End Device AT Commands and Downlink Commands

From Wiki for Dragino Project
Revision as of 10:34, 30 October 2020 by Edwin (Talk | contribs) (Reset to factory Default)

Jump to: navigation, search

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

Example:

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

Example:

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

Example:

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.

AT Command: AT+VER

Example:

AT+VER: Image Version and Frequency Band
Command Example Function Response
AT+VER=? Show Image version and Frequency Band
1.3 EU868
OK



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.