Emerson ATCA-7350 User Manual

ATCA-7350 Control via IPMI

Programmer’s Reference
6806800H29E
August 2011
©
2011 Emerson
All rights reserved.
Emerson is a trademark registered in the U.S. Patent and Trademark Office. All other product or service names are the property of their respective owners.
®
Intel
is a trademark or registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.
and all other Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other
Java countries.
Microsoft Microsoft Corporation.
PICMG PCI Industrial Computer Manufacturers Group.
UNIX
®
, Windows® and Windows Me® are registered trademarks of Microsoft Corporation; and Windows XP™ is a trademark of
®
, CompactPCI®, AdvancedTCA™ and the PICMG, CompactPCI and AdvancedTCA logos are registered trademarks of the
®
is a registered trademark of The Open Group in the United States and other countries.
Notice
While reasonable efforts have been made to assure the accuracy of this document, Emerson assumes no liability resulting from any omissions in this document, or from the use of the information obtained therein. Emerson reserves the right to revise this document and to make changes from time to time in the content hereof without obligation of Emerson to notify any person of such revision or changes.
Electronic versions of this material may be read online, downloaded for personal use, or referenced in another document as a URL to an Emerson website. The text itself may not be published commercially in print or electronic form, edited, translated, or otherwise altered without the permission of Emerson,
It is possible that this publication may contain reference to or information about Emerson products (machines and programs), programming, or services that are not available in your country. Such references or information must not be construed to mean that Emerson intends to announce such Emerson products, programming, or services in your country.
Limited and Restricted Rights Legend
If the documentation contained herein is supplied, directly or indirectly, to the U.S. Government, the following notice shall apply unless otherwise agreed to in writing by Emerson.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (b)(3) of the Rights in Technical Data clause at DFARS 252.227-7013 (Nov. 1995) and of the Rights in Noncommercial Computer Software and Documentation clause at DFARS 252.227-7014 (Jun. 1995).
Contact Address
Emerson Network Power - Embedded Computing GmbH
Lilienthalstr. 15
85579 Neubiberg-Munich/Germany

Contents

About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.2 Feature Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.2.1 HPM.1 Specific Firmware Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.2.1.1 IPMC Firmware Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.2.1.2 BIOS Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.2.1.3 FPGA Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.2.2 Serial over LAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2.3 Sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2.4 MAC Address Record. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2.5 Asynchronous Event Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2.6 Graceful Shutdown Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2.7 Local System Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.2.8 External Watchdog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.2.9 Boot Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2 Supported Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.1 Standard IPMI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.1.1 Global IPMI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.1.2 System Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.1.3 Watchdog Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.1.4 SEL Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.1.5 FRU Inventory Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.1.6 Sensor Device Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.1.7 Chassis Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.1.7.1 System Boot Options Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.1.8 LAN Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.2 PICMG 3.0 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.3 Emerson Specific Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.3.1 Serial Output Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
2.3.1.1 Set Serial Output Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.3.1.2 Get Serial Output Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3 FRU Information and Sensor Data Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.1 FRU Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.2 MAC Address Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
3
Contents
3.3 Sensor Data Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4 SOL Module Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.2 Configure the SOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.3 Enable SOL Load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
4.4 Setup SOL Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.5 Query the Configuration of SOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.6 Configure the SOL Module in OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
A Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
A.1 Emerson Network Power - Embedded Computing Documents . . . . . . . . . . . . . . . . . . . . . . . 59
A.2 Related Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)

List of Tables

