Kontron CP6004-SA User manual

If it’s embedded, it’s Kontron.
» User Guide «
D R A F T — F O R I N T E R N A L U S E O N L Y
CP6004-SA
CP6004-RA
CP6004-RC
CP6004X-SA
IPMI Firmware
Doc. ID: 1053-0139, Rev. 3.0
August 13, 2013

Preface CP6004-SA/-RA/-RC/CP6004X-SA
Page 2 ID 1053-0139, Rev. 3.0
D R A F T — F O R I N T E R N A L U S E O N L Y
Revision History
Imprint
Kontron Europe GmbH may be contacted via the following:
MAILING ADDRESS TELEPHONE AND E-MAIL
Kontron Europe GmbH +49 (0) 800-SALESKONTRON
Sudetenstraße 7 [email protected]
D - 87600 Kaufbeuren Germany
For further information about other Kontron products, please visit our Internet website:
www.kontron.com.
Disclaimer
Copyright © 2013 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 own-
ers and are recognized. Specifications are subject to change without notice.
Publication Title: CP6004-SA/-RA/-RC/CP6004X-SA IPMI Firmware User Guide
Doc. ID: 1053-0139
Rev. Brief Description of Changes Date of Issue
1.0 Initial issue 31-Oct-2012
2.0 General update, added description for the CP6004X-SA 8-Feb-2013
3.0 Added description for the CP6004-RA/CP6004-RC 13-Aug-2013

CP6004-SA/-RA/-RC/CP6004X-SA Preface
ID 1053-0139, Rev. 3.0 Page 3
D R A F T — F O R I N T E R N A L U S E O N L Y
Table of Contents
Revision History ........................................................................................................ 2
Imprint ....................................................................................................................... 2
Disclaimer ................................................................................................................. 2
Table of Contents ...................................................................................................... 3
List of Tables ............................................................................................................. 7
1. Introduction ...................................................................................9
1.1 Terminology and Acronym Definitions .......................................................... 9
1.2 Related Publications ...................................................................................11
1.3 IPMI Overview .............................................................................................11
2. IPMI Setup ....................................................................................12
2.1 IPMI in a CompactPCI Chassis .................................................................. 12
2.2 IPMI Setup for the CP6004-SA/-RA/-RC/CP6004X-SA ............................. 12
2.3 IPMI Setup for the Rack ............................................................................. 13
3. IPMI Controller Hardware ...........................................................13
4. IPMI Firmware ..............................................................................14
4.1 Key Features .............................................................................................. 14
5. Supported IPMI and ATCA Commands .....................................15
5.1 Standard IPMI Commands ......................................................................... 15
5.2 AdvancedTCA and AMC Commands ......................................................... 20
6. OEM Commands and Command Extensions ...........................21
6.1 Get Device ID Command with OEM Extensions ........................................ 21
6.2 Set Firmware Parameters .......................................................................... 22
6.3 Set Control State (SPI Boot Flash, Boot Order) ....................................... 23

Preface CP6004-SA/-RA/-RC/CP6004X-SA
Page 4 ID 1053-0139, Rev. 3.0
D R A F T — F O R I N T E R N A L U S E O N L Y
6.4 Get Control State (SPI Boot Flash, Boot Order) .........................................24
7. Sensors Implemented on the Board ......................................... 24
7.1 Sensor List ..................................................................................................25
7.2 Sensor Thresholds ......................................................................................28
7.3 OEM Event/Reading Types ........................................................................29
8. IPMI Firmware Code ...................................................................31
8.1 Structure and Functionality .........................................................................31
8.2 uEFI BIOS/IPMI Controller Interaction ........................................................31
8.3 IPMI Firmware Configuration ......................................................................31
8.4 Firmware Identification ................................................................................32
8.5 Firmware Upgrade ......................................................................................32
8.5.1 Firmware File Formats .......................................................................32
8.5.2 Firmware Upgrade - “ipmitool hpm” ..................................................33
8.5.3 Firmware Upgrade - “ipmitool fwum” .................................................34
8.6 Setting the SEL Time ..................................................................................34
8.7 IPMI Firmware Write Protection ..................................................................35
9. FRU Data ..................................................................................... 35
9.1 Structure and Functionality .........................................................................35
9.2 FRU Version Identification ..........................................................................35
9.3 Board-Specific FRU Data ...........................................................................36
9.4 FRU Data Update .......................................................................................36
9.5 FRU Data Write Protection .........................................................................36
10. XMC Card Support ...................................................................... 37
11. uEFI BIOS Failover Control - Automatic SPI Boot Flash Selection 37
12. OS Boot Order Selection by OEM IPMI ..................................... 37

CP6004-SA/-RA/-RC/CP6004X-SA Preface
ID 1053-0139, Rev. 3.0 Page 5
D R A F T — F O R I N T E R N A L U S E O N L Y
13. Hot Swap and Shutdown ............................................................38
13.1 Hot Swap Handle and Hot Swap LED ........................................................ 38
13.2 The Hot Swap and Shutdown Processes ................................................... 39
14. LAN Functions .............................................................................40
14.1 Overview .................................................................................................... 40
14.2 Setting Up the Ethernet Channel ............................................................... 41
14.3 Basic Setup from uEFI Shell ...................................................................... 41
14.4 Setup by “ipmitool” or IPMI Commands ..................................................... 41
14.5 Setup of User Accounts and Password ...................................................... 41
14.6 IPMI Over LAN ........................................................................................... 42
14.7 Serial Over LAN ......................................................................................... 43
15. OS Support / Tools ......................................................................44
15.1 Linux Tools ................................................................................................. 44
15.2 OS Support - Board Support Packages ..................................................... 44
16. IPMI and Hot Swap LEDs ............................................................45

