User's Manual
Table Of Contents
- 1. XTend RF Module
- 2. RF Module Operation
- 3. RF Module Configuration
- Programming Examples
- Command Reference Table
- Command Descriptions
- %V (Board Voltage) Command
- AM (Auto-set MY) Command
- AP (API Enable) Command
- AT (Guard Time After) Command
- BD (Interface Data Rate) Command
- BR (RF Data Rate) Command
- BT (Guard Time Before) Command
- CC (Command Sequence Character) Command
- CD (GPO2 Configuration) Command
- CF (Number Base) Command
- CN (Exit AT Command Mode) Command
- CS (GPO1 Configuration) Command
- CT (Command Mode Timeout) Command
- DB (Received Signal Strength) Command
- DT (Destination Address) Command
- E0 (Echo Off) Command
- E1 (Echo On) Command
- ER (Receive Error Count) Command
- FH (Force Wake-up Initializer) Command
- FL (Software Flow Control) Command
- FS (Forced Synch Time) Command
- FT (Flow Control Threshold) Command
- GD (Receive Good Count) Command
- HP (Hopping Channel) Command
- HT (Time before Wake-up Initializer) Command
- HV (Hardware Version) Command
- ID (Modem VID) Command
- KY (AES Encryption Key) Command
- LH (Wake-up Initializer Timer) Command
- MD (RF Mode) Command
- MK (Address Mask) Command
- MT (Multi-transmit) Command
- MY (Source Address) Command
- NB (Parity) Command
- PB (Polling Begin Address) Command
- PD (Minimum Polling Delay) Command
- PE (Polling End Address) Command
- PK (Maximum RF Packet Size) Command
- PL (TX Power Level) Command
- PW (Pin Wake-up) Command
- RB (Packetization Threshold) Command
- RC (Ambient Power - Single Channel) Command
- RE (Restore Defaults) Command
- RM (Ambient Power - All Channels) Command
- RN (Delay Slots) Command
- RO (Packetization Timeout) Command
- RP (RSSI PWM Timer) Command
- RR (Retries) Command
- RT (GPI1 Configuration) Command
- SB (Stop Bits) Command
- SH (Serial Number High) Command
- SL (Serial Number Low) Command
- SM (Sleep Mode) Command
- ST (Time before Sleep) Command
- TP (Board Temperature) Command
- TR (Transmit Error Count) Command
- TT (Streaming Limit) Command
- TX (Transmit Only) Command
- VL (Firmware Version - Verbose)
- VR (Firmware Version - Short) Command
- WA (Active Warning Numbers) Command
- WN (Warning Data) Command
- WR (Write) Command
- WS (Sticky Warning Numbers) Command
- API Operation
- 4. RF Communication Modes
- Appendix A: Agency Certifications
- Appendix B: Development Guide
- Appendix C: Additional Information
XTend™RFModule‐ProductManual
©2013DigiInternatonal,Inc. 41
API Operation
By default, XTend RF Modules act as a serial line replacement (Transparent Operation) - all UART
data received through the DI pin is queued up for RF transmission. When the module receives an
RF packet, the data is sent out the DO pin with no additional information.
Inherent to Transparent Operation are the following behaviors:
• If module parameter registers are to be set or queried, a special operation is required for
transitioning the module into Command Mode [refer to p17].
• In point-to-multipoint systems, the application must send extra information so that the
receiving module(s) can distinguish between data coming from different remotes.
As an alternative to the default Transparent Operation, API (Application Programming Interface)
Operations are available. API operation requires that communication with the module be done
through a structured interface (data is communicated in frames in a defined order). The API
specifies how commands, command responses and module status messages are sent and received
from the module using a UART data frame.
API Frame Specifications
Two API modes are supported and both can be enabled using the AP (API Enable) command. Use
the following AP parameter values to configure the module to operate in a particular mode:
• AP = 0 (default): Transparent Operation (UART Serial line replacement)
API modes are disabled.
•AP = 1: API Operation
•AP = 2: API Operation (with escaped characters)
Any data received prior to the start delimiter is silently discarded. If the frame is not received
correctly or if the checksum fails, the data is silently discarded.
API Operation (AP parameter = 1)
When this API mode is enabled (AP = 1), the UART data frame structure is defined as follows:
Figure3‐01. UARTDataFrameStructure:
MSB=MostSignificantByte,LSB=LeastSignificantByte
API Operation - with Escape Characters (AP parameter = 2)
When this API mode is enabled (AP = 2), the UART data frame structure is defined as follows:
Figure3‐02. UARTDataFrameStructure‐withescapecontrolcharacters:
MSB=MostSignificantByte,LSB=LeastSignificantByte
Escape characters. When sending or receiving a UART data frame, specific data values must be
escaped (flagged) so they do not interfere with the UART or UART data frame operation. To escape
an interfering data byte, insert 0x7D and follow it with the byte to be escaped XOR’d with 0x20.
Start Delimiter
(Byte 1)
Length
(Bytes 2-3)
Frame Data
(Bytes 4-n)
Checksum
(Byte n + 1)
0x7E MSB LSB API-specific Structure 1 Byte
Start Delimiter
(Byte 1)
Length
(Bytes 2-3)
Frame Data
(Bytes 4-n)
Checksum
(Byte n + 1)
0x7E MSB LSB API-specific Structure 1 Byte
Characters Escaped If Needed