Boot Process; Building The Image; U-Boot Environment Variables - Congatec conga-QMX8-Plus Quick Start Manual

2 Software
2.1

Building the Image

To build the Linux operating system image for the conga-QMX8-Plus,
follow the instructions described in the website below:
https://wiki.congatec.com
Note
Contact congatec technical support to get access to the repositories.
2.2 Starting Up
The conga-QMX8-Plus uses U-Boot as standard bootloader. The bootloader
is GNU GPL open source software. A serial terminal connection is required
in order to display the boot process and to modify the boot behavior. The
boot behavior is controlled via environment variables.
The included RS-232 adapter cable has two connectors. The RX/TX signals
are already crossed. Therefore, do NOT use a crossover-cable. Use the
connector labeled "CONSOLE" for the U-Boot console output.
To establish a terminal connection, a terminal program such as TeraTerm
or Putty can be used.
Use the following communication parameters:
Baud rate: 115200
Data: 8 bit
Parity: none
Stop: 1 bit
Flow control: none
Copyright © 2021 congatec GmbH
2.3

Boot Process

The conga-QMX8-Plus boot process starts at Power On Reset (POR), where
the hardware reset logic forces the ARM core to begin execution. The
on-chip boot ROM loads the bootloader.
After loading, the bootloader is executed and performs basic system
initialization (serial console, etc.). Afterwards, the environment settings are
parsed and the system boot continues as specified.
Press any key during startup to stop autoboot and to get to U-Boot console.
At the U-Boot console, the environment settings can be displayed using
the "print" command. In addition, useful functionality is available (such as
memory dump, access to the SPI and the I2C system, etc.). The "help"
command will display any command supported by the U-Boot.
If autoboot is not interrupted by pressing a key, the boot process goes
ahead and the module boots the Linux operating system installed on the
microSD card.
2.4

U-Boot Environment Variables

The U-Boot environment is located in SPI flash. One of the benefits of the
U-Boot bootloader is the possibility to specify its run time configuration
using environment variables.
The environment variables of U-Boot can be displayed using the printenv
(or the print) command.
During the boot process, the bootloader evaluates the "bootcmd" variable
and executes it. The boot command tries to load a bootscript or a kernel
from the boot device. If this is successful, the script or kernel will be started,
otherwise a fallback to network boot is performed. The variable "mmcdev"
specifies the mmc boot device. Furthermore, the variable "mmcroot" is
passed to the kernel in order to specify the location of the root filesystem.
QX8P_SDS_q10 6/7