Instruction Manual - English
VT1512-IP
Example 2:
Query Command Message with xid –
<?xml version="1.0" ?><device class="vt1512" id="1065a3050000">
<command xid="456"><sendinfo/></command></device>
Response Message with ack –
<?xml version="1.0" ?><device class="vt1512" id="1065a3050000">
<info>...</info><ack xid="456"></device>
3. Event Messages
Event messages are sent when a change of device status or settings occurs. The <event> element is used to contain the details of the event. Note that events are not sent in reply to a
query command.
Example Event Message - outlet 3 switched to ON:
<?xml version="1.0" ?>
<device class="vt1512" id="1065a3050000">
<event time="1403729752" evtid="123" subsid="1">
<outlet id="3">1</outlet>
</event>
</device>
Element Description
dlys required delays container.
dly outlet delays - attributes represent: "id" = outlet number, "sf" = power sequence off delay, "so" = power sequence on delay,
"cy" = power cycle delay. All delays values are in seconds, 255 seconds maximum.
grps required groups container.
sq opt-in/opt-out of sequence group: hexadecimal value represents which outlet participate in power sequence group. See above for details.
cy opt-in/opt-out of power cycle group: hexadecimal value represents which outlet participate in power cycle group. See above for details.
Outlet number Outlet group hex code Binary
Outlet
Hex
Binary
1
001
0000 0000 0001
2
002
0000 0000 0010
3
004
0000 0000 0100
4
008
0000 0000 1000
5
010
0000 0001 0000
6
020
0000 0010 0000
7
040
0000 0100 0000
8
080
0000 1000 0000
9
100
0001 0000 0000
10
200
0010 0000 0000
11
400
0100 0000 0000
12
800
1000 0000 0000
1 through 12 (i.e., all twelve outlets) fff 1111 1111 1111
1, 3, 6 and 7 (i.e., four outlets) 065 0000 0110 0101
Settings-related messages (i.e., <sendsettings> query, <set> action, and <set> event) contain the same content fragment format:
Details –
www.panamax.com
6
Common Attributes
Some message elements will include a timestamp attribute "time". The timestamp is in standard UNIX time, up to 10 decimal digit characters, and represents the number of seconds that have
passed since January 1st 1970 GMT.
Some message elements involve a group of outlets. Outlet group values are given as hexadecimal digits, representing which outlets participate in the group. A group value is encoded in a
12-bit binary bitmap, using the hexadecimal digits. To process the data it must be converted from hexadecimal to binary, where each bit represents an outlet participating in the group. Bit 0
represents outlet #1. The following table should help clarify:
<dlys>
<dly id="1" sf="12" so="1" cy="10"/>
<dly id="2" sf="11" so="2" cy="10"/>
<dly id="3" sf="10" so="3" cy="5"/>
<dly id="4" sf="9" so="4" cy="10"/>
<dly id="5" sf="8" so="5" cy="10"/>
<dly id="6" sf="7" so="6" cy="10"/>
<dly id="7" sf="6" so="7" cy="15"/>
<dly id="8" sf="5" so="8" cy="10"/>
<dly id="9" sf="4" so="9" cy="10"/>
<dly id="10" sf="3" so="10" cy="10"/>
<dly id="11" sf="2" so="11" cy="15"/>
<dly id="12" sf="1" so="12" cy="10"/>
</dlys>
<grps>
<sq>13f</sq>
<cy>f35</cy>
</grps>
Where "id" is the outlet number, "sf" is the turn off delay, "so" is the turn on delay and "cy" is the power cycle delay. The designation "sq" is the bitmap for outlets to be sequenced, and "cy"
is the bitmap for outlets to be power cycled.
Query Commands
Send Information Query
The Send Information query is used to retrieve general information about the device. Response information elements are enclosed in the <info> element.
Query –
<sendinfo/>
Sample Response –
<info time="1234567890">
<sernum>PAVT1512PRO0X142160000000</sernum>
<fwver>1.0.0.12520</fwver>
<bootcodever>1.0</bootcodever>
<ipaddr>3194548209</ipaddr>
<coprocfwver>1.0.0.12520</coprocfwver>
<coproclot>1300795003</coproclot>
<coprocdiex>5</coprocdiex>
<coprocdiey>42</coprocdiey>
<coproctest>65272</coproctest>
</info>
Details –
Element Description
sernum serial number of the product.
fwver version of firmware running on the master processor.
bootcodever version of boot loader firmware running on the master processor.
ipaddr Internet Protocol address in use, decimal value.
coprocfwver version of firmware running on the co-processor.
All other elements are for Core Brands use only.
Send Status Query
The Send Status query is used to retrieve the device status. Response status elements are enclosed in the <status> element.
Query –
<sendstatus/>
www.panamax.com
7