Changes for page End Device AT Commands and Downlink Command

Last modified by kai on 2024/09/06 10:00

From version < 52.6 >

edited by Xiaoling
on 2022/08/12 16:46

To version < 60.3 >

edited by Xiaoling
on 2023/03/27 13:52

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -9,27 +9,25 @@
  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.
++* (% style="color:blue" %)**Common Commands:** (%%) They should be available for each sensor, such as: change uplink interval, reset device.
++* (% style="color:blue" %)**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>>url:http://www.dragino.com/]]
--* 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:
++* **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>>url:http://www.dragino.com/]]
++* **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>>Notes for TTN]]
--** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]]
++** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]], [[How to Convert>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.1ConvertHEXtoBase64]]?
  ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server)
++(% style="display:none" %) (%%)
--
  = 3. Support End Node and firmware version =
@@ -104,12 +104,8 @@
  )))
  )))
--
--
--
  = 4. System Management Commands =
--
  == 4.1 Change Uplink Interval ==
@@ -139,16 +139,12 @@
  )))
  (((
--If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
++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 ==
@@ -183,7 +183,6 @@
  (((
  If the downlink payload=**04FF**, the end node will reboot.
--
  )))
@@ -223,7 +223,6 @@
  )))
--
  == 4.4 Show Firmware Version ==
@@ -254,7 +254,6 @@
  (((
--
  **xx: Software Type:**
  )))
@@ -288,7 +288,6 @@
  firmware version: v1.1.0 ~-~-> 110
--
  == 4.5 Show System Configure ==
@@ -314,12 +314,8 @@
  OK
  )))
--
--
--
  = 5. Keys, IDs and EUIs management =
--
  == 5.1 Application EUI ==
@@ -336,9 +336,6 @@
  )))
  |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
--
--
--
  == 5.2 Application Key ==
@@ -355,9 +355,6 @@
  )))
  |(% style="width:441px" %)AT+APPKEY=00 35 55 55 22 23 55 53 43 24 23 42 34 35 35 35|(% style="width:180px" %)Set the Application Key|(% style="width:350px" %)OK
--
--
--
  == 5.3 Application Session Key ==
@@ -376,9 +376,6 @@
  OK
  )))
--
--
--
  == 5.4 Device Address ==
@@ -397,9 +397,6 @@
  )))
  |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK
--
--
--
  == 5.5 Device EUI ==
@@ -418,9 +418,6 @@
  OK
  )))
--
--
--
  == 5.6 Network ID ==
@@ -437,9 +437,6 @@
  )))
  |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
--
--
--
  == 5.7 Network Session Key ==
@@ -456,15 +456,10 @@
  )))
  |(% style="width:455px" %)AT+NWKSKEY=A8 40 41 FF FF 12 34 56 00 01 02 04 05 06 06 07|(% style="width:215px" %)Set the Network Session Key.|(% style="width:343px" %)OK
--
--
--
  = 6. Joining and sending date on LoRaWAN network =
--
  == 6.1 Confirm Mode ==
--
  === 6.1.1  AT+CFM command before DR-LWS007 software stack ===
@@ -491,9 +491,6 @@
  * **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 ===
@@ -539,9 +539,6 @@
  * **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 ==
@@ -550,16 +550,13 @@
  (% style="color:blue" %)**AT Command: AT+CFS**
--(% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %)
--|=(% colspan="3" style="width: 531px;" %)AT+CFS
--|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:178px" %)**Response**
--|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:178px" %)0(((
++(% border="1" style="background-color:#ffffcc; color:green; width:463px" %)
++|=(% colspan="3" style="width: 460px;" %)AT+CFS
++|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:107px" %)**Response**
++|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:107px" %)0(((
  OK
  )))
--
--
--
  == 6.3 Join LoRa® Network ==
@@ -577,9 +577,6 @@
  While Error in format, return AT_BUSY_ERROR
  )))
--
--
--
  == 6.4 LoRa® Network Join Mode ==
@@ -606,9 +606,6 @@
  * **Example 1: **Downlink Payload: **2000                  ** ~/~/ Set AT+NJM=0
  * **Example 2:** Downlink Payload: **2001**                   ~/~/ Set AT+NJM=1
