|
|
| Line 16: |
Line 16: |
| | | | |
| | ==How to create a bootable SD card== | | ==How to create a bootable SD card== |
| | + | The process is quite straightforward: it consists of writing the WIC file of interest generated by Yocto onto the SD card. There are multiple ways to do that. |
| | | | |
| − | {{ImportantMessage|text=The procedure described here was tested with a virtual machine such as the [[Managed_Virtual_Machine_(MVM)|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.}}
| + | The most common is by using the well-know BalenaEtcher tool ([https://etcher.balena.io/ download BalenaEtcher]). The following instruction explains how to use it on a Windows host. The procedure is similar with a Linux host. |
| − | | + | * Download the desired binary image to flash (<code>*.wic</code> or <code>*.wic.bz2</code>) |
| − | | + | **Among the binaries made available in the [[mirror:desk-mp1-l/| mirror]] there are several <code>*.wic.bz2</code> files for the available releases. In particular, there is the <code>desk-image-qt5-openstlinux-weston-desk-mp1.wic.bz2</code> file. This image is the one used to program the microsSD card delivired along with the evaluation kit. |
| − | This article shows how to create a bootable microSD for the [[DESK-MP1-L/General/Release_Notes_(DESK-MP1-L)|DESK-MP1-L Release Notes]] kit by using a simple bash script. <br>
| + | * Connect the microSD card to the PC Host |
| − | | |
| − | The procedure has been tested on a MVM released with '''DESK-MP1-L 1.0.0''' release with
| |
| − | * a 32 GB microSD card [1]
| |
| − | * a USB SD card reader
| |
| − | * the binary files delivered along with the [[DESK-MP1-L/General/Release_Notes_(DESK-MP1-L)#Downloadable_binary_images|DESK-MP1-L 1.0.0]]
| |
| − | The resulting card is partitioned as depicted here below:
| |
| − | | |
| − | * partition:
| |
| − | ** 1: ATF binary
| |
| − | ** 2: ATF binary copy
| |
| − | ** 3: Metadata
| |
| − | ** 4: Metadata
| |
| − | ** 5: Fip binary
| |
| − | ** 6: Fip binary copy
| |
| − | ** 7: U-boot environment
| |
| − | ** 8: Boot partition (kernel, dtb, bootscr, splash_image)
| |
| − | ** 9: VendorFS
| |
| − | ** 10: RFS
| |
| − | ** 11: UserFS
| |
| − | | |
| − | Before use the script for create the uSD, prepare the binary needed:
| |
| − | * ATF binary : present on <code>/tftp/desk-mp1-l/uSD_tf-a-stm32mp157a-dcsb5000dd1r.stm32</code> or build it with repo on <code>~/desk-mp1-l/desk-mp1-boot-image</code>
| |
| − | * FIP binary : present on <code>/tftp/desk-mp1-l/uSD_fip.bin</code> or build it with repo on <code>~/desk-mp1-l/desk-mp1-boot-image</code>
| |
| − | * bootscript.txt : create <code>bootscript.txt</code> file and insert the code [[#bootscr|here]] into the script file
| |
| − | * uImage : present on <code>/tftp/desk-mp1-l/uImage</code> or build it with repo on <code>~/desk-mp1-l/linux</code>
| |
| − | * dtb : present on <code>/tftp/desk-mp1-l/desk-mp1-l-1.0.0_stm32mp157a-dcsb5000dd1r.dtb</code> or build it with repo on <code>~/desk-mp1-l/linux</code>
| |
| − | * vendorfs : present on <code>~/desk-mp1-l/rfs/desk-mp1-l-1.0.0_st-image-vendorfs-openstlinux-weston-desk-mp1.tar.xz</code>
| |
| − | * rootfs : present on <code>~/desk-mp1-l/rfs/desk-mp1-l-1.0.0_desk-image-qt5-openstlinux-weston-desk-mp1.tar.xz</code>
| |
| − | * userfs : present on <code>~/desk-mp1-l/rfs/desk-mp1-l-1.0.0_st-image-userfs-openstlinux-weston-desk-mp1.tar.xz</code>
| |
| − | | |
| − | The script - named <code>mksd.sh</code> - can be realized with the following code: | |
| − | <pre>
| |
| − | #!/bin/bash
| |
| − | | |
| − | help(){
| |
| − | echo "$0 Usage:"
| |
| − | echo "$0 <device> <name_binary_to_write> <paths...>"
| |
| − | echo "The value <name_binary_to_write> could be:"
| |
| − | echo " - atf: if you want flash only ATF binary on the uSD"
| |
| − | echo " - fip: if you want flash only FIP binary on the uSD"
| |
| − | echo " - bootfs: if you want build minmal bootfs and flash on the uSD"
| |
| − | echo " - rootfs: if you want flash only FIP file on the uSD"
| |
| − | echo " - vendorfs: if you want flash only FIP file on the uSD"
| |
| − | echo " - userfs: if you want flash only FIP file on the uSD"
| |
| − | echo " - all: if you want flash all binary for uSD"
| |
| − | echo "After the <name_binary_to_write> write the path of the binary to want write"
| |
| − | echo "If you want flash all binary, write all path with this sequence:"
| |
| − | echo "path for ATF, FIP, Bootscr, Kernel, dtb, Vendorfs, Rootfs, Userfs"
| |
| − | }
| |
| − | | |
| − | PARTITION_SIZES=("any" "256K" "256K" "256K" "256K" "4M" "4M" "512K" "64M" "any" "any" "any")
| |
| − | | |
| − | check_usd_partitioning() {
| |
| − | _count=0
| |
| − | _RESIZE_SD=0
| |
| − | if [ $(lsblk -o NAME,SIZE,FSTYPE /dev/$DEVICE | grep -Ec "${DEVICE}[0-11]*") != "12" ]
| |
| − | then
| |
| − | _RESIZE_SD=1
| |
| − | fi
| |
| − | | |
| − | if [ "$_RESIZE_SD" == "0" ]
| |
| − | then
| |
| − | while IFS= read -r line; do
| |
| − | partition=$(echo "$line" | awk '{print $1}')
| |
| − | size=$(echo "$line" | awk '{print $2}')
| |
| − | fstype=$(echo "$line" | awk '{print $3}')
| |
| − | | |
| − | echo "Partition: $partition"
| |
| − | echo "Dimension: $size"
| |
| − | if [ -z "$fstype" ]
| |
| − | then
| |
| − | echo "Partition type: None"
| |
| − | else
| |
| − | echo "Partition type: $fstype"
| |
| − | fi
| |
| − | | |
| − | if [[ ${PARTITION_SIZES[${_count}]} ]]
| |
| − | then
| |
| − | if [ "${PARTITION_SIZES[${_count}]}" != "any" ]
| |
| − | then
| |
| − | if [ "${PARTITION_SIZES[${_count}]}" != "$size" ]
| |
| − | then
| |
| − | echo "This partition aren't correct! expected ${PARTITION_SIZES[${_count}]}"
| |
| − | _RESIZE_SD=1
| |
| − | break
| |
| − | fi
| |
| − | fi
| |
| − | fi
| |
| − | echo ""
| |
| − | ((_count += 1))
| |
| − | | |
| − | done <<<"$(lsblk -o NAME,SIZE,FSTYPE /dev/$DEVICE | grep -E "${DEVICE}[0-11]*")"
| |
| − | fi
| |
| − | | |
| − | if [ "$_RESIZE_SD" == "1" ]
| |
| − | then
| |
| − | echo "formatting uSD because incorrect partitioning!"
| |
| − | umount /dev/${DEVICE}*
| |
| − | sudo sgdisk -o /dev/$DEVICE
| |
| − | partprobe
| |
| − | sudo sgdisk --resize-table=128 -a 1 \
| |
| − | -n 1:34:545 -c 1:"fsbl1" -t 1:8301 \
| |
| − | -n 2:546:1057 -c 2:"fsbl2" -t 2:8301 \
| |
| − | -n 3:1058:1569 -c 3:"metadata1" -t 3:8301 \
| |
| − | -n 4:1570:2081 -c 4:"metadata2" -t 4:8301 \
| |
| − | -n 5:2082:10273 -c 5:"fip" -u 3:4fd84c93-54ef-463f-a7ef-ae25ff887087 \
| |
| − | -n 6:10274:18465 -c 6:"fip" -u 4:09c54952-d5bf-45af-acee-335303766fb3 \
| |
| − | -n 7:18466:19489 -c 7:"uboot-env" -t 7:8301 \
| |
| − | -n 8:19490:150561 -c 8:"bootfs" -t 8:8300 \
| |
| − | -n 9:150562:183329 -c 9:"vendorfs" -t 9:8300 \
| |
| − | -n 10:183330:4377633 -c 10:"rootfs" -t 10:8300 -u 8:491f6117-415d-4f53-88c9-6e0de54deac6\
| |
| − | -n 11:4377634:4639777 -c 11:"userfs" -t 11:8300 \
| |
| − | -p /dev/$DEVICE
| |
| − | | |
| − | partprobe
| |
| − | mkfs.ext4 -F -L bootfs "/dev/${DEVICE}8"
| |
| − | mkfs.ext4 -F -L vendorfs "/dev/${DEVICE}9"
| |
| − | mkfs.ext4 -F -L rootfs "/dev/${DEVICE}10"
| |
| − | mkfs.ext4 -F -L userfs "/dev/${DEVICE}11"
| |
| − | fi
| |
| − | }
| |
| − | | |
| − | flash_atf(){
| |
| − | if file -b "$2" | grep -q "data"
| |
| − | then
| |
| − | dd if=$2 of=/dev/${1}1 conv=fdatasync
| |
| − | dd if=$2 of=/dev/${1}2 conv=fdatasync
| |
| − | else
| |
| − | echo "ATF binary not valid!"
| |
| − | exit 1
| |
| − | fi
| |
| − | }
| |
| − | | |
| − | flash_fip(){
| |
| − | if file -b $2 | grep -q "data"
| |
| − | then
| |
| − | dd if=$2 of=/dev/${1}5 conv=fdatasync
| |
| − | dd if=$2 of=/dev/${1}6 conv=fdatasync
| |
| − | else
| |
| − | echo "FIP binary not valid!"
| |
| − | exit 1
| |
| − | fi
| |
| − | }
| |
| − | | |
| − | flash_bootfs(){
| |
| − | if [ -f "$2" ] && [ -f "$3" ] && [ -f "$4" ]
| |
| − | then
| |
| − | mkfs.ext4 -F -L bootfs "/dev/${1}8"
| |
| − | echo "do bootfs"
| |
| − | mount /dev/${1}8 /mnt
| |
| − | mkimage -C none -A ARM -T script -n DESK-MP1 -d $2 /mnt/boot.scr
| |
| − | cp $3 /mnt
| |
| − | cp $4 /mnt
| |
| − | sync
| |
| − | umount /dev/${1}8
| |
| − | else
| |
| − | echo "Invalid argument for build and flash boofs!"
| |
| − | exit 1
| |
| − | fi
| |
| − | }
| |
| − | | |
| − | flash_vendorfs(){
| |
| − | if [[ -f $2 ]]
| |
| − | then
| |
| − | mkfs.ext4 -F -L vendorfs "/dev/${1}9"
| |
| − | echo "do vendorfs"
| |
| − | mount /dev/${1}9 /mnt
| |
| − | tar -xf $2 -C /mnt
| |
| − | sync
| |
| − | umount /dev/${1}9
| |
| − | else
| |
| − | echo "Vendorfs file not valid!"
| |
| − | exit 1
| |
| − | fi
| |
| − | }
| |
| − | | |
| − | flash_rootfs(){
| |
| − | if [[ -f $2 ]]
| |
| − | then
| |
| − | mkfs.ext4 -F -L rootfs "/dev/${1}10"
| |
| − | echo "do rootfs"
| |
| − | mount /dev/${1}10 /mnt
| |
| − | tar -xf $2 -C /mnt
| |
| − | sync
| |
| − | umount /dev/${1}10
| |
| − | else
| |
| − | echo "Rootfs file not valid!"
| |
| − | exit 1
| |
| − | fi
| |
| − | }
| |
| − | | |
| − | flash_userfs(){
| |
| − | echo "valore userfs $2"
| |
| − | if [[ -f $2 ]]
| |
| − | then
| |
| − | mkfs.ext4 -F -L userfs "/dev/${1}11"
| |
| − | echo "do userfs"
| |
| − | mount /dev/${1}11 /mnt
| |
| − | tar -xf $2 -C /mnt
| |
| − | sync
| |
| − | umount /dev/${1}11
| |
| − | else
| |
| − | echo "Userfs file not valid!"
| |
| − | exit 1
| |
| − | fi
| |
| − | }
| |
| − | | |
| − | if [[ -z $1 || -z $2 || -z $3 ]]
| |
| − | then
| |
| − | help
| |
| − | exit 1
| |
| − | fi
| |
| − | | |
| − | if [ "$(whoami)" != "root" ]
| |
| − | then
| |
| − | echo "you must be root to run this script!"
| |
| − | exit
| |
| − | fi
| |
| − | | |
| − | if ! [[ -b "/dev/$1" ]]
| |
| − | then
| |
| − | echo "/dev/$1 is not a valid block device!"
| |
| − | exit
| |
| − | fi
| |
| − | | |
| − | DEVICE=$1
| |
| − | check_usd_partitioning
| |
| − | | |
| − | umount /dev/${DEVICE}*
| |
| − | | |
| − | if [[ "$2" == "atf" ]]
| |
| − | then
| |
| − | flash_atf $1 $3
| |
| − | fi
| |
| − | | |
| − | if [[ "$2" == "fip" ]]
| |
| − | then
| |
| − | flash_fip $1 $3
| |
| − | fi
| |
| − | | |
| − | if [[ "$2" == "bootfs" ]]
| |
| − | then
| |
| − | if [[ -z $3 || -z $4 || -z $5 ]]
| |
| − | then
| |
| − | help
| |
| − | exit 1
| |
| − | fi
| |
| − | flash_bootfs $1 $3 $4 $5
| |
| − | fi
| |
| − | | |
| − | if [[ "$2" == "vendorfs" ]]
| |
| − | then
| |
| − | flash_vendorfs $1 $3
| |
| − | fi
| |
| − | | |
| − | if [[ "$2" == "rootfs" ]]
| |
| − | then
| |
| − | flash_rootfs $1 $3
| |
| − | fi
| |
| − | | |
| − | if [[ "$2" == "userfs" ]]
| |
| − | then
| |
| − | flash_userfs $1 $3
| |
| − | fi
| |
| − | | |
| − | if [[ "$2" == "all" ]]
| |
| − | then
| |
| − | if [[ -z $3 || -z $4 || -z $5 || -z $6 || -z $7 || -z $8 || -z $9 || -z $10 ]]
| |
| − | then
| |
| − | help
| |
| − | exit 1
| |
| − | fi
| |
| − | flash_atf $1 $3
| |
| − | flash_fip $1 $4
| |
| − | flash_bootfs $1 $5 $6 $7
| |
| − | flash_vendorfs $1 $8
| |
| − | flash_rootfs $1 $9
| |
| − | flash_userfs $1 ${10}
| |
| − | fi
| |
| − | | |
| − | echo "[Done]"
| |
| − | </pre>
| |
| − | | |
| − | Here is an example that shows how to use this script. We use here files delivered with [[DESK-MP1-L/General/Release_Notes_(DESK-MP1-L)#Downloadable_binary_images|DESK-MP1-L 1.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: <code>boot.scr</code> | |
| − | * Linux kernel: <code>uImage</code>
| |
| − | * Device tree blob: <code>stm32mp157a-dcsb5000dd1r.dtb</code>. | |
| − | | |
| − | In the case of you don't have some file on MVM, please download it from [https://mirror.dave.eu/desk-mp1-l mirro.dave.eu].
| |
| − | | |
| − | You can now run the script, by passing the following parameters:
| |
| − | * Device file of the microSD card (<code>sdb</code> in the example)
| |
| − | * operation to do (next variable depend from operation used):
| |
| − | ** Absolute path of ATF binary
| |
| − | ** Absolute path of FIP binary
| |
| − | ** Absolute path of bootscritp.txt
| |
| − | ** Absolute path of uImage binary
| |
| − | ** Absolute path of dtb binary
| |
| − | ** Absolute path of vendorfs tar.xz
| |
| − | ** Absolute path of rootfs tar.xz
| |
| − | ** Absolute path of userfs tar.xz | |
| − | | |
| − | <pre>
| |
| − | sudo ./mksd.sh sdb all /tftp/desk-mp1-l/uSD_tf-a-stm32mp157a-dcsb5000dd1r.stm32 /tftp/desk-mp1-l/uSD_fip.bin ./bootscript.txt /tftp/desk-mp1-l/uImage /tftp/desk-mp1-l/desk-mp1-l-1.0.0_stm32mp157a-dcsb5000dd1r.dtb ~/desk-mp1-l/rfs/desk-mp1-l-1.0.0_st-image-vendorfs-openstlinux-weston-desk-mp1.tar.xz ~/desk-mp1-l/rfs/desk-mp1-l-1.0.0_desk-image-qt5-openstlinux-weston-desk-mp1.tar.xz ~/desk-mp1-l/rfs/desk-mp1-l-1.0.0_st-image-userfs-openstlinux-weston-desk-mp1.tar.xz
| |
| − | </pre>
| |
| − | | |
| − | Another example where we update only a partition:
| |
| − | | |
| − | * update FIP(U-boot) partition
| |
| − | | |
| − | <pre>
| |
| − | sudo ./mksd.sh sdb fip /tftp/desk-mp1-l/uSD_fip.bin
| |
| − | </pre>
| |
| − | | |
| − | * update bootfs partition
| |
| − | | |
| − | <pre>
| |
| − | sudo ./mksd.sh sdb bootfs ./bootscript.txt /tftp/desk-mp1-l/uImage /tftp/desk-mp1-l/desk-mp1-l-1.0.0_stm32mp157a-dcsb5000dd1r.dtb
| |
| − | </pre>
| |
| − | | |
| − | === 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 <i>boot.scr</i> U-Boot bootscript.
| |
| − | | |
| − | Here below there is an example on how to create a <code>boot.scr</code> file from the '''bootscript.txt''' for booting from SD card:
| |
| − | | |
| − | <pre>
| |
| − | echo 'bootscript generated with command "./tools/mkimage -C none -A arm -T script -d boot.src.cmd boot.scr.uimg"'
| |
| − | | |
| − | setenv desk_release 'desk-mp1-l-1.0.0'
| |
| − | | |
| − | if test 0x${som_configid#} = 0x00000001;
| |
| − | then
| |
| − | if test 0x${cb_configid#} = 0x00000001;
| |
| − | then
| |
| − | setenv fdtfile stm32mp157a-dcsb5000dd1r.dtb
| |
| − | else
| |
| − | echo Invalid CB! Autoreset ...
| |
| − | sleep 30
| |
| − | reset
| |
| − | fi
| |
| − | else
| |
| − | echo Invalid SOM! Autoreset ...
| |
| − | sleep 30
| |
| − | reset
| |
| − | fi
| |
| − | | |
| − | setenv bootfile uImage
| |
| − | | |
| − | # if booting from NOR assume that this bootscript is inside uSD
| |
| − | # so override boot_device/boot_instance to continue booting from this device
| |
| − | if test ${boot_device} = "nor"
| |
| − | then
| |
| − | env set boot_device = "mmc"
| |
| − | env set boot_instance = "0"
| |
| − | fi
| |
| − | | |
| − | if test ${boot_instance} = "1";
| |
| − | then
| |
| − | env set b_part 6
| |
| − | env set rfs_part mmcblk2p8
| |
| − | else
| |
| − | env set b_part 8
| |
| − | env set rfs_part mmcblk1p10
| |
| − | fi
| |
| − | | |
| − | ext4load ${boot_device} ${boot_instance}:${b_part} ${fdtaddr} /${fdtfile}
| |
| − | ext4load ${boot_device} ${boot_instance}:${b_part} ${loadaddr} /${bootfile}
| |
| − | run mmc0args addcons
| |
| − | bootm ${loadaddr} - ${fdtaddr}
| |
| − | </pre>
| |
| − | | |
| − | and compile it using:
| |
| − | | |
| − | <pre>
| |
| − | mkimage -A ARM -T script -C none -n DESK-MP1 -d bootscript.txt boot.scr
| |
| − | </pre>
| |
| − | | |
| − | == How to flash wic binary on uSD ==
| |
| − | | |
| − | Among the binaries made available in the [[mirror:desk-mp1-l/| mirror]] there are several <code>*.wic.bz2</code> files, in the various releases, in particular there is the <code>desk-image-qt5-openstlinux-weston-desk-mp1.wic.bz2</code> file which is the binary present in the uSD of the kit. | |
| − | | |
| − | download the <code>*.wic.bz2</code> binary of the release you want.
| |
| − | | |
| − | Use BalenaEtcher tool ([https://etcher.balena.io/ download BalenaEtcher]), for flash the uSD with <code>*.wic.bz2</code> file.
| |
| − | | |
| − | === How use BalenaEtcher on Windows ===
| |
| − | | |
| − | * Download the binary to flash <code>*.wic</code> or <code>*.wic.bz2</code>
| |
| − | * Connect the uSD to the PC Host | |
| | * Open BalenaEtcher tool | | * Open BalenaEtcher tool |
| − | * On the tool | + | * Once the tool is open: |
| | ** Select the binary to flash by clicking on "Flash from file" | | ** Select the binary to flash by clicking on "Flash from file" |
| | ** Select the uSD to flash by clicking on "Select target" | | ** Select the uSD to flash by clicking on "Select target" |
| − | ** Flash the uSD by clicking o "Flash" | + | ** Flash the uSD by clicking o "Flash". |
| | + | |
| | + | TBD insert screenshot |
| | + | |
| | | | |
| | ---- | | ---- |
| | | | |
| | [[Category:ETRA]] | | [[Category:ETRA]] |
GET A QUOTE
ONLINE HELPDESK
