Ipmi RH Channel Commands, RH Channel Enabled | Intel ZT 4901

System Management

Table 2. RH Channel Alert Destinations

Destination #	Description

0x00	RESERVED

0x01	RH_CHAN_SET_ALL_MC_FD (Sets CIC Fault Detection Lines)

0x02	RH_CHAN_CLEAR_ALL_MC_FD (Clears CIC Fault Detection Lines)

The RH channel acts as a virtual channel that can respond to Alert Actions. This channel supports IPMI commands like Alert Immediate:

•In the Alert Policy Table: Create an entry with a unique policy number, channel specified as RH, destination specified as RH_CHAN_SET_ALL_MC_FD.

•In the Platform Event Filter Table: Create an entry with the Alert action selected, Alert Policy Number defined as above, and the data mask specified based on the sensor thresholds to be triggered.

4.2.3IPMI RH Channel Commands

The following RH commands are present in the ZT 5524 processor board BMC firmware. These are accessible only by sending the selected command/net function to the RH channel (0x05)

4.2.3.1RH Channel Enabled

This IPMI command returns whether the board has RH features enabled or not. Conditions for non- RH operation are: No IOX presence or the board is in a non-RH capable slot. Standard IPMI completion codes are returned.

IPMI Command: RH_CHAN_ENABLED (0x00)

Net Function: INTEL_RH_SPECIFIC_REQUEST (0x36)

ByteData Fields

Request	-	-

Response	1	Completion Code

	2	1h	=	RSS	enabled
		0h	=	RSS	disabled

4.2.3.2RH Channel Get RH BMC Address

This command gets the IPMB 1 address of the redundant host’s BMC. Standard IPMI completion codes are returned.

IPMI Command: RH_CHAN_GET_RH_BMC_ADDR (0x05)

Net Function: INTEL_RH_SPECIFIC_REQUEST (0x36)

ByteData Fields

28	High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification

Image 28

Intel ZT 4901 manual Ipmi RH Channel Commands, RH Channel Enabled, RH Channel Get RH BMC Address

Contents

