Attention

You are viewing an older version of the documentation. The latest version is v3.3.

rts-buster

The following section is applicable to:

../_images/linux.png

Important

Complete the pre-requisite section Setting up ECI Build before continuing further.

The ECI rts-buster Debian target image provides the Real-Time Systems Hypervisor (RTH) virtualized Debian Desktop OS (GPOS) and ECI privileged OS (POS) together with software utilities to manage virtual and privileged machines.

  1. Copy and Unzip Real-Time Hypervisor (RTH) package “RTH-Release5.X.XX.XXXXX.zip” to the ECI/rth_releases/ directory Refer to section Real-Time Systems Hypervisor (RTH) for information on obtaining the Real-Time Hypervisor (RTH) package.

    ../_images/036.png

  2. Extract the archive. In Ubuntu, you can right click on the archive and select “Extract Here”.

    ../_images/047.png
    ../_images/055.png

  3. Run the setup script:

    $ ./setup.sh
    ../_images/041.png

  4. The setup script will present a list of pre-configured use cases. Select custom to start configuring a custom build.

    ../_images/081.png

  5. The setup script will present a list of available build targets. Select rts-buster from the list.

    ../_images/016.png

  6. On the following prompt, it is possible to modify the build configuration of the target image. Select/deselect features to be included in the image using the arrow keys to move the selection and spacebar to toggle the state. When complete, press the enter key to finalize the selection.

    ../_images/094.png

    The following table describes the various options available:

    Feature Option

    Description

    [all] SSH Server

    Adds an SSH server to the target image.

    [all] EC Protocol Bridge

    Edge Control Protocol Bridge bridges various industrial protocols together, effectively providing a translation from one protocol to another.

    [POS] CODESYS Software PLC

    CODESYS Software PLC provides a Linux runtime that allows control applications to execute on Linux-based systems. This feature requires a CODESYS .deb file to be added to the build environment.

    [GPOS] Robot Operating System 2 (Foxy)

    Provides the Foxy version of ROS2 software

  7. On the following prompt, it is possible to modify the types of virtualized privileged OS (POS) which are included in the image. Select/deselect features to be included in the image using the arrow keys to move the selection and spacebar to toggle the state. When complete, press the enter key to finalize the selection.

    ../_images/103.png

    The following table describes the various options available:

    Feature Option

    Description

    Linux preemptive rt-kernel aka PREEMPT_RT

    Include the Linux kernel with PREEMPT_RT patchset as RTH privileged OS (POS)

    Linux & Xenomai 3.1.1 Cobalt Dual-kernel

    Include Linux kernel with Xenomai I I-pipe as RTH privileged OS (POS)

    Windriver® VxWorks® 7-SR650 RTOS (demo-only prebuild)

    Include prebuilt Wind-River Vxworks 7 Kernel Demo as 3rd party commercial RTH privileged OS (POS)

    BlackBerry QNX7® Neutrino® 7.1.0 RTOS (demo-only prebuild)

    Include prebuilt QNX 7 Kernel Demo as 3rd party commercial RTH privileged OS (POS)

  8. The setup script will begin downloading and configuring the assets needed to build the target image. Depending on the feature options selected and state of the build environment, a few notifications may occur. Some of these notifications are described below.

    • RTH Hypervisor Linux BSP package not found

      Note

      If the Real-Time Hypervisor (RTH) package has not been setup correctly, an error will occur. Follow the steps from section Real-Time Systems Hypervisor (RTH) to obtain the Real-Time Hypervisor (RTH) package.

      ../_images/026.png

    • Build directory already exists

      If the setup script is not building the target for the first time, the script will prompt: Build directory ecs-rts-<buster> already exists. Do you want to clean the cached build? y/[n]

      ../_images/063.png

      Press n to retain the target build cache, or press y to delete target build cache.

      Note

      It is advised to delete the target build cache if the target source was modified or the previous build was incomplete. Retaining the target build cache will reduce the build time, but may promote build errors if the target source was modified or the previous build was incomplete. If build errors occur, rerun the setup script and choose y at this prompt.

    For all other notifications, refer to the section links below:

  9. After setting up the build target, the script will prompt: Do you want to run an automated build? y/[n].

    ../_images/A.png

    To perform an automated build, press y at the prompt.

    ../_images/A.png

The build typically takes a very long time. A Linux build system with the recommended specs may take about 1-2 hours to complete. A Linux build system with the minimum specs may take 6+ hours to complete. See section Linux Build System for recommended specs.

../_images/B.png

After the build completes, see section Installing ECI-R to create a bootable USB flash drive to install the ECI image.

Note

The rts-buster target image provides a multi-OS build environment for Debian GNU/Linux 10 (Buster) Distribution generating several bootable RTH Privileged-Mode OS images consolidated with Hypervised Debian Desktop Linux (ie. bitbake eci-image-rts-base) through single image install

Below are a underlying build commands rebuild partially or entirely a specific POS :

  • Privileged Debian Buster PREEMPT_RT Linux 5.4 runtime (ie. bitbake eci-image-xenomai-pos-rth-package)

  • Privileged Debian Buster Xenomai 3.1 Cobalt/Ipipe-x86 Linux 5.4 runtime (ie. bitbake eci-image-rt-pos-rth-package)

  • Privileged Windriver® VxWorks® 7 SR0650 prebuilt-demo runtime (ie. bitbake eci-image-vxworks-pos-rth-package)

  • Privileged QNX® Neutrino® RTOS 7.0.3 (IA 32-bits and 64-bits) prebuilt-demo runtime (ie. bitbake eci-image-qnx-pos-rth-package)

rts-poky target provide the backward compatibility with prior ECI release legacy with Yocto 3.1 Poky build environment if ECI-B and ECI-X Privileged-Mode images deployed as .deb packaged :

  • Privileged Yocto Poky PREEMPT_RT Linux 5.4 runtime (ie. bitbake ecs-image-base-poky-rth-package -c do_package_write_deb)

  • Privileged Yocto Poky Xenomai 3.1 Cobalt/Ipipe-x86 Linux 5.4 runtime (ie. bitbake ecs-image-xenomai-poky-rth-package -c do_package_write_deb)