Last modified by kai on 2024/09/06 10:00
<
From version < 52.13 >
edited by Xiaoling
on 2022/09/19 15:27
To version < 60.3 >
edited by Xiaoling
on 2023/03/27 13:52
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -14,22 +14,20 @@
14 14  
15 15  (((
16 16  **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.**
17 -
18 -
19 -
20 20  )))
21 21  
19 +
22 22  = 2. How to use AT Commands or Downlink command =
23 23  
24 24  
25 -* 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/]]
26 -* 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:
23 +* **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/]]
24 +* **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:
27 27  ** Use HEX format to send a downlink: [[TTN v3>>Notes for TTN]]
28 -** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]]
26 +** 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]]?
29 29  ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server)
30 30  
29 +(% style="display:none" %) (%%)
31 31  
32 -
33 33  = 3. Support End Node and firmware version =
34 34  
35 35  
... ... @@ -104,11 +104,8 @@
104 104  )))
105 105  )))
106 106  
107 -
108 -
109 109  = 4. System Management Commands =
110 110  
111 -
112 112  == 4.1 Change Uplink Interval ==
113 113  
114 114  
... ... @@ -144,8 +144,6 @@
144 144  * **Example 1**: Downlink Payload:** 0100001E**  ~/~/ Set Transmit Interval (TDC) = 30 seconds
145 145  * **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
146 146  
147 -
148 -
149 149  == 4.2 Reboot End Node ==
150 150  
151 151  
... ... @@ -180,7 +180,6 @@
180 180  (((
181 181  If the downlink payload=**04FF**, the end node will reboot.
182 182  
183 -
184 184  
185 185  )))
186 186  
... ... @@ -220,7 +220,6 @@
220 220  )))
221 221  
222 222  
223 -
224 224  == 4.4 Show Firmware Version ==
225 225  
226 226  
... ... @@ -251,7 +251,6 @@
251 251  (((
252 252  
253 253  
254 -
255 255  **xx: Software Type:**
256 256  )))
257 257  
... ... @@ -285,7 +285,6 @@
285 285  firmware version: v1.1.0 ~-~-> 110
286 286  
287 287  
288 -
289 289  == 4.5 Show System Configure ==
290 290  
291 291  
... ... @@ -311,11 +311,8 @@
311 311  OK
312 312  )))
313 313  
314 -
315 -
316 316  = 5. Keys, IDs and EUIs management =
317 317  
318 -
319 319  == 5.1 Application EUI ==
320 320  
321 321  
... ... @@ -332,8 +332,6 @@
332 332  )))
333 333  |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
334 334  
335 -
336 -
337 337  == 5.2 Application Key ==
338 338  
339 339  
... ... @@ -350,8 +350,6 @@
350 350  )))
351 351  |(% 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
352 352  
353 -
354 -
355 355  == 5.3 Application Session Key ==
356 356  
357 357  
... ... @@ -370,8 +370,6 @@
370 370  OK
371 371  )))
372 372  
373 -
374 -
375 375  == 5.4 Device Address ==
376 376  
377 377  
... ... @@ -390,8 +390,6 @@
390 390  )))
391 391  |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK
392 392  
393 -
394 -
395 395  == 5.5 Device EUI ==
396 396  
397 397  
... ... @@ -410,8 +410,6 @@
410 410  OK
411 411  )))
412 412  
413 -
414 -
415 415  == 5.6 Network ID ==
416 416  
417 417  
... ... @@ -428,8 +428,6 @@
428 428  )))
429 429  |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
430 430  
431 -
432 -
433 433  == 5.7 Network Session Key ==
434 434  
435 435  
... ... @@ -446,14 +446,10 @@
446 446  )))
447 447  |(% 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
448 448  
449 -
450 -
451 451  = 6. Joining and sending date on LoRaWAN network =
452 452  
453 -
454 454  == 6.1 Confirm Mode ==
455 455  
456 -
457 457  === 6.1.1  AT+CFM command before DR-LWS007 software stack ===
458 458  
459 459  
... ... @@ -480,8 +480,6 @@
480 480  * **Example 1:** Downlink Payload: 0501  ~/~/ Set AT+CFM=1
481 481  * **Example 2:** Downlink Payload: 0500  ~/~/ Set AT+CFM=0
482 482  
483 -
484 -
485 485  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
486 486  
487 487  
... ... @@ -527,8 +527,6 @@
527 527  * **Example 1:** Downlink Payload: 05010101  ~/~/ Set AT+CFM=1,1,1
528 528  * **Example 2:** Downlink Payload: 05000700  ~/~/ Set AT+CFM=0,7,0
529 529  
530 -
531 -
532 532  == 6.2 Confirm Status ==
533 533  
534 534  
... ... @@ -537,15 +537,13 @@
537 537  
538 538  (% style="color:blue" %)**AT Command: AT+CFS**
539 539  
540 -(% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %)
541 -|=(% colspan="3" style="width: 531px;" %)AT+CFS
542 -|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:178px" %)**Response**
543 -|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:178px" %)0(((
506 +(% border="1" style="background-color:#ffffcc; color:green; width:463px" %)
507 +|=(% colspan="3" style="width: 460px;" %)AT+CFS
508 +|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:107px" %)**Response**
509 +|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:107px" %)0(((
544 544  OK
545 545  )))
546 546  
547 -
548 -
549 549  == 6.3 Join LoRa® Network ==
550 550  
551 551  
... ... @@ -563,8 +563,6 @@
563 563  While Error in format, return AT_BUSY_ERROR
564 564  )))
565 565  
566 -
567 -
568 568  == 6.4 LoRa® Network Join Mode ==
569 569  
570 570  
... ... @@ -591,8 +591,6 @@
591 591  * **Example 1: **Downlink Payload: **2000                  ** ~/~/ Set AT+NJM=0
592 592  * **Example 2:** Downlink Payload: **2001**  ~/~/ Set AT+NJM=1
593 593  
594 -
595 -
596 596  == 6.5 LoRa® Network Join Status ==
597 597  
598 598  
... ... @@ -608,8 +608,6 @@
608 608  OK
609 609  )))
610 610  
611 -
612 -
613 613  == 6.6 Print Last Received Data in Raw Format ==
614 614  
615 615  
... ... @@ -625,8 +625,6 @@
625 625  OK
626 626  )))
627 627  
628 -
629 -
630 630  == 6.7 Print Last Received Data in Binary Format ==
631 631  
632 632  
... ... @@ -642,8 +642,6 @@
642 642  OK
643 643  )))
644 644  
645 -
646 -
647 647  == 6.8 Send Text Data ==
648 648  
649 649  
... ... @@ -663,8 +663,6 @@
663 663  
664 664  )))
665 665  
666 -
667 -
668 668  == 6.9 Send Hexadecimal Data ==
669 669  
670 670  
... ... @@ -683,11 +683,8 @@
683 683  
684 684  )))
685 685  
686 -
687 -
688 688  = 7. LoRaWAN network management =
689 689  
690 -
691 691  == 7.1 Adaptive Data Rate ==
692 692  
693 693  
... ... @@ -714,8 +714,6 @@
714 714  * **Example 1**: Downlink Payload: **2201**  ~/~/ Set AT+ADR=1.
715 715  * **Example 2**: Downlink Payload: **2200FFFF**  ~/~/ Set AT+ADR=0.
716 716  
717 -
718 -
719 719  == 7.2 LoRa® Class ==
720 720  
721 721  
... ... @@ -734,8 +734,6 @@
734 734  
735 735  )))
736 736  
737 -
738 -
739 739  == 7.3 Duty Cycle Setting ==
740 740  
741 741  
... ... @@ -754,14 +754,17 @@
754 754  
755 755  )))
756 756  
757 -
758 -
759 759  == 7.4 Data Rate ==
760 760  
761 761  
762 -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
705 +Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
763 763  
707 +(% style="color:red" %)
708 +**Notice:**
764 764  
710 +* 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.
711 +* 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/]]
712 +
765 765  (% style="color:blue" %)**AT Command: AT+DR**
766 766  
767 767  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
... ... @@ -781,8 +781,6 @@
781 781  * **Example 1**: Downlink Payload: **220001FF**  ~/~/ Set AT+DR=1.
782 782  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+DR=0.
783 783  
784 -
785 -
786 786  == 7.5 Frame Counter Downlink ==
787 787  
788 788  
... ... @@ -801,8 +801,6 @@
801 801  OK
802 802  )))
803 803  
804 -
805 -
806 806  == 7.6 Frame Counter Uplink ==
807 807  
808 808  Feature: Get or Set the Frame Counter Uplink.
... ... @@ -820,8 +820,6 @@
820 820  
821 821  )))
822 822  
823 -
824 -
825 825  == 7.7 Join Accept Delay1 ==
826 826  
827 827  
... ... @@ -840,8 +840,6 @@
840 840  
841 841  )))
842 842  
843 -
844 -
845 845  == 7.8 Join Accept Delay2 ==
846 846  
847 847  
... ... @@ -860,8 +860,6 @@
860 860  
861 861  )))
862 862  
863 -
864 -
865 865  == 7.9 Public Network Mode ==
866 866  
867 867  
... ... @@ -889,8 +889,6 @@
889 889  )))
890 890  |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %)
891 891  
892 -
893 -
894 894  == 7.10 Receive Delay1 ==
895 895  
896 896  
... ... @@ -909,8 +909,6 @@
909 909  
910 910  )))
911 911  
912 -
913 -
914 914  == 7.11 Receive Delay2 ==
915 915  
916 916  
... ... @@ -929,8 +929,6 @@
929 929  
930 930  )))
931 931  
932 -
933 -
934 934  == 7.12 Rx2 Window Data Rate ==
935 935  
936 936  
... ... @@ -949,8 +949,6 @@
949 949  
950 950  )))
951 951  
952 -
953 -
954 954  == 7.13 Rx2 Window Frequency ==
955 955  
956 956  
... ... @@ -969,8 +969,6 @@
969 969  
970 970  )))
971 971  
972 -
973 -
974 974  == 7.14 Transmit Power ==
975 975  
976 976  
... ... @@ -998,8 +998,6 @@
998 998  * **Example 1**: Downlink Payload: **22000102**  ~/~/ Set AT+TXP=2.
999 999  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+TXP=0.
1000 1000  
1001 -
1002 -
1003 1003  == 7.15 RSSI of the Last Received Packet ==
1004 1004  
1005 1005  
... ... @@ -1015,8 +1015,6 @@
1015 1015  OK
1016 1016  )))
1017 1017  
1018 -
1019 -
1020 1020  == 7.16 SNR of the Last Received Packet ==
1021 1021  
1022 1022  
... ... @@ -1032,8 +1032,6 @@
1032 1032  OK
1033 1033  )))
1034 1034  
1035 -
1036 -
1037 1037  == 7.17 Application Port ==
1038 1038  
1039 1039  
... ... @@ -1059,8 +1059,6 @@
1059 1059  * **Example 1**: Downlink Payload: **2301**  ~/~/ set the application port to 1
1060 1060  * **Example 2**: Downlink Payload:** 2305**  ~/~/ set the application port to 5
1061 1061  
1062 -
1063 -
1064 1064  == 7.18 Single Channel Mode ==
1065 1065  
1066 1066  
... ... @@ -1077,8 +1077,6 @@
1077 1077  )))
1078 1078  |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK
1079 1079  
1080 -
1081 -
1082 1082  == 7.19 Eight Channel Mode ==
1083 1083  
1084 1084  
... ... @@ -1097,7 +1097,7 @@
1097 1097  )))
1098 1098  |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK
1099 1099  
1100 -(% style="color:blue" %)**Downlink Command: 0x24**
1018 +(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**
1101 1101  
1102 1102  Format: Command Code (0x24) followed by 1 bytes channel value.
1103 1103  
... ... @@ -1106,8 +1106,6 @@
1106 1106  * **Example 1**: Downlink Payload: 2401  ~/~/ set channel mode to 1
1107 1107  * **Example 2**: Downlink Payload: 2405  ~/~/ set channel mode to 5
1108 1108  
1109 -
1110 -
1111 1111  == 7.20 Get or Set RXwindows1 timeout ==
1112 1112  
1113 1113  
... ... @@ -1139,7 +1139,6 @@
1139 1139  (((
1140 1140  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.
1141 1141  
1142 -
1143 1143  
1144 1144  )))
1145 1145  
... ... @@ -1159,8 +1159,6 @@
1159 1159  )))
1160 1160  |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK
1161 1161  
1162 -
1163 -
1164 1164  == 7.22 Setting up uplinkdwelltime (as923, au915) ==
1165 1165  
1166 1166  
... ... @@ -1186,8 +1186,6 @@
1186 1186  * **Example 1**: Downlink Payload: **2501**  ~/~/ set uplinkdwelltime to 1
1187 1187  * **Example 2**: Downlink Payload: **2500**  ~/~/ set uplinkdwelltime to 0
1188 1188  
1189 -
1190 -
1191 1191  == 7.23 Set Packet Receiving Response Level ==
1192 1192  
1193 1193  
... ... @@ -1208,7 +1208,6 @@
1208 1208  * For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command.
1209 1209  * 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.
1210 1210  
1211 -
1212 1212  (% style="color:blue" %)**AT Command: AT+RPL**
1213 1213  
1214 1214  (% border="1" style="background-color:#ffffcc; color:green; width:536.222px" %)
... ... @@ -1228,8 +1228,6 @@
1228 1228  * **Example 1**: Downlink Payload: **2101**  ~/~/ set packet receiving response level to 1
1229 1229  * **Example 2**: Downlink Payload: **2102**  ~/~/ set packet receiving response level to 2
1230 1230  
1231 -
1232 -
1233 1233  == 7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets) ==
1234 1234  
1235 1235  
... ... @@ -1260,13 +1260,16 @@
1260 1260  * Example 1: Downlink Payload: 330100  ~/~/ Set AT+SETMAXNBTRANS=1,0
1261 1261  * Example 2: Downlink Payload: 330201  ~/~/ Set AT+SETMAXNBTRANS=2,1
1262 1262  
1263 -
1264 -
1265 1265  == 7.25 Device offline rejoining （LWS007) ==
1266 1266  
1267 1267  
1268 1268  (% style="color:blue" %)**AT Command: AT+DDETECT**
1269 1269  
1176 +AT+DDETECT=<Flag>,<ACK_Timout_1>,<ACK_Timout_2> (Default Value: AT+DDETECT=1,1440,2880)
1177 +
1178 +* ACK_Timout_1: Unit: min
1179 +* ACK_Timout_2: Unit: min
1180 +
1270 1270  (% border="1" style="background-color:#ffffcc; color:green; width:710.222px" %)
1271 1271  |=(% colspan="3" style="width: 707px;" %)AT+**DDETECT**
1272 1272  |(% style="width:160px" %)**Command Example**|(% style="width:198px" %)**Function**|(% style="width:349px" %)**Response**
... ... @@ -1298,16 +1298,18 @@
1298 1298  OK
1299 1299  )))
1300 1300  
1301 -(% style="color:blue" %)**Downlink Command: 0x33**
1212 +(% style="color:blue" %)**Downlink Command: 0x32**
1302 1302  
1303 1303  Format: Command Code (0x32) followed by 2 bytes mode value.
1304 1304  
1305 -If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 33.
1216 +If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 32.
1306 1306  
1307 -* **Example 1:** Downlink Payload: 320105A00B40  ~/~/ Set AT+DDETECT=1,1440,2880
1218 +* **Example 1:** Downlink Payload: 320105A00B40  ~/~/ Set AT+DDETECT=1,1440,2880
1219 +** 0x01 : Flag
1220 +** 0x05A0: ACK_Timout_1 : 1440minutes (24 hours)
1221 +** 0x0B40: ACK_Timout_2 : 2880minutes (48 hours)
1222 +** **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.
1308 1308  
1309 -
1310 -
1311 1311  == 7.26 Request the server to send an ACK ==
1312 1312  
1313 1313  
... ... @@ -1325,9 +1325,6 @@
1325 1325  OK
1326 1326  )))
1327 1327  
1328 -
1329 -
1330 -
1331 1331  == 7.27 Adjust network rejoining interval ==
1332 1332  
1333 1333  
... ... @@ -1336,13 +1336,13 @@
1336 1336  (% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %)
1337 1337  |=(% colspan="3" style="width: 724px;" %)AT+RJTDC
1338 1338  |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response**
1339 -|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30000(((
1249 +|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30(((
1340 1340  OK
1341 1341  
1342 -the interval is 30000ms = 30s
1252 +the interval is 30 min
1343 1343  )))
1344 -|(% style="width:165px" %)AT+RJTDC=60000|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK(((
1345 -Set the ReJoin data transmission interval to 60000ms = 60 seconds
1254 +|(% style="width:165px" %)AT+RJTDC=60|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK(((
1255 +Set the ReJoin data transmission interval to 60 min
1346 1346  )))
1347 1347  
1348 1348  (% style="color:blue" %)**Downlink Command: 0x26**
... ... @@ -1354,11 +1354,8 @@
1354 1354  * **Example 1:** Downlink Payload: 26000A  ~/~/ Set AT+RJTDC=10
1355 1355  * **Example 2: **Downlink Payload: 260002  ~/~/ Set AT+RJTDC=2
1356 1356  
1357 -
1358 -
1359 1359  = 8. AT Commands Combination =
1360 1360  
1361 -
1362 1362  == 8.1 Set a fix RX2DR for downlink window ==
1363 1363  
1364 1364  
... ... @@ -1365,8 +1365,6 @@
1365 1365  * (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
1366 1366  * (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1367 1367  
1368 -
1369 -
1370 1370  == 8.2 Use Downlink Command to set a fix uplink DR ==
1371 1371  
1372 1372  

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0