Industrial Native Real-Time Linux OS Solution

Setup and Tuning Guide

ID Date Version Classification
634647 01/01/2021 1.0 Public
Document Table of Contents

Xenomai Linux Installation

1. Copy the Xenomai Linux Debian packages built in the previous step to target board.

$ sudo gedit /etc/default/grub

2. Install Xenomai Linux Debian packages.

$ sudo dpkg -i [path]/linux-image-4.19.59-intel-pk-standard-ecs1.0_​​4.19.59-intel-pk-standard-ecs1.0-1_​​amd64.deb

$ sudo dpkg -i [path]/linux-headers-4.19.59-intel-pk-standard-ecs1.0_​​4.19.59-intel-pk-standard-ecs1.0-1_​​amd64.deb

$ sudo dpkg -i [path]/linux-libc-dev_​​4.19.59-intel-pk-standard-ecs1.0-1_​​amd64.deb

$ sudo dpkg -i [path]/ethercat_​​1.5.2_​​amd64.deb

$ sudo dpkg -i [path]/xenomai_​​3.1_​​amd64.deb

3. Edit grub to leave time to select new kernel and change the kernel cmdline.

Changes are:

#GRUB_​​TIMEOUT_​​STYLE=hidden

GRUB_​​TIMEOUT=10

GRUB_​​CMDLINE_​​LINUX_​​DEFAULT="quiet splash xenomai.allowed_​​group=1234 xenomai.sysheap_​​size=256 xenomai.state=enabled xenomai.smi=detect xenomai.smi_​​mask=1 nosmap console=ttyS0,115200 console=tty0 clocksource=tsc tsc=reliable nmi_​​watchdog=0 nosoftlockup idle=poll noht audit=0 irqaffinity=0 isolcpus=1-3 rcu_​​nocbs=1-3 intel_​​pstate=disable intel.max_​​cstate=0 intel_​​idle.max_​​cstate=0 processor.max_​​cstate=0 processor_​​idle.max_​​cstate=0 i915.enable_​​dc=0 i915.disable_​​power_​​well=0 noefi”
Note:Please refer to “noefi”, “isolcpus” and “rcu_​nocbs” descriptions in Section 2.4.

4. Update grub and reboot.

$ sudo update-grub

$ sudo reboot

5. After reboot, select “Advanced options for Ubuntu” “Ubuntu, with Linux 4.19.59-intel-pk-standard-ecs1.0” in the grub menu, and then boot.