Difference between revisions of "IOT-DIN-IMX8PLUS: Yocto Linux: Installation"

From Compulab Mediawiki
Jump to: navigation, search
 
Line 1: Line 1:
 
== Overview ==
 
== Overview ==
This article provides instructions needed to install the Yocto Linux live image onto the Compulab IOT-DIN-IMX8PLUS internal storage.</br>
 
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 {{filename|/dev/sdX}}.
 
 
== Preparing the Yocto Linux live image ==
 
* The Yocto Linux live image and block map file (bmap), mentioned below, are generated during the [[IOT-DIN-IMX8PLUS: Yocto Linux: Building Yocto images | Building IOT-DIN-IMX8PLUS Yocto]] process:
 
:* Live image: ''imx-image-multimedia-iot-din-imx8plus.wic.bz2''== Overview ==
 
 
This article provides instructions needed to install the Yocto Linux live image onto the Compulab IOT-DIN-IMX8PLUS internal storage.</br>
 
This article provides instructions needed to install the Yocto Linux live image onto the Compulab IOT-DIN-IMX8PLUS internal storage.</br>
 
The recommended installation procedure is using a host PC with a Debian-based operating system.
 
The recommended installation procedure is using a host PC with a Debian-based operating system.
Line 93: Line 81:
  
 
* Press '''Yes''' to reboot the device, unplug installation media
 
* Press '''Yes''' to reboot the device, unplug installation media
 
:* Block map file: ''imx-image-multimedia-iot-din-imx8plus.wic.bmap''
 
== Preparing Installation Media ==
 
* Flash the image file to the USB flash drive by the means of '''bmaptool''' utility:
 
<pre>
 
sudo bmaptool copy ~/path/to/imx-image-multimedia-iot-din-imx8plus.wic.bz2 --bmap ~/path/to/imx-image-multimedia-iot-din-imx8plus.wic.bmap /dev/sdX
 
</pre>
 
 
== Run Yocto Linux live image ==
 
* Insert the USB flash drive into one of the USB ports. It's recommended to use [[IOT-DIN-IMX8PLUS: Getting Started#Front_panel|USB3.0 port]]
 
* Power on the device and wait for the GRUB menu
 
 
== Installing Yocto images onto the internal storage ==
 
* In the GRUB menu choose '''Install Linux''' option
 
<pre>
 
                          GNU GRUB  version 2.04-20
 
 
┌────────────────────────────────────────────────────────────────────────────┐
 
│ Boot Linux Image-5.15.32+g637c4c0a2ba2                                    │
 
│*Install Linux                                                              │
 
│ Advanced Boot Options                                                      │
 
│                                                                            │
 
│                                                                            │
 
│                                                                            │
 
│                                                                            │
 
│                                                                            │
 
│                                                                            │
 
│                                                                            │
 
│                                                                            │
 
└────────────────────────────────────────────────────────────────────────────┘
 
 
      Use the ▲ and ▼ keys to select which entry is highlighted.         
 
      Press enter to boot the selected OS, `e' to edit the commands     
 
      before booting or `c' for a command-line.                         
 
</pre>
 
* The installer will start running automatically:
 
<pre>
 
          +--------cl-deploy will get started in 5 seconds-----------+
 
          | Configuration file /etc/cl-auto.conf parameters:        |
 
          | --------------------------------------------------      |
 
          | # Destination is the module inthernal media.            |
 
          | # Autoinstaller how to:                                  |
 
          | ## cp /usr/share/cl-deploy/cl-auto.conf.sample          |
 
          | /etc/cl-auto.conf                                        |
 
          | ## cl-auto -A                                            |
 
          | DST=/dev/mmcblk2                                        |
 
          | QUIET=Yes                                                |
 
          | UDEV=No                                                  |
 
          | --------------------------------------------------  91%  |
 
          +----------------------------------------------------------+
 
          |                <Stop Auto Installer>                    |
 
          +----------------------------------------------------------+
 
</pre>
 
* When installation is complete, the following message will show up:
 
<pre>
 
              +-------------------Success----------------------+
 
              | Remove installation media & Press Enter        |
 
              |                                                |
 
              |                                                |
 
              +------------------------------------------------+
 
              |                <Press Enter>                  |
 
              +------------------------------------------------+
 
</pre>
 
 
* Remove the USB flash drive from the unit
 
* Press '''Enter''' to reboot the unit
 
 
[[Category:Linux]]
 
[[Category:Yocto]]
 
[[Category:IOT-DIN-IMX8PLUS]]
 

Latest revision as of 15:39, 16 March 2025

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

  • 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