Changes for page End Device AT Commands and Downlink Command

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

From version < 60.9 >

edited by Xiaoling
on 2023/03/27 14:07

To version < 54.1 >

edited by Edwin Chen
on 2022/10/16 07:37

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.Xiaoling
++XWiki.Edwin

Content

@@ -14,20 +14,22 @@
  (((
  **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 =
--* **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:
++* 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:
  ** Use HEX format to send a downlink: [[TTN v3>>Notes for TTN]]
  ** 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 =
@@ -102,8 +102,8 @@
  )))
  )))
--(% style="display:none" %) (%%)
++
  = 4. System Management Commands =
  == 4.1 Change Uplink Interval ==
@@ -141,8 +141,8 @@
  * **Example 1**: Downlink Payload:** 0100001E**               ~/~/ Set Transmit Interval (TDC) = 30 seconds
  * **Example 2**: Downlink Payload:** 0100003C**               ~/~/ Set Transmit Interval (TDC) = 60 seconds
--(% style="display:none" %) (%%)
++
  == 4.2 Reboot End Node ==
@@ -175,10 +175,12 @@
  )))
  (((
--If the downlink payload=**04FF**, the end node will reboot.
--)))
++If the downlink payload=**04FF**, the end node will reboot.
++
++)))
++
  == 4.3 Reset to factory Default ==
@@ -215,6 +215,7 @@
  )))
++
  == 4.4 Show Firmware Version ==
@@ -245,6 +245,7 @@
  (((
++
  **xx: Software Type:**
  )))
@@ -278,6 +278,7 @@
  firmware version: v1.1.0 ~-~-> 110
++
  == 4.5 Show System Configure ==
@@ -303,6 +303,8 @@
  OK
  )))
++
++
  = 5. Keys, IDs and EUIs management =
  == 5.1 Application EUI ==
@@ -321,8 +321,8 @@
  )))
  |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
--(% style="display:none" %) (%%)
++
  == 5.2 Application Key ==
@@ -339,8 +339,8 @@
  )))
  |(% 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
--(% style="display:none" %) (%%)
++
  == 5.3 Application Session Key ==
@@ -359,8 +359,8 @@
  OK
  )))
--(% style="display:none" %) (%%)
++
  == 5.4 Device Address ==
@@ -379,8 +379,8 @@
  )))
  |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK
--(% style="display:none" %) (%%)
++
  == 5.5 Device EUI ==
@@ -399,8 +399,8 @@
  OK
  )))
--(% style="display:none" %) (%%)
++
  == 5.6 Network ID ==
@@ -417,8 +417,8 @@
  )))
  |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
--(% style="display:none" %) (%%)
++
  == 5.7 Network Session Key ==
@@ -435,8 +435,8 @@
  )))
  |(% 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
--(% style="display:none" %) (%%)
++
  = 6. Joining and sending date on LoRaWAN network =
  == 6.1 Confirm Mode ==
@@ -467,8 +467,8 @@
  * **Example 1:** Downlink Payload: 0501            ~/~/ Set AT+CFM=1
  * **Example 2:** Downlink Payload: 0500            ~/~/ Set AT+CFM=0
--(% style="display:none" %) (%%)
++
  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
@@ -514,8 +514,8 @@
  * **Example 1:** Downlink Payload: 05010101           ~/~/ Set AT+CFM=1,1,1
  * **Example 2:** Downlink Payload: 05000700           ~/~/ Set AT+CFM=0,7,0
--(% style="display:none" %) (%%)
++
  == 6.2 Confirm Status ==
@@ -524,13 +524,15 @@
  (% style="color:blue" %)**AT Command: AT+CFS**
--(% 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(((
++(% 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(((
  OK
  )))
++
++
  == 6.3 Join LoRa® Network ==
@@ -548,6 +548,8 @@
  While Error in format, return AT_BUSY_ERROR
  )))
++
++
  == 6.4 LoRa® Network Join Mode ==
@@ -574,8 +574,8 @@
  * **Example 1: **Downlink Payload: **2000                  ** ~/~/ Set AT+NJM=0
  * **Example 2:** Downlink Payload: **2001**                   ~/~/ Set AT+NJM=1
--(% style="display:none" %) (%%)
++
  == 6.5 LoRa® Network Join Status ==
@@ -591,8 +591,8 @@
  OK
  )))
--(% style="display:none" %) (%%)
++
  == 6.6 Print Last Received Data in Raw Format ==
