Last modified by kai on 2024/09/06 10:00
<
From version < 52.5 >
edited by Xiaoling
on 2022/08/12 16:24
To version < 58.1 >
edited by Bei Jinggeng
on 2022/12/02 10:28
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Bei
Content
... ... @@ -9,8 +9,8 @@
9 9  
10 10  Dragino LoRaWAN End Node support two types of AT Commands and Downlink Commands:
11 11  
12 -* **Common Commands:** They should be available for each sensor, such as: change uplink interval, reset device.
13 -* **Sensor Related Commands:** Only for special sensor, such as control relay, poll RS485 device.
12 +* (% style="color:blue" %)**Common Commands:** (%%) They should be available for each sensor, such as: change uplink interval, reset device.
13 +* (% style="color:blue" %)**Sensor Related Commands:** (%%) Only for special sensor, such as control relay, poll RS485 device.
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.**
... ... @@ -22,14 +22,12 @@
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:
25 +* **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/]]
26 +* **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]]
28 +** 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 -
32 -
33 33  = 3. Support End Node and firmware version =
34 34  
35 35  
... ... @@ -104,12 +104,8 @@
104 104  )))
105 105  )))
106 106  
107 -
108 -
109 -
110 110  = 4. System Management Commands =
111 111  
112 -
113 113  == 4.1 Change Uplink Interval ==
114 114  
115 115  
... ... @@ -139,16 +139,12 @@
139 139  )))
140 140  
141 141  (((
142 -If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
136 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
143 143  )))
144 144  
145 145  * **Example 1**: Downlink Payload:** 0100001E**  ~/~/ Set Transmit Interval (TDC) = 30 seconds
146 146  * **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
147 147  
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  
... ... @@ -491,7 +491,6 @@
491 491  * **Example 1:** Downlink Payload: 0501  ~/~/ Set AT+CFM=1
492 492  * **Example 2:** Downlink Payload: 0500  ~/~/ Set AT+CFM=0
493 493  
494 -
495 495  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
496 496  
497 497  
... ... @@ -537,7 +537,6 @@
537 537  * **Example 1:** Downlink Payload: 05010101  ~/~/ Set AT+CFM=1,1,1
538 538  * **Example 2:** Downlink Payload: 05000700  ~/~/ Set AT+CFM=0,7,0
539 539  
540 -
541 541  == 6.2 Confirm Status ==
542 542  
543 543  
... ... @@ -596,7 +596,6 @@
596 596  * **Example 1: **Downlink Payload: **2000                  ** ~/~/ Set AT+NJM=0
597 597  * **Example 2:** Downlink Payload: **2001**  ~/~/ Set AT+NJM=1
598 598  
599 -
600 600  == 6.5 LoRa® Network Join Status ==
601 601  
602 602  
... ... @@ -669,11 +669,11 @@
669 669  
670 670  (% style="color:blue" %)**AT Command: AT+SENDB**
671 671  
672 -(% border="1" style="background-color:#ffffcc; color:green; width:1120.22px" %)
673 -|=(% colspan="3" style="width: 1117px;" %)AT+SENDB
674 -|(% style="width:257px" %)**Command Example**|(% style="width:406px" %)**Function**|(% style="width:453px" %)**Response**
675 -|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:406px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK
676 -|(% style="width:257px" %)AT+SENDB=abcdef0123456789|(% style="width:406px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)While Error in format, return(((
632 +(% border="1" style="background-color:#ffffcc; color:green; width:1101px" %)
633 +|=(% colspan="3" style="width: 1098px;" %)AT+SENDB
634 +|(% style="width:257px" %)**Command Example**|(% style="width:394px" %)**Function**|(% style="width:446px" %)**Response**
635 +|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)OK
636 +|(% style="width:257px" %)AT+SENDB=abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)While Error in format, return(((
677 677  AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
678 678  
679 679  
... ... @@ -681,7 +681,6 @@
681 681  
682 682  = 7. LoRaWAN network management =
683 683  
684 -
685 685  == 7.1 Adaptive Data Rate ==
686 686  
687 687  
... ... @@ -714,7 +714,7 @@
714 714  Feature: Get or Set the Device Class(Currently only support class A, class C).
715 715  
716 716  
717 -(% style="color:blue" %)**AT Command:AT+CLASS**
676 +(% style="color:blue" %)**AT Command:  AT+CLASS**
718 718  
719 719  (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %)
720 720  |=(% colspan="3" style="width: 504px;" %)AT+CLASS
... ... @@ -729,10 +729,10 @@
729 729  == 7.3 Duty Cycle Setting ==
730 730  
731 731  
732 -Feature: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing.
691 +Feature: Get or Set the ETSI Duty Cycle setting** - 0**=disable, **1**=enable - Only for testing.
733 733  
734 734  
735 -(% style="color:blue" %)**AT Command:AT+DCS**
694 +(% style="color:blue" %)**AT Command:  AT+DCS**
736 736  
737 737  (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %)
738 738  |=(% colspan="3" style="width: 512px;" %)AT+DCS
... ... @@ -747,9 +747,14 @@
747 747  == 7.4 Data Rate ==
748 748  
749 749  
750 -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
709 +Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
751 751  
711 +(% style="color:red" %)
712 +**Notice:**
752 752  
714 +* 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.
715 +* 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/]]
716 +
753 753  (% style="color:blue" %)**AT Command: AT+DR**
754 754  
755 755  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
... ... @@ -775,7 +775,7 @@
775 775  Feature: Get or Set the Frame Counter Downlink.
776 776  
777 777  
778 -(% style="color:blue" %)**AT Command:AT+FCD**
742 +(% style="color:blue" %)**AT Command:  AT+FCD**
779 779  
780 780  (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %)
781 781  |=(% colspan="3" style="width: 690px;" %)AT+FCD
... ... @@ -792,7 +792,7 @@
792 792  Feature: Get or Set the Frame Counter Uplink.
793 793  
794 794  
795 -(% style="color:blue" %)**AT Command:AT+FCU**
759 +(% style="color:blue" %)**AT Command:  AT+FCU**
796 796  
797 797  (% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %)
798 798  |=(% colspan="3" style="width: 531px;" %)AT+FCU
... ... @@ -810,7 +810,7 @@
810 810  Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms.
811 811  
812 812  
813 -(% style="color:blue" %)**AT Command:AT+JN1DL**
777 +(% style="color:blue" %)**AT Command:  AT+JN1DL**
814 814  
815 815  (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %)
816 816  |=(% colspan="3" style="width: 534px;" %)AT+JN1DL
... ... @@ -824,10 +824,11 @@
824 824  
825 825  == 7.8 Join Accept Delay2 ==
826 826  
791 +
827 827  Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms.
828 828  
829 829  
830 -(% style="color:blue" %)**AT Command:AT+JN2DL**
795 +(% style="color:blue" %)**AT Command:  AT+JN2DL**
831 831  
832 832  (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %)
833 833  |=(% colspan="3" style="width: 535px;" %)AT+JN2DL
... ... @@ -847,7 +847,7 @@
847 847  (% style="color:red" %)**Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network.**
848 848  
849 849  
850 -(% style="color:blue" %)**AT Command:AT+PNM**
815 +(% style="color:blue" %)**AT Command:  AT+PNM**
851 851  
852 852  (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %)
853 853  |=(% colspan="3" style="width: 664px;" %)AT+PNM
... ... @@ -872,7 +872,7 @@
872 872  Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms
873 873  
874 874  
875 -(% style="color:blue" %)**AT Command:AT+RX1DL**
840 +(% style="color:blue" %)**AT Command: AT+RX1DL**
876 876  
877 877  (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %)
878 878  |=(% colspan="3" style="width: 405px;" %)AT+RX1DL
... ... @@ -890,7 +890,7 @@
890 890  Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms
891 891  
892 892  
893 -(% style="color:blue" %)**AT Command:AT+RX2DL**
858 +(% style="color:blue" %)**AT Command: AT+RX2DL**
894 894  
895 895  (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %)
896 896  |=(% colspan="3" style="width: 478px;" %)AT+RX2DL
... ... @@ -908,7 +908,7 @@
908 908  Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X)
909 909  
910 910  
911 -(% style="color:blue" %)**AT Command:AT+RX2DR**
876 +(% style="color:blue" %)**AT Command:  AT+RX2DR**
912 912  
913 913  (% border="1" style="background-color:#ffffcc; color:green; width:525.222px" %)
914 914  |=(% colspan="3" style="width: 522px;" %)AT+RX2DR
... ... @@ -926,7 +926,7 @@
926 926  Feature: Get or Set the Rx2 window frequency
927 927  
928 928  
929 -(% style="color:blue" %)**AT Command:AT+RX2FQ**
894 +(% style="color:blue" %)**AT Command:  AT+RX2FQ**
930 930  
931 931  (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %)
932 932  |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ
... ... @@ -943,10 +943,10 @@
943 943  
944 944  Feature: Get or Set the Transmit Power(0-5, MAX:0, MIN:5, according to LoRaWAN Spec, or 40=10dB, 41 = 11dB, …, 50 = 20dB which is out of LoRaWAN spec. )
945 945  
946 -Notice: Transmit Power might be changed by ADR from LoRaWAN server. So manually change TXP also remember to set AT+ADR=0 in sensor
911 +(% style="color:red" %)**Notice: Transmit Power might be changed by ADR from LoRaWAN server. So manually change TXP also remember to set AT+ADR=0 in sensor**
947 947  
948 948  
949 -(% style="color:blue" %)**AT Command:AT+TXP**
914 +(% style="color:blue" %)**AT Command:  AT+TXP**
950 950  
951 951  (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %)
952 952  |=(% colspan="3" style="width: 462px;" %)AT+TXP
... ... @@ -965,7 +965,6 @@
965 965  * **Example 1**: Downlink Payload: **22000102**  ~/~/ Set AT+TXP=2.
966 966  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+TXP=0.
967 967  
968 -
969 969  == 7.15 RSSI of the Last Received Packet ==
970 970  
971 971  
... ... @@ -987,7 +987,7 @@
987 987  Feature: Get the SNR of the last received packet
988 988  
989 989  
990 -(% style="color:blue" %)**AT Command:AT+SNR**
954 +(% style="color:blue" %)**AT Command:  AT+SNR**
991 991  
992 992  (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %)
993 993  |=(% colspan="3" style="width: 568px;" %)AT+SNR
... ... @@ -1021,7 +1021,6 @@
1021 1021  * **Example 1**: Downlink Payload: **2301**  ~/~/ set the application port to 1
1022 1022  * **Example 2**: Downlink Payload:** 2305**  ~/~/ set the application port to 5
1023 1023  
1024 -
1025 1025  == 7.18 Single Channel Mode ==
1026 1026  
1027 1027  
... ... @@ -1056,7 +1056,7 @@
1056 1056  )))
1057 1057  |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK
1058 1058  
1059 -(% style="color:blue" %)**Downlink Command: 0x24**
1022 +(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**
1060 1060  
1061 1061  Format: Command Code (0x24) followed by 1 bytes channel value.
1062 1062  
... ... @@ -1065,7 +1065,6 @@
1065 1065  * **Example 1**: Downlink Payload: 2401  ~/~/ set channel mode to 1
1066 1066  * **Example 2**: Downlink Payload: 2405  ~/~/ set channel mode to 5
1067 1067  
1068 -
1069 1069  == 7.20 Get or Set RXwindows1 timeout ==
1070 1070  
1071 1071  
... ... @@ -1085,8 +1085,9 @@
1085 1085  (((
1086 1086  
1087 1087  
1088 -**AT+RX1TWO** is theRxSingle timeout value of receive window 1. If it is not set, then the queriedvalue is the default value. If it is set, then the queried value is the setvalue. AT+RX2TWO is thesame as above. The definitionof RxSingle timeout is as described in the following paragraph.
1089 1089  
1051 +(% style="color:blue" %)**AT+RX1WTO**(%%) is theRxSingle timeout value of receive window 1. If it is not set, then the queriedvalue is the default value. If it is set, then the queried value is the setvalue. AT+RX2TWO is thesame as above. The definitionof RxSingle timeout is as described in the following paragraph.
1052 +
1090 1090  
1091 1091  )))
1092 1092  
... ... @@ -1096,6 +1096,7 @@
1096 1096  (((
1097 1097  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.
1098 1098  
1062 +
1099 1099  
1100 1100  )))
1101 1101  
... ... @@ -1140,7 +1140,6 @@
1140 1140  * **Example 1**: Downlink Payload: **2501**  ~/~/ set uplinkdwelltime to 1
1141 1141  * **Example 2**: Downlink Payload: **2500**  ~/~/ set uplinkdwelltime to 0
1142 1142  
1143 -
1144 1144  == 7.23 Set Packet Receiving Response Level ==
1145 1145  
1146 1146  
... ... @@ -1180,7 +1180,6 @@
1180 1180  * **Example 1**: Downlink Payload: **2101**  ~/~/ set packet receiving response level to 1
1181 1181  * **Example 2**: Downlink Payload: **2102**  ~/~/ set packet receiving response level to 2
1182 1182  
1183 -
1184 1184  == 7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets) ==
1185 1185  
1186 1186  
... ... @@ -1211,7 +1211,6 @@
1211 1211  * Example 1: Downlink Payload: 330100  ~/~/ Set AT+SETMAXNBTRANS=1,0
1212 1212  * Example 2: Downlink Payload: 330201  ~/~/ Set AT+SETMAXNBTRANS=2,1
1213 1213  
1214 -
1215 1215  == 7.25 Device offline rejoining （LWS007) ==
1216 1216  
1217 1217  
... ... @@ -1256,7 +1256,6 @@
1256 1256  
1257 1257  * **Example 1:** Downlink Payload: 320105A00B40  ~/~/ Set AT+DDETECT=1,1440,2880
1258 1258  
1259 -
1260 1260  == 7.26 Request the server to send an ACK ==
1261 1261  
1262 1262  
... ... @@ -1300,17 +1300,14 @@
1300 1300  * **Example 1:** Downlink Payload: 26000A  ~/~/ Set AT+RJTDC=10
1301 1301  * **Example 2: **Downlink Payload: 260002  ~/~/ Set AT+RJTDC=2
1302 1302  
1303 -
1304 1304  = 8. AT Commands Combination =
1305 1305  
1306 -
1307 1307  == 8.1 Set a fix RX2DR for downlink window ==
1308 1308  
1309 1309  
1310 -* **AT+ADR=0             ** **~-~->**  Disable ADR first
1311 -* **AT+RX2DR=xxxx**  **~-~->**  Set xxxx to your wanted DataRate
1268 +* (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
1269 +* (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1312 1312  
1313 -
1314 1314  == 8.2 Use Downlink Command to set a fix uplink DR ==
1315 1315  
1316 1316  

Applications

Navigation

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