Kontron AM4020 User Manual
» User Guide «
AM4020
IPMI Firmware
Doc. ID: 1036-5671, Rev. 2.0
March 30, 2011
If it’s embedded, it’s Kontron.
P R E L I M I N A R Y
Preface AM4020
Revision History
Publication Title:
Doc. ID: 1036-5671
Rev. Brief Description of Changes Date of Issue
1.0 Initial issue 9-Jun-2010
2.0 General update 30-Mar-2011
AM4020 IPMI Firmware User Guide
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.com
D - 87600 Kaufbeuren Germany
For further information about other Kontron products, please visit our Internet web site:
P R E L I M I N A R Y
www.kontron.com.
Disclaimer
Copyright © 201 1 Kontron AG. All rights reserved. All data is for information purposes only and
not guaranteed for legal purposes. Information has been carefully checked and is believed to
be accurate; however, no responsibility is assumed for inaccuracies. Kontron and the Kontron
logo and all other trademarks or registered trademarks are the property of their respective owners and are recognized. Specifications are subject to change without notice.
Page ii ID 1036-5671, Rev. 2.0
AM4020 Preface
Table of Contents
Revision History .........................................................................................................ii
Imprint ........................................................................................................................ii
Disclaimer ..................................................................................................................ii
Table of Contents ......................................................................................................iii
List of Tables ............................................................................................................vii
1. Introduction ...................................................................................3
1.1 Terminology and Acronym Definitions ..........................................................3
1.2 Related Publications ....................................................................................4
1.3 IPMI in AdvancedMC / AdvancedTCA Environment .................................... 4
1.4 Module Management Controller Hardware ..................................................5
2. MMC Firmware ...............................................................................5
2.1 Key Features ................................................................................................5
2.2 Supported IPMI and ATCA Commands ........................................................ 6
2.2.1 Standard IPMI Commands ................................................................... 6
2.2.2 AdvancedTCA and AMC Commands ................................................ 14
3. OEM Commands and Command Extensions ...........................16
3.1 Get Device ID Command with OEM Extensions ........................................ 16
3.2 Set Control State (Firmware Hub, Boot Order) .......................................... 17
3.3 Get Control State (Firmware Hub, Boot Order) .......................................... 18
3.4 OEM Module Quiescence Feedback .........................................................19
3.4.1 Usage if a Shutdown Daemon is Announced as Present .................. 20
P R E L I M I N A R Y
3.4.2 Usage if no Shutdown Daemon is Announced as Present ................ 20
4. Sensors Implemented on the AM4020 .......................................21
4.1 Sensor List .................................................................................................22
4.2 Sensor Thresholds .....................................................................................24
4.3 OEM Event/Reading Types ........................................................................ 26
ID 1036-5671, Rev. 2.0 Page iii
Preface AM4020
5. Firmware Code ............................................................................ 29
5.1 Structure and Functionality .........................................................................29
5.2 MMC Firmware Configuration .....................................................................29
5.2.1 KCS Interface Interrupt ......................................................................29
5.3 Firmware / Module Identification .................................................................30
5.4 Firmware Upgrade ......................................................................................31
5.4.1 Firmware File Formats .......................................................................31
5.4.2 Firmware Upgrade - “ipmitool hpm” ..................................................32
5.4.3 Firmware Upgrade - “ipmitool fwum” .................................................33
6. FRU Information ......................................................................... 33
6.1 FRU Version Identification ..........................................................................33
6.2 FRU Data Update .......................................................................................34
7. E-Keying ......................................................................................34
7.1 PCI Express Lane Width – x4 or x1 ............................................................34
7.2 PCI Express Reference Clock ....................................................................34
8. uEFI BIOS Failover Control - Automatic Flash Selection ....... 35
9. Hot Swap ..................................................................................... 36
P R E L I M I N A R Y
9.1 Method 1: The Payload OS Supports ACPI ................................................36
9.2 Method 2: The Payload OS Does Not Support ACPI .................................36
10. LAN Functions ............................................................................ 37
10.1 Overview .....................................................................................................37
10.2 Setting Up the Ethernet Channel ................................................................37
10.3 Basic Setup from uEFI Shell .......................................................................38
10.4 Setup by “ipmitool” or IPMI Commands ......................................................38
10.5 Setup of User Accounts and Password ......................................................38
10.6 IPMI Over LAN (IOL) ..................................................................................39
Page iv ID 1036-5671, Rev. 2.0
AM4020 Preface
10.7 Serial Over LAN (SOL) ............................................................................... 39
11. OS Support / Tools ......................................................................40
11.1 Linux Tools ................................................................................................. 40
11.2 OS Support - Board Support Packages ..................................................... 40
12. IPMI Module Management LEDs ................................................41
ID 1036-5671, Rev. 2.0 Page v
P R E L I M I N A R Y
Preface AM4020
This page has been intentionally left blank.
P R E L I M I N A R Y
Page vi ID 1036-5671, Rev. 2.0
AM4020 Preface
List of Tables
1 Terminology and Acronym Definitions ............................................................3
2 Related Publications ...................................................................................... 4
3 Standard IPMI Commands .............................................................................6
4 AdvancedTCA and AMC Commands .......................................................... 14
5 Get Device ID Command with OEM Extensions .......................................... 16
6 Set Control State ..........................................................................................17
7 Get Control State ......................................................................................... 18
8 OEM Module Quiescence Feedback ........................................................... 19
9 Sensor Name Prefix .....................................................................................21
10 Sensor List ................................................................................................... 22
11 Thresholds - Standard Temperature Range ................................................. 24
12 Thresholds - Extended Temperature Range ................................................ 24
13 Voltage Sensor Thresholds .......................................................................... 25
14 OEM Event/Reading Types .......................................................................... 26
15 IPMI Module Management LED Functions .................................................. 42
P R E L I M I N A R Y
ID 1036-5671, Rev. 2.0 Page vii
Preface AM4020
This page has been intentionally left blank.
P R E L I M I N A R Y
Page viii ID 1036-5671, Rev. 2.0
AM4020 IPMI Firmware
Chapter 1
1
Introduction
ID 1036-5671, Rev. 2.0 Page 1
P R E L I M I N A R Y
IPMI Firmware AM4020
This page has been intentionally left blank.
P R E L I M I N A R Y
Page 2 ID 1036-5671, Rev. 2.0
AM4020 IPMI Firmware
1. Introduction
1.1 Terminology 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/ACRONYM DESCRIPTION
AMC Advanced Mezzanine Card
BSP Board Support Package
DMI Desktop Management Interface
FRU Field Replaceable Unit
FWH Firmware Hub
2
I
C
IPMB Intelligent Platform Management Bus
IPMB-0 AdvancedTCA shelf-level IPMB
IPMB-L Local, on-carrier IPMB that links the carrier IPMC with the MMCs of installed modules
IPMC Intelligent Platform Management Controller located on the AMC carrier
IPMI Intelligent Platform Management Interface
IOL IPMI over LAN. An MMC is accessed via LAN, not IPMB.
KCS Keyboard Controller Style
MMC Module Management Controller – an IPMI controller located on the AMC module
MP Management Power
PICMG PCI Industrial Computer Manufacturer Group
PWR Payload Power
SDR Sensor Data Record
Inter-Integrated Circuit
P R E L I M I N A R Y
SDRR Sensor Data Record Repository
SEL System Event Log
SMBIOS System Management BIOS
SMS System Management Software (designed to run under the OS)
SOL Serial over LAN. A serial interface is redirected by LAN using the RMCP+ protocol.
ID 1036-5671, Rev. 2.0 Page 3
IPMI Firmware AM4020
1.2 Related Publications
The following publications contain information relating to this product.
Table 2: Related Publications
PRODUCT PUBLICATION
IPMI IPMI Specification V2.0
IPMI IPMI - Platform Management FRU Information Storage Definition v1.0,
Document Revision 1.1
MicroTCA PICMG® MTCA.0 Micro Telecommunications Computing Architecture R1.0
AMC PICMG® AMC.0, Advanced Mezzanine Card Specification R2.0
PICMG® AMC.1, PCI Express R2.0
PICMG® AMC.2, Gigabit Ethernet R1.0
PICMG® AMC.3, Storage Interfaces R1.0
AM4020 AM4020 User Guide, ID 1036-1863, Rev. 3.0
AM4020 uEFI BIOS User Guide, ID 1036-5670, Rev. 2.0
AM4020 BSP AM4020 Board Support Package
IPMI Tools ipmitool documentation: http://ipmitool.sourceforge.net
IPMI Tools OpenIPMI documentation: http://www.openipmi.sourceforge.net
As a hot-swappable field-replaceable unit (FRU), the AM4020 follows the stringent carrier
grade RASM feature set, namely - Reliability, Availability, Serviceability, Maintainability.
Built in accordance with the AMC.0 specification, the AM4020 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 AM4020 is equipped with a Module Management Controller (MMC).
P R E L I M I N A R Y
1.3 IPMI 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 ena bles the module payload power , vario us criteria must be satisfied by both the carrier and the module, including power requirement s and capabilities, matching interfaces, current module hot swap state, an d any other special conditions
as specified by the Shelf Manager policy.
Page 4 ID 1036-5671, Rev. 2.0
AM4020 IPMI Firmware
1.4 Module Management Controller Hardware
On the AM4020 processor AMC module, the MMC is implemented using the NXP LPC2368
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, PCH and MCH 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.1 Key Features
The following are key features of the AM4020 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
P R E L I M I N A R Y
• Complete FRU functionality
• Firmware can be updated in the field
• Two firmware banks implemented, firmware bank management is done by the open tool
“ipmitool” (functions “hpm” or “fwum”)
• Downloading new firmware image does not break currently running firmware activities
• Manual and automatic firmware image roll-back in case of upgrade failure
• Interoperable with other AMC, ATCA, or IPMI solutions
ID 1036-5671, Rev. 2.0 Page 5
IPMI Firmware AM4020
• uEFI BIOS fail-over control for automatic uEFI BIOS firmware bank switching after having
detected a non-working uEFI BIOS
• 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 shows MMC's heartbeat and pulses on KCS interface traffic
2.2 Supported IPMI and ATCA Commands
2.2.1 Standard 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 AM4020 MMC.
M = mandatory, O = optional
Table 3: Standard IPMI Commands
IPMI 2.0
COMMAND
SPEC.
NETFN CMD
SECTION
IPM DEVICE “GLOBAL” COMMANDS M
Get Device ID 20.1 App 01h
Cold Reset 20.2 App 02h
Warm Reset 20.3 App 03h O / No
Get Self Test Results 20.4 App 04h
Manufacturing Test On 20.5 App 05h O / No
P R E L I M I N A R Y
Set ACPI Power State 20.6 App 06h O / No
Get ACPI Power State 20.7 App 07h O / No
Get Device GUID 20.8 App 08h O / No
KONTRON
SUPPORT
ON MMC
M / Yes
O / Yes
O / Yes
Broadcast “Get Device ID” 20.9 App 01h
BMC WATCHDOG TIMER COMMANDS
Reset Watchdog Timer 27.5 App 22h
Set Watchdog Timer 27.6 App 24h
Get Watchdog Timer 27.7 App 25h
Page 6 ID 1036-5671, Rev. 2.0
M / Yes
O
O / Yes
O / Yes
O / Yes
AM4020 IPMI Firmware
Table 3: Standard IPMI Commands (Continued)
IPMI 2.0
COMMAND
SPEC.
NETFN CMD
SECTION
BMC DEVICE AND MESSAGING COMMANDS O
Set BMC Global Enables 22.1 App 2Eh
Get BMC Global Enables 22.2 App 2Fh
Clear Message Flags 22.3 App 30h
Get Message Flags 22.4 App 31h
Enable Message Channel Receive 22.5 App 32h
Get Message 22.6 App 33h
Send Message 22.7 App 34h
Read Event Message Buffer 22.8 App 35h
Get BT Interface Capabilities 22.9 App 36h O / No
Get System GUID 22.14 App 37h O / No
KONTRON
SUPPORT
ON MMC
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
O / Yes
Get Channel Authentication Capabilities 22.13 App 38h
Get Session Challenge 22.15 App 39h
Activate Session 22.17 App 3Ah
Set Session Privilege Level 22.18 App 3Bh
Close Session 22.19 App 3Ch
Get Session Info 22.20 App 3Dh
Get AuthCode 22.21 App 3Fh O / No
Set Channel Access 22.22 App 40h
Get Channel Access 22.23 App 41h
Get Channel Info 22.24 App 42h
Set User Access 22.26 App 43h
Get User Access 22.27 App 44h
Set User Name 22.28 App 45h
Get User Name 22.29 App 46h
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
P R E L I M I N A R Y
Set User Password 22.30 App 47h
ID 1036-5671, Rev. 2.0 Page 7
O / Yes
Loading...