Contens

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

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.
 

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

3. Support End Node and firmware version

4. System Management Commands

4.1 Change Uplink Interval

Feature: Change LoRaWAN End Node Transmit Interval.

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

4.2 Reboot End Node

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

Format: Command Code (0x04) followed by FF.

If the downlink payload=04FF, the end node will reboot.

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.

Format: Command Code (0x04) followed by FE.

If the downlink payload=04FE, Reset Parameters to Factory Default, Keys Reserve.

4.4 Show Firmware Version

Feature: Show firmware version. No downlink command yet.

Downlink Format: 0x26

Device will reply with firmware version info, device info. frequency band info. detail please check device user manual. Total 5 bytes Example: If device is of firmware version 1.1.0 Upload: xx -- yy -- zz -- 110 total 5 bytes

xx: Software Type:

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

yy: Frequency Band:

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

zz: Subband

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

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=O
• 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) . 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

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)

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

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: 220000FF // 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

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

AT+RX1TWO is theRxSingle timeout value of receive window 1. If it is not set, then the queriedvalue is the default value. If it is set, then the queried value is the setvalue. AT+RX2TWO is thesame as above. The definitionof RxSingle timeout is as described in the following paragraph.

Increasing thisvalue is equal to extending the time that the receiving window is opened, butthe corresponding power consumption will also increase. Properly increasingthis value can increase the success rate of the downlink.

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

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