TQMa6x - YOCTO Linux BSP documentation


Create SD-Card image

Create SD Card with BSP Image

There are two common ways to write the image to an SD card: using the highly recommended bmaptool (which is significantly faster) or the standard dd command.

Method 1: Using bmaptool (Recommended)

The bmaptool provides a faster and safer way to flash images. It automatically utilizes the .bmap file to skip empty blocks, verifies the integrity during flashing, and can flash compressed images (like .wic.zst) on the fly without manual extraction. 

$ cd <path to your image>
$ sudo bmaptool copy tq-image-weston-debug-tqma6qdl-multi-mba6x.rootfs.wic.zst /dev/sdc #Assuming the SD card is assigned to /dev/sdc

Method 2: Using the dd command

Alternatively, the uncompressed image can be simply written to the SD Card by using the dd shell command in Linux: 

$ cd <path to your image>
$ sudo dd if=tq-image-weston-debug-tqma6qdl-multi-mba6x.rootfs.wic of=/dev/sdc bs=1M conv=fsync #Assuming the SD card is assigned to /dev/sdc

Identify the SD Card

To identify the SD card in Linux, the shell command dmesg can be used:

  1. Open a new terminal
  2. Execute the following command without plugged SD Card: 
     $ dmesg | tail -n 15
  3. Insert SD Card and wait a few seconds
  4. Run the command from step two again:
$ dmesg | tail -n 15 
#plug in SD Card into the reader
$ dmesg | tail -n 15