AM5030 uEFI BIOS Doc. ID: 1037-1209, Rev. 1.0 August 27, 2010 If it’s embedded, it’s Kontron.
Preface AM5030 Revision History Publication Title: AM5030 uEFI BIOS User Guide Doc. ID: 1037-1209 Rev. PRELIMINARY 1.0 Brief Description of Changes Date of Issue Initial issue based on the uEFI BIOS version R12 27-Aug-2010 Imprint Kontron Modular Computers GmbH may be contacted via the following: MAILING ADDRESS TELEPHONE AND E-MAIL Kontron Modular Computers GmbH +49 (0) 800-SALESKONTRON Sudetenstraße 7 sales@kontron.
AM5030 uEFI BIOS Preface Table of Contents Revision History .........................................................................................................ii Imprint ........................................................................................................................ii Disclaimer ..................................................................................................................ii Table of Contents .................................................................
Preface 3.3.1.1 Console Redirection ..................................................................18 3.3.1.2 Console Redirection Settings ....................................................18 3.3.2 PRELIMINARY COM4 .................................................................................................19 3.3.2.1 Console Redirection ..................................................................19 3.3.2.2 Console Redirection Settings ...............................................
AM5030 uEFI BIOS Preface 5.1.1 Quiet Boot .......................................................................................... 33 5.1.2 Fast Boot ........................................................................................... 34 5.1.3 Setup Prompt Timeout ....................................................................... 34 5.1.4 Bootup NumLock State ...................................................................... 34 5.1.5 CSM16 Module Version ........................
Preface AM5030 uEFI BIOS 8.1 Introduction, Basic Operation .....................................................................47 8.1.1 Shell Startup .......................................................................................47 8.2 Kontron Shell Commands ...........................................................................48 PRELIMINARY 8.3 uEFI Shell Scripting ....................................................................................62 9. 8.3.1 Startup Scripting ......
Starting uEFI BIOS Setup Chapter 1 Starting uEFI BIOS Setup ID 1037-1209, Rev. 1.
PRELIMINARY Starting uEFI BIOS Setup AM5030 uEFI BIOS This page has been intentionally left blank. Page 2 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 1. Starting uEFI BIOS Setup Starting uEFI BIOS Setup The AM5030 is provided with a Kontron-customized, pre-installed and configured version of Aptio® (referred to as uEFI BIOS in this manual), AMI’s next generation BIOS firmware based on the Unified Extensible Firmware Interface (uEFI) specification and the Intel® Platform Innovation Framework for EFI. This uEFI BIOS provides a variety of new and enhanced functions specifically tailored to the hardware features of the AM5030.
Starting uEFI BIOS Setup 1.1 AM5030 uEFI BIOS Main Setup Menu The Main setup menu is the first screen that appears after starting the Setup program. At the top of this screen and all of the other major screens, there is a setup menu selection bar, which permits access to all of the other major setup menus. These menus are selected via the left-right arrow keys. All setup menu screens have two main frames. The left frame displays all the functions that can be configured. They are displayed in blue.
AM5030 uEFI BIOS 1.2 Starting uEFI BIOS Setup Navigation The AM5030 uEFI BIOS setup program uses a hot key-based navigation system. A hot key legend is located in the right frame on most setup screens.The following table provides information concerning the usage of these hot keys. HOT KEY DESCRIPTION The key is used to invoke the General Help window. The key is used to restore the previous values. The key is used to load the defaults.
PRELIMINARY Starting uEFI BIOS Setup AM5030 uEFI BIOS This page has been intentionally left blank. Page 6 ID 1037-1209, Rev. 1.
Main Setup Chapter 21 Main Setup ID 1037-1209, Rev. 1.
PRELIMINARY Main Setup AM5030 uEFI BIOS This page has been intentionally left blank. Page 8 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 2. Main Setup Main Setup Upon entering the uEFI BIOS Setup program, the Main setup screen is displayed. This screen lists the main setup sub-screens and provides very basic system information as well as functions for setting the system time and date. In addition, the remaining major setup menus can be accessed from this screen. This screen can also be selected from any other major setup screen by using the Main tab. Aptio Setup Utility - Copyright (C) 2009 American Megatrends, Inc.
Main Setup 2.3 AM5030 uEFI BIOS System Language SETTING DESCRIPTION English Use this function to select the system language. Currently, only English is supported. 2.4 System Date SETTING DESCRIPTION Use this function to change the system date. PRELIMINARY Select System Date using the Up and Down keys. Enter the new values through the keyboard. Press the Left and Right keys to move between fields. 2.
Advanced Setup Chapter 31 Advanced Setup ID 1037-1209, Rev. 1.
PRELIMINARY Advanced Setup AM5030 uEFI BIOS This page has been intentionally left blank. Page 12 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 3. Advanced Setup Advanced Setup Select the Advanced tab to enter the Advanced Setup screen. This screen lists the advanced configuration sub-screens. Aptio Setup Utility - Copyright (C) 2007 American Megatrends, Inc. Main Advanced C h i ps e t Boot S e c u r it y Save & Exit : Select Screen : Select Item Enter: +/-: F1: F2: F3 F4: Select Change Opt. General Help Previous Values Optimized Defaults Save ESC: Exit Ve r s i o n 1 . 2 3 . 11 0 9 .
Advanced Setup 3.1 AM5030 uEFI BIOS Trusted Computing This screen provides functions for specifying the TPM configuration settings and TPM displaying status information. Aptio Setup Utility - Copyright (C) 2009 American Megatrends, Inc. Advanced TPM Configuration TPM Support [Disable] PRELIMINARY Current TPM Status Information TPM SUPPORT OFF : Select Screen : Select Item Enter: +/-: F1: F2: F3 F4: Select Change Opt.
AM5030 uEFI BIOS 3.2 Advanced Setup USB Configuration This screen provides information about support for USB devices as well as functions for specifying the USB configuration settings. Aptio Setup Utility - Copyright (C) 2009 American Megatrends, Inc.
Advanced Setup 3.2.3 AM5030 uEFI BIOS EHCI Hand-Off This function is used to enable a workaround for operating systems without EHCI Hand-Off support. The EHCI ownership change should be claimed by the EHCI driver. Note: It is recommended to leave this function at the default setting. For operating systems without USB2.0 support this function must be left at the default setting. SETTING DESCRIPTION Disabled Use this setting to disable EHCI Hand-Off support.
AM5030 uEFI BIOS 3.2.6 Advanced Setup Device Power Delay SETTING DESCRIPTION Auto Use this setting to automatically select the maximum time the device will take before it properly reports itself to the host controller. The default value for a root port is 100 ms. For a hub port, the delay is taken from the hub descriptor. Manual Use this setting to manually select the maximum time the device will take before it properly reports itself to the host controller. The delay range is 1..
Advanced Setup 3.3 AM5030 uEFI BIOS Serial Port Console Redirection This screen provides information about functions for specifying the Serial Port Console Redirection configuration settings. Console redirection can be used to remotely operate system settings and the EFI console. Aptio Setup Utility - Copyright (C) 2009 American Megatrends, Inc.
AM5030 uEFI BIOS 3.3.2 Advanced Setup COM4 COM4 is available only if the MicroTCA system provides a serial port via PCI Express. 3.3.2.1 Console Redirection SETTING DESCRIPTION Disabled Use this setting to disable console redirection for a PCIe serial port. Enabled Use this setting to enable console redirection for a PCIe serial port. Default setting: Enabled 3.3.2.2 Console Redirection Settings 3.3.
Advanced Setup 3.3.3.4 AM5030 uEFI BIOS Parity This is a display-only function providing information about the parity for Out-of-Band Management. 3.3.3.5 Stop Bits This is a display-only function providing information about the number of stop bits for Out-ofBand Management. 3.3.3.6 Terminal Type SETTING DESCRIPTION VT100 Use one of these settings to select the terminal type for out-of-band management. PRELIMINARY VT100+ VT-UTF8 ANSI Default setting: VT-UTF8 Page 20 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 3.3.4 Advanced Setup Console Redirection Settings This screen provides information about functions for specifying the Console Redirection configuration settings for the serial port 0 and a PCIe serial port. Each serial port can be independently configured. Aptio Setup Utility - Copyright (C) 2009 American Megatrends, Inc.
Advanced Setup 3.3.4.3 AM5030 uEFI BIOS Data Bits SETTING DESCRIPTION 7 Use one of these settings to specify the number of data bits per frame. 8 Default setting: 8 3.3.4.4 Parity SETTING DESCRIPTION None Use one of these settings to select the parity for the serial port. Even PRELIMINARY Odd Mark Space Default setting: None 3.3.4.5 Stop Bits SETTING DESCRIPTION 1 Use one of these settings to specify the number of stop bits for the serial port. 2 Default setting: 1 3.3.4.
Chipset Setup Chapter 41 Chipset Setup ID 1037-1209, Rev. 1.
PRELIMINARY Chipset Setup AM5030 uEFI BIOS This page has been intentionally left blank. Page 24 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 4. Chipset Setup Chipset Setup Select the Chipset tab to enter the Chipset Setup screen. This screen indicates the NorthBridge sub-screen. Aptio Setup Utility - Copyright (C) 2007 American Megatrends, Inc. Main Advanced C h i ps e t Boot S e c u r it y Save & Exit : Select Screen : Select Item Enter: +/-: F1: F2: F3 F4: Select Change Opt. General Help Previous Values Optimized Defaults Save ESC: Exit Ve r s i o n 1 . 2 3 . 11 0 9 .
Chipset Setup 4.1 AM5030 uEFI BIOS Intel® VT for Directed I/O Configuration This screen provides functions for specifying the Intel® VT for Directed I/O configuration settings. Aptio Setup Utility - Copyright (C) 2009 American Megatrends, Inc. Advanced PRELIMINARY Intel(R) VT-d Interrupt Remapping Coherency Support ATS Support Pass-through DMA [Enabled] [Enabled] [Disabled] [Enabled] [Enabled] : Select Screen : Select Item Enter: +/-: F1: F2: F3 F4: Select Change Opt.
AM5030 uEFI BIOS 4.1.2 Chipset Setup Interrupt Remapping This function allows for reductions in interrupt virtualization overhead for assigned devices. Interrupt requests specify a requester ID and an interrupt ID, and remap hardware transforms these requests to a physical interrupt using a software-programmed Interrupt Remap Table structure in memory. Note: This function is available only when the function Intel(R) VT-d is set to Enabled.
Chipset Setup 4.1.5 AM5030 uEFI BIOS Pass-through DMA This function is used to enable/disable VT-d engine pass-through DMA support. DMA request with untranslated addresses are processed as pass-through and will cause a DMA draining. Note: This function is available only when the function Intel(R) VT-d is set to Enabled. SETTING DESCRIPTION Disable Use this setting to disable Pass-through DMA support. Enable Use this setting to enable Pass-through DMA support.
AM5030 uEFI BIOS 4.2 Chipset Setup NorthBridge Configuration This screen provides display-only information concerning the memory, which is integrated in the Intel® Xeon® LC5518 processor. Aptio Setup Utility - Copyright (C) 2007 American Megatrends, Inc.
PRELIMINARY Chipset Setup AM5030 uEFI BIOS This page has been intentionally left blank. Page 30 ID 1037-1209, Rev. 1.
Boot Setup Chapter 51 Boot Setup ID 1037-1209, Rev. 1.
PRELIMINARY Boot Setup AM5030 uEFI BIOS This page has been intentionally left blank. Page 32 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 5. Boot Setup Boot Setup Select the Boot tab to enter the Boot Setup screen. This screen lists the sub-screens for boot configuration and boot device priority. Aptio Setup Utility - Copyright (C) 2009 American Megatrends, Inc. Advanced C h ips e t Bo ot S e c u r it y Boot Configuration Quiet Boot Fast Boot Setup Prompt Timeout [Disabled] [Disabled] 1 Bootup NumLock State [On] CSM16 Module Version 07.
Boot Setup 5.1.2 AM5030 uEFI BIOS Fast Boot This function is used to enable or disable boot with initialization of a minimal set of devices required to launch active boot option.. SETTING DESCRIPTION Disabled Use this setting to disable fast boot. Enabled Use this setting to enable fast boot. Default setting: Disabled 5.1.3 Setup Prompt Timeout PRELIMINARY This integer function is used to set an additional time the POST should wait for the operator to press the key to enter setup.
AM5030 uEFI BIOS 5.1.7 Boot Setup Option ROM Messages This function is used to control the messages of the loaded PCI option ROMs. SETTING DESCRIPTION Force BIOS Use this setting to force to a BIOS-compatible output. This will show the option ROM messages. Keep Current Use this setting to keep the current video mode. This will suppress option ROM messages. Option ROMs requiring interactive inputs may not work properly in this mode.
Boot Setup 5.2 Boot Option Priorities 5.2.1 Boot Option #1..2 AM5030 uEFI BIOS These functions are used to form the boot order and are dynamically generated. They represent either a legacy BBS (BIOS Boot Specification) class of devices or a native EFI boot entry. Press Return on each option to select the BBS class / EFI boot entry desired. 5.2.
Security Setup Chapter 61 Security Setup ID 1037-1209, Rev. 1.
PRELIMINARY Security Setup AM5030 uEFI BIOS This page has been intentionally left blank. Page 38 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 6. Security Setup Security Setup Select the Security tab to enter the Security Setup screen. This screen provides information about the passwords and functions for specifying the security settings. Aptio Setup Utility - Copyright (C) 2009 American Megatrends, Inc. Main Advanced C h ips e t Bo ot S e c u r it y Sa v e & E xi t If ONLY the Administrator’s password is set, then this only limits access to Setup and is only asked for when entering Setup.
Security Setup 6.1 AM5030 uEFI BIOS Administrator Password This function is used to set, change or delete the Administrator password. If there is already a password installed, the system asks for this first. To clear a password, simply enter nothing and acknowledge by pressing Return. To set a password, enter it twice and acknowledge by pressing Return. Note: The password is case sensitive. 6.2 User Password PRELIMINARY This function is used to set, change or delete the User password.
Save & Exit Chapter 71 Save & Exit ID 1037-1209, Rev. 1.
PRELIMINARY Save & Exit AM5030 uEFI BIOS This page has been intentionally left blank. Page 42 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 7. Save & Exit Save & Exit Select the Save & Exit tab to enter the Save & Exit menu screen. This screen provides functions for handling changes made to the uEFI BIOS settings and the exiting of the Setup program. Aptio Setup Utility - Copyright (C) 2009 American Megatrends, Inc.
Save & Exit 7.4 AM5030 uEFI BIOS Discard Changes and Reset This function is used to discard all changes made within the Setup. This function performs a reboot afterwards. Note: The Setup will ask for confirmation prior to executing this command. 7.5 Save Changes (Save Options) PRELIMINARY This function is used to save all changes made within the Setup to Flash. This function returns to Setup. Note: The Setup will ask for confirmation prior to executing this command. 7.
The uEFI Shell Chapter 81 The uEFI Shell ID 1037-1209, Rev. 1.
PRELIMINARY The uEFI Shell AM5030 uEFI BIOS This page has been intentionally left blank. Page 46 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 8. The uEFI Shell The uEFI Shell The Kontron uEFI BIOS features a built-in and enhanced version of the uEFI Shell. For a detailed description of the available standard shell scripting refer to the EFI Shell User’s Guide. For a detailed description of the available standard shell commands, refer to the Shell Command Manual 1.0. Both documents can be downloaded from the EFI and Framework Open Source Community homepage (https://efi-shell.tianocore.
The uEFI Shell 8.2 AM5030 uEFI BIOS Kontron Shell Commands The Kontron uEFI implementation provides the following additional commands related to the specific HW features of the Kontron system: PRELIMINARY • • • • • • • • • • kboardconfig kboardinfo kboot kbootnsh kclearnvram kclsp kipmi kmkramdisk kpassword kwdt The following tables provide information concerning these Kontron-specific commands. The command response values indicated can vary depending on the board’s configuration.
AM5030 uEFI BIOS The uEFI Shell kboardconfig FUNCTION: SYNTAX: Configure the non-volatile board settings kboardconfig kboardconfig [-?||] where: ? USAGE: The kboardconfig command enables the PXE feature or sets the front/ rear I/O configuration of the dedicated device.
The uEFI Shell AM5030 uEFI BIOS kboardconfig SETTINGS: pxe: Select PXE boot network adapter disabled: No PXE boot available [all]: Try all Ethernet devices round robin for PXE boot gbe_a: Try only front port a for PXE boot gbe_b: Try only front port b for PXE boot amc_a: Try only AMC port a for PXE boot amc_b: Try only AMC port b for PXE boot xaui_a: Try only XAUI port a for PXE boot xaui_b: Try only XAUI port b for PXE boot PRELIMINARY SATAMode: Determines how SATA controllers operate disabled: Disabl
AM5030 uEFI BIOS The uEFI Shell kboardconfig SETTINGS: vga: VGA port configuration disabled: Disable VGA port configuration [enabled]: Enable VGA port configuration bootvideo: Select preferred boot video device amc: Use video on the AMC port onboard: Use onboard graphics wr_prot_sata: Onboard SATA Flash write protection [disabled]: Do not write protect the onboard SATA Flash Warning! The SATA Flash module is factory-configured to disabled. Do not change this setting.
The uEFI Shell AM5030 uEFI BIOS kboardinfo FUNCTION: SYNTAX: DESCRIPTION: USAGE: Show board identification data kboardinfo The kboardinfo command shows a summary of board-specific identification data. It is especially useful for support queries because it contains this data in a concentrated form. Show board identification data COMMAND / RESPONSE: PRELIMINARY Shell> kboardinfo KOMaOEMF rev.: Board ID: Hardware rev.: Logic rev.
AM5030 uEFI BIOS The uEFI Shell SETTINGS: KOMaOEMF rev.: Board ID: Hardware rev.: Logic rev.: Boot flash: Geographic Address: Material number: Hardware index: Serial number: EFI article name: EFI material number: EFI index: EFI build time: EFI build date: NorthBridge rev.: SouthBridge rev.: Microcode: CPU ID: CPU Branding: ID 1037-1209, Rev. 1.
The uEFI Shell AM5030 uEFI BIOS kboot FUNCTION: SYNTAX: Boot a legacy OS Not to be used for uEFI BootLoaders! kboot [-?|-d|-p|-p |-n |-t ] PRELIMINARY where: ? -d -p -n -t DESCRIPTION: USAGE: Show online help Boot default order Specify the path to the device to boot from Specify the device name to boot from Specify the device type to boot from Available types are: floppy harddrive cdrom network usb-floppy usb-harddrive usb-cdrom The kboot command boots a legac
AM5030 uEFI BIOS The uEFI Shell kbootnsh FUNCTION: SYNTAX: Manage the startup script stored in the Flash kbootnsh [-b][-?|-g |-p |-d] -b -? -g -p -d DESCRIPTION: USAGE: Display output page by page Show online help Store the current boot script to disk. If there is no physical disk drive present, the kmkramdisk command may be used. Store the shell script pointed to by filename to Flash. Note: The shell script cannot be larger then 400 bytes.
The uEFI Shell AM5030 uEFI BIOS kclearnvram FUNCTION: SYNTAX: Clear the NVRAM to restore the system’s default settings kclearnvram No parameters required. For safety reasons this command must be confirmed by pressing “c”. PRELIMINARY DESCRIPTION: The kclearnvram command allows to clear the system NVRAM. Since all EFI settings are stored inside the NVRAM, the default settings are loaded afterwards.
AM5030 uEFI BIOS The uEFI Shell kipmi FUNCTION: SYNTAX: Read or configure available Board Management Controller parameters kipmi [-?|-b|parameters] -? -b parameters DESCRIPTION: USAGE: show online help display output page by page fru -- display fru data ipmb -- ipmb bus settings: ipmb [redundant/single] irq -- irq [number]: get/set KCS IRQ mode -- set ipmi controller mode: mode [bmc/smc] net -- display and change mode SOL network settings sel -- handle system event log raw -- execute raw ipmi command
The uEFI Shell AM5030 uEFI BIOS kipmi SETTINGS: fru []: Displays FRU data Options: Fru device ID: Numeric FRU device ID. 0 if FRU is omitted. FRU device 0 is the baseboard’s own FRU.
AM5030 uEFI BIOS The uEFI Shell kmkramdisk FUNCTION: SYNTAX: Create RAMdisk drives kmkramdisk [-?|-s ] where: -? show help -s create a RAMdisk of given size in Megabytes with the mount point name Creates a RAMdisk of variable size. Can be very useful to perform file operations when no real filesystem is connected to the system. Note: The RAMdisk loses its mount point name after all drives are remapped by the map -r command.
The uEFI Shell AM5030 uEFI BIOS kpassword FUNCTION: SYNTAX: Control EFI setup and shell passwords kpassword [-u|-s] Control EFI setup and shell passwords DESCRIPTION: USAGE: The kpassword command is used to get and set the EFI shell and setup passwords. Both user and superuser (Administrator) passwords can be controlled.
AM5030 uEFI BIOS The uEFI Shell kwdt FUNCTION: SYNTAX: Configure the Kontron onboard Watchdog kwdt [-?|-t ] where: -? -t Show help Configure the Watchdog with the time related to timeindex and activate it with reset routing DESCRIPTION: USAGE: The kwdt command allows 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 OS Watchdog driver is required for this functionality to operate.
The uEFI Shell 8.3 uEFI Shell Scripting 8.3.1 Startup Scripting AM5030 uEFI BIOS If the ESC key is not pressed and the timeout is run out, either the Kontron Flash-stored startup is executed, if present, or the uEFI specified startup.nsh script located under \efi\boot\ on any of the attached drives is executed. If none of the startup scripts is present, or the startup script terminates, the default boot order is continued.
Updating the uEFI BIOS Chapter 91 Updating the uEFI BIOS ID 1037-1209, Rev. 1.
PRELIMINARY Updating the uEFI BIOS AM5030 uEFI BIOS This page has been intentionally left blank. Page 64 ID 1037-1209, Rev. 1.
AM5030 uEFI BIOS 9. Updating the uEFI BIOS Updating the uEFI BIOS BIOS updates are typically delivered as an update CD ISO image. This ISO image needs just to be burned to a CD and booted. Follow the menu for updating the uEFI BIOS. For further information refer to the update CD documentation. 9.1 BIOS Redundancy Strategy The AM5030 has two sets of EFI Flash chips to form an EFI redundancy strategy.
Updating the uEFI BIOS 9.5 AM5030 uEFI BIOS Flash Selection by DIP Switch On some cases it may be necessary to force the board to boot from the other Flash without using the appropriate IPMI command to switch the Flash chips. In this case, the onboard DIP switch SW3, switch 2, is used to toggle the active Flash. Note that this switch does not “select” one Flash chip. It toggles the currently active Flash.