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

XML SDK V8.7.0 Remote Control Interface Data messages

5
Data messages
Main data message tag
<Message version="1.0">
<Data>
Content
</Data>
</Message>
Data element
Content
The content is a choice between one or more of the Binary, Text, Graphic and Result elements.
Binary data messages
Binary element
<Message version="1.0">
<Data>
<Binary encoding=”base64” bit-count="0">
Content
</Binary>
</Data>
</Message>
Attribute List
encoding
Indicates how the content is encoded. This attribute is required and may assume the values “base2”,
“base16”, “base64” or “base64-mime”. The difference between “base64” and “base64-mime” is the way
the encoded string is terminated. Both encodings use the same character set, but “base64-mime” follows
the specification for SMTP messages and aligns the string to four characters and fills unused positions with
the padding character “=”, whereas “base64” reduces the number of characters to just the ones required,
depending on the bit count.
bit-count
Indicates the number of bits transferred excluding trailing zeros which are appended to achieve byte
boundary alignment. This attribute is required and is a string representing a positive integer.
Content
The content is a string of data decoded by the decoder and encoded as described by the encoding attrib-
ute.
The IAS (ISO-ASYNCHRONOUS and SYNCHRONOUS modes) Bit Stream Output sends a raw, synchronized
bit stream (FSK, some PSK only) to an external application. Before data can be transferred, the parame-
ters of the decoder software (e.g. demodulator, shift frequency, center frequency etc.) must be set to cor-
rect values.
In case of “base2” encoding, a “FALSE” bit is encoded as character ‘0’, “TRUE” as character ‘1’.
In case of “base16” encoding, 4 bits are encoded by their respective hexadecimal character, i.e., ‘0’ to ‘F’.
In case of “base64(-mime)” encoding, 6 bits are represented by a single character of the base64-code.