CM-FX6: U-Boot: Firmware Overview
Contents
Introduction
This article describes the firmware for CM-FX6 system-on-module. CM-FX6 firmware consists of two components provided in a single binary: Secondary Program Loader (SPL) and U-Boot. SPL is the bootstrap utility invoked by the CPU internal boot ROM code of the i.MX6 SoC. The i.MX6 boot ROM tries to boot SPL from either SD card, or SPI flash, as determined by the hardware boot selector (BOOT SELECT button). SPL performs minimal hardware initializations and loads U-Boot from the same boot storage device. If loading U-Boot from MMC fails, SPL will try to load it from the SPI flash as a fall back. U-Boot initializes hardware modules necessary for system boot and loads the operating system.
Package contents
images
- cm-fx6-firmware - U-Boot and SPL binaries combined to a single binary
u-boot
- spl-2014.10-cm-fx6-2.1.bin - SPL binary
- u-boot-2014.10-cm-fx6-2.1.bin - U-Boot binary
- u-boot-2014.10-cm-fx6-2.1.patch - patch vs. v2014.10 mainline U-Boot
- patches - ordered collection of patches, that form the single patch above (u-boot-2014.10-cm-fx6-2.1.patch)
Utilities
- firmware_scripts - A collection of helper scripts
- cm-fx6-bootloader-update.sh - A script for updating U-Boot from Linux
- combine_firmware.sh - A script for combining SPL and U-Boot to a single binary
- splash_image - Splash image examples
SPL
SPL is responsible for initial clock setup, DDR initialization and boot media controller initialization. It is loaded into the CPU internal SRAM immediately after system reset. After basic hardware setup, SPL loads U-Boot bootloader into the system RAM and transfers control to the U-Boot bootloader. SPL resides at 0x400 offset from the start of its storage (either SPI flash, or MMC/SD card).
U-Boot
U-Boot is the bootloader used on CM-FX6. It allows flexible selection of operating system boot modes, provides scripting facilities and command line interface through a serial port. U-Boot allows booting operating system from the on-board NAND flash, the on-board SSD, or the network (TFTP/NFS server). U-Boot resides at offset 0x10000 from the start of its storage.
Please consult U-Boot quick reference and U-Boot project documentation for U-Boot features and commands description.
U-Boot environment
U-Boot environment resides on the SPI flash, regardless of the boot source. The environment resides at offset 0xC0000 from the start of SPI flash, and its size is 8KiB.
Boot sources
CM-FX6 can boot from either a micro SD card, or the on-board SPI flash.
The following sections describe the layout of each storage type.
Default SPI flash mapping
Offset | Description | Size |
---|---|---|
0KB | Reserved | 1KB |
1KB | SPL | 63KB |
64KB | U-Boot | 448KB |
512KB | Reserved | 256KB |
768KB | U-Boot environment | 256KB |
1MB | Splash image | Remaining SPI flash space |
Default SD card mapping
Offset | Description | Size |
---|---|---|
0KB | Reserved/MBR | 1KB |
1KB | SPL | 63KB |
64KB | U-Boot | 448KB |
512KB | Reserved | 512KB |
1MB | Remaining SD-card space | Remaining SD-card space |
Default NAND flash mapping
Offset | Description | Size |
---|---|---|
0MB | Linux kernel | 7.5MB |
7.5MB | Device tree blob | 0.5MB |
8MB | Linux filesystem | Remaining NAND flash space |