Wavecom W-RCI (Remote Control) V8.7.0 - Manual (Page 12)

4

XML Messages XML SDK V8.7.0 Remote Control Interface
Information messages provide information about the hardware, the software or hardware versions, the
state of the decoders, and the state and configuration of the server.
Error messages provide information about server system errors (not errors in the decoded data).
Encoding
The XML files are encoded in UTF-8, UTF-16 or Unicode.
Message template
XML header
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Message SYSTEM "RCI/1.0/DTD/WAVECOM.dtd">
Extended XML header
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Message SYSTEM "RCI/1.0/DTD/WAVECOM.dtd">
<Message version="1.0" instance="0" subinstance="0" serial-nr="0210125807" date="20050412"
time="19:45:55:367">
Content
</Message>
The XML header is not interpreted by the server and may be included or omitted. For server messages the
header is empty.
Message elements
The implied attributes instance/subinstance, serial-nr, date and time only contain a value if the ex-
tended message header is set on the server. This can be done by sending a set configuration message.
Attribute List
version
The message version is formatted as major.minor version. A server will handle all messages from a client
as long as the major versions of the server and the client are equal and the minor version of the server is
equal to or greater than the minor version of the client. This attribute is locked to the version of the DTD
in the current Wavecom DTD.
instance
subinstance
In future decoder releases multiple codes may be instantiated on a single card. This feature requires that
the server knows the destination of the message or the client knows the source of the message. These at-
tributes are implied and are not used in this release.
serial-nr
The serial number of the decoder assigned to this client. This attribute is implied and represents a string.
date
Date of message creation. This attribute is implied and represents a string. The format of date is
YYYYMMDD.
time
Time of message creation. This attribute is implied and represents a string. The format of time is
hh:mm:ss:milliseconds.
Content
The content is a choice between the Data, Metadata, Command, Information and Error elements.