Kontron-Specific Uefi Shell Commands; Uefi Shell Scripting; Startup Scripting - Kontron KBox C-101 User Manual

15. uEFI BIOS

15.1.3. Kontron-Specific uEFI Shell Commands

The Kontron uEFI implementation provides the following additional commands related to the specific HW features of the
Kontron system.
COMMAND DESCRIPTION
kBoardInfo Shows a summary of board-specif ic data and displays/checks various parameters such as the current
uEFI BIOS revision, etc.
kBootScript Manages the flash-stored startup script
If the shell is launched by the boot process, it executes a shell script stored in the flash. If the shell
script terminates, the shell will continue the boot process. However, the shell script can also contain
any other boot command.
kNvram Manages the NVRAM to restore the system's default settings
Since all uEFI settings are stored inside the NVRAM, the default settings are loaded af ter invoking
this command.
kFlash Programs and verif ies the SPI boot flashes holding the uEFI BIOS code
uEFI BIOS binary files must be available from connected mass storage devices, such as USB flash
drive or harddisk.
kRamdisk Creates and manages RAMdisks
This command is used to perform f ile operations when no real f ilesystem is connected to the
system.
kWatchdog Configures the Kontron onboard Watchdog
This command is used to enable the Kontron onboard Watchdog with reset target before OS boot.
This can be used to detect if the OS fails to boot and react by reset.
kUpdate
Controls the Kontron common update tool
When using the kUpdate command, the structure of the ZIP archive must not be altered.
kUpdate automatically starts the update procedure via kUpdate -u. If a certain image is intended to
be used, enter kUpdate -s to select the respective image.
The uEFI Shell commands are not case-sensitive. Each uEFI Shell command is provided with a detailed
online help that can be invoked by entering "<cmd> <space> <-?>" in the command line. To
display the uEFI Shell command list, enter <help> or <?> in the command line.

15.2. uEFI Shell Scripting

15.2.1. Startup Scripting

If the ESC key is not pressed and the timeout is run out, the uEFI Shell tries to execute some startup scripts automatically.
It searches for scripts and executes them in the following order:
1. Kontron flash-stored startup script.
2. If there is no Kontron flash-stored startup script present, the uEFI-specified startup.nsh script is used. This script
must be located on the root of any of the attached FAT formatted disk drive.
3. If none of the startup scripts is present or the startup script terminates, the default boot order is continued.
52
KBox C-101 – User's Guide (Version 2.00)
www.kontron.com