Intel MPCHC5525 User Manual

Intel® NetStructure™
MPCHC5525 System Master
Processor Board IPMI Reference
Driver

User’s Manual

May 2004

Order Number: 301561-001

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 patents or pending patent applications, trademarks, copyrights, or other intellectual property rights that relate to the
presented subject matter. The furnishing of documents and other materials and information does not provide any license, express or implied, by
estoppel or otherwise, to any such patents, trademarks, copyrights, or other intellectual property rights.

Intel products are not intended for use in medical, life saving, life sustaining, critical control or safety systems, or in nuclear facility applications.
Intel may make changes to specifications and product descriptions at any time, without notice.
Designers must not rely on the absence or characteristics of any features or instructions marked “reserved” or “undefined.” Intel reserves these for

future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them.
This User’s Manual as well as the software described in it is furnished under license and may only be used or copied in accordance with the terms of

the license. The information in this manual is furnished for informational use only, is subject to change without notice, and should not be construed as
a commitment by Intel Corporation. Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this
document or any software that may be provided in association with this document.

Except as permitted by such license, no part of this document may be reproduced, stored in a retrieval system, or transmitted in any form or by any
means without the express written consent of Intel Corporation.

Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order.
Copies of documents which have an ordering number and are referenced in this document, or other Intel literature may be obtained by calling

1-800-548-4725 or by visiting Intel's website at http://www.intel.com.
AnyPoint, AppChoice, BoardWatch, BunnyPeople, CablePort, Celeron, Chips, CT Media, Dialogic, DM3, EtherExpress, ETOX, FlashFile, i386, i486,

i960, iCOMP, InstantIP, Intel, Intel Centrino, Intel logo, Intel386, Intel486, Intel740, IntelDX2, IntelDX4, IntelSX2, Intel Create & Share, Intel GigaBlade,
Intel InBusiness, Intel Inside, Intel Inside logo, Intel NetBurst, Intel NetMerge, Intel NetStructure, Intel Play, Intel Play logo, Intel SingleDriver, Intel
SpeedStep, Intel StrataFlash, Intel TeamStation, Intel Xeon, Intel XScale, IPLink, Itanium, MCS, MMX, MMX logo, Optimizer logo, OverDrive,
Paragon, PC Dads, PC Parents, PDCharm, Pentium, Pentium II Xeon, Pentium III Xeon, Performance at Your Command, RemoteExpress, SmartDie,
Solutions960, Sound Mark, StorageExpress, The Computer Inside., The Journey Inside, TokenExpress, VoiceBrick, VTune, and Xircom are
trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

*Other names and brands may be claimed as the property of others.
Copyright © 2004, Intel Corporation

2 Intel® NetStructure™ MPCHC5525 System Mast er Process or Boar d IPMI Ref erence Driver User’s Manual

Contents

Contents

1 Using This Guide.............................................................................................................................7

1.1 Terms and Definitions............. ...................................... ............................... ..................... ....7

1.2 Other Sources of Information................................................................................................8

2 IBMU Functionality .......................................... ..... ....... ....... ..... ....... .. .......... .. ....... ....... ..... ................9

2.1 Introduction...........................................................................................................................9

2.1.1 Purpose of IPMI....................... ...................................... ...................................... ....9

2.1.2 Who Gathers the Information?.................................................................................9

2.1.3 Where Is IPMI-Relevant Information Stored?........................................................10

2.1.4 Basic Communica tion Principles............... ............................... ..............................11

2.1.4.1 Boa r d s/De vices with IPMI Controller .......................................... ...........11

2.1.4.2 N on intellige nt D ev ic e s ... .. . .. ... .. .. .............. ... .. .. . .. .... . .. .. ... .. .. .............. . .. ...11

2.1.4.3 On-Board Temperat ure Sensor .......................... ...................................11

2.1.5 Requi re ments ........................................................................................................11

2.1.5.1 Boards/Devices with IPMI Controller and On-Board Sensors................11