Table 1-1 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Table 1-2 Sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Table 2-1 Supported Global IPMI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Table 2-2 Supported System Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Table 2-3 Supported Watchdog Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Table 2-4 Supported SEL Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Table 2-5 Supported FRU Inventory Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Table 2-6 Supported Sensor Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Table 2-7 Supported Chassis Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Table 2-8 Configurable System Boot Option Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Table 2-9 System Boot Options Parameter #5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Table 2-10 System Boot Options Parameter #96 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Table 2-11 System Boot Options Parameter #98 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Table 2-12 System Boot Options Parameter #99 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Table 2-13 Supported LAN Device Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Table 2-14 Supported PICMG 3.0 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Table 2-15 Serial Output Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Table 2-16 Request Data of Set Serial Output Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Table 2-17 Response Data of Set Serial Output Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Table 2-18 Request Data of Get Serial Output Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Table 2-19 Response Data of Get Serial Output Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Table 3-1 FRU Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Table 3-2 Emerson MAC Address Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Table 3-3 Emerson MAC Address Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Table 3-4 Interface Type Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Table 3-5 IPMI Sensors Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Table 3-6 +12VCC Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Table 3-7 +3.3VCC Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Table 3-8 +3.3VSB Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Table 3-9 +5VCC Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Table 3-10 +5VSB Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Table 3-11 -48V Power1 Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Table 3-12 -48V Power2 Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Table 3-13 ACPI State Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Table 3-14 BIOS Bank Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Table 3-15 BMC POST ERROR Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Table 3-16 Boot Errors Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Table 3-17 CPU0 Core Rem Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Table 3-18 CPU0 Status Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Table 3-19 CPU1 Core Rem Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
5
List of Tables
Table 3-20 CPU1 Status Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Table 3-21 CPU Inlet Temp Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Table 3-22 FBD Inlet Temp Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Table 3-23 FRU Hot Swap Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Table 3-24 FW Progress Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Table 3-25 Handle State Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Table 3-26 HD Env Temp Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Table 3-27 IPMB Link State Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Table 3-28 Log Disabled Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Table 3-29 PwrOk Sig. Drop Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Table 3-30 RTM Handle Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Table 3-31 RTM HS Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Table 3-32 SYSTEM RESTART Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Table 3-33 Ver Change Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Table 3-34 Watchdog Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Table A-1 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Table A-2 Related Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
6
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)

About this Manual

Overview of Contents

This manual is intended for users qualified in electronics or electrical engineering. Users must have a working understanding of Intelligent Platform Management Interface (IPMI).
It provides information on how to control and monitor the functionality of the ATCA-7350 via IPMI and contains the following chapters and appendices:
z Chapter 1, Introduction, on page 11 describes the main features of the IPMC firmware.
z Chapter 2, Supported Commands, on page 15 lists all the IPMI1.5 and IPMI2.0 standard
commands supported by the ATCA-7350.
z Chapter 3, FRU Information and Sensor Data Records, on page 27 provides the FRU
information and all the sensor data records.
z Chapter 4, SOL Module Configuration, on page 53 describes how to configure the Serial
over LAN.
z Appendix A, Related Documentation, on page 59 provides links to further ATCA-7350-
related documentation.

Abbreviations

This document uses the following abbreviations:
Abbreviation Definition
ACPI Advanced Configuration and Power Interface
ATCA Advanced Telecom Computing Architecture
BIOS Basic Input/Output System
CMD IPMI Command Specified in Hexadecimal
CPU Central Processing Unit
FBD Fully Buffered DIMM
FPGA Field-Programmable Gate Array
FRU Field Replaceable Unit
FW Firmware
GA General Availability
GUID Global Unique Identifier
HD Hard Disk
IANA Internet Assigned Numbers Authority
IPMB Intelligent Platform Management Bus
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
7
About this Manual
Abbreviation Definition
IPMC Intelligent Platform Management Controller
IPMI Intelligent Platform Management Interface
LAN Local Area Network
LED Light Emitting Diode
LSB Least Significant Bit
LUN Logical Units
MAC Media Access Control
MSB Most Significant Bit
NetFn IPMI Network Function in Hexadecimal
OEM Original Equipment Manufacturer
PICMG PCI Industrial Computer Manufacturers Group
PwrOk Power OK
RTM Rear-Transition Modules
SDR Sensor Data Records
SEL System Event Log
SOL Serial Over LAN
VCC Virtual Channel Connection
VER Version

Conventions

The following table describes the conventions used throughout this manual.
Notation Description
0x00000000 Typical notation for hexadecimal numbers (digits are 0
0b0000 Same for binary numbers (digits are 0 and 1)
bold Used to emphasize a word Screen Used for on-screen output and code related elements or
Courier + Bold Used to characterize user input and to separate it from
Reference Used for references and for table and figure descriptions
File > Exit Notation for selecting a submenu
through F), for example used for addresses and offsets
commands in body text
system output
<text> Notation for variables and keys
[text] Notation for software buttons to click on the screen and
parameter description
... Repeated item for example node 1, node 2, ..., node 12
8
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
About this Manual
Notation Description
. . .
.. Ranges, for example: 0..4 means one of the integers
| Logical OR
Omission of information from example/command that is not necessary at the time being
0,1,2,3, and 4 (used in registers)
Indicates a hazardous situation which, if not avoided, could result in death or serious injury
Indicates a hazardous situation which, if not avoided, may result in minor or moderate injury
Indicates a property damage message

