Differences

This shows you the differences between two versions of the page.

--- getting_started:tutorials:rttest [2016/11/29 15:41] – created graf
+++ getting_started:tutorials:rttest [2021/03/29 18:20] (current) – ursgraf
@@ Line 1: / Line 1: @@
 ====== Test your Realtime System ======
-After successfully installing EEROS you might wonder how precise the periodic execution of your safety system and control system is. Keep in mind that EEROS will run these systems with
+You might wonder how precise the periodic execution of your safety system and control system is. Keep in mind that EEROS will run on systems with or without realtime capabilities. However, the latencies will greatly affect the precision of the periodic execution of the threads running the safety and control system.
+In the EEROS library you will find a directory with examples. For this example see [[https://github.com/eeros-project/eeros-framework/blob/master/examples/rtTest/rtTest.cpp|rtTest.cpp]].
+Open a shell in the build directory of your EEROS library and run //rtTest//. This examples does:
+  * Creates a single periodic task with a period of 1ms
+  * Measures the latency of the repetition frequency
+You can start the program with the option //-s// passing a number of seconds after which the program stops.
+<code>
+$ sudo ./examples/rtTest/rtTest -s 60 // run for a minute
+</code>
+IMPORTANT You have to run a program using real time threads with root privileges.
+The program will print out the cumulative runtime measurements of
+  * maximum period
+  * minimum period
+  * mean period
+once per second. A typical result would be:
+<code>
+-11-30 08:55:09    I:  ss: period max: 0.00105021   period min: 0.000949614   period mean: 0.000999999
+</code>
+The maximum period during the runtime of the program was 1.050ms, the minimum period was 0.950ms. This figures will vary depending on your platform and operating system support. For a real-life test try to run other programs concurrently. E.g.
+<code>
+$ dd if=/dev/zero of=/dev/null // gives full 100% load with low priority
+</code>