Remote AT Command Response- 0x97
Request frame: Remote AT Command Request - 0x17
Description
This frame type is emitted in response to a Remote AT Command Request - 0x17. Some commands send back multiple response frames; for example, the ND command. Refer to individual AT command descriptions for details on API response behavior.
This frame is only emitted if the Frame ID in the request is non-zero.
Format
The following table provides the contents of the frame. For details on frame structure, see API frame specifications.
| Offset | Size | Frame Field | Description |
|---|---|---|---|
| 0 | 8-bit | Start Delimiter | Indicates the start of an API frame. |
| 1 | 16-bit | Length | Number of bytes between the length and checksum. |
| 3 | 8-bit | Frame type |
Remote AT Command Response - 0x97 |
| 4 | 8-bit | Frame ID |
Identifies the data frame for the host to correlate with a prior request. |
| 5 | 64-bit | 64-bit source address |
The sender's 64-bit address. |
| 13 | 16-bit | Reserved |
Unused, but this field is typically set to 0xFFFE. |
| 15 | 16-bit |
AT command |
The two ASCII characters that identify the AT Command. |
| 17 | 8-bit | Command status |
Status code for the host's request: 0x00 = OK 0x01 = ERROR 0x02 = Invalid command 0x03 = Invalid parameter 0x04 = Transmission failure 0x0C = Encryption error |
| 18-n | variable | Parameter value (optional) |
If the host requested a command parameter change, this field will be omitted. If the host queried a command by omitting the parameter value in the request, this field will return the value currently set on the device. |
| EOF | 8-bit | Checksum | 0xFF minus the 8-bit sum of bytes from offset 3 to this byte (between length and checksum). |
Examples
Each example is written without escapes (AP = 1) and all bytes are represented in hex format. For brevity, the start delimiter, length, and checksum fields have been excluded.
Set remote command parameter
Host set the NI string of a remote device to "Remote" using a Remote AT Command Request - 0x17.
The corresponding 0x97 Remote AT Command Response with a matching Frame ID is emitted as a response:
7E 00 0F 97 27 00 13 A2 00 12 34 56 78 12 7E 4E 49 00 51
| Frame type | Frame ID | 64-bit source | Reserved | AT command | Command Status | Command data |
|---|---|---|---|---|---|---|
| 0x97 | 0x27 | 0x0013A200 12345678 |
0x127E | 0x4E49 | 0x00 | (omitted) |
| Response | Matches request |
|
Unused | "NI" | Success | Parameter changes return no data |
Transmission failure
Host queued the the PAN ID change of a remote device using a Remote AT Command Request - 0x17. Due to existing network congestion, the host will retry any failed attempts.
The corresponding 0x97 Remote AT Command Response with a matching Frame ID is emitted as a response:
7E 00 0F 97 27 00 13 A2 00 12 34 56 78 FF FE 49 44 04 EA
| Frame type | Frame ID | 64-bit source | Reserved | AT command | Command Status | Command data |
|---|---|---|---|---|---|---|
| 0x97 | 0x27 | 0x0013A200 12345678 |
0xFFFE | 0x4944 | 0x04 | (omitted) |
| Response | Matches request |
|
Unused | "ID" | Transmission failure | Parameter changes return no data |
Query remote command parameter
Query the temperature of a remote device—.
The corresponding 0x97 Remote AT Command Response with a matching Frame ID is emitted with the temperature value as a response:
7E 00 11 97 27 00 13 A2 00 12 34 56 78 FF FE 54 50 00 00 2F A8
| Frame type | Frame ID | 64-bit source | Reserved | AT command | Command Status | Command data |
|---|---|---|---|---|---|---|
| 0x97 | 0x27 | 0x0013A200 12345678 |
0x0013A200 12345678 |
0x4944 | 0x00 | 0x002F |
| Response | Matches request |
|
Unused | "TP" | Success | +47 °C |
PDF
