Digi XGI-20CZ7-E00-W0, User Manual

Page: 66 / 153

Program XBee Industrial Gateway using
Python XBee Industrial Gateway Python application and Remote
Manager
Digi XBee Industrial Gateway 66
n
addr
l
Usage : Required.
l
Description : This attribute indicates the destination address of the node to which the
content indicated by the command body should be transmitted.
l
Value : Legal values for this attribute include:
The 64-bit IEEE address of the node following one of these patterns:
XX:XX:XX:XX:XX:XX:XX:XX
[XX:XX:XX:XX:XX:XX:XX:XX]!
XXXXXXXXXXXXXXXX
XX-XX-XX-XX-XX-XX-XX-XX
The string broadcast , which transmits the string to all nodes using a broadcast packet.
n
encoding
l
Usage : Optional.
l
Description : Specifies how the character data in the command elements is processed.
l
Value : The following encoding types are allowed:
o
base64 : Use Base64 encoding. Character data is decoded during command processing
prior to transmit on the RF Network.
o
utf-8 : Use UTF-8 variable-width encoding. While you can specify this encoding type,
current limitations in RCI/SCI processing through Remote Manager mean that true UTF-
8 encoding is not passed cleanly through all systems and end-to-end. It is only safe to
use ASCII. Specifying 'utf-8' is primarily useful for evaluation only.
o
Default value : base64 .
Command body (value)
The command body contains the data to be transmitted to the specified XBee node of the network.
The command body content depends on the value of the encoding attribute:
n
base64 : The command body value must be encoded in base64. The XBee Industrial Gateway
Python application will receive the encoded content but, prior to transmission to the
corresponding XBee node, the application will decode the command body to its original content
and that will be transmitted.
n
utf-8 : The command body value must be the serial data that you want to send to the XBee
node. The entire content of the command body as received by the gateway Python application
will be transmitted subject to whitespace handling rules of XML and the limitations of Remote
Manager to represent individual code points. For best results, base64 encoding is preferred for
production code and evaluation is best when limited to the ASCII subset.
Note Whitespace is not significant when the XBee Industrial Gateway Python application processes
base64. However, whitespace in UTF-8 is significant, because it is impossible to determine whether