Last modified by kai on 2024/09/06 10:00
<
From version < 60.3 >
edited by Xiaoling
on 2023/03/27 13:52
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
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Edwin
Content
... ... @@ -14,20 +14,22 @@
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 +
17 17  )))
18 18  
19 -
20 20  = 2. How to use AT Commands or Downlink command =
21 21  
22 22  
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:
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:
25 25  ** Use HEX format to send a downlink: [[TTN v3>>Notes for TTN]]
26 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]]?
27 27  ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server)
28 28  
29 -(% style="display:none" %) (%%)
30 30  
32 +
31 31  = 3. Support End Node and firmware version =
32 32  
33 33  
... ... @@ -102,6 +102,8 @@
102 102  )))
103 103  )))
104 104  
107 +
108 +
105 105  = 4. System Management Commands =
106 106  
107 107  == 4.1 Change Uplink Interval ==
... ... @@ -139,6 +139,8 @@
139 139  * **Example 1**: Downlink Payload:** 0100001E**  ~/~/ Set Transmit Interval (TDC) = 30 seconds
140 140  * **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
141 141  
146 +
147 +
142 142  == 4.2 Reboot End Node ==
143 143  
144 144  
... ... @@ -173,6 +173,7 @@
173 173  (((
174 174  If the downlink payload=**04FF**, the end node will reboot.
175 175  
182 +
176 176  
177 177  )))
178 178  
... ... @@ -212,6 +212,7 @@
212 212  )))
213 213  
214 214  
222 +
215 215  == 4.4 Show Firmware Version ==
216 216  
217 217  
... ... @@ -242,6 +242,7 @@
242 242  (((
243 243  
244 244  
253 +
245 245  **xx: Software Type:**
246 246  )))
247 247  
... ... @@ -275,6 +275,7 @@
275 275  firmware version: v1.1.0 ~-~-> 110
276 276  
277 277  
287 +
278 278  == 4.5 Show System Configure ==
279 279  
280 280  
... ... @@ -300,6 +300,8 @@
300 300  OK
301 301  )))
302 302  
313 +
314 +
303 303  = 5. Keys, IDs and EUIs management =
304 304  
305 305  == 5.1 Application EUI ==
... ... @@ -318,6 +318,8 @@
318 318  )))
319 319  |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
320 320  
333 +
334 +
321 321  == 5.2 Application Key ==
322 322  
323 323  
... ... @@ -334,6 +334,8 @@
334 334  )))
335 335  |(% 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
336 336  
351 +
352 +
337 337  == 5.3 Application Session Key ==
338 338  
339 339  
... ... @@ -352,6 +352,8 @@
352 352  OK
353 353  )))
354 354  
371 +
372 +
355 355  == 5.4 Device Address ==
356 356  
357 357  
... ... @@ -370,6 +370,8 @@
370 370  )))
371 371  |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK
372 372  
391 +
392 +
373 373  == 5.5 Device EUI ==
374 374  
375 375  
... ... @@ -388,6 +388,8 @@
388 388  OK
389 389  )))
390 390  
411 +
412 +
391 391  == 5.6 Network ID ==
392 392  
393 393  
... ... @@ -404,6 +404,8 @@
404 404  )))
405 405  |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
406 406  
429 +
430 +
407 407  == 5.7 Network Session Key ==
408 408  
409 409  
... ... @@ -420,6 +420,8 @@
420 420  )))
421 421  |(% 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
422 422  
447 +
448 +
423 423  = 6. Joining and sending date on LoRaWAN network =
424 424  
425 425  == 6.1 Confirm Mode ==
... ... @@ -450,6 +450,8 @@
450 450  * **Example 1:** Downlink Payload: 0501  ~/~/ Set AT+CFM=1
451 451  * **Example 2:** Downlink Payload: 0500  ~/~/ Set AT+CFM=0
452 452  
479 +
480 +
453 453  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
454 454  
455 455  
... ... @@ -495,6 +495,8 @@
495 495  * **Example 1:** Downlink Payload: 05010101  ~/~/ Set AT+CFM=1,1,1
496 496  * **Example 2:** Downlink Payload: 05000700  ~/~/ Set AT+CFM=0,7,0
497 497  
526 +
527 +
498 498  == 6.2 Confirm Status ==
499 499  
500 500  
... ... @@ -503,13 +503,15 @@
503 503  
504 504  (% style="color:blue" %)**AT Command: AT+CFS**
505 505  
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(((
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(((
510 510  OK
511 511  )))
512 512  
543 +
544 +
513 513  == 6.3 Join LoRa® Network ==
514 514  
515 515  
... ... @@ -527,6 +527,8 @@
527 527  While Error in format, return AT_BUSY_ERROR
528 528  )))
529 529  
562 +
563 +
530 530  == 6.4 LoRa® Network Join Mode ==
531 531  
532 532  
... ... @@ -553,6 +553,8 @@
553 553  * **Example 1: **Downlink Payload: **2000                  ** ~/~/ Set AT+NJM=0
554 554  * **Example 2:** Downlink Payload: **2001**  ~/~/ Set AT+NJM=1
555 555  
590 +
591 +
556 556  == 6.5 LoRa® Network Join Status ==
557 557  
558 558  
... ... @@ -568,6 +568,8 @@
568 568  OK
569 569  )))
570 570  
607 +
608 +
571 571  == 6.6 Print Last Received Data in Raw Format ==
572 572  
573 573  
... ... @@ -583,6 +583,8 @@
583 583  OK
584 584  )))
585 585  
624 +
625 +
586 586  == 6.7 Print Last Received Data in Binary Format ==
587 587  
588 588  
... ... @@ -598,6 +598,8 @@
598 598  OK
599 599  )))
600 600  
641 +
642 +
601 601  == 6.8 Send Text Data ==
602 602  
603 603  
... ... @@ -617,6 +617,8 @@
617 617  
618 618  )))
619 619  
662 +
663 +
620 620  == 6.9 Send Hexadecimal Data ==
621 621  
622 622  
... ... @@ -635,6 +635,8 @@
635 635  
636 636  )))
637 637  
682 +
683 +
638 638  = 7. LoRaWAN network management =
639 639  
640 640  == 7.1 Adaptive Data Rate ==
... ... @@ -663,6 +663,8 @@
663 663  * **Example 1**: Downlink Payload: **2201**  ~/~/ Set AT+ADR=1.
664 664  * **Example 2**: Downlink Payload: **2200FFFF**  ~/~/ Set AT+ADR=0.
665 665  
712 +
713 +
666 666  == 7.2 LoRa® Class ==
667 667  
668 668  
... ... @@ -681,6 +681,8 @@
681 681  
682 682  )))
683 683  
732 +
733 +
684 684  == 7.3 Duty Cycle Setting ==
685 685  
686 686  
... ... @@ -699,6 +699,8 @@
699 699  
700 700  )))
701 701  
752 +
753 +
702 702  == 7.4 Data Rate ==
703 703  
704 704  
... ... @@ -705,11 +705,9 @@
705 705  Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
706 706  
707 707  (% style="color:red" %)
708 -**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 +(%%)
709 709  
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 -
713 713  (% style="color:blue" %)**AT Command: AT+DR**
714 714  
715 715  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
... ... @@ -729,6 +729,8 @@
729 729  * **Example 1**: Downlink Payload: **220001FF**  ~/~/ Set AT+DR=1.
730 730  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+DR=0.
731 731  
782 +
783 +
732 732  == 7.5 Frame Counter Downlink ==
733 733  
734 734  
... ... @@ -747,6 +747,8 @@
747 747  OK
748 748  )))
749 749  
802 +
803 +
750 750  == 7.6 Frame Counter Uplink ==
751 751  
752 752  Feature: Get or Set the Frame Counter Uplink.
... ... @@ -764,6 +764,8 @@
764 764  
765 765  )))
766 766  
821 +
822 +
767 767  == 7.7 Join Accept Delay1 ==
768 768  
769 769  
... ... @@ -782,6 +782,8 @@
782 782  
783 783  )))
784 784  
841 +
842 +
785 785  == 7.8 Join Accept Delay2 ==
786 786  
787 787  
... ... @@ -800,6 +800,8 @@
800 800  
801 801  )))
802 802  
861 +
862 +
803 803  == 7.9 Public Network Mode ==
804 804  
805 805  
... ... @@ -827,6 +827,8 @@
827 827  )))
828 828  |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %)
829 829  
890 +
891 +
830 830  == 7.10 Receive Delay1 ==
831 831  
832 832  
... ... @@ -845,6 +845,8 @@
845 845  
846 846  )))
847 847  
910 +
911 +
848 848  == 7.11 Receive Delay2 ==
849 849  
850 850  
... ... @@ -863,6 +863,8 @@
863 863  
864 864  )))
865 865  
930 +
931 +
866 866  == 7.12 Rx2 Window Data Rate ==
867 867  
868 868  
... ... @@ -881,6 +881,8 @@
881 881  
882 882  )))
883 883  
950 +
951 +
884 884  == 7.13 Rx2 Window Frequency ==
885 885  
886 886  
... ... @@ -899,6 +899,8 @@
899 899  
900 900  )))
901 901  
970 +
971 +
902 902  == 7.14 Transmit Power ==
903 903  
904 904  
... ... @@ -926,6 +926,8 @@
926 926  * **Example 1**: Downlink Payload: **22000102**  ~/~/ Set AT+TXP=2.
927 927  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+TXP=0.
928 928  
999 +
1000 +
929 929  == 7.15 RSSI of the Last Received Packet ==
930 930  
931 931  
... ... @@ -941,6 +941,8 @@
941 941  OK
942 942  )))
943 943  
1016 +
1017 +
944 944  == 7.16 SNR of the Last Received Packet ==
945 945  
946 946  
... ... @@ -956,6 +956,8 @@
956 956  OK
957 957  )))
958 958  
1033 +
1034 +
959 959  == 7.17 Application Port ==
960 960  
961 961  
... ... @@ -981,6 +981,8 @@
981 981  * **Example 1**: Downlink Payload: **2301**  ~/~/ set the application port to 1
982 982  * **Example 2**: Downlink Payload:** 2305**  ~/~/ set the application port to 5
983 983  
1060 +
1061 +
984 984  == 7.18 Single Channel Mode ==
985 985  
986 986  
... ... @@ -997,6 +997,8 @@
997 997  )))
998 998  |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK
999 999  
1078 +
1079 +
1000 1000  == 7.19 Eight Channel Mode ==
1001 1001  
1002 1002  
... ... @@ -1015,7 +1015,7 @@
1015 1015  )))
1016 1016  |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK
1017 1017  
1018 -(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**
1098 +(% style="color:blue" %)**Downlink Command: 0x24**
1019 1019  
1020 1020  Format: Command Code (0x24) followed by 1 bytes channel value.
1021 1021  
... ... @@ -1024,6 +1024,8 @@
1024 1024  * **Example 1**: Downlink Payload: 2401  ~/~/ set channel mode to 1
1025 1025  * **Example 2**: Downlink Payload: 2405  ~/~/ set channel mode to 5
1026 1026  
1107 +
1108 +
1027 1027  == 7.20 Get or Set RXwindows1 timeout ==
1028 1028  
1029 1029  
... ... @@ -1055,6 +1055,7 @@
1055 1055  (((
1056 1056  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.
1057 1057  
1140 +
1058 1058  
1059 1059  )))
1060 1060  
... ... @@ -1074,6 +1074,8 @@
1074 1074  )))
1075 1075  |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK
1076 1076  
1160 +
1161 +
1077 1077  == 7.22 Setting up uplinkdwelltime (as923, au915) ==
1078 1078  
1079 1079  
... ... @@ -1099,6 +1099,8 @@
1099 1099  * **Example 1**: Downlink Payload: **2501**  ~/~/ set uplinkdwelltime to 1
1100 1100  * **Example 2**: Downlink Payload: **2500**  ~/~/ set uplinkdwelltime to 0
1101 1101  
1187 +
1188 +
1102 1102  == 7.23 Set Packet Receiving Response Level ==
1103 1103  
1104 1104  
... ... @@ -1138,6 +1138,8 @@
1138 1138  * **Example 1**: Downlink Payload: **2101**  ~/~/ set packet receiving response level to 1
1139 1139  * **Example 2**: Downlink Payload: **2102**  ~/~/ set packet receiving response level to 2
1140 1140  
1228 +
1229 +
1141 1141  == 7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets) ==
1142 1142  
1143 1143  
... ... @@ -1168,16 +1168,13 @@
1168 1168  * Example 1: Downlink Payload: 330100  ~/~/ Set AT+SETMAXNBTRANS=1,0
1169 1169  * Example 2: Downlink Payload: 330201  ~/~/ Set AT+SETMAXNBTRANS=2,1
1170 1170  
1260 +
1261 +
1171 1171  == 7.25 Device offline rejoining （LWS007) ==
1172 1172  
1173 1173  
1174 1174  (% style="color:blue" %)**AT Command: AT+DDETECT**
1175 1175  
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 -
1181 1181  (% border="1" style="background-color:#ffffcc; color:green; width:710.222px" %)
1182 1182  |=(% colspan="3" style="width: 707px;" %)AT+**DDETECT**
1183 1183  |(% style="width:160px" %)**Command Example**|(% style="width:198px" %)**Function**|(% style="width:349px" %)**Response**
... ... @@ -1209,18 +1209,16 @@
1209 1209  OK
1210 1210  )))
1211 1211  
1212 -(% style="color:blue" %)**Downlink Command: 0x32**
1298 +(% style="color:blue" %)**Downlink Command: 0x33**
1213 1213  
1214 1214  Format: Command Code (0x32) followed by 2 bytes mode value.
1215 1215  
1216 -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.
1217 1217  
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.
1304 +* **Example 1:** Downlink Payload: 320105A00B40  ~/~/ Set AT+DDETECT=1,1440,2880
1223 1223  
1306 +
1307 +
1224 1224  == 7.26 Request the server to send an ACK ==
1225 1225  
1226 1226  
... ... @@ -1238,6 +1238,8 @@
1238 1238  OK
1239 1239  )))
1240 1240  
1325 +
1326 +
1241 1241  == 7.27 Adjust network rejoining interval ==
1242 1242  
1243 1243  
... ... @@ -1246,13 +1246,13 @@
1246 1246  (% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %)
1247 1247  |=(% colspan="3" style="width: 724px;" %)AT+RJTDC
1248 1248  |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response**
1249 -|(% 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(((
1250 1250  OK
1251 1251  
1252 -the interval is 30 min
1338 +the interval is 30000ms = 30s
1253 1253  )))
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
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
1256 1256  )))
1257 1257  
1258 1258  (% style="color:blue" %)**Downlink Command: 0x26**
... ... @@ -1264,6 +1264,8 @@
1264 1264  * **Example 1:** Downlink Payload: 26000A  ~/~/ Set AT+RJTDC=10
1265 1265  * **Example 2: **Downlink Payload: 260002  ~/~/ Set AT+RJTDC=2
1266 1266  
1353 +
1354 +
1267 1267  = 8. AT Commands Combination =
1268 1268  
1269 1269  == 8.1 Set a fix RX2DR for downlink window ==
... ... @@ -1272,6 +1272,8 @@
1272 1272  * (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
1273 1273  * (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1274 1274  
1363 +
1364 +
1275 1275  == 8.2 Use Downlink Command to set a fix uplink DR ==
1276 1276  
1277 1277  

Applications

Navigation

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