HsiSetSlotPower, HsiGetSlotReset | Intel ZT 4901 guide

Slot Control API

HSI_STATUS_INVALID_PARAMETER

returned if the physical slot number does not correspond to any actual slot or if the handle is invalid

Other HSI_STATUS values

returned if other errors occurred during execution of this function

Synopsis:

This function detects the power status of the specified slot and returns it in the pPower parameter as a logical value: TRUE means the slot power is on; FALSE means the slot power is off.

9.7HsiSetSlotPower

Prototype:

HSI_STATUS

HsiSetSlotPower(

IN HSI_SLOT_CONTROL_HANDLE Handle,

IN UINT32 Slot,

IN BOOLEAN Power );

Arguments:
Handle -	The handle of the current session
Slot -	The physical slot number
Power -	The new power state for the slot: TRUE means ON, FALSE means OFF
Return Value:

HSI_STATUS_SUCCESS

if successful

HSI_STATUS_INVALID_PARAMETER

returned if the physical slot number does not correspond to any actual slot or if the handle is invalid

Other HSI_STATUS values

returned if other errors occurred during execution of this function

Synopsis:

This function enables or disables power for the specified slot. The new power state of the slot is specified by the value of the parameter Power: TRUE means switch the power on; FALSE means switch the power off.

9.8HsiGetSlotReset

Prototype:

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

89

Image 89

Intel ZT 4901 manual HsiSetSlotPower, HsiGetSlotReset

Contents

