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
, 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).
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:
zChapter 1, Introduction, on page 11 describes the main features of the IPMC firmware.
zChapter 2, Supported Commands, on page 15 lists all the IPMI1.5 and IPMI2.0 standard
commands supported by the ATCA-7350.
zChapter 3, FRU Information and Sensor Data Records, on page 27 provides the FRU
information and all the sensor data records.
zChapter 4, SOL Module Configuration, on page 53 describes how to configure the Serial
over LAN.
zAppendix A, Related Documentation, on page 59 provides links to further ATCA-7350-
related documentation.
Abbreviations
This document uses the following abbreviations:
AbbreviationDefinition
ACPIAdvanced Configuration and Power Interface
ATCAAdvanced Telecom Computing Architecture
BIOSBasic Input/Output System
CMDIPMI Command Specified in Hexadecimal
CPUCentral Processing Unit
FBDFully Buffered DIMM
FPGAField-Programmable Gate Array
FRUField Replaceable Unit
FWFirmware
GAGeneral Availability
GUIDGlobal Unique Identifier
HDHard Disk
IANAInternet Assigned Numbers Authority
IPMBIntelligent Platform Management Bus
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
7
About this Manual
AbbreviationDefinition
IPMCIntelligent Platform Management Controller
IPMIIntelligent Platform Management Interface
LANLocal Area Network
LEDLight Emitting Diode
LSBLeast Significant Bit
LUNLogical Units
MACMedia Access Control
MSBMost Significant Bit
NetFnIPMI Network Function in Hexadecimal
OEMOriginal Equipment Manufacturer
PICMGPCI Industrial Computer Manufacturers Group
PwrOkPower OK
RTMRear-Transition Modules
SDRSensor Data Records
SELSystem Event Log
SOLSerial Over LAN
VCCVirtual Channel Connection
VERVersion
Conventions
The following table describes the conventions used throughout this manual.
NotationDescription
0x00000000Typical notation for hexadecimal numbers (digits are 0
0b0000Same for binary numbers (digits are 0 and 1)
boldUsed to emphasize a word
ScreenUsed for on-screen output and code related elements or
Courier + BoldUsed to characterize user input and to separate it from
ReferenceUsed for references and for table and figure descriptions
File > ExitNotation 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
NotationDescription
.
.
.
..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 NumberPublication DateDescription
6806800H29ADecember 2008First edition
6806800H29BJanuary 2009Second edition
6806800H29CJanuary 2009Third edition
6806800H29DFebruary 2009Fourth edition
6806800H29EAugust 2011Added 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.1Overview
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
FeatureFurther Details...
Supported for fault tolerant field upgrade
Support for field updates of firmware via the payload
processor interface
Serial over LAN (SOL)Serial over LANon page 13
Sensor management including, among others, power
good and boot bank supervision sensor
FRU inventory with MAC address recordMAC Address Recordon page 13
Local system event log (SEL)Local System Event Logon page 14
External watchdogExternal Watchdogon page 14
BIOS boot configuration via IPMIBoot Configuration Parameterson page 14
IPMC Firmware Upgrade on page 12
Sensors on page 13
Chassis Device Commands on page 18
1.2Feature Description
Besides its basic functions, the ATCA-7350 provides the features described in this section.
1.2.1HPM.1 Specific Firmware Upgrades
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
11
IntroductionHPM.1 Specific Firmware Upgrades
1.2.1.1IPMC Firmware Upgrade
The IPMC firmware basically consists of five major parts:
zBoot loader
zActive and Backup IPMI firmware
zActive 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 (Ekeying, 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.2BIOS 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.3FPGA 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 LANIntroduction
1.2.2Serial 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.3Sensors
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.4MAC 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.5Asynchronous 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 shutdown.
1.2.6Graceful 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
IntroductionLocal System Event Log
1.2.7Local 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.8External 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.9Boot 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.1Standard 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.1Global IPMI Commands
The IPMC supports the following global IPMI commands.
Table 2-1 Supported Global IPMI Commands
CommandNetFn (Request/Response) CMDComments
Get Device ID0x06/0x070x01-
2
Cold Reset0x06/0x070x02-
Warm Reset0x06/0x070x03-
Get Self Test Results0x06/0x070x04-
Get Device GUID0x06/0x070x08-
2.1.2System Interface Commands
The system interface commands are supported by blades providing a system interface.
Table 2-2 Supported System Interface Commands
CommandNetFn (Request/Response)CMD
Set BMC Global Enables0x06/0x070x2E
Get BMC Global Enables0x06/0x070x2F
Clear Message Flags0x06/0x070x30
Get Message Flags0x06/0x070x31
Get Message0x06/0x070x33
Send Message0x06/0x070x34
Set Channel Access0x06/0x070x40
Get Channel Access0x06/0x070x41
Get Channel Info 0x06/0x070x42
Set User Access 0x06/0x070x43
Get User Access 0x06/0x070x44
Set User Name0x06/0x070x45
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
15
Supported CommandsWatchdog Commands
Table 2-2 Supported System Interface Commands (continued)
CommandNetFn (Request/Response)CMD
Get User Name 0x06/0x070x46
Set User Password 0x06/0x070x47
Set User Payload Access0x06/0x070x4C
Get User Payload Access0x06/0x070x4D
Set Channel Security Keys0x06/0x070x5C
2.1.3Watchdog 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
CommandNetFn (Request/Response) CMD
Reset Watchdog Timer0x06/0x070x22
Set Watchdog Timer0x06/0x070x24
Get Watchdog Timer0x06/0x070x25
2.1.4SEL Device Commands
Table 2-4 Supported SEL Device Commands
CommandNetFn (Request/Response)CMD
Get SEL Info0x0A/0x0B0x40
Reserve SEL0x0A/0x0B0x42
Get SEL Entry0x0A/0x0B0x43
Add SEL Entry0x0A/0x0B0x44
Clear SEL0x0A/0x0B0x47
Get SEL Time0x0A/0x0B0x48
Set SEL Time0x0A/0x0B0x49
16
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
FRU Inventory CommandsSupported Commands
2.1.5FRU Inventory Commands
Table 2-5 Supported FRU Inventory Commands
CommandNetFn (Request/Response) CMD
Get FRU Inventory Area Info0x0A/0x0B0x10
Read FRU Data0x0A/0x0B0x11
Write FRU Data0x0A/0x0B0x12
2.1.6Sensor Device Commands
Table 2-6 Supported Sensor Device Commands
NetFn
Command
(Request/Response) CMDComments
Get Device SDR Info0x04/0x050x20-
Get Device SDR0x04/0x050x21-
Reserve Device SDR Repository0x04/0x050x22-
Get Sensor Reading Factors0x04/0x050x23-
Set Sensor Hysteresis0x04/0x050x24-
Get Sensor Hysteresis0x04/0x050x25-
Set Sensor Threshold0x04/0x050x26-
Get Sensor Threshold0x04/0x050x27-
Set Sensor Event Enable0x04/0x050x28-
Get Sensor Event Enable0x04/0x050x29-
Get Sensor Event Status0x04/0x050x2B-
Get Sensor Reading0x04/0x050x2D-
Get Sensor Type0x04/0x050x2F-
Set Event Receiver0x04/0x050x00-
Get Event Receiver0x04/0x050x01-
Platform Event0x04/0x050x02-
ATCA-7350 Control via IPMI Programmer’s Reference (6806800H29E)
17
Supported CommandsChassis Device Commands
2.1.7Chassis Device Commands
Table 2-7 Supported Chassis Device Commands
CommandNetFn (Request/Response) CMD
Set System Boot Options0x00/0x010x08
Get System Boot Options0x00/0x010x09
2.1.7.1System 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 PropertyCorresponding Boot Parameter Number
Boot flags5
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 shutdown98
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
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.