Home

AM4001 IPMI: MMC User Manual

1. 11 FRU Data 11 1 Structure and Functionality The Management Controller provides 4 kB non volatile storage space for FRU information Please refer to 3 which defines the structure of FRU data Full low level access to read or write a module s FRU Information is provided by regular IPMI FRU Device commands Please be careful when writing FRU information directly using standard IPMI commands because there is no write protection Damaging the FRU Information e g may confuse a shelf management software which uses the FRU data To avoid this damage there is a Kontron Linux tool frum refer to 12 1 Linux which allows to display and partially modify FRU data E g the frum tool makes it easy to modify Product Info Area fields like Product Version or Product Serial Number 11 2 Board Specific FRU Data Supported are the following FRU data areas and data fields FRU Board Info Area Manufacturing date time Board manufacturer C7 Kontron Board Product Name C6 CP6016 Board Serial Number CF 123456789012345 Board Part Number C9 123456789 FRU File ID C7 STD R10 FRU Product Info Area Product manufacturer C7 Kontron Product Name C6 CP6016 Product Part Number C2 00 2 Product Version D9 0000000000000000000000000 Product Serial Number D9 0000000000000000000000000 Asset Tag D9 di FRU File ID C7 STD R10 CustomData D5
2. AO G pJEOg NNN uq AS L pJEOg NNN 3 Not applicable i e not used and not settable ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 38 IPMI Firmware User Guide CP6016 9 3 OEM sensor types and OEM sensor event reading types Specification of PICMG specific OEM sensors can be found in AdvancedTCA Base specification OEM OEM ENT READ SENSOR zin DESCRIPTION TYPE CODE TYPE CODE Firmware Info 1 COh 70h Internal Diagnostic Data Firmware Info 2 COh 71h Internal Diagnostic Data Initialization Agent C2h 03h Offsets events digital 0 Initialization O K Discrete 1 Initialization Error FRU Agent C5h 0Ah FRU initialization agent using a standard reading type Discrete Post Value C6h 6Fh Error is detected if the POST code is 0 and doesn t sensor type change for a defined amount of time specific In case of no error Bits 7 0 POST code payload Port 80h In case of error Bits 15 0 4000h Data2 POST code low nibble Data3 POST code high nibble Firmware Upgrade Manager 6Fh Offsets events C7h sensor type 0 First Boot after upgrade specific 1 First Boot after rollback error 2 First Boot after errors watchdog 3 First Boot after manual rollback 4 7 Reserved 8 Firmware Watchdog Bite reset occurred ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 39 IPMI Firmware User Guide CP6016 r
3. Page 16 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide A Standard IPMI command Set Watchdog Timer to stop a possibly running IPMI watchdog timer A Standard IPMI command Set SEL Time to set the event log time to the time which is kept by the RTC An OEM IPMI command refer to 8 2 2 Set Firmware Parameters with some parameters which e g set the Management Controller to a BMC or a SMC as selected in the EFI shell A Standard IPMI command Set ACPI Power State to set the state ACPI legacy on Etc 7 2 5 Hot Swap and Shut Down 7 2 5 1 Handle Switch and Hot Swap blue LED As a hot swappable field replaceable unit FRU the CP6016 behaves like an ATCA blade and internally uses similar M states The blue Hot Swap LED HS LED of an inserted board in a powered rack in general shows the board s Hot Swap state On the board is inactive and may be a activated by closing the Handle Switch or b may be extracted The M state is 1 An exception is the case when module power is off e g after a shut down and the handle is still closed We have here the M state 4 To show the operator that the power is off the blue LED will be on in spite of the closed handle Blinking changing from active state to inactive state or vice versa Don t extract the board now The M state is 2 5 or 6 Off the board is active Don t extract the board now Normally the extracti
4. memory for firmware banks if implemented 7 2 Firmware Code 7 2 1 Structure and Functionality The IPMI controller firmware code is organized into boot code and operational code both of which are stored in a flash module Upon an IPMI controller reset the IPMI controller first executes the boot code which does A self test to verify the status of the Management Controller s hardware including its memory Performs a checksum of the operational code After successful verification of the operational code checksum the firmware will jump to the operational code Only the operational code is upgradeable in the field 7 2 2 Firmware Upgrade Only if the SPI FLASH memory is implemented and no write protection is set The standard way to upgrade the IPMI controller s operational code is to use the open tool ipmitool 1 together with an image file Ipmitool allows the downloading ipmitool fwum download and activation ipmitool fwum upgrade of the new operational code and saves an existing one The rollback to the formerly running operational code is possible as well ipmitool fwum rollback The status command ipmitool fwum status displays what firmware is stored and in what state it is last known good running previous good running before upgrade All IPMI interfaces which are offered by ipmitool KCS interface IPMB bus LAN are usable for the upgrade This allows local upgrade
5. 6Fh 7FFFh Please note that the Health LED is always red if the payload is not active Blue Hot Swap LED is on 9 2 Sensor Thresholds Page 36 2009 Kontron AG ID 1035 7980 Rev 1 1 IPMI Firmware User Guide CP6016 ET 31 X38 uou saddn Do SLI Jo SLL 7 001 2 96 2 96 q eU jeo149 Jeddn 2 SOL 2 SOL 2 86 2 06 2 06 ALIS EN NI uou seddn 2 96 2 96 2 S8 2 08 2 08 eu 2 06 2 06 2 08 Ja SZ 2 SL A 08v 2 08 2 08 9 S 2 S9 2 S9 ALLEE 2 0 5 0 350 550 750 Nor LE 18912 uou 19M0 Dok Dok Dok Do L So L RU 16912 J MoT 2 2 9o 206 2 ALLES 9108191079 UOU J9M07 do G 9o G 9e G Oo G Oo G L BU Puis gl J8qWNN Add du NNN 1esdiu duiej NNN peog due NNN Z p1eog duie NNN pleog dui NNN A DJe0g NNN HOSN3S UL Uc ue I Uy UG 148 Page 37 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide qeu qeu qeu qeu qeu qeu A S628 A v 9 A061 A 086 0 A 8 S A LOG I qeu qeu qeu qeu qeu qeu A Se s A v09 A 1061 A 0460 A SZS A848 A 10 G A 00 A 08L A c06 0 AELOS A 6081 A cSLY A c00 AGLI A v8 0 NSL A LET L qeu qeu qeu qeu qeu qeu A 60 A 186 A S69 8 0 A 2897 ALL qeu qeu qeu qeu qeu qeu IWdIAS PJE0G NNN 46 Meyeg HOA NNN UV A8 pJEOg NNN ug A6 HA PJEOG NNN M9
6. 777 dev ipmi0 ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 45
7. 7980 Rev 1 1 O 2009 Kontron AG Page 9 IPMI Firmware User Guide CP6016 r 5 IPMI Setup 5 1 IPMI in a Compact PCI Chassis Kontron s IPMI implementation in the cPCI environment is compliant to the PCMIG 2 9 R1 0 specification The specification defines the pinout of J1 and J2 as well as the addressing scheme There should be only one BMC in the chassis or at least on the IPMB segment The BMC may reside either on an SBC blade or on an external system management card SMC or in a shelf management controller ShMC The specification allows all of these variants BMC Satellite Satellite Satellite IPMB Address IPMB Address IPMB Address IPMB Address Fix 20h Satellite Satellite Satellite Satellite IPMB Address IPMB Address IPMB Address IPMB Address Beh Bah BAn Bch 1 IPMB address for satellte is determined via the location of the slot in the chassis To use the IPMI resources in a rack some steps are needed The system operator must perform the following steps 5 2 IPMI Setup for the CP6016 First of all the IPMI Management Controller of the CP6016 has to be configured For the first time please use the EFI shell and kipmi command with option parameters Simple kipmi command displays possible options for this command kipmi mode command shows current controller mode BMC or SMC This command provide you possibility also to change this setting by issuing kipmi mode smc Satellite or kipmi
8. Chassis Get POH Counter Event Commands x Set Event Receiver Get Event Receiver Platform Event a k a Event Message PEF and Alerting Commands Get PEF Capabilities Arm PEF Postpone Timer Set PEF Configuration Parameters Get PEF Configuration Parameters Set Last Processed Event ID Get Last Processed Event ID Alert Immediate PET Acknowledge ID 1035 7980 Rev 1 1 2009 Kontron AG Page 25 IPMI Firmware User Guide CP6016 Get Device SDR Info Get Device SDR Reserve Device SDR Repository Get Sensor Reading Factors Set Sensor Hysteresis Get Sensor Hysteresis Set Sensor Threshold Get Sensor Threshold Set Sensor Event Enable Get Sensor Event Enable Re arm Sensor Events Get Sensor Event Status Get Sensor Reading Set Sensor Type Get Sensor Type FRU Device Commands Get FRU Inventory Area Info Storage Read FRU Data Storage Write FRU Data Storage SDR Device Commands Get SDR Repository Info Storage Get SDR Repository Allocation Info Storage Reserve SDR Repository Storage Get SDR Storage Add SDR Storage Partial Add SDR Storage Delete SDR Storage Clear SDR Repository Storage Get SDR Repository Time Storage Set SDR Repository Time Storage Enter SDR Repository Update Mode Storage Storage Exit SDR Repository Upd
9. IPMI Firmware User Guide CP6016 r 3 Contents J e c e 2121 11 una 2 2 Reyision History M 3 Dip Contents EE EE NE EE 4 EB KOLo LOLL slo E 6 4 1 Acr nym DefInifi nS uansett E EE 6 42 Related TOC mie ita OM si RE 8 4 3 Prod ct OyervieW Me 9 5 PEN 10 5 1 IPMI in a Compact PCI Chassis n naa 10 34 JEMI Setup forthe CPO Osinna a 10 5 3 PIN for T PE 11 6 Management Controller Hardwatre naa 12 7 Management Controller Firmwatre n n annassa 13 7 1 Key FP see 13 7 2 Firmware Codeuuesseasmsangmimmkenmenmdkensnnnensdatkues 14 7 2 1 sStr cture and PIHSOHODALIICV ascosocenacesecczeccevsaceanesncad pes veunesaeacteadesesteesmdencuacemndeens 14 12 2 Firmware Upgrade suamamevrsnmesnselnugnneammneadaains main 14 223 Firmware Module Identification a 15 7 2 4 The Payload Boot PrO 6S8S a anna apanapa aa ssiuasqoslapes 15 7 2 5 Is oretenus m 17 7 2 6 Setting or the SEL BID EE EE RR EN 19 Tob TAN NR au au eni tieni aede Siapa ae boue dis du enini sad heus 19 7 3 1 O c g P 19 132 Setting up the Ethernet channel cca Ssl 20 7 3 3 Setup of user and passwoId aa 20 7 3 4 IPMI ver LAN IOL
10. MAC CC CC CC CC CC CC Field will be modified during the manufacturing process 9 Field is free for user Please note that changes need special care checksums Refer to 3 ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 43 IPMI Firmware User Guide CP6016 r 11 3 Downloading the FRU Data Normally the user doesn t need to download the FRU data because the module is supplied with it before shipping But if needed the standard way to download FRU information to the module is to use the open tool ipmitool 1 for the download of an image file e g ipmitool fru write 0 file name gt All IPMI interfaces which are offered by ipmitool are usable KCS interface IPMB bus LAN This allows local upgrade or remote upgrade Please note that the KCS and LAN interfaces are only usable on a powered payload Please note that the writing of FRU data while the board is write protected will have no effect Page 44 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide 12 OS Support Tools 12 1 Linux Normally all drivers and kernel modules needed for communication between the payload sided software and the Management Controller firmware via the KCS interface come with the distribution Newest sources can be downloaded from http openipmi sourceforge net There may be downloaded the OpenIPMI project as well The OpenIPMI library package includes some applications and the needed libraries One of t
11. Yes Set SOL Configuration Parameters 26 3 Transport 22h O Yes ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 27 IPMI Firmware User Guide CP6016 r PICMG 3 0 AdvancedTCAer10 Table Get PICMG Properties 3 9 Get Address Info Get Shelf Address Info Set Shelf Address Info FRU Control M Yes 3 Get FRU LED Properties M Yes Get LED Color Capabilities 2 M Yes Set FRU LED State DS Get FRU LED State Mus Set IPMB State Set FRU Activation Policy Get FRU Activation Policy Set FRU Activation Get Device Locator Record ID Set Port State Get Port State Compute Power Properties Set Power Level Get Power Level Renegotiate Power Get Fan Speed Properties Set Fan Level Get Fan Level Bused Resource Get IPMB Link Info 1 Has oem extensions Please refer to 8 2 1 Get Device ID Command with OEM Extensions 2 Response byte 2 hours byte 3 minutes after module start Bytes 4 6 void 3 Only 1 Cold Reset and 2 Warm Reset Page 28 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide 8 2 OEM Commands and Extensions 8 2 1 Get Device ID Command with OEM Extensions Get Device ID command with OEM extensions 00h App 06h Oth Byte Data Field Request Data qu Response Data 1 Completion Code 2 12 Regular Get Device ID Command response fields 13 Release number 1 of the IPMI controller firmware The open ipmi tool ipmitool 1 d
12. and remote upgrade Please note that KCS and LAN interfaces are only usable on a powered payload Page 14 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide Files which contain an image of operational code have the board name CP6016 and the string FWUM in its name During the download process the currently running operational code is still operating in a normal way until the upgrade command is issued During the now starting upgrade process the IPMI controller is off line for about 20 seconds when the boot code is re organizing the firmware storage Afterwards the new operational code is started If the new operational code doesn t operate well e g hangs the boot code will perform an automatic rollback to the last working operational code and start this again 7 2 3 Firmware Module Identification There are two ways to verify by means of IPMI that the Management Controller resides on a CP6016 The response on the IPMI command Get Device ID offers among others the following response data Manufacturer ID 3A98h Kontron IANA ID Device ID 04h H8S2166 Product ID 6016 which means that the board is a CP6016 Firmware Revision in bytes 4 5 depends on the core version of the running firmware The SDR revision in byte 13 OEM part of the response is a sub revision of the firmware revision It is unique for all versions of the board s firmware i e the Firmware Revision men
13. can be many SMCs Each SMC is connected to the BMC via a dedicated bus IPMB 0 The CP6016 management controller can be set in SMC mode and in BMC mode by an IPMI OEM command The factory setting is SMC ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 7 IPMI Firmware User Guide CP6016 r 4 2 Related Documentation IPMI specifications http www intel com design servers ipmi spec htm IPMI Intelligent Platform Management Interface Specification v1 5 Document revision 1 1 February 2002 Addenda Errata and Clarifications document revision 4 for IPMI v1 5 rev 1 1 specification IPMI Intelligent Platform Management Bus Communications Protocol Specification v1 0 Document Revision 1 0 November 1999 IPMI IPMB v1 0 Address Allocation Document Revision 1 0 September 1998 3 IPMI Platform Management FRU Information Storage Definition v1 0 Document Revision 1 1 September 1999 PICMG specifications http www picmg org PICMG 2 9 R1 0 CompactPCI System Management Specification February 2000 PICMG 3 0 R2 0 AdvancedTCA Base Specification March 2005 Open tools documentation 1 ipmitool documentation http ipmitool sourceforge net Refer as well to 12 OS Support Tools 2 OpenIPMI documentation http www openipmi sourceforge net Refer as well to 12 OS Support Tools Kontron manuals and specifications http www kontron com CP6016 User Guide Page 8 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Fi
14. enable the LAN support after parameter setup this command has to be issued ipmitool lan set lt channel 2 3 gt access on Please note that the following commands must use the IP address which belongs to the enabled channel The open tool ipmitool can serve as a control program and user interface for this ipmitool allows to issue generic IPMI commands as e g ipmitool I lanplus H 192 168 3 189 U admin P admin A PASSWORD raw 6 1 or to call complex functions like mc info ipmitool I lanplus H 192 168 3 189 U admin P admin A PASSWORD mc info This uses many generic IPMI commands to get all needed information 7 3 5 Serial over LAN SOL Serial over LAN connects the COMO or dev ttyS0 respectively of the CP6016 s payload side to an Ethernet channel The IPMC resides between this serial interface and one of the Ethernet channels It serves as an encoder and a decoder for the used RMCP protocol and controls the data stream Outside the CP6016 e g the open tool ipmitool can be used to drive the SOL session i e it offers a console function to communicate via Ethernet with the CP6016 s serial interface The serial interface can be used as a connection 1 to a user program on the CP6016 payload or 2 to the EFI console redirection function Refer to the EFI setup menu Advanced gt Serial Port Console Redirection There the serial parameters for this purpose can be set Please note that after EFI start the OS get
15. link board reset post code boot error processor state Health error IPMI watchdog etc Page 12 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide 7 Management Controller Firmware 7 1 Key Features Compliant with IPMI specification 1 5 revision 1 1 Compliant with PICMG 2 9 specification Firmware designed and specially made for compact PCI implementation and easy integration with SAF HPI KCS SMS interface with interrupt support Dual Port IPMB configurable as two independent channels or in redundant mode refer to 8 2 2 Set Firmware Parameters Out of band management and monitoring using IPMB interface permits access to sensors regardless of the board s CPU state Sensor thresholds fully configurable Sensor names prefixed with identification of owner BMC without slot number or SMC with slot number Complete IPMI watchdog functionality Complete SEL SDR repository and FRU functionality on BMC Complete FRU functionality Master Write Read I2C supports for external I2C devices communications FRU EEPROM FAN If the SPI FLASH memory is implemented o Two IPMI controller firmware banks allow an automatic backup This allows manual and automatic firmware image roll back in case of upgrade failure o The downloading of a new firmware image does not break currently running firmware or payload activities refer to 7 2 2 Firmware Upgrade o Firmware bank management is done by the open t
16. mode bmc Baseboard Depends on the function of the CP6016 s IPMI controller you need Result issuing kipmi ipq command provides information about currently selected IRQ lack of irq used for KCS interface communication Additional parameter 10 11 or 0 sets IRQ configuration to IRQ10 IRQ11 or no IRQ The default factory setting of a CP6016 is SMC IRQ 11 If it is that what you want you need not enter the EFI shell When storing the configuration the EFI creates an IPMI Device Information Record Type 38h entry in the SMBIOS table This record contains information about Page 10 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide 1 Supported IPMI specification revision v1 5 type of the supported interface KCS style chosen interrupt 10 11 or none This information is needed by the IPMI OS kernel drivers for Linux during their loading time After the loading most available IPMI communications tools which access the IPMI controller via IPMI OS drivers should work e g ipmicmd ipmitool 1 etc Now it s possible to use such a tool to issue the Set Firmware Parameters OEM IPMI command refer to 8 2 2 Set Firmware Parameters to modify the configuration again But the change of the interrupt number always needs a EFI restart for a correct set up of the SMBIOS table 5 3 IPMI Setup for the rack For a working IPMI configuration the SDRR of the BMC has to be filled with all sensors d
17. 0F3Ch 1212h Ch Voltage 02h 2204h DDR termination supply Y NNN Board Vtt 9V Threshold 01h 2204h OF3Ch 1212h Dh Voltage 02h 2204h Board 5V supply Y NNN Board 5 0V Threshold 01h 2204h 0F3Ch 1212h Eh Voltage 02h 2204h Board 1 5V supply Y NNN Board 1 5V Threshold 01h 2204h 0F3Ch 1212h Fh Fan 04h 0000h Speed rpm Fan 1 N NNN Fan1 Speed Threshold 01h 0000h 1B1Bh 10h Fan 04h 0000h Speed rpm Fan 2 N NNN Fan2 Speed Threshold 01h 0000h 1B1Bh 11h OEM CFh 0002h Board reset event N NNN Last Reset digital Discrete 03h 0000h Page 34 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide Ass r SENSOR TYPE Mask Peer SENSOR Number CODE Deass DESCRIPTION er ID string EVENT READING Mask Readin TYPE CODE Reading g Mask Mask 0003h 12h Entity presence 25h 0000h Board is in System Slot N NNN Slot System Sensor specific 6Fh 0000h SYSEN 0003h 13h Entity presence 25h 0000h Board is selected N NNN PCI Present Sensor specific 6Fh 0000h BDSEL and in system 0003h slot SYSEN 14h Entity presence 25h 0000h Value is always 1 N NNN CTCA chassis Sensor specific 6Fh 0000h 0003h 15h Power supply 08h 0000h N NNN Board PwrOff digital Discrete 03h 0000h 0003h 16h Watchdog2 23h 010Fh IPMI Watchdog Y N
18. 980 Rev 1 1 2009 Kontron AG Page 17 IPMI Firmware User Guide CP6016 r Example 2 The handle switch is closed the blue LED is off and power is on If we use an OS with ACPI support a Shut Down command will lead us to the state payload power off and the blue LED will be switched on despite the handle is still closed The states of the LED and the position of the handle switch are not corresponding in this case but for the operator it is easier to be notified by the glowing LED that this board needs service To power up the board again we can proceed like in example 1 see above 7 2 5 2 The Hot Swap and Shut Down processes When we open the Handle Switch of a board which s payload is running we want to switch the payload off i e shut the power down in a way which causes no loss of data We aim the same if we order the operating system OS to perform a Shut Down We must distinguish here between three scenarios We might have on payload side 1 a dumb OS which doesn t support ACPI at all 2 an OS which supports ACPI 3 a dumb OS which doesn t support ACPI but behaves towards the Management Controller as if it supports ACPI This will be treated like 2 A hot Swap or a Shut down in a system 2 or 3 which is normally caused by an operator s command will both end in a Graceful Shut Down A Graceful Shut Down denotes a shut down where all processes are terminat
19. G kontron Kontron User s Guide IPMI Firmware User Guide for the CP6016 Board Manual ID 1035 7980 Rev 1 1 September 11 2009 IPMI Firmware User Guide CP6016 r 1 Copyright Copyright 2009 Kontron AG Kontron Modular Computers makes no representations or warranties with respect to the contents or use of this manual and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose Kontron Modular Computers makes no representations or warranties with respect to this embedded Linux package and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose Permission is granted to make and distribute verbatim copies of this manual provided that the copyright notice and this permission notice are preserved on all copies Permission is granted to copy and distribute modified versions of this documentation under the conditions for verbatim copying provided also that the entire resulting derived work is distributed under the terms of a permission notice identical to this one Permission is granted to copy and distribute translations of this documentation into another language under the above conditions for modified versions The PICMG and CompactPCI names and the PICMG CompactPCI ATCA and AdvancedTCA logos are registered trademarks and AdvancedMC is a trademark of the PCI Industrial Computer Manufac
20. NN IPMI WD Sensor specific 6Fh 0000h 010Fh 010Fh 17h IPMB status change 000Fh IPMB 0 state refer to N NNN IPMB State Fih 0000h PICMG 3 0 Rev 2 0 Sensor specific 6Fh 000Fh 3 8 4 1 18h System ACPI Power 7FFFh System ACPI Power N NNN ACPI State State 022h 0000h State Sensor specific 6Fh 7FFFh 19h Platform Alert 24h 0000h Aggregates states N NNN Health Error digital Discrete 03h 0000h power temperatures 0003h etc Visualization by the Health LED 14h Processor 07h 0463h CPU status Y NNN CPU 0 Status Sensor specific 6Fh 0400h Offset Oah Processor 0402h 04E3h Automatically Throttled 1Bh POST value OEM 4000h POST code value port N NNN POST Value C6h 0000h 80h Sensor specific 6Fh 40FFh 1Ch Boot error 1Eh 0008h Firmware Hub 0 Boot Y NNN FWHO BootErr Sensor specific 6Fh 0008h Flash 0 boot error 0008h 0008h 1Dh Boot error 1Eh 0008h Firmware Hub 1 Boot Y NNN FWH1 BootErr Sensor specific 6Fh 0008h Flash 1 boot error 0008h 0008h 1Eh Entity Presence 25h 0000h Presence of XMC board N NNN XMC present Sensor specific 6Fh 0000h 0003h 1Fh Platform Alert 24h 0002h 1 0 k no alert power N NNN Pwr Denied digital Discrete 03h 0002h not denied ID 1035 7980 Rev 1 1 2009 Kontron AG 7 Page 35 IPMI Firmware User Guide r Ass CP6016 SEN
21. OEM OEM SENSOR Er DESCRIPTION TYPE CODE TYPE CODE Board Reset CFh 03h Data 2 contains the reset type digital WARM 0 Discrete COLD 1 FORCED COLD 2 SOFT RESET 3 MAX 4 Data 3 contains the reset source IPMI_WATCHDOG 0 IPMI_COMMAND 1 PROC_INT_CHECKSTOP 2 PROC_INT_RST 3 RESET BUTTON 4 POWER UP 5 LEG INITIAL WATCHDOG 6 LEG PROG WATCHDOG 7 SOFTWARE INITIATED 8 SETUP RESET 9 UNKNOWN OxFF Page 40 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide OEM E Sk DESCRIPTION TYPE CODE TYPE CODE e g for 73h Sensor specific Event Power Good Offset Bit set o k Power Good Event gb rrr 1h HS early faults 2h DEG 3h FAL 4h n a 5h vccCore good 6h n a 7h n a 8h n a 9h n a Ah n a Bh n a Ch n a Dh n a Eh vccMainGood Board revision CEh 6Fh Bits 7 0 Board Revision number PESO type This corresponds to Board and PLD Revision register specific described in CP6016 board manual ID 1035 7980 Rev 1 1 2009 Kontron AG Page 41 IPMI Firmware User Guide CP6016 r 10 IPMI Communication LEDs 10 1 Overview There are three IPMI communication LEDs on the face plate Blue Hot Swap LED Color Blue 1 Labeled HS Meaning Indicates the Hot Swap state of the inserted and powered module Meaning O
22. SORTYPE Mask Suis SENSOR Number CODE Deass DESCRIPTION Bn eno ID string EVENT READING Mask Readin TYPE CODE Reading g Mask Mask 0003h 20h OEM FRU Agent C5h 0140h FRU Initialization Agent Y NNN FRU Agent 0000h state 0140h Discrete 0Ah 0147h 21h Management 0002h IPMI controller storage Y NNN IPMC Storage Subsystem Health 0000h access error 0002h 28h 0003h Sensor specific 6Fh 22h Firmware Upgrade 010Fh Status of Firmware N NNN Firm Upg Mng Manager C7h 0000h Upgrade Manager Sensor specific 6Fh 010Fh 23h Platform Alert 24h 0002h 2 Management N NNN IpmC Reboot digital Discrete 03h 0000h controller is re booting 0003h 24h Firmware version 0002h Management controller s N NNN Ver change change 2Bh 0000h firmware version Sensor specific 6Fh 0002h changed 25h Event Logging 003Ch State of event logging N NNN SEL State Disabled 10h 0000h Sensor specific 6Fh 003Ch 26h OEM Firmware Info 1 0003h For internal use only N NNN IPMI Info 1 COh 0000h OEM 70h 7FFFh 27h OEM Firmware Info 2 0003h For internal use only N NNN IPMI Info 2 COh 0000h OEM 71h 7FFFh 28h Initialization Agent 0002h Initialization Agent error N NNN IniAgent Err C2h 0000h status Used on BMC digital Discrete 03h 0003h only 1 error free 29h OEM Board Revision 0000h Board revision N NNN Board Rev CEh 0000h information Sensor specific
23. Session Info 22 20 App 3Dh O No Get AuthCode 22 21 App 3Fh O No Set Channel Access 22 22 App 40h O No Get Channel Access 22 23 App 41h O No Get Channel Info 22 24 App 42h O No Set User Access 22 26 App 43h O No Get User Access 22 27 App 44h O No Set User Name 22 28 App 45h O No Get User Name 22 29 App 46h O No Set User Password 22 30 App 47h O No Activate Payload 24 1 App 48h O No Deactivate Payload 24 2 App 49h O No Get Payload Activation Status 24 4 App 4Ah O No Get Payload Instance Info 24 5 App 4Bh O No Set User Payload Access 24 6 App 4Ch O No Get User Payload Access 24 7 App 4Dh O No Get Channel Payload Support 24 8 App 4Eh O No Get Channel Payload Version 24 9 App 4Fh O No Get Channel OEM Payload Info 24 10 App 50h O No Master Write Read 22 11 App 52h Get Channel Cipher Suits 22 15 App 54h Suspend Resume Payload Encryption 24 3 App 55h Set Channel Security Keys 22 25 App 56h Get System Interface Capabilities 22 9 App 57h Page 24 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide Chassis Device Commands Get Chassis Capabilities Chassis Get Chassis Status Chassis Chassis Control Chassis Chassis Reset Chassis Chassis Identify Chassis Set Chassis Capabilities Chassis Set Power Restore Policy Chassis Get System Restart Cause Chassis Set System Boot Options Chassis Get System Boot Options 28 13 Chassis 09h O No OFh O Yes
24. ata records of all IPMI controllers in the rack After every system start the BMC uses the SDRR to initialize all sensors of all boards The SDRR setup must be done by a management tool e g the open Linux tool ipmitool 1 The command then is ipmitool sdr fill sensors This will only work if the IPMI controller of the BMC is addressed This addressing is the default if you use ipmitool on the payload side of the board where the BMC is residing ID 1035 7980 Rev 1 1 2009 Kontron AG Page 11 IPMI Firmware User Guide CP6016 r 6 Management Controller Hardware On the CP6016 module the Management Controller is implemented using the Renesas H8S 2166 controller with 512 kB of internal Flash and 40 kB of RAM An additional 1 MB serial SPI FLASH memory chip if implemented provides redundant firmware image storage A separate 32 kB serial EEPROM chip is used for firmware private data and 4 kB EEPROM serves as FRU Inventory storage The Management Controller circuit implements two local Keyboard Style Interfaces KCS with interrupt support for communication with system side management software and EFI The Management Controllers in the rack are all connected by the IPMB 0 bus The Management Controller implements a wide range of sensors that permit the monitoring of main power voltages SV PWR 3 3V 5V MP 1 5V 1 8V 0 9V DDR temperatures CPU die temperature chipset temperature and 3 board temperatures Power Good IPMB 0
25. ate Mode Run Initialization Agent Storage Page 26 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide SEL Device Commands 0 Get SEL Info Storage O Yes Get SEL Allocation Info Storage O Yes Reserve SEL Storage O Yes Get SEL Entry Storage O Yes Add SEL Entry Storage O Yes Partial Add SEL Entry Storage O No Delete SEL Entry Storage O Yes Clear SEL Storage O Yes Get SEL Time Storage O Yes Set SEL Time Storage O Yes Get Auxiliary Log Status Storage O No Set Auxiliary Log Status Storage O No anbeveecommm I s Suspend BMC ARPs 23 3 Transport 03h O Yes Get IP UDP RMCP Statistics 23 4 Transport 04h O Yes Serial Modem Device Commands Set Serial Modem Configuration 25 1 Transport 10h O No Get Serial Modem Configuration 25 2 Transport O No Set Serial Modem Mux 25 3 Transport 12h O No Get TAP Response Codes 25 4 Transport 13h O No Set PPP UDP Proxy Transmit Data 25 5 Transport O No Get PPP UDP Proxy Transmit Data 25 6 Transport 15h O No Send PPP UDP Proxy Packet 25 7 Transport 16h O No Get PPP UDP Proxy Receive Data 25 8 Transport O No Serial Modem Connection Active 25 9 Transport 18h O No Callback 25 10 Transport 19h O No Set User Callback Options 25 11 Transport O No Get User Callback Options 25 12 Transport 1Bh O No SOL Activating 26 1 Transport 20h O Yes Get SOL Configuration Parameters 262 Transport 21h O
26. by writing to a board register Please refer to the CP6016 User Guide 7 2 4 2 Boot Flash Selection by OEM IPMI Command The OEM IPMI command Set Control State refer to 8 2 3 Set Control State Firmware Hub EFI Flash Boot Order adjusts whether the Management Controller has to invert the register based Flash selection or not from the next boot process on The Management Controller stores this decision in a parameter in the EEPROM Please refer to 8 2 3 Set Control State Firmware Hub EFI Flash Boot Order 7 2 4 3 Automatic Boot Flash Selection during the Boot Process After each payload reset the Management Controller selects the boot flash by applying the related EEPROM parameter Physically the Management Controller sets or resets a signal line Afterwards it waits for a special message from the EFI This message contains the checksum report i e it reports whether the boot Flash s checksum is right or wrong If the checksum is wrong or the message is not received within 60 seconds then the currently used EFI Flash is assumed to contain an invalid or a corrupted image In this case the Management Controller toggles the parameter value in the EEPROM and issues a Boot Error Invalid boot sector event by setting the appropriate sensor value sensor FWHx Boot Err x 0 1 x is simply the value of the parameter in EEPROM and not the absolute number of the used boot flash Afterwards it causes a payload off no cycle and cont
27. e Keyboard Controller Style Interface This is the IPMI mandatory interface on the host system payload to communicate with the BMC Management Power This powers the BMC s or SMC s controller and is available as soon as the board is inserted The Handle switch needs not be closed for that PCI Industrial Computer Manufacturer Group Payload Power This powers the host side of the board where the application software runs It is granted by the BMC or SMC after all prerequisites are met prerequisites are a closed handle switch power on the backplane etc Sensor Data Record This is the IPMI data structure that defines a sensor Sensor Data Record Repository Is the device in the BMC where all SDRs of the chassis boards are administrated A free Linux utility named ipmitool 1 makes a full chassis discovery and fills the SDRR with the SDRs being found The factory default repository contains only the local board s SDRs TODO refer to ipmitool System Event Log Is the device in the BMC where all the events in the chassis which are reported are administrated If an event occurs on any board the sensor event is sent throught the IPMB bus to the BMC which additionally stores its own events as well System Management BIOS System Management Software designed to run under the OS O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide SMC Satellite Management Controller In a compact PCI chassis there
28. e FRU Data ta n pn cde eto ESodem tUi bs on a UHR 44 12 OS Suppers Tools ces ep eae uu vimine n eee 45 MEME EE REESE EE RER EET NN 45 ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 5 IPMI Firmware User Guide CP6016 r 4 introduction 4 1 Acronym Definitions BMC BSP FRU FWH ISC IPMB IPMB 0 IPMI KCS MP PICMG PWR SDR SDRR SEL SMBIOS SMS Page 6 Baseboard Management Controller In a compact CPCI chassis there can be only one BMC present The BMC administrates the SEL and the SDRR for the complete system The BMC is connected to the other boards in the shelf via a dedicated bus IPMB 0 The CP6016 management controller can be set in SMC mode and in BMC mode by an IPMI OEM command The factory setting is SMC Board Support Package Field Replaceable Unit Every board is aFRU The FRU data contains information about the board such as the part number and the serial number See PICMG Specification 2 9 for complete details on the FRU data structure The free Linux tool ipmitool 1 can be used to update or to display the FRU data Firmware Hub Memory location where a complete EFI code is stored Inter Integrated Circuit Intelligent Plattorm Management Bus The dedicated 12C management bus where the BMC and the SMCs communicate Intelligent Plattorm Management Bus which connects all SMCs with the BMC or a Shelf Manager Intelligent Plattorm Management Interfac
29. e SEL time The Management Controller has no own hardware real time clock Therefore after start restart or upgrade of the Management Controller first its software clock has to be supplied with the current time The Management Controller uses the time when handling event messages which otherwise will have an out of date time stamp Every time when the EFI comes up it supplies the Management Controller with the payload s current real time clock time A problem is a re start of the Management Controller without a following EFI start Because during re start the Management Controller s time gets lost it must be set again by issuing the IPMI command Set SEL Time This may be done by application software on the payload side via the KCS interface or by a remote Management Controller via the IPMB 0 7 3 LAN functions 7 3 1 Overview The two Ethernet channels which reside on RearIO channel 2 and channel 3 in parallel to their normal use be used for the following special purposes IPMI over LAN IOL Serial over LAN SOL Common for both kinds of communication is the use of the RMCP RMCP for the packing of the data to be transferred On Ethernet the port 623 is used for transfers with this protocol 7 ID 1035 7980 Rev 1 1 2009 Kontron AG Page 19 IPMI Firmware User Guide CP6016 r While IOL serves to transport IPMI commands and their responses the SOL serves to transport any serial data In each case the IPMC serve
30. ects power on Response data 1 Completion code ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 31 IPMI Firmware User Guide CP6016 r 8 2 4 Get Control State Firmware Hub EFI Flash Boot Order Get Control State Firmware Hub EFI Flash Boot 00h OEM 3Eh 2th Order Byte Data Field Request data 1 Control ID 00h EFI Flash selection 9Dh EFI Boot Order Configuration Response data 1 Completion code 4 Current Control State refer to 8 2 3 Set Control State Firmware Hub EFI Flash Boot Order Page 32 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide 9 Board Sensors The Management Controller includes many sensors for voltage or temperature monitoring and various others for pass fail type signal monitoring Every sensor is associated with a Sensor Data Record SDR Sensor Data Records contain information about the sensors identification such as sensor type sensor name sensor unit SDRs also contain the configuration of a specific sensor such as thresholds hysteresis event generation capabilities etc that specify the sensor s behavior Some fields of the sensor SDR are configurable through IPMI v1 5 command and are set to a built in initial value Module sensors that have been implemented are listed in the sensor list below 9 1 Sensor List The sensor name ID string has a name prefix which is NNN in the lists below Whe
31. ed before the power is switched off 7 2 5 2 1 Dumb system with no ACPI support After payload power on the starting EFI will inform the Management Controller by sending the IPMI command Set ACPI Power State Set Legacy on This means that a Hot Swap opening of a closed handle shall immediately lead to a power off by the Management controller The operator is responsible for the termination of processes to avoid the loss of date 7 2 5 2 2 System having ACPI support When after EFI there is an OS starting which supports ACPI this will cause the transmission of the IPMI command Set ACPI Power State S0 G0 working to the Management Controller This means that the OS has reprogrammed the chip set in a manner that a power button signal doesn t lead to an immediate power off but only causes an event that can be detected by the OS Case 1 Hot Swap When the handle switch is opened the Management Controller pulls the power button signal to notify the OS The OS then will shut down all processes and afterwards will cause the transmission of the IPMI command Set ACPI Power State S5 G2 soft off to the Management Controller which will now switch the power off Please note that the Management Controller will switch off the power immediately if no more that 20 seconds have elapsed between entering S0 G0 state and Hot Swap This is to speed up the Hot Swap while the OS has not yet started an application Pa
32. er Guide CP6016 8 Supported IPMI Commands 8 1 Standard Commands Part of the command list in IPMI specification 2 0 M mandatory O optional Kontron IPMI 2 0 support Spec section Nemi CMD On IPMC IPM Device Global M Commands Get Device ID N gt a 5 Cold Reset RZ t Ww gt 5 5 Warm Reset Get Self Test Results Manufacturing Test On Set ACPI Power State Get ACPI Power State t3 d E oo ge 5 Get Device GUID Broadcast Get Device ID amet T Cuma wem capes au Disks ONT BMC Watchdog Timer Commands o Reset Watchdog Timer 27 5 App 22h O Yes Set Watchdog Timer 27 6 App 24h O Yes Get Watchdog Timer 27 7 App 25h O Yes ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 23 IPMI Firmware User Guide BMC Device and Messaging Commands x CP6016 Set BMC Global Enables 22 1 App 2Eh Get BMC Global Enables Clear Message Flags Get Message Flags Enable Message Channel Receive Get Message Send Message Read Event Message Buffer 22 8 App 35h Get BT Interface Capabilities 22 9 App 36h Get System GUID 22 14 App 37h O No Get Channel Authentication Capabilities 22 13 App 38h O No Get Session Challenge 22 15 App 39h O No Activate Session 22 17 App 3Ah O No Set Session Privilege Level 22 18 App 3Bh O No Close Session 22 19 App 3Ch O No Get
33. ge 18 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide Case 2 Shut Down When the OS is forced by the user to perform a shut down it will shuts down all processes Afterwards it will cause the transmission of the IPMI command Set ACPI Power State S5 G2 soft off to the Management Controller which will now switch the power off 7 2 5 2 3 System which emulates ACPI support An OS which not really supports ACPI like e g VxWorks is able to get Graceful Shut Down support from the Management Controller if it behaves in the following way After start such an OS has to manipulate the chip set in a way that prevents an immediate power off on a power button signal Then it has to send the IPMI command Set ACPI Power State S0 G0 working to the Management Controller to enable this to process later a S5 G2 soft off command During its run time the system shall cyclically read the Hot Swap Sensor sensor 0 using the IPMI command Get Sensor Reading This allows the tracking of the board s state After the board has once reached M state 4 sensor reading is 10h the leaving of this announces that the handle switch was opened Now the time has come to terminate all processes After all critical processes have been terminated the OS has to send the IPMI command Set ACPI Power State 5 G2 soft off to the Management Controller which will set the power off immediately 7 2 6 Setting of th
34. he applications is ipmicmd which makes it possible to send and receive raw IPMI sequences another the ipmi_ui provides a higher level interface and thus it does not require deep IPMI knowledge from the user side Another very useful all in one tool is ipmitool 1 http ipmitool sourceforge net It provides a user friendly interface to many IPMI features and extensions for example to PICMG LED control and for the upgrade of the IPMC s firmware ipmitool fwum There is a Kontron Modular Computers IPMI ToolKit which contains some tools for the customer for the monitoring and the maintenance of some IPMI functionalities The following command line tools are included in the IPMI Tool Kit frum display and modification of FRU data temptool selection display and storage of temperature and voltage sensor values All these tools are OpenIPMI based This toolkit is available on the AMC Kit CD If this CD was not shipped with your module then please contact our support support kontron modular com Please refer to the manual MAN LIN IPMI TOOLKIT 0103 pdf being included in the package Before using any of the tools mentioned above the needed OpenIPMI kernel modules have to be loaded if not yet done automatically at Linux start up modprobe ipmi si modprobe ipmi devintf Possibly there are access issues for device ipmi0 when calling ipmitool To prevent that try the following command chmod
35. inues as being described at the beginning of this chapter When a timeout error is recognized and the count of boot errors exceeds 2 or when a checksum error is recognized and the count of boot errors exceeds 4 the Management Controller gives up i e causes no more payload reset to stabilize the system Not until the next payload power on event the Management Controller will care about booting 7 2 4 4 Boot Order selection by OEM IPMI Normally the EFI will apply the boot order which was selected in the EFI menu Boot Boot Option Priorities But there is another alternative boot order which is held in the Management Controller s non volatile memory This boot order can be set and read by IPMI OEM commands refer to 8 2 3 Set Control State Firmware Hub EFI Flash Boot Order and 8 2 4 Get Control State Firmware Hub EFI Flash Boot Order At payload start the Management Controller writes it into a register where the EFI can read it If this Management Controller s boot order has a non zero value the EFI will use it instead of its own boot order Please refer to 8 2 3 Set Control State Firmware Hub EFI Flash Boot Order 7 2 4 5 Communication between Management Controller and EFI For communication between EFI and Management Controller there is a private KCS interface During the boot process the EFI sends the following IPMI commands to the Management Controller An OEM command which reports a good or a bad checksum
36. isplays this as SDR in the answer on command ipmitool fwum status 14 Module Geographical Address slot number 1 Module in chassis slot 1 15 Reserved 16 Reserved ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 29 IPMI Firmware User Guide CP6016 r 8 2 2 Set Firmware Parameters The command below permits the selection of interrupts to be used during KCS communication Please not that parameters which are set while the board is write protected are only valid until the next IPMI firmware reset Some ATCA carriers cause an additional IPMI firmware reset when the handle switch is closed Set Firmware Parameters 03h OEM 3Eh 05h Data Field Request data 1 Reserved B4h 2 Reserved 90h 3 Reserved 91h 4 Reserved 8Bh 5 Cmd Flags 6 2 Reserved 1 Ob get only 1b set parameters 0 Ob do not reset 1b reset Management Controller after setting parameters 6 Operating Modes 7 5 Reserved 4 Ob IPMB in redundancy 3 1 Reserved 0 Ob BMC 1b SMC 7 IRQ number FFh do not use interrupts 0Ah use IRQ10 OBh use IRQ11 Any other values Reserved Response data 1 Completion code 2 Cmd Flags Page 30 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide 3 Operating Modes 4 IRQ number 8 2 3 Set Control State Firmware Hub EFI Flash Boot Order P
37. lease not that parameters which are set while the board is write protected are only valid until the next IPMI firmware reset Some ATCA carriers cause an additional IPMI firmware reset when the handle switch is closed Set Control State Firmware Hub EFI Flash Boot 00h OEM 3Eh 20h Order Byte Data Field Request data 1 Control ID 00h EFI Flash selection 9Dh EFI Boot Order Configuration 2 Control State for EFI Flash selection These settings are stored in EEPROM and applied to logic each time the IPMI controller detects power on 00h EFI Flash selection is not inverted 01h EFI Flash selection is logically inverted Please note that this selection will be automatically toggled by the IPMI controller during a failing boot process Other payload sided settings may additionally modify this selection Control State for EFl Boot Order Configuration 00h 07h Selected EFI Boot Order Configuration 00h selects the default Boot Order which is selected in the EFI menu BIOS boot order configuration 000b Boot order is according to EFI setup default 001b Next boot device class FDD 010b Next boot device class HDD 011b Next boot device class CD ROM 100b Next boot device class Network 101b Next boot device class USB FDD 110b Next boot device class USB HDD 111b Next boot device class USB CD ROM These settings are stored in EEPROM and applied to logic each time the IPMI controller det
38. mitool The open tool ipmitool offers commands for the setup of the two Ethernet channels All possible options are showed by issuing ipmitool lan set If ipmitool is not usable the LAN parameters can be set by using the generic IPMI commands which are defined for this e g by ipmicmd To show the current LAN parameters for a channel ipmitool offers the command Ipmitool lan print lt channel 1 2 gt 7 3 3 Setup of user and password The open tool ipmitool offers commands for the listing and manipulation of user accounts for channel 1 and 2 An overview can be obtained by putting in ipmitool user Page 20 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide The predefined users for a channel can be listed by the command ipmitool user list lt channel 1 2 gt The CP6016 has for every channel these predefinitions in non volatile memory ID Name Callin Link Auth IPMI Msg Channel Priv Limit 1 false true true USER 2 admin false true true ADMINISTRATOR Please note that admin s password is preset with admin Changed users and passwords stay valid after payload power off The user must be activated by ipmitool user enable lt user number gt 7 3 4 IPMI over LAN IOL IPMI over LAN is used for to communicate with an IPMI controller as e g the CP6016 s IPMC via LAN using the RMCP or RMCP protocol The data which is transferred are IPMI commands and the responses to them To
39. n a Module may be extracted or b power is off e g after shut down and handle is closed Blinking Hot Swap active don t extract Off Module in normal operation Don t extract Index in IPMI commands Get Set LED State 0 LED I0 Out Of Service Color Green red 3 2 Labeled IO Meaning Indicates the Out Of Service state of the powered module Behavior Solid red Management controller out of service or not programmed or in reset state Off Management controller is running Pulsing green Traffic on the IPMB 0 bus Index in IPMI commands Get Set LED State 1 LED I1 Health Color Green red 3 2 Labeled Il Behavior Blinking Management controller is running showing its heart beat Pulsing KCS interface active Off Management controller is not running Any action green No health error detected refer to sensor Health Error Any action red Health error detected Index in IPMI commands Get Set LED State s 2 10 2 Programming of the LEDs All LEDs can be programmed by the IPMI commands Set FRU LED State Command although this is not recommended because they have a dedicated function But lamp test will make sense LED I0 and I I will not keep statically ON or OFF because they are continuously showing the activities of IPMB 0 and KCS interface which will be affected by the programming Page 42 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide
40. n reading the sensor name after module insertion this prefix becomes automatically adapted to the role BMC or SMC and the physical position slot number of the module in a rack If the module s Management Controller is set up as a BMC the prefix will be BMC independent of the slot where it resides If the module s Management Controller is set up as a SMC the prefix will be Sxx where xx is the slot number e g 09 The sensor number is the number which identifies the sensor e g when using the IPMI command Get Sensor Reading Please not that ipmitool 1 accepts sensor numbers in decimal e g 10 or hexadecimal e g Oxa notation Please note that the IPMI tool ipmitool displays for command ipmitool sdr list the contents of the sensor data record repository SDRR of the whole rack if the SDRR is generated The generation of the SDRR has always to be done new after adding or subtracting any board to or from the rack Refer to 5 3 PMI Setup for the rack For OEM Kontron specific sensor types and reading types in the following table please refer to the next chapter spe Causes red SENSOR TYPE Mask Health LED SENSOR Number CODE Deass P ID string EVENT READING Mask DESCRIPTION ded j TYPE CODE Reading enk Mask Oh ATCA CTCA Hot Swap 00FFh Hot swap sensor N NNN Hot Swap FOh 0000h Sensor specific 6Fh OOFFh 1h Temperature 01h 7A95h CPU die tempe
41. on is impossible because the Handle Switch is closed The M state is 3 or 4 Normally the logical states active and inactive of a board are identical to the physical states handle open and handle closed or payload power on and payload power off But this is only true if we exclusively use the Handle Switch to select the board s state If we e g switch the power on or off using an IPMI chassis commands or we let shut down the payload by the OS then the position of the handle switch and the power state necessarily might become asynchronous This is avoided by a special behavior of the blue LED in that case Please refer to the description of on state above Example 1 The handle switch is closed the blue LED is off and power is on If we switch off power by the IPMI chassis command the blue LED will be switched on despite the handle is still closed The states of the LED and the position of the handle switch are not corresponding in this case but for the operator it is easier to be notified by the glowing LED that this board needs service If we now switch on the power again by an IPMI chassis command the LED will be switched off again The position of the handle switch again is corresponding with the power state Another possibility is to power up the module is to open the handle and to wait until the blue LED stops blinking and stays on The closing of the handle then powers up the module ID 1035 7
42. ool ipmitool 1 function fwum which can update the firmware in the field Firmware fully customizable to the customer s needs by OEM IPMI commands refer to 8 2 2 Set Firmware Parameters FRU data can be updated in the field by the open tool ipmitool 1 function fru write Interoperable with other IPMI solutions OEM board supervision and control extensions such as boot device flash selection refer to 7 2 4 2 Boot Flash Selection by OEM IPMI Command and firmware boot order configuration refer to 7 2 4 4 Boot Order selection by OEM IPMI ID 1035 7980 Rev 1 1 2009 Kontron AG Page 13 IPMI Firmware User Guide CP6016 r Automatic switching to an alternative EFI image after having detected a not working EFI refer to 7 2 4 3 Automatic Boot Flash Selection during the Boot Process Graceful shutdown support refer to 7 2 5 Hot Swap and Shut Down Handle switch and blue Hot Swap LED are working like on an ATCA blade refer to 7 2 5 Hot Swap and Shut Down An Out of Service OOS LED shows whether the IPMI controller is working and pulses when there is IPMB 0 traffic refer to 10 IPMI Communication LEDs The Health LED shows the IPMI controller s heartbeat and pulses if the KCS interface is active refer to 10 IPMI Communication LEDs The board s write protection feature for all non volatile memories is supported These memories are a PC EEPROM for FRU data and parameters b SPI FLASH
43. rature Y NNN Temp CPU Threshold 01h 7A95h OF3Ch 3F3F 2h Temperature 01h 7A95h Temp Chipset Y NNN Temp Chipset Threshold 01h 7A95h I OF3Ch 3F3F 3h Temperature 01h 7A95h Temp Board 1 Y ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 33 IPMI Firmware User Guide CP6016 r SENSOR Number ID string Ass SENSOR TYPE Mask 1 CODE Deass Causes red Health LED on error Reading Mask EVENTIREADING Mask PESCRIPTION TYPE CODE Reading Mask NNN Temp Board 1 Threshold 01h 7A95h OF3Ch 3F3F 4h Temperature 01h 7A95h Temp Board 2 Y NNN Temp Board 2 Threshold 01 h 7A95h OF3Ch 3F3F 5h Temperature 01h 7A95h Temp Board 3 Y NNN Temp Board 3 Threshold 01 h 7A95h OF3Ch 3F3F 6h Power supply 08h 0000h Status of all power lines N NNN Pwr Good OEM 73h 0000h 402Fh 7h Power supply 08h 402Fh Power fail events for all Y NNN Pwr Good Evt OEM 73h 402Fh power lines I 402Fh 402Fh 8h Voltage 02h 2204h Board 3 3V supply Y NNN Board 3 3V Threshold 01h 2204h OF3Ch 1212h 9h Voltage 02h 2204h Management Power MP Y NNN Board 5VIPMI Threshold 01h 2204h 5V OF3Ch 1212h Ah Voltage 02h 2204h Battery Y NNN Volt Battery Threshold 01h 2000h OF3Ch 1212h Bh Voltage 02h 2204h Board 1 8V supply Y NNN Board 1 8V Threshold 01h 2204h
44. rmware User Guide This product fully supports Intelligent Platform Management Interface 1 5 IPMIv1 5 and PICMG 2 9 R1 0 specifications All its functionalities run under an autonomous management controller even if the board is held in reset or power down by a management card within a system designed for High Availability such as XL VHDS or XL LP42 While the CP6016 IPMI implementation is fully compliant to IPMI v1 5 and should work with any System Management Software that respects this specification it has been designed to be easily integrated with the Service Availability Forum Hardware Platform Interface SAF HPI specification 4 3 Product Overview You can find more information about the IPMI at the following Web site http www saforum org home IPMI is an extensible and open standard that defines autonomous system monitoring It is autonomous because every management controller within a compact PCI chassis monitors its own sensors and sends critical events through a dedicated bus to a Baseboard Management Controller BMC that logs it into a non volatile System Event Log SEL The CP6016 IPMI implementation includes a device SDR repository module that allows the user s System Management Software SMS to discover all system s components and to build a database of all management controller sensors You can find more information about the IPMI at the following Web site http www intel com design servers ipmi ID 1035
45. s active in most cases except e g DOS and the ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 21 IPMI Firmware User Guide CP6016 r console redirection stops working because the OS doesn t use EFI functions to drive the console 3 to a Linux login console This can be activated after payload start e g by the command getty h 9600 dev ttySO 4 etc SOL supports and requires serial hardware handshake This should be activated for the serial port Otherwise transmitted data might get lost In any case the same serial parameters for the used payload side serial interface and the IPMC s serial interface have to be used The parameters for the IPMC s serial interface can be set by the ipmitool sol set command Calling ipmitool sol set shows all options that can be set Other commands which are possible are showed when issuing ipmitool sol help 7 4 XMC Card Support The CP6016 is ready for the insertion of XMC card The presence or absence of XMC card is reported by sensor XMC preset refer to sensor description If XMC card is present the card s FRU data EEPROM is readable writable The size of EEPROM must be smaller or equal to 256 bytes because of 8 bit EEPROM addressing Note that XMC FRU size is always reported as 256 bytes and writing to part that exceeds real capacity should be avoided The FRU ID for XMC FRU data is always 1 Page 22 O 2009 Kontron AG ID 1035 7980 Rev 1 1 IPMI Firmware Us
46. s as a protocol encoder and decoder Please note that IOL is able to use both RMCP and RMCP protocols SOL works only with the RMCP protocol Please note that IOL and SOL need the Ethernet device to be powered Therefore the module payload must be fully powered 7 3 2 Setting up the Ethernet channel There are two methods to prepare the IPMIC s SOL and IOL LAN parameters for the two possible Ethernet channels During EFI shell setup By use of the open tool ipmitool or IPMI commands The setup methods are compatible i e both methods show the parameters which are set by the other one however ipmitool provides access to more options including SOL The setup is separate for both channels When the MAC addresses are set the ones which are programmed into the hardware have to be re used This is a restriction The IP addresses of a channel being used by normal payload traffic and IOL SOL traffic may differ but need not differ as long as the RMCP port 623 is not used in parallel by payload and IOL SOL 7 3 2 1 Setup by EFI shell The EFI shell setup provides kipmi family of commands The kipmi command with option net is used to query and set ipmi LAN related options Calling kipmi net 2 should print current configuration of channel 2 and display possible setting options After adjusting possible parameters IOL should be ready to work Note that here are no SOL specific configuration options 7 3 2 2 Setup by ip
47. tioned above is not really needed for the identification of the firmware The Device ID String which can be found by reading the Management Controller Device Locator Record SDR Type 12h contains the string BMC CP6016 For e g the ipmitool 1 command ipmitool sdr list mcloc the Device ID Strings of all available boards will be displayed If the CP6016 is a BMC for it this string will be displayed without change If the CP6016 is a SMC then the string will be changed into Sxx CP6016 where xx is the slot number where the board is residing e g S09 CP6016 7 2 4 The Payload Boot Process When the CP6016 s payload starts the first code to be executed is the EFI There are two Flash devices numbered 0 and 1 which may contain different EFI code Which one of them will be selected from the next boot process on is selectable this way a The contents of a user payload writeable register refer to the CP6016 User Guide tells which Boot Flash to use This is the primary selection b The firmware s parameter EEPROM contains a parameter which s value decides whether to invert the primary selection register s contents or not when the Management Controller s firmware selects the boot flash For this the Management Controller sets or resets a control signal which inverts or inverts not the boot flash selection ID 1035 7980 Rev 1 1 O 2009 Kontron AG Page 15 IPMI Firmware User Guide CP6016 r 7 2 4 1 Boot Flash Selection
48. turers Group Intel is a registered trademark of Intel Corporation TC is a trademark of Phillips Semiconductors Linux is a registered trademark of Linus Torvalds All other trademarks registered trademarks and trade names are the property of their respective owners Page 2 O 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide 2 Revision History Manual Product Title IPMI Firmware User Guide for the CP6016 Board Manual ID Number 1035 7980 Revision Index Brief Description of Changes Date of Issue Changes to Chapter 10 1 Overview Sept 11 2009 Imprint Kontron Modular Computers GmbH may be contacted via the following MAILING ADDRESS TELEPHONE AND E MAIL Kontron Modular Computers GmbH 49 0 800 SALESKONTRON SudetenstraBe 7 sales kontron com D 87600 Kaufbeuren Germany For further information about other Kontron products please visit our Internet web site www kontron com Disclaimer Copyright 2009 Kontron AG All rights reserved All data is for information purposes only and not guaranteed for legal purposes Information has been carefully checked and is believed to be accurate however no responsibility is assumed for inaccuracies Kontron and the Kontron logo and all other trademarks or registered trademarks are the property of their respective owners and are recognized Specifications are subject to change without notice 7 ID 1035 7980 Rev 1 1 2009 Kontron AG Page 3
49. u uuu usasqa a E 21 7 3 5 Seral over LAN Sveen 21 T4 XMC Card SUpport e rene ten epe dedu bats aiSia Kisiki sisane 22 B Supported IPMI Commands j3 ct cacecscenicducsedaazeaatiansacasura acneoscuseenseuadbeusbadsrseenecancudeeeuduees 23 8 1 Standard Commands sangens 23 82 OEM Commands and Extensions n uuu 29 Page 4 2009 Kontron AG ID 1035 7980 Rev 1 1 CP6016 IPMI Firmware User Guide 8 2 1 Get Device ID Command with OEM Extensions 29 8 2 2 Set Firmware Parameters a 30 8 2 3 Set Control State Firmware Hub EFI Flash Boot Order 31 8 2 4 Get Control State Firmware Hub EFI Flash Boot Order 32 9 Board SeNsofS ienige 33 9 1 Sensor LISE NE EE 9 33 9 2 Sensor ENN uuu Case re HIS an astaaaqiaspasqssakapaskussssqasiGunsssischaqiusuqtuqas 36 9 3 OEM sensor types and OEM sensor event reading types 39 10 TPM Communication LEDS uu uu as easa eere n ie oE S EEE ESE 42 I Overview SEE 42 10 2 Programming or the LED aai rere beide te idea cin te cadi rides 42 IT ERU DA we M 43 11 1 Structure and Functionality eee 43 112 Board Spe ifi FRU DL tussi ensenen isaisa tuta Uva uide tid dau 43 11 3 Downloading th

AM4001 IPMI: MMC User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents