Attention

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

Install ECI Image for Yocto-based Zephyr (Legacy)

After building the legacy-poky-zephyr-ehl image you are ready to install the image on a target system.

To deploy the image on a target system, you need to do the following:

  1. Create a bootable USB

  2. Boot target system from Slim Bootloader and install image

Create Bootable USB for Zephyr (Legacy)

../../_images/linux5.png

Do the following to create a bootable USB, which you will later use to build and install the ECI image:

  1. Open a terminal to the ECI directory. In Ubuntu*, you can right-click an empty space in the directory explorer and select Open in Terminal.

    ../../_images/C2.png

  2. Insert a USB drive with at least 12 GB capacity into the Linux build system.

    Note: For best performance, use a USB 3.1 (or greater) device and port.

    Warning

    All data on the USB mass storage device will be erased!

    At the terminal prompt, run the create_bootable_usb.sh script:

    $ ./create_bootable_usb.sh

    If the message “Please run as root” appears, run the script again with sudo:

    $ sudo ./create_bootable_usb.sh
    ../../_images/0121.png

    If no ECI images have been built yet, the script will display the message: No built images found. Refer to Build ECI and build an ECI image. Then, run the create_bootable_usb.sh script.

    ../../_images/0213.png

  3. The script will display a list of available ECI images. Enter an image name from the list. This example has only the legacy-poky-zephyr-ehl target image.

    ../../_images/zephyr-01.png

    If a mass storage device cannot be located, the script will display the message: ERR: No removable mass storage devices found. Insert a USB drive with at least 12 GB capacity into the Linux build system and run the create_bootable_usb.sh script again.

    ../../_images/zephyr-02.png

  4. The script will display a list of available removable mass storage devices.

    ../../_images/zephyr-03.png

    Enter the name of a device from the displayed list. In this example, the device name displayed is sdb.

    ../../_images/zephyr-04.png

    When the warning, Warning: All data will be erased on <device> Proceed? [y/N] is displayed, enter y to proceed. The target ECI image will be written to the removable mass storage device.

  5. After the script completes, you will have a bootable USB drive that can install the target ECI image. Eject the USB drive from the Linux build system. You will use this USB drive to boot and install the image.

    ../../_images/zephyr-05a.png

Boot and Install Image for Zephyr (Legacy)

The following steps are applicable to:

../../_images/target_generic7.png

To boot the target system from Slim Bootloader (SBL) and install the image, insert the bootable USB drive created earlier into the target system, and do the following:

  1. Power ON the target system boots from SBL. The target system will begin the installation process.

  2. During the installation, the message Please select an install target or press n to exit is displayed. Enter an available install target (make sure that the target is correct). For example, enter mmcblk0.

  3. If you see the prompt /dev/mmcblk0# contains a ext4 file system … Proceed anyway? (y,N), press y to continue.

  4. After the installation is complete, remove the USB drive and press Enter` on the keyboard to reboot the target system to Zephyr OS. Follow the section FuSa Sanity Checks to run a few sanity checks.