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/linux1.png

This section provides the steps to build an ECI rts-buster (ECI-R) image.

Prerequisite

Make sure that you complete the steps in Setting up ECI Build before proceeding to build an ECI rts-buster image.

Building ECI ``rts-buster`` Image

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. Do the following to build the image:

  1. Copy the Real-Time Hypervisor (RTH) package “RTH-Release5.X.XX.XXXXX.zip” to the ECI/rth_releases/ directory and unzip it. For details on obtaining the RTH package, refer to Real-Time Systems Hypervisor (RTH).

    ../_images/036.png

  2. Extract the archive. In Ubuntu, right-click the archive and select Extract Here.

    ../_images/045.png
    ../_images/055.png

  3. Run the setup script:

    $ ./setup.sh
    ../_images/setup1.png

  4. A list of pre-configured use cases will be displayed. Select custom to start configuring a custom build.

    ../_images/use-cases1.png

  5. A list of available build targets will be displayed. Select rts-buster from the list.

    ../_images/016.png

  6. A list of features available for rts-buster will be displayed. Select or deselect the features that you want to include in the image. Use the arrow keys to scroll through the list of options and use the spacebar to toggle the state. Press enter to finalize the selection.

    ../_images/093.png

    The following table lists the available options:

    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. A list of virtualized privileged OS (POS) included in the image are listed. Select/deselect features to be included in the image. Use the arrow keys to scroll through the list of options and use the spacebar to toggle the state. Press enter to finalize the selection.

    ../_images/103.png

    The following table lists the available options:

    Feature Option

    Description

    Linux preemptive rt-kernel aka PREEMPT_RT

    Includes the Linux kernel with PREEMPT_RT patchset as RTH POS

    Linux & Xenomai 3.1.1 Cobalt Dual-kernel

    Includes Linux kernel with Xenomai I I-pipe as RTH POS

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

    Includes prebuilt Wind-River Vxworks 7 Kernel Demo as third-party commercial RTH POS

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

    Includes prebuilt QNX 7 Kernel Demo as third-party commercial RTH privileged OS (POS)

The setup script will begin configuring the assets needed to build the target image. Depending on the feature options selected and the state of the build environment, a few notifications might be displayed:

  • RTH Hypervisor Linux BSP package not found

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

    ../_images/025.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 recommended that you 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 might cause 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, click the following links:

  1. 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 specifications might take about 1-2 hours to complete. A Linux build system with the minimum specifications might take over 6 hours to complete. Refer Linux Build System for the recommended specifications.

../_images/B1.png

After the build completes, refer 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 (that is, bitbake eci-image-rts-base) through a single image installation.

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

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

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

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

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

rts-poky target is backward compatible with ECI release legacy with Yocto 3.1 Poky build environment, if ECI-B and ECI-X Privileged-Mode images are deployed as .deb packages:

  • Privileged Yocto Poky PREEMPT_RT Linux 5.4 runtime (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 (bitbake ecs-image-xenomai-poky-rth-package -c do_package_write_deb)