Preface CP6004-SA/-RA/-RC/CP6004X-SA
Page 6 ID 1053-0139, Rev. 3.0
D R A F T — F O R I N T E R N A L U S E O N L Y
This page has been intentionally left blank.

CP6004-SA/-RA/-RC/CP6004X-SA Preface
ID 1053-0139, Rev. 3.0 Page 7
D R A F T — F O R I N T E R N A L U S E O N L Y
List of Tables
1 Terminology and Acronym Definitions ............................................................ 9
2 Related Publications .....................................................................................11
3 Standard IPMI Commands ........................................................................... 15
4 AdvancedTCA and AMC Commands .......................................................... 20
5 Get Device ID Command with OEM Extensions .......................................... 21
6 Set Firmware Parameters ............................................................................ 22
7 Set Control State .......................................................................................... 23
8 Get Control State ......................................................................................... 24
9 Sensor List ................................................................................................... 25
10 Gigabit Ethernet Link Sensor Assignment ................................................... 27
11 10 Gigabit Ethernet Link Sensor Assignment .............................................. 27
12 Thresholds - Standard and Extended Temperature Range ......................... 28
13 Voltage Sensor Thresholds .......................................................................... 28
14 OEM Event/Reading Types .......................................................................... 29
15 IOL/SOL Channel Assignment for the CP6004-SA/CP6004X-SA ............... 40
16 IOL/SOL Channel Assignment for the CP6004-RA/CP6004-RC ................. 40
17 IPMI and Hot Swap LEDs Function ............................................................. 46

Preface CP6004-SA/-RA/-RC/CP6004X-SA
This page has been intentionally left blank.
Page 8 ID 1053-0139, Rev. 3.0
D R A F T — F O R I N T E R N A L U S E O N L Y

CP6004-SA/-RA/-RC/CP6004X-SA IPMI Firmware
ID 1053-0139, Rev. 3.0 Page 9
D R A F T — F O R I N T E R N A L U S E O N L Y
1. Introduction
1.1 Terminology and Acronym Definitions
The following table provides descriptions for terms and acronyms used in this guide. The de-
scriptions are derived primarily from the IPMI specifications.
Table 1: Terminology and Acronym Definitions
TERM or ACRONYM DESCRIPTION
BMC Baseboard Management Controller
Each board is equipped with an IPMI controller acting either as a BMC or as an SMC.
However, in a CompactPCI chassis, there can be only one BMC present. The BMC
administrates the SEL and the SDRR for the complete system. The BMC is connected
to the other boards in the shelf via a dedicated bus (IPMB-0). The CP6004-SA/-RA/-
RC/CP6004X-SA’s IPMI controller can be configured to operate in SMC mode or in
BMC mode via an IPMI OEM command or an uEFI Shell command. The factory
setting is SMC.
BSP Board Support Package
FRU Field Replaceable Unit
Every board is a FRU. The FRU data contains information about the board such as
the part number and the serial number. See PICMG Specification 2.9 for complete
details on the FRU data structure. The free Linux tool “ipmitool” can be used to
update or display the FRU data.
FWH Firmware Hub memory location where a complete uEFI BIOS code is stored.
I2CInter-Integrated Circuit
IPMB Intelligent Platform Management Bus
The dedicated I2C management bus where the BMC and the SMCs communicate.
IPMB-0 Intelligent Platform Management Bus which connects all SMCs with the BMC or the
shelf manager.
IPMI Intelligent Platform Management Interface
IOL IPMI over LAN. An IPMI controller is accessed via LAN, not IPMB.
KCS Keyboard Controller Style (Interface)
This is the IPMI mandatory interface on the host system (payload) to communicate
with the BMC.
MP Management Power
This powers the BMC or the SMC controller.
PICMG PCI Industrial Computer Manufacturer Group

IPMI Firmware CP6004-SA/-RA/-RC/CP6004X-SA
Page 10 ID 1053-0139, Rev. 3.0
D R A F T — F O R I N T E R N A L U S E O N L Y
PWR Payload Power
This powers the host side of the board where the application software runs. It is
granted by the BMC or the SMC after all prerequisites are met. Prerequisites can be,
for example, a closed handle switch, power on the backplane, etc.
SDR Sensor Data Record
This is the IPMI data structure that defines a sensor.
SDRR Sensor Data Record Repository
The SDRR is located in the BMC and contains all SDRs of the chassis’ boards that
are administrated. A free Linux utility named “ipmitool” makes a full chassis discovery
and fills the SDRR with the SDRs being found.
SEL System Event Log
The SEL is located in the BMC and keeps track of all events in the chassis. If an
event occurs on any board, the sensor event is sent through the IPMB bus to the
BMC, which additionally stores its own events as well.
SMBIOS System Management BIOS
SMC Satellite Management Controller
Each board is equipped with an IPMI controller acting either as a BMC or as an SMC.
In a CompactPCI chassis, there can be several SMCs. The SMC administrates the
sensor and FRU data of the CP6004-SA/-RA/-RC/CP6004X-SA and makes it avail-
able to the BMC. Each SMC can be connected to the BMC via a dedicated bus (IPMB-
0). The CP6004-SA/-RA/-RC/CP6004X-SA’s IPMI controller can be configured to
operate in SMC mode or in BMC mode via an IPMI OEM command or an uEFI Shell
command. The factory setting is SMC.
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.
Table 1: Terminology and Acronym Definitions (Continued)
TERM or ACRONYM DESCRIPTION