Last modified by kai on 2024/09/06 10:00
<
From version < 58.2 >
edited by Xiaoling
on 2022/12/02 13:45
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
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,14 +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  
30 30  
31 31  
33 +
32 32  = 3. Support End Node and firmware version =
33 33  
34 34  
... ... @@ -104,8 +104,11 @@
104 104  )))
105 105  
106 106  
109 +
110 +
107 107  = 4. System Management Commands =
108 108  
113 +
109 109  == 4.1 Change Uplink Interval ==
110 110  
111 111  
... ... @@ -141,6 +141,9 @@
141 141  * **Example 1**: Downlink Payload:** 0100001E**  ~/~/ Set Transmit Interval (TDC) = 30 seconds
142 142  * **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
143 143  
149 +
150 +
151 +
144 144  == 4.2 Reboot End Node ==
145 145  
146 146  
... ... @@ -306,8 +306,12 @@
306 306  OK
307 307  )))
308 308  
317 +
318 +
319 +
309 309  = 5. Keys, IDs and EUIs management =
310 310  
322 +
311 311  == 5.1 Application EUI ==
312 312  
313 313  
... ... @@ -324,6 +324,9 @@
324 324  )))
325 325  |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
326 326  
339 +
340 +
341 +
327 327  == 5.2 Application Key ==
328 328  
329 329  
... ... @@ -340,6 +340,9 @@
340 340  )))
341 341  |(% 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
342 342  
358 +
359 +
360 +
343 343  == 5.3 Application Session Key ==
344 344  
345 345  
... ... @@ -358,6 +358,9 @@
358 358  OK
359 359  )))
360 360  
379 +
380 +
381 +
361 361  == 5.4 Device Address ==
362 362  
363 363  
... ... @@ -376,6 +376,9 @@
376 376  )))
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  
400 +
401 +
402 +
379 379  == 5.5 Device EUI ==
380 380  
381 381  
... ... @@ -394,6 +394,9 @@
394 394  OK
395 395  )))
396 396  
421 +
422 +
423 +
397 397  == 5.6 Network ID ==
398 398  
399 399  
... ... @@ -410,6 +410,9 @@
410 410  )))
411 411  |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
412 412  
440 +
441 +
442 +
413 413  == 5.7 Network Session Key ==
414 414  
415 415  
... ... @@ -426,10 +426,15 @@
426 426  )))
427 427  |(% 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
428 428  
459 +
460 +
461 +
429 429  = 6. Joining and sending date on LoRaWAN network =
430 430  
464 +
431 431  == 6.1 Confirm Mode ==
432 432  
467 +
433 433  === 6.1.1  AT+CFM command before DR-LWS007 software stack ===
434 434  
435 435  
... ... @@ -447,6 +447,8 @@
447 447  |(% style="width:155px" %)AT+CFM=1|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)OK
448 448  |(% style="width:155px" %)AT+CFM=2|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)While Error in format, return AT_PARAM_ERROR
449 449  
485 +
486 +
450 450  (% style="color:blue" %)**Downlink Command: 0x05**
451 451  
452 452  Format: Command Code (0x05) followed by 2 bytes mode value.
... ... @@ -456,6 +456,9 @@
456 456  * **Example 1:** Downlink Payload: 0501  ~/~/ Set AT+CFM=1
457 457  * **Example 2:** Downlink Payload: 0500  ~/~/ Set AT+CFM=0
458 458  
496 +
497 +
498 +
459 459  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
460 460  
461 461  
... ... @@ -492,6 +492,8 @@
492 492  OK
493 493  )))
494 494  
535 +
536 +
495 495  (% style="color:blue" %)**Downlink Command: 0x05**
496 496  
497 497  Format: Command Code (0x05) followed by 2 bytes mode value.
... ... @@ -501,6 +501,9 @@
501 501  * **Example 1:** Downlink Payload: 05010101  ~/~/ Set AT+CFM=1,1,1
502 502  * **Example 2:** Downlink Payload: 05000700  ~/~/ Set AT+CFM=0,7,0
503 503  
546 +
547 +
548 +
504 504  == 6.2 Confirm Status ==
505 505  
506 506  
... ... @@ -516,6 +516,9 @@
516 516  OK
517 517  )))
518 518  
564 +
565 +
566 +
519 519  == 6.3 Join LoRa® Network ==
520 520  
521 521  
... ... @@ -533,6 +533,9 @@
533 533  While Error in format, return AT_BUSY_ERROR
534 534  )))
535 535  
584 +
585 +
586 +
536 536  == 6.4 LoRa® Network Join Mode ==
537 537  
538 538  
... ... @@ -550,6 +550,8 @@
550 550  |(% style="width:162px" %)AT+NJM=0|(% style="width:227px" %)Set the Network Join Mode|(% style="width:361px" %)OK
551 551  |(% 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
552 552  
604 +
605 +
553 553  (% style="color:blue" %)**Downlink Command: 0x20**
554 554  
555 555  Format: Command Code (0x20) followed by 1 bytes mode value.
... ... @@ -559,6 +559,9 @@
559 559  * **Example 1: **Downlink Payload: **2000                  ** ~/~/ Set AT+NJM=0
560 560  * **Example 2:** Downlink Payload: **2001**  ~/~/ Set AT+NJM=1
561 561  
615 +
616 +
617 +
562 562  == 6.5 LoRa® Network Join Status ==
563 563  
564 564  
... ... @@ -574,6 +574,9 @@
574 574  OK
575 575  )))
576 576  
633 +
634 +
635 +
577 577  == 6.6 Print Last Received Data in Raw Format ==
578 578  
579 579  
... ... @@ -589,6 +589,9 @@
589 589  OK
590 590  )))
591 591  
651 +
652 +
653 +
592 592  == 6.7 Print Last Received Data in Binary Format ==
593 593  
594 594  
... ... @@ -604,6 +604,9 @@
604 604  OK
605 605  )))
606 606  
669 +
670 +
671 +
607 607  == 6.8 Send Text Data ==
608 608  
609 609  
... ... @@ -623,6 +623,9 @@
623 623  
624 624  )))
625 625  
691 +
692 +
693 +
626 626  == 6.9 Send Hexadecimal Data ==
627 627  
628 628  
... ... @@ -641,8 +641,12 @@
641 641  
642 642  )))
643 643  
712 +
713 +
714 +
644 644  = 7. LoRaWAN network management =
645 645  
717 +
646 646  == 7.1 Adaptive Data Rate ==
647 647  
648 648  
... ... @@ -662,6 +662,8 @@
662 662  AT_PARAM_ERROR
663 663  )))
664 664  
737 +
738 +
665 665  (% style="color:blue" %)**Downlink Command: 0x22**
666 666  
667 667  If the downlink payload=2201, it means setting the adaptive data rate to 1, while type code is 22.
... ... @@ -669,6 +669,9 @@
669 669  * **Example 1**: Downlink Payload: **2201**  ~/~/ Set AT+ADR=1.
670 670  * **Example 2**: Downlink Payload: **2200FFFF**  ~/~/ Set AT+ADR=0.
671 671  
746 +
747 +
748 +
672 672  == 7.2 LoRa® Class ==
673 673  
674 674  
... ... @@ -687,6 +687,9 @@
687 687  
688 688  )))
689 689  
767 +
768 +
769 +
690 690  == 7.3 Duty Cycle Setting ==
691 691  
692 692  
... ... @@ -705,17 +705,15 @@
705 705  
706 706  )))
707 707  
708 -== 7.4 Data Rate ==
709 709  
710 710  
711 -Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
712 712  
713 -(% style="color:red" %)
714 -**Notice:**
791 +== 7.4 Data Rate ==
715 715  
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 718  
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
795 +
796 +
719 719  (% style="color:blue" %)**AT Command: AT+DR**
720 720  
721 721  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
... ... @@ -728,6 +728,8 @@
728 728  
729 729  )))
730 730  
809 +
810 +
731 731  (% style="color:blue" %)**Downlink Command: 0x2200aaFF**
732 732  
733 733  If the downlink payload=220001FF, it means setting the data rate to 1, while type code is 22 00 aa FF.
... ... @@ -735,6 +735,9 @@
735 735  * **Example 1**: Downlink Payload: **220001FF**  ~/~/ Set AT+DR=1.
736 736  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+DR=0.
737 737  
818 +
819 +
820 +
738 738  == 7.5 Frame Counter Downlink ==
739 739  
740 740  
... ... @@ -753,6 +753,9 @@
753 753  OK
754 754  )))
755 755  
839 +
840 +
841 +
756 756  == 7.6 Frame Counter Uplink ==
757 757  
758 758  Feature: Get or Set the Frame Counter Uplink.
... ... @@ -770,6 +770,9 @@
770 770  
771 771  )))
772 772  
859 +
860 +
861 +
773 773  == 7.7 Join Accept Delay1 ==
774 774  
775 775  
... ... @@ -788,6 +788,9 @@
788 788  
789 789  )))
790 790  
880 +
881 +
882 +
791 791  == 7.8 Join Accept Delay2 ==
792 792  
793 793  
... ... @@ -806,6 +806,9 @@
806 806  
807 807  )))
808 808  
901 +
902 +
903 +
809 809  == 7.9 Public Network Mode ==
810 810  
811 811  
... ... @@ -833,6 +833,9 @@
833 833  )))
834 834  |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %)
835 835  
931 +
932 +
933 +
836 836  == 7.10 Receive Delay1 ==
837 837  
838 838  
... ... @@ -851,6 +851,9 @@
851 851  
852 852  )))
853 853  
952 +
953 +
954 +
854 854  == 7.11 Receive Delay2 ==
855 855  
856 856  
... ... @@ -869,6 +869,9 @@
869 869  
870 870  )))
871 871  
973 +
974 +
975 +
872 872  == 7.12 Rx2 Window Data Rate ==
873 873  
874 874  
... ... @@ -887,6 +887,9 @@
887 887  
888 888  )))
889 889  
994 +
995 +
996 +
890 890  == 7.13 Rx2 Window Frequency ==
891 891  
892 892  
... ... @@ -905,6 +905,9 @@
905 905  
906 906  )))
907 907  
1015 +
1016 +
1017 +
908 908  == 7.14 Transmit Power ==
909 909  
910 910  
... ... @@ -932,6 +932,9 @@
932 932  * **Example 1**: Downlink Payload: **22000102**  ~/~/ Set AT+TXP=2.
933 933  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+TXP=0.
934 934  
1045 +
1046 +
1047 +
935 935  == 7.15 RSSI of the Last Received Packet ==
936 936  
937 937  
... ... @@ -947,6 +947,9 @@
947 947  OK
948 948  )))
949 949  
1063 +
1064 +
1065 +
950 950  == 7.16 SNR of the Last Received Packet ==
951 951  
952 952  
... ... @@ -962,6 +962,9 @@
962 962  OK
963 963  )))
964 964  
1081 +
1082 +
1083 +
965 965  == 7.17 Application Port ==
966 966  
967 967  
... ... @@ -978,6 +978,8 @@
978 978  )))
979 979  |(% style="width:157px" %)AT+PORT=21|(% style="width:204px" %)Set the application port|(% style="width:135px" %)OK
980 980  
1100 +
1101 +
981 981  (% style="color:blue" %)**Downlink Command: 0x23**
982 982  
983 983  Format: Command Code (0x23) followed by 1 bytes port value.
... ... @@ -987,6 +987,9 @@
987 987  * **Example 1**: Downlink Payload: **2301**  ~/~/ set the application port to 1
988 988  * **Example 2**: Downlink Payload:** 2305**  ~/~/ set the application port to 5
989 989  
1111 +
1112 +
1113 +
990 990  == 7.18 Single Channel Mode ==
991 991  
992 992  
... ... @@ -1003,6 +1003,9 @@
1003 1003  )))
1004 1004  |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK
1005 1005  
1130 +
1131 +
1132 +
1006 1006  == 7.19 Eight Channel Mode ==
1007 1007  
1008 1008  
... ... @@ -1021,8 +1021,10 @@
1021 1021  )))
1022 1022  |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK
1023 1023  
1024 -(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**
1025 1025  
1152 +
1153 +(% style="color:blue" %)**Downlink Command: 0x24**
1154 +
1026 1026  Format: Command Code (0x24) followed by 1 bytes channel value.
1027 1027  
1028 1028  If the downlink payload=2401, it means set channel mode to 1, while type code is 24.
... ... @@ -1030,6 +1030,9 @@
1030 1030  * **Example 1**: Downlink Payload: 2401  ~/~/ set channel mode to 1
1031 1031  * **Example 2**: Downlink Payload: 2405  ~/~/ set channel mode to 5
1032 1032  
1162 +
1163 +
1164 +
1033 1033  == 7.20 Get or Set RXwindows1 timeout ==
1034 1034  
1035 1035  
... ... @@ -1081,6 +1081,9 @@
1081 1081  )))
1082 1082  |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK
1083 1083  
1216 +
1217 +
1218 +
1084 1084  == 7.22 Setting up uplinkdwelltime (as923, au915) ==
1085 1085  
1086 1086  
... ... @@ -1097,6 +1097,8 @@
1097 1097  )))
1098 1098  |(% style="width:183px" %)AT+DWELLT=0|(% style="width:179px" %)Set uplinkdwelltime|(% style="width:131px" %)OK
1099 1099  
1235 +
1236 +
1100 1100  (% style="color:blue" %)**Downlink Command: 0x25**
1101 1101  
1102 1102  Format: Command Code (0x25) followed by 1 bytes state value.
... ... @@ -1106,6 +1106,9 @@
1106 1106  * **Example 1**: Downlink Payload: **2501**  ~/~/ set uplinkdwelltime to 1
1107 1107  * **Example 2**: Downlink Payload: **2500**  ~/~/ set uplinkdwelltime to 0
1108 1108  
1246 +
1247 +
1248 +
1109 1109  == 7.23 Set Packet Receiving Response Level ==
1110 1110  
1111 1111  
... ... @@ -1126,6 +1126,9 @@
1126 1126  * For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command.
1127 1127  * 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.
1128 1128  
1269 +
1270 +
1271 +
1129 1129  (% style="color:blue" %)**AT Command: AT+RPL**
1130 1130  
1131 1131  (% border="1" style="background-color:#ffffcc; color:green; width:536.222px" %)
... ... @@ -1136,6 +1136,8 @@
1136 1136  )))
1137 1137  |(% style="width:160px" %)AT+RPL=0|(% style="width:263px" %)Set packet receiving response level|(% style="width:109px" %)OK
1138 1138  
1282 +
1283 +
1139 1139  (% style="color:blue" %)**Downlink Command: 0x21**
1140 1140  
1141 1141  Format: Command Code (0x21) followed by 1 bytes level value.
... ... @@ -1145,6 +1145,9 @@
1145 1145  * **Example 1**: Downlink Payload: **2101**  ~/~/ set packet receiving response level to 1
1146 1146  * **Example 2**: Downlink Payload: **2102**  ~/~/ set packet receiving response level to 2
1147 1147  
1293 +
1294 +
1295 +
1148 1148  == 7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets) ==
1149 1149  
1150 1150  
... ... @@ -1166,6 +1166,8 @@
1166 1166  OK
1167 1167  )))
1168 1168  
1317 +
1318 +
1169 1169  (% style="color:blue" %)**Downlink Command: 0x33**
1170 1170  
1171 1171  Format: Command Code (0x33) followed by 2 bytes mode value.
... ... @@ -1175,6 +1175,9 @@
1175 1175  * Example 1: Downlink Payload: 330100  ~/~/ Set AT+SETMAXNBTRANS=1,0
1176 1176  * Example 2: Downlink Payload: 330201  ~/~/ Set AT+SETMAXNBTRANS=2,1
1177 1177  
1328 +
1329 +
1330 +
1178 1178  == 7.25 Device offline rejoining （LWS007) ==
1179 1179  
1180 1180  
... ... @@ -1211,6 +1211,8 @@
1211 1211  OK
1212 1212  )))
1213 1213  
1367 +
1368 +
1214 1214  (% style="color:blue" %)**Downlink Command: 0x33**
1215 1215  
1216 1216  Format: Command Code (0x32) followed by 2 bytes mode value.
... ... @@ -1219,6 +1219,9 @@
1219 1219  
1220 1220  * **Example 1:** Downlink Payload: 320105A00B40  ~/~/ Set AT+DDETECT=1,1440,2880
1221 1221  
1377 +
1378 +
1379 +
1222 1222  == 7.26 Request the server to send an ACK ==
1223 1223  
1224 1224  
... ... @@ -1236,6 +1236,9 @@
1236 1236  OK
1237 1237  )))
1238 1238  
1397 +
1398 +
1399 +
1239 1239  == 7.27 Adjust network rejoining interval ==
1240 1240  
1241 1241  
... ... @@ -1253,6 +1253,8 @@
1253 1253  Set the ReJoin data transmission interval to 60000ms = 60 seconds
1254 1254  )))
1255 1255  
1417 +
1418 +
1256 1256  (% style="color:blue" %)**Downlink Command: 0x26**
1257 1257  
1258 1258  Format: Command Code (0x26) followed by 2 bytes mode value.
... ... @@ -1262,14 +1262,21 @@
1262 1262  * **Example 1:** Downlink Payload: 26000A  ~/~/ Set AT+RJTDC=10
1263 1263  * **Example 2: **Downlink Payload: 260002  ~/~/ Set AT+RJTDC=2
1264 1264  
1428 +
1429 +
1430 +
1265 1265  = 8. AT Commands Combination =
1266 1266  
1433 +
1267 1267  == 8.1 Set a fix RX2DR for downlink window ==
1268 1268  
1269 1269  
1270 1270  * (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
1271 -* (% 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
1272 1272  
1440 +
1441 +
1442 +
1273 1273  == 8.2 Use Downlink Command to set a fix uplink DR ==
1274 1274  
1275 1275  

Applications

Navigation

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