Parker PHD28, User Manual, Page: 89 / 157

11
Version supervisor events
2 Application Programming Interface (API)
PHD API Reference
Version
Event
version
Event Data
Keys Values Description
count
<0..100> Number of version items in message.
partnumX
<0..4294967295> Software part number for entry X.
nameX
<string> Software name for entry X.
majorX
<0..4294967295> Software major version number for entry X.
minorX
<0..4294967295> Software minor version number for entry X.
Direction
input
Channel
version
Notes
Received by the application when subscribed to.
The
version
event contains count version items, each consisting of the four keys,
partnumX
,
nameX
,
majorX
and
minorX
, where X is a number from 0 to count.
The example below assumes the Storyboard application is set up to call Lua function
version_receive when the
version
event occurs. Event data is available through the
mapargs
argument. Note that Lua "for loops" are inclusive, so the example below is
written to loop from 0 through count -1.
Lua Example function version_receive ( mapargs )
local ev = mapargs .context_event_data
local count = ev [" count "] - 1
local i
for i = 0 ,count do
print (" Name: ". . ev[ " name ".. i ])
print (" Part number: ". . ev[ " partnum ".. i ])
print (" Version: V ".. ev [" major ".. i ].."."..
string .format(" %02d ", ev [" minor ".. i ]))
end
-- Input validation of partnumX against nil left as an exercise
end