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.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 Uplink fcnt settings（LWS007)
  • 7.25 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets)
  • 7.26 Device offline rejoining
  • 7.27 Request the server to send an ACK
• 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

• For AT Command , See Devices User Manual for Device. The user manual can be found in each product page of Dragino Official Website
• For LoRaWAN Downlink: The gateway transfer downlink command in HEX format. This page shows the HEX format downlink code for each command. but some servers use base64 as downlink code. Below are reference for how to use downlink command:
  • Use HEX format to send a downlink: TTN v3
  • Use Base64 format to send a downlink: Chirpstack
  • 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.

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

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.

4.4 Show Firmware Version

Feature: Show firmware version. No downlink command yet.

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

5. Keys, IDs and EUIs management

5.1 Application EUI

Feature: Get or Set the Application EUI.

5.2 Application Key

Feature: Get or Set the Application Key.

5.3 Application Session Key

Feature: Get or Set the Application Session Key.

5.4 Device Address

Feature: Get or Set the Device Address.

5.5 Device EUI

Feature: Get or Set the Device EUI.

5.6 Network ID

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

5.7 Network Session Key

Feature: Get or Set the Network Session Key

6. Joining and sending date on LoRaWAN network

6.1 Confirm Mode

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

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.2 Confirm Status

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

6.3 Join LoRa® Network

Feature: Join network.

6.4 LoRa® Network Join Mode

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

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=O
• Example 2: Downlink Payload: 2001 // Set AT+NJM=1

6.5 LoRa® Network Join Status

Feature: LoRa® Network Join Status.

6.6 Print Last Received Data in Raw Format

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

6.7 Print Last Received Data in Binary Format

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

6.8 Send Text Data

Feature: Send Text Data<port:data>.

6.9 Send Hexadecimal Data

Feature: Send hexadecimal data along with the application port.

7. LoRaWAN network management

7.1 Adaptive Data Rate

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

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

7.3 Duty Cycle Setting

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

7.4 Data Rate

Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) . Note: while set Data Rate, please use set Adptive Data Rate, ADR=0 first. otherwise device will response to server's ADR command and change the DR to the setting from server

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.

7.6 Frame Counter Uplink

Feature: Get or Set the Frame Counter Uplink.

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.

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.

7.9 Public Network Mode

Feature: Get or Set the public network mode. (0: off, 1: on)

7.10 Receive Delay1

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

7.11 Receive Delay2

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

7.12 Rx2 Window Data Rate

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

7.13 Rx2 Window Frequency

Feature: Get or Set the Rx2 window frequency

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

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: 220000FF // Set AT+TXP=0.

7.15 RSSI of the Last Received Packet

Feature: Get or Set the Rx2 window frequency

7.16 SNR of the Last Received Packet

Feature: Get the SNR of the last received packet

7.17 Application Port

Feature: Get or set the application port.

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.

7.19 Eight Channel Mode

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

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

7.21 Get or Set RXwindows2 timeout

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

7.22 Setting up uplinkdwelltime (as923, au915)

Feature: Get or Set uplinkdwelltime

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.

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 Uplink fcnt settings（LWS007)

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

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

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.26 Device offline rejoining

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

• Example 1: Downlink Payload: 320105A00B40 // Set AT+DDETECT=1,1440,2880 

7.27 Request the server to send an ACK

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

Same as:

• AT+ADR=0  Reference
• AT+DR=5    Reference
• AT+TXP=0  Reference
  )))