4: Configuration Using XML
XPort Pro™ Command Reference
66
The start tag consists of a name surrounded by angle brackets, like
<configrecord>
.
The end tag consists of the same name surrounded by angle brackets, but with a
forward slash preceding the name, like
</configrecord>
.
The element content is everything that appears between the start tag and end tag,
including text and other (child) elements.
In addition to content, an element can contain attributes—name-value pairs included in
the start tag after the element name.
Attribute values must always be quoted, using single or double quotes.
Each attribute name should appear only once in an element.
The Evolution OS™ uses the following attributes to label the group configuration settings.
Record, Group, Item, and Value Tags
A <configgroup> is a logical grouping of configuration parameters and must contain one
or more <configitem> elements. It must have a name attribute and may have an instance
attribute.
A <configitem> is a specific grouping of configuration parameters relevant to its parent
group. An item takes the name attribute and must contain one or more value elements.
For example, the line group might have parameters such as baud rate, data bits, and
parity.
A value may specify the value of a configuration parameter. It may take the name
attribute. In our example, a value of 9600 might be specified for baud rate; 7 may be
specified for data bits, and even may be specified for parity.
A name attribute identifies the group, item, or value. It is always quoted (as are all
XML attributes). For example, a group that contains serial port parameters has the
name “line”.
An instance attribute identifies which of several instances is being addressed. It is
always quoted. For example, the serial port name has the instance “1” to indicate
serial port 1 or “2” to specify serial port 2.
The following figures show examples of XML configuration records and the use of the
<configrecord>, <configgroup>, <configitem>, and <value> XML elements.
Figure 4-3. XML Group Example
<?xml version=”1.0” standalone=”yes”?>
<configrecord>
<configgroup name = “serial command mode” instance = “1”>
<configitem name = “mode”>
<value>disable</value>
</configitem>
</configgroup>