Kontron-Specific Uefi Shell Commands; Uefi Shell Scripting; Startup Scripting; Create A Startup Script - Kontron KBox C-102 Series User Manual

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.

Table 14: Kontron-Specific uEFI Shell Commands

COMMAND DESCRIPTION
kBoot Boots a selected device.
kBoardInfo Shows a summary of board-specific 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.
kRamdisk Creates and manages RAMdisks.
This command is used to perform file operations when no real file system 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.
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.
If there is no Kontron flash-stored startup script present, the uEFI-specified startup.nsh script is used. This
2.
script must be located on the root of any of the attached FAT formatted disk drive.

15.2.2. Create a Startup Script

Startup scripts can be created using the uEFI Shell built-in editor edit or under any OS with a plain text editor of your
choice. To create a startup shell script, simply save the script on the root of any FAT-formatted drive attached to the
system. To copy the startup script to the flash, use the kBootScript uEFI Shell command.
In case there is no mass storage device attached, the startup script can be generated in a RAM disk and stored in the
SPI boot flash using the kRamdisk uEFI Shell command.
www.kontron.com
KBox C-102 - User Guide, Rev. 1.0
// 108