Running U-Boot Print


As explained in Installing U-Boot to the STM32F429 Discovery Board, you have to install U-Boot to the internal Flash of the STM32F429 in order to run Linux (uClinux) on the Discovery board. U-Boot runs as the primary firmware from the internal Flash on each power-on / reset.

U-Boot is probably the most popular firmware monitor for Linux. It is developed and maintained by DENX Software Engineering ( If you need detailed information on any aspects of U-Boot operation, DENX publishes extensive U-Boot user documentation at their web site.

On the STM32F429, U-Boot runs directly from the internal Flash. Volatile data (stack, variables, dynamic pool) are maintained in the internal SRAM. External RAM is not used unless you explicitly call a U-Boot command with an argument pointing to a memory location in SDRAM.

As soon as the Discovery board is powered on or reset, the STM32F429 proceeds to boot the U-Boot firmware from the internal Flash printing the following output to the serial console:

U-Boot 2010.03-cortexm-1.14.2 (Sep 04 2015 - 19:58:13)

CPU : STM32F4 (Cortex-M4)
Freqs: SYSCLK=180MHz,HCLK=180MHz,PCLK1=45MHz,PCLK2=90MHz
Board: STM32F429-DISCOVERY Rev 1.A
In: serial
Out: serial
Err: serial
Net: STM32_MAC
Hit any key to stop autoboot: 0

If you hit any key on the serial console before the number of seconds defined by the U-Boot bootdelay variable has elapsed, you will enter the U-Boot interactive command monitor. From the command monitor you can run U-Boot commands to examine memory, load an image from Ethernet or UART, boot Linux from a loaded image or perform any other action supported by U-Boot.

U-Boot makes use of the so-called environment variables to define various aspects of the target functionality. On the Discovery board, the U-Boot environment is stored in the internal Flash of the STM32F429 and is persistent across power or reset cycles. Parameters defined by the U-boot environment variables include: target IP address, target MAC address, location in RAM where a Linux bootable image will be loaded, and many others.

To manipulate the U-Boot environment the following commands are used:

  • printenv <var> - print the value of the variable var. Without arguments, prints all environment variables:
  • STM32F429-DISCO> printenv
    bootargs=stm32_platform=stm-disco console=ttyS0,115200 panic=10
    bootcmd=run envmboot
    Environment size: 589/4092 bytes

  • setenv <var> <val> - set the variable var to the value val:
  • STM32F429-DISCO> setenv image vlad/networking.uImage

    Running setenv <var> will unset (undefine) a specified U-Boot variable.

  • saveenv - save the up-to-date U-Boot environment, possibly updated using setenv commands, into internal Flash. Running saveenv makes sure that any updates you have made to the U-Boot environment are persistent across power cycles and resets.

    STM32F429-DISCO> saveenv
    Saving Environment to envm...

The autoboot sequence in U-Boot is controlled by the two environment variables called bootdelay and bootcmd.

The bootdelay variable defines a delay, in seconds, before running the autoboot command defined by bootcmd. During the bootdelay countdown, you can interrupt the autobooting by pressing any key. This will let you enter the U-Boot command line interface.

The bootcmd variable defines a command executed by U-Boot automatically after the bootdelay countdown is over. Typically, this would be run netboot to boot Linux from TFTP during development or run envmboot to boot Linux from the internal Flash on deployed units.

In deployed configurations, where boot time to the service provided by your embedded device is critical, you will probably want to set bootdelay to 0:

STM32F429-DISCO> set bootdelay 0
STM32F429-DISCO> savee
Saving Environment to envm...

This will make sure that on each power on / reset U-Boot immediately executes the command defined by bootcmd, typically booting Linux from internal Flash.

With bootdelay set to 0 the U-Boot countdown is disabled, so there is a question how you enter the U-Boot command monitor, should you need to enter it for some reason. To do so, push the Ctrl-C keys down and don't release them until you have hit the reset button on the Discovery board. This will interrupt the U-Boot bootcmd sequence and let you enter the U-Boot command monitor:

U-Boot 2010.03-cortexm-1.14.2 (Sep 04 2015 - 19:58:13)
Hit any key to stop autoboot: 0

From the command monitor, you would be able to reset bootdelay to 3 or whatever value makes sense to you.