Last modified by kai on 2024/09/06 10:00
<
From version < 55.1 >
edited by Edwin Chen
on 2022/10/16 07:43
To version < 52.1 >
edited by Edwin Chen
on 2022/07/23 11:23
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -9,14 +9,12 @@
9 9  
10 10  Dragino LoRaWAN End Node support two types of AT Commands and Downlink Commands:
11 11  
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.
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.
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  
18 -
19 -
20 20  )))
21 21  
22 22  = 2. How to use AT Commands or Downlink command =
... ... @@ -25,10 +25,11 @@
25 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 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:
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]], [[How to Convert>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.1ConvertHEXtoBase64]]?
26 +** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]]
29 29  ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server)
30 30  
31 31  
30 +
32 32  = 3. Support End Node and firmware version =
33 33  
34 34  
... ... @@ -104,8 +104,10 @@
104 104  )))
105 105  
106 106  
106 +
107 107  = 4. System Management Commands =
108 108  
109 +
109 109  == 4.1 Change Uplink Interval ==
110 110  
111 111  
... ... @@ -135,7 +135,7 @@
135 135  )))
136 136  
137 137  (((
138 -If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
139 +If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
139 139  )))
140 140  
141 141  * **Example 1**: Downlink Payload:** 0100001E**  ~/~/ Set Transmit Interval (TDC) = 30 seconds
... ... @@ -142,6 +142,7 @@
142 142  * **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
143 143  
144 144  
146 +
145 145  == 4.2 Reboot End Node ==
146 146  
147 147  
... ... @@ -150,10 +150,10 @@
150 150  
151 151  (% style="color:blue" %)**AT Command: ATZ**
152 152  
153 -(% border="1" style="background-color:#ffffcc; color:green; width:546px" %)
154 -|=(% colspan="3" style="width: 543px;" %)ATZ: Trig a reset of the MCU
155 -|(% style="width:157px" %)**Command Example**|(% style="width:92px" %)**Function**|(% style="width:294px" %)**Response**
156 -|(% style="width:157px" %)ATZ|(% style="width:92px" %)Reset MCU|(% style="width:294px" %)(((
155 +(% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %)
156 +|=(% colspan="3" %)ATZ: Trig a reset of the MCU
157 +|**Command Example**|**Function**|**Response**
158 +|ATZ|Reset MCU|(((
157 157  Device reset and show booting info
158 158  
159 159  LSN50 Device/LoRa ST Module
... ... @@ -176,7 +176,6 @@
176 176  (((
177 177  If the downlink payload=**04FF**, the end node will reboot.
178 178  
179 -
180 180  
181 181  )))
182 182  
... ... @@ -188,10 +188,10 @@
188 188  
189 189  (% style="color:blue" %)**AT Command: AT+FDR**
190 190  
191 -(% border="1" style="background-color:#ffffcc; color:green; width:789px" %)
192 -|=(% colspan="3" style="width: 786px;" %)Reset to factory default
193 -|(% style="width:154px" %)**Command Example**|(% style="width:175px" %)**Function**|(% style="width:456px" %)**Response**
194 -|(% style="width:154px" %)AT+FDR|(% style="width:175px" %)Reset to factory default|(% style="width:456px" %)(((
192 +(% border="1" style="background-color:#ffffcc; color:green; width:831.222px" %)
193 +|=(% colspan="3" style="width: 828px;" %)Reset to factory default
194 +|(% style="width:181px" %)**Command Example**|(% style="width:181px" %)**Function**|(% style="width:465px" %)**Response**
195 +|(% style="width:181px" %)AT+FDR|(% style="width:181px" %)Reset to factory default|(% style="width:465px" %)(((
195 195  Device reset to factory default parameters and show booting info
196 196  
197 197  LSN50 Device/LoRa ST Module
... ... @@ -216,7 +216,6 @@
216 216  )))
217 217  
218 218  
219 -
220 220  == 4.4 Show Firmware Version ==
221 221  
222 222  
... ... @@ -225,10 +225,10 @@
225 225  
226 226  (% style="color:blue" %)**AT Command: AT+VER**
227 227  
228 -(% border="1" style="background-color:#ffffcc; color:green; width:542px" %)
229 -|=(% colspan="3" style="width: 539px;" %)AT+VER: Image Version and Frequency Band
230 -|(% style="width:157px" %)**Command Example**|(% style="width:295px" %)**Function**|(% style="width:86px" %)**Response**
231 -|(% style="width:157px" %)AT+VER=?|(% style="width:295px" %)Show Image version and Frequency Band|(% style="width:86px" %)(((
228 +(% border="1" style="background-color:#ffffcc; color:green; width:586px" %)
229 +|=(% colspan="3" style="width: 583px;" %)AT+VER: Image Version and Frequency Band
230 +|(% style="width:170px" %)**Command Example**|(% style="width:300px" %)**Function**|(% style="width:113px" %)**Response**
231 +|(% style="width:170px" %)AT+VER=?|(% style="width:300px" %)Show Image version and Frequency Band|(% style="width:113px" %)(((
232 232  1.3 EU868
233 233  
234 234  OK
... ... @@ -281,7 +281,6 @@
281 281  firmware version: v1.1.0 ~-~-> 110
282 282  
283 283  
284 -
285 285  == 4.5 Show System Configure ==
286 286  
287 287  
... ... @@ -310,6 +310,7 @@
310 310  
311 311  = 5. Keys, IDs and EUIs management =
312 312  
312 +
313 313  == 5.1 Application EUI ==
314 314  
315 315  
... ... @@ -437,8 +437,10 @@
437 437  
438 438  = 6. Joining and sending date on LoRaWAN network =
439 439  
440 +
440 440  == 6.1 Confirm Mode ==
441 441  
443 +
442 442  === 6.1.1  AT+CFM command before DR-LWS007 software stack ===
443 443  
444 444  
... ... @@ -466,6 +466,7 @@
466 466  * **Example 2:** Downlink Payload: 0500  ~/~/ Set AT+CFM=0
467 467  
468 468  
471 +
469 469  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
470 470  
471 471  
... ... @@ -512,6 +512,7 @@
512 512  * **Example 2:** Downlink Payload: 05000700  ~/~/ Set AT+CFM=0,7,0
513 513  
514 514  
518 +
515 515  == 6.2 Confirm Status ==
516 516  
517 517  
... ... @@ -573,6 +573,7 @@
573 573  * **Example 2:** Downlink Payload: **2001**  ~/~/ Set AT+NJM=1
574 574  
575 575  
580 +
576 576  == 6.5 LoRa® Network Join Status ==
577 577  
578 578  
... ... @@ -649,11 +649,11 @@
649 649  
650 650  (% style="color:blue" %)**AT Command: AT+SENDB**
651 651  
652 -(% border="1" style="background-color:#ffffcc; color:green; width:1101px" %)
653 -|=(% colspan="3" style="width: 1098px;" %)AT+SENDB
654 -|(% style="width:257px" %)**Command Example**|(% style="width:394px" %)**Function**|(% style="width:446px" %)**Response**
655 -|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)OK
656 -|(% 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(((
657 +(% border="1" style="background-color:#ffffcc; color:green; width:1120.22px" %)
658 +|=(% colspan="3" style="width: 1117px;" %)AT+SENDB
659 +|(% style="width:257px" %)**Command Example**|(% style="width:406px" %)**Function**|(% style="width:453px" %)**Response**
660 +|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:406px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK
661 +|(% 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(((
657 657  AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
658 658  
659 659  
... ... @@ -662,6 +662,7 @@
662 662  
663 663  = 7. LoRaWAN network management =
664 664  
670 +
665 665  == 7.1 Adaptive Data Rate ==
666 666  
667 667  
... ... @@ -689,6 +689,7 @@
689 689  * **Example 2**: Downlink Payload: **2200FFFF**  ~/~/ Set AT+ADR=0.
690 690  
691 691  
698 +
692 692  == 7.2 LoRa® Class ==
693 693  
694 694  
... ... @@ -695,7 +695,7 @@
695 695  Feature: Get or Set the Device Class(Currently only support class A, class C).
696 696  
697 697  
698 -(% style="color:blue" %)**AT Command:  AT+CLASS**
705 +(% style="color:blue" %)**AT Command:AT+CLASS**
699 699  
700 700  (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %)
701 701  |=(% colspan="3" style="width: 504px;" %)AT+CLASS
... ... @@ -711,10 +711,10 @@
711 711  == 7.3 Duty Cycle Setting ==
712 712  
713 713  
714 -Feature: Get or Set the ETSI Duty Cycle setting** - 0**=disable, **1**=enable - Only for testing.
721 +Feature: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing.
715 715  
716 716  
717 -(% style="color:blue" %)**AT Command:  AT+DCS**
724 +(% style="color:blue" %)**AT Command:AT+DCS**
718 718  
719 719  (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %)
720 720  |=(% colspan="3" style="width: 512px;" %)AT+DCS
... ... @@ -730,15 +730,9 @@
730 730  == 7.4 Data Rate ==
731 731  
732 732  
733 -Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
740 +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  
735 -(% style="color:red" %)
736 -**Notice:**
737 737  
738 -* 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.
739 -* Data Rate specifies Spreading Factor. The mapping various in different frequency band. 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/]]
740 -
741 -
742 742  (% style="color:blue" %)**AT Command: AT+DR**
743 743  
744 744  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
... ... @@ -759,6 +759,7 @@
759 759  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+DR=0.
760 760  
761 761  
763 +
762 762  == 7.5 Frame Counter Downlink ==
763 763  
764 764  
... ... @@ -765,7 +765,7 @@
765 765  Feature: Get or Set the Frame Counter Downlink.
766 766  
767 767  
768 -(% style="color:blue" %)**AT Command:  AT+FCD**
770 +(% style="color:blue" %)**AT Command:AT+FCD**
769 769  
770 770  (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %)
771 771  |=(% colspan="3" style="width: 690px;" %)AT+FCD
... ... @@ -783,7 +783,7 @@
783 783  Feature: Get or Set the Frame Counter Uplink.
784 784  
785 785  
786 -(% style="color:blue" %)**AT Command:  AT+FCU**
788 +(% style="color:blue" %)**AT Command:AT+FCU**
787 787  
788 788  (% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %)
789 789  |=(% colspan="3" style="width: 531px;" %)AT+FCU
... ... @@ -802,7 +802,7 @@
802 802  Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms.
803 803  
804 804  
805 -(% style="color:blue" %)**AT Command:  AT+JN1DL**
807 +(% style="color:blue" %)**AT Command:AT+JN1DL**
806 806  
807 807  (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %)
808 808  |=(% colspan="3" style="width: 534px;" %)AT+JN1DL
... ... @@ -817,11 +817,10 @@
817 817  
818 818  == 7.8 Join Accept Delay2 ==
819 819  
820 -
821 821  Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms.
822 822  
823 823  
824 -(% style="color:blue" %)**AT Command:  AT+JN2DL**
825 +(% style="color:blue" %)**AT Command:AT+JN2DL**
825 825  
826 826  (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %)
827 827  |=(% colspan="3" style="width: 535px;" %)AT+JN2DL
... ... @@ -839,10 +839,10 @@
839 839  
840 840  Feature: Get or Set the public network mode. (0: off, 1: on). A Public LoRaWAN network use 0x34 as syncword. Default Settings; PNM=1
841 841  
842 -(% style="color:red" %)**Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network.**
843 +(% style="color:red" %)Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network
843 843  
844 844  
845 -(% style="color:blue" %)**AT Command:  AT+PNM**
846 +(% style="color:blue" %)**AT Command:AT+PNM**
846 846  
847 847  (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %)
848 848  |=(% colspan="3" style="width: 664px;" %)AT+PNM
... ... @@ -868,7 +868,7 @@
868 868  Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms
869 869  
870 870  
871 -(% style="color:blue" %)**AT Command: AT+RX1DL**
872 +(% style="color:blue" %)**AT Command:AT+RX1DL**
872 872  
873 873  (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %)
874 874  |=(% colspan="3" style="width: 405px;" %)AT+RX1DL
... ... @@ -887,7 +887,7 @@
887 887  Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms
888 888  
889 889  
890 -(% style="color:blue" %)**AT Command: AT+RX2DL**
891 +(% style="color:blue" %)**AT Command:AT+RX2DL**
891 891  
892 892  (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %)
893 893  |=(% colspan="3" style="width: 478px;" %)AT+RX2DL
... ... @@ -906,7 +906,7 @@
906 906  Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X)
907 907  
908 908  
909 -(% style="color:blue" %)**AT Command:  AT+RX2DR**
910 +(% style="color:blue" %)**AT Command:AT+RX2DR**
910 910  
911 911  (% border="1" style="background-color:#ffffcc; color:green; width:525.222px" %)
912 912  |=(% colspan="3" style="width: 522px;" %)AT+RX2DR
... ... @@ -925,7 +925,7 @@
925 925  Feature: Get or Set the Rx2 window frequency
926 926  
927 927  
928 -(% style="color:blue" %)**AT Command:  AT+RX2FQ**
929 +(% style="color:blue" %)**AT Command:AT+RX2FQ**
929 929  
930 930  (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %)
931 931  |=(% 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 -(% 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 +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**
950 +(% 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
... ... @@ -966,6 +966,7 @@
966 966  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+TXP=0.
967 967  
968 968  
970 +
969 969  == 7.15 RSSI of the Last Received Packet ==
970 970  
971 971  
... ... @@ -988,7 +988,7 @@
988 988  Feature: Get the SNR of the last received packet
989 989  
990 990  
991 -(% style="color:blue" %)**AT Command:  AT+SNR**
993 +(% style="color:blue" %)**AT Command:AT+SNR**
992 992  
993 993  (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %)
994 994  |=(% colspan="3" style="width: 568px;" %)AT+SNR
... ... @@ -1043,7 +1043,6 @@
1043 1043  
1044 1044  == 7.19 Eight Channel Mode ==
1045 1045  
1046 -
1047 1047  Feature: Get or Set eight channels mode,Only for US915,AU915,CN470.
1048 1048  
1049 1049  
... ... @@ -1069,6 +1069,7 @@
1069 1069  * **Example 2**: Downlink Payload: 2405  ~/~/ set channel mode to 5
1070 1070  
1071 1071  
1073 +
1072 1072  == 7.20 Get or Set RXwindows1 timeout ==
1073 1073  
1074 1074  
... ... @@ -1088,9 +1088,8 @@
1088 1088  (((
1089 1089  
1090 1090  
1093 +**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.
1091 1091  
1092 -(% 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.
1093 -
1094 1094  
1095 1095  )))
1096 1096  
... ... @@ -1100,7 +1100,6 @@
1100 1100  (((
1101 1101  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.
1102 1102  
1103 -
1104 1104  
1105 1105  )))
1106 1106  
... ... @@ -1147,6 +1147,7 @@
1147 1147  * **Example 2**: Downlink Payload: **2500**  ~/~/ set uplinkdwelltime to 0
1148 1148  
1149 1149  
1150 +
1150 1150  == 7.23 Set Packet Receiving Response Level ==
1151 1151  
1152 1152  
... ... @@ -1187,6 +1187,7 @@
1187 1187  * **Example 2**: Downlink Payload: **2102**  ~/~/ set packet receiving response level to 2
1188 1188  
1189 1189  
1191 +
1190 1190  == 7.24 Controls NBTrans in unconfirmed uplink mode（LWS007 NBTrans:Set retransmission packets) ==
1191 1191  
1192 1192  
... ... @@ -1310,11 +1310,12 @@
1310 1310  
1311 1311  = 8. AT Commands Combination =
1312 1312  
1315 +
1313 1313  == 8.1 Set a fix RX2DR for downlink window ==
1314 1314  
1315 1315  
1316 -* (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
1317 -* (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1319 +* **AT+ADR=0             ** **~-~->**  Disable ADR first
1320 +* **AT+RX2DR=xxxx**  **~-~->**  Set xxxx to your wanted DataRate
1318 1318  
1319 1319  
1320 1320  == 8.2 Use Downlink Command to set a fix uplink DR ==
... ... @@ -1327,5 +1327,3 @@
1327 1327  * AT+ADR=0  [[Reference>>||anchor="H7.1AdaptiveDataRate"]]
1328 1328  * AT+DR=5  [[Reference>>||anchor="H7.4DataRate"]]
1329 1329  * AT+TXP=0  [[Reference>>||anchor="H7.14TransmitPower"]]
1330 -
1331 -

Applications

Navigation

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