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

History
Version	Issue Date	Notes
1.0.0	Jun 2021	First DESK release
3.0.0	Feb 2022	3.0.0 DESK release

How to create a bootable SD card

The procedure described here was tested with a virtual machine such as the MVM. The USB controller of the MVM should be enabled by default. If you are using Linux-based distribution and are having trouble detecting a USB device in virtual machine, please make sure your user belongs to the vboxusers group.

This article shows how to create a bootable microSD for the DESK-MX6-L Release Notes kit by using a simple bash script.
Note: Starting from DESK-MX6-L 1.0.0 release the support for the SPL has been introduced in U-Boot. Previous versions of this script will no longer produce a fully functional and bootable microSD card.

The procedure has been tested on a MVM released with DESK-MX6-L 3.0.0 release with

• a 16 GB microSD card [1]
• a USB SD card reader
• the binary files delivered along with the DESK-MX6-L 3.0.0.

The resulting card is partitioned as depicted here below:

• bootable partition (mmcblk0p1, vfat) containing:
  • binary images (U-Boot and kernel images)
• root file system partition (mmcblk0p2, ext3)
  • root file system binaries and init scripts

The script - named mksd.sh - can be realized with the following code:

#!/bin/bash

if [[ -z $1 || -z $2 || -z $3 || -z $4 || -z $5 ]]
then
        echo "$0 Usage:"
        echo "  $0 <device> <u-boot.img> <SPL> <binaries directory> <rootfs tar.bz2>"
        echo "  Example: $0 /dev/sdc u-boot.img SPL binaries/ rootfs.tar.bz2"
        exit
fi

if [ "$(whoami)" != "root" ]
then
        echo "you must be root to run this script!"
        exit
fi

if ! [[ -b $1 ]]
then
        echo "$1 is not a valid block device!"
        exit
fi

if ! [[ -e $2 ]]
then
        echo "Incorrect u-boot.img location!"
        exit
fi

if ! [[ -e $3 ]]
then
        echo "Incorrect SPL location!"
        exit
fi

if ! [[ -d $4 ]]
then
        echo "Incorrect Binaries location!"
        exit
fi

if ! [[ -f $5 ]]
then
        echo "Incorrect rootfs location!"
        exit
fi

DRIVE=$1
if [[ "$DRIVE" == *"mmcblk"* ]]
then
        echo "You're using a mmc device, I need to fix partition names"
        PART="p"
else
        PART=""
fi
UBOOT=$2
SPL=$3
BINARIES=$4
RFS=$5

echo "All data on "$DRIVE" now will be destroyed! Continue? [y/n]"
read ans
if ! [ $ans == 'y' ]
then
        exit
fi

echo "[Partitioning $1...]"

dd if=/dev/zero of=$DRIVE bs=1024 count=1024

SIZE=`fdisk -l $DRIVE | grep Disk | awk '{print $5}'`

echo DISK SIZE - $SIZE bytes

CYLINDERS=`echo $SIZE/255/63/512 | bc`

# check if we're running an old (e.g. 2.20.x) or new (e.g. 2.24.x) sfdisk
sfdisk --help | grep -- -H

if [ "$?" -eq "0" ]
then
        {
                echo 40,1380,0x0c,*
                echo 1420,,83,-
        } | sfdisk -D -H 255 -S 63 -C $CYLINDERS $DRIVE
else
{
    echo 16M,8176M,0x0c,*
    echo 8192M,,83,-
} | sfdisk $DRIVE
fi

partprobe


echo "[Making filesystems...]"
mkfs.vfat -F 32 -n BOOT "$DRIVE$PART"1 #> /dev/null
mkfs.ext3 -F -L ROOTFS "$DRIVE$PART"2 #> /dev/null

echo "[Copying files...]"