2.1.5.2 N on intellige nt D ev ic e s ... .. . .. ... .. .. .............. ... .. .. . .. .... . .. .. ... .. .. .............. . .. ...12

2.1.6 Available Dr ivers............... ...................................... ............................... ................13

2.2 How Does Communicati on Work?........ ............................... ............................... ................13

2.2.1 Communication Within a Chassis..........................................................................14

2.2.1.1 Devices with IPMI Controller..................................................................15

2.2.1.2 N on intellige nt D ev ic e s ... .. . .. ... .. .. .............. ... .. .. . .. .... . .. .. ... .. .. .............. . .. ...15

2.2.1.3 On-Board Temperat ure Sensor .......................... ...................................16

2.2.2 Commu nication bet ween Chas sis..........................................................................16

3 Preparing Software for IPMI Usage...............................................................................................19

3.1 Action Plan.... ............................... ...................................... ...................................... ...........19

3.2 Notes on Writing Your Own IPMI Driver.............................................................................19

3.3 Sensor Data Records...... ........................ .............................. ............................... ..............20

3.3.1 Obtaining SDR Settings.........................................................................................20

3.4 Notes on Writing System Management Software..................................... ............ ....... .......20

3.4.1 Require men ts for Events .... ...................................................................................20

3.4.2 Checking CPU Board Sig n als........................................ ............................... .........21

3.4.2.1 Critical IRQ Status ................................................................................. 21

3.4.2.2 CPCI Signal .................. ...................................... ...................................21

3.4.2.3 Ej e cto r Swi tch.................................. ............................... .......................21

3.4.2.4 PO ST Cod e....... ................. ............................... .....................................22

3.4.3 Monitoring the IBMU..............................................................................................22

3.4.3.1 Self Test............................................. ...................................... ..............22

3.4.3.2 IPMI Controller Wat c h dog................................. .....................................22

4 Supported IPMI Commands

and BMC/PM Addresses23

4.1 Standard IPM I Comma n ds .......... ............................... ..................................... ...................23

4.2 Global IPMI Commands......................................................................................................23

4.2.1 System Interface Commands .......................... ...................................... ................23

4.2.2 Watchdog Com ma nds ...........................................................................................23

4.2.3 SEL Comm ands.....................................................................................................24

Intel® NetStructure™ MPCHC5525 System Master Processor Board IPMI Reference Driver User’s Manual 3

Contents

4.2.4 SDR Comm ands....................................................................................................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 ...................................................... .......... .. ....... ..... .. .......... .. ....26

4.3.1 BMC/PMChangeRole ............................................................................................26

4.3.1.1 Request Data.........................................................................................26

4.3.1.2 Response Data......................................................................................26

4.3.2 FlashFileSystemClear............................................................................................27

4.3.2.1 Request Data.........................................................................................27

4.3.2.2 Response Data......................................................................................27

4.3.3 G et GeographicalAddress ......................................................................................27

4.3.3.1 Request Data.........................................................................................27

4.3.3.2 Response Data......................................................................................27

4.3.4 Get SDRR epos itoryCRC ........................................................................................27

4.3.4.1 Request Data.........................................................................................28

4.3.4.2 Response Data......................................................................................28

4.3.5 SetShadowRepositoryEnable................................................................................28

4.3.5.1 Request Data.........................................................................................28

4.3.5.2 Response Data......................................................................................28

4.4 BMC and PM Ad dresses .................................................................................................... 28

5 Customer Support......................................................................................................................... 31

5.1 Customer Support...............................................................................................................31

5.2 Technical Support and Return for Service Assistance .......................................................31

5.3 Sales Assistanc e............................ ...................................... .............................. ................31

Figures

1 Repositories of BMC and PMs ........................ ..... ....... ....... ....... ..... ....... ....... ..... ....... ....... ....... ....10

2 Required Parts for Communication with IPMI Devices and On-Board Sensors.........................12

