15Module Management LED Functions ........................................................... 47
ID 1052-3624, Rev. 1.0Page 7
PrefaceAM4022
This page has been intentionally left blank.
Page 8ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
1.Introduction
1.1Terminology and Acronym Definitions
The following table provides descriptions for terms and acronyms used in this guide. The descriptions are derived primarily from the IPMI specifications.
Table 1:Terminology and Acronym Definitions
TERM/ ACRONYMDESCRIPTION
AMCAdvanced Mezzanine Card
BSPBoard Support Package
DMIDesktop Management Interface
FRUField Replaceable Unit
FWHFirmware Hub
2
I
C
IPMBIntelligent Platform Management Bus
IPMB-0AdvancedTCA shelf-level IPMB
IPMB-LLocal, on-carrier IPMB that links the carrier IPMC with the MMCs of installed modules
IPMCIntelligent Platform Management Controller located on the AMC carrier
IPMIIntelligent Platform Management Interface
IOLIPMI over LAN. An MMC is accessed via LAN, not IPMB.
KCSKeyboard Controller Style
MMCModule Management Controller – an IPMI controller located on the AMC module
MPManagement Power
PICMGPCI Industrial Computer Manufacturer Group
PWRPayload Power
SDRSensor Data Record
Inter-Integrated Circuit
SDRRSensor Data Record Repository
SELSystem Event Log
SMBIOSSystem Management BIOS
SMSSystem Management Software (designed to run under the OS)
SOLSerial over LAN. A serial interface is redirected by LAN using the RMCP+ protocol.
ID 1052-3624, Rev. 1.0Page 9
IPMI FirmwareAM4022
1.2Related Publications
The following publications contain information relating to this product.
Table 2:Related Publications
PRODUCTPUBLICATION
IPMIIPMI Specification V2.0
IPMIIPMI - Platform Management FRU Information Storage Definition v1.0,
As a hot-swappable field-replaceable unit (FRU), the AM4022 follows the stringent carrier
grade RASM feature set, namely - Reliability, Availability, Serviceability, Maintainability.
Built in accordance with the AMC.0 specification, the AM4022 is also compliant with the AMC.1,
AMC.2, and AMC.3 specifications and is easily managed via its IPMI v2.0-compliant management features.
As with every Advanced Mezzanine Card (AMC), the AM4022 is equipped with a Module Management Controller (MMC).
1.3IPMI in AdvancedMC / AdvancedTCA Environment
The Module Management Controller is a crucial component of any AMC module. Besides acting as a regular IPMI management controller (sensor monitoring, event logging, etc.), it also
provides an interface to all necessary data related to module power requirements and implemented interfaces (E-Keying). Further, it plays an active role in the module hot swap state management. The carrier IPMI Controller (IPMC) communicates with the MMC using the local IPMB
(IPMB-L) bus. In an ATCA/AMC environment, it is the IPMC that actually turns on/off module
(payload) power. However, before the IPMC enables the module payload power, various criteria must be satisfied by both the carrier and the module, including power requirements and capabilities, matching interfaces, current module hot swap state, and any other special conditions
as specified by the Shelf Manager policy.
Page 10ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
1.4Module Management Controller Hardware
On the AM4022 processor AMC module, the MMC is implemented using an NXP® ARM7 microcontroller with 512 kB of internal flash and 56 kB of RAM.
An external 64 kB serial EEPROM chip is used for firmware private data and for FRU inventory
storage. An additional external 4 MB serial SPI flash is used for redundant firmware image storage.
The MMC implements one local Keyboard Controller Style (KCS) interface with interrupt support for communication with the system side management software and the uEFI BIOS. The
IPMB-L bus is used for interconnection with the IPMC.
IPMI over LAN (IOL) and Serial Over LAN (SOL) are supported on all four Ethernet channels
of the module. SOL is only available on one Ethernet channel at a time.
The MMC provides access to various sensors which permit the monitoring of:
•System power voltages: +12V (PWR), +5V, +3.3V, +3.3V (MP)
•Temperatures: CPU and PCH die as well as airflow near AMC edge-connector
•Power Good, LAN links, IPMB link, board reset, POST code, boot error, CPU States (processor hot, THERMTRIP, …), IPMB-L state, Health error, IPMI watchdog, etc.
2.MMC Firmware
2.1Key Features
The following are key features of the AM4022 MMC firmware:
•Compliant with the related IPMI and PICMG® specifications
•Firmware designed and specially made for AdvancedMC environments (ATCA, µTCA)
•Supports one KCS interface with interrupt support
•Supports the local IPMB (IPMB-L) interface
•Out-of-Band management and monitoring using IPMB-L interface permits access to
sensors regardless of the module’s CPU state
•Sensor thresholds fully configurable
•Sensor names prefixed with AMC module Bay ID (A1…4, B1…4)
•Usable in µTCA slots 1…12. Sensor names for slots 9…12 are prefixed with C1…C4
•Complete IPMI watchdog functionality
•Complete FRU functionality
•Firmware can be updated in the field
•Firmware image management may done by the open tool “ipmitool” (functions “hpm” or
“fwum”)
•Downloading new firmware image does not break currently running firmware activities
•Manual firmware image roll-back in case of upgrade failure
•Interoperable with other AMC, ATCA, or IPMI solutions
ID 1052-3624, Rev. 1.0Page 11
IPMI FirmwareAM4022
•Fail-over control to a recovery BIOS in the event a non-working uEFI BIOS is detected
•OEM commands for uEFI BIOS firmware bank selection and uEFI BIOS boot order
override
•IPMI over LAN (IOL) support
•Serial over LAN (SOL) support
•Graceful shutdown support
•The “Health” LED indicates whether the module is healthy (normal operation) and all
sensors are within the specified range (green) or at least one sensor is out of range
(amber).
2.2Supported IPMI and ATCA Commands
2.2.1Standard IPMI Commands
The following table shows an excerpt from the command list specified in the IPMI specification
2.0. The shaded table cells indicate commands supported by the AM4022 MMC.
M = mandatory, O = optional
Table 3:Standard IPMI Commands
IPMI 2.0
COMMAND
SPEC.
NETFNCMD
SECTION
IPM DEVICE “GLOBAL” COMMANDSM
Get Device ID20.1App01h
Cold Reset20.2App02h
Warm Reset20.3App03hO / No
Get Self Test Results20.4App04h
Manufacturing Test On20.5App05hO / No
Set ACPI Power State20.6App06hO / No
Get ACPI Power State20.7App07hO / No
Get Device GUID20.8App08hO / No
KONTRON
SUPPORT
ON MMC
M / Yes
O / Yes
O / Yes
Broadcast “Get Device ID”20.9App01h
BMC WATCHDOG TIMER COMMANDS
Reset Watchdog Timer27.5App22h
Set Watchdog Timer27.6App24h
Get Watchdog Timer27.7App25h
Page 12ID 1052-3624, Rev. 1.0
M / Yes
O
O / Yes
O / Yes
O / Yes
AM4022IPMI Firmware
Table 3:Standard IPMI Commands (Continued)
IPMI 2.0
COMMAND
SPEC.
NETFNCMD
SECTION
BMC DEVICE AND MESSAGING COMMANDSO
Set BMC Global Enables22.1App2Eh
Get BMC Global Enables22.2App2Fh
Clear Message Flags22.3App30h
Get Message Flags22.4App31h
Enable Message Channel Receive22.5App32h
Get Message22.6App33h
Send Message22.7App34h
Read Event Message Buffer22.8App35h
Get BT Interface Capabilities22.9App36hO / No
Get System GUID22.14App37hO / No
KONTRON
SUPPORT
ON MMC
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
Get Channel Authentication Capabilities22.13App38h
Get Session Challenge22.15App39h
Activate Session22.17App3Ah
Set Session Privilege Level22.18App3Bh
Close Session22.19App3Ch
Get Session Info22.20App3Dh
Get AuthCode22.21App3FhO / No
Set Channel Access22.22App40h
Get Channel Access22.23App41h
Get Channel Info22.24App42h
Set User Access22.26App43h
Get User Access22.27App44h
Set User Name22.28App45h
Get User Name22.29App46h
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
Set User Password22.30App47h
ID 1052-3624, Rev. 1.0Page 13
O / Yes
IPMI FirmwareAM4022
Table 3:Standard IPMI Commands (Continued)
IPMI 2.0
COMMAND
SPEC.
NETFNCMD
SECTION
Activate Payload24.1App48h
Deactivate Payload24.2App49h
Get Payload Activation Status24.4App4Ah
Get Payload Instance Info24.5App4Bh
Set User Payload Access24.6App4Ch
Get User Payload Access24.7App4Dh
Get Channel Payload Support24.8App4Eh
Get Channel Payload Version24.9App4Fh
Get Channel OEM Payload Info24.10App50hO / No
Master Write-Read22.11App52h O / No
Get Channel Cipher Suits22.15App54hO / No
KONTRON
SUPPORT
ON MMC
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
Suspend/Resume Payload Encryption24.3App55h
Set Channel Security Keys22.25App56hO / No
Get System Interface Capabilities22.9App57hO / No
CHASSIS DEVICE COMMANDSO
Get Chassis Capabilities28.1Chassis00h
Get Chassis Status28.2Chassis01h
Chassis Control28.3Chassis02h
Chassis Reset28.4Chassis03hO / No
Chassis Identify28.5Chassis04hO / No
Set Chassis Capabilities28.7Chassis05hO / No
Set Power Restore Policy28.8Chassis06hO / No
Get System Restart Cause28.11Chassis07hO / No
Set System Boot Options28.12Chassis08hO / No
O / Yes
O / Yes
O / Yes
O / Yes
Get System Boot Options28.13Chassis09hO / No
Get POH Counter28.14Chassis0Fh
Page 14ID 1052-3624, Rev. 1.0
O / Yes
AM4022IPMI Firmware
Table 3:Standard IPMI Commands (Continued)
IPMI 2.0
COMMAND
SPEC.
NETFNCMD
SECTION
EVENT COMMANDSM
Set Event Receiver29.1S/E00h
Get Event Receiver29.2S/E01h
Platform Event (a.k.a. “Event Message”)29.3S/E02h
PEF AND ALERTING COMMANDSO
Get PEF Capabilities30.1S/E10hO / No
Arm PEF Postpone Timer30.2S/E11hO / No
Set PEF Configuration Parameters30.3S/E12hO / No
Get PEF Configuration Parameters30.4S/E13hO / No
Set Last Processed Event ID30.5S/E14hO / No
Get Last Processed Event ID30.6S/E15hO / No
KONTRON
SUPPORT
ON MMC
M / Yes
M / Yes
M / Yes
Alert Immediate30.7S/E16hO / No
PET Acknowledge30.8S/E17hO / No
SENSOR DEVICE COMMANDSM
Get Device SDR Info35.2S/E20h
Get Device SDR35.3S/E21h
Reserve Device SDR Repository35.4S/E22h
Get Sensor Reading Factors35.5S/E23hO / No
Set Sensor Hysteresis35.6S/E24h
Get Sensor Hysteresis35.7S/E25h
Set Sensor Threshold35.8S/E26h
Get Sensor Threshold35.9S/E27h
Set Sensor Event Enable35.10S/E28h
Get Sensor Event Enable35.11S/E29h
M / Yes
M / Yes
M / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
Re-arm Sensor Events35.12S/E2AhO / No
ID 1052-3624, Rev. 1.0Page 15
IPMI FirmwareAM4022
Table 3:Standard IPMI Commands (Continued)
IPMI 2.0
COMMAND
SPEC.
NETFNCMD
SECTION
Get Sensor Event Status35.13S/E2BhO / No
Get Sensor Reading35.14S/E2Dh
Set Sensor Type35.15S/E2EhO / No
Get Sensor Type35.16S/E2FhO / No
FRU DEVICE COMMANDSM
Get FRU Inventory Area Info34.1Storage10h
Read FRU Data34.2Storage11h
Write FRU Data 34.3Storage12h
SDR DEVICE COMMANDSO
Get SDR Repository Info33.9Storage20hO / No
Get SDR Repository Allocation Info33.10Storage21hO / No
KONTRON
SUPPORT
ON MMC
M / Yes
M / Yes
M / Yes
M / Yes
Reserve SDR Repository33.11Storage22hO / No
Get SDR33.12Storage23hO / No
Add SDR33.13Storage24hO / No
Partial Add SDR33.14Storage25hO / No
Delete SDR33.15Storage26hO / No
Clear SDR Repository33.16Storage27hO / No
Get SDR Repository Time33.17Storage28hO / No
Set SDR Repository Time33.18Storage29hO / No
Enter SDR Repository Update Mode33.19Storage2AhO / No
Exit SDR Repository Update Mode33.20Storage2BhO / No
Run Initialization Agent33.21Storage2ChO / No
SEL DEVICE COMMANDS O
Get SEL Info40.2Storage40hO / No
Get SEL Allocation Info40.3Storage41hO / No
Page 16ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
Table 3:Standard IPMI Commands (Continued)
IPMI 2.0
COMMAND
SPEC.
NETFNCMD
SECTION
Reserve SEL40.4Storage42hO / No
Get SEL Entry40.5Storage43hO / No
Add SEL Entry40.6Storage44hO / No
Partial Add SEL Entry40.7Storage45hO / No
Delete SEL Entry40.8Storage46hO / No
Clear SEL40.9Storage47hO / No
Get SEL Time40.10Storage48hO / No
Set SEL Time40.11Storage49hO / No
Get Auxiliary Log Status40.12Storage5AhO / No
Set Auxiliary Log Status40.13Storage5BhO / No
LAN DEVICE COMMANDS
KONTRON
SUPPORT
ON MMC
O
Set LAN Configuration Parameters23.1Transport01h
Get LAN Configuration Parameters23.2Transport02h
Suspend BMC ARPs23.3Transport03h
Get IP/UDP/RMCP Statistics23.4Transport04h
SERIAL/MODEM DEVICE COMMANDSO
Set Serial/Modem Configuration25.1Transport10hO / No
Get Serial/Modem Configuration25.2Transport11hO / No
Set Serial/Modem Mux25.3Transport12hO / No
Get TAP Response Codes25.4Transport13hO / No
Set PPP UDP Proxy Transmit Data25.5Transport14hO / No
Get PPP UDP Proxy Transmit Data25.6Transport15hO / No
Send PPP UDP Proxy Packet25.7Transport16hO / No
Get PPP UDP Proxy Receive Data25.8Transport17hO / No
O / Yes
O / Yes
O / Yes
O / Yes
Serial/Modem Connection Active25.9Transport18hO / No
ID 1052-3624, Rev. 1.0Page 17
IPMI FirmwareAM4022
Table 3:Standard IPMI Commands (Continued)
IPMI 2.0
COMMAND
SPEC.
NETFNCMD
SECTION
Callback25.10Transport19hO / No
Set User Callback Options25.11Transport1AhO / No
Get User Callback Options25.12Transport1BhO / No
SOL Activating26.1Transport20h
Get SOL Configuration Parameters26.2Transport21h
Set SOL Configuration Parameters26.3Transport22h
BRIDGE MANAGEMENT COMMANDS (ICMB)O
Get Bridge State[ICMB]Bridge00hO / No
Set Bridge State[ICMB]Bridge01hO / No
Get ICMB Address[ICMB]Bridge02hO / No
Set ICMB Address[ICMB]Bridge03hO / No
KONTRON
SUPPORT
ON MMC
O / Yes
O / Yes
O / Yes
Set Bridge Proxy Address[ICMB]Bridge04hO / No
Get Bridge Statistics[ICMB]Bridge05hO / No
Get ICMB Capabilities[ICMB]Bridge06hO / No
Clear Bridge Statistics[ICMB]Bridge08hO / No
Get Bridge Proxy Address[ICMB]Bridge09hO / No
Get ICMB Connector Info[ICMB]Bridge0AhO / No
Get ICMB Connection ID[ICMB]Bridge0BhO / No
Send ICMB Connection ID[ICMB]Bridge0ChO / No
DISCOVERY COMMANDS (ICMB)O
Prepare For Discovery[ICMB]Bridge10hO / No
Get Addresses[ICMB]Bridge11hO / No
Set Discovered[ICMB]Bridge12hO / No
Get Chassis Device ID[ICMB]Bridge13hO / No
Set Chassis Device ID[ICMB]Bridge14hO / No
Page 18ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
Table 3:Standard IPMI Commands (Continued)
IPMI 2.0
COMMAND
SPEC.
NETFNCMD
SECTION
BRIDGING COMMANDS (ICMB)O
Bridge Request[ICMB]Bridge20hO / No
Bridge Message[ICMB]Bridge21hO / No
EVENT COMMANDS (ICMB)O
Get Event Count[ICMB]Bridge30hO / No
Set Event Destination[ICMB]Bridge31hO / No
Set Event Reception State[ICMB]Bridge32hO / No
Send ICMB Event Message[ICMB]Bridge33hO / No
Get Event Destination[ICMB]Bridge34hO / No
Get Event Reception State[ICMB]Bridge35hO / No
KONTRON
SUPPORT
ON MMC
OEM COMMANDS FOR BRIDGE NETFNO
OEM Commands[ICMB]BridgeC0h-FEhO / No
OTHER BRIDGE COMMANDSO
Error Report[ICMB]BridgeFFhO / No
ID 1052-3624, Rev. 1.0Page 19
IPMI FirmwareAM4022
2.2.2AdvancedTCA and AMC Commands
The following table shows an excerpt from the command lists specified in the PICMG 3.0 R 2.0
AdvancedTCA Base Specification and the PICMG AMC.0 Advanced Mezzanine Card Specification, R 1.0. The shaded table cells indicate commands supported by the AM4022 MMC.
M = mandatory, O = optional
Table 4:AdvancedTCA and AMC Commands
PICMG 3.0
COMMAND
SPEC.
NETFNCMD
TABLE
AdvancedTCAM
Get PICMG Properties3-9PICMG00h
Get Address Info3-8PICMG01hN/A
Get Shelf Address Info3-13PICMG02hN/A
Set Shelf Address Info3-14PICMG03hN/A
FRU Control3-22PICMG04h
Get FRU LED Properties3-24PICMG05h
Get LED Color Capabilities3-25PICMG06h
Set FRU LED State3-26PICMG07h
Get FRU LED State3-27PICMG08h
Set IPMB State3-51PICMG09hN/A
KONTRON
SUPPORT
ON MMC
M / Yes
M / Yes [1]
M / Yes
M / Yes
M / Yes
M / Yes
Set FRU Activation Policy3-17PICMG0AhN/A
Get FRU Activation Policy3-18PICMG0BhN/A
Set FRU Activation3-16PICMG0ChN/A
Get Device Locator Record ID3-29PICMG0Dh
Set Port State3-41PICMG0EhN/A
Get Port State3-42PICMG0FhN/A
Compute Power Properties3-60PICMG10hN/A
Set Power Level3-62PICMG11hN/A
Get Power Level3-61PICMG12hN/A
Renegotiate Power3-66PICMG13hN/A
Get Fan Speed Properties3-63PICMG14hN/A
M / Yes
Page 20ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
Table 4:AdvancedTCA and AMC Commands (Continued)
PICMG 3.0
COMMAND
SPEC.
NETFNCMD
TABLE
Set Fan Level3-65PICMG15hN/A
Get Fan Level3-64PICMG16hN/A
Bused Resource3-44PICMG17hN/A
Get IPMB Link Info3-49PICMG18hN/A
AMC
AMC.0
KONTRON
SUPPORT
ON MMC
TABLE
Set AMC Port State3-27PICMG19hO / Yes
Get AMC Port State3-28PICMG1Ah
Set Clock State3-44PICMG2Ch
Get Clock State3-45PICMG2Dh
O / Yes
O / Yes
O / Yes
[1] Only “FRU Control - Cold Reset” and “FRU Control - Quiesce” are supported.
ID 1052-3624, Rev. 1.0Page 21
IPMI FirmwareAM4022
3.OEM Commands and Command Extensions
3.1Get Device ID Command with OEM Extensions
The IPMI specification defines four optional bytes in the response to Get Device ID. The
response bytes [13:16] hold the 'Auxiliary Firmware Revision Information'.
Table 5:Get Device ID Command with OEM Extensions
COMMANDLUNNetFnCMD
Get Device ID command with OEM extensions00hApp = 06h01h
REQUEST DATA
ByteData Field
--
RESPONSE DATA
ByteData Field
1Completion Code
2 - 12Regular Get Device ID command response fields
13Release number of the MMC firmware:
10h for R10,
11h for R11,
…
14Module geographical address (site number):
1 … 8=Module in AMC bay A1, A2, A3, A4, B1, B2, B3, B4
or in µTCA slot 1 … 8 with bus addresses
72h, 74h, 76h, 78h, 7ah, 7ch, 7eh, 80h
9 …12 = Module in µTCA slot 9 … 12 = Bay C1, C2, C3, C4
with bus addresses 82h, 84h, 86h,88h
0, > 12 = Module position is not in range. The IPMB-L bus is
switched off
15 - 16Reserved
Page 22ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
3.2Set Control State (Firmware Hub, Boot Order)
Table 6:Set Control State
COMMANDLUNNetFnCMD
Set Control State (Firmware Hub, Boot Order)00hOEM = 3Eh20h
REQUEST DATA
ByteData Field
1Control ID:
00h = Firmware hub (SPI boot flash) Selection
9Dh = Boot Order Configuration
2Control State for SPI boot flash selection:
(These settings are stored in EEPROM and applied (to logic) each time the IPMI controller
detects power-on)
00h = Standard SPI boot flash is selected (default)
01h = Recovery SPI boot flash is selected
Please note that this selection may be forcibly overridden either by the DIP Switch SW3,
switch 2 (refer to the AM4022 User Guide, Table 4-3).
To be able to change the SPI boot flash selection via the Set Control State command, the
recovery SPI boot flash must not be previously selected.
In case of a failed boot process from the standard SPI boot flash, the IPMI controller will
select the recovery SPI boot flash and boot the board again.
In case of a boot failure from the recovery SPI boot flash, the board locks up.
Refer to Chapter 8, uEFI BIOS Failover Control - Automatic SPI Boot Flash Selection, for
further information.
Control State for Boot Order Configuration:
(These settings are stored in EEPROM and applied (to logic) each time the IPMI controller
detects power-on)
00h = No override, boot as usual
01h = Next boot device is: Floppy
02h = Next boot device is: HDD
03h = Next boot device is: CD
04h = Next boot device is: Network
05h = Next boot device is: USB Floppy
06h = Next boot device is: USB HDD
07h = Next boot device is: USB CDROM
RESPONSE DATA
ByteData Field
1Completion Code
ID 1052-3624, Rev. 1.0Page 23
IPMI FirmwareAM4022
3.3Get Control State (Firmware Hub, Boot Order)
Table 7:Get Control State
COMMANDLUNNetFnCMD
Get Control State (Firmware Hub, Boot Order)00hOEM = 3Eh21h
REQUEST DATA
ByteData Field
1Control ID:
00h = Firmware hub (SPI boot flash) selection
9Dh = Boot Order Configuration
RESPONSE DATA
ByteData Field
1Completion Code
4Control State (refer to Chapter 3.2, Set Control State)
00h .. 01h for control ID = Firmware hub (SPI boot flash) selection
00h .. FFh for control ID = Boot Order Configuration
Page 24ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
3.4OEM Module Quiescence Feedback
This command is used to control a graceful shutdown of the AM4022 and is a prerequisite for
the hot swap feature. For further information on hot swap, refer to Chapter 10, Hot Swap.
If the software environment does not support ACPI, a self-written shutdown daemon, can be
used to shut down the system in an orderly manner. For this purpose, Kontron’s latest BSP includes a Graceful Reboot and Shutdown Daemon, “grnsd”.
If ACPI is fully supported, this command can be used to set a timeout time for the case that the
ACPI means (ACPI daemon, etc.) are unable to shut down the system in time. As a default value at system start this time is set to 0 (endless wait).
Table 8:OEM Module Quiescence Feedback
COMMANDLUNNetFnCMD
OEM Module Quiescence Feedback00hOEM = 3Eh40h
REQUEST DATA
ByteData Field
1Control bits:
[7] - 1b = set quiesce wait timeout
[6] - 1b = quiescence acknowledge (OS ready)
[5] - 1b = OS daemon present
[4:0] Reserved
2Quiesce wait timeout [sec]
a) An OS daemon is present (refer to bits above):
This is the maximum time from the moment on that the MMC receives FRU Control
(Quiesce) request until it sends back the appropriate Module Hot Swap event message.
b) No OS daemon is present (refer to bits above):
This is the maximum time from the moment on that the MMC receives FRU Control
(Quiesce) request until it sends back the appropriate Module Hot Swap event message. If
sleep state is recognized before timeout, the Module Hot Swap event message will be sent
immediately. If the time is set to 0 (default after reset,) the Module Hot Swap event
message will only be sent after recognition of sleep state (signal).
ByteData Field
1Completion code
2Control bits:
[7] - Reserved
[6] - 1b = quiescence acknowledge (OS ready)
[5] - 1b = OS daemon present
[4] - 1b = quiesce request (FRU Control)
[3] - Reserved
[2] - 1b = graceful reboot request (FRU Control)
[1] - 1b = quiescence reached (MMC acknowledge)
[0] - 1b = module hot swap switch opened
RESPONSE DATA
4Quiesce wait timeout (valid only if OS daemon present = 1)
ID 1052-3624, Rev. 1.0Page 25
IPMI FirmwareAM4022
3.4.1Usage if a Shutdown Daemon is Announced as Present
If a timeout time has to be set to avoid an endless waiting for the sleep state, the daemon calls
this command after system start with the “set quiesce wait timeout” bit set and the “Quiesce
wait timeout” time <> 0. Afterwards, the daemon calls this command cyclically with the “OS
daemon present” bit set. When the MMC gets a FRU Control (Quiesce) request from the carrier
(e.g. during a hot swap sequence), it sets the “quiesce request (FRU Control)” bit in its command response. After the daemon sees this bit set in the response, it should shut down the
system. After having set the “quiesce request (FRU Control)” bit, the MMC starts the timeout
timer (if a timeout time was defined) and monitors the sleep signal line to recognize the sleep
state which should be caused by the shutdown. When the MMC detects the sleep state (signal)
or it receives a command with the “quiescence acknowledge” bit set or the timeout timer has
expired, the MMC sends a “Module Hot Swap Event” message to the carrier, and in the following the payload power will be switched off.
3.4.2Usage if no Shutdown Daemon is Announced as Present
If no command call announces that a daemon is present, the MMC automatically uses the default timeout time 0 (endless wait) during the hot swap process. But if the timeout time was set
to a value 1…255, this time will be used in any case while waiting for the sleep state (signal).
Settings changed with this command are volatile (in particular quiesce timeout and OS daemon
present). Bits [6:5] are always settable, but once the quiesce request comes, they cannot be
cleared until quiescence state is entered and exited.
Page 26ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
4.Sensors Implemented on the AM4022
The MMC includes several sensors for voltage or temperature monitoring and various others
for pass/fail type signal monitoring.
Every sensor is associated with a Sensor Data Record (SDR). Sensor Data Records contain
information about the sensors identification such as sensor type, sensor name, sensor unit.
SDRs also contain the configuration of a specific sensor such as threshold, hysteresis or event
generation capabilities that specify sensor's behavior. Some fields of the sensor SDR are configurable using IPMI commands others are always set to built-in default values.
Finally, one field, which is the sensor owner, must reflect the module addresses that allow the
AMC carrier to identify the owner of the sensor when it is scanned and merged into the AMC
Carrier's SDR repository.
From the IPMI perspective, the MMC is set up as a satellite management controller (SMC). The
MMC supports sensor devices IPMI commands and uses the static sensor population feature
of IPMI. All Sensor Data Records can be queried using Device SDR commands.
Each sensor has a name field in its SDR. The sensor name has a prefix, which is automatically
adapted, dependent on the physical position of the module in a carrier or in a µTCA chassis.
The following prefixes are used for all sensors of an AMC module:
Table 9:Sensor Name Prefix
AMC Bay
μTCA slot
Sensor Name
12345678----
123456789101112
A1:A2:A3:A4:B1:B2:B3:B4:C1:C2:C3:C4:
Prefix
Module sensors that have been implemented are listed in the sensor list below.
ID 1052-3624, Rev. 1.0Page 27
IPMI FirmwareAM4022
4.1Sensor List
The following table indicates all sensors available on the AM4022. For further information on
Kontron’s OEM specific sensor types and sensor event type codes presented in the following
table, please refer to Chapter 4.3, OEM Event/Reading Types.
Table 10:Sensor List
Sensor Number /
Name
00h /
A1:IPMI Info-1
01h /
A1:IPMI Info-2
02h /
A1:IPMI Watchdog
03h /
A1:FRU Agent
04h /
A1:Health Error
05h /
A1:MMC Reboot
06h /
A1:ModuleHotSwap
07h /
A1:IPMBL State
Sensor Type (Code) /
Event/Reading Type
(Code)
OEM Firmware Info 1 (C0h) /
OEM (70h)
OEM Firmware Info 2 (C0h) /
OEM (71h)
Watchdog (23h) /
Sensor-specific (6Fh)
OEM (C5h) /
Discrete (0Ah)
Platform Alert (24h) /
Digital discrete (03h)
Platform Alert (24h) /
Digital discrete (03h)
OEM (F2h) /
Sensor-specific (6Fh)
OEM (C3h) /
Sensor-specific (6Fh)
Ass. Mask /
Deass. Mask /
Reading Mask
0003h / 0000h /
7FFFh
0003h / 0000h /
7FFFh
010Fh / 0000h /
010Fh
0140h / 0000h /
0147h
0000h / 0000h /
0003h
0002h / 0000h /
0003h
001Fh / 0000h /
001Fh
0007h / 0000h /
000Fh
Health
Description
LED
Shows
Error
For internal use onlyN
For internal use onlyN
Watchdog 2Y
FRU agentN
Aggregate states (power,
temperature, etc.). Visualization by the Health LED.
MMC reboot active state. Is
asserted during boot time.
Hot swap sensorN
State of IPMB-L busN
Y
N
08h /
A1:Stor Err
0Ah /
A1: MMC FwUp
0Ch /
A1: Config Error
0Dh /
A1:Board Reset
0Eh /
A1:Temp CPU
0Fh /
A1:Temp PCH
11h /
A1:Temp Air
12h /
A1:Board 3.3vIPM
Mgmt. Subsyst. Health (28h) /
Sensor-specific (6Fh)
Firmware Upgrade Manager
(C7h) / Sensor specific (6Fh)
OEM (CEh) /
Sensor-specific (6Fh)
OEM (C4h) /
Sensor-specific (6Fh)
Temperature (01h) /
Threshold (01h)
Temperature (01h) /
Threshold (01h)
Temperature (01h) /
Threshold (01h)
Voltage (02h) /
Threshold (01h)
0002h / 0000h /
0003h
010Fh / 0000h /
010Fh
017Ch / 0000h /
077Dh
04DEh / 0000h /
04DEh
1A81h / 7A81h /
3939h
0A80h / 7A80h /
3838h
7A95h / 7A95h /
3F3Fh
2204h / 2204h /
1212h
Storage errorN
Status of Firmware Upgrade
Manager
Configuration ErrorY
Board reset eventY
CPU die temperatureY
PCH temperatureY
Air temperature near AMC
edge-connector
AMC Management Power
(MP) 3.3V
N
Y
Y
Page 28ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
Table 10:Sensor List
Sensor Number /
Name
13h /
A1:Board 12.0v
14h /
A1:Board 5.0V
15h /
A1:Board 3.3V
16h /
A1:Pwr Good
17h /
A1:Pwr Good Evt
18h /
A1:CPU status
19h /
A1:FWH0 Boot Err
1Ah /
A1:FWH1 Boot Err
Sensor Type (Code) /
Event/Reading Type
(Code)
Voltage (02h) /
Threshold (01h)
Voltage (02h) /
Threshold (01h)
Voltage (02h) /
Threshold (01h)
Power supply (08h) /
OEM (77h)
Power supply (08h) /
OEM (77h)
Processor (07h) /
Sensor-specific (6Fh)
Boot Error (1Eh) /
Sensor-specific (6Fh)
Boot Error (1Eh) /
Sensor-specific (6Fh)
Ass. Mask /
Deass. Mask /
Reading Mask
2204h / 2204h /
1212h
2204h / 2204h /
1212h
2204h / 2204h /
1212h
0000h / 0000h /
0887h
0000h / 0887h /
0887h
0463h / 0400h /
04E3h
0008h / 0008h /
0008h
0008h / 0008h /
0008h
Health
Description
LED
Shows
Error
AMC Payload Power (PWR)
12V
Board 5V supplyY
Board 3.3V supplyY
States of all power linesN
Power fail events for all
power lines
CPU aggregate statusY
Firmware Hub 0 boot errorY
Firmware Hub 1 boot errorY
Y
Y
1Bh /
A1:POST Value
1Ch /
A1:Lan AMC0 Link
1Dh /
A1:Lan AMC1 Link
1Eh /
A1:Lan Front0 Lk
1Fh /
A1:Lan Front1 Lk
OEM Post Value (C6h) /
OEM (78h)
LAN (27h) /
Sensor-specific (6Fh)
LAN (27h) /
Sensor-specific (6Fh)
LAN (27h) /
Sensor-specific (6Fh)
LAN (27h) /
Sensor-specific (6Fh)
0000h / 0000h /
00FFh
0000h / 0000h /
0003h
0000h / 0000h /
0003h
0000h / 0000h /
0003h
0000h / 0000h /
0003h
POST Value (from host I/O
port 80h)
LAN link status –
AMC port 0
LAN link status –
AMC port 1
LAN link status –
Front port 0 (upper)
LAN link status –
Front port 1 (lower)
N
N
N
N
N
ID 1052-3624, Rev. 1.0Page 29
IPMI FirmwareAM4022
4.2Sensor Thresholds
The AM4022 CPU module is available for two different operating temperature ranges. For each
operating temperature range, a set of temperature thresholds for the sensors is defined. The
standard temperature range uses thresholds defined by Table 11, and the extended temperature range uses thresholds defined by Table 12. Table 13 provides voltage sensor thresholds.
Table 11:Thresholds - Standard Temperature Range
Sensor Number /
ID String
Upper non-recoverable
Upper critical
Upper non-critical
Normal max.
Nominal
Normal min.
Lower non-critical
Lower critical
Lower non-recoverable
0Eh /
A1:Temp
CPU
115 °C118 °C100 °C
105 °C108 °C90 °C
95 °C98 °C80 °C
90 °C93 °C75 °C
80 °C83 °C65 °C
3 °C3 °C0 °C
1 °Cn.a.-5 °C
n.a.n.a.-7 °C
n.a.n.a.-10 °C
0Fh /
A1:Temp
PCH
Table 12:Thresholds - Extended Temperature Range
Sensor Number /
ID string
0Eh /
A1:Temp
CPU
0Fh /
A1:Temp
PCH
11h /
A1:Temp
Air
11h /
A1:Temp
Air
Upper non-recoverable
Upper critical
Upper non-critical
Normal max.
Nominal
Normal min.
Lower non-critical
Lower critical
Lower non-recoverable
Page 30ID 1052-3624, Rev. 1.0
115 °C118 °C100 °C
105 °C108 °C90 °C
95 °C98 °C80 °C
90 °C93 °C75 °C
80 °C83 °C65 °C
3 °C3 °C0 °C
1 °Cn.a.-40 °C
n.a.n.a.-42 °C
n.a.n.a.-45 °C
AM4022IPMI Firmware
Table 13:Voltage Sensor Thresholds
Sensor Number /
ID String
Upper non-recoverable
Upper critical
Upper non-critical
Normal max.
Nominal
Normal min.
Lower non-critical
Lower critical
Lower non-recoverable
17h /
A1:Board
3.3vIPM
n.a.n.a.n.a.n.a.
3.50 V13.4 V5.36 V3.50 V
n.a.n.a.n.a.n.a.
3.46 V13.2 V5.31 V3.46 V
3.30 V12.0 V5.00 V3.30 V
3.13 V10.8 V4.70 V3.13 V
n.a.n.a.n.a.n.a.
3.11 V10.7 V4.67 V3.11 V
n.a.n.a.n.a.n.a.
18h /
A1:Board 12.0v
19h /
A1:Board 5.0V
A1:Board 3.3V
1Ah /
ID 1052-3624, Rev. 1.0Page 31
IPMI FirmwareAM4022
4.3OEM Event/Reading Types
Kontron’s OEM specific sensor types and sensor event type codes are presented in the following table.
Table 14:OEM Event/Reading Types
OEM
SENSOR
TYPE (CODE)
Firmware Info 1 (C0h)70hInternal Diagnostic Data
Firmware Info 2 (C0h)71hInternal Diagnostic Data
Config Error (CEh)6Fh
(sensor type specific)
OEM
EVENT/READING
TYPE (CODE)
DESCRIPTION
Sensor-specific
Offset
00hConfiguration OK, no error.
01hReserved
02hUnsupported Board
03hUnsupported Hardware
04hReserved
05hReserved
06hReserved
07hReserved
08hPCIe Configuration Conflict with
Event
(active) uEFI setting
Board Reset (C4h)6Fh
(sensor type specific)
09hPCIe (uEFI FW bank 0) – conflict
0AhPCIe (uEFI FW bank 1) – conflict
Sensor-specific
Offset
00hReserved
01hHwPowerReset
02hPCIReset
03hHwWatchDogReset
04hSoftReset
05hReserved
06hColdReset
07hIPMICommand
08hReserved
09hReserved
0AhBMCWatchdog
Event
Page 32ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
Table 14:OEM Event/Reading Types (Continued)
OEM
SENSOR
EVENT/READING
TYPE (CODE)
IPMBL State (C3h)6Fh
(sensor type specific)
Post Value (C6h)6Fh
(sensor type specific)
Firmware Upgrade Manager
(C7h)
6Fh
(sensor type specific)
OEM
TYPE (CODE)
DESCRIPTION
Sensor discrete
State
08hIPMB-L running
othersIPMB-L not running
Sensor discrete
State
Bits [7:0]Post Value (read from host I/O port
Bits [15:8]Reserved
Sensor-specific
Offset
0hFirst Boot after upgrade
1hFirst Boot after rollback (error)
2hFirst Boot after errors (watchdog)
3hFirst Boot after manual rollback
Meaning
Meaning
80h)
Event
4hReserved
5hReserved
6hReserved
7hReserved
8hFirmware Watchdog Bite, reset
occurred
ID 1052-3624, Rev. 1.0Page 33
IPMI FirmwareAM4022
Table 14:OEM Event/Reading Types (Continued)
OEM
SENSOR
TYPE (CODE)
Power Supply (08h) i.e. for
Power Good /
Power Good Event
OEM
EVENT/READING
TYPE (CODE)
77h
(OEM)
DESCRIPTION
Sensor-specific
Offset
0h12V good (PWR)
1h5V good
2h3V3 good
3hReserved
4hReserved
5hReserved
6hReserved
7hvccCore good
8hReserved
9hReserved
AhReserved
Bh3V3IPMI good (MP)
Event
Hot Swap Sensor (F2h)6Fh
(sensor type specific)
ChReserved
Sensor-specific
Offset
00hHandle close
01hHandle open
02hQuiesced
03hBackend Power Failure
04hBackend Power Shutdown
Event
Page 34ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
5.Firmware Code
5.1Structure and Functionality
MMC firmware code is organized into boot code and operational code (IPMI firmware). Both
are stored in the internal flash of the micro-controller.
An additional external SPI flash device is used for holding redundant copies of the operational
code. This additional flash device is organized to have two banks. One of them will always hold
a copy of the active operational code. The other firmware bank holds either a newly downloaded firmware or the 'previous good' operational code for rollback.
Upon an MMC start or reset, the controller first executes the boot code. The boot code will
check the status of the firmware banks and calculate a checksum of the operational code. Upon
successful verification of the operational code checksum, the firmware will execute the operational code. The operational code is upgradable in the field.
5.2MMC Firmware Configuration
For initial setup and to get some basic information on the AM4022 MMC, use the AM4022
uEFI Shell or external IPMI access. For further information refer to the AM4022 uEFI BIOS
User Guide, Chapter 6, uEFI Shell.
Beside the built-in uEFI Shell commands, the Kontron uEFI implementation provides a
number of additional commands, related to the specific hardware features of the system.
The Kontron uEFI Shell command for configuration of the system management is the kipmi
command. The kipmi command provides a set of parameters to support various IPMI
management controllers. Note that not all parameters have an impact on the AM4022 MMC.
For a complete list of the kipmi parameters, refer to the AM4022 uEFI BIOS User Guide,
Chapter 6, uEFI Shell.
5.3KCS Interface Interrupt
The default factory setting of a AM4022 for its KCS interface is IRQ11. When changing the
configuration, the uEFI BIOS creates/updates an entry in the SMBIOS table. This record
contains the following information (among others):
•type of the supported interface (KCS style)
•selected interrupt (11 or none)
This interrupt configuration is needed by the operating system’s KCS interface kernel driver
when it is loaded.
Changing the KCS interrupt number using the kipmi irq uEFI Shell command requires a restart
of the uEFI BIOS. To restart the AM4022, issue the reset uEFI Shell command.
ID 1052-3624, Rev. 1.0Page 35
IPMI FirmwareAM4022
5.4Firmware / Module Identification
IPMI provides two methods to identify the AM4022 MMC firmware:
•Issuing the IPMI Command Get Device ID
•Reading the Device Locator Record (SDR Type 12h)
A full description of the IPMI command Get Device ID and the Device Locator Record
(SDR Type 12h) can be found in the IPMI specification. For further information refer to Table
2, Related Publications.
IPMI Command: Get Device ID
The response on the IPMI command Get Device ID offers the following information
(among others):
•Manufacturer ID = 3A98h / 15000d (Kontron IANA ID)
•Device ID = 20h (NXP® ARM7 microcontroller)
•Product ID= identifies the firmware (its board family firmware)
•Firmware revision (byte 4:5) reflects the version of the running firmware, which will
change after firmware update.
•SDR revision (byte 13, OEM extension) will be incremented with each firmware update
For a description of the OEM extensions refer to Chapter 3.1, “Get Device ID Command with
OEM Extensions”.
Device Locator Record
The Device Locator Record (SDR Type 12h) contains a Device ID String which identifies the
MMC as AM4022 MMC. Additionally, some run-time information such as AMC slot and slotdependent IPMB address is available in this record.
For example, when using the Linux “ipmitool” on a AM4022 placed in the first AMC slot of a
µTCA system, by calling:
ipmitool sdr list mcloc
the following information is displayed:
A1:AM4022 | … @72h | ok
Page 36ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
5.5Firmware Upgrade
The standard way to upgrade the MMC's operational code is to use the open tool “ipmitool” (see
Table 2, Related Publications). This tool allows download and activation of new operational
code and also rollback to the “last known good” operational code. Additionally, the status and
the firmware version of the redundant firmware copies can be checked.
For local or remote firmware upgrade, the following IPMI interfaces are available:
•KCS interface (locally, requires active payload, but fast)
•IPMB (remote, independent of the payload state)
•LAN (remote, via IOL, requires also active payload)
During the download process, the currently running operational code operates as usual until
the activation command is issued. During the activation process, the MMC is off-line for about
45 seconds while the boot code is re-organizing the firmware storage. Afterwards, it starts the
new operational code. If this doesn't succeed, after a timeout the boot code performs an automatic rollback to the “last known good” operational code.
5.5.1Firmware File Formats
Firmware images for upgrade are provided in two formats:
•Firmware in binary format, e.g. FW_IPMI_<BOARD>_<REL>_FWUM.bin,
for usage with “ipmitool fwum ..” commands
•Firmware images in the PICMG defined HPM.1 file format,
e.g. FW_IPMI_<BOARD>_<REL>_FWUM.hpm,
for usage with “ipmitool hpm ..” commands.
where:
<BOARD>identifies to board family of the MMC’s firmware
<REL>identifies to release (version) of MMC’s firmware.
ID 1052-3624, Rev. 1.0Page 37
IPMI FirmwareAM4022
5.5.2Firmware Upgrade - “ipmitool hpm”
Firmware upgrade using a HPM.1 file requires at least “ipmitool” version 1.8.10.
The firmware upgrade procedure starts with downloading the HPM.1 file using, for example,
the following command:
ipmitool hpm upgrade <HPM.1_FWFile>.hpm all
The next step is the activation of the newly downloaded MMC firmware. This is done using:
ipmitool hpm activate
Detailed information about the currently active firmware versions or the redundant copies can
be obtained using the commands mentioned below.
To obtain detailed version information of the active MMC firmware, use the following command:
ipmitool hpm compprop 1 1
To obtain the version of the rollback copy (only valid if a newly downloaded firmware is already
activated), use the following command:
ipmitool hpm compprop 1 3
To obtain the version of the newly downloaded MMC firmware (only valid after download and
before activation), use the following command:
ipmitool hpm compprop 1 4
To obtain detailed information about the MMC’s HPM.1 upgrade capabilities, use the following
command:
ipmitool hpm targetcap
To perform a manual rollback to the previously good firmware image, use the following command:
ipmitool hpm rollback
5.5.3Firmware Upgrade - “ipmitool fwum”
“ipmitool” version 1.8.9 doesn’t support HPM.1 correctly. Tool versions prior to this do not
support HPM.1 at all.
The firmware upgrade procedure starts with downloading the binary firmware file using, for
example, the following command:
ipmitool fwum download <Binary_FWFile>.bin
Page 38ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
The next step is the activation of the newly downloaded MMC firmware. This is done using
ipmitool fwum upgrade
Detailed information about the currently active firmware versions and the redundant copies
can be obtained using the following command:
ipmitool fwum status
Some information about the MMC’s upgrade capabilities can be determined using the command:
ipmitool fwum info
To perform a manual rollback to the previously good firmware image, use the following
command:
ipmitool fwum rollback
6.FRU Information
The MMC provides 4 kB of non-volatile storage space for FRU information. Some of the data
stored there, such as the Module Current Requirements record or E-Keying information (refer
to AMC.0 specification for details), are mandatory for module functionality in an ATCA/AMC environment.
Please note that missing FRU information possibly will prevent the AMC module from being accepted by the carrier controller during the hot swap process, and the module will possibly not
receive payload power.
Full low-level access to read or write a module's FRU information is provided by regular IPMI
FRU Device commands. Please be careful when writing FRU information directly using standard IPMI commands. Damaging the FRU information may lead to a non-working payload.
6.1FRU Version Identification
The FRU data fields, as defined in the IPMI specification 2.0, are used to record the version of
the FRU installed. The revision number is incremented for each new release of FRU data.
Example of board FRU ID: “STD_R01”
Example of product FRU ID: “STD_R01”
6.2FRU Data Update
Update of the FRU data can be done via regular IPMI FRU device commands. The correct FRU
data must be prepared at the factory.
ID 1052-3624, Rev. 1.0Page 39
IPMI FirmwareAM4022
7.E-Keying
E-Keying has been defined in the AMC.0 R2.0 Specification to prevent module damage,
prevent malfunction, and verify bay connection compatibility. Therefore, the FRU data of an
AMC module contains PICMG-defined records which describe the module’s AMC
interoperability:
•Module Current Requirements Record
•Clock Configuration Record, for the PCI Express reference clock
•AMC Point-to-point Record, describing module’s AMC port capabilities
The IPMI commands Set AMC Port State and Get AMC Port State defined by the
AMC.0 specification are used by the carrier or MCH for either granting or rejecting the E-keys
(i.e. enabling or disabling of AMC ports during E-Keying).
The DIP Switch SW2 can be used to forcibly disable some AMC ports and to configure the PCI
Express reference clock if required.
The AM4022 does not have provisions for an external PCIe clock input (FCLKA). For this reason it does not support Spread Spectrum clocking (SSC) which is also indicated in the module’s
FRU data.
Please refer to the AM4022 User Guide for further information.
8.uEFI BIOS Failover Control - Automatic SPI
Boot Flash Selection
The uEFI BIOS code is stored in two different SPI Boot flash devices designated as the standard SPI boot flash and the recovery SPI boot flash.
By default, the uEFI BIOS code stored in the standard SPI boot flash is executed first. If this
fails, the uEFI BIOS code in the recovery SPI boot Flash is then executed.
During boot-up, the uEFI BIOS reports its operational status to the MMC within a given time. If
the status is "failed" or not reported within the given time, the MMC selects the recovery SPI
boot flash, resets the board's processor, and waits for the status report from the uEFI BIOS
again.
In the event the recovery boot operation fails, the MMC reports it, but takes no further action of
its own.
When a boot operation fails, a "Boot Error - Invalid boot sector" event is asserted for the related
sensor:
•"FWH0 Boot Err" sensor indicates the standard SPI boot flash has failed
•"FWH1 Boot Err" sensor indicates the recovery SPI boot flash has failed
For further information regarding SPI boot flash selection, refer to Chapter 3.2, Table 6.
Page 40ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
9.OS Boot Order Selection by OEM IPMI
Normally the uEFI BIOS will apply the OS boot order which was selected in the uEFI BIOS
menu “uEFI Boot/Boot Option Priorities”. But there is another alternative boot order which is
stored in the IPMI controller's non-volatile memory. This boot order can be set and read by IPMI
OEM commands. At payload start the IPMI controller writes this boot order into a register where
the uEFI BIOS can read it. If this IPMI controller's boot order has a non-zero value, the uEFI
BIOS will use it instead of its own boot order.
10.Hot Swap
As a hot-swappable field replaceable unit (FRU), the AM4022 also follows the same stringent
carrier grade RASM feature set, namely - Reliability, Availability, Serviceability, Maintainability.
When offered in combination with AdvancedTCA platforms, TEM (Telecom Equipment Manufacturers) clients literally conserve valuable system AdvancedTCA system slots. The AM4022
supports full hot swap capability as per PICMG 3.0. It can be removed from or installed in the
system while it is on (without powering-down the system). Please refer to the PICMG 3.0 specification for additional details.
During hot swap of a working module, the payload side has to be shut down automatically on
command of the MMC and the end of shutdown has to be signalled back to the MMC. Because
the AM4022 supports ACPI, an OS on the payload side which supports this too makes shutdown very easy. If the OS doesn't support ACPI, there is a special method to be used.
10.1Method 1: The Payload OS Supports ACPI
Requirements:
•The ACPI daemon must be active.
•An ACPI power button event must result in a sleep state.
Hot swap operation sequence processed by MMC and OS:
•On command of the carrier controller, the MMC simulates the pressing and release of the
power button to force an ACPI event.
•The ACPI daemon detects this ACPI event and initiates the shutdown of the payload software system.
•At the end of shutdown, the payload hardware system reports the sleep state to the MMC
by setting the appropriate signal line.
•The MMC detects the sleep state and reports this to the carrier controller (“quiesced”) so
that the hot swap processing can be continued and finished.
By default the MMC waits endlessly for the sleep state. Please note that some shelf managers
or MCHs use a timeout to simply switch off a module which needs too much time to reach sleep
state. As this might be an undesirable situation, refer to the appropriate manual for further assistance. In any event, if an endless wait is to be avoided, it is possible to set a timeout time for
the module's MMC after which the system will be switched off unconditionally. For the setting
of the timeout refer to Chapter 3.4, OEM Module Quiescence Feedback.
ID 1052-3624, Rev. 1.0Page 41
IPMI FirmwareAM4022
10.2Method 2: The Payload OS Does Not Support ACPI
Requirements:
•At system start on the payload side, the Kontron shutdown daemon “grnsd” must be started. It is included in the Linux board support packages for the AM4022. This daemon communicates cyclically with the MMC for the exchange of states, commands and
acknowledges. For this, it uses the OEM Module Quiescence Feedback command.
Refer to Chapter 3.4. In principle, it plays the same role as the ACPI daemon of Method
1 above.
Hot swap operation sequence processed by MMC and OS:
•On command of the carrier controller the MMC sets a “shut down request” flag.
•The “grnsd” daemon recognizes this request in the response to its cyclical OEM ModuleQuiescence Feedback command and initiates the shutdown of the payload software
system.
•At the end of the shutdown process, the “grnsd” daemon informs the MMC by setting the
appropriate flag when calling the OEM Module Quiescence Feedback command.
•The MMC reports this to the carrier controller so that the hot swap processing can be continued and finished.
By default the MMC waits endlessly for this information. If an endless wait is to be avoided, it
is possible to set a timeout time after which the system will be switched off unconditionally. For
the setting of the timeout refer to Chapter 3.4, OEM Module Quiescence Feedback.
11.LAN Functions
11.1Overview
The two Ethernet channels on the AMC Fabric Interface and also the two Ethernet channels on
the front panel can - in parallel to their “normal” use - be used for the following special purposes:
•IPMI over LAN (IOL)
•Serial over LAN (SOL)
Common for both kinds of communication is the use of the RMCP/RMCP+ protocol for the
packing of the data to be transferred. The RMCP/RMCP+ protocol uses the TCP port 623 by
default.
While IOL serves to transport IPMI commands and their responses, SOL serves to transport
any serial data. In each case, the MMC serves as a protocol encoder and decoder. IOL is able
to use both RMCP and RMCP+ protocols. SOL works only with the RMCP+ protocol.
Please note that IOL and SOL need the Ethernet device to be powered. Therefore, the module
(payload) must be fully powered.
11.2Setting Up the Ethernet Channel
There are two methods to configure the LAN settings (IOL/SOL) for the four Ethernet channels:
•By use of the kipmi net uEFI Shell command in the uEFI BIOS
Page 42ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
•By use of the open tool “ipmitool” or IPMI commands
The setup methods are compatible, i.e. both methods show the parameters which are set by
the other one.
The setup is separate for all four channels. When the MAC addresses are set, the ones which
are programmed into the hardware must be re-used. This is a restriction. The IP addresses of
a channel being used by “normal” payload traffic and IOL/SOL traffic may differ but need not
differ as long as port 623 is not used in parallel by payload and IOL/SOL.
The four Ethernet ports provided by the AM4022 are assigned to the following channels:
Channel 1: AMC port 0
Channel 2: AMC port 1
Channel 3: Front port 0, GbE C, upper connector (J4)
Channel 4: Front port 1, GbE D, lower connector (J3)
11.3Basic Setup from uEFI Shell
With the 'kipmi net' command from uEFI Shell some basic settings such as IP address, subnet mask and gateway address can be setup for all of the four Ethernet channels.
11.4Setup by “ipmitool” or IPMI Commands
The open tool “ipmitool” offers commands for the setup of the four Ethernet channels. All possible options are shown by issuing:
ipmitool lan set
If “ipmitool” is not usable, the LAN parameters can be set by using standard IPMI commands
as defined in the IPMI specification.
To show the current LAN parameters for a channel, “ipmitool” offers the command:
ipmitool lan print <channel = 1, 2, 3, 4>
11.5Setup of User Accounts and Password
The open tool “ipmitool” offers commands for the listing and manipulation of user accounts for
channels 1 through 4. An overview can be obtained by issuing:
ipmitool user
The predefined user accounts for a channel can be listed using the following command:
ipmitool user list <channel = 1, 2, 3, 4>
ID 1052-3624, Rev. 1.0Page 43
IPMI FirmwareAM4022
For every channel, the AM4022 has these predefinitions in non-volatile memory:
ID Name Callin Link Auth IPMI Msg Channel Priv Limit
1 false true true USER
2 admin false true true ADMINISTRATOR
Please note that the ADMINISTRATOR password is preset with admin.
Changed accounts and passwords stay valid after payload power-off.
The accounts must be activated using the following command:
ipmitool user enable <user number>
11.6IPMI Over LAN (IOL)
IPMI over LAN is used to allow the IPMI controller to communicate with the MMC via LAN using
the RMCP or the RMCP+ protocol. The data transferred are IPMI commands and the responses to them.
To enable LAN support after parameter setup this command must be issued:
ipmitool lan set <channel = 1, 2, 3, 4> access on
Please note that the following commands must use the IP address which belongs to the enabled channel.
The open tool “ipmitool” can serve as a control program and user interface for this. “ipmitool”
allows the issuing of generic IPMI commands such as:
ipmitool -I lan -H 192.168.3.189 -U admin -P admin -A PASSWORD raw 6 1
or to call complex functions like “mc.info2:
ipmitool -I lan -H 192.168.3.189 -U admin -P admin -A PASSWORD mc info
This uses many generic IPMI commands to get the information needed.
11.7Serial Over LAN (SOL)
Serial over LAN connects the COM1 or /dev/ttyS0 respectively of the AM4022's payload side
to an Ethernet channel. The MMC resides between this serial interface and one of the Ethernet
channels. It serves as an encoder and a decoder for the used RMCP+ protocol and controls
the data stream. Outside the AM4022 for example, the open tool “ipmitool” can be used to drive
the SOL session, i.e. it offers a console function to communicate via Ethernet with the
AM4022's serial interface.
The MMC firmware supports only “straight password authentication” SOL sessions with default
privilege level USER.
Page 44ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
Opening an SOL session requires special parameters as shown below:
ipmitool -I lanplus -H 192.168.3.189 -U admin -P admin -L USER -C 0 sol
activate
The serial interface can be used as a connection, for example:
•To a user program on the AM4022 payload
•To the uEFI BIOS. Refer to the Main Setup menu, Serial Port Console Redirection
function in the AM4022 uEFI BIOS User Guide. The serial parameters can be set via this
function.
•To a Linux login console. This can be activated after payload start, for example, by the
command:
getty -h 115200 /dev/ttyS0
SOL supports and requires serial hardware handshake. This should be activated for the serial
port. Otherwise transmitted data might get lost. In any case the same serial parameters for the
used payload side serial interface and the MMC's serial interface must be used.
The parameters for the MMC's serial interface can be set by using the following command:
ipmitool sol set
This command shows all options that can be set.
Further options are listed after issuing the following command:
ipmitool sol help
12.OS Support / Tools
12.1Linux Tools
OpenIPMI - KCS driver
Normally all drivers and kernel modules needed for communication between the payload-sided
software and the MMC firmware via the KCS interface come with the distribution. Latest sources can be downloaded from: http://openipmi.sourceforge.net. The OpenIPMI project may be
downloaded from this source as well. The OpenIPMI library package includes some applications and the needed libraries.
“ipmitool”
Another very useful all-in-one tool is the “ipmitool” (http://ipmitool.sourceforge.net). It provides
a user-friendly interface to many IPMI features and extensions, for example, to get sensor
readings, change sensor thresholds or access other Management Controllers via IPMB. Before
“ipmitool” can be used, the OpenIPMI driver mentioned above must be loaded too.
ID 1052-3624, Rev. 1.0Page 45
IPMI FirmwareAM4022
AM4020
GbE D
GbE C
0
1
2
3
LED1 (Out-of-Service LED)
LED2 (Health LED)
HS LED (Hot Swap LED)
IPMI Module Management LEDs
12.2OS Support - Board Support Packages
To see which Operating Systems are supported refer to the board's data sheet. Please visit
http://www.kontron.com to get the data sheet. Please also have a look in the download section
for latest versions of Board Support Packages or Firmware Updates.
For further information concerning IPMI, refer to the BSP documentation for the respective OS.
13.IPMI Module Management LEDs
There are three IPMI Module Management LEDs on the front panel of the AM4022. The following figure illustrates a Full-Size AM4022 module and the location of the LEDs.
Page 46ID 1052-3624, Rev. 1.0
AM4022IPMI Firmware
The following table describes the functions of the IPMI Module Management LEDs.
Table 15:Module Management LED Functions
OVERRIDE MODE
selectable by user or
LEDCOLORSTATENORMAL MODE
carrier, depending
on PICMG LED
command
LED1
(Out-ofService
LED)
LED2
(Health
LED)
HS LED
(Hot
Swap
LED)
redoffDefaultBy user:
green/amber/redoffPayload is off; module is not pow-
blueona) Module ready for hot swap
onMMC out of service or in reset
state
blinkingMMC firmware upgrade
ered
greenModule is healthy (normal opera-
tion) and all related sensors are
within the specified range
amberPayload is on and at least one
sensor is out of range
redReserved
extraction, or
b) Module has just been inserted
in a powered system
blinkingModule hot swap in progress;
module not ready for extraction
offModule is in normal operation
• Only lamp test
By user:
• Only lamp test
By carrier:
• On
• Off
• Slow/ Fast Blink-
ing
By user:
• Only lamp test
ID 1052-3624, Rev. 1.0Page 47
IPMI FirmwareAM4022
This page has been intentionally left blank.
Page 48ID 1052-3624, Rev. 1.0
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.