Manuals / Intel / Computer Equipment / Network Router

Intel ZT 4901 manual Slot Information Structure, PCI Tree Information Retrieval Flags

Models: ZT 4901

1 136

Download 136 pages 35.65 Kb

Page 100

Demonstration Utilities

Table 3. PCI Tree Information Retrieval Flags

Flags	Meanings

PRES	Device is present.

CONN	Device is software connected.

CONF	Device’s software connection failed.

The following information is displayed:

•Slot path

•Vendor ID

•Device ID

•SubsystemVendor ID

•SubsystemDevice ID

•Class code D

•Sub class code

•Programming interface

•Header type

•Flag

10.1.4.1.5Catching and Printing Notification Messages

This demo application covers the capability of catching and printing notification messages sent by

HSSD when an event is triggered. The following event types are supported. The flags supported are defined in the “Event Notification” topic of the Intel® NetStructureTM Hot Swap Kit for Linux 4.2 software manual. For details on obtaining this manual, see Section H.2, “User Documentation” on page 131.

Table 4. Events that Generate Notification Messages

Event types	Meanings

EXTR REQ	Device extraction request.

EXTR CONF	Device extraction confirmed.

REMOVAL	Device removed.

INSERTION	Device inserted.

10.1.4.2Slot Information Structure

The slot information structure contains information about a specific slot, identified by a slot path. It includes the following pieces of information:

•Path to the slot

•Current bus number, slot number and function number of the slot

•Physical slot number

•Physical slot depth

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

Image 100

Intel ZT 4901 manual Slot Information Structure, PCI Tree Information Retrieval Flags

Contents

