CM-FX6: U-Boot: Firmware Overview

From Compulab Mediawiki
Revision as of 08:47, 30 June 2014 by Nikita (talk | contribs) (Package contents)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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.

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 0xC000 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
0KB Reserved
1KB SPL
64KB U-Boot
512KB Reserved
768KB U-Boot environment
1MB Reserved

Default SD card mapping

Offset Description
0KB Reserved/MBR
1KB SPL
64KB U-Boot
512KB Reserved
1MB Remaining SD-card space


Package contents

images

  • cm-fx6-firmware - U-Boot and SPL binaries combined to a single binary

u-boot

  • spl-2014.04-cm-fx6-1.bin - SPL binary
  • u-boot-2014.04-cm-fx6-1.bin - U-Boot binary
  • u-boot-2014.04-cm-fx6-1.patch - patch vs. v2014.04 mainline U-Boot
  • patches - ordered collection of patches, that form the single patch above (u-boot-2014.04-cm-fx6-1.patch)

Utilities

  • 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

See also