IOT-DIN-IMX8PLUS: Yocto Linux: Installation
Contents
Overview
This article provides instructions needed to install the Yocto Linux live image onto the Compulab IOT-DIN-IMX8PLUS internal storage.
The recommended installation procedure is using a host PC with a Debian-based operating system.
Preparing the workstation
- Obtain a Debian-based workstation with a free USB port.
 - Install bmap-tools package if not installed
 - Obtain a USB flash drive. Any commercially available USB flash drive of 4GB (or larger) may be used for the installation.
 - Plug the USB flash drive into the host PC. From now we assume the device name of the flash drive on your Linux PC is /dev/sdX.
 
Preparing the Yocto Linux live image
- The Yocto Linux live image and block map file (bmap), mentioned below, are generated during the Building IOT-DIN-IMX8PLUS Yocto process:
 
- Live image archive: fsl-image-network-full-cmdline-iotdin-imx8p.rootfs.wic.zst
 - Block map file: fsl-image-network-full-cmdline-iotdin-imx8p.rootfs.wic.bmap
 
Preparing Installation Media
- Unpack the image archive:
 
zstd -dc fsl-image-network-full-cmdline-iotdin-imx8p.rootfs.wic.zst > fsl-image-network-full-cmdline-iotdin-imx8p.rootfs.wic
- Flash the image file to the USB flash drive by the means of bmaptool utility:
 
sudo bmaptool copy ~/path/to/fsl-image-network-full-cmdline-iotdin-imx8p.rootfs.wic --bmap ~/path/to/ fsl-image-network-full-cmdline-iotdin-imx8p.rootfs.wic.bmap /dev/sdX
Run Yocto Linux live image
- Insert the USB flash drive into the USB3.0 port located on the front panel
 - Power on the device
 - Wait for the automatic Linux login
 
Installing Yocto images onto the internal storage
- Invoke cl-deploy utility
 
root@iotdin-imx8p:~# cl-deploy
- Select /dev/mmcblk2 as a destination device
 
Select a destination device
─────────────────────────────────────────────────────────────────────────────────────────
       ┌─────────────────────────────────────────────────────────────────────┐
       │  Available Devices:                                                 │
       │ ┌─────────────────────────────────────────────────────────────────┐ │
       │ │                                                                 │ │
       │ │                      (*) /dev/mmcblk2                           │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ └─────────────────────────────────────────────────────────────────┘ │
       │                     <  OK  >        <Cancel>                        │
       └─────────────────────────────────────────────────────────────────────┘
- The following warning message will show up.
 
Start Deployment
─────────────────────────────────────────────────────────────────────────────────────────
       ┌──────────────────────────── WARNING ────────────────────────────────┐
       │ Src: /dev/sda -> Dst: /dev/mmcblk2                                  │
       │                                                                     │
       │ All data on /dev/mmcblk2 will be destroyed                          │
       │                                                                     │
       │                                                                     │
       │                                                                     │
       │─────────────────────────────────────────────────────────────────────│
       │                     <  Yes  >      <  No  >                         │
       └─────────────────────────────────────────────────────────────────────┘
- Confirm installation onto internal media by choosing Yes
 - Installation will start
 - When installation is complete, the following message will show up:
 
Finished with success
─────────────────────────────────────────────────────────────────────────────────────────
       ┌─────────────────────────────────────────────────────────────────────┐
       │ Boot media has been deployed on /dev/mmcblk2                        │
       │                                                                     │
       │ Would you like to reboot the device now?                            │
       │                                                                     │
       │                                                                     │
       │                                                                     │
       │─────────────────────────────────────────────────────────────────────│
       │                     <  Yes  >      <  No  >                         │
       └─────────────────────────────────────────────────────────────────────┘
- Press Yes to reboot the device, unplug installation media