Intel NetStructureTM ZT 4901 High Availability Software Technical Product SpecificationPage Contents Hot Swap API Demonstration Utilities Tables Figures Date Revision Description Revision History This page intentionally left blank Document Organization Document Organization Following terms are commonly used in this document IntroductionTerminology Introduction Introduction High Availability Hardware Approach CIC Processor BoardsPCI Bridge Mezzanine RSS Processor Board Block Diagram Backplane RSS Host with Bridge Mezzanine Block Diagram Host application System Management Backplane Device Drivers High-Availability Software ApproachHost Application System Management Backplane Device Drivers Host Application Software ServiceabilityGoals of the Host Application Portability Host Application Software Division of Labor Development Issues Code Modularity Graceful SwitchoverHardened Applications Ipmi API System ManagementRedundant Host API Baseboard Management Controller Firmware Enhancements Fault ConfigurationHot Swap API Slot Control API Channel Definitions for ZT Isolation Strategies RH Channel Get RH BMC Address Ipmi RH Channel CommandsRH Channel Enabled Request Response This page intentionally left blank Device Driver Design High Availability CompactPCI Device Drivers Initialization Device Driver StatesQuiesced Activation Find Adding High-Availability FunctionalityDevice Removed Resume Operations Add Device Driver Synchronization Suspend OperationsRemove Device Summary Redundant Host API RhGetHwDestinationHostAndResetIntel-Specific APIs RhSetHostName Redundant Host API Redundant Host PICMG* 2.12 APIsHsistatussuccess Hsistatusinvalidparameter Following topics specify each of the interface functions Definitions and Types Minoralarm Majoralarm Criticalalarm Rhalarmseverity RESETREQUIRED, Resetnotrequired Unknown Rhslotneedsreset RhEnumerateInstances Initialization/TerminationHsistatusno Datadetected Hsistatusinsufficientbuffer RhOpen Char *InstanceId Optional OUT Rhhandle *pHandle RhOpenInstanceId RhEnumerateInstances RhGetInstanceID RhCloseRhClose in Rhhandle Handle Handle Domain and Host Information API Handle Handle of the current session PInstanceIDRhGetDomainCount RhGetDomainCount Rhhandle Handle OUT uint32 *pCount System RhGetDomainNumbersHandle Handle of the current session PCount RhGetDomainSlotPath RhGetDomainOwnership SlotPathLength Domain is written as a null-terminated stringCharacter HSISTATUSINSUFFICIENTBUFFER, this is the minimum Is placed RhGetDomainSlotCountRhGetDomainSlots RhGetSlotDomain RhGetCurrentHostNumber Rhhandle Handle OUT uint32 *pHost RhGetCurrentHostNumberRhGetHostCount Handle Handle of the current session PHostCount RhGetHostNumbersRhGetHostCount Rhhandle Handle OUT uint32 *pHostCount RhGetHostName False RhSetHostAvailability RhGetHostAvailability RhGetPhysicalSlotInformation Slot Information APIRhGetDomainAvailabilityToHost If the specified slot is empty HsinosuchdeviceRhslotdescriptor Devices directly placed in the physical slots SlotPath RhGetSlotChildInformation+ FunctionNumber for the corresponding PCI-PCI bridge By two characters from the set ‘0’..’9’, ‘A’..’F’ If there are no child devices below the specified bridge Handle Handle of the current session PhysSlot PCI buses in the system Switchover Scenarios and Theory of Operation Switchover API Partially Cooperative Switchover Hostile Switchover RhPrepareForSwitchover Hsistatusrequestdenied Hsistatussuccess returned in the case of success RhCancelPrepareForSwitchover RhGetDomainSwConnectionStatus Invalid session handle or the specified slot does not exist RhPerformSwitchoverRhGetSlotSwConnectionStatus Handle Handle of the current session DestinationHost RhSetHwDestinationHostValue Rhnodestinationhost means no host should own Specified domains Rhnodestinationhost means no host owns the domains RhGetHwDestinationHost Notification, Reporting and AlarmsRhEnableDomainStateNotification During software connection and disconnection RhEnableSwitchoverNotificationDisconnecting Switchovers in which it participates RhEnableSwitchoverRequestNotification RhEnableUnsafeSwitchoverNotification Indicates is the depth of the device below the physical slot Device in unsafe state RhDisableNotification Handle Handle of the current session NotificationType Hot Swap API Hot Swap API ImbDeviceIoControl ImbOpenDriverImbCloseDriver Lpvoid ImbSendTimedI2cRequestDword Lpdword Accesnstatus ImbSendIpmiRequestImbGetAsyncMessage ImbRegisterForAsyncMsgNotification ImbIsAsyncMessageAvailableImbUnregisterForAsyncMsgNotification EventId EventID handle returned once registered ImbSetLocalBmcAddr ImbGetLocalBmcAddr Byte imbGetIpmiVersion ImbGetIpmiVersionByte Current determined Ipmi version HsiOpenSlotControl Slot Control APIHsiCloseSlotControl Hsistatusnomemory Slot Control API HsiGetSlotCountHsiGetBoardPresent Hsistatusnodatadetected HsiGetBoardHealthy Healthy HsiGetSlotPower HsiGetSlotReset HsiSetSlotPower Slot Physical slot number HsiSetSlotResetHsistatusnotimplemented Hsiapidef Hsistatus HsiGetSlotM66EnableFalse 66 MHz operation is not enabled for the slot HsiSetSlotM66Enable Handle Handle of the current session Callback HsiSetSlotEventCallbackFunction Returned if the arguments or handle is invalid Hsisloteventinfo Void *HSISLOTEVENTCALLBACKHsisloteventinfostruct Functional Description Demonstration UtilitiesUser Interface RH Interface Software Initiated Handovers Multiple Mode CapabilitiesHardware Initiated Failovers Demonstration Utilities Notification, Reporting and Alarms Switchover FunctionsHost Domain Enumeration and Association Slot Information Isolation Strategy Fault ConfigurationIpmi Interface HS Functional Description Hot Swap Interface PCI Tree Information Retrieval Flags Slot Information Structure Slot State Slot Control Interface Demonstration Utilities Linux Software InstallationInstalling the Redundant Host Software Kit Source Installation Installing RH Source RPMPatching and Rebuilding an RH-Enabled Kernel Software Installation Making RH Configuration Changes Configuring the Redundant Host Infrastructure1 /lib/modules/priBptd.o 2 /lib/modules/slotcntrl.o 4 /CompactPCI-RH-1.0/app/bin VxWorks Tornado II Setup3 /CompactPCI-RH-1.0/app/lib RedundantHostFunctionReturnValuesB Redundant Host Function Return Values Hsistatusnosysrhtablefound Hsistatusnosuchbridge Hsistatusnotready HsistatusnotavailibleHsistatusobjectdoesnotexist Hsistatusoperationaborted Hsistatusunsuccessfultranslation HsistatusunabletosendpacketHsistatusunsupportedplatform Hsistatusuptinsertionfailed This page intentionally left blank HSK Driver Object Declaration HSK Device Driver Interface for VxWorks HSK Device Driver Interface for VxWorks HSK Device Information Structure Compatlistcheckdevice HSK Driver Instantiation Code Segment Prhdeviceobj AddDevice Redundant Host-Aware Callback Definitions Hsistatus StopDevice Hsistatus StartDevicePrhdeviceobj deviceobject Hsistatussuccess if successful otherwise Hsistatusfailure Hsistatus SurpriseRemoval Hsistatus RemoveDevice Hsistatus rhHskRegisterMsgCallback RH-Aware Message Registration Definitions Pcilocation pci Process Packet Callback DefinitionInt rhHskUnregisterMsgCallback Hsistatus rhHskSendMessage RH-Aware Send Message DefinitionUINT8* pBuf, int iLen, Pvoid pContext Length in bytes of the data packet being sent PPackett Alternate Hscsr Interfaces RH Device Driver Interface for Linux RH Device Driver Interface for Linux Non Bus Mastering Peripheral Design Guideline for Peripheral VendorsEBus Mastering DMA Capable Peripheral Support for Unmodified Standard Drivers Design Guideline for Peripheral Vendors Category ZT 5550 Functions Redundant Host Functions Porting ZT 5550 HA Applications to Picmg HAGetEthernetRo Porting ZT 5550 HA Applications to PicmgUting HASetEthernetRou RH Switchover on OS Crash RH Switchover on OS Crash CompactPCI Data Sheet ReferenceUser Documentation VxWorks Wind River* VxWorks Programmer’s Guide is available at Data Sheet Reference Impi Index Ipmi API Page This page intentionally left blank