Advanced Application Features; Remote Configuration Commands; Send A Remote Command; Apply Changes On Remote Devices - Digi XBee-PRO S3 User Manual

Advanced application features

Remote configuration commands

A device in API mode has provisions to send configuration commands to remote devices using the
Remote Command Request API frame. For more information, see
this API frame to send commands to a remote module to read or set command parameters.

Send a remote command

To send a remote command populate the Remote AT Command Request frame (0x17) with:
1. The 64-bit address and of the remote device.
2. The correct command options value.
3. The command and parameter data (optional).

Apply changes on remote devices

When you use remote commands to change command parameter settings on a remote device,
parameter changes do not take effect until you apply the changes. For example, changing the BD
parameter does not change the serial interface on the remote until the changes are applied. To apply
changes, do one of the following:
Set the apply changes option bit in the API frame.
n
Issue an AC (Apply Changes) command to the remote device.
n
Issue a WR + FR command to the remote device to save changes and reset the device.
n

Remote command responses

If the remote device receives a remote command request transmission, and the API frame ID is non-
zero, the remote sends a remote command response transmission back to the device that sent the
remote command. When a remote command response transmission is received, a device sends a
remote command response API frame out its serial port. The remote command response indicates
the status of the command (success, or reason for failure), and in the case of a command query, it
includes the register value. The device that sends a remote command will not receive a remote
command response frame if either of the following conditions exist:
The destination device could not be reached.
n
The frame ID in the remote command request is set to 0.
n

Network commissioning and diagnostics

We call the process of discovering and configuring devices in a network for operation, "network
commissioning." Devices include several device discovery and configuration features. In addition to
configuring devices, you must develop a strategy to place devices to ensure reliable routes. To
accommodate these requirements, modules include features to aid in placing devices, configuring
devices, and network diagnostics.

Configure devices

You can configure XBee devices locally through serial commands (AT or API) or remotely through
remote API commands. API devices can send configuration commands to set or read the configuration
settings of any device in the network.
XBee®-PRO 900HP/XSC RF Modules
Remote configuration commands
Operate in API mode. You can use
160