Last modified by kai on 2024/09/06 10:00
<
From version < 60.1 >
edited by Edwin Chen
on 2023/03/25 15:30
To version < 54.1 >
edited by Edwin Chen
on 2022/10/16 07:37
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -14,6 +14,7 @@
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 +
17 17  
18 18  
19 19  )))
... ... @@ -21,13 +21,14 @@
21 21  = 2. How to use AT Commands or Downlink command =
22 22  
23 23  
24 -* **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/]]
25 -* **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:
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:
26 26  ** Use HEX format to send a downlink: [[TTN v3>>Notes for TTN]]
27 27  ** 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]]?
28 28  ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server)
29 29  
30 30  
32 +
31 31  = 3. Support End Node and firmware version =
32 32  
33 33  
... ... @@ -103,6 +103,7 @@
103 103  )))
104 104  
105 105  
108 +
106 106  = 4. System Management Commands =
107 107  
108 108  == 4.1 Change Uplink Interval ==
... ... @@ -141,6 +141,7 @@
141 141  * **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
142 142  
143 143  
147 +
144 144  == 4.2 Reboot End Node ==
145 145  
146 146  
... ... @@ -175,6 +175,7 @@
175 175  (((
176 176  If the downlink payload=**04FF**, the end node will reboot.
177 177  
182 +
178 178  
179 179  )))
180 180  
... ... @@ -214,6 +214,7 @@
214 214  )))
215 215  
216 216  
222 +
217 217  == 4.4 Show Firmware Version ==
218 218  
219 219  
... ... @@ -244,6 +244,7 @@
244 244  (((
245 245  
246 246  
253 +
247 247  **xx: Software Type:**
248 248  )))
249 249  
... ... @@ -277,6 +277,7 @@
277 277  firmware version: v1.1.0 ~-~-> 110
278 278  
279 279  
287 +
280 280  == 4.5 Show System Configure ==
281 281  
282 282  
... ... @@ -303,6 +303,7 @@
303 303  )))
304 304  
305 305  
314 +
306 306  = 5. Keys, IDs and EUIs management =
307 307  
308 308  == 5.1 Application EUI ==
... ... @@ -322,6 +322,7 @@
322 322  |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
323 323  
324 324  
334 +
325 325  == 5.2 Application Key ==
326 326  
327 327  
... ... @@ -339,6 +339,7 @@
339 339  |(% 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
340 340  
341 341  
352 +
342 342  == 5.3 Application Session Key ==
343 343  
344 344  
... ... @@ -358,6 +358,7 @@
358 358  )))
359 359  
360 360  
372 +
361 361  == 5.4 Device Address ==
362 362  
363 363  
... ... @@ -377,6 +377,7 @@
377 377  |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK
378 378  
379 379  
392 +
380 380  == 5.5 Device EUI ==
381 381  
382 382  
... ... @@ -396,6 +396,7 @@
396 396  )))
397 397  
398 398  
412 +
399 399  == 5.6 Network ID ==
400 400  
401 401  
... ... @@ -413,6 +413,7 @@
413 413  |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
414 414  
415 415  
430 +
416 416  == 5.7 Network Session Key ==
417 417  
418 418  
... ... @@ -430,6 +430,7 @@
430 430  |(% 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
431 431  
432 432  
448 +
433 433  = 6. Joining and sending date on LoRaWAN network =
434 434  
435 435  == 6.1 Confirm Mode ==
... ... @@ -461,6 +461,7 @@
461 461  * **Example 2:** Downlink Payload: 0500  ~/~/ Set AT+CFM=0
462 462  
463 463  
480 +
464 464  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
465 465  
466 466  
... ... @@ -507,6 +507,7 @@
507 507  * **Example 2:** Downlink Payload: 05000700  ~/~/ Set AT+CFM=0,7,0
508 508  
509 509  
527 +
510 510  == 6.2 Confirm Status ==
511 511  
512 512  
... ... @@ -515,14 +515,15 @@
515 515  
516 516  (% style="color:blue" %)**AT Command: AT+CFS**
517 517  
518 -(% border="1" style="background-color:#ffffcc; color:green; width:463px" %)
519 -|=(% colspan="3" style="width: 460px;" %)AT+CFS
520 -|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:107px" %)**Response**
521 -|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:107px" %)0(((
536 +(% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %)
537 +|=(% colspan="3" style="width: 531px;" %)AT+CFS
538 +|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:178px" %)**Response**
539 +|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:178px" %)0(((
522 522  OK
523 523  )))
524 524  
525 525  
544 +
526 526  == 6.3 Join LoRa® Network ==
527 527  
528 528  
... ... @@ -541,6 +541,7 @@
541 541  )))
542 542  
543 543  
563 +
544 544  == 6.4 LoRa® Network Join Mode ==
545 545  
546 546  
... ... @@ -568,6 +568,7 @@
568 568  * **Example 2:** Downlink Payload: **2001**  ~/~/ Set AT+NJM=1
569 569  
570 570  
591 +
571 571  == 6.5 LoRa® Network Join Status ==
572 572  
573 573  
... ... @@ -584,6 +584,7 @@
584 584  )))
585 585  
586 586  
608 +
587 587  == 6.6 Print Last Received Data in Raw Format ==
588 588  
589 589  
... ... @@ -600,6 +600,7 @@
600 600  )))
601 601  
602 602  
625 +
603 603  == 6.7 Print Last Received Data in Binary Format ==
604 604  
605 605  
... ... @@ -616,6 +616,7 @@
616 616  )))
617 617  
618 618  
642 +
619 619  == 6.8 Send Text Data ==
620 620  
621 621  
... ... @@ -636,6 +636,7 @@
636 636  )))
637 637  
638 638  
663 +
639 639  == 6.9 Send Hexadecimal Data ==
640 640  
641 641  
... ... @@ -655,6 +655,7 @@
655 655  )))
656 656  
657 657  
683 +
658 658  = 7. LoRaWAN network management =
659 659  
660 660  == 7.1 Adaptive Data Rate ==
... ... @@ -684,6 +684,7 @@
684 684  * **Example 2**: Downlink Payload: **2200FFFF**  ~/~/ Set AT+ADR=0.
685 685  
686 686  
713 +
687 687  == 7.2 LoRa® Class ==
688 688  
689 689  
... ... @@ -703,6 +703,7 @@
703 703  )))
704 704  
705 705  
733 +
706 706  == 7.3 Duty Cycle Setting ==
707 707  
708 708  
... ... @@ -722,6 +722,7 @@
722 722  )))
723 723  
724 724  
753 +
725 725  == 7.4 Data Rate ==
726 726  
727 727  
... ... @@ -728,11 +728,9 @@
728 728  Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
729 729  
730 730  (% style="color:red" %)
731 -**Notice:**
760 +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.
761 +(%%)
732 732  
733 -* 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.
734 -* 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/]]
735 -
736 736  (% style="color:blue" %)**AT Command: AT+DR**
737 737  
738 738  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
... ... @@ -753,6 +753,7 @@
753 753  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+DR=0.
754 754  
755 755  
783 +
756 756  == 7.5 Frame Counter Downlink ==
757 757  
758 758  
... ... @@ -772,6 +772,7 @@
772 772  )))
773 773  
774 774  
803 +
775 775  == 7.6 Frame Counter Uplink ==
776 776  
777 777  Feature: Get or Set the Frame Counter Uplink.
... ... @@ -790,6 +790,7 @@
790 790  )))
791 791  
792 792  
822 +
793 793  == 7.7 Join Accept Delay1 ==
794 794  
795 795  
... ... @@ -809,6 +809,7 @@
809 809  )))
810 810  
811 811  
842 +
812 812  == 7.8 Join Accept Delay2 ==
813 813  
814 814  
... ... @@ -828,6 +828,7 @@
828 828  )))
829 829  
830 830  
862 +
831 831  == 7.9 Public Network Mode ==
832 832  
833 833  
... ... @@ -856,6 +856,7 @@
856 856  |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %)
857 857  
858 858  
891 +
859 859  == 7.10 Receive Delay1 ==
860 860  
861 861  
... ... @@ -875,6 +875,7 @@
875 875  )))
876 876  
877 877  
911 +
878 878  == 7.11 Receive Delay2 ==
879 879  
880 880  
... ... @@ -894,6 +894,7 @@
894 894  )))
895 895  
896 896  
931 +
897 897  == 7.12 Rx2 Window Data Rate ==
898 898  
899 899  
... ... @@ -913,6 +913,7 @@
913 913  )))
914 914  
915 915  
951 +
916 916  == 7.13 Rx2 Window Frequency ==
917 917  
918 918  
... ... @@ -932,6 +932,7 @@
932 932  )))
933 933  
934 934  
971 +
935 935  == 7.14 Transmit Power ==
936 936  
937 937  
... ... @@ -960,6 +960,7 @@
960 960  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+TXP=0.
961 961  
962 962  
1000 +
963 963  == 7.15 RSSI of the Last Received Packet ==
964 964  
965 965  
... ... @@ -976,6 +976,7 @@
976 976  )))
977 977  
978 978  
1017 +
979 979  == 7.16 SNR of the Last Received Packet ==
980 980  
981 981  
... ... @@ -992,6 +992,7 @@
992 992  )))
993 993  
994 994  
1034 +
995 995  == 7.17 Application Port ==
996 996  
997 997  
... ... @@ -1018,6 +1018,7 @@
1018 1018  * **Example 2**: Downlink Payload:** 2305**  ~/~/ set the application port to 5
1019 1019  
1020 1020  
1061 +
1021 1021  == 7.18 Single Channel Mode ==
1022 1022  
1023 1023  
... ... @@ -1035,6 +1035,7 @@
1035 1035  |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK
1036 1036  
1037 1037  
1079 +
1038 1038  == 7.19 Eight Channel Mode ==
1039 1039  
1040 1040  
... ... @@ -1053,7 +1053,7 @@
1053 1053  )))
1054 1054  |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK
1055 1055  
1056 -(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**
1098 +(% style="color:blue" %)**Downlink Command: 0x24**
1057 1057  
1058 1058  Format: Command Code (0x24) followed by 1 bytes channel value.
1059 1059  
... ... @@ -1063,6 +1063,7 @@
1063 1063  * **Example 2**: Downlink Payload: 2405  ~/~/ set channel mode to 5
1064 1064  
1065 1065  
1108 +
1066 1066  == 7.20 Get or Set RXwindows1 timeout ==
1067 1067  
1068 1068  
... ... @@ -1094,6 +1094,7 @@
1094 1094  (((
1095 1095  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.
1096 1096  
1140 +
1097 1097  
1098 1098  )))
1099 1099  
... ... @@ -1114,6 +1114,7 @@
1114 1114  |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK
1115 1115  
1116 1116  
1161 +
1117 1117  == 7.22 Setting up uplinkdwelltime (as923, au915) ==
1118 1118  
1119 1119  
... ... @@ -1140,6 +1140,7 @@
1140 1140  * **Example 2**: Downlink Payload: **2500**  ~/~/ set uplinkdwelltime to 0
1141 1141  
1142 1142  
1188 +
1143 1143  == 7.23 Set Packet Receiving Response Level ==
1144 1144  
1145 1145  
... ... @@ -1180,6 +1180,7 @@
1180 1180  * **Example 2**: Downlink Payload: **2102**  ~/~/ set packet receiving response level to 2
1181 1181  
1182 1182  
1229 +
1183 1183  == 7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets) ==
1184 1184  
1185 1185  
... ... @@ -1211,16 +1211,12 @@
1211 1211  * Example 2: Downlink Payload: 330201  ~/~/ Set AT+SETMAXNBTRANS=2,1
1212 1212  
1213 1213  
1261 +
1214 1214  == 7.25 Device offline rejoining （LWS007) ==
1215 1215  
1216 1216  
1217 1217  (% style="color:blue" %)**AT Command: AT+DDETECT**
1218 1218  
1219 -AT+DDETECT=<Flag>,<ACK_Timout_1>,<ACK_Timout_2> (Default Value: AT+DDETECT=1,1440,2880)
1220 -
1221 -* ACK_Timout_1: Unit: min
1222 -* ACK_Timout_2: Unit: min
1223 -
1224 1224  (% border="1" style="background-color:#ffffcc; color:green; width:710.222px" %)
1225 1225  |=(% colspan="3" style="width: 707px;" %)AT+**DDETECT**
1226 1226  |(% style="width:160px" %)**Command Example**|(% style="width:198px" %)**Function**|(% style="width:349px" %)**Response**
... ... @@ -1252,19 +1252,16 @@
1252 1252  OK
1253 1253  )))
1254 1254  
1255 -(% style="color:blue" %)**Downlink Command: 0x32**
1298 +(% style="color:blue" %)**Downlink Command: 0x33**
1256 1256  
1257 1257  Format: Command Code (0x32) followed by 2 bytes mode value.
1258 1258  
1259 -If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 32.
1302 +If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 33.
1260 1260  
1261 -* **Example 1:** Downlink Payload: 320105A00B40  ~/~/ Set AT+DDETECT=1,1440,2880
1262 -** 0x01 : Flag
1263 -** 0x05A0: ACK_Timout_1 : 1440minutes (24 hours)
1264 -** 0x0B40: ACK_Timout_2 : 2880minutes (48 hours)
1265 -** **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.
1304 +* **Example 1:** Downlink Payload: 320105A00B40  ~/~/ Set AT+DDETECT=1,1440,2880
1266 1266  
1267 1267  
1307 +
1268 1268  == 7.26 Request the server to send an ACK ==
1269 1269  
1270 1270  
... ... @@ -1283,6 +1283,7 @@
1283 1283  )))
1284 1284  
1285 1285  
1326 +
1286 1286  == 7.27 Adjust network rejoining interval ==
1287 1287  
1288 1288  
... ... @@ -1291,13 +1291,13 @@
1291 1291  (% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %)
1292 1292  |=(% colspan="3" style="width: 724px;" %)AT+RJTDC
1293 1293  |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response**
1294 -|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30(((
1335 +|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30000(((
1295 1295  OK
1296 1296  
1297 -the interval is 30 min
1338 +the interval is 30000ms = 30s
1298 1298  )))
1299 -|(% style="width:165px" %)AT+RJTDC=60|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK(((
1300 -Set the ReJoin data transmission interval to 60 min
1340 +|(% style="width:165px" %)AT+RJTDC=60000|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK(((
1341 +Set the ReJoin data transmission interval to 60000ms = 60 seconds
1301 1301  )))
1302 1302  
1303 1303  (% style="color:blue" %)**Downlink Command: 0x26**
... ... @@ -1310,6 +1310,7 @@
1310 1310  * **Example 2: **Downlink Payload: 260002  ~/~/ Set AT+RJTDC=2
1311 1311  
1312 1312  
1354 +
1313 1313  = 8. AT Commands Combination =
1314 1314  
1315 1315  == 8.1 Set a fix RX2DR for downlink window ==
... ... @@ -1319,6 +1319,7 @@
1319 1319  * (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1320 1320  
1321 1321  
1364 +
1322 1322  == 8.2 Use Downlink Command to set a fix uplink DR ==
1323 1323  
1324 1324  

Applications

Navigation

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