--
--
--
  == 6.5 LoRa® Network Join Status ==
@@ -624,9 +624,6 @@
  OK
  )))
--
--
--
  == 6.6 Print Last Received Data in Raw Format ==
@@ -642,9 +642,6 @@
  OK
  )))
--
--
--
  == 6.7 Print Last Received Data in Binary Format ==
@@ -660,9 +660,6 @@
  OK
  )))
--
--
--
  == 6.8 Send Text Data ==
@@ -690,11 +690,11 @@
  (% style="color:blue" %)**AT Command: AT+SENDB**
--(% border="1" style="background-color:#ffffcc; color:green; width:1120.22px" %)
--|=(% colspan="3" style="width: 1117px;" %)AT+SENDB
--|(% style="width:257px" %)**Command Example**|(% style="width:406px" %)**Function**|(% style="width:453px" %)**Response**
--|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:406px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK
--|(% style="width:257px" %)AT+SENDB=abcdef0123456789|(% style="width:406px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)While Error in format, return(((
++(% border="1" style="background-color:#ffffcc; color:green; width:1101px" %)
++|=(% colspan="3" style="width: 1098px;" %)AT+SENDB
++|(% style="width:257px" %)**Command Example**|(% style="width:394px" %)**Function**|(% style="width:446px" %)**Response**
++|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)OK
++|(% style="width:257px" %)AT+SENDB=abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)While Error in format, return(((
  AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
@@ -702,7 +702,6 @@
  = 7. LoRaWAN network management =
--
  == 7.1 Adaptive Data Rate ==
@@ -735,7 +735,7 @@
  Feature: Get or Set the Device Class(Currently only support class A, class C).
--(% style="color:blue" %)**AT Command:AT+CLASS**
++(% style="color:blue" %)**AT Command:  AT+CLASS**
  (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %)
  |=(% colspan="3" style="width: 504px;" %)AT+CLASS
@@ -750,10 +750,10 @@
  == 7.3 Duty Cycle Setting ==
--Feature: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing.
++Feature: Get or Set the ETSI Duty Cycle setting** - 0**=disable, **1**=enable - Only for testing.
--(% style="color:blue" %)**AT Command:AT+DCS**
++(% style="color:blue" %)**AT Command:  AT+DCS**
  (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %)
  |=(% colspan="3" style="width: 512px;" %)AT+DCS
@@ -768,9 +768,14 @@
  == 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
++Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
++(% style="color:red" %)
++**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>>https://lora-alliance.org/resource_hub/rp2-1-0-3-lorawan-regional-parameters/]]
++
  (% style="color:blue" %)**AT Command: AT+DR**
  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
@@ -796,7 +796,7 @@
  Feature: Get or Set the Frame Counter Downlink.
--(% style="color:blue" %)**AT Command:AT+FCD**
++(% style="color:blue" %)**AT Command:  AT+FCD**
  (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %)
  |=(% colspan="3" style="width: 690px;" %)AT+FCD
@@ -813,7 +813,7 @@
  Feature: Get or Set the Frame Counter Uplink.
--(% style="color:blue" %)**AT Command:AT+FCU**
++(% style="color:blue" %)**AT Command:  AT+FCU**
  (% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %)
  |=(% colspan="3" style="width: 531px;" %)AT+FCU
@@ -831,7 +831,7 @@
  Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms.
--(% style="color:blue" %)**AT Command:AT+JN1DL**
++(% style="color:blue" %)**AT Command:  AT+JN1DL**
  (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %)
  |=(% colspan="3" style="width: 534px;" %)AT+JN1DL
@@ -845,10 +845,11 @@
  == 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.
--(% style="color:blue" %)**AT Command:AT+JN2DL**
++(% style="color:blue" %)**AT Command:  AT+JN2DL**
  (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %)
  |=(% colspan="3" style="width: 535px;" %)AT+JN2DL
@@ -868,7 +868,7 @@
  (% style="color:red" %)**Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network.**
--(% style="color:blue" %)**AT Command:AT+PNM**
++(% style="color:blue" %)**AT Command:  AT+PNM**
  (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %)
  |=(% colspan="3" style="width: 664px;" %)AT+PNM
@@ -893,7 +893,7 @@
  Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms
--(% style="color:blue" %)**AT Command:AT+RX1DL**
++(% style="color:blue" %)**AT Command: AT+RX1DL**
  (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %)
  |=(% colspan="3" style="width: 405px;" %)AT+RX1DL
@@ -911,7 +911,7 @@
  Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms
--(% style="color:blue" %)**AT Command:AT+RX2DL**
++(% style="color:blue" %)**AT Command: AT+RX2DL**
  (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %)
  |=(% colspan="3" style="width: 478px;" %)AT+RX2DL
@@ -929,7 +929,7 @@
  Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X)
--(% style="color:blue" %)**AT Command:AT+RX2DR**
++(% style="color:blue" %)**AT Command:  AT+RX2DR**
  (% border="1" style="background-color:#ffffcc; color:green; width:525.222px" %)
  |=(% colspan="3" style="width: 522px;" %)AT+RX2DR
@@ -947,7 +947,7 @@
  Feature: Get or Set the Rx2 window frequency
--(% style="color:blue" %)**AT Command:AT+RX2FQ**
++(% style="color:blue" %)**AT Command:  AT+RX2FQ**
  (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %)
  |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ
@@ -964,10 +964,10 @@
  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
++(% style="color:red" %)**Notice: Transmit Power might be changed by ADR from LoRaWAN server. So manually change TXP also remember to set AT+ADR=0 in sensor**
--(% style="color:blue" %)**AT Command:AT+TXP**
++(% style="color:blue" %)**AT Command:  AT+TXP**
  (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %)
  |=(% colspan="3" style="width: 462px;" %)AT+TXP
@@ -986,7 +986,6 @@
  * **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 ==
@@ -1008,7 +1008,7 @@
  Feature: Get the SNR of the last received packet
--(% style="color:blue" %)**AT Command:AT+SNR**
++(% style="color:blue" %)**AT Command:  AT+SNR**
  (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %)
  |=(% colspan="3" style="width: 568px;" %)AT+SNR
@@ -1042,7 +1042,6 @@
  * **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 ==
@@ -1077,7 +1077,7 @@
  )))
  |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK
