Table of Contents：

• 1. Introduction
• 2. How to use AT Commands or Downlink command
• 3. Support End Node and firmware version
• 4. System Management Commands
  • 4.1 Change Uplink Interval
  • 4.2 Reboot End Node
  • 4.3 Reset to factory Default
  • 4.4 Show Firmware Version
  • 4.5 Show System Configure
• 5. Keys, IDs and EUIs management
  • 5.1 Application EUI
  • 5.2 Application Key
  • 5.3 Application Session Key
  • 5.4 Device Address
  • 5.5 Device EUI
  • 5.6 Network ID
  • 5.7 Network Session Key
• 6. Joining and sending date on LoRaWAN network
  • 6.1 Confirm Mode
    • 6.1.1  AT+CFM command before DR-LWS007 software stack
    • 6.1.2  AT+CFM command since DR-LWS007 software stack
  • 6.2 Confirm Status
  • 6.3 Join LoRa® Network
  • 6.4 LoRa® Network Join Mode
  • 6.5 LoRa® Network Join Status
  • 6.6 Print Last Received Data in Raw Format
  • 6.7 Print Last Received Data in Binary Format
  • 6.8 Send Text Data
  • 6.9 Send Hexadecimal Data
• 7. LoRaWAN network management
  • 7.1 Adaptive Data Rate
  • 7.2 LoRa® Class
  • 7.3 Duty Cycle Setting
  • 7.4 Data Rate
  • 7.5 Frame Counter Downlink
  • 7.6 Frame Counter Uplink
  • 7.7 Join Accept Delay1
  • 7.8 Join Accept Delay2
  • 7.9 Public Network Mode
  • 7.10 Receive Delay1
  • 7.11 Receive Delay2
  • 7.12 Rx2 Window Data Rate
  • 7.13 Rx2 Window Frequency
  • 7.14 Transmit Power
  • 7.15 RSSI of the Last Received Packet
  • 7.16 SNR of the Last Received Packet
  • 7.17 Application Port
  • 7.18 Single Channel Mode
  • 7.19 Eight Channel Mode
  • 7.20 Get or Set RXwindows1 timeout
  • 7.21 Get or Set RXwindows2 timeout
  • 7.22 Setting up uplinkdwelltime (as923, au915)
  • 7.23 Set Packet Receiving Response Level
  • 7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets)
  • 7.25 Device offline rejoining （LWS007)
  • 7.26 Request the server to send an ACK
  • 7.27 Adjust network rejoining interval
• 8. AT Commands Combination
  • 8.1 Set a fix RX2DR for downlink window
  • 8.2 Use Downlink Command to set a fix uplink DR

1. 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.

2. How to use AT Commands or Downlink command

• AT Command : See Devices User Manual for how to connect to device via USB TTL adapter and use. The user manual can be found in each product page of Dragino Official Website
• LoRaWAN Downlink Command: The gateway transfer downlink command in HEX format. This page shows the Downlink Command In HEX format. Please note some LoRaWAN servers use base64 as downlink code so user need to convert HEX to Base64 and use. Below are references for how to use downlink command:
  • Use HEX format to send a downlink: TTN v3
  • Use Base64 format to send a downlink: Chirpstack, How to Convert?
  • See use note for more serves Servers Note(IoT LoRaWAN Server)

3. Support End Node and firmware version

4. System Management Commands

4.1 Change Uplink Interval

Feature: Change LoRaWAN End Node Transmit Interval.

AT Command: AT+TDC

• Example 1: Downlink Payload: 0100001E               // Set Transmit Interval (TDC) = 30 seconds
• Example 2: Downlink Payload: 0100003C               // Set Transmit Interval (TDC) = 60 seconds

4.2 Reboot End Node

Feature: Reboot End Node to perform a new OTAA or ABP Join.

AT Command: ATZ

Downlink Command: 0x04

4.3 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

Downlink Command: 0x04

4.4 Show Firmware Version

Feature: Show firmware version. No downlink command yet.

AT Command: AT+VER

Downlink Command: 0x26 (Valid in 006 stack)

• 0x00 01: LGT92 Version
• 0x00 02: LBT1
• 0x00 03: LSE01/LDDS75/LDDS20/LSPH01/LLMS01/LSNPK01