Summary of Changes

This manual has been revised and replaces all prior editions.
Part Number Publication Date Description
6806800H29A December 2008 First edition
6806800H29B January 2009 Second edition
6806800H29C January 2009 Third edition
6806800H29D February 2009 Fourth edition
6806800H29E August 2011 Added Table 3-30 on page 47 and Ta b le

Comments and Suggestions

No danger encountered. Pay attention to important information
3-31 on page 48.
We welcome and appreciate your comments on our documentation. We want to know what you think about our manuals and how we can make them better.
Mail comments to us by filling out the following online form:
http://www.emersonnetworkpowerembeddedcomputing.com/ > Contact Us > Online Form
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
9
About this Manual
In "Area of Interest" select "Technical Documentation". Be sure to include the title, part number, and revision of the manual and tell us how you used it.
10
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)

Introduction

1.1 Overview

The ATCA-7350 provides an intelligent hardware management system as defined in the AdvancedTCA Base Specification (PICMG 3.0; AMC.0). This system implements an Intelligent Peripheral Management Controller (IPMC) based on the proprietary H8S reference design from American Megatrends Inc.
The ATCA-7350 IPMC supports all standard Intelligent Peripheral Management Interface (IPMI) commands and provides hardware interfaces for other system managements features such as hot-swap control, LED control, power control and temperature and voltage monitoring. The IPMC also supports a Keyboard Controller Style (KCS) based host interface for payload-to-IPMI communication.
1
In addition, the following features are included:
Table 1-1 Features
Feature Further Details...
Supported for fault tolerant field upgrade Support for field updates of firmware via the payload
processor interface
Serial over LAN (SOL) Serial over LAN on page 13
Sensor management including, among others, power good and boot bank supervision sensor
FRU inventory with MAC address record MAC Address Record on page 13
Asynchronous event notification Asynchronous Event Notification on page 13
Graceful shutdown timeout Graceful Shutdown Timeout on page 13
Local system event log (SEL) Local System Event Log on page 14
External watchdog External Watchdog on page 14
BIOS boot configuration via IPMI Boot Configuration Parameters on page 14
IPMC Firmware Upgrade on page 12
Sensors on page 13
Chassis Device Commands on page 18

1.2 Feature Description

Besides its basic functions, the ATCA-7350 provides the features described in this section.

1.2.1 HPM.1 Specific Firmware Upgrades

ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
11
Introduction HPM.1 Specific Firmware Upgrades
1.2.1.1 IPMC Firmware Upgrade
The IPMC firmware basically consists of five major parts:
z Boot loader
z Active and Backup IPMI firmware
z Active and Backup SDR data
The boot loader maintains redundant copies of the firmware in the flash memory of the ATCA-
7350. Each time the IPMC firmware is upgraded, the most recent firmware version is kept in flash memory and the older firmware version is overwritten by the new one. Once the new IPMI firmware is programmed, the IPMC resets itself to boot from the new image. The boot loader validates the new IPMC firmware. Provided the IPMC can power up successfully the current image is made active and the previously active image is made backup. In case of power-up failures, the boot loader automatically recovers from crisis and boots from the previous image.
The IPMC can be upgraded via KCS and IPMB interface. To ensure that the payload is not interrupted during IPMC firmware upgrade, the IPMC is storing all operational information (E­keying, SOL parameters, hot-swap state, last events to be queued, graceful shutdown timeout, latest pin settings…) in non-volatile storage.
The IPMC firmware is fully HPM.1 compliant. Thus in general also open source tools like ipmitool can be used for IPMC firmware upgrade. However, we recommend to use the firmware upgrade tools provided by Emerson (fcu, fuf, or ipmi_upd.sh). To obtain these tools contact your local sales representative.
The SDR data is hold as a separate component which can be upgraded separately. The IPMC holds an active and a backup component.
1.2.1.2 BIOS Upgrade
BIOS can either be upgraded via flash based tools provided from Emerson, or via IPMI with the use of HPM.1 specific protocols. The BIOS firmware is fully implemented as HPM.1 specific components with an active and an backup image. BIOS upgrade via IPMI is intended to be used for crisis recovery only. This is because it is much more time consuming than using flash based routines. Be aware that even when no BIOS boot bank is programmed at all (no boot loader) crisis recovery via IPMI is always possible.
1.2.1.3 FPGA Upgrade
The FPGA can be upgraded via IPMI also. The IPMC controls an active component and a backup component for crisis recovery.
12
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
Serial over LAN Introduction

