Deployment
Finally, you will find the built images in platform-<platformname>/images.
Complete system images:
- uboot-sd.img
The complete system images are intend for:
- development system initialisation
- deployment
Bootloader images:
- u-boot.bin
- u-boot-with-spl-pbl-mmcsd-2017.07.bin
- u-boot-with-spl-pbl-ecc-mmcsd-2017.07.bin
- u-boot-pbl.bin.bswap
- u-boot-pbl.bin.ecc.bswap
- u-boot-pbl.bin.ae.ecc.bswap
Linux images:
- linuximage : Kernel (zImage)
- ls1021a-tqmls1021a-mbls102x.dtb : device tree blob for TQMLS102xA on MBLS102xA
Rootfs images:
- root.tgz : Root file system archive (for NFS etc.)
- root.ext2 : Root file system partition image (for system update)
- root.ubi : ubi partition for QSPI NOR
- root.ubifs : ubifs image for QSPI NOR
Firmware images:
- firmware.tgz : firmware image contains all devicetree blobs and linux kernel image
- firmware.img : firmware image archive (for firmware image creation)
Create SD Card with BSP Image
To install a new firmware use SD cards. To copy the built images on the host system to a connected card type:
$ cd <BSP project>/platform-<platform_name>/images $ sudo dd if=@mod_name_code@_hd.img of=/dev/sdf bs=1M conv=fsync #Assuming the SD card is assigned to /dev/sdf
To find out what device file the SD card has, type “dmesg” after you connect the card to see the system messages. At the bottom you'll see some “Attached scsi …” messages along with something like:
[ 8197.588395] sdf: sdf1
Updating existing firmware over ethernet
To update bootloader / kernel / devicetree in a running system you have to copy the images to a tftp directory and upload them to the eMMC or SD Card.
Please see How to setup TFTP Server
1. Boot from eMMC or SD and stop autoboot in U-Boot
Hit any key to stop autoboot: 0 =>
2. Set U-Boot variable mmcdev according to the drive you want to write to
=> setenv mmcdev <Nr.>
mmcdev 0 = SD Card (if eMMC ist not placed)
mmcdev 0 = eMMC (if eMMC ist placed)
3. Connect device via ethernet to a tftp server supplying the image
4. Provide the correct network configuration in U-Boot:
- ⇒ setenv autoload no
- ⇒ setenv serverip <serverip> (e.g.: setenv serverip 192.168.100.110)
- ⇒ setenv ipaddr <ipaddr> (e.g.: setenv ipaddr 192.168.100.111)
- ⇒ setenv netmask <netmask> (e.g.: setenv netmask 255.255.255.0)
5. Provide U-Boot the file name of the desired image on the tftp server:
- For U-Boot update on eMMC/SD Card : ⇒ setenv uboot <filename>
- For U-Boot update on QSPI NOR : ⇒ setenv uboot-qspi <filename>
- For Device Tree update on eMMC/SD Card and QSPI NOR : ⇒ setenv fdt_file <filename>
- For Kernel update on eMMC/SD Card and QSPI NOR : ⇒ setenv zimage <filename>
6. Perform Update:
- U-Boot update on eMMC /SD Card : ⇒ run update_uboot
- U-Boot update on QSPI NOR : ⇒ run update_uboot-qspi
- Device Tree update on eMMC /SD Card : ⇒ run update_fdt
- Device Tree update on QSPI NOR : ⇒ run update_fdt-qspi
- Kernel update on eMMC /SD Card : ⇒ run update_kernel
- Kernel update on QSPI NOR : ⇒ run update_kernel-qspi
Using NFS boot
Prerequisites
To boot the @mod_name@ from network you need a working bootloader in eMMC/SD-card or SPI-NOR (placement option on @mod_name@) which is able to get the kernel image over tftp and to provide the kernel with commandline settings for NFS.
The dtb-file and kernel image have to be provided via tftp and the rootfs via nfs.
Configuration of U-Boot Environment
The bootloader environment needs to be modified to work with your tftp-server and your nfs-server.
- setenv autoload no
- setenv serverip <serverip> (e.g.: setenv serverip 192.168.100.1)
- setenv ipaddr <ipaddr> (e.g.: setenv ipaddr 192.168.0.10)
- setenv netmask <netmask> (e.g.: setenv netmask 255.255.255.0)
- setenv rootpath <rootpath> (NFS share has to set in /etc/exports on the Computer that runs the NFS server first)
- setenv fdt_file <fdt_file> (name of devicetree file to be downloaded from the tftp server)
- setenv zimage <zimage> (name of the Linux kernel image to be downloaded from the tftp server)
TQ-Systems GmbH provides the Board Support Packages (BSP) free of charge. The software included in the shipment has been configured individually for the starter kits. The software is only intended to evaluate the module. The use of the Board Support Packages (BSP) is only allowed within the scope of functionality described by TQ-Systems GmbH. TQ-Systems GmbH does not accept any liability for all further changes of the Board Support Package and for any damage resulting from its use.