1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/tests/xtimer_hang
josar 82d126158e test/xtimer_hang: use xtimer_periodic_wakeup
When sleeping in the main function with xtimer_sleep not every percentage
will be printed as the sleep duration and the processing time added do
not result in full percentage values.

Using xtimer_periodic_wakeup ensures that every integer percentage is printed.
2018-11-15 12:14:09 +01:00
..
tests tests: move testrunner import up 2018-08-13 14:11:24 +02:00
main.c test/xtimer_hang: use xtimer_periodic_wakeup 2018-11-15 12:14:09 +01:00
Makefile examples, tests: add memory insufficient arduino boards 2018-11-02 17:57:13 +01:00
README.md test/xtimer_hang: DEBUG_PINS 2018-10-31 12:41:43 +01:00

xTimer hang test

This is a runtime test for the RIOT xtimer implementation it prints text Testing... (<percentage>) (approximately) every TEST_INTERVAL_MS ms (milliseconds) for an overall test duration of TEST_TIME_S seconds.

The test will print [SUCCESS] on completion, if it stops or hangs before, the test has failed.

Please note (again), this is a runtime test to check if xtimer runs into a deadlock, it is not about clock stability nor accuracy of timing intervals.

When debug pins are used and observed the expected output is as follows: The MAIN_THREAD_PIN is on for ca. 100ms and that in a regular interval. If this interval is not regular or has gaps this is an error. The WORKER_THREAD_PIN should toggle after 1ms and 1.1ms. (As this might fall in the XTIMER_ISR_BACKOFF the first pin toggle is delayed untill the second is ready. Thus the time interval can be longer.) If the Timer fall in the same interrupt there might be a interrupt before the second worker thread timer is set. This leads to a separation of the timer interrupts until they again fall in the same interrupt. It might happen that from the seperation of the interrupts till the merge there is only a uneven count of WORKER_THREAD_PIN toggles, which means a loss of one worker time 2, which is expected as it has a lower priority then worker timer 1. And thus in the moment when the hardware interrupt for the 2 worker is executet it has to wait for the 1 worker timer because of the XTIMER_ISR_BACKOFF and so the first timer is executed first as it has the higher priority.