From edaef4066bb80fc6c02be6dff5fa11e8b114b52d Mon Sep 17 00:00:00 2001 From: Adrian Mangeac Date: Mon, 21 Oct 2019 16:03:59 +0200 Subject: Update with 8.1 related information Change-Id: I440ae0f359839b6f1ac4ead423944ce726f6295c Signed-off-by: Adrian Mangeac --- .../doc/about_release.xml | 66 +- .../doc/eltf_params_updated.xml | 160 +-- .../doc/prerequisites_and_requirements.xml | 2 +- .../doc/real_time_in_enea_linux.xml | 1147 ++++++++++++++------ .../doc/using_enea_linux.xml | 18 +- 5 files changed, 854 insertions(+), 539 deletions(-) (limited to 'doc') diff --git a/doc/book-enea-linux-release-info/doc/about_release.xml b/doc/book-enea-linux-release-info/doc/about_release.xml index 1fcd235..dd9e7ed 100644 --- a/doc/book-enea-linux-release-info/doc/about_release.xml +++ b/doc/book-enea-linux-release-info/doc/about_release.xml @@ -44,16 +44,16 @@ -- enea-image-rt-sdk /* precompiled artifacts for the development process. The image contains userspace tools and kernel configurations necessary - for developing, debugging and profiling applications and \ + for developing, debugging and profiling applications and kernel modules */ -- various artifacts -- esdk - /* Extensible SDK related artifacts including SDK installer and */ - /* manifests, self-extracting archive installing cross-compilation - toolchain for the platform */ - -- x86_64-buildtools-nativesdk-standalone-8.1.sh - /* self-extracting archive installing additional tools - for the host machine */ + /* Extensible SDK related artifacts including SDK installer and + manifests, self-extracting archive installing cross-compilation + toolchain for the platform */ + -- x86_64-buildtools-nativesdk-standalone-8.1.sh + /* self-extracting archive installing additional tools + ` for the host machine */ -- raspberrypi3-64/ /* artifacts for the reference machine */ -- rpm/ @@ -65,33 +65,47 @@ -- enea-image-rt-sdk /* precompiled artifacts for the development process. The image contains userspace tools and kernel configurations necessary - for developing, debugging and profiling applications and \ + for developing, debugging and profiling applications and kernel modules */ -- various artifacts -- esdk - /* Extensible SDK related artifacts including SDK installer and */ - /* manifest, self-extracting archive installing cross-compilation - toolchain for the platform */ - -- x86_64-buildtools-nativesdk-standalone-8.1.sh - /* self-extracting archive installing additional tools - for the host machine */ + /* Extensible SDK related artifacts including SDK installer and + manifest, self-extracting archive installing cross-compilation + toolchain for the platform */ + -- x86_64-buildtools-nativesdk-standalone-8.1.sh + /* self-extracting archive installing additional tools + for the host machine */ The following set of artifacts is available: - --bzImage - /* kernel image */ --- bzImage-<target>-rt.bin - /* kernel image, same as above */ --- config-<target>.config - /* kernel configuration file */ --- enea-image-rt-<target>-rt.ext4 - /* compressed EXT4 image of the rootfs */ --- enea-image-rt-<target>-rt.tar.gz - /* tar archive of the image */ --- modules-<target>-rt.tgz - /* external kernel modules */ + -- intel-corei7-64 + --bzImage + /* kernel image */ + -- bzImage-<target>-rt.bin + /* kernel image, same as above */ + -- config-<target>.config + /* kernel configuration file */ + -- enea-image-rt-<target>-rt.ext4 + /* compressed EXT4 image of the rootfs */ + -- enea-image-rt-<target>-rt.tar.gz + /* tar archive of the image */ + -- modules-<target>-rt.tgz + /* external kernel modules */ +-- raspberrypi3-64 + -- Image + /* kernel image */ + -- Image-<target>.bin + /* kernel image, same as above */ + -- bcm*-rpi-3-b-*-<target>.dtb + /* the device tree blob */ + -- enea-image-standard-<target>.ext4 + /* compressed EXT4 image of the rootfs */ + -- enea-image-standard-<target>.tar.gz + /* tar archive of the image */ + -- modules-<target>.tgz + /* external kernel modules */
diff --git a/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml b/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml index b557335..5e52ca0 100644 --- a/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml +++ b/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml @@ -22,7 +22,7 @@ A programlisting, ID "eltf-prereq-apt-get-commands-host" - # Host Ubuntu 16.04.2 LTS 64bit + # Host Ubuntu 18.04 LTS 64bit sudo apt-get -y update sudo apt-get -y install sed wget subversion git-core coreutils unzip texi2html \ texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \ @@ -42,17 +42,17 @@ export PATH=~/bin:$PATH correct also compared to the "previous" REL VER in pardoc-distro.xml "prev_baseline". - 8 + 8.1 - 2.5 + 2.7 - sumo + warrior http://www.yoctoproject.org/downloads + url="http://downloads.yoctoproject.org/releases/yocto/yocto-2.7/poky-warrior-21.0.0.tar.bz2">http://www.yoctoproject.org/downloads http://linux.enea.com/EneaLinux8.0 + url="http://linux.enea.com/EneaLinux8.1">http://linux.enea.com/EneaLinux8.1 A programlisting, ID "eltf-repo-cloning-enea-linux". Use $MACHINE/default.xml as parameter, where MACHINE is one of the target @@ -61,7 +61,7 @@ export PATH=~/bin:$PATH mkdir enea-linux cd enea-linux repo init -u git@git.enea.com:linux/manifests/el_manrtt.git \ - -b refs/tags/Enea_Linux_8.0 -m intel-corei7-64/default.xml + -b refs/tags/Enea_Linux_8.1 -m intel-corei7-64/default.xml repo sync A table with ONE row, only the row with ID @@ -149,7 +149,7 @@ repo sync Linux Kernel Version - 4.14 + 4.19 @@ -159,151 +159,11 @@ repo sync - Enea deb folder for downloading DEB packages for this + Enea rpm folder for downloading RPM packages for this target http://linux.enea.com/EneaLinux8.0/deb - - - - - - - MACHINE Information Intel Atom C3000 - - - - - - - Component - - Description - - - - - - Target official name - - Intel Atom C3000 - - - - Architecture and Description - - x86-64 - - - - Link to target datasheet - - Intel - Atom datasheet - - - - Poky version - - Git-commit-id: TBD - - - - GCC version - - 7.3 - - - - Linux Kernel Version - - 4.14 - - - - Supported Drivers - - Ethernet, RTC, UART - - - - Enea deb folder for downloading DEB packages for this - target - - http://linux.enea.com/EneaLinux8.0/deb - - - -
- - - MACHINE Information Intel NUC Kaby Lake - - - - - - - Component - - Description - - - - - - Target official name - - Intel NUC Kaby Lake - - - - Architecture and Description - - x86-64 - - - - Link to target datasheet - - Intel - NUC Kaby Lake datasheet - - - - Poky version - - Git-commit-id: TBD - - - - GCC version - - 7.3 - - - - Linux Kernel Version - - 4.14 - - - - Supported Drivers - - Ethernet, RTC, UART - - - - Enea deb folder for downloading DEB packages for this - target - - http://linux.enea.com/EneaLinux8.0/deb + url="http://linux.enea.com/EneaLinux8.1/rpm">http://linux.enea.com/EneaLinux8.1/rpm diff --git a/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml b/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml index 2215ba8..688145f 100644 --- a/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml +++ b/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml @@ -63,7 +63,7 @@ $ git config --global user.email johndoe@example.comBuilding Enea Linux requires a set of packages to be installed on your Linux development host. The list of required packages is described in the Yocto + url="https://www.yoctoproject.org/docs/2.7/ref-manual/ref-manual.html#required-packages-for-the-host-development-system">Yocto Project reference manual. 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 fa60f93..ec56fd9 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 @@ -5,7 +5,7 @@ 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. + 4.19/preempt-rt kernel.
Addtional packages provided in the RT profile @@ -171,15 +171,19 @@
Stress Testcases - Below you will find several testcases for an RT image. + Below you will find several testcases for intel-corei7-64 and + raspberrypi3-64 RT images. - - - <emphasis role="bold">Test 1 (RT image)</emphasis> - +
+ Details on testcases for intel-corei7-64 - - # Test case (1/6): rt_bmark.intlat.no_stress + + + <emphasis role="bold">Test 1 (RT image)</emphasis> + + + + # Test case (1/6): rt_bmark.intlat.no_stress # .............................................................................. # No stress requested # Starting cyclictest @@ -187,22 +191,22 @@ .... .... # Min: 2 us -# Avg: 3.0 us -# Max: 15 us -# Max list: [5, 6, 7, 9, 10, 15] +# Avg: 2.0 us +# Max: 24 us +# Max list: [4, 6, 12, 14, 14, 24] # 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' @@ -212,19 +216,18 @@ .... # Min: 2 us # Avg: 2.0 us -# Max: 11 us -# Max list: [4, 5, 6, 9, 10, 11] -# PASS - - - - - - - <emphasis role="bold">Test 3 (RT image)</emphasis> - - - +# Max: 10 us +# Max list: [4, 5, 6, 7, 10, 10] +# PASS + + + + + + <emphasis role="bold">Test 3 (RT image)</emphasis> + + + # Test case (3/6): rt_bmark.intlat.hdd # .............................................................................. # Starting stress(hdd) @@ -234,21 +237,20 @@ .... .... # Min: 2 us -# Avg: 2.7 us -# 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 +# Avg: 2.0 us +# Max: 24 us +# Max list: [7, 13, 14, 20, 24, 24] +# PASS + + + + + + <emphasis role="bold">Test 4 (RT image)</emphasis> + + + + # Test case (4/6): rt_bmark.intlat.io # .............................................................................. # Starting stress(io) # Command: 'stress -i 8' @@ -257,21 +259,20 @@ .... .... # Min: 2 us -# Avg: 3.0 us -# 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 +# Avg: 2.0 us +# Max: 13 us +# Max list: [5, 7, 7, 9, 11, 13] +# PASS + + + + + + <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' @@ -280,20 +281,20 @@ .... .... # Min: 2 us -# Avg: 4.2 us -# Max: 15 us -# Max list: [10, 12, 12, 13, 13, 15] - # PASS - - - - - - <emphasis role="bold">Test 6 (RT image)</emphasis> - - - - # Test case (6/6): rt_bmark.intlat.full +# Avg: 5 us +# Max: 28 us +# Max list: [12, 13, 14, 15, 19, 28] +# PASS + + + + + + <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' @@ -302,316 +303,756 @@ .... .... # Min: 2 us -# Avg: 3.5 us -# Max: 19 us -# Max list: [12, 14, 15, 16, 18, 19] +# Avg: 3.6 us +# Max: 18 us +# Max list: [12, 13, 14, 16, 16, 18] +# PASS + + +
+ + Repeat these tests for the Standard image and compare the results + (see the following tables). + +
+ Benchmark Numbers for the Standard Image + + + + + + + + + + + + + + + + + + + + Latency [us] + + + + Stress Type + + + + + + no stress + + + + cpu + + + + Io + + + + vm + + + + hdd + + + + full + + + + + + + + Min + + + + 2 + + + + 2 + + + + 2 + + + + 2 + + + + 2 + + + + 2 + + + + + + average + + + + 2.0 + + + + 2.0 + + + + 2.0 + + + + 4.5 + + + + 2.0 + + + + 3.7 + + + + + + max + + + + 36 + + + + 49 + + + + 60 + + + + 270 + + + + 102 + + + + 254 + + + + +
+ + + Benchmark Numbers for the RT Image + + + + + + + + + + + + + + + + + + + + Latency [us] + + + + Stress Type + + + + + + no stress + + + + cpu + + + + Io + + + + vm + + + + hdd + + + + full + + + + + + + + Min + + + + 2 + + + + 2 + + + + 2 + + + + 2 + + + + 2 + + + + 2 + + + + + + average + + + + 2.0 + + + + 2.0 + + + + 2.0 + + + + 5.0 + + + + 2.0 + + + + 3.6 + + + + + + max + + + + 24 + + + + 10 + + + + 13 + + + + 28 + + + + 24 + + + + 18 + + + + +
+ +
+ Details on testcases for raspberrypi3-64 + + + + <emphasis role="bold">Test 1 (RT image)</emphasis> + + + + # Test case (1/6): rt_bmark.intlat.no_stress +# .............................................................................. +# No stress requested +# Starting cyclictest +# Command: cyclictest -S -p 99 -q -i 100 -d 20 -l 30000 +.... +.... +# Min: 11 us +# Avg: 28.4 us +# Max: 135 us +# Max list: [96, 99, 104, 110, 118, 135] # PASS - - - -
- Repeat these tests for the Standard image and compare the results - (see the following tables). + + + + + + + <emphasis role="bold">Test 2 (RT image)</emphasis> + + + + # Test case (2/6): rt_bmark.intlat.cpu +# .............................................................................. +# Starting stress(cpu) +# Command: 'stress -c 8' +# Starting cyclictest +# Command: cyclictest -S -p 99 -q -i 100 -d 20 -l 30000 +.... +.... +# Min: 11 us +# Avg: 29.5 us +# Max: 130 us +# Max list: [96, 103, 106, 109, 112, 130] +# PASS + + + + + + <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' +# Starting cyclictest +# Command: cyclictest -S -p 99 -q -i 100 -d 20 -l 30000 +.... +.... +# Min: 11 us +# Avg: 29.7 us +# Max: 173 us +# Max list: [117, 126, 132, 137, 147, 173] +# PASS + + + + + + <emphasis role="bold">Test 4 (RT image)</emphasis> + + + + # Test case (4/6): rt_bmark.intlat.io +# .............................................................................. +# Starting stress(io) +# Command: 'stress -i 8' +# Starting cyclictest +# Command : cyclictest -S -p 99 -q -i 100 -d 20 -l 30000 +.... +.... +# Min: 11 us +# Avg: 27.6 us +# Max: 137 us +# Max list: [102, 108, 114, 123, 133, 137] +# PASS + + + + + + <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' +# Starting cyclictest +# Command: cyclictest -S -p 99 -q -i 100 -d 20 -l 30000 +.... +.... +# Min: 11 us +# Avg: 33.8 us +# Max: 150 us +# Max list: [107, 116, 119, 124, 125, 150] +# PASS + + + + + + <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' +# Starting cyclictest +# Command : cyclictest -S -p 99 -q -i 100 -d 20 -l 30000 +.... +.... +# Min: 11 us +# Avg: 31.2 us +# Max: 149 us +# Max list: [124, 128, 134, 142, 144, 149] +# PASS + + +
+ + Repeat these tests for the Standard image and compare the results + (see the following tables). + + + Benchmark Numbers for the Standard Image + + + + + -
- Benchmark Numbers for the Standard Image + - - + - + - + - + - + + + + Latency [us] + - + + Stress Type + + + + + + no stress + - + + cpu + - - - - Latency [us] - + + Io + - - Stress Type - - + + vm + - - - no stress - + + hdd + - - cpu - + + full + + + - - Io - + + + + Min + - - vm - + + 11 + - - hdd - + + 12 + - - full - - - + + 11 + - - - - Min - + + 11 + - - 2 - + + 9 + - - 2 - + + 10 + + - - 1 - + + + average + - - 2 - + + 26.9 + - - 1 - + + 26.9 + - - 2 - - + + 27.6 + - - - average - + + 31.1 + - - 2.9 - + + 43.8 + - - 2.0 - + + 45.8 + + - - 2.7 - + + + max + - - 4.2 - + + 450 + - - 3.0 - + + 226 + - - 4.5 - - - - - - max - - - - 262 - - - - 82 - - - - 101 - - - - 776 - - - - 122 - - - - 1428 - - - - -
- - - Benchmark Numbers for the RT Image - - - - - - - - - + + 547 + - - - - - - - - - - Latency [us] - - - - Stress Type - - - - - - no stress - - - - cpu - - - - Io - + + 481 + - - vm - - - - hdd - - - - full - - - - - - - - Min - - - - 2 - - - - 2 - - - - 2 - - - - 2 - - - - 2 - - - - 2 - - - - - - average - - - - 3.0 - - - - 2.0 - + + 922 + - - 3.0 - - - - 4.3 - - - - 2.7 - - - - 3.5 - - - - - - max - - - - 15 - - - - 13 - - - - 42 - - - - 20 - - - - 16 - - - - 32 - - - - -
+ + 941 + + + + + + + + Benchmark Numbers for the RT Image + + + + + + + + + + + + + + + + + + + + Latency [us] + + + + Stress Type + + + + + + no stress + + + + cpu + + + + Io + + + + vm + + + + hdd + + + + full + + + + + + + + Min + + + + 11 + + + + 11 + + + + 11 + + + + 11 + + + + 11 + + + + 11 + + + + + + average + + + + 28.4 + + + + 29.5 + + + + 27.6 + + + + 33.8 + + + + 29.7 + + + + 31.2 + + + + + + max + + + + 135 + + + + 130 + + + + 137 + + + + 150 + + + + 173 + + + + 149 + + + + +
+ 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 9fde297..aba7c1d 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 @@ -31,7 +31,7 @@ $ mkdir enea-linux $ cd enea-linux $ repo init -u git@git.enea.com:linux/manifests/el_manifests-rt.git \ - -b refs/tags/Enea_Linux_RT_8.0 -m $MACHINE/default.xml + -b refs/tags/Enea_Linux_RT_8.1 -m $MACHINE/default.xml $ repo sync @@ -110,7 +110,7 @@ $ cd <build_dir>/tmp/deploy/images/<target>/ # Here are the build b $ mkdir enea-linux $ cd enea-linux $ repo init -u git@git.enea.com:linux/manifests/el_manifests-rt.git \ - -b refs/tags/Enea_Linux_RT_8.0 -m $MACHINE/default.xml + -b refs/tags/Enea_Linux_RT_8.1 -m $MACHINE/default.xml $ repo sync @@ -278,7 +278,7 @@ label device01 Copy pxelinux.0 and vesamenu.c32 from the build directory, e.g. from - <build_dir>tmp/work/corei7-64-enea-linux/syslinux/6.03-r0/image/usr/share/syslinux/. + <build_dir>tmp/work/corei7-64-enea-linux/syslinux/6.04-pre2-r0/image/usr/share/syslinux/. @@ -415,8 +415,8 @@ BBLAYERS ?= " \ As a result, BBLAYERS shall be extended with the bsp-layer/s layer for your target and any other additional layer/s. For details on how to do this, see the Yocto - 2.5 Dev Manual, section "Understanding and Creating Layers". If + url="http://www.yoctoproject.org/docs/2.7/dev-manual/dev-manual.html#understanding-and-creating-layers">Yocto + 2.7 Dev Manual, section "Understanding and Creating Layers". If needed replace the Yocto version. Layers can be added when you initialize the build environment. The @@ -443,9 +443,9 @@ BBLAYERS ?= " \ Adding a Recipe Study the Hello + url="https://www.yoctoproject.org/docs/2.7/dev-manual/dev-manual.html#new-recipe-single-c-file-package-hello-world">Hello World recipe in the Yocto Project Development Manual. If needed - replace the example version (2.5) with the Yocto version in your Enea + replace the example version (2.7) with the Yocto version in your Enea Linux distribution. @@ -695,8 +695,8 @@ $ ./enea-*-toolchain-<version>.sh image in a consistent way, e.g. to install, upgrade, or delete packages considering the dependencies. The package management systems supported by Enea Linux are described in this section. More information about PMS can - be found in the Yocto 2.5 document Yocto + be found in the Yocto 2.7 document Yocto Project Mega Manual. If needed replace the Yocto version in the link. -- cgit v1.2.3-54-g00ecf