Difference between revisions of "TUnit"
(TUnit TinyOS Unit Testing) |
m |
||
| (29 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | [[Image:tunit.png|frame]] | |
| − | + | TUnit is a [http://en.wikipedia.org/wiki/Unit_testing 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 [http://en.wikipedia.org/wiki/List_of_unit_testing_frameworks other languages]. TUnit is used daily in TinyOS [http://en.wikipedia.org/wiki/Test-driven_development 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 [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. | ||
| + | |||
| + | Privately, any group can run TUnit standalone or as an automated process in their own team development environment. | ||
| + | |||
| + | = Requirements = | ||
| + | * [[TUnit Requirements]] | ||
| + | |||
| + | = Tutorials = | ||
| + | * [[How TUnit Works]] | ||
| + | ** [[TUnit Philosophy]] | ||
| + | ** [[TUnit Test Flow]] | ||
| + | ** [[TUnit Assertions]] | ||
| + | * [[Setting up TUnit]] | ||
| + | ** [[suite.properties]] | ||
| + | ** [[tunit.xml]] | ||
| + | * [[Single-Node Unit Testing]] | ||
| + | ** [[Your First Test]] | ||
| + | ** [[Assertion Playground]] | ||
| + | ** [[State Interface Test]] | ||
| + | ** [[Characterization Testing with Statistics]] | ||
| + | * [[Multi-Node Unit Testing]] | ||
| + | |||
| + | = Case Studies = | ||
| + | |||
| + | * [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. | ||
| + | |||
| + | * [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. | ||
| + | |||
| + | * [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. | ||
| + | |||
| + | * [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x/tos/chips/general_radio_tests/TestMac/ TestMac] | ||
| + | ** Multi-Node Testing and Characterization: Multiple statistics logging | ||
| + | |||
| + | * [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x/tos/chips/cc2420/TestRxThroughputWithNoCca/ 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. | ||
| + | |||
| + | * [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x/tos/chips/cc2420/TestSwAcks/ TestSwAcks] | ||
| + | ** Multi-Node Test: An idle Supporting Node simply sends back an acknowledgment to the Driving Node. | ||
| + | |||
| + | * [http://tinyos.cvs.sourceforge.net/tinyos/tinyos-2.x-contrib/tunit/tests/tinyos-2.x/tos/chips/cc2420/TestLplDefaultContinuousDelivery/ 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 = | ||
| + | |||
| + | * [[TUnit Feature Requests]] | ||
| + | * [[TUnit Known Issues]] | ||
| + | * [[TUnit Recent Updates]] | ||
| + | |||
| + | = External Links = | ||
| + | * [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://radio.weblogs.com/0100190/stories/2002/07/25/sixRulesOfUnitTesting.html Six Rules of Unit Testing] | ||
| + | * [http://www.xprogramming.com/xpmag/BigVisibleCharts.htm Big Visible Charts] | ||
| + | * [http://www.ibm.com/developerworks/library/j-test.html Testing, fun? Really?] | ||
| + | * [http://www.agiledata.org/essays/tdd.html Introduction to Test-Driven Design] | ||
| + | [[Category:TUnit]] | ||
Latest revision as of 04:25, 26 February 2010
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.
Contents
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.
- AckBehavior
- Isolation test of the acknowledgements layer of the CC1100/CC2500 dual radio stack.
- 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.
