DESK-MX6-L/Development/How to create a bootable microSD card

History
Issue Date	Notes
2021/07/16	First DESK release
2022/03/04	DESK-MX6-L 3.0.0 release
2023/04/27	DESK-MX6-L 4.0.0 release
2024/06/13	DESK-MX6-L 4.x.x release

How to create a bootable SD card

This article shows how to (re)create the bootable SD card, from the binary images produced by the DESK-MX-L Yocto build, using a standard SD image flasher like balenaEtcher

The process is relatively straightforward: it consists of writing the WIC file of interest generated by Yocto onto the SD card. The following instruction explains how to use balenaEtcher on a Windows host. The procedure is similar when working with a Linux host.

• download the desired binary image to flash (*.wic or *.wic.bz2) from the mirror binary server selecting the proper DESK-MX6-L release
  • among the binaries made available in the mirror there are several *.wic.bz2 files for the available releases. In particular, there is the dave-image-devel-desk-mx6.wic.bz2 file. This image is the one used to program the microSD card delivered along with the evaluation kit.
• connect the microSD card to the PC Host
• open balenaEtcher tool
• once the tool is open:
  • select the binary to flash by clicking on "Flash from file"
  • select the microSD to flash by clicking on "Select target"
  • flash the uSD by clicking o "Flash".

Unpacking

Flashing

Validating

SD card structure

The created SD card has the following structure:

• raw sectors for the bootloader storage: tipically this is a 8MB raw part where storing the bootloader binaries (like SPL and u-boot.img) for the U-boot startup
• FAT32 first partition: this will be mapped to the /dev/mmcblk0p1 device in Linux
  • usually this partition contains the Linux kernel binary and the device tree blob
  • the splash screen image is stored in this partition too for a splash image showing during U-Boot startup
• ext4 second partition: this will be mapped to the /dev/mmcblk0p2 device in Linux
  • this partition contains the Linux root file system

Creating the SD card from binary artifacts

Even if the overall binary artifacts have been created by the Yocto build, it is highly discouraged to manually create the SD card starting from them.

The Yocto build take care about the overall binary consistance (like kernel modules and so on) avoiding to mistmatch different version.

Moreover, the SD card is intended to be used during the development process and not for the production phase (where other deployment specifications and details have to be taken into account).