@@ -608,8 +608,8 @@
  OK
  )))
--(% style="display:none" %) (%%)
++
  == 6.7 Print Last Received Data in Binary Format ==
@@ -625,8 +625,8 @@
  OK
  )))
--(% style="display:none" %) (%%)
++
  == 6.8 Send Text Data ==
@@ -640,11 +640,14 @@
  |(% style="width:201px" %)**Command Example**|(% style="width:340px" %)**Function**|(% style="width:446px" %)**Response**
  |(% style="width:201px" %)AT+SEND=12:hello world|(% style="width:340px" %)Send text data along with the application port.|(% style="width:446px" %)OK(((
  While Error in format, return
++
  AT_BUSY_ERROR/AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
++
++
  )))
--(% style="display:none" %) (%%)
++
  == 6.9 Send Hexadecimal Data ==
@@ -658,11 +658,13 @@
  |(% 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
++AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
++
++
  )))
--(% style="display:none" %) (%%)
++
  = 7. LoRaWAN network management =
  == 7.1 Adaptive Data Rate ==
@@ -691,8 +691,8 @@
  * **Example 1**: Downlink Payload: **2201**                       ~/~/ Set AT+ADR=1.
  * **Example 2**: Downlink Payload: **2200FFFF**               ~/~/ Set AT+ADR=0.
--(% style="display:none" %) (%%)
++
  == 7.2 LoRa® Class ==
@@ -711,8 +711,8 @@
  )))
--(% style="display:none" %) (%%)
++
  == 7.3 Duty Cycle Setting ==
@@ -731,8 +731,8 @@
  )))
--(% style="display:none" %) (%%)
++
  == 7.4 Data Rate ==
@@ -739,11 +739,9 @@
  Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
  (% style="color:red" %)
--**Notice:**
++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.
++(%%)
--* 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" %)
@@ -763,8 +763,8 @@
  * **Example 1**: Downlink Payload: **220001FF**                     ~/~/ Set AT+DR=1.
  * **Example 2**: Downlink Payload: **220000FF**                     ~/~/ Set AT+DR=0.
--(% style="display:none" %) (%%)
++
  == 7.5 Frame Counter Downlink ==
@@ -783,6 +783,8 @@
  OK
  )))
++
++
  == 7.6 Frame Counter Uplink ==
  Feature: Get or Set the Frame Counter Uplink.
@@ -800,8 +800,8 @@
  )))
--(% style="display:none" %) (%%)
++
  == 7.7 Join Accept Delay1 ==
@@ -820,8 +820,8 @@
  )))
--(% style="display:none" %) (%%)
++
  == 7.8 Join Accept Delay2 ==
@@ -840,8 +840,8 @@
  )))
--(% style="display:none" %) (%%)
++
  == 7.9 Public Network Mode ==
@@ -869,8 +869,8 @@
  )))
  |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %)
--(% style="display:none" %) (%%)
++
  == 7.10 Receive Delay1 ==
@@ -889,8 +889,8 @@
  )))
--(% style="display:none" %) (%%)
++
  == 7.11 Receive Delay2 ==
@@ -909,8 +909,8 @@
  )))
--(% style="display:none" %) (%%)
++
  == 7.12 Rx2 Window Data Rate ==
@@ -929,8 +929,8 @@
  )))
--(% style="display:none" %) (%%)
++
  == 7.13 Rx2 Window Frequency ==
@@ -949,8 +949,8 @@
  )))
--(% style="display:none" %) (%%)
++
  == 7.14 Transmit Power ==
@@ -978,8 +978,8 @@
  * **Example 1**: Downlink Payload: **22000102**         ~/~/ Set AT+TXP=2.
  * **Example 2**: Downlink Payload: **220000FF**         ~/~/ Set AT+TXP=0.
--(% style="display:none" %) (%%)
++
  == 7.15 RSSI of the Last Received Packet ==
@@ -995,8 +995,8 @@
  OK
  )))
--(% style="display:none" %) (%%)
++
  == 7.16 SNR of the Last Received Packet ==
@@ -1012,8 +1012,8 @@
  OK
  )))
--(% style="display:none" %) (%%)
++
  == 7.17 Application Port ==
@@ -1039,8 +1039,8 @@
  * **Example 1**: Downlink Payload: **2301**          ~/~/ set the application port to 1
  * **Example 2**: Downlink Payload:** 2305**          ~/~/ set the application port to 5
