Difference between revisions of "End Device AT Commands and Downlink Commands"
David.huang (Talk | contribs) (→Application EUI) |
David.huang (Talk | contribs) (→Keys, IDs and EUIs management) |
||
| Line 214: | Line 214: | ||
|'''Response''' | |'''Response''' | ||
|- | |- | ||
| − | |AT+APPEUI? | + | |AT+APPEUI=? |
|Get the Application EUI | |Get the Application EUI | ||
|00 b3 d5 00 00 00 00 00 | |00 b3 d5 00 00 00 00 00 | ||
| Line 238: | Line 238: | ||
|'''Response''' | |'''Response''' | ||
|- | |- | ||
| − | |AT+APPKEY? | + | |AT+APPKEY=? |
|Get the Application Key | |Get the Application Key | ||
|00 35 55 55 22 23 55 53 43 24 23 42 34 35 35 35 | |00 35 55 55 22 23 55 53 43 24 23 42 34 35 35 35 | ||
| Line 262: | Line 262: | ||
|'''Response''' | |'''Response''' | ||
|- | |- | ||
| − | |AT+APPSKEY? | + | |AT+APPSKEY=? |
|Get the Application Session Key | |Get the Application Session Key | ||
|00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2 | |00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2 | ||
| Line 269: | Line 269: | ||
|- | |- | ||
|AT+APPSKEY=00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2 | |AT+APPSKEY=00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2 | ||
| + | |Set the Application Session Key. | ||
| + | |(While Error in format, return AT_PARAM_ERROR) | ||
| + | OK | ||
| + | |} | ||
| + | <br> | ||
| + | |||
| + | == Device Address== | ||
| + | Feature: Get or Set the Device Address. | ||
| + | |||
| + | <span CLASS=bluemiddle> AT Command: AT+DADDR</span> | ||
| + | |||
| + | {| style="color:green;background-color:#ffffcc;" border="1" cellpadding="5" cellspacing="0" | ||
| + | ! colspan="3"|AT+DADDR | ||
| + | |- | ||
| + | |'''Command Example''' | ||
| + | |'''Function''' | ||
| + | |'''Response''' | ||
| + | |- | ||
| + | |AT+DADDR=? | ||
| + | |Get the Application Session Key. | ||
| + | |(While Error in format, return AT_PARAM_ERROR) | ||
| + | A8 40 41 FF | ||
| + | |||
| + | OK | ||
| + | |||
| + | |- | ||
| + | |AT+DADDR=A8 40 41 FF | ||
|Set the Application Session Key. | |Set the Application Session Key. | ||
|OK | |OK | ||
Revision as of 22:06, 1 November 2020
Contents
Introduction
Dragino LoRaWAN End Node support two types of AT Commands and Downlink Commands:
- Common Commands: They should be available for each sensor, such as: change uplink interval, reset device.
- Sensor Related Commands: Only for special sensor, such as control relay, poll RS485 device.
This page shows the common commands since Dragino LoRaWAN stack DR-LWS-005. Make sure the end node support stack higher than DR-LWS-005 before checking this page.
How to use AT Commands or Downlink command
See Devices User Manual for Device. The user manual can be found in each product page of Dragino Official Website
Support End Node and firmware version
| Dragino STM32 base hardware Firmware / LoRaWAN stack list | ||
|---|---|---|
| Model | Description | Firmware Version ; Stack Version |
| LSN50-v1, LSN50-V2, | Open Source Generic LoRaWAN Sensor Node | LSN50 v1.6.0 <--> DR-LWS-003;
LSN50 v1.7.0 <--> DR-LWS-005; --> Support since this version |
System Management Commands
Change Uplink Interval
Feature: Change LoRaWAN End Node Transmit Interval.
AT Command: AT+TDC
| AT+TDC | ||
|---|---|---|
| Command Example | Function | Response |
| AT+TDC? | Show current transmit Interval | 30000
OK the interval is 30000ms = 30s |
| AT+TDC=60000 | Set Transmit Interval | OK
Set transmit interval to 60000ms = 60 seconds |
Downlink Command: 0x01
Format: Command Code (0x01) followed by 3 bytes time value.
If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
- Example 1: Downlink Payload: 0100001E // Set Transmit Interval (TDC) = 30 seconds
- Example 2: Downlink Payload: 0100003C // Set Transmit Interval (TDC) = 60 seconds
Reboot End Node
Feature: Reboot End Node to perform a new OTAA or ABP Join.
AT Command: ATZ
| ATZ: Trig a reset of the MCU | ||
|---|---|---|
| Command Example | Function | Response |
| ATZ | Reset MCU | Device reset and show booting info
LSN50 Device/LoRa ST Module Image Version: XX Frequency Band: XX DevEui= XX XX XX XX XX XX XX XX <followed by the Tx and Rx information> |
Downlink Command: 0x04
Format: Command Code (0x04) followed by FF.
If the downlink payload=04FF, the end node will reboot.
Reset to factory Default
Feature: Reset the parameters to Factory Default, factory default value depends on the firmware settings, the OTAA and ABP keys will reserve after this command.
AT Command: AT+FDR
| Reset to factory default | ||
|---|---|---|
| Command Example | Function | Response |
| AT+FDR | Reset to factory default | Device reset to factory default parameters and show booting info
LSN50 Device/LoRa ST Module Image Version: XX Frequency Band: XX DevEui= XX XX XX XX XX XX XX XX Please set the parameters or reset Device to apply change |
Downlink Command: 0x04
Format: Command Code (0x04) followed by FE.
If the downlink payload=04FE, Reset Parameters to Factory Default, Keys Reserve.
Show Firmware Version
Feature: Show firmware version. No downlink command yet.
AT Command: AT+VER
| AT+VER: Image Version and Frequency Band | ||
|---|---|---|
| Command Example | Function | Response |
| AT+VER=? | Show Image version and Frequency Band |
1.3 EU868 OK |
Show System Configure
Feature: Show All configure. No downlink command yet.
AT Command: AT+CFG
| AT+CFG: Print all configurations | ||
|---|---|---|
| Command Example | Function | Response |
| AT+CFG | Show all configures |
AT+DEUI = XX XX XX XX XX XX XX XX AT+DADDR=XXXXXXXX ………. AT+RX2WTO=X AT+CHS=868100000 OK |
Keys, IDs and EUIs management
Application EUI
Feature: Get or Set the Application EUI.
AT Command: AT+APPEUI
| AT+APPEUI | ||
|---|---|---|
| Command Example | Function | Response |
| AT+APPEUI=? | Get the Application EUI | 00 b3 d5 00 00 00 00 00
OK |
| AT+APPEUI=00 b3 d5 7e f0 00 4d 34 | Set the Application EUI | OK |
Application Key
Feature: Get or Set the Application Key.
AT Command: AT+APPKEY
| AT+APPKEY | ||
|---|---|---|
| Command Example | Function | Response |
| AT+APPKEY=? | Get the Application Key | 00 35 55 55 22 23 55 53 43 24 23 42 34 35 35 35
OK |
| AT+APPKEY=00 35 55 55 22 23 55 53 43 24 23 42 34 35 35 35 | Set the Application Key. | OK |
Application Session Key
Feature: Get or Set the Application Session Key.
AT Command: AT+APPSKEY
| AT+APPSKEY | ||
|---|---|---|
| Command Example | Function | Response |
| AT+APPSKEY=? | Get the Application Session Key | 00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2
OK |
| AT+APPSKEY=00 7d dc 73 33 d3 eb 9e 14 38 d5 a4 3e 62 5b e2 | Set the Application Session Key. | (While Error in format, return AT_PARAM_ERROR)
OK |
Device Address
Feature: Get or Set the Device Address.
AT Command: AT+DADDR
| AT+DADDR | ||
|---|---|---|
| Command Example | Function | Response |
| AT+DADDR=? | Get the Application Session Key. | (While Error in format, return AT_PARAM_ERROR)
A8 40 41 FF OK |
| AT+DADDR=A8 40 41 FF | Set the Application Session Key. | OK |
Joining and sending date on LoRaWAN network
LoRaWAN network management
0x05 Enable/Disable Data Confirm Mode
Set end node to use confirm mode or unconfirm mode to uplink payload.
- Downlink Payload: 05000001, Set AT+CFM=1, use confirm mode to uplink.
- Downlink Payload: 05000000, set AT+CFM=0, use unconfirm mode to uplink.
0x20 LoRa® Network Join Mode-- ABP or OTAA
Set the Network Join Mode. (0: ABP, 1: OTAA)
- Downlink Payload: 0x2000, Set AT+NJM=O, use ABP mode to uplink.
- Downlink Payload: 0x2001, Set AT+NJM=1, use OTAA mode to uplink.
0x22 Adaptive Rate
Set the Adaptive Data Rate setting. (0: off, 1: on)
- Downlink Payload: 0x2201, Set AT+ADR=1.
- Downlink Payload: 0x2200FFFF, Set AT+ADR=0.
0x23 Application Port
Set the application port
- Example1 : Downlink Payload: 0x2305 // Set AT+PORT=5 .
- Example2 : Downlink Payload: 0x2317 // Set AT+PORT=23 .
0x24 Eight Channel Mode
Set eight channels mode,Only for US915,AU915,CN470
- Example : Downlink Payload: 0x24 01 // Set AT+CHE=1 902.3 902.5 902.7 902.9 903.1 903.3 903.5 903.7 .
0x25 UplinkDwellTime
Set UplinkDwellTime
- Downlink Payload: 0x2500, Set AT+DWELLT=0 to uplink.
- Downlink Payload: 0x2501, Set AT+DWELLT=1 to uplink.
0x21 Set response level
- Downlink Payload: 0x2101, Set AT+RPL=1. //Receive an unconfirmed packet and reply with an empty packet to the server.
- Downlink Payload: 0x210101, Set AT+RPL=1,1. //Receive an unconfirmed packet and reply with 00 packet to the server.
- Downlink Payload: 0x2102, Set AT+RPL=2. //Receive the confirmed packet and reply an empty packet to the server.
- Downlink Payload: 0x210201, Set AT+RPL=2,1. //Receive the confirmed packet and reply with 00 packet to the server.
- Downlink Payload: 0x2103, Set AT+RPL=3. //Receive an ADR packet and reply with an empty packet to the server.
- Downlink Payload: 0x210301, Set AT+RPL=3,1. //Receive an ADR packet reply to 00 packet to the server.