3 Required Parts for Communication with Nonintelligent Devices ................................................12

4 Buses/Interfaces Provided by the IBMU.....................................................................................13

5 Communication within a Chassis................................................................................................14

6 Exam ple fo r PM wit h IPM I Controller..................................... .............................. .......................15

7 Example for Nonintelligent Devices... .. .......... .. ..... ....... ..... .. ....... ..... .. .......... .. ....... ..... .. .......... .. ....16

8 Example: On-Board Sensor........................................................................................................16

9 Intelligent Chassis Management Bus (ICMB).............................................................................17

10 Fan without IPMI Controller Monitored via ICMB .......................................................................17

11 Example for Nonintelligent Device via ICMB .............................................. ....... .. ....... .......... ......18

Tables

1 Ter ms and Def initions............................................. ............................... .......................................7

2 Refer e n ce Documents............................ ............................... ..................................... ..................8

3 Data in Repo sitories............ ............................... .............................. ..........................................10

4 Optional Global IPM I Comman ds.............................. ............................... .............................. ....23

5 Optional SEL Device Commands...............................................................................................24

6 Optional SDR Device Commands..............................................................................................24

7 Implemented Optional Sensor Device Commands.....................................................................25

8 Implemented Optional ICMB Bridge Commands........................................................................ 25

9 Address Mapping................................................................ ....... ....... ............ ............ ..................29

4 Intel® NetStructure™ MPCHC5525 Syst em Mast er Proc essor Board I PMI Refe rence Dr iver Us er’s Manua l

Revision History

Date Revision Description

May 2004 001 Initial Release of this manual.

Contents

Intel® NetStructure™ MPCHC5525 System Master Processor Board IPMI Reference Driver User’s Manual 5

Contents

6 Intel® NetStructure™ MPCHC5525 Syst em Mast er Proc essor Board I PMI Refe rence Dr iver Us er’s Manua l

Using This G uide

Using This Guide 1

The Intel® NetStructure™ MPCHC5525 System Master Proces sor Board IPMI Reference Driv er
User’s Guide is intended for users qualified in electronics or electrical engineering. Users should
have a working understanding of PCI, CompactPCI*, telecommuni cations, and the IPMI
Specification V1.0 Rev. 1.1.

1.1 Terms and Definitions

T able 1. T erms and Definitions

Abbreviation Description

BIB Board Information Block
BMC Base Board Management Controller
CMD Command Code
CPU Central Processing Unit
CRC Cyclic Redundancy Code
ECC Error Correction Code
FRU Field Replaceable Unit
GPIO General Purpose I/O

2

C Intelligent I/O Controller

I
IBMU Intelligent Board Management Unit
ICMB Intelligent Chassis Management Bus
IPMB Intelligent Peripheral Management Bus
IPMI Intelligent Platform Management Interface
IRQ Interr upt Request
KCS Keyboard Controller Style
LSB Least Significant Byte
MSB Most Significant Byte
NetFn Network Function Code
NMI Nonmaskable Interrupt
OEM Original Equipment Manufacturer
PMC Peripheral Management Controller
POST Power-on Self Test
PSU Power Supply Unit
RAM Random Acce ss Memory
RTB Rear Transition Board

Intel® NetStructure™ MPCHC5525 System Master Processor Board IPMI Reference Driver User’s Guid e 7

Using This G ui de

Table 1. Terms and Definitions

Abbreviation Description

SDR Sensor Data Record
SEL System Event Log
SMI System Mana gement Interface

1.2 Other Sources of Information

Table 2. Reference Documents

Document Can be found at

®

Intel

NetStructure™ MPCBL5525 System Master

Processor Board Technical Product Specifi cation
Intelligent Platform Management Interface Specification

v. 1.0 Rev. 1.1
Platform Management FRU Information Storage

Definition v1.0 Rev. 1.1
Intelligent Chassis Management Bus Bridge Specification

