Specifications

4
Changing Shelf Settings Using HPI
63
Using the example HPI application (hpiapp)
RadisysprovidesanexampleHPIapplication,hpiapp,thatiscompliantwiththeSAFHPI
Specification.YoucanuseittoperformtasksandasanexamplewhenwritingyourownHPI
applications.
Important:
•Donotcallthehpiappexampleapplicationprogrammatically.Itisanexampleonlyandis
notintendedforuseinhighavailabilityapplications.
•DonotusethesaHPIResourceResetStateSet()functiontoresetAMCsinstalledinan
ATCA‐1200module.ThefunctionusesthePICMG“FRUControl”command,whichwill
performacoldresetandcausetheentireATCA‐1200moduletoreset.
Thefollowingdescribeshpiapp:
•Pre‐compiledbinaryisincludedinthemodulesoftwareimagefortheconvenienceof
developersandprovidesmenusforexecutingallHPIAPIcallsdefinedintheHPI
specification.
•Sourcecodeisprovidedinatarformatthatyoucandecompress.UsethestandardGNU
auto‐configureandauto‐makeprocessestobuild it.
•CanberuneitherremotelyorlocallyandlinkswiththeHPIclientlibrary(HCL)tointerface
withtheHPIserverrunningwiththeShelfManager.
AREADMEfileprovidedwithhpiappintheHCLsourcepackageexplainsindetailthebuild
procedureandhowtoruniteitherlocallyorremotely.Thehpiappsourceprovidesan
exampleofhowtocallmostHPIfunctions.