
Copyright © 2018 congatec AG SKIT_ARM_iMX8_q11.indd 10/10
The following environment variables are predefined for conga-SMX8:
Name Default value Description
bootcmd Defines the startup command of the bootloader, i.e.
how the system performs the boot process
fdt_file imx8qm-cgtsmx8.dtb The device tree blob, might be exchanged in order to
enhance functionality
image Image The name of the kernel image file that is loaded
during boot process
hdp_file hdmitxfw.bin The binary firmware file for enabling HDMI transmit,
essential to load if video output to HDMI is desired
ipaddr not specified Address of the system (used for network boot)
serverip not specified Address of the remote host (used for network boot)
netmask not specified Netmask of the network (used for network boot)
nfsroot not specified The location where the NFS root filesystem is stored
(used for network boot)
mmcdev "2" (onboard microSD) The boot device number (used for mmcboot)
mmcpart "1" (first partition) The number of the bootpartiton on the bootdevice
(used for mmcboot)
mmcroot "/dev/mmcblk2p2 rootwait
rw" (2nd partition on device 2)
The root filesystem (used for mmcboot), might also
be used to extend the kernel command line
Following, some frequently used scripts:
Name Description
mmcboot Boots the system from mmc (with the specified parameters for mmcboot), i.e.
eMMC, SD-card, microSD-card
mmcargs Configures the bootargs for mmcboot
netboot Boots the system from network (with the specified parameters for network boot)
netargs Configures the bootargs for network boot
loadbootscript Used during boot, loads an eventually existing boot script
loadimage Used during boot, loads the kernel
loadfdt Used during boot, loads the device tree blob file
loadhpd Used during boot, loads the hdmi firmware file
There are several commands to change the behavior of the bootloader and
to customize the boot process. The help command can be used to display
a list of all available commands.
2.4 Linux
By default, the system boots the Linux operating system that is stored on
the microSD card. The operating system image is Yocto.
Booting to the Linux desktop may take some time. This is because the
complete system initialization occurs from a microSD card connected via
a 4-bit interface.
To speed up the boot process significantly, install the root filesystem onto
the onboard eMMC device or an external SATA device.
Note
In order to maintain the integrity of the file system, it is recommended to
always shut down the system by issuing the command “poweroff” in the
console terminal.
2.5 Additional Information
The software provided with the conga-SKIT/ARM i.MX8 is based on the
Yocto Project (www.yoctoproject.org) and i.MX8 specific add-on layers
provided by NXP and congatec.
In order to rebuild the root filesystem image, kernel and bootloader for
conga-SMX8, the complete kernel source, bootloader source and individual
patches can be obtained from the congatec source code repository:
https://git.congatec.com/imx8_early_access
Further software documentation can be found here:
https://git.congatec.com/imx8_early_access/meta-fsl-bsp-release
Note
Contact congatec technical support to get access to the repository.