Summary of the content on the page No. 1
®
Intel NetStructure™
MPCHC5525 System Master
Processor Board IPMI Reference
Driver
User’s Manual
May 2004
Order Number: 301561-001
Summary of the content on the page No. 2
INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTELR PRODUCTS. EXCEPT AS PROVIDED IN INTEL’S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY RELATING TO SALE AND/OR USE OF INTEL PRODUCTS, INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT, OR OTHER INTELLECTUAL PROPERTY RIGHT. Intel Corporation may have
Summary of the content on the page No. 3
Contents Contents 1 Using This Guide .............................................................................................................................7 1.1 Terms and Definitions...........................................................................................................7 1.2 Other Sources of Information................................................................................................8 2 IBMU Functionality ...................................................
Summary of the content on the page No. 4
Contents 4.2.4 SDR Commands....................................................................................................24 4.2.5 FRU Inventory Device Commands ....................................................................... 24 4.2.6 Sensor Device Commands....................................................................................25 4.2.7 ICMB Bridge Commands.......................................................................................25 4.3 Force-Specific Commands
Summary of the content on the page No. 5
Contents Revision History Date Revision Description May 2004 001 Initial Release of this manual. ® Intel NetStructure™ MPCHC5525 System Master Processor Board IPMI Reference Driver User’s Manual 5
Summary of the content on the page No. 6
Contents ® 6 Intel NetStructure™ MPCHC5525 System Master Processor Board IPMI Reference Driver User’s Manual
Summary of the content on the page No. 7
Using This Guide Using This Guide 1 ® The Intel NetStructure™ MPCHC5525 System Master Processor Board IPMI Reference Driver User’s Guide is intended for users qualified in electronics or electrical engineering. Users should have a working understanding of PCI, CompactPCI*, telecommunications, and the IPMI Specification V1.0 Rev. 1.1. 1.1 Terms and Definitions Table 1. Terms and Definitions Abbreviation Description BIB Board Information Block BMC Base Board Management Controller CMD Command Co
Summary of the content on the page No. 8
Using This Guide Table 1. Terms and Definitions Abbreviation Description SDR Sensor Data Record SEL System Event Log SMI System Management Interface 1.2 Other Sources of Information Table 2. Reference Documents Document Can be found at ® Intel NetStructure™ MPCBL5525 System Master Intel order number 301070 Processor Board Technical Product Specification Intelligent Platform Management Interface Specification www.intel.com/design/servers/ipmi/spec_old.htm v. 1.0 Rev. 1.1 Platform Management FRU
Summary of the content on the page No. 9
IBMU Functionality IBMU Functionality 2 2.1 Introduction ® The Intelligent Board Management Unit (IBMU) equips the Intel NetStructure™ MPCBL5525 board with Intelligent Platform Management Interface (IPMI) functionality as designed by Force Computers*. IPMI is used for platform management. IPMI is completely independent of the software running on the CPU board; it remains operative even if the board software has crashed or the board is not powered. Due to this fact, IPMI is used to log system
Summary of the content on the page No. 10
IBMU Functionality 2.1.3 Where Is IPMI-Relevant Information Stored? The following table shows which information is stored in which repository of a BMC/PM. Table 3. Data in Repositories Information Repository Available in Field Replaceable Inventory information on board or device: Manufacturer ID, product ID etc. PM and BMC Unit (FRU) Messages concerning events, such as abnormal voltages, out-of-range System Event Log BMC temperatures etc. (SEL) Sensor data records (SDRs) of all sensors on a bo
Summary of the content on the page No. 11
IBMU Functionality 2.1.4 Basic Communication Principles The system management software communicates with the devices via the BMC. It can communicate with: Boards/devices with IPMI controller Boards/devices without IPMI controller (nonintelligent devices) On-board sensors The following sections describe the basic communication procedure between the system management software and the boards/devices given in the list above. 2.1.4.1 Boards/Devices with IPMI Controller As seen in Figure 1, th
Summary of the content on the page No. 12
IBMU Functionality Figure 2. Required Parts for Communication with IPMI Devices and On-Board Sensors 2.1.5.2 Nonintelligent Devices For the communication between the system management software and nonintelligent devices the following components are necessary: IPMI driver for operating system Middleware System management software Figure 3. Required Parts for Communication with Nonintelligent Devices ® 12 Intel NetStructure™ MPCHC5525 System Master Processor Board IPMI Reference Driver User
Summary of the content on the page No. 13
IBMU Functionality 2.1.6 Available Drivers IPMI drivers for the following operating systems are available: VxWorks* Windows 2000/NT* Solaris* MontaVista Linux* These drivers include an application programming interface (API) to use IPMI commands. Please see Appendix A for an API to use IPMI commands. Additional information regarding implementing this software is available by contacting Force Computers (www.forcecomputers.com). 2.2 How Does Communication Work? Communication in this cas
Summary of the content on the page No. 14
IBMU Functionality Whereas the Keyboard Controller Style (KCS0) interface and the Intelligent Peripheral Management Buses (IPMB) allow communication between components within one chassis, the KCS0 interface and ICMB connect the devices of one chassis with another chassis. The IPMB and ICMB buses are IBMU powered and will be available even if the CPU board is not powered. Note: On some boards the sensors on the sensor bus are not powered by the IBMU. This means that if the power supply is int
Summary of the content on the page No. 15
IBMU Functionality Note: After installing or removing a board under hot-swap conditions, it is possible that nonintelligent devices will block the IPMB bus. Therefore: If the device is powered by its own power supply, turn off the device, then turn it on again. If the device is powered by the system’s power supply, turn off the whole system, then turn on. 2.2.1.1 Devices with IPMI Controller The following describes an easy event handling example for a fan module with IPMI controller. The
Summary of the content on the page No. 16
IBMU Functionality Figure 7. Example for Nonintelligent Devices 2.2.1.3 On-Board Temperature Sensor To read out the actual temperature value from the on-board sensor, the procedure is as follows: 1. The system management software sends the IPMI command “Get Sensor Reading” to the BMC, the BMC reads the value from the on-board sensor and sends it to the system management software. 2. The system management software compares the read value with a threshold value. 3. If the temperature is too high
Summary of the content on the page No. 17
IBMU Functionality Figure 9. Intelligent Chassis Management Bus (ICMB) The connection via ICMB is useful for maintenance purposes. If, for example, the CPU board in one chassis hangs, the BMC in the other chassis can read the log file of the affected BMC via ICMB. Another application is the monitoring and controlling of nonintelligent devices. If the CPU board the BMC is located on hangs or is in stand-by mode, the BMC in another chassis can request sensor 2 data of the nonintelligent device
Summary of the content on the page No. 18
IBMU Functionality 1. The system management software residing on the CPU board in chassis 2 sends an ICMB message to the BMC2. This ICMB message contains the ICMB header information and the 2 IPMI command “Master Write-Read I C” with which the fan sensor data is requested. 2. The BMC2 sends the ICMB message to the BMC1 via ICMB. 3. BMC1 extracts the IPMI command “Master Write-Read I2C” from the ICMB message. 4. BMC1 reads the sensor temperature on the fan module via the command “Master Write-
Summary of the content on the page No. 19
Preparing Software for IPMI Usage Preparing Software for IPMI Usage 3 3.1 Action Plan Before being able to use IPMI the following steps are required and will be described in this chapter. 3.2 Notes on Writing Your Own IPMI Driver ® The Intel NetStructure™ MPCBL5525 offers IPMI drivers for several operating systems. For information about designing your own IPMI driver, refer to the Intelligent Board Management Unit Reference Guide (PN217328), available by contacting Force Computers. The interf
Summary of the content on the page No. 20
Preparing Software for IPMI Usage 3.3 Sensor Data Records For each sensor attached to an IPMI controller in a system you need SDRs. SDRs for sensors on Force CPU boards are provided by Force Computers. SDRs for sensors on third-party products must be obtained by the respective manufacturer. 3.3.1 Obtaining SDR Settings To obtain SDR settings (thresholds, whether thresholds can be changed, whether a sensor generates events etc.), the default way is to write a function using the IPMI command “