binaries_dir=${BINARIES%/}
mount "$DRIVE$PART"1 /mnt
cp -av --no-preserve=ownership $binaries_dir/* /mnt/
umount "$DRIVE$PART"1

echo "[Extracting rfs (this may take a while...)]"
mount "$DRIVE$PART"2 /mnt
tar jxf $RFS -C /mnt > /dev/null
chmod 755 /mnt
umount "$DRIVE$PART"2

echo "[Programming SPL]"
dd if=$SPL of=$DRIVE bs=512 seek=2 conv=fsync

echo "[Programming u-boot.img]"
dd if=$UBOOT of=$DRIVE bs=1k seek=69 conv=fsync

echo "[Done]"

Here is an example that shows how to use this script. We use here files delivered with DESK-MX6-L 3.0.0 release. Before invoking the script, the following files has to be renamed in order to make them compatible with the default U-Boot environment variables:

• bootscript: boot.scr
• splash image: splash_image.bmp
• Linux kernel: desk-mx6-l-3.0.0_uImage
• Device tree blob: desk-mx6-l-3.0.0_imx6dl-sbcx-cb0012.dtb.

We will copy them into ~/desk-mx-l/desk directory. Needed binary files can be found on MVM in the following location:

dvdk@vagrant:~$ ll /tftpboot/desk-mx-l/
total 11616
drwxr-xr-x 2 dvdk root    4096 Feb 24 13:11 ./
drwxr-xr-x 3 dvdk root    4096 Feb 24 13:08 ../
-rw-r--r-- 1 dvdk root   51910 Feb 24 13:10 desk-mx6-l-3.0.0_imx6dl-sbcx-cb0012.dtb
-rw-r--r-- 1 dvdk root   52223 Feb 24 13:10 desk-mx6-l-3.0.0_imx6dl-sbcx-cb0013.dtb
-rw-r--r-- 1 dvdk root   51824 Feb 24 13:10 desk-mx6-l-3.0.0_imx6dl-sbcx-cb0018.dtb
-rw-r--r-- 1 dvdk root   52894 Feb 24 13:10 desk-mx6-l-3.0.0_imx6dl-sbcx-cb0050.dtb
-rw-r--r-- 1 dvdk root   52199 Feb 24 13:10 desk-mx6-l-3.0.0_imx6dl-sbcx-cb0055.dtb
-rw-r--r-- 1 dvdk root   48399 Feb 24 13:10 desk-mx6-l-3.0.0_imx6dl-xelk-l.dtb
-rw-r--r-- 1 dvdk root   53187 Feb 24 13:10 desk-mx6-l-3.0.0_imx6q-sbcx-cb0012.dtb
-rw-r--r-- 1 dvdk root   53496 Feb 24 13:10 desk-mx6-l-3.0.0_imx6q-sbcx-cb0013.dtb
-rw-r--r-- 1 dvdk root   49840 Feb 24 13:10 desk-mx6-l-3.0.0_imx6q-xelk-l-2-0-0.dtb
-rw-r--r-- 1 dvdk root   49672 Feb 24 13:11 desk-mx6-l-3.0.0_imx6q-xelk-l.dtb
-rw-r--r-- 1 dvdk root   60416 Feb 24 13:08 desk-mx6-l-3.0.0_mx6qdldesk_nand_SPL
-rw-r--r-- 1 dvdk root  625300 Feb 24 13:08 desk-mx6-l-3.0.0_mx6qdldesk_nand_u-boot.img
-rw-r--r-- 1 dvdk root   60416 Feb 24 13:08 desk-mx6-l-3.0.0_mx6qdldesk_spi_SPL
-rw-r--r-- 1 dvdk root  602668 Feb 24 13:08 desk-mx6-l-3.0.0_mx6qdldesk_spi_u-boot.img
-rw-r--r-- 1 dvdk root   60416 Feb 24 13:08 desk-mx6-l-3.0.0_mx6qdldesk_SPL
-rw-r--r-- 1 dvdk root  624932 Feb 24 13:08 desk-mx6-l-3.0.0_mx6qdldesk_u-boot.img
-rw-r--r-- 1 dvdk root 8154280 Feb 24 13:10 desk-mx6-l-3.0.0_uImage
-rw-r--r-- 1 dvdk root 1152054 Feb 24 13:08 splash_image.bmp
dvdk@vagrant:~$ ll ~/desk-mx-l/desk-mx6-l-3.0.0_boot.scr 
-rw-rw-r-- 1 dvdk dvdk 1556 Feb 24 14:43 /home/dvdk/desk-mx-l/desk-mx6-l-3.0.0_boot.scr
dvdk@vagrant:~$ cp /tftpboot/desk-mx-l/desk-mx6-l-3.0.0_uImage ~/desk-mx-l/desk/desk-mx6-l-3.0.0_uImage
dvdk@vagrant:~$ cp /tftpboot/desk-mx-l/desk-mx6-l-3.0.0_imx6dl-sbcx-cb0012.dtb ~/desk-mx-l/desk/desk-mx6-l-3.0.0_imx6dl-sbcx-cb0012.dtb
dvdk@vagrant:~$ cp ~/desk-mx-l/desk-mx6-l-3.0.0_boot.scr ~/desk-mx-l/desk/boot.scr
dvdk@vagrant:~$ cp /tftpboot/desk-mx-l/splash_image.bmp ~/desk-mx-l/desk/

You can now run the script, by passing the following parameters:

• Device file of the microSD card (/dev/sdb in the example)
• U-Boot image
• SPL
• Path of the directory containing the bootscript file, the splash image, the Linux kernel image and the device tree blob files
• Archive of the target's root file system (compressed as .tar.bz2 file).

dvdk@vagrant:~/desk-mx-l$ sudo ./desk-mx6-l-3.0.0_mksd.sh /dev/sdb /tftpboot/desk-mx-l/desk-mx6-l-3.0.0_mx6qdldesk_u-boot.img /tftpboot/desk-mx-l/desk-mx6-l-3.0.0_mx6qdldesk_SPL ~/desk-mx-l/desk ./rfs/desk-mx6-l-3.0.0_desk-image-qt5-desk-mx6.tar.bz2 
All data on /dev/sdb now will be destroyed! Continue? [y/n]
y
[Partitioning /dev/sdb...]
1024+0 records in
1024+0 records out
1048576 bytes (1.0 MB, 1.0 MiB) copied, 2.01554 s, 520 kB/s
DISK SIZE - 15931539456 bytes
Checking that no-one is using this disk right now ... OK

Disk /dev/sdb: 14.86 GiB, 15931539456 bytes, 31116288 sectors
Disk model: Transcend       
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes

>>> Created a new DOS disklabel with disk identifier 0x40f56c1d.
/dev/sdb1: Created a new partition 1 of type 'W95 FAT32 (LBA)' and of size 8 GiB.
/dev/sdb2: Created a new partition 2 of type 'Linux' and of size 6.9 GiB.
/dev/sdb3: Done.

New situation:
Disklabel type: dos
Disk identifier: 0xe38701f1

Device     Boot    Start      End  Sectors  Size Id Type
/dev/sdb1  *       32768 16777215 16744448    8G  c W95 FAT32 (LBA)
/dev/sdb2       16777216 62333951 45556736 21.7G 83 Linux

New situation:
Disklabel type: dos
Disk identifier: 0x40f56c1d

Device     Boot    Start      End  Sectors  Size Id Type
/dev/sdb1  *       32768 16777215 16744448    8G  c W95 FAT32 (LBA)
/dev/sdb2       16777216 31116287 14339072  6.9G 83 Linux

The partition table has been altered.
Calling ioctl() to re-read partition table.
Syncing disks.
[Making filesystems...]
mkfs.fat 4.1 (2017-01-24)
mke2fs 1.45.5 (07-Jan-2020)
Creating filesystem with 1792384 4k blocks and 448800 inodes
Filesystem UUID: 969ecf69-e872-4709-b325-627b3d1c9201
Superblock backups stored on blocks: 
        32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632

Allocating group tables: done                            
Writing inode tables: done                            
Creating journal (16384 blocks): done
Writing superblocks and filesystem accounting information: done 

[Copying files...]
'/home/dvdk/desk-mx-l/desk/boot.scr' -> '/mnt/boot.scr'
'/home/dvdk/desk-mx-l/desk/desk-mx6-l-3.0.0_imx6dl-sbcx-cb0012.dtb' -> '/mnt/desk-mx6-l-3.0.0_imx6dl-sbcx-cb0012.dtb'
'/home/dvdk/desk-mx-l/desk/desk-mx6-l-3.0.0_uImage' -> '/mnt/desk-mx6-l-3.0.0_uImage'
'/home/dvdk/desk-mx-l/desk/splash_image.bmp' -> '/mnt/splash_image.bmp'
[Extracting rfs (this may take a while...)]
[Programming SPL]
118+0 records in
118+0 records out
60416 bytes (60 kB, 59 KiB) copied, 0.129522 s, 466 kB/s
[Programming u-boot.img]
610+1 records in
610+1 records out
624932 bytes (625 kB, 610 KiB) copied, 1.84936 s, 338 kB/s
[Done]

[1] In case you have a different size, you'll need to change the sfdisk parameters accordingly.

bootscr

Once you got the new binaries compiled from your modified sources, they have to be installed on first SD partition preserving the original file names used into boot.scr u-boot bootscript.

Here below there is an example on how to create a boot.scr file from the bootscript.txt for booting from SD card:

'V��3Fb���6"�DESK-MX6-L�echo 'bootscript generated with command "mkimage -A ARM -T script -C none -n DESK-MX6-L -d bootscript.txt boot.scr"'

setenv desk_release 'desk-mx6-l-3.0.0'

if test 0x${cb_configid#} = 0x00000012;
then
        if test ${cpu} = 6DL; then
                setenv fdtfile ${desk_release}_imx6dl-sbcx-cb0012.dtb
        else
                setenv fdtfile ${desk_release}_imx6q-sbcx-cb0012.dtb
        fi
elif test 0x${cb_configid#} = 0x00000013;
then
        if test ${cpu} = 6DL; then
                setenv fdtfile ${desk_release}_imx6dl-sbcx-cb0013.dtb
        else
                setenv fdtfile ${desk_release}_imx6q-sbcx-cb0013.dtb
        fi
elif test 0x${cb_configid#} = 0x00000001;
then
        if test ${cpu} = 6DL; then
                setenv fdtfile ${desk_release}_imx6dl-xelk-l.dtb
        else
                setenv fdtfile ${desk_release}_imx6q-xelk-l.dtb
        fi
elif test 0x${cb_configid#} = 0x00000018;
then
        setenv fdtfile ${desk_release}_imx6dl-sbcx-cb0018.dtb
elif test 0x${cb_configid#} = 0x00000050;
then
        setenv fdtfile ${desk_release}_imx6dl-sbcx-cb0050.dtb
elif test 0x${cb_configid#} = 0x00000055;
then
        setenv fdtfile ${desk_release}_imx6dl-sbcx-cb0055.dtb
elif test 0x${cb_configid#} = 0xffffffff;
then
        setenv fdtfile ${desk_release}_imx6q-xelk-l-2-0-0.dtb
else
    echo Invalid CB! Autoreset ...
    sleep 30
        reset
fi

setenv bootfile ${desk_release}_uImage

setenv mmc_loadk 'fatload mmc ${mmcdev}:1 ${loadaddr} ${bootfile}'
setenv mmc_loadfdt 'fatload mmc ${mmcdev}:1 ${fdtaddr} ${fdtfile}'

echo Booting DESK-MX6-L via mmcboot with ${fdtfile} as device tree

run mmcboot

echo mmcboot FAILURE

and compile it using:

mkimage -A ARM -T script -C none -n DESK-MX6-L -d bootscript.txt boot.scr

Then copy the boot.scr into the <binaries_dir> directories used by the script to create the SD card.

Attention !

• /home/dvdk/desk-mx-l/desk-mx6-l-3.0.0_boot.scr has been generated using the images available at the moment of VM creation: please, use the previous indication as an example on how to create a proper bootscript for your own purposes
• /home/dvdk/desk-mx-l/desk-mx6-l-3.0.0_mksd.sh bash script has been validated using a single SD card version: the size of the partitions and the related sfdisk parameters have to be properly modified according to your own SD card used and to your partitions specification. You can use it an an example to be modified according your use case

---