• 0x01: EU868
• 0x02: US915
• 0x03: IN865
• 0x04: AU915
• 0x05: KZ865
• 0x06: RU864
• 0x07: AS923
• 0x08: AS923-1
• 0x09: AS923-2
• 0xa0: AS923-3

firmware version: v1.1.0 --> 110

4.5 Show System Configure

Feature: Show All configure. No downlink command yet.

AT Command: AT+CFG

5. Keys, IDs and EUIs management

5.1 Application EUI

Feature: Get or Set the Application EUI.

AT Command: AT+APPEUI

5.2 Application Key

Feature: Get or Set the Application Key.

AT Command: AT+APPKEY

5.3 Application Session Key

Feature: Get or Set the Application Session Key.

AT Command: AT+APPSKEY

5.4 Device Address

Feature: Get or Set the Device Address.

AT Command: AT+DADDR

5.5 Device EUI

Feature: Get or Set the Device EUI.

AT Command: AT+DEUI

5.6 Network ID

Feature: Get or Set the Network ID.(You can enter this command change only after successful network connection)

AT Command: AT+NWKID

5.7 Network Session Key

Feature: Get or Set the Network Session Key

AT Command: AT+NWKSKEY

6. Joining and sending date on LoRaWAN network

6.1 Confirm Mode

6.1.1  AT+CFM command before DR-LWS007 software stack

Feature: Get or Set the confirmation mode (0-1).

AT Command: AT+CFM

Downlink Command: 0x05

Format: Command Code (0x05) followed by 2 bytes mode value.

If the downlink payload=0501, it means set end node to use confirm mode, while type code is 05.

• Example 1: Downlink Payload: 0501            // Set AT+CFM=1
• Example 2: Downlink Payload: 0500            // Set AT+CFM=0

6.1.2  AT+CFM command since DR-LWS007 software stack

AT Command: AT+CFM

Downlink Command: 0x05

Format: Command Code (0x05) followed by 2 bytes mode value.

If the downlink payload=05010101, it means set end node to use confirm mode, while type code is 05.

• Example 1: Downlink Payload: 05010101           // Set AT+CFM=1,1,1
• Example 2: Downlink Payload: 05000700           // Set AT+CFM=0,7,0

6.2 Confirm Status

Feature: Get confirmation status of the last AT+SEND (0-1).

AT Command: AT+CFS

6.3 Join LoRa® Network

Feature: Join network.

AT Command: AT+JOIN

6.4 LoRa® Network Join Mode

Feature: Get or Set the Network Join Mode. (0: ABP, 1: OTAA).

AT Command: AT+NJM

Downlink Command: 0x20

Format: Command Code (0x20) followed by 1 bytes mode value.

If the downlink payload=2000, it means set the Network Join Mode, while type code is 20.

• Example 1: Downlink Payload: 2000                   // Set AT+NJM=0
• Example 2: Downlink Payload: 2001                   // Set AT+NJM=1

6.5 LoRa® Network Join Status

Feature: LoRa® Network Join Status.

AT Command: AT+NJS

6.6 Print Last Received Data in Raw Format

Feature: Print Last Received Data in Raw Format<port:data>.

AT Command: AT+RECV

6.7 Print Last Received Data in Binary Format

Feature: Print Last Received Data in Binary Format<port:data>.

AT Command: AT+RECVB

6.8 Send Text Data

Feature: Send Text Data<port:data>.

AT Command: AT+SEND

6.9 Send Hexadecimal Data

Feature: Send hexadecimal data along with the application port.

AT Command: AT+SENDB

7. LoRaWAN network management

7.1 Adaptive Data Rate

Feature: Get or Set the Adaptive Data Rate setting. (0: off, 1: on).

AT Command: AT+ADR

Downlink Command: 0x22

If the downlink payload=2201, it means setting the adaptive data rate to 1, while type code is 22.

• Example 1: Downlink Payload: 2201                       // Set AT+ADR=1.
• Example 2: Downlink Payload: 2200FFFF               // Set AT+ADR=0.

7.2 LoRa® Class

Feature: Get or Set the Device Class(Currently only support class A, class C).

AT Command:  AT+CLASS

7.3 Duty Cycle Setting

Feature: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing.

AT Command:  AT+DCS

7.4 Data Rate

Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .

Notice:

• User need to set Adaptive Data Rate(ADR)=0 first. otherwise device will respond to server's ADR command and change the DR according to server auto-adjustment.
• Data Rate specifies Spreading Factor. The mapping varies in different frequency bands. User can check this link for detail. rp2-1.0.3-lorawan-regional-parameters.pdf

AT Command: AT+DR

Downlink Command: 0x2200aaFF

If the downlink payload=220001FF, it means setting the data rate to 1, while type code is 22 00 aa FF.

• Example 1: Downlink Payload: 220001FF                     // Set AT+DR=1.
• Example 2: Downlink Payload: 220000FF                     // Set AT+DR=0.

7.5 Frame Counter Downlink

Feature: Get or Set the Frame Counter Downlink.

AT Command:  AT+FCD

7.6 Frame Counter Uplink

Feature: Get or Set the Frame Counter Uplink.

AT Command:  AT+FCU

7.7 Join Accept Delay1

Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms.

AT Command:  AT+JN1DL

7.8 Join Accept Delay2

Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms.

AT Command:  AT+JN2DL

7.9 Public Network Mode

Feature: Get or Set the public network mode. (0: off, 1: on). A Public LoRaWAN network use 0x34 as syncword. Default Settings; PNM=1

Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network.

AT Command:  AT+PNM

7.10 Receive Delay1

Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms

AT Command: AT+RX1DL

7.11 Receive Delay2

Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms

AT Command: AT+RX2DL

7.12 Rx2 Window Data Rate

Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X)

AT Command:  AT+RX2DR

7.13 Rx2 Window Frequency

Feature: Get or Set the Rx2 window frequency

AT Command:  AT+RX2FQ

7.14 Transmit Power

Feature: Get or Set the Transmit Power(0-5, MAX:0, MIN:5, according to LoRaWAN Spec, or 40=10dB, 41 = 11dB, …, 50 = 20dB which is out of LoRaWAN spec. )

Notice: Transmit Power might be changed by ADR from LoRaWAN server. So manually change TXP also remember to set AT+ADR=0 in sensor

AT Command:  AT+TXP

Downlink Payload. The 4th byte of 0x22 downlink.

If the downlink payload=22000100, it means setting the TXP to 0.

• Example 1: Downlink Payload: 22000102         // Set AT+TXP=2.
• Example 2: Downlink Payload: 22000000        // Set AT+TXP=0.

7.15 RSSI of the Last Received Packet

Feature: Get or Set the Rx2 window frequency

AT Command:AT+RSSI

7.16 SNR of the Last Received Packet

Feature: Get the SNR of the last received packet

AT Command:  AT+SNR

7.17 Application Port

Feature: Get or set the application port.

AT Command: AT+PORT

Downlink Command: 0x23

Format: Command Code (0x23) followed by 1 bytes port value.

If the downlink payload=2301, it means set the application port to 1, while type code is 23.

• Example 1: Downlink Payload: 2301          // set the application port to 1
• Example 2: Downlink Payload: 2305          // set the application port to 5

7.18 Single Channel Mode

Feature:Get or Set Frequency (Unit: Hz) for Single Channel Mode.

AT Command: AT+CHS

7.19 Eight Channel Mode

Feature: Get or Set eight channels mode,Only for US915,AU915,CN470.

AT Command: AT+CHE

Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)

Format: Command Code (0x24) followed by 1 bytes channel value.

If the downlink payload=2401, it means set channel mode to 1, while type code is 24.

• Example 1: Downlink Payload: 2401           // set channel mode to 1
• Example 2: Downlink Payload: 2405           // set channel mode to 5

7.20 Get or Set RXwindows1 timeout

Feature: Get or Set the number of symbols to detect and timeout from RXwindow1(0 to 255).

AT Command: AT+RX1WTO

7.21 Get or Set RXwindows2 timeout

Feature: Get or Set the number of symbols to detect and timeout from RXwindow2(0 to 255).

AT Command: AT+RX2WTO

7.22 Setting up uplinkdwelltime (as923, au915)

Feature: Get or Set uplinkdwelltime

AT Command: AT+DWELLT

Downlink Command: 0x25

Format: Command Code (0x25) followed by 1 bytes state value.

If the downlink payload=2501, it means set uplinkdwelltime to 1, while type code is 25.

