From 18eeab5960104a3b4d9757574e67d7d454bc9609 Mon Sep 17 00:00:00 2001 From: Sona Sarmadi Date: Thu, 20 Sep 2018 10:58:16 +0200 Subject: Fixed review comments Fixed Adrian, Martin and Miruna's remaining review comments. Change-Id: Ifa38428304722fd6a6cf947b2f74c3fdd902e27a Signed-off-by: Sona Sarmadi --- .../doc/real_time_in_enea_linux.xml | 262 ++++++++++++--------- .../doc/using_enea_linux.xml | 2 +- 2 files changed, 155 insertions(+), 109 deletions(-) diff --git a/doc/book-enea-linux-user-guide/doc/real_time_in_enea_linux.xml b/doc/book-enea-linux-user-guide/doc/real_time_in_enea_linux.xml index afc3d33..8d7b8d4 100644 --- a/doc/book-enea-linux-user-guide/doc/real_time_in_enea_linux.xml +++ b/doc/book-enea-linux-user-guide/doc/real_time_in_enea_linux.xml @@ -2,77 +2,89 @@ Real-Time in Enea Linux - The Enea Linux Standard and Real-Time Profiles are based - on the same Yocto (poky) version but differ in kernel needs. The RT Profile uses the Intel 4.14/preempt-rt kernel. + The Enea Linux Standard and Real-Time Profiles are based on the same + Yocto (poky) version but differ in kernel needs. The RT Profile uses the + Intel + 4.14/preempt-rt kernel. - Addtional packages provided in the RT profile + Addtional packages provided in the RT profile - - + + - - - Package - Version - Description - - + + + Package - - - bitcalc - 1.0-r0.0 - Tool for understanding bit calculations and - visualizing to binary, hex and decimal. - + Version - - count-ticks - 1.1-r1.0 - Counts the number of kernel ticks during command execution. - - - - partrt - 1.1-r0.0 - Tool for dividing a SMP Linux system into a real - time domain and a non-real time domain. - + Description + + - - cyclictest - - A testing tool for evaluating relative performance of RT systems. - + + + bitcalc - - stress - - A simple workload generator for POSIX systems. - - - -
+ 1.0-r0.0 + + Tool for understanding bit calculations and visualizing to + binary, hex and decimal. + + + + count-ticks + + 1.1-r1.0 + + Counts the number of kernel ticks during command + execution. + + + + partrt + + 1.1-r0.0 + + Tool for dividing a SMP Linux system into a real time domain + and a non-real time domain. + + + + rt-tests + + 1.1 + + Programs that test various rt-linux features. + + + + For the detailed list of packages provided in both Standard and RT - profiles along with package versions, please refer to the manifest files located in - <build_dir>/tmp/deploy/images/<target>. + profiles along with package versions, please refer to the Open Source + Reports.
Benchmark The worst case latency benchmark uses a combination of tools: cyclictest, and stress. The values of buffer sizes configured for use in the latter tool are chosen - both to generate a stessful load on a network via NFS traffic in the hdd test, and in an attempt to resemble a real life embedded application. + url="https://wiki.linuxfoundation.org/realtime/documentation/howto/tools/cyclictest/start">cyclictest, + and stress. The + values of buffer sizes configured for use in the latter tool are chosen + both to generate a stressful load on a network via NFS traffic in the hdd + test, and in an attempt to resemble a real life embedded + application.
Benchmark Details - The combination of cyclictest and stress has been used for the - benchmarking presented in this document. Details are given in the tables presented below. + The combination of cyclictest and + stress has been used for the + benchmarking presented in this document. Details are given in the tables + presented below. Stress scenarios @@ -157,9 +169,12 @@ Below you will find several testcases for an RT image. - <emphasis role="bold">Test 1 (RT image)</emphasis> + + <emphasis role="bold">Test 1 (RT image)</emphasis> + - # Test case (1/6): rt_bmark.intlat.no_stress + + # Test case (1/6): rt_bmark.intlat.no_stress # .............................................................................. # No stress requested # Starting cyclictest @@ -172,12 +187,17 @@ # Max list: [5, 6, 7, 9, 10, 15] # PASS - + + + - <emphasis role="bold">Test 2 (RT image)</emphasis> + + <emphasis role="bold">Test 2 (RT image)</emphasis> + - # Test case (2/6): rt_bmark.intlat.cpu + + # Test case (2/6): rt_bmark.intlat.cpu # .............................................................................. # Starting stress(cpu) # Command: 'stress -c 8' @@ -190,11 +210,17 @@ # Max: 11 us # Max list: [4, 5, 6, 9, 10, 11] # PASS - + + + - <emphasis role="bold">Test 3 (RT image)</emphasis> - # Test case (3/6): rt_bmark.intlat.hdd + + <emphasis role="bold">Test 3 (RT image)</emphasis> + + + + # Test case (3/6): rt_bmark.intlat.hdd # .............................................................................. # Starting stress(hdd) # Command: 'stress -d 8 --hdd-bytes 20M' @@ -207,11 +233,17 @@ # Max: 14 us # Max list: [9, 10, 11, 12, 14, 14] # PASS - + + + - <emphasis role="bold">Test 4 (RT image)</emphasis> - # Test case (4/6): rt_bmark.intlat.io + + <emphasis role="bold">Test 4 (RT image)</emphasis> + + + + # Test case (4/6): rt_bmark.intlat.io # .............................................................................. # Starting stress(io) # Command: 'stress -i 8' @@ -224,11 +256,17 @@ # Max: 15 us # Max list: [8, 9, 10, 12, 12, 15] # PASS - + + + - <emphasis role="bold">Test 5 (RT image)</emphasis> - # Test case (5/6): rt_bmark.intlat.vm + + <emphasis role="bold">Test 5 (RT image)</emphasis> + + + + # Test case (5/6): rt_bmark.intlat.vm # .............................................................................. # Starting stress(vm) # Command: 'stress -m 8 --vm-bytes 10M' @@ -240,11 +278,17 @@ # Avg: 4.2 us # Max: 15 us # Max list: [10, 12, 12, 13, 13, 15] - # PASS + # PASS + + - <emphasis role="bold">Test 6 (RT image)</emphasis> - # Test case (6/6): rt_bmark.intlat.full + + <emphasis role="bold">Test 6 (RT image)</emphasis> + + + + # Test case (6/6): rt_bmark.intlat.full # .............................................................................. # Starting stress(io+cpu+hdd+vm) # Command: 'stress -i 8 -c 8 -d 8 --hdd-bytes 20M -m 8 --vm-bytes 10M' @@ -257,7 +301,9 @@ # Max: 19 us # Max list: [12, 14, 15, 16, 18, 19] # PASS - + + + Repeat these tests for the Standard image and compare the results @@ -284,7 +330,7 @@ - Latency [µs] + Latency [us] @@ -326,27 +372,27 @@ - 2 us + 2 - 2 us + 2 - 1 us + 1 - 2 us + 2 - 1 us + 1 - 2 us + 2 @@ -356,27 +402,27 @@ - 2.9 us + 2.9 - 2.0 us + 2.0 - 2.7 us + 2.7 - 4.2 us + 4.2 - 3.0 us + 3.0 - 4.5 us + 4.5 @@ -386,27 +432,27 @@ - 262 us + 262 - 82 us + 82 - 101 us + 101 - 776 us + 776 - 122 us + 122 - 1428 us + 1428 @@ -434,7 +480,7 @@ - Latency [µs] + Latency [us] @@ -476,27 +522,27 @@ - 2 us + 2 - 2 us + 2 - 2 us + 2 - 2 us + 2 - 2 us + 2 - 2 us + 2 @@ -506,27 +552,27 @@ - 3.0 us + 3.0 - 2.0 us + 2.0 - 3.0 us + 3.0 - 4.3 us + 4.3 - 2.7 us + 2.7 - 3.5 us + 3.5 @@ -536,27 +582,27 @@ - 15 us + 15 - 13 us + 13 - 42 us + 42 - 20 us + 20 - 16 us + 16 - 32 us + 32 diff --git a/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml b/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml index 0704dbf..19ec877 100644 --- a/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml +++ b/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml @@ -56,7 +56,7 @@ $ TEMPLATECONF=meta-el-rt/conf/template.<machine> \ - Build Enea Linux RT image + Build an Enea Linux RT image # You have already initiated the build environment and are in the <build_dir> $ bitbake <enea-image-name> -- cgit v1.2.3-54-g00ecf