Technical Product Specification Intel NetStructureTM ZT 4901 High Availability SoftwarePage Contents Hot Swap API Demonstration Utilities Figures Tables Revision History Date Revision Description This page intentionally left blank Document Organization Document Organization Terminology IntroductionFollowing terms are commonly used in this document Introduction Introduction High Availability Hardware Approach PCI Processor BoardsCIC RSS Processor Board Block Diagram Bridge Mezzanine RSS Host with Bridge Mezzanine Block Diagram Backplane Host Application High-Availability Software ApproachHost application System Management Backplane Device Drivers System Management Backplane Device Drivers Serviceability Host Application SoftwareGoals of the Host Application Portability Division of Labor Host Application Software Development Issues Hardened Applications Graceful SwitchoverCode Modularity Redundant Host API System ManagementIpmi API Fault Configuration Baseboard Management Controller Firmware EnhancementsHot Swap API Slot Control API Isolation Strategies Channel Definitions for ZT RH Channel Enabled Ipmi RH Channel CommandsRH Channel Get RH BMC Address Request Response This page intentionally left blank High Availability CompactPCI Device Drivers Device Driver Design Device Driver States InitializationQuiesced Activation Adding High-Availability Functionality FindDevice Removed Add Device Resume Operations Remove Device Suspend OperationsDriver Synchronization Summary RhGetHwDestinationHostAndReset Redundant Host APIIntel-Specific APIs RhSetHostName Redundant Host PICMG* 2.12 APIs Redundant Host APIHsistatussuccess Hsistatusinvalidparameter Definitions and Types Following topics specify each of the interface functions Minoralarm Majoralarm Criticalalarm Rhalarmseverity RESETREQUIRED, Resetnotrequired Unknown Rhslotneedsreset Initialization/Termination RhEnumerateInstancesHsistatusno Datadetected Hsistatusinsufficientbuffer RhOpen RhOpen Char *InstanceId Optional OUT Rhhandle *pHandleInstanceId RhEnumerateInstances RhClose RhGetInstanceIDRhClose in Rhhandle Handle Handle Handle Handle of the current session PInstanceID Domain and Host Information APIRhGetDomainCount RhGetDomainCount Rhhandle Handle OUT uint32 *pCount Handle Handle of the current session PCount RhGetDomainNumbersSystem RhGetDomainOwnership RhGetDomainSlotPath Domain is written as a null-terminated string SlotPathLengthCharacter HSISTATUSINSUFFICIENTBUFFER, this is the minimum RhGetDomainSlots RhGetDomainSlotCountIs placed RhGetSlotDomain RhGetHostCount RhGetCurrentHostNumberRhGetCurrentHostNumber Rhhandle Handle OUT uint32 *pHost RhGetHostCount Rhhandle Handle OUT uint32 *pHostCount RhGetHostNumbersHandle Handle of the current session PHostCount RhGetHostName RhSetHostAvailability False RhGetHostAvailability RhGetDomainAvailabilityToHost Slot Information APIRhGetPhysicalSlotInformation Hsinosuchdevice If the specified slot is emptyRhslotdescriptor Devices directly placed in the physical slots RhGetSlotChildInformation SlotPath+ FunctionNumber for the corresponding PCI-PCI bridge By two characters from the set ‘0’..’9’, ‘A’..’F’ Handle Handle of the current session PhysSlot If there are no child devices below the specified bridge PCI buses in the system Switchover API Switchover Scenarios and Theory of Operation Partially Cooperative Switchover RhPrepareForSwitchover Hostile Switchover Hsistatusrequestdenied RhCancelPrepareForSwitchover Hsistatussuccess returned in the case of success RhGetDomainSwConnectionStatus RhGetSlotSwConnectionStatus RhPerformSwitchoverInvalid session handle or the specified slot does not exist RhSetHwDestinationHost Handle Handle of the current session DestinationHostValue Rhnodestinationhost means no host should own Specified domains Rhnodestinationhost means no host owns the domains RhEnableDomainStateNotification Notification, Reporting and AlarmsRhGetHwDestinationHost Disconnecting RhEnableSwitchoverNotificationDuring software connection and disconnection RhEnableSwitchoverRequestNotification Switchovers in which it participates RhEnableUnsafeSwitchoverNotification Device in unsafe state Indicates is the depth of the device below the physical slot RhDisableNotification Handle Handle of the current session NotificationType Hot Swap API Hot Swap API ImbCloseDriver ImbOpenDriverImbDeviceIoControl ImbSendTimedI2cRequest LpvoidDword Lpdword ImbGetAsyncMessage ImbSendIpmiRequestAccesnstatus ImbIsAsyncMessageAvailable ImbRegisterForAsyncMsgNotificationImbUnregisterForAsyncMsgNotification EventId EventID handle returned once registered ImbGetLocalBmcAddr ImbSetLocalBmcAddr ImbGetIpmiVersion Byte imbGetIpmiVersionByte Current determined Ipmi version Slot Control API HsiOpenSlotControlHsiCloseSlotControl Hsistatusnomemory HsiGetBoardPresent HsiGetSlotCountSlot Control API HsiGetBoardHealthy Hsistatusnodatadetected HsiGetSlotPower Healthy HsiSetSlotPower HsiGetSlotReset Hsistatusnotimplemented HsiSetSlotResetSlot Physical slot number False 66 MHz operation is not enabled for the slot HsiGetSlotM66EnableHsiapidef Hsistatus HsiSetSlotM66Enable HsiSetSlotEventCallback Handle Handle of the current session CallbackFunction Returned if the arguments or handle is invalid Hsisloteventinfostruct Void *HSISLOTEVENTCALLBACKHsisloteventinfo Demonstration Utilities Functional DescriptionUser Interface RH Interface Multiple Mode Capabilities Software Initiated HandoversHardware Initiated Failovers Demonstration Utilities Switchover Functions Notification, Reporting and AlarmsHost Domain Enumeration and Association Slot Information Ipmi Interface Fault ConfigurationIsolation Strategy Hot Swap Interface HS Functional Description Slot Information Structure PCI Tree Information Retrieval Flags Slot Control Interface Slot State Demonstration Utilities Installing the Redundant Host Software Kit Software InstallationLinux Installing RH Source RPM Source InstallationPatching and Rebuilding an RH-Enabled Kernel Software Installation Configuring the Redundant Host Infrastructure Making RH Configuration Changes1 /lib/modules/priBptd.o 2 /lib/modules/slotcntrl.o 3 /CompactPCI-RH-1.0/app/lib VxWorks Tornado II Setup4 /CompactPCI-RH-1.0/app/bin RedundantHostFunctionReturnValuesB Redundant Host Function Return Values Hsistatusnosuchbridge Hsistatusnosysrhtablefound Hsistatusnotavailible HsistatusnotreadyHsistatusobjectdoesnotexist Hsistatusoperationaborted Hsistatusunabletosendpacket HsistatusunsuccessfultranslationHsistatusunsupportedplatform Hsistatusuptinsertionfailed This page intentionally left blank HSK Device Driver Interface for VxWorks HSK Driver Object Declaration HSK Device Information Structure HSK Device Driver Interface for VxWorks HSK Driver Instantiation Code Segment Compatlistcheckdevice Redundant Host-Aware Callback Definitions Prhdeviceobj AddDevice Hsistatus StartDevice Hsistatus StopDevicePrhdeviceobj deviceobject Hsistatussuccess if successful otherwise Hsistatusfailure Hsistatus RemoveDevice Hsistatus SurpriseRemoval RH-Aware Message Registration Definitions Hsistatus rhHskRegisterMsgCallback Int rhHskUnregisterMsgCallback Process Packet Callback DefinitionPcilocation pci RH-Aware Send Message Definition Hsistatus rhHskSendMessageUINT8* pBuf, int iLen, Pvoid pContext Length in bytes of the data packet being sent Alternate Hscsr Interfaces PPackett RH Device Driver Interface for Linux RH Device Driver Interface for Linux Design Guideline for Peripheral VendorsE Non Bus Mastering PeripheralBus Mastering DMA Capable Peripheral Support for Unmodified Standard Drivers Design Guideline for Peripheral Vendors Porting ZT 5550 HA Applications to Picmg Category ZT 5550 Functions Redundant Host Functions Porting ZT 5550 HA Applications to Picmg HAGetEthernetRoUting HASetEthernetRou RH Switchover on OS Crash RH Switchover on OS Crash Data Sheet Reference CompactPCIUser Documentation VxWorks Wind River* VxWorks Programmer’s Guide is available at Data Sheet Reference Index Impi Ipmi API Page This page intentionally left blank