Flashing Yocto with SOAFEE using NVMe M.2 SSD / USB

The following provide procedures for how to flash Yocto images with SOAFEE and boot via an NVMe M.2 SSD or USB drive.

Boot using NVMe M.2 SSD

Preparing bootable medium

1. Before deploying the image to your target device, a tool is needed to copy the image using its block map. Here, we use bmap-tools, which can be installed on your Ubuntu-based host using the following command:

sudo apt install bmap-tools

2. To install the binaries into a USB drive, download the flasher image to make the bootable USB drive and enter the following command:

Note : Make sure the USB is formatted before proceeding installation and unmounting the USB drive.

$ bmaptool copy --bmap adlink-image-validation-comhpc.wic.bmap adlink-image-validation-comhpc.wic.gz /dev/sda ( X should be replaced with respect device like sda, sdc or sdd )
For Example: ( USB Device  uses /dev/sda device node )

3. Once completed, replug your USB drive (bootable drive) into your host system. You should see 3 partitions as exemplified below.

</media/<local_directory>/msdos>
</media/<local_directory>/root>
</media/<local_directory>/data>

4. Download the Yocto image with SOAFEE layers from here and copy the files into"</media/<directory>/root>" using the following commands.

$ sudo cp <Image_Downloaded_Directory>adlink-image-validation-comhpc.wic.gz </media/<directory>/root/home>
$ sudo cp <Image_Downloaded_Directory>adlink-image-validation-comhpc.wic.bmap </media/<directory>/root/home>

5. After copying the image and bmap file onto the USB drive, type the “sync” command on the terminal before removing it from the host device.


Installing binaries onto NVMe M.2 SSD

  1. Insert the USB drive and boot the system from USB drive.

    • Press 【Esc】while booting to get the boot manger

    • Go into Boot Manger > Select your USB Drive > USB Boot

    Note: Make sure to log in as root with NO password via VGA Display.

  2. Flash the image to the target’s NVMe M.2 SSD using the following bmaptool command:

    $ cd  /
    $ bmaptool copy --bmap /home/adlink-image-validation-comhpc.wic.bmap /home/adlink-image-validation-comhpc.wic.gz /dev/nvme0n1

  3. Reboot your host system using the following command.

    $ reboot


Booting from NVMe M.2 SSD

1. Now you can boot from your NVMe M.2 SSD

  • Press [Esc] key while booting to get the boot manger

  • Go into Boot Manger > Select your USB Drive > NVMe M.2 SSD Boot

2. Log in as root with NO password to finish.


Boot using USB drive

Preparing bootable medium

1. Before deploying the image to your target device, a tool is needed to copy the image using its block map. Here, we use bmap-tools, which can be installed on your Ubuntu-based host via the following command:

sudo apt install bmap-tools

2. To flash the Yocto Image with SOAFEE layers, download the SOAFEE image here to make the bootable USB drive and enter the following command:

Note : Make sure the USB is formatted before proceeding installation and unmounting the USB drive.

$ bmaptool copy --bmap ewaol-virtualization-image-ava.wic.bmap ewaol-virtualization-image-ava.wic.gz /dev/sda ( X should be replaced with respect device like sda, sdc or sdd )
For Example: ( USB Device  uses /dev/sda device node )

3. Once completed, replug your USB drive (bootable drive) into your host system. You should see 2 partitions as exemplified below.

</media/<local_directory>/msdos>
</media/<local_directory>/root>

Booting from USB drive

1. Insert the USB drive and boot the system from USB drive.

  • Press 【Esc】 while booting to get the boot manger

  • Go into Boot Manger > Select your USB Drive > USB Boot

2. Log in as root with NO password via VGA Display.

Note: This image does note require a bmap-tool command.