--(% style="display:none" %) (%%)
++
  == 7.18 Single Channel Mode ==
@@ -1057,8 +1057,8 @@
  )))
  |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK
--(% style="display:none" %) (%%)
++
  == 7.19 Eight 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 (LHT65,LHT65N Downlink Command:0x07)**
++(% style="color:blue" %)**Downlink Command: 0x24**
  Format: Command Code (0x24) followed by 1 bytes channel value.
@@ -1086,8 +1086,8 @@
  * **Example 1**: Downlink Payload: 2401           ~/~/ set channel mode to 1
  * **Example 2**: Downlink Payload: 2405           ~/~/ set channel mode to 5
--(% style="display:none" %) (%%)
++
  == 7.20 Get or Set RXwindows1 timeout ==
@@ -1104,19 +1104,25 @@
  )))
  |(% style="width:163px" %)AT+RX1WTO=60|(% style="width:201px" %)Set RXwindows1 timeout|(% style="width:93px" %)OK
--(% style="display:none" %) (%%)
--
  (((
++
++
++
  (% 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.
++
++
  )))
  [[image:image-20220526162535-1.png]]
++
  (((
  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 ==
@@ -1133,8 +1133,8 @@
  )))
  |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK
--(% style="display:none" %) (%%)
++
  == 7.22 Setting up uplinkdwelltime (as923, au915) ==
@@ -1160,8 +1160,8 @@
  * **Example 1**: Downlink Payload: **2501**                    ~/~/ set uplinkdwelltime to 1
  * **Example 2**: Downlink Payload: **2500**                    ~/~/ set uplinkdwelltime to 0
--(% style="display:none" %) (%%)
++
  == 7.23 Set Packet Receiving Response Level ==
@@ -1201,8 +1201,8 @@
  * **Example 1**: Downlink Payload: **2101**                ~/~/ set packet receiving response level to 1
  * **Example 2**: Downlink Payload: **2102**                ~/~/ set packet receiving response level to 2
--(% style="display:none" %) (%%)
++
  == 7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets) ==
@@ -1233,18 +1233,13 @@
  * Example 1: Downlink Payload: 330100                 ~/~/ Set AT+SETMAXNBTRANS=1,0
  * Example 2: Downlink Payload: 330201                 ~/~/ Set AT+SETMAXNBTRANS=2,1
--(% style="display:none" %) (%%)
++
  == 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**
@@ -1276,20 +1276,16 @@
  OK
  )))
--(% style="color:blue" %)**Downlink Command: 0x32**
++(% style="color:blue" %)**Downlink Command: 0x33**
  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.
++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
--** 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.
++* **Example 1:** Downlink Payload: 320105A00B40                     ~/~/ Set AT+DDETECT=1,1440,2880
--(% style="display:none" %) (%%)
++
  == 7.26 Request the server to send an ACK ==
@@ -1303,11 +1303,12 @@
  )))
  |(% style="width:160px" %)**AT+PNACKMD=0**|(% style="width:263px" %)off request the server to send an ACK|(% style="width:109px" %)(((
++
  OK
  )))
--(% style="display:none" %) (%%)
++
  == 7.27 Adjust network rejoining interval ==
@@ -1316,13 +1316,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" %)30(((
++|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30000(((
  OK
--the interval is 30 min
++the interval is 30000ms = 30s
  )))
--|(% 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="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="color:blue" %)**Downlink Command: 0x26**
@@ -1334,8 +1334,8 @@
  * **Example 1:** Downlink Payload: 26000A                 ~/~/ Set AT+RJTDC=10
  * **Example 2: **Downlink Payload: 260002                 ~/~/ Set AT+RJTDC=2
--(% style="display:none" %) (%%)
++
  = 8. AT Commands Combination =
  == 8.1 Set a fix RX2DR for downlink window ==
@@ -1342,11 +1342,10 @@
  * (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
--
  * (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
--(% style="display:none" %) (%%)
++
  == 8.2 Use Downlink Command to set a fix uplink DR ==
@@ -1355,9 +1355,7 @@
  **Same as:**
  * AT+ADR=0    [[Reference>>||anchor="H7.1AdaptiveDataRate"]]
--
  * AT+DR=5      [[Reference>>||anchor="H7.4DataRate"]]
--
  * AT+TXP=0     [[Reference>>||anchor="H7.14TransmitPower"]]

Changes for page End Device AT Commands and Downlink Command

Summary

Details

Applications

Navigation