[[File:TBD.png|thumb|center|200px|Work in progress]] <section begin="History" />

!colspan="4" style="width:100%; text-align:left"; border-bottom:solid 2px #ededed"|History

!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|VersionIssue Date!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Issue DateNotes|-| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |{{oldid|14119|2021/07/16}}| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |First DESK release|-| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |{{oldid|16989|2022/03/04}}| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |DESK-MX6-L 3.0.0 release|-!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000" |2023/04/27! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:white#000000"|NotesDESK-MX6-L 4.0.0 release

<section end="History" />__FORCETOC__<section begin="Body" />

{{ImportantMessage|text=The procedure described here was tested with a physical machine. In case of a virtual machine such as the [[Managed_Virtual_Machine_(MVM)|MVM]], it might not work properly. Also, it is worth remembering that The USB controller of the MVM is disabled should be enabled by default. See also [[MVM_FAQs#Q:_How_to_use_the_USB_devices_connected_to_the_host_machine.3F|this section]]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/General/Release_Notes_(DESK-MX6-L)Release_Notes|DESK-MX6-L Release Notes]] kit by using a simple bash script. <br>'''Note:''' Starting from this '''DESK-MX6-L 1.0.0''' release the support for the SPL has been introduced in UbootU-Boot. Previous versions of this script will no longer produce a fully functional and bootable microSD card. <br>

The procedure has been tested on a Linux PC running Ubuntu LTS (>=MVM released with '''DESK-MX6-L 4.0.0'TBD'') distribution release with *a 16 32 GB microSD card [1]*a USB SD card reader*the binary files delivered along with the [[Axel_Embedded_Linux_Kit_(XELK)DESK-MX6-L/General/Release_Notes#Downloadable_binary_images|DESKMX6DESK-MX6-L ''14.x0.x''0]].The resulting card is partitioned as depicted [[Axel_Embedded_Linux_Kit_(XELK)#XELK_microSD_Layout|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 <code>mksd.sh</code> - looks like thiscan be realized with the following code:

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

echo "you must be root to run this script!" exit

echo "$1 is not a valid block device!" exit

echo "Incorrect u-boot.img location!" exit

echo "Incorrect SPL location!" exit

echo "Incorrect Binaries location!" exit

echo "Incorrect rootfs location!" exit

echo "You're using a mmc device, I need to fix partition names" PART="p"

PART=""

exit

{ echo 1040,1380,0x0c,* echo 13901420,,83,- } | sfdisk -D -H 255 -S 63 -C $CYLINDERS $DRIVE

echo 1016M,4086M8176M,0x0c,* echo 4096M8192M,,83,-

mkfs.ext3 -F -L ROOTFS "$DRIVE$PART"2 #> /dev/null # wait for the VM to recognize the uSDsleep 60

Here is an example that shows how to use this script. Let's assume that the binary We use here files were downloaded in the <code>desk<delivered with [[DESK-MX6-L/code> subdirectory of the working directoryGeneral/Release_Notes#Downloadable_binary_images|DESK-MX6-L 4.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:

* splash image: <code>splash_image.bmp</code>* Linux kernel: <code>uImagedesk-mx6-l-4.0.0_uImage</code>* Device tree blob: <code>imx6qdesk-xelkmx6-l-24.0.0_imx6dl-0sbcx-0cb0012.dtb</code>.

This is In the list case of the you don't have some file on MVM, please download it from [https://mirror.dave.eu/desk-mx-l/ mirror.dave.eu]. We will copy them into <code>~/desk-mx-l/desk</code> directory. Needed binary files that will can be used by found on <code>MVM</code> in the scriptfollowing location:

dvdk@vagrant:~$ ll /tftpboot/desk-mxmx6-l$ ls -la desk/total 754811360drwxrwxrdrwxr-xr-x 2 dvdk dvdk root 4096 Oct Apr 9 163 17:22 57 ./drwxrwxrdrwxr-xr-x 6 dvdk 3 dvdk root 4096 Oct Apr 9 4 07:16../-rw-r--r-- 1 dvdk root 52247 Apr 3 17:38 desk-mx6-l-4.0.0_imx6dl-sbcx-cb0012.dtb-rw-r--r-- 1 dvdk root 52560 Apr 3 17:38 desk-mx6-l-4.0.0_imx6dl-sbcx-cb0013.dtb-rw-r--r-- 1 dvdk root 52161 Apr 3 17:22 38 desk-mx6-l-4.0.0_imx6dl-sbcx-cb0018.dtb-rw-r--r-- 1 dvdk root 53231 Apr 3 17:38 desk-mx6-l-4.0.0_imx6dl-sbcx-cb0050.dtb-rw-r--r-- 1 dvdk root 53760 Oct 52536 Apr 9 163 17:38 desk-mx6-l-4.0.0_imx6dl-sbcx-cb0055.dtb-rw-r--r-- 1 dvdk root 48736 Apr 3 17:38 desk-mx6-l-4.0.0_imx6dl-xelk-l.dtb-rw-r--r-- 1 dvdk root 53524 Apr 3 17:22 imx6q38 desk-mx6-l-4.0.0_imx6q-sbcx-cb0012.dtb-rw-r--r-- 1 dvdk root 53833 Apr 3 17:38 desk-mx6-l-4.0.0_imx6q-sbcx-cb0013.dtb-rw-r--r-- 1 dvdk root 50177 Apr 3 17:38 desk-mx6-l-4.0.0_imx6q-xelk-l-2-0-0.dtb-rw-r--r-- 1 dvdk root 50009 Apr 3 17:38 desk-mx6-l-4.0.0_imx6q-xelk-l.dtb-rw-r--r-- 1 dvdk root 56320 Apr 3 17:38 desk-mx6-l-4.0.0_mx6qdldesk_SPL-rw-r--r-- 1 dvdk root 56320 Apr 3 17:38 desk-mx6-l-4.0.0_mx6qdldesk_nand_SPL-rw-r--r-- 1 dvdk root 576288 Apr 3 17:38 desk-mx6-l-4.0.0_mx6qdldesk_nand_u-boot.img-rw-r--r-- 1 dvdk root 56320 Oct Apr 9 163 17:22 SPL38 desk-mx6-l-4.0.0_mx6qdldesk_spi_SPL-rw-r--r-- 1 dvdk root 554004 Apr 3 17:38 desk-mx6-l-4.0.0_mx6qdldesk_spi_u-boot.img-rw-r--r-- 1 dvdk root 569864 Oct 576000 Apr 9 163 17:22 u38 desk-mx6-l-4.0.0_mx6qdldesk_u-boot.img-rw-r--r-- 1 dvdk root 8038640 Apr 3 17:38 desk-mx6-l-4.0.0_uImage-rw-r--r-- 1 dvdk root 1152054 Apr 3 17:38 splash_image.bmpdvdk@vagrant:~$ ll ~/desk-mx-l/desk-mx6-l-4.0.0_boot.scr -rw-rw-r-- 1 dvdk dvdk 7031520 Oct 1556 Apr 9 163 17:57 /home/dvdk/desk-mx-l/desk-mx6-l-4.0.0_boot.scrdvdk@vagrant:~$ mkdir -p ~/desk-mx-l/desk/dvdk@vagrant:~$ cp /tftpboot/desk-mx6-l/desk-mx6-l-4.0.0_uImage ~/desk-mx-l/desk/desk-mx6-l-4.0.0_uImagedvdk@vagrant:~$ cp /tftpboot/desk-mx6-l/desk-mx6-l-4.0.0_imx6dl-sbcx-cb0012.dtb ~/desk-mx-l/desk/desk-mx6-l-4.0.0_imx6dl-sbcx-cb0012.dtbdvdk@vagrant:22 uImage~$ cp ~/desk-mx-l/desk-mx6-l-4.0.0_boot.scr ~/desk-mx-l/desk/boot.scrdvdk@vagrant:~$ cp /tftpboot/desk-mx6-l/splash_image.bmp ~/desk-mx-l/desk/dvdk@vagrant:~$ cp ~/desk-mx-l/rfs/desk-mx6-l-4.0.0_modules.tar.gz ~/desk-mx-l/desk/

*Device file of the microSD card (<code>/dev/sdcsdb</code> in the example)

*Path of the directory containing the bootscript file, the splash image, the Linux kernel image, and the device tree blob files

dvdk@vagrant:~/desk-mx-l$ umount /dev/sdb*dvdk@vagrant:~/desk-mx-l$ sudo ./mksddesk-mx6-l-4.0.0_mksd.sh /dev/sd<x> <usdb /tftpboot/desk-mx6-l/desk-mx6-l-4.0.0_mx6qdldesk_u-boot.img/tftpboot/desk-mx6-l/desk-mx6-l-4.0.0_mx6qdldesk_SPL ~/desk-mx-l/desk ./rfs/desk-image-qt6-desk-mx6.tar.bz2 All data on /dev/sdb now will be destroyed! Continue? [y/n]y[Partitioning /dev/sdb...]1024+0 records in1024+0 records out1048576 bytes (1.0 MB, 1.0 MiB) copied, 0.228364 s, 4.6 MB/sDISK SIZE - 31914983424 bytesChecking that no-one is using this disk right now ... OK Disk /dev/sdb: 29.74 GiB, 31914983424 bytes, 62333952 sectorsDisk model: Transcend Units: sectors of 1 * 512 = 512 bytesSector size (logical/physical): 512 bytes / 512 bytesI/O size (minimum/optimal): 512 bytes / 512 bytes >> <SPL> Created a new DOS disklabel with disk identifier 0xeba9791f./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 21.7 GiB./dev/sdb3: Done. New situation:Disklabel type: dosDisk identifier: 0xeba9791f 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 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 5694592 4k blocks and 1425408 inodesFilesystem UUID: 2b7edb0e-b75b-4685-87b9-1933bfd0c8f0Superblock backups stored on blocks: 32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632, 2654208, 4096000 Allocating group tables: done Writing inode tables: done Creating journal (32768 blocks): doneWriting superblocks and filesystem accounting information: done  [Copying files...]'/home/dvdk/desk-mx-l/desk/ <rfs_filenameboot.scr' ->'/mnt/boot.scr''/home/dvdk/desk-mx-l/desk/desk-mx6-l-4.0.0_imx6dl-sbcx-cb0012.dtb' -> '/mnt/desk-mx6-l-4.0.0_imx6dl-sbcx-cb0012.dtb''/home/dvdk/desk-mx-l/desk/desk-mx6-l-4.0.0_uImage' -> '/mnt/desk-mx6-l-4.0.0_uImage'TBD '/home/dvdk/desk-mx-l/desk/splash_image.bmp' -> '/mnt/splash_image.bmp'[Extracting rfs (this may take a while...)][Programming SPL]110+0 records in110+0 records out56320 bytes (56 kB, 55 KiB) copied, 0.0340295 s, 1.7 MB/s[Programming u-boot.img]562+1 records in562+1 records out576000 bytes (576 kB, 562 KiB) copied, 0.201931 s, 2.9 MB/s[Done]

===Binary images on SD card - bootscr ===

echo 'bootscript generated with command "mkimage -A ARM -T script -C none -n AXEL-Lite-DESK-SBCX MX6 -d bootscript.txt boot.scr"'

setenv desk_release 'desk-mx6-l-14.0.0'

if test 0x${cb_configid#} = 0x00000002;then if test ${cpu} = 6DL; then setenv fdtfile ${desk_release}_imx6dl-sbcx.dtb else setenv fdtfile ${desk_release}_imx6q-sbcx.dtb fielif test 0x${cb_configid#} = 0x00000003;then if test ${cpu} = 6DL; then setenv fdtfile ${desk_release}_imx6dl-sbcx-cb0003.dtb else setenv fdtfile ${desk_release}_imx6q-sbcx-cb0003.dtb fielif test 0x${cb_configid#} = 0x00000012;

elif test 0x${cb_configid#} = 0xffffffff0x00000077;then if test ${cpu} = 6DL; then setenv fdtfile ${desk_release}_imx6dl-sbcx-cb0077.dtb else setenv fdtfile ${desk_release}_imx6q-sbcx-cb0077.dtb fielif test 0x${cb_configid#} = 0x00000001;

setenv fdtfile ${desk_release}_imx6dl-deskxelk-l-2.0.0.dtb

setenv fdtfile ${desk_release}_imx6q-deskxelk-l-2.0.0.dtb

setenv bootfile ${desk_release}_uImageuImage

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

mkimage -A ARM -T script -C none -n AXELDESK-Lite-DESKMX6-SBCX L -d bootscript.txt boot.scr