v1.0 Rev. 1.2
PICMG 2.9 R1.0 System Management Specification www.picmg.com
Force Computers* PENT/CPCI-735/736 Family

Refere nce Guide

Intel order number 301070

www.intel.com/design/servers/ipmi/spec_old.htm

developer.intel.com

www.intel.com/design/servers/ipmi/spec.htm

www.forcecomputers.com

8Intel

®

NetStructure™ MPCHC5525 Syst em Mas ter Processor Board IPMI Refere nce Dri ver User ’s Gui d e

IBMU Funct i onality

IBMU Functionality 2

2.1 Introduction

The Intellig ent Board Management Unit (IBMU) equips the Intel® NetStructure™ MPCBL5525
board with Intelligent Platform Manageme nt Interface (IPMI) functionality as designed by Force
Computers*. IPMI is used fo r platform management.

IPMI is completely independent of the software running on the CPU board; it remains operative
even if the board soft ware has crash ed or the boa rd is not power ed. Due to thi s fact, IPMI is used to
log system status informa tio n .

IPMI functionality on the IBMU is based on the Intelligent Platform Management Standards V1.0
Rev. 1.1. In addition, the following optional features applying to the IPMI standard are offered:

• Buses th at allow in t er n al a n d external co m munica ti o n

• Optional IPMI commands

• BMC standby mode

The features of the IBMU allow platform management with devices with and without IPMI
controllers (nonintelligent devices). Both are handled differently in many aspects as explained in
the next sections.

2.1.1 Purpo se of IPMI

The purpose of IPMI is to gather information and control dev ices (e.g., fans). The types of
information tha t ca n be gat h er ed ar e:

• Inventory – Board type, manufacturer, se rial number, board revision etc.

• Sensor – Temperature, fan speeds, power supply unit (PSU) voltages.

The system management software can use the gathere d information to monito r system events and
trigger actions, i.e. perform so calle d platform management.

2.1.2 Who Gathers the Information?

In a system there are, for examp le, several CPU boards and fans. Each of them has inventory data
and sensors and can provide this inventory data and sensor data. To make communication within
your system easier, your system management software communicates with the CPU boards and
fans via one single IPMI controller on a CPU board. This IPMI controller wil l be the Base Board
Management Controller (BMC) a nd the other IPMI controllers on CPU boards or fans will be
Peripheral Management Controllers (PMs).

The BMC has a central function in gathering inventory and sensor-specific data, whereas the PMs
only provide data . Tha t is why only one BMC is allowed within one system chassis.

Intel® NetStructure™ MPCHC5525 System Master Processor Board IPMI Reference Driver User’s Guid e 9

IBMU Funct i onality

2.1.3 Where Is IPMI-Relevant Information Stored?

The following ta ble shows which informati on is stored in which reposi tory of a BMC/PM.

Table 3. Data in Repositories

Information Repository Available in

Inventor y info rm atio n on boa rd or de vice: Man uf act ur er I D, pro du ct ID et c.
Messages concerning events, such as abnormal voltages, out-of-range

temperatures etc.
Sensor data records (SDRs) of all sensors on a board. SDRs contain, for

example, thresh old values, conversion factors, and information on
whether events are generated.

SDRs of all sensors available in the entire system. At first, the SDR
repository of the BMC is empty, and the SDRs of all PMs must be copied
into the BMC’s SDR repository (will be explained later).

The IBMU provides approximately 100 Kbytes of flash memory for each repository.
The following figure shows the repositories available in IPMI controllers operated as BMC or PM

after the SDRs of the PMs were copied into the BMC’s SDR repository. Nonintelligent devices
provide none of the repositories.

Figure 1. Repositories of BMC and PMs

Field Replaceable
Unit (FRU)

System E vent Log
(SEL)

Local SDR PM and BMC

SDR BMC

PM and BMC

BMC

10 Intel® NetStructure™ MPCHC5525 Syst em Mas ter Processor Board IPMI Refere nce Dri ver User’s Guide