Xbee/Xbee-Pro Digimesh 2.4 Advanced Application Features; Xbee Remote Configuration Commands; Sending A Remote Command To Xbee; Applying Changes On Remote Xbee Devices - Digi XBee User Manual

®
XBee/XBee-PRO DigiMesh 2.4 User Manual
XBee/XBee-PRO DigiMesh 2.4 Advanced
Application Features

XBee Remote Configuration Commands

A module in API mode has provisions to send configuration commands to remote devices using
the Remote Command Request API frame (see the API Operations chapter.) This API frame can
be used to send commands to a remote module to read or set command parameters.

Sending a Remote Command to XBee

To send a remote command, populate the Remote Command Request frame with the 64-bit
address of the remote device, the correct command options value, and the command and
parameter data (optional). If a command response is desired, the Frame ID needs to be set to a
non-zero value. Only unicasts of remote commands are supported. Remote commands cannot be
broadcast.

Applying Changes On Remote XBee Devices

When you use remote commands to change command parameter settings on a remote device,
the parameter changes do not take effect until the changes are applied. For example, changing
the BD parameter will not change the actual serial interface rate on the remote until the changes
are applied. Changes can be applied using remote commands in one of three ways:
• Set the apply changes option bit in the API frame
• Issue an AC command to the remote device
• Issue a WR + FR command to the remote device to save changes and reset the device

XBee Remote Command Responses

If a local device sends a command request to a remote device, and the API frame ID is non-zero,
the remote device sends a remote command response transmission back to the local device.
When the local device receives a remote command response transmission, it sends a remote
command response API frame out its UART. The remote command response indicates the status
of the command (success, or reason for failure), and in the case of a command query, it will
include the register value. The device that sends a remote command will not receive a remote
command response frame if:
• The destination device could not be reached
• The frame ID in the remote command request is set to 0
© 2014 Digi International Inc. 26