第1页 / 共644页
第2页 / 共644页
第3页 / 共644页
第4页 / 共644页
第5页 / 共644页
第6页 / 共644页
第7页 / 共644页
第8页 / 共644页
IPMI2_0E4_Markup_061209.pdf
Introduction
Audience
Reference Documents
Conventions and Terminology
Background - Architectural Goals
New for IPMI v1.5
New for IPMI v2.0
IPMI Overview
Intelligent Platform Management
IPMI Relationship to other Management Standards
Management Controllers and the IPMB
IPMI Messaging
Sensor Model
System Event Log and Event Messages
Sensor Data Records & Capabilities Commands
Initialization Agent
Sensor Data Record Repository
Private Management Busses
FRU Information
FRU Devices
Entity Association Records
Linkage between Events and FRU Information
Differentiation and Feature Extensibility
System Interfaces
Other Messaging Interfaces
Serial/Modem Interface
LAN Interface
1.7.19aPayloads
Serial Over LAN (SOL)
IPMI and ASF
LAN Alerting
Serial/Modem Alerting and Paging
Platform Event Filtering (PEF)
Call Down Lists and Alert Policies
Channel Model, Authentication, Sessions, and Users
Standardized Watchdog Timer
Standardized POH Counter
Firmware Firewall
Command and Function Discovery
IPMI Hardware Components
Configuration Interfaces
IPMI and BIOS
System Management Software (SMS)
SMI Handler
Overview of Changes from IPMI v1.0
Logical Management Device Types
Baseboard Management Controller (BMC)
Required BMC Functions
General Mgmt. Satellite Controller Required Functions
Message Interface Description
Network Function Codes
Completion Codes
Completion Code Requirements
Response Field Truncation on non-zero Generic Completion Codes
Summary of Completion Code Use
Sensor Owner Identification
Software IDs (SWIDs)
Isolation from Message Content
IPMI Messaging Interfaces
Terminology
Channel Model
Channel Numbers
Channel Protocol Type
Channel Medium Type
Channel Access Modes
Logical Channels
Channel Privilege Levels
Users & Password Support
‘Anonymous Login’ Convention
Anonymous Login Status
System Interface Messaging
BMC Channels and Receive Message Queue
Event Message Buffer
System Interface Discovery and Multiple Interfaces
IPMI Sessions
Session-less Connections
Single-session Connections
Multi-session Connections
Per-Message and User Level Authentication Disables
Link Authentication
Summary of Connection Characteristics
Session Activation and IPMI Challenge-Response
Session Sequence Numbers
IPMI v1.5 Session Sequence Number Handling
Session Sequence Number Generation
IPMI v1.5 Inbound Session Sequence Number Tracking and Handling
IPMI v1.5 Out-of-order Packet Handling
IPMI v1.5 Outbound Session Sequence Number Tracking and Handling
IPMI v2.0 RMCP+ Session Sequence Number Handling
IPMI v2.0 RMCP+ Sliding Window
Session Inactivity Timeouts
Avoiding ‘Slot Stealing’
Additional Session Specifications and Characteristics
BMC Message Bridging
BMC LUN 10b Routing
Send Message Command From System Interface
Send Message Command with Response Tracking
Bridged Request Example
Message Size & Private Bus Transaction Size Requirements
IPMB Interface
IPMB Access via Master Write-Read command
BMC IPMB LUNs
Sending Messages to IPMB from System Software
Sending IPMB Messages to System Software
Testing for Event Message Buffer Support
ICMB Interface
Virtual ICMB Bridge Device
ICMB Bridge Commands in BMC using Channels
ICMB Bridging from System Interface to Remote IPMB using Channels
ICMB Bridging from Local IPMB to Remote IPMB using Channels
Keyboard Controller Style (KCS) Interface
KCS Interface/BMC LUNs
KCS Interface-BMC Request Message Format
BMC-KCS Interface Response Message Format
Logging Events from System Software via KCS Interface
KCS Interface Registers
KCS Interface Control Codes
Status Register
SMS_ATN Flag Usage
Command Register
Data Registers
KCS Control Codes
Performing KCS Interface Message Transfers
KCS Communication and Non-communication Interrupts
Physical Interrupt Line Sharing
Additional Specifications for the KCS interface
KCS Flow Diagrams
Write Processing Summary
Read Processing Summary
Error Processing Summary
Interrupting Messages in Progress
KCS Driver Design Recommendations
SMIC Interface
SMS Transfer Streams
SMIC Communication Register Overview
SMIC/BMC Message Interface Registers
Flags Register
Control/Status Register
Control and Status Codes
Data Register
Performing a single SMIC/BMC Transaction
Performing a SMIC/BMC Message Transfer
Interrupting Streams in Progress
Stream Switching
DATA_RDY Flag Handling
SMIC Control and Status Code Ranges
SMIC SMS Stream Control Codes
SMIC SMS Stream Status Codes
SMIC Messaging
SMIC/BMC LUNs
SMIC-BMC Request Message Format
BMC-SMIC Response Message Format
Logging Events from System Software via SMIC
Block Transfer (BT) Interface
BT Interface-BMC Request Message Format
BMC-BT Interface Response Message Format
Using the Seq Field
Response Expiration Handling
Logging Events from System Software via BT Interface
Host to BMC Interface
BT Host Interface Registers
BT BMC to Host Buffer (BMC2HOST)
BT Host to BMC Buffer (HOST2BMC)
BT Control Register (BT_CTRL)
BT Interrupt Mask Register (INTMASK)
Communication Protocol
Host and BMC Busy States
Host Command Power-On/Reset States
SMBus System Interface (SSIF)
Single Threaded Interface
Single-part Write
Multi-part Write
Error conditions for Multi-part Writes
Single-part Read Transaction
Multi-part Read Transactions
Retention of Output Data
SMBAlert Signal Handling
Enabling/disabling SSIF SMBAlert
Polling for output data
SMBus NACKs and Error Recovery
PEC Handling
SMBus Timeout and Hang Handling
Discovering SSIF
SSIF Support Requirements for IPMI v1.5-only BMCs
SSIF Support Requirements for IPMI v2.0 & Later BMCs
Summary of SMBus Commands Values for SSIF
SSIF IPMI Commands
SSIF Timing
IPMI LAN Interface
RMCP
ASF Messages in RMCP
RMCP Port Numbers
RMCP Message Format
Required ASF/RMCP Messages for IPMI-over-LAN
RMCP ACK Messages
RMCP ACK Handling
RMCP/ASF Presence Ping Message
RMCP/ASF Pong Message (Ping Response)
RMCP+
BMC Support Requirements for v1.5 and v2.0/RMCP+ Protocols
Session-less Command Support
IPMI Messages Encapsulation Under RMCP
RMCP/ASF and IPMI Byte Order
Example IPMI over LAN Packet
VLAN Support
IPMI LAN Message Format
LAN Alerting
IPMI LAN Configuration
IP and MAC Address Configuration
‘Teamed’ and Fail-over LAN Channels
ARP Handling and Gratuitous ARP
OS-Absent problems with ARP
Resolving ARP issues
BMC-generated ARPs
Retaining IP Addresses in a DHCP Environment
Resolving DHCP issues
Discovering Support For IPMI over IP Connections
IPMI v1.5 LAN Session Activation
IPMI v2.0/RMCP+ Session Activation
RMCP+ Session Termination
RMCP+ Open Session Request
RMCP+ Open Session Response
RAKP Messages
RAKP Message 1
RAKP Message 2
RAKP Message 3
RAKP Message 4
RMCP+ and RAKP Message Status Codes
Differences between v1.5 and v2.0/RMCP+ Sessions
IPMI v2.0 RMCP+ Payload Types
Payloads and Payload Type Numbers
IPMI Message Payloads and IPMI Commands
OEM Payload Type Handles
Payload Type Numbers
Authentication, Integrity, and Confidentiality Algorithm Numbers
RAKP-HMAC-SHA1 Authentication Algorithm
13.28.1b RAKP-HMAC-SHA256 Authentication Algorithm
RAKP-none Authentication Algorithm
RAKP-HMAC-MD5 Authentication Algorithm
Integrity Algorithms
Confidentiality (Encryption) Algorithms
AES-CBC-128 Encrypted Payload Format
Generating the Initialization Vector
Encryption with AES
CBC (Cipher Block Chaining)
xRC4 Encrypted Payload Format
Generating the xRC4 Initialization Vector
Initializing the xRC4 State Machines
RMCP+ Authenticated Key-Exchange Protocol (RAKP)
Generating Additional Keying Material
Setting User Passwords and Keys
Random Number Generation
Random Number Key
Random Number Generator Counters
Random Number Generator Operation
IPMI Serial/Modem Interface
Serial/Modem Capabilities
Connection Modes
PPP/UDP Proxy Operation
Asynchronous Communication Parameters
Serial Port Sharing
Serial Port Switching
Access Modes
Console Redirection with Serial Port Sharing
Detecting Who Answered The Phone
Connecting to the BMC
Connecting to the Console Redirection
Directing the Connection After Power Up / Reset
Interaction with Microsoft ‘Headless’ Operation
Pre-boot Only Mode
Always Available Mode
Shared Mode
Serial Port Sharing Access Characteristics
Serial Port Sharing Hardware Implementation Notes
Connection Mode Auto-detect
Modem-specific Options
Modem Activation
Serial/Modem Connection Active (Ping) Message
Serial/Modem Connection Active Message Parameters
Mux Switch Coordination
Receive During Ping
Application Handling of the Serial/Modem Connection Active Message
Basic Mode
Basic Mode Packet Framing
Data Byte Escaping
Message Fields
Message Retries
Packet Handshake
PPP/UDP Mode
PPP/UDP Mode Sessions
PPP Frame Format
PPP Frame Implementation Requirements
Link Control Protocol (LCP) packets
Configuration Requests
Maximum Receive Unit Handling
Protocol Field Compression Handling
Address & Control Field Compression Handling
IPMI/RMCP Message Format in PPP Frame
Example of IPMI Frame with Field Compression
Frame Data Encoding
Escaping Algorithm
Escaped Character Handling
Asynch Control Character Maps (ACCM)
IP Network Protocol Negotiation (IPCP)
CHAP Operation in PPP Mode
Serial/Modem Callback
Callback Control Protocol (CBCP) Support
CBCP Address Type and Dial String Characters
Terminal Mode
Terminal Mode Versus Basic Mode Differences
Terminal Mode Message Format
IPMI Message Data
Terminal Mode IPMI Message Bridging
Sending Messages to SMS
Sending Messages to Other Media
Terminal Mode Packet Handshake
Terminal Mode ASCII Text Commands
Terminal Mode Text Command and IPMI Message Examples
Terminal Mode Line Editing
Terminal Mode Input Restrictions
Page Blackout Interval
Dial Paging
Alert Strings for Dial Paging
Dialing Digits
Long Pause Character (control-L)
Empty (delimiter) Character (FFh)
‘Null’ Terminator Character (00h)
TAP Paging
TAP Escaping (data transparency)
TAP Checksum
TAP Response Codes
TAP Page Success Criteria
PPP Alerting
Serial Over LAN
System Serial Controller Requirements
SOL and Serial Port Sharing
SOL Operation Overview
SOL Security
SOL Sequence Numbers
Flow Control
Bit Rate Handling
Volatile and Non-volatile SOL Configuration Parameters
SOL Payload Data Format
Activating SOL using RMCP+ Authentication
SOL Packet Acknowledge and Retries
SOL Interaction with Windows.NET Escape Sequences
SOL Payload Activated with Serial Port Sharing
Event Messages
Critical Events and System Event Log Restrictions
Event Receiver Handling of Event Messages
IPMB Seq Field use in Event Messages
Event Status, Event Conditions, and Present State
System Software use of Sensor Scanning bits & Entity Info
Re-arming
‘Global’ Re-arm
‘Platform Event Filtering (PEF)
Alert Policies
Deferred Alerts
PEF Postpone Timer
PEF Startup Delay
Last Processed Event Tracking
Event Processing When The SEL Is Full
PEF Actions
Event Filter Table
Event Data 1 Event Offset Mask
Using the Mask and Compare Fields
Mask and Compare Field Examples
Alert Policy Table
Alert Testing
Alert Processing
Alert Processing after Power Loss
Processing non-Alert Actions after Power Loss
Alert Processing when IPMI Messaging is in Progress
Sending Multiple Alerts On One Call
Serial/Modem Alert Processing
PEF and Alert Handling Example
Event Filter, Policy, Destination, and String Relationships
Populating a PET
OEM Custom Fields and Text Alert Strings for IPMI v1.5 PET
PEF Performance Target
Firmware Firewall & Command Discovery
Command Specification Information
Specification of Completion Codes
Handling ‘Reserved’ Bits and Fields
Logical Unit Numbers (LUNs) for Commands
Command Table Notation
IPM Device “Global” Commands
Get Device ID Command
Cold Reset Command
Warm Reset Command
Get Self Test Results Command
Manufacturing Test On Command
Set ACPI Power State Command
Get ACPI Power State Command
Get Device GUID Command
Broadcast ‘Get Device ID’
Firmware Firewall & Command Discovery Commands
Completion Codes with Firmware Firewall
Get NetFn Support Command
Get Command Support Command
Get Command Sub-function Support Command
Get Configurable Commands Command
Get Configurable Command Sub-functions Command
Set Command Enables Command
Get Command Enables Command
Set Configurable Command Sub-function Enables Command
Get Configurable Command Sub-function Enables Command
Get OEM NetFn IANA Support Command
IPMI Messaging Support Commands
Set BMC Global Enables Command
Get BMC Global Enables Command
Clear Message Flags Command
Get Message Flags Command
Enable Message Channel Receive Command
Get Message Command
Send Message Command
Read Event Message Buffer Command
Get System Interface Capabilities Command
Get BT Interface Capabilities Command
Master Write-Read Command
Session Header Fields
Get Channel Authentication Capabilities Command
Get System GUID Command
22.14a Set System Info Parameters Command
22.14b Get System Info Parameters Command
Get Channel Cipher Suites Command
Cipher Suite Records
Cipher Suite IDs
Get Session Challenge Command
Activate Session Command
AuthCode Algorithms
Set Session Privilege Level Command
Close Session Command
Get Session Info Command
Get AuthCode Command
Set Channel Access Command
Get Channel Access Command
Get Channel Info Command
Set Channel Security Keys Command
Set User Access Command
Get User Access Command
Set User Name Command
Get User Name Command
Set User Password Command
IPMI LAN Commands
Set LAN Configuration Parameters Command
Get LAN Configuration Parameters Command
Suspend BMC ARPs Command
Get IP/UDP/RMCP Statistics Command
RMCP+ Support and Payload Commands
Activate Payload Command
Deactivate Payload Command
Suspend/Resume Payload Encryption Command
Get Payload Activation Status Command
Get Payload Instance Info Command
Set User Payload Access Command
Get User Payload Access Command
Get Channel Payload Support Command
Get Channel Payload Version Command
Get Channel OEM Payload Info Command
IPMI Serial/Modem Commands
Set Serial/Modem Configuration Command
Get Serial/Modem Configuration Command
Set Serial/Modem Mux Command
Get TAP Response Codes Command
Set PPP UDP Proxy Transmit Data Command
Get PPP UDP Proxy Transmit Data Command
Send PPP UDP Proxy Packet Command
Get PPP UDP Proxy Receive Data Command
Serial/Modem Connection Active (Ping) Command
Callback Command
Set User Callback Options Command
Get User Callback Options Command
Set Serial Routing Mux Command
SOL Commands
SOL Activating Command
Set SOL Configuration Parameters Command
Get SOL Configuration Parameters Command
BMC Watchdog Timer Commands
Watchdog Timer Actions
Watchdog Timer Use Field and Expiration Flags
Using the Timer Use field and Expiration flags
Watchdog Timer Event Logging
Pre-timeout Interrupt
Pre-timeout Interrupt Support Detection
BIOS Support for Watchdog Timer
Reset Watchdog Timer Command
Set Watchdog Timer Command
Get Watchdog Timer Command
Chassis Commands
Get Chassis Capabilities Command
Get Chassis Status Command
Chassis Control Command
Chassis Reset Command
Chassis Identify Command
Set Front Panel Enables
Set Chassis Capabilities Command
Set Power Restore Policy Command
Set Power Cycle Interval
Remote Access Boot control
Get System Restart Cause Command
Set System Boot Options Command
Get System Boot Options Command
Get POH Counter Command
Event Commands
Set Event Receiver Command
Get Event Receiver Command
Platform Event Message Command
Event Request Message Fields
IPMB Event Message Formats
System Interface Event Request Message Format
Event Data Field Formats
PEF and Alerting Commands
Get PEF Capabilities Command
Arm PEF Postpone Timer Command
Set PEF Configuration Parameters Command
Get PEF Configuration Parameters Command
Set Last Processed Event ID Command
Get Last Processed Event ID Command
Alert Immediate Command
PET Acknowledge Command
System Event Log (SEL) Commands
SEL Device Commands
Get SEL Info Command
Get SEL Allocation Info Command
Reserve SEL Command
Reservation Restricted Commands
Reservation Cancellation
Get SEL Entry Command
Add SEL Entry Command
SEL Record Type Ranges
Partial Add SEL Entry Command
Delete SEL Entry Command
Clear SEL Command
Get SEL Time Command
Set SEL Time Command
Get SEL Time UTC Offset
Set SEL Time UTC Offset
Get Auxiliary Log Status Command
Set Auxiliary Log Status Command
SEL Record Formats
SEL Event Records
OEM SEL Record - Type C0h-DFh
OEM SEL Record - Type E0h-FFh
SDR Repository
SDR Repository Device
Modal and Non-modal SDR Repositories
Command Support while in SDR Repository Update Mode
Populating the SDR Repository
SDR Repository Updating
Discovering Management Controllers and Device SDRs
Reading the SDR Repository
Sensor Initialization Agent
System Support Requirements for the Initialization Agent
IPMI and ACPI Interaction
Recommended Initialization Agent Steps
SDR Repository Device Commands
SDR ‘Record IDs’
Get SDR Repository Info Command
Get SDR Repository Allocation Info Command
Reserve SDR Repository Command
Reservation Restricted Commands
Reservation Cancellation
Get SDR Command
Add SDR Command
Partial Add SDR Command
Delete SDR Command
Clear SDR Repository Command
Get SDR Repository Time Command
Set SDR Repository Time Command
Enter SDR Repository Update Mode Command
Exit SDR Repository Update Mode Command
Run Initialization Agent Command
FRU Inventory Device Commands
Get FRU Inventory Area Info Command
Read FRU Data Command
Write FRU Data Command
Sensor Device Commands
Static and Dynamic Sensor Devices
Get Device SDR Info Command
Get Device SDR Command
Reserve Device SDR Repository Command
Get Sensor Reading Factors Command
Set Sensor Hysteresis Command
Get Sensor Hysteresis Command
Set Sensor Thresholds Command
Get Sensor Thresholds Command
Set Sensor Event Enable Command
Get Sensor Event Enable Command
Re-arm Sensor Events Command
Get Sensor Event Status Command
Response According to Sensor Type
Hysteresis and Event Status
High-going versus Low-going Threshold Events
Get Sensor Event Status Command Format
Get Sensor Reading Command
Set Sensor Type Command
Get Sensor Type Command
Set Sensor Reading And Event Status Command
35b. Command Forwarding Commands
35b.1 Get Forwarded Commands Command
35b.2Set Forwarded Commands Command
35b.3Enable Forwarded Commands Command
35b.4Forwarded Command Command
Sensor Types and Data Conversion
Linear and Linearized Sensors
Non-Linear Sensors
Sensor Reading Conversion Formula
Resolution, Tolerance and Accuracy
Tolerance
Resolution
Resolution for Non-linear & Linearizable Sensors
Offset Constant Relationship to Resolution
Management Software, SDRs, and Sensor Display
Software Display of Threshold Settings
Notes on Displaying Sensor Readings & Thresholds
Timestamp Format
Special Timestamp values
Accessing FRU Devices
Using Entity IDs
System- and Device-relative Entity Instance Values
Restrictions on Using Device-relative Entity Instance Values
Sensor-to-FRU Association
Handling Sensor Associations
Entity Presence
Software detection of Entities
Using Entity Association Records
Sensor & Event Message Codes
Sensor Type Code
Event/Reading Type Code
SDR Specification of Event Types
SDR Specification of Reading Types
Use of Codes in Event Messages
Sensor and Event Code Tables
Event/Reading Type Codes
Sensor Type Codes and Data
Sensor Data Record Formats
SDR Type 01h, Full Sensor Record
SDR Type 02h, Compact Sensor Record
SDR Type 03h, Event-Only Record
SDR Type 08h - Entity Association Record
SDR Type 09h - Device-relative Entity Association Record
SDR Type 0Ah:0Fh - Reserved Records
SDR Type 10h - Generic Device Locator Record
SDR Type 11h - FRU Device Locator Record
SDR Type 12h - Management Controller Device Locator Record
SDR Type 13h - Management Controller Confirmation Record
SDR Type 14h - BMC Message Channel Info Record
SDR Type C0h - OEM Record
Device Type Codes
Entity IDs
Type/Length Byte Format
6-bit ASCII Packing Example
Sensor Unit Type Codes
Examples
Processor Sensor with Sensor-specific States & Event Generation
Processor Sensor with Generic States & Event Generation
Appendix A - Previous Sequence Number Tracking
Appendix B - Example PEF Mask Compare Algorithm
Appendix C1 - Locating IPMI System Interfaces via SM BIOS Tables
C1-1IPMI Device Information - BMC Interface
C1-1.1Interface Type
C1-1.2IPMI Specification Revision Field
C1-1.3I2C Slave Address Field
C1-1.4NV Storage Device Address Field
C1-1.5Base Address Field
C1-1.6Base Address Modifier Field
C1-1.7System Interface Register Alignment
C1-1.7.1Byte-spaced I/O Address Examples
C1-1.7.232-bit Spaced I/O Address Examples
C1-1.7.3Memory-mapped Base Address
C1-1.7.4Interrupt Info Field
C1-1.8Interrupt Number Field
Appendix C2 - Locating IPMI System Interfaces on PCI
Appendix C3 - Locating IPMI System Interfaces with ACPI
C3-1SPMI Description Table and ACPI Control Methods
C3-2Locating IPMI System Interfaces in ACPI Name Space
C3-3Example IPMI Definition ASL Code
Example 1: SMIC Interface in I/O Space
Example 2: KCS Interface in 64-bit Address Space
Example 3: SMIC Interface in I/O Space
Example 4: SSIF Interface
Appendix D - Determining Message Size Requirements
Appendix E - Terminal Mode Grammar
E-1Notation
E-2Grammar for Terminal Mode Input
E-3Grammar for Terminal Mode Output
Appendix F - TAP Flow Summary
Appendix G - Command Assignments
Appendix H - Sub-function Assignments
- IPMI -
Intelligent Platform Management
Interface Specification
Second Generation
v2.0
Document Revision 1.0
February 12, 2004
June 12, 2009 Markup
Intel Hewlett-Packard NEC Dell
Intelligent Platform Management Interface Specification
Date
9/16/98
8/26/99
2/21/01
2/20/02
9/12/03
9/26/03
1/27/04
See v1.5
spec
2/12/04
6/1/04
5/5/05
2/15/06
6/12/09
Ver
1.0
1.0
1.5
1.5
1.5
1.5
1.5
1.5
2.0
2.0
2.0
2.0
2.0
Rev
1.0
1.1
1.0
1.1
1.1
1.1
1.1
1.2
1.0
1.0
1.0
1.0
1.0
Revision History
Modifications
IPMI v1.0 Initial release
Errata Revision. Incorporated errata from revision 1 or the Errata and
Clarifications for the IPMI v1.0 specification.
IPMI v1.5 Initial release
Updated to include addenda and errata
Markup to include 9/12/03 addenda and errata
Markup updated to include missing optional 5th byte on Get Chassis Status
command, per errata E317
Markup updated per errata document version 5
IPMI 1.5 updated per errata document version 5
IPMI Second Generation document. Initial release.
Markup per IPMI v2.0/v1.5 errata document revision 1.
Markup per IPMI v2.0/v1.5 errata document revision 2.
Markup per IPMI v2.0/v1.5 errata document revision 3.
Markup per IPMI v2.0/v1.5 errata dcoument revision 4.
Copyright © 20042009 Intel Corporation, Hewlett-Packard Company, NEC
Corporation, Dell Inc., All rights reserved.
INTELLECTUAL PROPERTY DISCLAIMER
THIS SPECIFICATION IS PROVIDED “AS IS” WITH NO WARRANTIES WHATSOEVER INCLUDING ANY
WARRANTY OF MERCHANTABILITY, FITNESS FOR ANY PARTICULAR PURPOSE, OR ANY WARRANTY
OTHERWISE ARISING OUT OF ANY PROPOSAL, SPECIFICATION, OR SAMPLE.
NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY
RIGHTS IS GRANTED OR INTENDED HEREBY.
INTEL, HEWLETT-PACKARD, NEC, AND DELL DISCLAIM ALL LIABILITY, INCLUDING LIABILITY FOR
INFRINGEMENT OF PROPRIETARY RIGHTS, RELATING TO IMPLEMENTATION OF INFORMATION IN THIS
SPECIFICATION. INTEL, HEWLETT-PACKARD, NEC, AND DELL, DO NOT WARRANT OR REPRESENT THAT
SUCH IMPLEMENTATION(S) WILL NOT INFRINGE SUCH RIGHTS.
I2C is a trademark of Philips Semiconductors. All other product names are trademarks, registered trademarks, or servicemarks of
their respective owners.
I2C is a two-wire communications bus/protocol developed by Philips. IPMB is a subset of the I 2C bus/protocol and was
developed by Intel. Implementations of the I2C bus/protocol or the IPMB bus/protocol may require licenses from various
entities, including Philips Electronics N.V. and North American Philips Corporation.
Intel, Hewlett-Packard, NEC, and Dell retain the right to make changes to this document at any time, without notice. Intel,
Hewlett-Packard, NEC, and Dell make no warranty for the use of this document and assume no responsibility for any error which
may appear in the document nor does it make a commitment to update the information contain ed herein.
ii
Intelligent Platform Management Interface Specification
IPMI NON-DISCLOSURE AGREEMENT
DO NOT download these files (collectively, the “Confidential Information”) until you have carefully read the
following terms and conditions. By downloading the Confidential Information you agree to the terms of t his
Agreement. If you do not wish to so agree, do not download the Confidential Information.
1. Confidential Information. The confidential, proprietary and trade secret information being disclosed ("Confidential
Information"), is that information marked with a "confidential", "proprietary", or similar legend, and is described as:
Confidential Information: Intelligent Platform Management Interface Specification Second Generation (v2.0),
Intelligent Platform Management Bus Bridge Specification (v1.0), Intelligent Chassis Management Bus Bridge
Specification (v1.0)
CONFIDENTIAL INFORMATION IS PROVIDED SOLELY FOR YOUR INTERNAL EVALUATION AND
REVIEW TO DETERMINE WHETHER TO ADOPT THE SPECIFICATIONS BY SIGNING A SEPARATE
ADOPTER’S AGREEMENT. THE RECEIVING PARTY IS NOT LICENSED TO IMPLEMENT THE
SPECIFICATIONS UNLESS OR UNTIL AN ADOPTER’S AGREEMENT IS EXECUTED.
Disclosing party’s representatives for disclosing Confidential Information is: Fadi Zuhayri (fadi.zuhayri@intel.com)
2. Obligations of Receiving Party. The receiving party will maintain the confidentiality of the Confidential Information of
the disclosing party with at least the same degree of care that it uses to protect its own confidential and proprietary
information, but no less than a reasonable degree of care under the circumstances. The receiving party will not
disclose any of the disclosing party’s Confidential Information to employees or to any third parties except to the
receiving party’s employees, parent company and majority-owned subsidiaries who have a need to know and who
agree to abide by nondisclosure terms at least as comprehensive as those set forth herein; provided that the
receiving party will be liable for breach by any such entity. The receiving party will not make any copies of
Confidential Information received from the disclosing party except as necessary for its employees, parent company
and majority-owned subsidiaries with a need to know. Any copies which are made will be identified as belonging to
the disclosing party and marked "confidential", "proprietary" or with a similar legend.
3. Period of Non-Assertion. Unless a shorter period is indicated below, the disclosing party will not assert any claims
for breach of this Agreement or misappropriation of trade secrets against the receiving party arising out of the
receiving party’s disclosure of disclosing party’s Confidential Information made more than five (5) years from the
date of receipt of the Confidential Information by the receiving party. However, unless at least one of the exceptions
set forth in Section 4 below has occurred, the receiving party will continue to treat such Confidential Information as
the confidential information of the disclosing party and only disclose any such Confidential Information to third
parties under the terms of a non-disclosure agreement.
4. Termination of Obligation of Confidentiality. The receiving party will not be liable for the disclosure of any
Confidential Information which is: (a) rightfully in the public domain other than by a breach of this Agreement of a
duty to the disclosing party; (b) rightfully received from a third party without any obligation of confidentiality;
(c) rightfully known to the receiving party without any limitation on use or disclosure prior to its receipt from the
disclosing party; (d) independently developed by employees of the receiving party; or (e) generally made available to
third parties by the disclosing party without restriction on disclosure.
5. Title. Title or the right to possess Confidential Information as between the parties will remain in the disclosing party.
6. No Obligation of Disclosure; Termination The disclosing party may terminate this Agreement at any time without
cause upon written notice to the other party; provided that the receiving party’s obligations with respect to information
disclosed during the term of this Agreement will survive any such termination. The disclosing party may, at any time:
(a) cease giving Confidential Information to the other party without any liability, and/or (b) request in writing the
return or destruction of all or part of its Confidential Information previously disclosed, and all copies thereof, and the
receiving party will promptly comply with such request, and certify in writing its compliance.
7. General.
(a) This Agreement is neither intended to nor will it be construed as creating a joint venture, partnership or other
form of business association between the parties, nor an obligation to buy or sell products using or incorporating
the Confidential Information.
(b) No license under any patent, copyright, trade secret or other intellectual property right is granted to or conferred
upon either party in this Agreement or by the transfer of any information by one party to the other party as
contemplated hereunder, either expressly, by implication, inducement, estoppel or otherwise, and that any
license under any such intellectual property rights must be express and in writing.
(c) The failure of either party to enforce any right resulting from breach of any provision of this Agreement will not be
deemed a waiver of any right relating to a subsequent breach of such provision or of any other right hereunder.
(d) This Agreement will be governed by the laws of the State of Delaware without reference to conflict of laws
principles.
(e) This Agreement constitutes the entire agreement between the parties with respect to the disclosure(s) of
Confidential Information described herein, and may not be amended except in a writing signed by a duly
authorized representative of the respective parties. Any other agreements between the parties, including non-
disclosure agreements, will not be affected by this Agreement.
iii
Intelligent Platform Management Interface Specification
Table of Contents
1.
Introduction...........................................................................................................................................1
1.1 Audience..........................................................................................................................................................1
1.2 Reference Documents......................................................................................................................................2
1.3 Conventions and Terminology.........................................................................................................................5
1.4 Background - Architectural Goals ...................................................................................................................6
1.5 New for IPMI v1.5 ..........................................................................................................................................7
1.6 New for IPMI v2.0 ..........................................................................................................................................9
IPMI Overview..............................................................................................................................................11
1.7
1.7.1
Intelligent Platform Management ...........................................................................................................11
IPMI Relationship to other Management Standards...............................................................................11
1.7.2
1.7.3 Management Controllers and the IPMB .................................................................................................12
1.7.4
IPMI Messaging .....................................................................................................................................13
1.7.5 Sensor Model..........................................................................................................................................13
1.7.6 System Event Log and Event Messages .................................................................................................14
1.7.7 Sensor Data Records & Capabilities Commands....................................................................................14
1.7.8
Initialization Agent.................................................................................................................................15
1.7.9 Sensor Data Record Repository..............................................................................................................15
1.7.10 Private Management Busses...................................................................................................................15
1.7.11 FRU Information ....................................................................................................................................15
1.7.12 FRU Devices ..........................................................................................................................................16
1.7.13 Entity Association Records ....................................................................................................................16
1.7.14 Linkage between Events and FRU Information......................................................................................16
1.7.15 Differentiation and Feature Extensibility................................................................................................ 17
1.7.16 System Interfaces....................................................................................................................................17
1.7.17 Other Messaging Interfaces...................................................................................................................18
1.7.18 Serial/Modem Interface ..........................................................................................................................18
1.7.19 LAN Interface.........................................................................................................................................18
1.7.19a Payloads .................................................................................................................................................18
1.7.20 Serial Over LAN (SOL) .........................................................................................................................19
1.7.21 IPMI and ASF ........................................................................................................................................19
1.7.22 LAN Alerting..........................................................................................................................................20
1.7.23 Serial/Modem Alerting and Paging ........................................................................................................20
1.7.24 Platform Event Filtering (PEF)...............................................................................................................20
1.7.25 Call Down Lists and Alert Policies.........................................................................................................20
1.7.26 Channel Model, Authentication, Sessions, and Users.............................................................................20
1.7.27 Standardized Watchdog Timer...............................................................................................................21
1.7.28 Standardized POH Counter ....................................................................................................................21
1.7.29 Firmware Firewall ..................................................................................................................................21
1.7.30 Command and Function Discovery ........................................................................................................22
1.7.31 IPMI Hardware Components..................................................................................................................22
1.7.32 Configuration Interfaces.........................................................................................................................22
1.8
IPMI and BIOS..............................................................................................................................................23
1.9 System Management Software (SMS) ...........................................................................................................23
1.10 SMI Handler ..................................................................................................................................................24
1.11 Overview of Changes from IPMI v1.0...........................................................................................................25
2. Logical Management Device Types..................................................................................................26
3. Baseboard Management Controller (BMC)......................................................................................29
3.1 Required BMC Functions..............................................................................................................................32
4. Satellite Controller Required Functions...........................................................................................35
5. Message Interface Description .........................................................................................................37
iv
Intelligent Platform Management Interface Specification
5.1 Network Function Codes ...............................................................................................................................37
5.2 Completion Codes .........................................................................................................................................40
5.3 Completion Code Requirements....................................................................................................................41
5.3.1 Response Field Truncation on non-zero Generic Completion Codes.....................................................42
5.3.2 Summary of Completion Code Use ........................................................................................................42
5.4 Sensor Owner Identification ..........................................................................................................................43
5.5 Software IDs (SWIDs)...................................................................................................................................43
5.6
Isolation from Message Content ....................................................................................................................44
IPMI Messaging Interfaces ................................................................................................................45
6.1 Terminology ..................................................................................................................................................45
6.2 Channel Model ..............................................................................................................................................45
6.3 Channel Numbers ..........................................................................................................................................46
6.4 Channel Protocol Type ..................................................................................................................................47
6.5 Channel Medium Type ..................................................................................................................................48
6.6 Channel Access Modes..................................................................................................................................49
6.7 Logical Channels...........................................................................................................................................50
6.8 Channel Privilege Levels...............................................................................................................................50
6.9 Users & Password Support ............................................................................................................................51
6.9.1
‘Anonymous Login’ Convention............................................................................................................51
6.9.2 Anonymous Login Status........................................................................................................................51
6.10 System Interface Messaging ..........................................................................................................................52
6.10.1 BMC Channels and Receive Message Queue.........................................................................................52
6.10.2 Event Message Buffer ............................................................................................................................52
6.11 System Interface Discovery and Multiple Interfaces .....................................................................................53
6.12 IPMI Sessions................................................................................................................................................53
6.12.1 Session-less Connections........................................................................................................................54
6.12.2 Single-session Connections ....................................................................................................................54
6.12.3 Multi-session Connections......................................................................................................................54
6.12.4 Per-Message and User Level Authentication Disables ...........................................................................54
6.12.5 Link Authentication................................................................................................................................ 55
6.12.6 Summary of Connection Characteristics.................................................................................................55
6.12.7 Session Activation and IPMI Challenge-Response ................................................................................56
6.12.8 Session Sequence Numbers ....................................................................................................................57
6.12.9 IPMI v1.5 Session Sequence Number Handling.....................................................................................57
6.12.10 IPMI v1.5 Inbound Session Sequence Number Tracking and Handling ................................................58
6.12.11 IPMI v1.5 Out-of-order Packet Handling...............................................................................................58
6.12.12 IPMI v1.5 Outbound Session Sequence Number Tracking and Handling..............................................59
6.12.13 IPMI v2.0 RMCP+ Session Sequence Number Handling .....................................................................59
6.12.14 IPMI v2.0 RMCP+ Sliding Window ......................................................................................................59
6.12.15 Session Inactivity Timeouts....................................................................................................................59
6.12a Avoiding ‘Slot Stealing’.............................................................................................................................60
6.12.16 Additional Session Specifications and Characteristics ...........................................................................60
6.13 BMC Message Bridging ................................................................................................................................ 61
6.13.1 BMC LUN 10b Routing .........................................................................................................................62
6.13.2 Send Message Command From System Interface...................................................................................63
6.13.3 Send Message Command with Response Tracking ................................................................................64
6.13.4 Bridged Request Example ......................................................................................................................65
6.14 Message Size & Private Bus Transaction Size Requirements .......................................................................67
IPMB Interface.....................................................................................................................................71
7.1
IPMB Access via Master Write-Read command ...........................................................................................71
7.2 BMC IPMB LUNs.........................................................................................................................................71
7.3 Sending Messages to IPMB from System Software ......................................................................................71
7.4 Sending IPMB Messages to System Software ...............................................................................................72
7.5 Testing for Event Message Buffer Support ...................................................................................................73
6.
7.
v
Intelligent Platform Management Interface Specification
8.
8.2.1
8.2.2
ICMB Interface ....................................................................................................................................75
8.1 Virtual ICMB Bridge Device ........................................................................................................................75
ICMB Bridge Commands in BMC using Channels.......................................................................................75
8.2
ICMB Bridging from System Interface to Remote IPMB using Channels .............................................75
ICMB Bridging from Local IPMB to Remote IPMB using Channels....................................................76
9. Keyboard Controller Style (KCS) Interface ......................................................................................79
9.1 KCS Interface/BMC LUNs............................................................................................................................79
9.2 KCS Interface-BMC Request Message Format .............................................................................................79
9.3 BMC-KCS Interface Response Message Format...........................................................................................80
9.4 Logging Events from System Software via KCS Interface............................................................................80
9.5 KCS Interface Registers ................................................................................................................................ 80
9.6 KCS Interface Control Codes ........................................................................................................................82
9.7 Status Register...............................................................................................................................................82
9.7.1 SMS_ATN Flag Usage...........................................................................................................................83
9.8 Command Register ........................................................................................................................................84
9.9 Data Registers................................................................................................................................................84
9.10 KCS Control Codes .......................................................................................................................................84
9.11 Performing KCS Interface Message Transfers ..............................................................................................84
9.12 KCS Communication and Non-communication Interrupts ............................................................................85
9.13 Physical Interrupt Line Sharing .....................................................................................................................85
9.14 Additional Specifications for the KCS interface............................................................................................86
9.15 KCS Flow Diagrams......................................................................................................................................87
9.16 Write Processing Summary ...........................................................................................................................91
9.17 Read Processing Summary ............................................................................................................................91
9.18 Error Processing Summary ............................................................................................................................91
9.19 Interrupting Messages in Progress.................................................................................................................92
9.20 KCS Driver Design Recommendations .........................................................................................................92
10. SMIC Interface.....................................................................................................................................94
10.1 SMS Transfer Streams...................................................................................................................................94
10.2 SMIC Communication Register Overview ....................................................................................................94
10.3 SMIC/BMC Message Interface Registers......................................................................................................95
10.3.1 Flags Register.........................................................................................................................................95
10.3.2 Control/Status Register...........................................................................................................................96
10.3a Control and Status Codes...........................................................................................................................96
10.3.3 Data Register ..........................................................................................................................................97
10.4 Performing a single SMIC/BMC Transaction ...............................................................................................97
10.5 Performing a SMIC/BMC Message Transfer ................................................................................................ 98
10.6 Interrupting Streams in Progress....................................................................................................................98
10.7 Stream Switching...........................................................................................................................................99
10.8 DATA_RDY Flag Handling..........................................................................................................................99
10.9 SMIC Control and Status Code Ranges.......................................................................................................100
10.10 SMIC SMS Stream Control Codes ..............................................................................................................101
10.11 SMIC SMS Stream Status Codes.................................................................................................................102
10.12 SMIC Messaging .........................................................................................................................................103
10.13 SMIC/BMC LUNs.......................................................................................................................................103
10.14 SMIC-BMC Request Message Format ........................................................................................................103
10.15 BMC-SMIC Response Message Format......................................................................................................104
10.16 Logging Events from System Software via SMIC.......................................................................................104
11. Block Transfer (BT) Interface ..........................................................................................................105
11.1 BT Interface-BMC Request Message Format..............................................................................................105
11.2 BMC-BT Interface Response Message Format ...........................................................................................106
11.3 Using the Seq Field......................................................................................................................................106
11.4 Response Expiration Handling ....................................................................................................................107
vi
Intelligent Platform Management Interface Specification
11.5 Logging Events from System Software via BT Interface.............................................................................107
11.6 Host to BMC Interface ................................................................................................................................ 108
11.6.1 BT Host Interface Registers .................................................................................................................108
11.6.2 BT BMC to Host Buffer (BMC2HOST) ..............................................................................................108
11.6.3 BT Host to BMC Buffer (HOST2BMC) ..............................................................................................108
11.6.4 BT Control Register (BT_CTRL) ........................................................................................................109
11.6.5 BT Interrupt Mask Register (INTMASK) ............................................................................................111
11.7 Communication Protocol .............................................................................................................................112
11.8 Host and BMC Busy States .........................................................................................................................113
11.9 Host Command Power-On/Reset States.......................................................................................................113
12. SMBus System Interface (SSIF) ......................................................................................................115
12.1 Single Threaded Interface............................................................................................................................115
12.2 Single-part Write .........................................................................................................................................115
12.3 Multi-part Write...........................................................................................................................................116
12.3.1 Error conditions for Multi-part Writes .................................................................................................116
12.4 Single-part Read Transaction ......................................................................................................................117
12.5 Multi-part Read Transactions ......................................................................................................................117
12.6 Retention of Output Data.............................................................................................................................118
12.7 SMBAlert Signal Handling..........................................................................................................................119
12.7.1 Enabling/disabling SSIF SMBAlert .....................................................................................................119
12.8 Polling for output data .................................................................................................................................119
12.9 SMBus NACKs and Error Recovery ...........................................................................................................119
12.10 PEC Handling..............................................................................................................................................119
12.11 SMBus Timeout and Hang Handling...........................................................................................................120
12.12 Discovering SSIF.........................................................................................................................................120
12.13 SSIF Support Requirements for IPMI v1.5-only BMCs..............................................................................121
12.14 SSIF Support Requirements for IPMI v2.0 & Later BMCs.........................................................................121
12.15 Summary of SMBus Commands Values for SSIF .......................................................................................121
12.16 SSIF IPMI Commands.................................................................................................................................122
12.17 SSIF Timing ................................................................................................................................................122
13. IPMI LAN Interface............................................................................................................................125
13.1 RMCP..........................................................................................................................................................126
13.1.1 ASF Messages in RMCP ......................................................................................................................126
13.1.2 RMCP Port Numbers............................................................................................................................127
13.1.3 RMCP Message Format .......................................................................................................................128
13.2 Required ASF/RMCP Messages for IPMI-over-LAN.................................................................................128
13.2.1 RMCP ACK Messages.........................................................................................................................129
13.2.2 RMCP ACK Handling..........................................................................................................................130
13.2.3 RMCP/ASF Presence Ping Message ....................................................................................................130
13.2.4 RMCP/ASF Pong Message (Ping Response) .......................................................................................131
13.3 RMCP+........................................................................................................................................................131
13.4 BMC Support Requirements for v1.5 and v2.0/RMCP+ Protocols .............................................................132
13.4.1 Session-less Command Support............................................................................................................132
13.5 IPMI Messages Encapsulation Under RMCP..............................................................................................133
13.5.1 RMCP/ASF and IPMI Byte Order........................................................................................................133
13.6 Example IPMI over LAN Packet.................................................................................................................134
13.7 VLAN Support ............................................................................................................................................137
13.8 IPMI LAN Message Format ........................................................................................................................137
13.9 LAN Alerting...............................................................................................................................................138
13.10 IPMI LAN Configuration ............................................................................................................................139
13.10.1 IP and MAC Address Configuration ....................................................................................................139
13.10.2 ‘Teamed’ and Fail-over LAN Channels ...............................................................................................139
13.11 ARP Handling and Gratuitous ARP ............................................................................................................139
13.11.1 OS-Absent problems with ARP............................................................................................................140
vii
Intelligent Platform Management Interface Specification
13.11.2 Resolving ARP issues...........................................................................................................................140
13.11.3 BMC-generated ARPs..........................................................................................................................141
13.12 Retaining IP Addresses in a DHCP Environment........................................................................................141
13.12.1 Resolving DHCP issues........................................................................................................................141
13.13 Discovering Support For IPMI over IP Connections...................................................................................142
13.14 IPMI v1.5 LAN Session Activation.............................................................................................................142
13.15 IPMI v2.0/RMCP+ Session Activation .......................................................................................................144
13.16 RMCP+ Session Termination......................................................................................................................145
13.17 RMCP+ Open Session Request ...................................................................................................................145
13.18 RMCP+ Open Session Response.................................................................................................................147
13.19 RAKP Messages..........................................................................................................................................148
13.20 RAKP Message 1 ........................................................................................................................................148
13.21 RAKP Message 2 ........................................................................................................................................150
13.22 RAKP Message 3 ........................................................................................................................................151
13.23 RAKP Message 4 ........................................................................................................................................152
13.24 RMCP+ and RAKP Message Status Codes.................................................................................................153
13.25 Differences between v1.5 and v2.0/RMCP+ Sessions.................................................................................153
13.26 IPMI v2.0 RMCP+ Payload Types..............................................................................................................154
13.27 Payloads and Payload Type Numbers .........................................................................................................154
13.27.1 IPMI Message Payloads and IPMI Commands ....................................................................................155
13.27.2 OEM Payload Type Handles ................................................................................................................155
13.27.3 Payload Type Numbers ........................................................................................................................156
13.28 Authentication, Integrity, and Confidentiality Algorithm Numbers.............................................................156
13.28.1 RAKP-HMAC-SHA1 Authentication Algorithm .................................................................................157
13.28.1b RAKP-HMAC-SHA256 Authentication Algorithm............................................................................157
13.28.2 RAKP-none Authentication Algorithm ................................................................................................ 157
13.28.3 RAKP-HMAC-MD5 Authentication Algorithm...................................................................................157
13.28.4 Integrity Algorithms .............................................................................................................................157
13.28.5 Confidentiality (Encryption) Algorithms..............................................................................................158
13.29 AES-CBC-128 Encrypted Payload Format..................................................................................................159
13.29.1 Generating the Initialization Vector .....................................................................................................159
13.29.2 Encryption with AES............................................................................................................................159
13.29.3 CBC (Cipher Block Chaining) .............................................................................................................159
13.30 xRC4 Encrypted Payload Format ................................................................................................................160
13.30.1 Generating the xRC4 Initialization Vector ...........................................................................................160
13.30.2 Initializing the xRC4 State Machines ...................................................................................................160
13.31 RMCP+ Authenticated Key-Exchange Protocol (RAKP) ...........................................................................161
13.32 Generating Additional Keying Material ......................................................................................................164
13.33 Setting User Passwords and Keys................................................................................................................164
13.34 Random Number Generation .......................................................................................................................164
13.34.1 Random Number Key...........................................................................................................................165
13.34.2 Random Number Generator Counters ..................................................................................................165
13.34.3 Random Number Generator Operation.................................................................................................165
14. IPMI Serial/Modem Interface............................................................................................................166
14.1 Serial/Modem Capabilities ..........................................................................................................................166
14.2 Connection Modes.......................................................................................................................................166
14.2.1 PPP/UDP Proxy Operation...................................................................................................................167
14.2.2 Asynchronous Communication Parameters ..........................................................................................167
14.2.3 Serial Port Sharing................................................................................................................................ 168
14.2.4 Serial Port Switching............................................................................................................................169
14.2.5 Access Modes.......................................................................................................................................169
14.2.6 Console Redirection with Serial Port Sharing ......................................................................................169
14.2a Detecting Who Answered The Phone ......................................................................................................170
14.2b Connecting to the BMC ...........................................................................................................................170
viii
相关推荐
2023年江西萍乡中考道德与法治真题及答案.doc
2012年重庆南川中考生物真题及答案.doc
2013年江西师范大学地理学综合及文艺理论基础考研真题.doc
2020年四川甘孜小升初语文真题及答案I卷.doc
2020年注册岩土工程师专业基础考试真题及答案.doc
2023-2024学年福建省厦门市九年级上学期数学月考试题及答案.doc
2021-2022学年辽宁省沈阳市大东区九年级上学期语文期末试题及答案.doc
2022-2023学年北京东城区初三第一学期物理期末试卷及答案.doc
2018上半年江西教师资格初中地理学科知识与教学能力真题及答案.doc
2012年河北国家公务员申论考试真题及答案-省级.doc
2020-2021学年江苏省扬州市江都区邵樊片九年级上学期数学第一次质量检测试题及答案.doc
2022下半年黑龙江教师资格证中学综合素质真题及答案.doc
