Running U-Boot Print

 

As explained in Installing U-Boot to the Embedded Artists LPC4357 Dev Kit, you have to install U-Boot to the internal Flash of the LPC4357 in order to run Linux (uClinux) on the LPC4357 Dev Kit. 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 (www.denx.de). 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 LPC4357, 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 LPC4357 kit is powered on or reset, the LPC4357 proceeds to boot the U-Boot firmware from the internal Flash printing the following output to the serial console:

U-Boot 2010.03-00073-1.14.0 (May 14 2015 - 12:51:52)

CPU : LPC43xx series (Cortex-M4/M0)
Freqs: SYSTICK=144MHz,CCLK=144MHz
Board: Embedded Artists LPC4357 Dev Kit Rev A1
DRAM: 32 MB
In:  serial
Out: serial
Err: serial
Net: LPC18XX_MAC
Hit any key to stop autoboot: 0
EA-LPC4357>

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 LPC4357 Dev Kit, the U-Boot environment is stored in the QSPI Flash 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:
  • EA-LPC4357> printenv
    baudrate=115200
    hostname=ea-lpc4357
    loadaddr=0x28000000
    ...
    Environment size: 761/4092 bytes
    EA-LPC4357>

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

    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 non-volatile Flash. Running saveenv makes sure that any updates you have made to the U-Boot environment are persistent across power cycles and resets.
  • EA-LPC4357> saveenv
    Saving Environment to spifi...
    EA-LPC4357>

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 flashboot to boot Linux from 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:

EA-LPC4357> sete bootdelay 0
EA-LPC4357> savee
Saving Environment to spifi...
EA-LPC4357>

This will make sure that on each power on / reset U-Boot immediately executes the command defined by bootcmd, typically booting Linux from 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 target board. This will interrupt the U-Boot bootcmd sequence and let you enter the U-Boot command monitor:

U-Boot 2010.03-00073-1.14.0 (May 14 2015 - 12:51:52)

CPU : LPC43xx series (Cortex-M4/M0)
Freqs: SYSTICK=144MHz,CCLK=144MHz
Board: Embedded Artists LPC4357 Dev Kit Rev A1
DRAM: 32 MB
In: serial
Out: serial
Err: serial
Net: LPC18XX_MAC
Hit any key to stop autoboot: 0
EA-LPC4357><INTERRUPT>

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