Technical Product Specification Intel NetStructureTM ZT 4901 High Availability SoftwarePage Contents Hot Swap API Demonstration Utilities Figures TablesRevision History Date Revision DescriptionThis 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 MezzanineRSS Host with Bridge Mezzanine Block Diagram BackplaneHost Application High-Availability Software ApproachHost application System Management Backplane Device Drivers System Management Backplane Device Drivers Serviceability Host Application SoftwareGoals of the Host Application PortabilityDivision of Labor Host Application SoftwareDevelopment Issues Hardened Applications Graceful SwitchoverCode Modularity Redundant Host API System ManagementIpmi API Fault Configuration Baseboard Management Controller Firmware EnhancementsHot Swap API Slot Control APIIsolation Strategies Channel Definitions for ZTRH 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 DesignDevice Driver States InitializationQuiesced ActivationAdding High-Availability Functionality FindDevice RemovedAdd Device Resume OperationsRemove Device Suspend OperationsDriver Synchronization Summary RhGetHwDestinationHostAndReset Redundant Host APIIntel-Specific APIs RhSetHostNameRedundant Host PICMG* 2.12 APIs Redundant Host APIHsistatussuccess HsistatusinvalidparameterDefinitions and Types Following topics specify each of the interface functionsMinoralarm Majoralarm Criticalalarm Rhalarmseverity RESETREQUIRED, Resetnotrequired Unknown Rhslotneedsreset Initialization/Termination RhEnumerateInstancesHsistatusno Datadetected HsistatusinsufficientbufferRhOpen RhOpen Char *InstanceId Optional OUT Rhhandle *pHandleInstanceId RhEnumerateInstancesRhClose RhGetInstanceIDRhClose in Rhhandle Handle HandleHandle Handle of the current session PInstanceID Domain and Host Information APIRhGetDomainCount RhGetDomainCount Rhhandle Handle OUT uint32 *pCountHandle Handle of the current session PCount RhGetDomainNumbersSystem RhGetDomainOwnership RhGetDomainSlotPathDomain is written as a null-terminated string SlotPathLengthCharacter HSISTATUSINSUFFICIENTBUFFER, this is the minimumRhGetDomainSlots 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 FalseRhGetHostAvailability RhGetDomainAvailabilityToHost Slot Information APIRhGetPhysicalSlotInformation Hsinosuchdevice If the specified slot is emptyRhslotdescriptor Devices directly placed in the physical slotsRhGetSlotChildInformation 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 bridgePCI buses in the system Switchover API Switchover Scenarios and Theory of OperationPartially Cooperative Switchover RhPrepareForSwitchover Hostile SwitchoverHsistatusrequestdenied RhCancelPrepareForSwitchover Hsistatussuccess returned in the case of successRhGetDomainSwConnectionStatus 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 domainsRhnodestinationhost means no host owns the domains RhEnableDomainStateNotification Notification, Reporting and AlarmsRhGetHwDestinationHost Disconnecting RhEnableSwitchoverNotificationDuring software connection and disconnection RhEnableSwitchoverRequestNotification Switchovers in which it participatesRhEnableUnsafeSwitchoverNotification Device in unsafe state Indicates is the depth of the device below the physical slotRhDisableNotification Handle Handle of the current session NotificationType Hot Swap API Hot Swap API ImbCloseDriver ImbOpenDriverImbDeviceIoControl ImbSendTimedI2cRequest LpvoidDword LpdwordImbGetAsyncMessage ImbSendIpmiRequestAccesnstatus ImbIsAsyncMessageAvailable ImbRegisterForAsyncMsgNotificationImbUnregisterForAsyncMsgNotification EventId EventID handle returned once registeredImbGetLocalBmcAddr ImbSetLocalBmcAddrImbGetIpmiVersion Byte imbGetIpmiVersionByte Current determined Ipmi versionSlot Control API HsiOpenSlotControlHsiCloseSlotControl HsistatusnomemoryHsiGetBoardPresent HsiGetSlotCountSlot Control API HsiGetBoardHealthy HsistatusnodatadetectedHsiGetSlotPower HealthyHsiSetSlotPower HsiGetSlotResetHsistatusnotimplemented 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 invalidHsisloteventinfostruct Void *HSISLOTEVENTCALLBACKHsisloteventinfo Demonstration Utilities Functional DescriptionUser Interface RH InterfaceMultiple Mode Capabilities Software Initiated HandoversHardware Initiated Failovers Demonstration UtilitiesSwitchover Functions Notification, Reporting and AlarmsHost Domain Enumeration and Association Slot InformationIpmi Interface Fault ConfigurationIsolation Strategy Hot Swap Interface HS Functional DescriptionSlot Information Structure PCI Tree Information Retrieval FlagsSlot Control Interface Slot StateDemonstration Utilities Installing the Redundant Host Software Kit Software InstallationLinux Installing RH Source RPM Source InstallationPatching and Rebuilding an RH-Enabled Kernel Software InstallationConfiguring the Redundant Host Infrastructure Making RH Configuration Changes1 /lib/modules/priBptd.o 2 /lib/modules/slotcntrl.o3 /CompactPCI-RH-1.0/app/lib VxWorks Tornado II Setup4 /CompactPCI-RH-1.0/app/bin RedundantHostFunctionReturnValuesB Redundant Host Function Return Values Hsistatusnosuchbridge HsistatusnosysrhtablefoundHsistatusnotavailible HsistatusnotreadyHsistatusobjectdoesnotexist HsistatusoperationabortedHsistatusunabletosendpacket HsistatusunsuccessfultranslationHsistatusunsupportedplatform HsistatusuptinsertionfailedThis page intentionally left blank HSK Device Driver Interface for VxWorks HSK Driver Object DeclarationHSK Device Information Structure HSK Device Driver Interface for VxWorksHSK Driver Instantiation Code Segment CompatlistcheckdeviceRedundant Host-Aware Callback Definitions Prhdeviceobj AddDeviceHsistatus StartDevice Hsistatus StopDevicePrhdeviceobj deviceobject Hsistatussuccess if successful otherwise HsistatusfailureHsistatus RemoveDevice Hsistatus SurpriseRemovalRH-Aware Message Registration Definitions Hsistatus rhHskRegisterMsgCallbackInt 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 sentAlternate Hscsr Interfaces PPackettRH 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 DriversDesign Guideline for Peripheral Vendors Porting ZT 5550 HA Applications to Picmg Category ZT 5550 Functions Redundant Host FunctionsPorting ZT 5550 HA Applications to Picmg HAGetEthernetRoUting HASetEthernetRouRH Switchover on OS Crash RH Switchover on OS Crash Data Sheet Reference CompactPCIUser Documentation VxWorks Wind River* VxWorks Programmer’s Guide is available atData Sheet Reference Index ImpiIpmi API Page This page intentionally left blank