Difference between revisions of "TUnit"

From TinyOS Wiki
Jump to: navigation, search
(External Links)
m
 
(10 intermediate revisions by 2 users not shown)
Line 6: Line 6:
 
The TUnit unit testing framework is available [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/ open source] to be used both publicly and privately.   
 
The TUnit unit testing framework is available [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/ open source] to be used both publicly and privately.   
  
Unit tests can be contributed by the public to the public automated unit testing system in tinyos-2.x-contrib/tests. These tests are automatically checked out and executed on several dedicated mote hardware platforms. Results and lava lamp status indicators are available live at [http://www.lavalampmotemasters.com http://www.lavalampmotemasters.com].
+
Unit tests can be contributed by the public to the public automated unit testing system in tinyos-2.x-contrib/tests.  
  
 
Privately, any group can run TUnit standalone or as an automated process in their own team development environment.
 
Privately, any group can run TUnit standalone or as an automated process in their own team development environment.
  
==Tutorials==
+
= Requirements =
 +
* [[TUnit Requirements]]
 +
 
 +
= Tutorials =
 
* [[How TUnit Works]]
 
* [[How TUnit Works]]
 
** [[TUnit Philosophy]]
 
** [[TUnit Philosophy]]
Line 27: Line 30:
 
= Case Studies =
 
= Case Studies =
  
* [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x-contrib/blaze/tos/chips/blazeradio/CC2500/receive/TestRxFifoReceive/ TestRxFifo]
+
* [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x-contrib/blaze/tos/chips/ccxx00/integration/cc1100/receive/TestRxFifoReceive/ TestRxFifo]
 
** Isolation test testing the receive functionality of a radio stack from the rest of the system, allowing us to test edge cases observed by receiving various types of data in the software implemented RX FIFO.
 
** Isolation test testing the receive functionality of a radio stack from the rest of the system, allowing us to test edge cases observed by receiving various types of data in the software implemented RX FIFO.
  
* [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x-contrib/blaze/tos/chips/blazeradio/shared/acks/AckBehavior/ AckBehavior]
+
* [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x-contrib/blaze/tos/chips/ccxx00/isolation/AckBehavior/ AckBehavior]
** Isolation test of the acknowledgements layer of the CC1100/CC2500 dual radio stack.
+
** Isolation test of the acknowledgements layer of the [[CC1100/CC2500]] dual radio stack.
  
* [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x-contrib/blaze/tos/chips/blazeradio/CC2500/csma/CsmaBehavior/ CsmaBehavior]
+
* [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x-contrib/blaze/tos/chips/ccxx00/isolation/CsmaBehavior/ CsmaBehavior]
 
** Isolation test of the CSMA layer of the CC2500 radio stack.
 
** Isolation test of the CSMA layer of the CC2500 radio stack.
  
Line 48: Line 51:
 
** Multi-Node Test: A Test Suite where 2 to 19 Supporting Nodes deliver LPL messages to a single listener, the Driving Node. At the end of a period of time, a dynamic threshold is calculated at +/- 10% and assertions are made against each of the nodes in the network to determine if the channel is being shared fairly amongst the multiple transmitters.
 
** Multi-Node Test: A Test Suite where 2 to 19 Supporting Nodes deliver LPL messages to a single listener, the Driving Node. At the end of a period of time, a dynamic threshold is calculated at +/- 10% and assertions are made against each of the nodes in the network to determine if the channel is being shared fairly amongst the multiple transmitters.
  
 +
= Progress =
 +
 +
* [[TUnit Feature Requests]]
 +
* [[TUnit Known Issues]]
 +
* [[TUnit Recent Updates]]
  
==External Links==
+
= External Links =
* [http://www.lavalampmotemasters.com Lava Lamp Mote Masters (http://www.lavalampmotemasters.com)] TUnit Public Automated Unit Testing Main Site
+
* [http://www.lavalampmotemasters.com TinyOS 2.x Public Automated Unit Testing (http://www.lavalampmotemasters.com)]
 
* [http://butunclebob.com/ArticleS.UncleBob.TheThreeRulesOfTdd Three Rules of Test-Driven Development]
 
* [http://butunclebob.com/ArticleS.UncleBob.TheThreeRulesOfTdd Three Rules of Test-Driven Development]
 
* [http://radio.weblogs.com/0100190/stories/2002/07/25/sixRulesOfUnitTesting.html Six Rules of Unit Testing]
 
* [http://radio.weblogs.com/0100190/stories/2002/07/25/sixRulesOfUnitTesting.html Six Rules of Unit Testing]
Line 56: Line 64:
 
* [http://www.ibm.com/developerworks/library/j-test.html Testing, fun? Really?]
 
* [http://www.ibm.com/developerworks/library/j-test.html Testing, fun? Really?]
 
* [http://www.agiledata.org/essays/tdd.html Introduction to Test-Driven Design]
 
* [http://www.agiledata.org/essays/tdd.html Introduction to Test-Driven Design]
 +
[[Category:TUnit]]

Latest revision as of 04:25, 26 February 2010

Tunit.png

TUnit is a unit testing framework geared for TinyOS and sensor networks. The philosophy surrounding the design of TUnit stems from years of accepted industry standard testing in other languages. TUnit is used daily in TinyOS Test Driven Development, decreasing the time spent manually testing and debugging software by literally hundreds of man-hours.

Open Source Testing

The TUnit unit testing framework is available open source to be used both publicly and privately.

Unit tests can be contributed by the public to the public automated unit testing system in tinyos-2.x-contrib/tests.

Privately, any group can run TUnit standalone or as an automated process in their own team development environment.

Requirements

Tutorials

Case Studies

  • TestRxFifo
    • Isolation test testing the receive functionality of a radio stack from the rest of the system, allowing us to test edge cases observed by receiving various types of data in the software implemented RX FIFO.
  • CsmaBehavior
    • Isolation test of the CSMA layer of the CC2500 radio stack.
  • TestMac
    • Multi-Node Testing and Characterization: Multiple statistics logging
  • TestRxThroughputWithNoCca
    • Multi-Node Test: Upon receiving the first message from the Driving Node, the Supporting Node receiver starts a timer and accumulates received messages. When the timer fires, it reports performance and verifies enough packets got through. The performance is characterized with statistics logging.
  • TestSwAcks
    • Multi-Node Test: An idle Supporting Node simply sends back an acknowledgment to the Driving Node.
  • TestLplDefaultContinuousDelivery
    • Multi-Node Test: A Test Suite where 2 to 19 Supporting Nodes deliver LPL messages to a single listener, the Driving Node. At the end of a period of time, a dynamic threshold is calculated at +/- 10% and assertions are made against each of the nodes in the network to determine if the channel is being shared fairly amongst the multiple transmitters.

Progress

External Links