Specifications

1
Introduction
11
Firmware tools
Radisysprovidesfirmwar etoolsthatinteractdirectlywiththehardwaretoperformsoftware
managementoperations.ThefirmwaretoolsareLinux‐basedandincludeasetofcommands
forperforminglowleveloperationssuchascheckingfortheversionsofinstalledfirmware,
updatingtheflashbanks,andverifyingtheimages.Thesetoolstypicallyrunlocallyonthe
localmanagementprocessor,butsomeofthetoolsmaybeabletoperformtheiroperations
remotely.Fordescriptionsofthefirmwaretoolsandtheassociatedentities,seetheATCA
SoftwareGuide.
Programmable devices
Theprogrammabledevicesarethephysicalhardwaredevicesthatcontainthestored
programs.Eachhardwaremodulehasanumberofprogrammabledevicesmodeledas
upgradeablesoftwareentities.Theseentitiesrepresentthesoftwarethatexistsonnon‐
volatileprogrammabledevices,suchasFlashandEEPROM,andonlogicdevices,suchasFPGA
andCPLD.
Upgrade campaign configuration file
Theupgradecampaignconfigurationfileisthefilewheretheparametersfortheupdateare
set.Thefileisusedbythersys_swmutilityindeterminingwhichmodulesandcomponents
areupdatedandinwhatordertheupdatestak eplace.Fordetailsonpreparingthefile,see
Step6:Definetheupgradecampaignconfigurationfileonpage 26.
rsys_swm utility
Thersys_swmutilityisafully‐featuredutilityprovidedwiththesourcecodethatyoucanuse
toex ecuteanautomaticupgradecampaignviatheSMF.Youcanalsousetheutilityforissuing
commandlineinterface(CLI)commandsthatinvokeSMFoperationsattheshelformodule
level.
ThisupgradeutilityoperatesasbothanHPIandanSMFapplicationusingboththeHPIClient
LibraryandtheSML.Theupgrade‐specificoperationsdescribedinthisdocumentare
performedusingtheSMLAPIsRSYS_SMLInfoGet()andRSYS_SmlUpgrade().SeeStep7:
Runningthersys_swmutilityforinstructionsusingthersys_swmutilitytoperformupgrades.