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. 31
MK (Address Mask) Command
<Networking & Security> The MK command is
used to set/read the Address Mask of a module.
All RF data packets contain the Destination
Address of the TX (transmitting) module. When a
packet is received, the TX module Destination
Address is logically "ANDed" (bitwise) with the
Address Mask of the RX (receiving) module. The
resulting value must match the Destination
Address or Address Mask of the RX module for the
packet to be received and sent out the RX
module's DO (Data Out) pin. If the "ANDed" value does not match the Destination Address or
Address Mask of the RX module, the packet is discarded.
Sniffer Mode (when MK = 0): ACK requests are ignored and every RX (receive) frame is sent to
the UART, without regard for repeated frames.
All “0” values are treated as irrelevant values and ignored.
Refer to the ‘Addressing’ section [p45] for more information.
MT (Multi-transmit) Command
<Networking & Security> The MT command is
used to enabled multiple transmissions of RF data
packets. When Multi-transmit Mode is enabled
(MT > 0), packets do not request an ACK
(acknowledgement) from the receiving RF
module(s). MT takes precedence over RR, so if
both MT and RR are non-zero, then MT+1 packets
will be sent (with no ACK requests).
When a receiving module receives a packet with
remaining forced retransmissions, it calculates
the length of the packet and inhibits transmission
for the amount of time required for all retransmissions. Thereafter, a random number of delay
slots are inserted between 0 and RN before transmission is allowed from the receiving module(s).
This prevents all listening modules from transmitting at once upon conclusion of a multiple
transmission event (when RN > 0).
NOTE: The actual number of forced transmissions is the parameter value plus one. For example, if
MT = 1, two transmissions of each packet will be sent.
Refer to the ‘Multi-transmit Mode’ section [p47] for more information.
MY (Source Address) Command
<Networking & Security> The MY command is
used to set/read the Source Address of the RF
module.
Refer to the DT command and the 'Addressing'
section [p45] for more information.
AT Command: ATMK
Binary Command: 0x12 (18 decimal)
Parameter Range:0 - 0xFFFF
Default Parameter Value: 0xFFFF (65535d)
Number of bytes returned: 2
Related Commands: DT (Destination Address),
HP (Hopping Channel), ID (Modem VID), MY
(Source Address)
AT Command: ATMT
Binary Command: 0x3D (61 decimal)
Parameter Range: 0 - 0xFF
Default Parameter Value:0 (no forced
retransmissions)
Number of bytes returned: 1
Related Commands: Networking (DT, MK, MY,
RN, TT), Serial Interfacing (BR, PK, RB, RO), RF
Interfacing (FS)
AT Command: ATMY
Binary Command: 0x2A (42 decimal)
Parameter Range: 0 - 0xFFFF
Default Parameter Value: 0xFFFF (Disabled -
DT (Destination Address) parameter serves as
both source and destination address.)
Number of bytes returned: 2
Related Commands: DT (Destination Address),
HP (Hopping Channel), ID (Modem VID), MK
(Address Mask)