Artesyn System Management Interface Based on HPI-B 2.0(Centellis 4620/4440) User's Guide (June 2014) - Manual (Page 41)

Using HPI-B
System Management Interface Based on BBS HPI-B 2.0 (Centellis 4620/4440) User’s Guide (6806800P21D) 41
Any FRUs available in a shelf are represented as HPI resources together with Resource Data
Records (RDRs) corresponding to that FRU. Whenever a FRU is added to or removed from a
shelf, the corresponding HPI resource/RDR is added/removed from the HPI domain.
4.4.2 Accessing HPI Domains
In order to access an HPI domain, you must open a session via the HPI call
saHpiSessionOpen()
and provide as first parameter the domain ID of the corresponding
HPI domain. How to obtain the domain ID is described later within this section about the
multishelf HPI library.
If you want to access several shelves, then you need to open several sessions simultaneously,
one session for each HPI domain which represents a shelf. It is also possible to open several
sessions for one HPI domain/shelf only as well.
When the connection to a shelf is lost, all running HPI calls which access the corresponding
domain return immediately with the error code SA_HPI_ERR_NO_RESPONSE. All open
sessions for the affected domain are automatically closed by the multishelf library. In the
meantime, the library tries to regain access to the shelf. As soon as the connection is
reestablished, the domain is recreated and the application can open another session and
access the domain again. Whenever a domain is created or removed, an HPI event from the HPI
Communication State sensor is generated in the default domain (see
Connection State Sensor
on page 47 and HPI Domain Events on page 48 ).
HPI events are handled domain wide. This means that HPI events from a shelf or FRUs in that
shelf are only visible and can only be received within the session that corresponds to that
domain.
4.4.3 How Domains and Shelves are Represented
As previously mentioned, each HPI implementation has at least the default domain. It has the
ID 0 assigned to it.
Starting with HPI-B, the default domain contains a Domain Reference Table, which contains
references to all related domains and may be used by applications for discovery of available
domains in the current configuration. For more information about the Domain Reference
Table, refer to the HPI-B specification document of the SAI-HPI-B.02.01 standard.