System Management Controller Firmware User Guide for the CP308
Contents
1. Page 28 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide OEM OEM SENSOR EVENT READING DESCRIPTION TYPE CODE TYPE CODE e g for 73h Sensor Event Power Good specific Offset Bit set o k Power Good Event Oh HS fault 1h n a 2h DEG 3h FAL 4h n a 5h n a 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 Power Good Main Board revision CEh 6Fh Bits 7 0 Board Revision number sensor type specific This corresponds to Board and PLD Revision register described in CP6016 board manual 8 System Management LED There are is one LED on the face plate controlled by the System Management Controller SMC LED Health Color Green red Labeled SMC LED 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 ID 1035 8160 Rev 1 0 2009 Kontron AG Page 29 SMC Firmware User Guide CP308 po 9 System Management Setup 9 1 EFI BIOS Setup for the System Management For initial setup and to get some basic information of the CP308 System Management Controller the CP308 EFI shell is used Refer to chapter uEFI Shell of 10 CP308 uEFI BIOS User Guide2. IPMB 0 state refer to N SXX IPMB State F1h 0000h PICMG 3 0 Rev 2 0 Sensor specific 6Fh 000Fh 3 8 4 1 OCh System ACPI Power 7FFFh System ACPI Power N SXX ACPI State State 022h 0000h State Sensor specific 6Fh 7FFFh ODh Platform Alert 24h 0000h Aggregates sensors N SXX Health Error digital Discrete 03h 0000h power voltages etc 0003h Visualized by SMC LED OEh Processor 07h 0463h CPU status Y SXX CPU 0 Status Sensor specific 6Fh 0400h Offset Oah Processor 0402h 04E3h Automatically Throttled OFh POST value OEM 4000h POST code value port N SXX POST Value C6h 0000h 80h Sensor specific 6Fh 40FFh 10h Boot error 1Eh 0008h Firmware Hub 0 Boot Y SXX FWHO BootErr Sensor specific 6Fh 0008h Flash 0 boot error 0008h 0008h 11h Boot error 1Eh 0008h Firmware Hub 1 Boot Y SXX FWH1 BootErr Sensor specific 6Fh 0008h Flash 1 boot error 0008h 0008h 12h Mngmt Subsystem 0002h IPMI controller storage Y SXX IPMC Storage Health 28h 0000h access error 0002h Sensor specific 6Fh 0003h 13h Platform Alert 24h 0002h 2 Management N SXX IpmC Reboot digital Discrete 03h 0000h controller is re booting 0003h ID 1035 8160 Rev 1 0 2009 Kontron AG 7 Page 25 SMC Firmware User Guide r SENSOR Number Ass SENSOR TYPE VERGI CODE Deass EVENT READING NER TYPE CODE Reading NER DESCRIPTION
3. max slot number 15 00h Reserved 16 00h Reserved 6 3 2 Set Get Control State OEM commands With the two OEM IPMI commands Set Control State and Get Control State firmware non volatile parameters can be read or changed The parameter is selected by using the dedicated Control ID the parameter s value i e it value range depends on this selection ID 1035 8160 Rev 1 0 2009 Kontron AG Page 21 SMC Firmware User Guide r 6 3 2 1 Get Control State CP308 Set Control State Firmware Hub EFI Flash Boot Order IPMB Sensor Monitoring Mode 00h OEM 3Eh 20h Byte Data Field Request data 1 Control ID 00h EFI Flash selection 10h IPMB Sensor Monitoring Mode 9Dh EFI Boot Order Configuration Control State for EFI Flash selection 00h EFI Flash selection is not inverted 01h EFI Flash selection is logically inverted Control State for IPMB Sensor Monitoring Mode 10h Default IPMB related Sensor events disabled 11h IPMB related Sensors generate events Control State for EFI Boot Order Configuration 00h 07h Selected EFI Boot Order Configuration 00h selects the Boot Order which is set in the EFI BIOS boot order configuration 000b Boot order is according to EFI setup default 001b Next boot device class 010b Next boot device class 011b Next boot device class 100b Next boot device class 101b Ne
4. 10 11 or none This information is needed by the Operating System s KCS interface kernel driver when it is loaded Changing the KCS interrupt number from EFI shell needs a restart of the EFI BIOS for a correct set up of the SMBIOS table So issue a reset command instead of the exit command to leave the EFI shell when having changed the KCS Interrupt selection 9 1 2 Firmware Upgrade This board s Management Controller Firmware can be updated using the Firmware Update CD for CP308 Boot the CP308 from the Update CD and follow the onscreen instructions to update either Management Controller firmware or uEFI BIOS or both Page 30 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide 10 OS Support Tools 10 1 Linux tools OpenIPMI KCS driver 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 IPMI Tool 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 get sensor reading change sensor thresholds to access the SEL or t
5. BMC that logs it into a non volatile System Event Log SEL You can find more information about the IPMI at the following Web site http www intel com design servers ipmi CP308 System Management The CP308 System Management neither implements a fully functional BMC nor is it suggested to be fully compliant to the Intelligent Platform Management Interface 1 5 IPMIv1 5 and PICMG 2 9 R1 0 specifications This System Management Controller implementation is just based on it Page 8 O 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide 5 System Management Controller 5 1 Management Controller Hardware On the CP308 processor board the Management Controller is implemented using the NXP LPC2136 32 bit microcontroller with 256 kB of internal Flash and 32 kB of RAM An external serial EEPROM is used for firmware private data and for storage of sensor events The Management Controller implements one local Keyboard Style Interface KCS with interrupt support for communication with system side management software and the uEFI BIOS The Management Controllers in the rack are all connected the IPMB bus The Management Controller provides access to various board sensors that permit the monitoring of e system power voltages SV PWR 3 3V SV PMB e processor memory and board temperature e Power Good IPMB link state board resets POST code boot errors various processor states Health error etc 5 2 K
6. Without this the sensor events will have an out of date time stamp Note When the Management Controller restarts without getting the time from EFI for example executing the IPMI command Cold Reset no actual time is available Application software may send an IPMI command Set SEL Time via the KCS interface or by a remote Management Controller via the IPMB to set the correct time again 5 3 6 OS Shut Down The Management Controller allows a shut down of the Operating System OS using a PICMG defined OEM IPMI command This requires an OS which supports APCI power states Using the PICMG command FRU Control with Option set to 04h Quiesce will result in an shutdown of the Operating System The IPMI specification defines two commands which allow the Management Controller to track the current APCI power state Theses are the commands Set ACPI Power State and Get ACPI Power State The IPMI command Set ACPI Power State doesn t have impact on the real power state It just informs the Management Controller about it The uEFI BIOS ACPI sets the initial power state to ACPI legacy on on system startup before the OS boots using the IPMI command An ACPI capable OS sets the state to SO GO working when it has reprogrammed the chip set in a manner that a power button signal doesn t lead to an immediate power off but causes an event that can be detected by the OS which then leads to an OS
7. switch bank reset depends on the error condition e 2 retries on timeouts no message from EFI at all e 4retries when a checksum error is reported from EFI a ID 1035 8160 Rev 1 0 2009 Kontron AG Page 11 SMC Firmware User Guide CP308 po Note The number within the names of the two related sensors FWHO 1 Boot Err corresponds to the value of the non volatile parameter not to the absolute number of the uEFI BIOS firmware bank which is not known by the MC 5 3 4 uEFI BIOS Boot Order selection by OEM IPMI command Normally the EFI will apply the boot order which was selected in the uEFI BIOS 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 changed or just read by IPMI OEM commands During boards boot process the uEFI BIOS read this value from the Management Controller s stored boot order The uEFI BIOS will use this setting instead of its own boot order setting Please refer to chapter 6 3 2 Set Get Control State OEM commands using the Control ID for EFI Boot Order Configuration for details 5 3 5 Setting the SEL time The Management Controller has no own hardware real time clock but requires current time to generate sensor events with a correct timestamp So every time when the EFI comes up the EFI supply the time from board processor s RTC to the Management Controller
8. AG Page 3 SMC Firmware User Guide CP308 po 3 Contents EE EE EEE EE ENE 2 2 Reyision History rece act ciara cas te Acdece tenella cette eca E eee cyanea 3 Dip Contents EEE EE EE EN 4 gt JIniredQeChon evnene elnm ene emning 6 4 1 Acr nym DSH MODS Vaa ere eee dramskeee 6 4 2 Related Doc ment tion s ccctessasetesivezedasetdcediernac iiae ieia e a a E ae aiii 7 4 3 Product OvyervieW csi seacscntetiesiaae caked sasiu iresi niuia E EEE Ts Aanias aaa asies 8 4 3 1 CP308 System Management Controller esseeeeeeseeeeeseeressrsersressrseresreeseresres 8 4 3 2 System Management based on IPMI enornnnnorennvnnnnnvonnnnnnvnnnvnnnnnnevnnnnnnnnnnnvnnnee 8 5 System Management Controller seeseseesesseeeseeeeeseesserrrestesrrsersstesesetssresstsstettensereeerreeseeee 9 5 1 Management Controller Hardware Lqussemnadrgmmmeddbjuenkgentemmmv ud 9 Dek Key Pe Agr EEE EE 9 5 3 Management Controller Firmware ii ssccesicsinedaerienciacei eens 10 5 3 1 Structure and Functionality sseeseseeeeseeseesereeererstssreseesstssrerreestesersrresrenseneeesee 10 5 3 2 Initial uEFI BIOS interadfonu m senssmvmimemevnsn jvinnenumidedkuie 10 5 3 3 Board s Boot Process uEFI BIOS Flash selection rrronnnnnrorrrrrrrrrnnennnnnnnr 11 5 3 4 uEFI BIOS Boot Order selection by OEM IPMI command asvrnnnvnnvrnnvvnrnnnne 12 5 3 5 FE NL 12 5 3 6 OS Shut DOWD eee ect ne Taipa ai 12 5 3 7 Firmware Identification eseeeeeeseeeeeseessreeee
9. Get System Boot Options 28 13 Chassis 09h O No Chassis Get POH Counter Event Commands 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 13h O No Get PEF Configuration Parameters 30 4 S E Set Last Processed Event ID Get Last Processed Event ID 15h O No O No Alert Immediate S E 16h ID 1035 8160 Rev 1 0 O 2009 Kontron AG Page 17 SMC Firmware User Guide CP308 Sensor Device Commands 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 O Yes 2 Get SDR Repository Allocation Info Storage O Yes 2 Reserve SDR Repository Storage O Yes 2 Get SDR Storage O Yes 2 Add SDR Storage O No Partial Add SDR Storage O No Delete SDR Storage O No Clear SDR Repository Storage O No Get SDR Repo
10. LEE A 0 v A 089 Oo S Oo S Oo S eu q eu q EU WWIGOS IWdIAS Ndo dwel xxS pieog dwaL XXS dwa 1 XXS NE E PIEOG XXS p1e0g XXS AO S PJEOG XXS 1 4O HUL 1 UG I UG 49 1 YL D Not applicable i e not used and not settable Page 27 O 2009 Kontron AG ID 1035 8160 Rev 1 0 SMC Firmware User Guide CP308 r 7 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 SENSOR EVENT READING DESCRIPTION TYPE CODE TYPE CODE Firmware Info 1 COh 70h Internal Diagnostic Data Firmware Info 2 COh 71h Internal Diagnostic Data POST Value C6h 6Fh Error is detected if the POST code is not equal to 00h sensor type specific and doesn t change for a defined amount of time 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 Board Reset CFh 03h Data 2 contains the reset type digital Discrete WARM 0 COLD 1 FORGED 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
11. for more information Beside the built in uEFI Shell commands the Kontron uEFI implementation provides a number of additional commands related to the specific HW features of the system The Kontron uEFI Shell command for configuration of the System Management is the kipmi command The kipmi command provides a set of parameters to support various IPMI Management controllers Not all parameters have impact on the CP308 System Management On the CP308 the kipmi command may be used with following parameters e kipmi without any parameter displays a list of available parameters e kipmi irq provides information about currently selected IRQ used for KCS System Interface An additional parameter 10 11 or 0 sets KCS IRQ configuration to RQ10 IRQ 1 or to no IRQ at all e kipmi sel may be used with additional parameters to deal with the System Event Log SEL for example clear the SEL or displaying a single entry e kipmi raw for execution of raw IPMI commands also with additional parameters Using the kipmi command with other parameters than those listed here don t have any impact on the CP308 System Management Controller 9 1 1 KCS Interface IRQ The default factory setting of a CP308 for its KCS interface is no IRQ When changing the configuration the EFI creates updates an entry in the SMBIOS table This record contains information about among others e type of the supported interface KCS style e chosen interrupt
12. 5 3 3 1 uEFI BIOS Flash Selection by OEM IPMI command Using the OEM IPMI command Get Control State the current selected uEFI BIOS bank set by the MC can be determined With the OEM IPMI command Set Control State this setting can be changed This setting is always kept as a non volatile parameter i e is restored after power off power on cycles Please refer to 6 3 2 Set Get Control State OEM commands using Control ID for EFI Flash selection 5 3 3 2 Automatic uEFI BIOS Flash Selection After each board processor reset the Management Controller selects the uEFI BIOS flash by applying the related non volatile parameter Then it waits for a message from the uEFI BIOS This message contains a checksum report i e it reports whether the boot Flash s checksum is right or wrong If either the checksum is wrong or the message is not received within a given time then the currently used uEFI BIOS is assumed to contain an invalid or a corrupted image In this case the Management Controller toggles the related non volatile parameter and generates a Boot Error Invalid boot sector event The sensor event is generated either by sensor FWHO Boot Err or FWH1 Boot Err dependent on which uEFI BIOS bank failed After selecting the alternate uEFI BIOS bank the board processor is reset and the Management Controller waits for the checksum report message from EFI again The number of retries wait f checksum
13. C Firmware User Guide 6 Supported IPMI Commands 6 1 Standard Commands Part of the command list in IPMI specification 2 0 M mandatory O optional Kontron IPMI 2 0 support Spec section On SMC IPM Device Global Commands Get Device ID App M Yes 1 Cold Reset App O Yes O No Warm Reset App Get Self Test Results App O Yes O No Manufacturing Test On App Set ACPI Power State App O Yes Get ACPI Power State App O Yes Get Device GUID App O No Broadcast Get Device ID App BMC Watchdog Timer Commands o Reset Watchdog Timer 27 5 App 22h O No Set Watchdog Timer Get Watchdog Timer 1 Has OEM extensions Please refer to 6 3 1 Get Device ID Command with OEM Extensions for details ID 1035 8160 Rev 1 0 2009 Kontron AG Page 15 SMC Firmware User Guide BMC Device and Messaging Commands o Set BMC Global Enables O Yes Get BMC Global Enables Clear Message Flags Get Message Flags 22 4 App 31h Enable Message Channel Receive 22 5 App 32h Get Message 22 6 App 33h Send Message 22 7 App 34h 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 A
14. Firmware User Guide CP308 po 4 Introduction 4 1 Acronym Definitions BMC BSP FRU FWH 12C IPMB IPMB 0 IPMI KCS MP PICMG PWR SDR SDRR SEL SMBIOS SMS SMC 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 Board Support Package Field Replaceable Unit Every board is a FRU 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 FRU data is not present on the CP308 Management Controller Firmware Hub Memory location where a complete EFI code is stored Inter Integrated Circuit Intelligent Platform Management Bus The dedicated 12C management bus where the BMC and the SMCs communicate Intelligent Platform Management Bus which connects all SMCs with the BMC or a Shelf Manager Intelligent Platform Management Interface Keyboard Controller Style Interface This is the IPMI mandatory interface on the host system payload to communicate with the Management Controller Management Power This powers the BMC s or SMC s controller and is available as soon as the board is inserted A Handle switch needs not be closed for that PCI Industrial Computer Manufacturer Group Payload P
15. G kontron Kontron User s Guide System Management Controller Firmware User Guide for the CP308 Board based on IPMI Manual ID 1035 8160 Rev Index 1 0 September 3 2009 If it s embedded it s Kontron SMC Firmware User Guide CP308 m 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 t
16. ID string CP308 Causes red Health LED on error Reading MER 14h Event Logging 003Ch State of event logging N SXX SEL State Disabled 10h 0000h Sensor specific 6Fh 003Ch 15h OEM Firmware Info 1 0003h For internal use only N SXX IPMI Info 1 COh 0000h OEM 70h 7FFFh 16h OEM Firmware Info 2 0003h For internal use only N SXX IPMI Info 2 COh 0000h OEM 71h 7FFFh 17h OEM Board Revision 0000h Board revision N SXX Board Rev CEh 0000h information Sensor specific 6Fh 7FFFh Please note that the Health LED is always red if the payload is not active i e the OS is shut down or Event Generation of sensor Board SVIPMT is disabled by default Event Generation of sensor IPMB State is disabled by default IPMB voltage is optional not default on 3U cPCI backplanes Page 26 2009 Kontron AG ID 1035 8160 Rev 1 0 SMC Firmware User Guide CP308 7 2 Sensor Thresholds ETG EDEN PEN uou Jaddn e21149 4eddn 1e91 1 149 uou 1addn 1E9149 uou JaM07 jed1 149 13M07 9 qe19A0991 UOU JEMOT Buns qi JequnN YOSNAS Oo SLL Oo 96 Oo S6 i BU a Vu i eu Oo SOL 0 06 3o 06 NOSE A 887 G Aches Oo 96 2 08 0 08 i BU a EU q Lu Oo 06 Do GL 9o GL AGLYE A eves A eves 2 08 Do 99 Oo 99 A v0e e A v86 v A v86 0 0 0 0 000 Abore A0SL b A 0S2 b Do k Do tr Do be i BU i BU i PU Oo Oo Oo amp Ab
17. agement Interface Specification v1 5 IPMI Command Get Device ID The response on the IPMI command Get Device ID offers the following information among others e Manufacturer ID 3A98h Kontron IANA ID e Device ID 20h NXP LPC2136 e Product ID 0134h 308 identifies the board as a CP308 e Firmware Revision in bytes 4 5 depends on the core version of the running firmware e 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 mentioned above is not really needed for the identification of the firmware For a description of the OEM extensions refer to chapter 6 3 1 Get Device ID Command with OEM Extensions ID 1035 8160 Rev 1 0 2009 Kontron AG Page 13 SMC Firmware User Guide CP308 po Device Locator Record The Device Locator Record SDR Type 12h contains a Device ID String This string identifies the MC as CP308 SMC and also holds some run time information like slot number and the slot dependent IPMB address For example when using the Linux ipmitool 7 on a CP308 placed in 8 slot of CompactPCI system by calling ipmitool sdr list mcloc The following information is displayed S08 CP308 BEh ok Where 508 identifies the slot number and BEh the IPMB address derived from the slot number Page 14 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SM
18. agement Interface Specification v1 5 Document revision 1 1 February 2002 2 Addenda Errata and Clarifications document revision 4 for IPMI v1 5 rev 1 1 specification 3 IPMB Intelligent Platform Management Bus Communications Protocol Specification v1 0 Doc Rev 1 0 November 1999 4 IPMI IPMB v1 0 Address Allocation Document Revision 1 0 September 1998 PICMG specifications http www picmg org 5 PICMG 2 9 R1 0 CompactPCI System Management Specification February 2000 6 PICMG 3 0 R2 0 AdvancedTCA Base Specification March 2005 Open IPMI tools documentation see also chapter 10 OS Support Tools 7 ipmitool documentation http ipmitool sourceforge net 8 OpenIPMI documentation http www openipmi sourceforge net Kontron manuals and specifications http www kontron com 9 CP308 User Guide 3U Compact PCI Processor Board Doc ID 1027 4487 Rev 2 0 July 20 2009 10 CP308 uEFI BIOS User Guide Doc ID 1030 4232 Rev 2 0 July 22 2009 ID 1035 8160 Rev 1 0 2009 Kontron AG Page 7 SMC Firmware User Guide CP308 r 4 3 Product Overview 4 3 1 CP308 System Management Controller Although the CP308 SMC implementation is not fully compliant to IPMI v1 5 it should work with System Management Software SMS and IPMI tools which respect this specification Compared with a BMC defined by IPMI the CP308 SMC is just an IPM Device with some additional capabilities to allow SMS
19. ctivation 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 FRU Control Capabilities PICM CM CM ICM ICM ICM ICM PICM ICM ICM ICM ICM ICM ICM ICM ICM ICM ICM ICM ICM ICM ICM ICM 3 FRU Control Option request byte 3 Only 00h Cold Reset and 04h Quiesce are implemented G G G G G G G G G G G G G G G G G G G G G G Yes 3 Both options are reserved i e not optional in the FRU Control Capabilities mask Page 20 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide 6 3 OEM Commands and Extensions 6 3 1 Get Device ID Command with OEM Extensions The IPMI specification defines four optional bytes in the response to Get Device ID The response bytes 13 14 hold the Auxiliary Firmware Revision Information Get Device ID command with OEM extensions 00h App 06h Oth Byte Data Field Request Data J Response Data 1 Completion Code 2 12 Regular Get Device ID Command response fields 13 Release number of the management controller firmware 10h for R10 11h for R11 14 Boards Geographical Address slot number read from backplane 0 reserved 1 slot 1
20. ey Features e Based on IPMI specification 1 5 revision 1 1 and PICMG 2 9 CompactPCI System Management specification e KCS SMS interface with interrupt support e Single Port IPMB channel from to CompactPCI backplane e Out of band management and monitoring using IPMB interface permits access to sensors regardless of the board s CPU state e Sensor thresholds fully configurable e Sensor names prefixed with identification of owner based on slot number e SEL functionality storing local sensor events e Interoperable with other IPMI solutions e uEFI BIOS fail over control for automatic EFI firmware bank switching after having detected a not working EFI refer to chapter 5 3 3 2 Automatic uEFI BIOS Flash Selection e OEM commands for uEFI BIOS firmware bank selection and uEFI BIOS boot order override refer to chapters 5 3 3 1 and 5 3 4 e OS shutdown support refer to chapter 5 3 6 OS Shut Down e The Health LED shows the IPMI controller s heartbeat and pulses if the KCS interface is active refer to chapter 8 System Management LED The complete list of all CP308 SMC sensors including thresholds and event generation masks can be found in chapter 7 Board Sensors below 7 ID 1035 8160 Rev 1 0 2009 Kontron AG Page 9 SMC Firmware User Guide CP308 m 5 3 Management Controller Firmware 5 3 1 Structure and Functionality The Management Controller MC firmware code is stored i
21. 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 using IPMI commands and are set to a built in initial value Board sensors that have been implemented are listed in the sensor list below 7 1 Sensor List The sensor name ID string has a prefix which is SXX in the table below XX is replaced with the slot number during runtime e g S08 is the prefix for the sensors of a CP308 in the 8 slot When reading the sensor name the prefix is automatically adapted to the physical position slot number of the board in a rack Sensor Type and Event Reading Type Codes are described by the IPMI specification 1 in detail Kontron OEM specific sensor type codes and event reading type codes are described in chapter 7 3 Ass VEGLEG Deass VEGLEG Reading MER Causes red Health LED on error Reading MER SENSOR TYPE CODE EVENT READING TYPE CODE SENSOR Number DESCRIPTION ID string 00h Temperature 01h 7A95h CPU die temperature Y SXX Temp CPU Threshold 01h 7A95h O0F3Ch 3F3F O1th Temperature 01h 7A95h Temperature sensor Y SXX Temp Board Threshold 01h 7A95h close to processor OF3Ch 3F3F 02h Tem
22. l uEFI BIOS interaction For communication between uEFI BIOS and Management Controller the KCS interface is used During the boot process the uEFI BIOS sends the some IPMI and OEM defined commands to the Management Controller e An OEM command which reports a good or a bad checksum of the current selected uEFI BIOS firmware bank e The IPMI command Set SEL Time to set the event log time to the time which is kept by processor boards RTC Page 10 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide e A Standard IPMI command Set ACPI Power State to set an initial state before the OS boots e An OEM command to get Boot Order Override setting from MC e And others 5 3 3 Board s Boot Process uEFI BIOS Flash selection When the CP308 s processor starts the first code executed is the uEFI BIOS There are two Flash banks which may contain different uEFI BIOS firmware The currently selected one can be checked from EFI shell using the kboardinfo command Refer to chapter uEFI Shell of 10 the CP308 uEFI BIOS User Guide for more information The selection of uEFI BIOS firmware bank used for the next boot process can be changed the following ways e Using a DIP Switch Refer to 9 the CP308 User Guide 3U Compact PCI Processor Board for details e From Management Controller side o Using OEM IPMI command o Automatically by the uEFI BIOS fail over control
23. n its internal flash area To allow observation of the board s sensors CPU states and processor board startup the MC has its own power supply The MC is powered independent of the CPU On the CP308 a special power controller is used to turn on power supply of the CPU automatically The MC has no influence on CPU s power supply it just observes it Refer to 9 CP308 User Guide 3U Compact PCI Processor Board for details 5 3 1 1 Management Controller Startup Upon system start the System Management Controller does e A self test to verify the status of the Management Controller s hardware The self test result can be determined using the IPMI command Get Self Test Results e Checks integrity of connected EEPROM containing internal firmware parameters configuration data and the storage of sensor events Then it starts monitoring its sensors and provides the sensor and event data to SMS either via KCS interface or via IPMB over the backplane 5 3 1 2 Processor Board Startup When the processor board gets powered turned on or when the system is restarted the MC additionally observes correct startup of the system e uEFI BIOS fail over control e POST code observation Erroneous processor board startup is indicated by the related sensors events are generated then and by the SMC LED Refer to the sensors Health Error POST Value and FWHx Boot Err at chapter 7 1 Sensor List 5 3 2 Initia
24. o access other Management Controllers via IPMB Before ipmitool can be used the OpenIPMI driver mentioned above must be loaded too 10 2 OS Support Board Support Packages To see which Operating Systems are supported refer to the board s data sheet please visit http www kontron com to get the data sheet Also have a look in the download section for latest versions of Board Support Packages or Firmware Updates For information about IPMI refer to the BSP s documentation of the dedicated OS ID 1035 8160 Rev 1 0 2009 Kontron AG Page 31 SMC Firmware User Guide CP308 m This page has been intentionally left blank Page 32 2009 Kontron AG ID 1035 8160 Rev 1 0
25. or other tools for IPMI to read the sensors and give access to stored sensor events Sensors and Events The CP308 Sensors are accessible via the KCS System Interface from CP308 Host OS side All sensors are monitored and Sensor Events are generated in case of a sensors value is out of range refer to 7 1 Sensor List and 7 2 Sensor Thresholds Generated sensor events are stored in the local System Event Log SEL Sensor Data Record Repository Some SMS expects a BMC with an already filled Sensor Data Record Repository SDRR behind a KCS to get current readings of sensors Normally the SDRR holds information of all sensors in the system and therefore the SDRR must be filled when the system or rack is setup Thus CP308 SMC is intended to provide only information of its own sensors The CP308 System Management Controller implementation includes a static SDR repository module which includes its own sensors This SDRR has read only access i e its content is fixed and could not be changed This allows SMS to deal with the CP308 SMC to get sensor readings and access its SEL like SMS does this with a BMC 4 3 2 System Management based on IPMI What is IPMI 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
26. ower This powers the host side of the board where the application software runs On the CP308 the payload power is switched on automatically The Management Controller of the CP308 observes it 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 The CP308 Management Controller s repository always contains only the local board s SDRs 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 In the Event Log of the CP308 Management Controller only local events are stored System Management BIOS System Management Software designed to run under the OS Satellite Management Controller In a compact PCI chassis there can be many SMCs Each SMC is connected to the BMC via a dedicated bus IPMB 0 The CP308 management controller operates as SMC only 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide The CP308 System Management Controller implementation is based on the following IPMI and PICMG specifications But the CP308 SMC doesn t claims to be fully compliant to these specifications 4 2 Related Documentation IPMI specifications http www intel com design servers ipmi spec htm 1 IPMI Intelligent Platform Man
27. perature 01h 7A95h Temperature sensor Y SXX Temp SODIMM Threshold 01h 7A95h close to SODIMM socket 0F3Ch 3F3F 03h Power supply 08h 0000h Status of power lines N OEM 73h 0000h PGOOD_MAIN SXX Pwr Good 73h ye NE FALT OVOP CPCI1_DEG_3V3 CPCI1_FAL_3V33 04h Power supply 08h 0000h Power fail events for Y SXX Pwr Good Evt OEM 73h 400Dh power lines I 400Dh 400Dh 05h Voltage 02h 2204h Board 3 3V supply Y SXX Board 3 3V Threshold 01h 2204h OF3Ch 1212h Page 24 O 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SENSOR Number ID string SENSOR TYPE CODE EVENT READING TYPE CODE SMC Firmware User Guide Ass WEGE Deass WERE Reading VET DESCRIPTION Causes red Health LED on error Reading MER 06h Voltage 02h 2204h IPMI IPMB Power 5V N SXX Board 5VIPMI Threshold 01h 2204h from to backplane OF3Ch 1212h 07h Voltage 02h 2204h Board 5V supply Y SXX Board 5 0V Threshold 01h 2204h OF3Ch 1212h 08h Fan 04h 0000h Speed rpm Fan 1 N SXX Fan1 Speed Threshold 01 h 0000h 1B1Bh 09h OEM CFh 0002h Board reset event N SXX Last Reset digital Discrete 03h 0000h 0003h OAh Entity presence 25h 0000h Board is in System Slot N SXX Slot System Sensor specific 6Fh 0000h SYSEN 0003h OBh IPMB status change 000Fh
28. pp 3Bh O No Close Session 22 19 App 3Ch O No Get 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 Yes 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 16 2009 Kontron AG CP308 ID 1035 8160 Rev 1 0 CP308 SMC 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
29. rademarks and AdvancedMC is a trademark of the PCI Industrial Computer Manufacturers Group Intel is a registered trademark of Intel Corporation IC 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 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide 2 Revision History Manual Product Title User Guide CP308 System Management Controller 1035 8160 Revision Index Brief Description of Changes Date of Issue 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 8160 Rev 1 0 2009 Kontron
30. sersrrrrrrstesrrserestessesseestesseesresreesetee 13 6 Supported IPML Commands uvaner iii a ni ai esn 15 6 1 Standatd Commands sssini inne aiaa e ea aeaa a aaa a raS 15 6 2 PICMG defined OEM Commands eseeeeeeseeeeeeeseseesesstesreresserssesrerseestesereseesseseeesee 20 6 3 OEM Commands and Extensions seseseeseeeseeseeseesrreresserstrresstesrsrresttsseseresresseesres 21 6 3 1 Get Device ID Command with OEM Extensions ennvrrovorrnvrnrnvvnvnrnrvrnvrversnene 21 6 3 2 Set Get Control State OEM commands hvem snev 21 Te BSE 24 7 1 Sensor List ca seed be E T E 24 Pome Sensor Thresholds nsession res a asie eee e E SEE En EEE Ears E 27 7 3 OEM sensor types and OEM sensor event reading types rrrnrrnvrnnronnvnrerrnnrrrrnnennnee 28 Ge System M nagement LED Luyessermsegmspetepee keenmunmanenadiannie 29 Page 4 O 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide 9 System MEN SAP sene a n aa iaaa 30 9 1 EFI BIOS Setup for the System Management eonnannnononvvnnnrnnvrnnenenennnnvnenerrasennnenene 30 9 1 1 KES Interface IRQ munnet kassa ata vosdeisteines vas voddeaeeniens 30 9 1 2 Fre Ep 30 LO OG Support Tools cis siccatssasanaevasuacns ances re ritena S EEEE AE AEEA EEE ERRES E ieai 31 IOT Er GUS euenire E E EEEE EE E E EE 31 10 2 OS Support Board Support Packages ccssssssssacssccssecssasssseenvessenssassaessesssseesseases 31 ID 1035 8160 Rev 1 0 2009 Kontron AG Page 5 SMC
31. shutdown When the OS is almost shut down it sets the ACPI state to S5 G2 soft off Page 12 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide The current set ACPI state can be determined either by the IPMI command Get ACPI Power State or by reading the dedicated sensor ACPI State Both ways are possible via KCS only when the OS is up or via IPMB by a Management Controller of another board in the rack Notes Compared to ATCA blades where a graceful shutdown is initiated by pulling the handle switch and indicated by a blue LED and the MC is capable of switching payload power on or off the CP308 doesn t have such ATCA features Refer to 9 CP308 User Guide 3U Compact PCI Processor Board for details On the CP308 a special power controller is used to turn on power supply of the CPU automatically The MC has no influence on CPU s power supply it just observes it The operator is in responsibility that all boards in the system are shut down before the power is switched off 5 3 7 Firmware Identification There are two ways by means of IPMI to identify the CP308 System Management Controller Firmware e Issuing a IPMI Command Get Device ID e Read the Device Locator Record SDR Type 12h A full description of the IPMI command Get Device ID and for the Device Locator Record SDR Type 12h format can be found at 1 IPMI Intelligent Platform Man
32. sitory Time Storage Set SDR Repository Time Storage Enter SDR Repository Update Mode Storage Exit SDR Repository Update Mode Storage Run Initialization Agent Storage 2 Only commands for reading Sensor Data Record Repository SDRR are implemented The static SDRR of the CP308 System Management Controller SMC only contains its own sensors and could not be changed Page 18 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide SEL Device Commands Get SEL Info Storage Get SEL Allocation Info Storage Reserve SEL Storage Get SEL Entry Storage Add SEL Entry i Storage 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 LAN Device Commands iki Gone E U MM Serial Modem Device Commands Ono omo Orno CO omo omo omo Omo 0mo omo omo omo O No ID 1035 8160 Rev 1 0 2009 Kontron AG Page 19 SMC Firmware User Guide r 6 2 PICMG defined OEM Commands PICMGe 3 0 Rev 3 0 with Errata Spec Table NetFn CMD CP308 Partially supported FRU Control Get FRU LED Properties Get LED Color Capabilities Set FRU LED State Get FRU LED State Set IPMB State Set FRU Activation Policy Get FRU A
33. xt boot device class 110b Next boot device class 111b Next boot device class FDD HDD CD ROM Network USB FDD USB HDD USB CD ROM Response data 1 Completion code Please note that this selection will be automatically toggled by the Management Controller during a failing boot process Other payload sided settings may also modify the uEFI BIOS bank selection a DIP switch for example Page 22 2009 Kontron AG ID 1035 8160 Rev 1 0 CP308 SMC Firmware User Guide EE The IPMB IPMI voltage observed by sensors Board SVIPMT and IPMB State is normally provided by the backplane But this is not the default option for 3U Compact PCI racks 6 3 2 2 Get Control State Get Control State Firmware Hub EFI Flash Boot 00h OEM 3Eh 21h Order IPMB Sensor Monitoring Mode Byte Data Field Request data 1 Control ID 00h EFI Flash selection 10h IPMB Sensor Monitoring Mode 9Dh EFI Boot Order Configuration Response data 1 Completion code 4 Current Control State refer to 6 3 2 1 Get Control State ID 1035 8160 Rev 1 0 O 2009 Kontron AG Page 23 SMC Firmware User Guide m 7 Board Sensors The Management Controller includes many sensors for voltage or temperature monitoring and various others for pass fail type signal monitoring CP308 Every sensor is associated with a Sensor Data Record SDR Sensor Data Records contain
Download Pdf Manuals
Related Search