• Example 1: Downlink Payload: 2501                    // set uplinkdwelltime to 1
• Example 2: Downlink Payload: 2500                    // set uplinkdwelltime to 0

7.23 Set Packet Receiving Response Level

Feature: Get or Set packet receiving response level. This feature is used to set compatible with different LoRaWAN servers. If RPL doesn;t match , user will see strange message in the server portal.

RPL value:

• AT+RPL=0: Device won't immediately reply any downlink commands from platform.
• AT+RPL=1: Device will immediately reply message to Unconfirmed Data Down. Payload is 0x00.
• AT+RPL=2: Device will immediately reply message to Confirmed Data Down. Payload is 0x00 and requied response header for this command.
• AT+RPL=3: Device will immediately reply message to MAC Command. Payload is 0x00 and requied response header for this command.
• AT+RPL=4: Device will immediately reply message to Confirmed Data Down & MAC Command. Payload is 0x00 and requied response header for these two commands.

Case Analyes:

• For Class A devices, AT+RPL=0 is ok. that is defaut settings in software.
• For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command.
• For Class C devices used in TTI, need to set AT+RPL=4 because TTI require immediately reply message to Confirmed Data Down & MAC Command.

AT Command: AT+RPL

Downlink Command: 0x21

Format: Command Code (0x21) followed by 1 bytes level value.

If the downlink payload=2101, it means set packet receiving response level to 1, while type code is 21.

• Example 1: Downlink Payload: 2101                // set packet receiving response level to 1
• Example 2: Downlink Payload: 2102                // set packet receiving response level to 2

7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets)

AT Command: AT+SETMAXNBTRANS 

Downlink Command: 0x33

Format: Command Code (0x33) followed by 2 bytes mode value.

If the downlink payload=330100, it means set end node to use confirm mode, while type code is 33.

• Example 1: Downlink Payload: 330100                 // Set AT+SETMAXNBTRANS=1,0
• Example 2: Downlink Payload: 330201                 // Set AT+SETMAXNBTRANS=2,1

7.25 Device offline rejoining （LWS007)

AT Command: AT+DDETECT

AT+DDETECT=<Flag>,<ACK_Timout_1>,<ACK_Timout_2> (Default Value: AT+DDETECT=1,1440,2880)

• ACK_Timout_1: Unit: min
• ACK_Timout_2: Unit: min

Downlink Command: 0x32

Format: Command Code (0x32) followed by 2 bytes mode value.

If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 32.

• Example 1: Downlink Payload: 320105A00B40                     // Set AT+DDETECT=1,1440,2880
  • 0x01 : Flag
  • 0x05A0: ACK_Timout_1 : 1440minutes (24 hours)
  • 0x0B40: ACK_Timout_2 : 2880minutes (48 hours)
  • Explain: Enable Online Detect, if end node doesn't receive any downlink within ACK_Timout_1( 1440 minutes or 24 hours). End node will use confirmed uplink to send packets during ACK_Timout_1 (the 24th hour) to ACK_Timout_2 ( the 48th hour). If from the 24th to 48th hour, end node got an downlink from server, it will switch back to unconfirmed uplink. end node will restart ACK_Timout_1. If from the 24th to 48th hour, end node still not got any downlink, means device doesn't get ACK from server within last 48 hours. Device will process rejoin, rejoin request interval is AT+RJTDC period. For AU915/ US915, device will use the sub-band used for last join.

7.26 Request the server to send an ACK

AT Command: AT+PNACKMD

7.27 Adjust network rejoining interval

AT Command: AT+RJTDC

Downlink Command: 0x26

Format: Command Code (0x26) followed by 2 bytes mode value.

If the downlink payload=26000A, it means set end node to use confirm mode, while type code is 26.

• Example 1: Downlink Payload: 26000A                 // Set AT+RJTDC=10
• Example 2: Downlink Payload: 260002                 // Set AT+RJTDC=2

8. AT Commands Combination

8.1 Set a fix RX2DR for downlink window

• AT+ADR=0              -->  Disable ADR first

• AT+RX2DR=xxxx    -->  Set xxxx to your wanted DataRate

8.2 Use Downlink Command to set a fix uplink DR

Downlink Command: 0x22000500

Same as:

• AT+ADR=0    Reference

• AT+DR=5      Reference

• AT+TXP=0     Reference