Last modified by kai on 2024/09/06 10:00
<
From version < 52.11 >
edited by Xiaoling
on 2022/09/19 15:00
To version < 58.2 >
edited by Xiaoling
on 2022/12/02 13:45
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -14,7 +14,6 @@
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 18  
19 19  
20 20  )))
... ... @@ -22,15 +22,14 @@
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:
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:
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]]
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]]?
29 29  ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server)
30 30  
31 31  
32 32  
33 -
34 34  = 3. Support End Node and firmware version =
35 35  
36 36  
... ... @@ -106,11 +106,8 @@
106 106  )))
107 107  
108 108  
109 -
110 -
111 111  = 4. System Management Commands =
112 112  
113 -
114 114  == 4.1 Change Uplink Interval ==
115 115  
116 116  
... ... @@ -146,9 +146,6 @@
146 146  * **Example 1**: Downlink Payload:** 0100001E**  ~/~/ Set Transmit Interval (TDC) = 30 seconds
147 147  * **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
148 148  
149 -
150 -
151 -
152 152  == 4.2 Reboot End Node ==
153 153  
154 154  
... ... @@ -314,12 +314,8 @@
314 314  OK
315 315  )))
316 316  
317 -
318 -
319 -
320 320  = 5. Keys, IDs and EUIs management =
321 321  
322 -
323 323  == 5.1 Application EUI ==
324 324  
325 325  
... ... @@ -336,9 +336,6 @@
336 336  )))
337 337  |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
338 338  
339 -
340 -
341 -
342 342  == 5.2 Application Key ==
343 343  
344 344  
... ... @@ -355,9 +355,6 @@
355 355  )))
356 356  |(% 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
357 357  
358 -
359 -
360 -
361 361  == 5.3 Application Session Key ==
362 362  
363 363  
... ... @@ -376,9 +376,6 @@
376 376  OK
377 377  )))
378 378  
379 -
380 -
381 -
382 382  == 5.4 Device Address ==
383 383  
384 384  
... ... @@ -397,9 +397,6 @@
397 397  )))
398 398  |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK
399 399  
400 -
401 -
402 -
403 403  == 5.5 Device EUI ==
404 404  
405 405  
... ... @@ -418,9 +418,6 @@
418 418  OK
419 419  )))
420 420  
421 -
422 -
423 -
424 424  == 5.6 Network ID ==
425 425  
426 426  
... ... @@ -437,9 +437,6 @@
437 437  )))
438 438  |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
439 439  
440 -
441 -
442 -
443 443  == 5.7 Network Session Key ==
444 444  
445 445  
... ... @@ -456,15 +456,10 @@
456 456  )))
457 457  |(% 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
458 458  
459 -
460 -
461 -
462 462  = 6. Joining and sending date on LoRaWAN network =
463 463  
464 -
465 465  == 6.1 Confirm Mode ==
466 466  
467 -
468 468  === 6.1.1  AT+CFM command before DR-LWS007 software stack ===
469 469  
470 470  
... ... @@ -482,8 +482,6 @@
482 482  |(% style="width:155px" %)AT+CFM=1|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)OK
483 483  |(% style="width:155px" %)AT+CFM=2|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)While Error in format, return AT_PARAM_ERROR
484 484  
485 -
486 -
487 487  (% style="color:blue" %)**Downlink Command: 0x05**
488 488  
489 489  Format: Command Code (0x05) followed by 2 bytes mode value.
... ... @@ -493,9 +493,6 @@
493 493  * **Example 1:** Downlink Payload: 0501  ~/~/ Set AT+CFM=1
494 494  * **Example 2:** Downlink Payload: 0500  ~/~/ Set AT+CFM=0
495 495  
496 -
497 -
498 -
499 499  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
500 500  
501 501  
... ... @@ -532,8 +532,6 @@
532 532  OK
533 533  )))
534 534  
535 -
536 -
537 537  (% style="color:blue" %)**Downlink Command: 0x05**
538 538  
539 539  Format: Command Code (0x05) followed by 2 bytes mode value.
... ... @@ -543,9 +543,6 @@
543 543  * **Example 1:** Downlink Payload: 05010101  ~/~/ Set AT+CFM=1,1,1
544 544  * **Example 2:** Downlink Payload: 05000700  ~/~/ Set AT+CFM=0,7,0
545 545  
546 -
547 -
548 -
549 549  == 6.2 Confirm Status ==
550 550  
551 551  
... ... @@ -561,9 +561,6 @@
561 561  OK
562 562  )))
563 563  
564 -
565 -
566 -
567 567  == 6.3 Join LoRa® Network ==
568 568  
569 569  
... ... @@ -581,9 +581,6 @@
581 581  While Error in format, return AT_BUSY_ERROR
582 582  )))
583 583  
584 -
585 -
586 -
587 587  == 6.4 LoRa® Network Join Mode ==
588 588  
589 589  
... ... @@ -601,8 +601,6 @@
601 601  |(% style="width:162px" %)AT+NJM=0|(% style="width:227px" %)Set the Network Join Mode|(% style="width:361px" %)OK
602 602  |(% 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
603 603  
604 -
605 -
606 606  (% style="color:blue" %)**Downlink Command: 0x20**
607 607  
608 608  Format: Command Code (0x20) followed by 1 bytes mode value.
... ... @@ -612,9 +612,6 @@
612 612  * **Example 1: **Downlink Payload: **2000                  ** ~/~/ Set AT+NJM=0
613 613  * **Example 2:** Downlink Payload: **2001**  ~/~/ Set AT+NJM=1
614 614  
615 -
616 -
617 -
618 618  == 6.5 LoRa® Network Join Status ==
619 619  
620 620  
... ... @@ -630,9 +630,6 @@
630 630  OK
631 631  )))
632 632  
633 -
634 -
635 -
636 636  == 6.6 Print Last Received Data in Raw Format ==
637 637  
638 638  
... ... @@ -648,9 +648,6 @@
648 648  OK
649 649  )))
650 650  
651 -
652 -
653 -
654 654  == 6.7 Print Last Received Data in Binary Format ==
655 655  
656 656  
... ... @@ -666,9 +666,6 @@
666 666  OK
667 667  )))
668 668  
669 -
670 -
671 -
672 672  == 6.8 Send Text Data ==
673 673  
674 674  
... ... @@ -688,9 +688,6 @@
688 688  
689 689  )))
690 690  
691 -
692 -
693 -
694 694  == 6.9 Send Hexadecimal Data ==
695 695  
696 696  
... ... @@ -709,12 +709,8 @@
709 709  
710 710  )))
711 711  
712 -
713 -
714 -
715 715  = 7. LoRaWAN network management =
716 716  
717 -
718 718  == 7.1 Adaptive Data Rate ==
719 719  
720 720  
... ... @@ -734,8 +734,6 @@
734 734  AT_PARAM_ERROR
735 735  )))
736 736  
737 -
738 -
739 739  (% style="color:blue" %)**Downlink Command: 0x22**
740 740  
741 741  If the downlink payload=2201, it means setting the adaptive data rate to 1, while type code is 22.
... ... @@ -743,9 +743,6 @@
743 743  * **Example 1**: Downlink Payload: **2201**  ~/~/ Set AT+ADR=1.
744 744  * **Example 2**: Downlink Payload: **2200FFFF**  ~/~/ Set AT+ADR=0.
745 745  
746 -
747 -
748 -
749 749  == 7.2 LoRa® Class ==
750 750  
751 751  
... ... @@ -764,9 +764,6 @@
764 764  
765 765  )))
766 766  
767 -
768 -
769 -
770 770  == 7.3 Duty Cycle Setting ==
771 771  
772 772  
... ... @@ -785,15 +785,17 @@
785 785  
786 786  )))
787 787  
788 -
789 -
790 -
791 791  == 7.4 Data Rate ==
792 792  
793 793  
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
711 +Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
795 795  
713 +(% style="color:red" %)
714 +**Notice:**
796 796  
716 +* 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.
717 +* 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/]]
718 +
797 797  (% style="color:blue" %)**AT Command: AT+DR**
798 798  
799 799  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
... ... @@ -806,8 +806,6 @@
806 806  
807 807  )))
808 808  
809 -
810 -
811 811  (% style="color:blue" %)**Downlink Command: 0x2200aaFF**
812 812  
813 813  If the downlink payload=220001FF, it means setting the data rate to 1, while type code is 22 00 aa FF.
... ... @@ -815,9 +815,6 @@
815 815  * **Example 1**: Downlink Payload: **220001FF**  ~/~/ Set AT+DR=1.
816 816  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+DR=0.
817 817  
818 -
819 -
820 -
821 821  == 7.5 Frame Counter Downlink ==
822 822  
823 823  
... ... @@ -836,9 +836,6 @@
836 836  OK
837 837  )))
838 838  
839 -
840 -
841 -
842 842  == 7.6 Frame Counter Uplink ==
843 843  
844 844  Feature: Get or Set the Frame Counter Uplink.
... ... @@ -856,9 +856,6 @@
856 856  
857 857  )))
858 858  
859 -
860 -
861 -
862 862  == 7.7 Join Accept Delay1 ==
863 863  
864 864  
... ... @@ -877,9 +877,6 @@
877 877  
878 878  )))
879 879  
880 -
881 -
882 -
883 883  == 7.8 Join Accept Delay2 ==
884 884  
885 885  
... ... @@ -898,9 +898,6 @@
898 898  
899 899  )))
900 900  
901 -
902 -
903 -
904 904  == 7.9 Public Network Mode ==
905 905  
906 906  
... ... @@ -928,9 +928,6 @@
928 928  )))
929 929  |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %)
930 930  
931 -
932 -
933 -
934 934  == 7.10 Receive Delay1 ==
935 935  
936 936  
... ... @@ -949,9 +949,6 @@
949 949  
950 950  )))
951 951  
952 -
953 -
954 -
955 955  == 7.11 Receive Delay2 ==
956 956  
957 957  
... ... @@ -970,9 +970,6 @@
970 970  
971 971  )))
972 972  
973 -
974 -
975 -
976 976  == 7.12 Rx2 Window Data Rate ==
977 977  
978 978  
... ... @@ -991,9 +991,6 @@
991 991  
992 992  )))
993 993  
994 -
995 -
996 -
997 997  == 7.13 Rx2 Window Frequency ==
998 998  
999 999  
... ... @@ -1012,9 +1012,6 @@
1012 1012  
1013 1013  )))
1014 1014  
1015 -
1016 -
1017 -
1018 1018  == 7.14 Transmit Power ==
1019 1019  
1020 1020  
... ... @@ -1042,9 +1042,6 @@
1042 1042  * **Example 1**: Downlink Payload: **22000102**  ~/~/ Set AT+TXP=2.
1043 1043  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+TXP=0.
1044 1044  
1045 -
1046 -
1047 -
1048 1048  == 7.15 RSSI of the Last Received Packet ==
1049 1049  
1050 1050  
... ... @@ -1060,9 +1060,6 @@
1060 1060  OK
1061 1061  )))
1062 1062  
1063 -
1064 -
1065 -
1066 1066  == 7.16 SNR of the Last Received Packet ==
1067 1067  
1068 1068  
... ... @@ -1078,9 +1078,6 @@
1078 1078  OK
1079 1079  )))
1080 1080  
1081 -
1082 -
1083 -
1084 1084  == 7.17 Application Port ==
1085 1085  
1086 1086  
... ... @@ -1097,8 +1097,6 @@
1097 1097  )))
1098 1098  |(% style="width:157px" %)AT+PORT=21|(% style="width:204px" %)Set the application port|(% style="width:135px" %)OK
1099 1099  
1100 -
1101 -
1102 1102  (% style="color:blue" %)**Downlink Command: 0x23**
1103 1103  
1104 1104  Format: Command Code (0x23) followed by 1 bytes port value.
... ... @@ -1108,9 +1108,6 @@
1108 1108  * **Example 1**: Downlink Payload: **2301**  ~/~/ set the application port to 1
1109 1109  * **Example 2**: Downlink Payload:** 2305**  ~/~/ set the application port to 5
1110 1110  
1111 -
1112 -
1113 -
1114 1114  == 7.18 Single Channel Mode ==
1115 1115  
1116 1116  
... ... @@ -1127,9 +1127,6 @@
1127 1127  )))
1128 1128  |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK
1129 1129  
1130 -
1131 -
1132 -
1133 1133  == 7.19 Eight Channel Mode ==
1134 1134  
1135 1135  
... ... @@ -1148,10 +1148,8 @@
1148 1148  )))
1149 1149  |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK
1150 1150  
1024 +(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**
1151 1151  
1152 -
1153 -(% style="color:blue" %)**Downlink Command: 0x24**
1154 -
1155 1155  Format: Command Code (0x24) followed by 1 bytes channel value.
1156 1156  
1157 1157  If the downlink payload=2401, it means set channel mode to 1, while type code is 24.
... ... @@ -1159,9 +1159,6 @@
1159 1159  * **Example 1**: Downlink Payload: 2401  ~/~/ set channel mode to 1
1160 1160  * **Example 2**: Downlink Payload: 2405  ~/~/ set channel mode to 5
1161 1161  
1162 -
1163 -
1164 -
1165 1165  == 7.20 Get or Set RXwindows1 timeout ==
1166 1166  
1167 1167  
... ... @@ -1213,9 +1213,6 @@
1213 1213  )))
1214 1214  |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK
1215 1215  
1216 -
1217 -
1218 -
1219 1219  == 7.22 Setting up uplinkdwelltime (as923, au915) ==
1220 1220  
1221 1221  
... ... @@ -1232,8 +1232,6 @@
1232 1232  )))
1233 1233  |(% style="width:183px" %)AT+DWELLT=0|(% style="width:179px" %)Set uplinkdwelltime|(% style="width:131px" %)OK
1234 1234  
1235 -
1236 -
1237 1237  (% style="color:blue" %)**Downlink Command: 0x25**
1238 1238  
1239 1239  Format: Command Code (0x25) followed by 1 bytes state value.
... ... @@ -1243,9 +1243,6 @@
1243 1243  * **Example 1**: Downlink Payload: **2501**  ~/~/ set uplinkdwelltime to 1
1244 1244  * **Example 2**: Downlink Payload: **2500**  ~/~/ set uplinkdwelltime to 0
1245 1245  
1246 -
1247 -
1248 -
1249 1249  == 7.23 Set Packet Receiving Response Level ==
1250 1250  
1251 1251  
... ... @@ -1266,9 +1266,6 @@
1266 1266  * For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command.
1267 1267  * 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.
1268 1268  
1269 -
1270 -
1271 -
1272 1272  (% style="color:blue" %)**AT Command: AT+RPL**
1273 1273  
1274 1274  (% border="1" style="background-color:#ffffcc; color:green; width:536.222px" %)
... ... @@ -1279,8 +1279,6 @@
1279 1279  )))
1280 1280  |(% style="width:160px" %)AT+RPL=0|(% style="width:263px" %)Set packet receiving response level|(% style="width:109px" %)OK
1281 1281  
1282 -
1283 -
1284 1284  (% style="color:blue" %)**Downlink Command: 0x21**
1285 1285  
1286 1286  Format: Command Code (0x21) followed by 1 bytes level value.
... ... @@ -1290,9 +1290,6 @@
1290 1290  * **Example 1**: Downlink Payload: **2101**  ~/~/ set packet receiving response level to 1
1291 1291  * **Example 2**: Downlink Payload: **2102**  ~/~/ set packet receiving response level to 2
1292 1292  
1293 -
1294 -
1295 -
1296 1296  == 7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets) ==
1297 1297  
1298 1298  
... ... @@ -1314,8 +1314,6 @@
1314 1314  OK
1315 1315  )))
1316 1316  
1317 -
1318 -
1319 1319  (% style="color:blue" %)**Downlink Command: 0x33**
1320 1320  
1321 1321  Format: Command Code (0x33) followed by 2 bytes mode value.
... ... @@ -1325,9 +1325,6 @@
1325 1325  * Example 1: Downlink Payload: 330100  ~/~/ Set AT+SETMAXNBTRANS=1,0
1326 1326  * Example 2: Downlink Payload: 330201  ~/~/ Set AT+SETMAXNBTRANS=2,1
1327 1327  
1328 -
1329 -
1330 -
1331 1331  == 7.25 Device offline rejoining （LWS007) ==
1332 1332  
1333 1333  
... ... @@ -1364,8 +1364,6 @@
1364 1364  OK
1365 1365  )))
1366 1366  
1367 -
1368 -
1369 1369  (% style="color:blue" %)**Downlink Command: 0x33**
1370 1370  
1371 1371  Format: Command Code (0x32) followed by 2 bytes mode value.
... ... @@ -1374,9 +1374,6 @@
1374 1374  
1375 1375  * **Example 1:** Downlink Payload: 320105A00B40  ~/~/ Set AT+DDETECT=1,1440,2880
1376 1376  
1377 -
1378 -
1379 -
1380 1380  == 7.26 Request the server to send an ACK ==
1381 1381  
1382 1382  
... ... @@ -1394,9 +1394,6 @@
1394 1394  OK
1395 1395  )))
1396 1396  
1397 -
1398 -
1399 -
1400 1400  == 7.27 Adjust network rejoining interval ==
1401 1401  
1402 1402  
... ... @@ -1414,8 +1414,6 @@
1414 1414  Set the ReJoin data transmission interval to 60000ms = 60 seconds
1415 1415  )))
1416 1416  
1417 -
1418 -
1419 1419  (% style="color:blue" %)**Downlink Command: 0x26**
1420 1420  
1421 1421  Format: Command Code (0x26) followed by 2 bytes mode value.
... ... @@ -1425,21 +1425,14 @@
1425 1425  * **Example 1:** Downlink Payload: 26000A  ~/~/ Set AT+RJTDC=10
1426 1426  * **Example 2: **Downlink Payload: 260002  ~/~/ Set AT+RJTDC=2
1427 1427  
1428 -
1429 -
1430 -
1431 1431  = 8. AT Commands Combination =
1432 1432  
1433 -
1434 1434  == 8.1 Set a fix RX2DR for downlink window ==
1435 1435  
1436 1436  
1437 1437  * (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
1438 -* (% style="color:red" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1271 +* (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1439 1439  
1440 -
1441 -
1442 -
1443 1443  == 8.2 Use Downlink Command to set a fix uplink DR ==
1444 1444  
1445 1445  

Applications

Navigation

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