<
From version < 59.1 >
edited by Bei Jinggeng
on 2023/01/10 11:43
To version < 52.11 >
edited by Xiaoling
on 2022/09/19 15:00
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Bei
1 +XWiki.Xiaoling
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,12 +21,15 @@
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 -** 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 +** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]]
28 28  ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server)
29 29  
31 +
32 +
33 +
30 30  = 3. Support End Node and firmware version =
31 31  
32 32  
... ... @@ -102,8 +102,11 @@
102 102  )))
103 103  
104 104  
109 +
110 +
105 105  = 4. System Management Commands =
106 106  
113 +
107 107  == 4.1 Change Uplink Interval ==
108 108  
109 109  
... ... @@ -140,6 +140,8 @@
140 140  * **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
141 141  
142 142  
150 +
151 +
143 143  == 4.2 Reboot End Node ==
144 144  
145 145  
... ... @@ -174,6 +174,7 @@
174 174  (((
175 175  If the downlink payload=**04FF**, the end node will reboot.
176 176  
186 +
177 177  
178 178  )))
179 179  
... ... @@ -213,6 +213,7 @@
213 213  )))
214 214  
215 215  
226 +
216 216  == 4.4 Show Firmware Version ==
217 217  
218 218  
... ... @@ -243,6 +243,7 @@
243 243  (((
244 244  
245 245  
257 +
246 246  **xx: Software Type:**
247 247  )))
248 248  
... ... @@ -276,6 +276,7 @@
276 276  firmware version: v1.1.0 ~-~-> 110
277 277  
278 278  
291 +
279 279  == 4.5 Show System Configure ==
280 280  
281 281  
... ... @@ -302,8 +302,11 @@
302 302  )))
303 303  
304 304  
318 +
319 +
305 305  = 5. Keys, IDs and EUIs management =
306 306  
322 +
307 307  == 5.1 Application EUI ==
308 308  
309 309  
... ... @@ -321,6 +321,8 @@
321 321  |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
322 322  
323 323  
340 +
341 +
324 324  == 5.2 Application Key ==
325 325  
326 326  
... ... @@ -338,6 +338,8 @@
338 338  |(% 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
339 339  
340 340  
359 +
360 +
341 341  == 5.3 Application Session Key ==
342 342  
343 343  
... ... @@ -357,6 +357,8 @@
357 357  )))
358 358  
359 359  
380 +
381 +
360 360  == 5.4 Device Address ==
361 361  
362 362  
... ... @@ -376,6 +376,8 @@
376 376  |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK
377 377  
378 378  
401 +
402 +
379 379  == 5.5 Device EUI ==
380 380  
381 381  
... ... @@ -395,6 +395,8 @@
395 395  )))
396 396  
397 397  
422 +
423 +
398 398  == 5.6 Network ID ==
399 399  
400 400  
... ... @@ -412,6 +412,8 @@
412 412  |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
413 413  
414 414  
441 +
442 +
415 415  == 5.7 Network Session Key ==
416 416  
417 417  
... ... @@ -429,10 +429,14 @@
429 429  |(% 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
430 430  
431 431  
460 +
461 +
432 432  = 6. Joining and sending date on LoRaWAN network =
433 433  
464 +
434 434  == 6.1 Confirm Mode ==
435 435  
467 +
436 436  === 6.1.1  AT+CFM command before DR-LWS007 software stack ===
437 437  
438 438  
... ... @@ -450,6 +450,8 @@
450 450  |(% style="width:155px" %)AT+CFM=1|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)OK
451 451  |(% style="width:155px" %)AT+CFM=2|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)While Error in format, return AT_PARAM_ERROR
452 452  
485 +
486 +
453 453  (% style="color:blue" %)**Downlink Command: 0x05**
454 454  
455 455  Format: Command Code (0x05) followed by 2 bytes mode value.
... ... @@ -460,6 +460,8 @@
460 460  * **Example 2:** Downlink Payload: 0500  ~/~/ Set AT+CFM=0
461 461  
462 462  
497 +
498 +
463 463  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
464 464  
465 465  
... ... @@ -496,6 +496,8 @@
496 496  OK
497 497  )))
498 498  
535 +
536 +
499 499  (% style="color:blue" %)**Downlink Command: 0x05**
500 500  
501 501  Format: Command Code (0x05) followed by 2 bytes mode value.
... ... @@ -506,6 +506,8 @@
506 506  * **Example 2:** Downlink Payload: 05000700  ~/~/ Set AT+CFM=0,7,0
507 507  
508 508  
547 +
548 +
509 509  == 6.2 Confirm Status ==
510 510  
511 511  
... ... @@ -522,6 +522,8 @@
522 522  )))
523 523  
524 524  
565 +
566 +
525 525  == 6.3 Join LoRa® Network ==
526 526  
527 527  
... ... @@ -540,6 +540,8 @@
540 540  )))
541 541  
542 542  
585 +
586 +
543 543  == 6.4 LoRa® Network Join Mode ==
544 544  
545 545  
... ... @@ -557,6 +557,8 @@
557 557  |(% style="width:162px" %)AT+NJM=0|(% style="width:227px" %)Set the Network Join Mode|(% style="width:361px" %)OK
558 558  |(% style="width:162px" %)AT+NJM=2|(% style="width:227px" %)Set the Network Join Mode|(% style="width:361px" %)While Error in format, return AT_PARAM_ERROR
559 559  
604 +
605 +
560 560  (% style="color:blue" %)**Downlink Command: 0x20**
561 561  
562 562  Format: Command Code (0x20) followed by 1 bytes mode value.
... ... @@ -567,6 +567,8 @@
567 567  * **Example 2:** Downlink Payload: **2001**  ~/~/ Set AT+NJM=1
568 568  
569 569  
616 +
617 +
570 570  == 6.5 LoRa® Network Join Status ==
571 571  
572 572  
... ... @@ -583,6 +583,8 @@
583 583  )))
584 584  
585 585  
634 +
635 +
586 586  == 6.6 Print Last Received Data in Raw Format ==
587 587  
588 588  
... ... @@ -599,6 +599,8 @@
599 599  )))
600 600  
601 601  
652 +
653 +
602 602  == 6.7 Print Last Received Data in Binary Format ==
603 603  
604 604  
... ... @@ -615,6 +615,8 @@
615 615  )))
616 616  
617 617  
670 +
671 +
618 618  == 6.8 Send Text Data ==
619 619  
620 620  
... ... @@ -635,6 +635,8 @@
635 635  )))
636 636  
637 637  
692 +
693 +
638 638  == 6.9 Send Hexadecimal Data ==
639 639  
640 640  
... ... @@ -654,8 +654,11 @@
654 654  )))
655 655  
656 656  
713 +
714 +
657 657  = 7. LoRaWAN network management =
658 658  
717 +
659 659  == 7.1 Adaptive Data Rate ==
660 660  
661 661  
... ... @@ -675,6 +675,8 @@
675 675  AT_PARAM_ERROR
676 676  )))
677 677  
737 +
738 +
678 678  (% style="color:blue" %)**Downlink Command: 0x22**
679 679  
680 680  If the downlink payload=2201, it means setting the adaptive data rate to 1, while type code is 22.
... ... @@ -683,6 +683,8 @@
683 683  * **Example 2**: Downlink Payload: **2200FFFF**  ~/~/ Set AT+ADR=0.
684 684  
685 685  
747 +
748 +
686 686  == 7.2 LoRa® Class ==
687 687  
688 688  
... ... @@ -702,6 +702,8 @@
702 702  )))
703 703  
704 704  
768 +
769 +
705 705  == 7.3 Duty Cycle Setting ==
706 706  
707 707  
... ... @@ -721,17 +721,14 @@
721 721  )))
722 722  
723 723  
724 -== 7.4 Data Rate ==
725 725  
726 726  
727 -Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
791 +== 7.4 Data Rate ==
728 728  
729 -(% style="color:red" %)
730 -**Notice:**
731 731  
732 -* 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.
733 -* 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/]]
794 +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
734 734  
796 +
735 735  (% style="color:blue" %)**AT Command: AT+DR**
736 736  
737 737  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
... ... @@ -744,6 +744,8 @@
744 744  
745 745  )))
746 746  
809 +
810 +
747 747  (% style="color:blue" %)**Downlink Command: 0x2200aaFF**
748 748  
749 749  If the downlink payload=220001FF, it means setting the data rate to 1, while type code is 22 00 aa FF.
... ... @@ -752,6 +752,8 @@
752 752  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+DR=0.
753 753  
754 754  
819 +
820 +
755 755  == 7.5 Frame Counter Downlink ==
756 756  
757 757  
... ... @@ -771,6 +771,8 @@
771 771  )))
772 772  
773 773  
840 +
841 +
774 774  == 7.6 Frame Counter Uplink ==
775 775  
776 776  Feature: Get or Set the Frame Counter Uplink.
... ... @@ -789,6 +789,8 @@
789 789  )))
790 790  
791 791  
860 +
861 +
792 792  == 7.7 Join Accept Delay1 ==
793 793  
794 794  
... ... @@ -808,6 +808,8 @@
808 808  )))
809 809  
810 810  
881 +
882 +
811 811  == 7.8 Join Accept Delay2 ==
812 812  
813 813  
... ... @@ -827,6 +827,8 @@
827 827  )))
828 828  
829 829  
902 +
903 +
830 830  == 7.9 Public Network Mode ==
831 831  
832 832  
... ... @@ -855,6 +855,8 @@
855 855  |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %)
856 856  
857 857  
932 +
933 +
858 858  == 7.10 Receive Delay1 ==
859 859  
860 860  
... ... @@ -874,6 +874,8 @@
874 874  )))
875 875  
876 876  
953 +
954 +
877 877  == 7.11 Receive Delay2 ==
878 878  
879 879  
... ... @@ -893,6 +893,8 @@
893 893  )))
894 894  
895 895  
974 +
975 +
896 896  == 7.12 Rx2 Window Data Rate ==
897 897  
898 898  
... ... @@ -912,6 +912,8 @@
912 912  )))
913 913  
914 914  
995 +
996 +
915 915  == 7.13 Rx2 Window Frequency ==
916 916  
917 917  
... ... @@ -931,6 +931,8 @@
931 931  )))
932 932  
933 933  
1016 +
1017 +
934 934  == 7.14 Transmit Power ==
935 935  
936 936  
... ... @@ -959,6 +959,8 @@
959 959  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+TXP=0.
960 960  
961 961  
1046 +
1047 +
962 962  == 7.15 RSSI of the Last Received Packet ==
963 963  
964 964  
... ... @@ -975,6 +975,8 @@
975 975  )))
976 976  
977 977  
1064 +
1065 +
978 978  == 7.16 SNR of the Last Received Packet ==
979 979  
980 980  
... ... @@ -991,6 +991,8 @@
991 991  )))
992 992  
993 993  
1082 +
1083 +
994 994  == 7.17 Application Port ==
995 995  
996 996  
... ... @@ -1007,6 +1007,8 @@
1007 1007  )))
1008 1008  |(% style="width:157px" %)AT+PORT=21|(% style="width:204px" %)Set the application port|(% style="width:135px" %)OK
1009 1009  
1100 +
1101 +
1010 1010  (% style="color:blue" %)**Downlink Command: 0x23**
1011 1011  
1012 1012  Format: Command Code (0x23) followed by 1 bytes port value.
... ... @@ -1017,6 +1017,8 @@
1017 1017  * **Example 2**: Downlink Payload:** 2305**  ~/~/ set the application port to 5
1018 1018  
1019 1019  
1112 +
1113 +
1020 1020  == 7.18 Single Channel Mode ==
1021 1021  
1022 1022  
... ... @@ -1034,6 +1034,8 @@
1034 1034  |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK
1035 1035  
1036 1036  
1131 +
1132 +
1037 1037  == 7.19 Eight Channel Mode ==
1038 1038  
1039 1039  
... ... @@ -1052,8 +1052,10 @@
1052 1052  )))
1053 1053  |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK
1054 1054  
1055 -(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**
1056 1056  
1152 +
1153 +(% style="color:blue" %)**Downlink Command: 0x24**
1154 +
1057 1057  Format: Command Code (0x24) followed by 1 bytes channel value.
1058 1058  
1059 1059  If the downlink payload=2401, it means set channel mode to 1, while type code is 24.
... ... @@ -1062,6 +1062,8 @@
1062 1062  * **Example 2**: Downlink Payload: 2405  ~/~/ set channel mode to 5
1063 1063  
1064 1064  
1163 +
1164 +
1065 1065  == 7.20 Get or Set RXwindows1 timeout ==
1066 1066  
1067 1067  
... ... @@ -1093,6 +1093,7 @@
1093 1093  (((
1094 1094  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.
1095 1095  
1196 +
1096 1096  
1097 1097  )))
1098 1098  
... ... @@ -1113,6 +1113,8 @@
1113 1113  |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK
1114 1114  
1115 1115  
1217 +
1218 +
1116 1116  == 7.22 Setting up uplinkdwelltime (as923, au915) ==
1117 1117  
1118 1118  
... ... @@ -1129,6 +1129,8 @@
1129 1129  )))
1130 1130  |(% style="width:183px" %)AT+DWELLT=0|(% style="width:179px" %)Set uplinkdwelltime|(% style="width:131px" %)OK
1131 1131  
1235 +
1236 +
1132 1132  (% style="color:blue" %)**Downlink Command: 0x25**
1133 1133  
1134 1134  Format: Command Code (0x25) followed by 1 bytes state value.
... ... @@ -1139,6 +1139,8 @@
1139 1139  * **Example 2**: Downlink Payload: **2500**  ~/~/ set uplinkdwelltime to 0
1140 1140  
1141 1141  
1247 +
1248 +
1142 1142  == 7.23 Set Packet Receiving Response Level ==
1143 1143  
1144 1144  
... ... @@ -1159,6 +1159,9 @@
1159 1159  * For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command.
1160 1160  * 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.
1161 1161  
1269 +
1270 +
1271 +
1162 1162  (% style="color:blue" %)**AT Command: AT+RPL**
1163 1163  
1164 1164  (% border="1" style="background-color:#ffffcc; color:green; width:536.222px" %)
... ... @@ -1169,6 +1169,8 @@
1169 1169  )))
1170 1170  |(% style="width:160px" %)AT+RPL=0|(% style="width:263px" %)Set packet receiving response level|(% style="width:109px" %)OK
1171 1171  
1282 +
1283 +
1172 1172  (% style="color:blue" %)**Downlink Command: 0x21**
1173 1173  
1174 1174  Format: Command Code (0x21) followed by 1 bytes level value.
... ... @@ -1179,6 +1179,8 @@
1179 1179  * **Example 2**: Downlink Payload: **2102**  ~/~/ set packet receiving response level to 2
1180 1180  
1181 1181  
1294 +
1295 +
1182 1182  == 7.24 Controls NBTrans in unconfirmed uplink mode(LWS007 NBTrans:Set retransmission packets) ==
1183 1183  
1184 1184  
... ... @@ -1200,6 +1200,8 @@
1200 1200  OK
1201 1201  )))
1202 1202  
1317 +
1318 +
1203 1203  (% style="color:blue" %)**Downlink Command: 0x33**
1204 1204  
1205 1205  Format: Command Code (0x33) followed by 2 bytes mode value.
... ... @@ -1210,6 +1210,8 @@
1210 1210  * Example 2: Downlink Payload: 330201  ~/~/ Set AT+SETMAXNBTRANS=2,1
1211 1211  
1212 1212  
1329 +
1330 +
1213 1213  == 7.25 Device offline rejoining (LWS007) ==
1214 1214  
1215 1215  
... ... @@ -1246,6 +1246,8 @@
1246 1246  OK
1247 1247  )))
1248 1248  
1367 +
1368 +
1249 1249  (% style="color:blue" %)**Downlink Command: 0x33**
1250 1250  
1251 1251  Format: Command Code (0x32) followed by 2 bytes mode value.
... ... @@ -1255,6 +1255,8 @@
1255 1255  * **Example 1:** Downlink Payload: 320105A00B40  ~/~/ Set AT+DDETECT=1,1440,2880
1256 1256  
1257 1257  
1378 +
1379 +
1258 1258  == 7.26 Request the server to send an ACK ==
1259 1259  
1260 1260  
... ... @@ -1273,6 +1273,8 @@
1273 1273  )))
1274 1274  
1275 1275  
1398 +
1399 +
1276 1276  == 7.27 Adjust network rejoining interval ==
1277 1277  
1278 1278  
... ... @@ -1281,15 +1281,17 @@
1281 1281  (% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %)
1282 1282  |=(% colspan="3" style="width: 724px;" %)AT+RJTDC
1283 1283  |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response**
1284 -|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30(((
1408 +|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30000(((
1285 1285  OK
1286 1286  
1287 -the interval is 30 min
1411 +the interval is 30000ms = 30s
1288 1288  )))
1289 -|(% style="width:165px" %)AT+RJTDC=60|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK(((
1290 -Set the ReJoin data transmission interval to 60 min
1413 +|(% style="width:165px" %)AT+RJTDC=60000|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK(((
1414 +Set the ReJoin data transmission interval to 60000ms = 60 seconds
1291 1291  )))
1292 1292  
1417 +
1418 +
1293 1293  (% style="color:blue" %)**Downlink Command: 0x26**
1294 1294  
1295 1295  Format: Command Code (0x26) followed by 2 bytes mode value.
... ... @@ -1300,15 +1300,20 @@
1300 1300  * **Example 2: **Downlink Payload: 260002  ~/~/ Set AT+RJTDC=2
1301 1301  
1302 1302  
1429 +
1430 +
1303 1303  = 8. AT Commands Combination =
1304 1304  
1433 +
1305 1305  == 8.1 Set a fix RX2DR for downlink window ==
1306 1306  
1307 1307  
1308 1308  * (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
1309 -* (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1438 +* (% style="color:red" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1310 1310  
1311 1311  
1441 +
1442 +
1312 1312  == 8.2 Use Downlink Command to set a fix uplink DR ==
1313 1313  
1314 1314  
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0