Controlling the central power supply via XML
14
· G&D MultiPower-12-NT
Controlling the central power supply via
XML
XML enables you to control the central power supply using third-party devices (e.g.
AMX® and Crestron®). The central power supply uses the Ethernet interface to
process any XML commands received from third-party devices.
Structure of a valid XML document
Any commands are transmitted as XML documents to the G&D device. Valid
XML documents start with an optional, standardised header. On the top level, they
are included in a
<root>
tag:
The commands to be executed are placed between the start and end tag (
root
). The
commands are described on page 21.
Selecting devices
The XML API lets you specify devices not only by their ID, but also by their name.
Use the attribute
type
to select devices via ID (
"id")
or via name (
"name"
). The attribute
is supported by all commands referring to named devices.
STRUCTURE OF A VALID XML DOCUMENT
<?xml version="1.0" encoding="utf-8"?>
<!-- optional header -->
<root>
<!-- start tag of the document -->
</root>
<!-- end tag of the document -->
ADVICE:
Using an attribute is optional. If you do
not
use an attribute, devices are
identified by their ID.
ADDRESSING THE CENTRAL POWER SUPPLY BY NAME
<?xml version="1.0" encoding="utf-8"?>
<root>
<powerupoutlet>
<MultiPowerSwitch type="name">MultiPower-NT</MultiPowerSwitch>
<Outlet>1</Outlet>
</powerupoutlet>
</root>