1.2.2 Serial over LAN

Serial over LAN (SOL) is an IPMI v.2.0 defined capability that allows to establish a virtual serial console connection with the payload over LAN. The serial data of the payload is transferred to the IPMC. The IPMC generates RMCP+ packets, which are routed to the ethernet controller of the base interfaces. Be aware that SOL/LAN configuration is only possible if the Ethernet controller and its payload is fully powered, otherwise the completion code 0xD5 is returned. For more information on how to use and configure SOL see Chapter 4, SOL Module Configuration,
on page 53.

1.2.3 Sensors

Apart from several voltage and temperature specific sensors (for details refer to Sensor Data
Records on page 29), the IPMC provides the following additional sensors:
Table 1-2 Sensors
Sensor Description
Firmware Progress, and Boot Error Sensor
The IPMC firmware provides Firmware Progress (Table 3-24 on page
43), and Boot Error (Table 3-16 on page 37) sensors to enable
payload firmware and payload OS to report boot progress and OS Boot via IPMI event messages.

1.2.4 MAC Address Record

The ATCA-7350 implements an MAC address FRU OEM record. You can retrieve all MAC addresses of the blade from the FRU information. For more details refer to MAC Address
Record on page 27.

1.2.5 Asynchronous Event Notification

To enable payload applications to be informed about graceful shutdown/reboot requests, the FRU Activate (Deactivate) and FRU Control (Graceful Reboot) command message is routed as a LUN2 message to the payload interface.
If the payload application has registered to these commands via the OpenIPMI library, it gets informed and can take all necessary actions before the payload is gracefully rebooted or shut­down.

1.2.6 Graceful Shutdown Timeout

The IPMI command Set System Boot Options together with the parameter #98 can be used to persistently specify the timeout for Graceful Shutdown. For more information refer to Chassis
Device Commands on page 18.
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
13
Introduction Local System Event Log

1.2.7 Local System Event Log

The IPMC provides a local system event log (SEL). Thus, event information is stored on-board the ATCA-7350 as well.

1.2.8 External Watchdog

For crisis recovery purposes the IPMI building block provides an external hardware watchdog. The IPMI firmware is reset if it does not trigger the watchdog anymore.

1.2.9 Boot Configuration Parameters

The IPMC supports BIOS boot order selection via IPMI partially. Be aware, that in case of the BIOS boot order is selected via IPMI the boot order displayed in the BIOS menu doesn't reflect the boot order selected via IPMI. For more information how to set the boot order via IPMI refer to System Boot Option Commands, parameter #5.
14
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)

Supported Commands

2.1 Standard IPMI Commands

The IPMC is fully compliant to the Intelligent Platform Management Interface v.1.5. This section provides information about the supported IPMI commands.

2.1.1 Global IPMI Commands

The IPMC supports the following global IPMI commands.
Table 2-1 Supported Global IPMI Commands
Command NetFn (Request/Response) CMD Comments
Get Device ID 0x06/0x07 0x01 -
2
Cold Reset 0x06/0x07 0x02 -
Warm Reset 0x06/0x07 0x03 -
Get Self Test Results 0x06/0x07 0x04 -
Get Device GUID 0x06/0x07 0x08 -

2.1.2 System Interface Commands

The system interface commands are supported by blades providing a system interface.
Table 2-2 Supported System Interface Commands
Command NetFn (Request/Response) CMD
Set BMC Global Enables 0x06/0x07 0x2E
Get BMC Global Enables 0x06/0x07 0x2F
Clear Message Flags 0x06/0x07 0x30
Get Message Flags 0x06/0x07 0x31
Get Message 0x06/0x07 0x33
Send Message 0x06/0x07 0x34
Set Channel Access 0x06/0x07 0x40
Get Channel Access 0x06/0x07 0x41
Get Channel Info 0x06/0x07 0x42
Set User Access 0x06/0x07 0x43
Get User Access 0x06/0x07 0x44
Set User Name 0x06/0x07 0x45
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
15
Supported Commands Watchdog Commands
Table 2-2 Supported System Interface Commands (continued)
Command NetFn (Request/Response) CMD
Get User Name 0x06/0x07 0x46
Set User Password 0x06/0x07 0x47
Set User Payload Access 0x06/0x07 0x4C
Get User Payload Access 0x06/0x07 0x4D
Set Channel Security Keys 0x06/0x07 0x5C