--(% style="color:blue" %)**Downlink Command: 0x24**
++(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**
  Format: Command Code (0x24) followed by 1 bytes channel value.
@@ -1086,7 +1086,6 @@
  * **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 ==
@@ -1106,8 +1106,9 @@
  (((
--**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.
++(% style="color:blue" %)**AT+RX1WTO**(%%) 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.
++
  )))
@@ -1161,7 +1161,6 @@
  * **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 ==
@@ -1201,7 +1201,6 @@
  * **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) ==
@@ -1232,12 +1232,16 @@
  * 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) ==
  (% style="color:blue" %)**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
++
  (% border="1" style="background-color:#ffffcc; color:green; width:710.222px" %)
  |=(% colspan="3" style="width: 707px;" %)AT+**DDETECT**
  |(% style="width:160px" %)**Command Example**|(% style="width:198px" %)**Function**|(% style="width:349px" %)**Response**
@@ -1269,15 +1269,18 @@
  OK
  )))
--(% style="color:blue" %)**Downlink Command: 0x33**
++(% style="color:blue" %)**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 33.
++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
++* **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 ==
@@ -1303,13 +1303,13 @@
  (% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %)
  |=(% colspan="3" style="width: 724px;" %)AT+RJTDC
  |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response**
--|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30000(((
++|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30(((
  OK
--the interval is 30000ms = 30s
++the interval is 30 min
  )))
--|(% style="width:165px" %)AT+RJTDC=60000|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK(((
--Set the ReJoin data transmission interval to 60000ms = 60 seconds
++|(% style="width:165px" %)AT+RJTDC=60|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK(((
++Set the ReJoin data transmission interval to 60 min
  )))
  (% style="color:blue" %)**Downlink Command: 0x26**
@@ -1321,17 +1321,14 @@
  * **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
++* (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
++* (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
--
  == 8.2 Use Downlink Command to set a fix uplink DR ==

Changes for page End Device AT Commands and Downlink Command

Summary

Details

Applications

Navigation