CM-FX6: U-Boot: Firmware Overview

From Compulab Mediawiki
Jump to: navigation, search

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-2015.07-cm-fx6-3.bin - SPL binary
  • u-boot-2015.07-cm-fx6-3.bin - U-Boot binary
  • u-boot-2015.07-cm-fx6-3.patch - patch vs. v2015.07 mainline U-Boot
  • patches - ordered collection of patches, that form the single patch above (u-boot-2015.07-cm-fx6-3.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


See also