2.1.3 Watchdog Commands

The watchdog commands are supported by blades providing a system interface and a watchdog type 2 sensor.
The pre-timeout option is not supported.
Table 2-3 Supported Watchdog Commands
Command NetFn (Request/Response) CMD
Reset Watchdog Timer 0x06/0x07 0x22
Set Watchdog Timer 0x06/0x07 0x24
Get Watchdog Timer 0x06/0x07 0x25

2.1.4 SEL Device Commands

Table 2-4 Supported SEL Device Commands
Command NetFn (Request/Response) CMD
Get SEL Info 0x0A/0x0B 0x40
Reserve SEL 0x0A/0x0B 0x42
Get SEL Entry 0x0A/0x0B 0x43
Add SEL Entry 0x0A/0x0B 0x44
Clear SEL 0x0A/0x0B 0x47
Get SEL Time 0x0A/0x0B 0x48
Set SEL Time 0x0A/0x0B 0x49
16
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
FRU Inventory Commands Supported Commands

2.1.5 FRU Inventory Commands

Table 2-5 Supported FRU Inventory Commands
Command NetFn (Request/Response) CMD
Get FRU Inventory Area Info 0x0A/0x0B 0x10
Read FRU Data 0x0A/0x0B 0x11
Write FRU Data 0x0A/0x0B 0x12

2.1.6 Sensor Device Commands

Table 2-6 Supported Sensor Device Commands
NetFn
Command
(Request/Response) CMD Comments
Get Device SDR Info 0x04/0x05 0x20 -
Get Device SDR 0x04/0x05 0x21 -
Reserve Device SDR Repository 0x04/0x05 0x22 -
Get Sensor Reading Factors 0x04/0x05 0x23 -
Set Sensor Hysteresis 0x04/0x05 0x24 -
Get Sensor Hysteresis 0x04/0x05 0x25 -
Set Sensor Threshold 0x04/0x05 0x26 -
Get Sensor Threshold 0x04/0x05 0x27 -
Set Sensor Event Enable 0x04/0x05 0x28 -
Get Sensor Event Enable 0x04/0x05 0x29 -
Get Sensor Event Status 0x04/0x05 0x2B -
Get Sensor Reading 0x04/0x05 0x2D -
Get Sensor Type 0x04/0x05 0x2F -
Set Event Receiver 0x04/0x05 0x00 -
Get Event Receiver 0x04/0x05 0x01 -
Platform Event 0x04/0x05 0x02 -
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
17
Supported Commands Chassis Device Commands

2.1.7 Chassis Device Commands

Table 2-7 Supported Chassis Device Commands
Command NetFn (Request/Response) CMD
Set System Boot Options 0x00/0x01 0x08
Get System Boot Options 0x00/0x01 0x09
2.1.7.1 System Boot Options Commands
The IPMI system boot options commands allow you to control the boot process of a blade by sending boot parameters to the blade’s boot firmware (for example BIOS, U-Boot or VxWorks). The boot firmware interprets the sent boot parameters and executes the boot process accordingly. Each boot parameter addresses a particular functionality and consists of a sequence of one or more bytes. The IPMI specification assigns numbers to boot parameters. Boot parameters 0 to 7 are standard parameters whose structure and functionality is defined by the IPMI specification. The boot parameters 96 to 127 are OEM-specific which can be used for different purposes.
The following table lists which boot properties can be configured and the corresponding boot parameter number.
Table 2-8 Configurable System Boot Option Parameters
Configurable Boot Property Corresponding Boot Parameter Number
Boot flags 5
Selection between default and backup boot flash as device to boot from
Selection between default and backup EEPROM as device where the on-board FPGA loads its configuration stream from
Timeout for graceful shutdown 98
Write Protection for BIOS boot banks and FRU information
96
99
18
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
Loading...
+ 42 hidden pages