Changes for page End Device AT Commands and Downlink Command
Last modified by kai on 2024/09/06 10:00
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Edwin - 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.** ... ... @@ -25,11 +25,9 @@ 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]] 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 ... ... @@ -452,10 +452,8 @@ 452 452 453 453 = 6. Joining and sending date on LoRaWAN network = 454 454 455 - 456 456 == 6.1 Confirm Mode == 457 457 458 - 459 459 === 6.1.1 AT+CFM command before DR-LWS007 software stack === 460 460 461 461 ... ... @@ -482,7 +482,6 @@ 482 482 * **Example 1:** Downlink Payload: 0501 ~/~/ Set AT+CFM=1 483 483 * **Example 2:** Downlink Payload: 0500 ~/~/ Set AT+CFM=0 484 484 485 - 486 486 === 6.1.2 AT+CFM command since DR-LWS007 software stack === 487 487 488 488 ... ... @@ -528,7 +528,6 @@ 528 528 * **Example 1:** Downlink Payload: 05010101 ~/~/ Set AT+CFM=1,1,1 529 529 * **Example 2:** Downlink Payload: 05000700 ~/~/ Set AT+CFM=0,7,0 530 530 531 - 532 532 == 6.2 Confirm Status == 533 533 534 534 ... ... @@ -587,7 +587,6 @@ 587 587 * **Example 1: **Downlink Payload: **2000 ** ~/~/ Set AT+NJM=0 588 588 * **Example 2:** Downlink Payload: **2001** ~/~/ Set AT+NJM=1 589 589 590 - 591 591 == 6.5 LoRa® Network Join Status == 592 592 593 593 ... ... @@ -660,11 +660,11 @@ 660 660 661 661 (% style="color:blue" %)**AT Command: AT+SENDB** 662 662 663 -(% border="1" style="background-color:#ffffcc; color:green; width:11 20.22px" %)664 -|=(% colspan="3" style="width: 1 117px;" %)AT+SENDB665 -|(% style="width:257px" %)**Command Example**|(% style="width:4 06px" %)**Function**|(% style="width:453px" %)**Response**666 -|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:4 06px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK667 -|(% style="width:257px" %)AT+SENDB=abcdef0123456789|(% style="width:4 06px" %)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((( 668 668 AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 669 669 670 670 ... ... @@ -672,7 +672,6 @@ 672 672 673 673 = 7. LoRaWAN network management = 674 674 675 - 676 676 == 7.1 Adaptive Data Rate == 677 677 678 678 ... ... @@ -699,6 +699,7 @@ 699 699 * **Example 1**: Downlink Payload: **2201** ~/~/ Set AT+ADR=1. 700 700 * **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 701 701 670 + 702 702 == 7.2 LoRa® Class == 703 703 704 704 ... ... @@ -705,7 +705,7 @@ 705 705 Feature: Get or Set the Device Class(Currently only support class A, class C). 706 706 707 707 708 -(% style="color:blue" %)**AT Command:AT+CLASS** 677 +(% style="color:blue" %)**AT Command: AT+CLASS** 709 709 710 710 (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %) 711 711 |=(% colspan="3" style="width: 504px;" %)AT+CLASS ... ... @@ -720,10 +720,10 @@ 720 720 == 7.3 Duty Cycle Setting == 721 721 722 722 723 -Feature: Get or Set the ETSI Duty Cycle setting 692 +Feature: Get or Set the ETSI Duty Cycle setting** - 0**=disable, **1**=enable - Only for testing. 724 724 725 725 726 -(% style="color:blue" %)**AT Command:AT+DCS** 695 +(% style="color:blue" %)**AT Command: AT+DCS** 727 727 728 728 (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %) 729 729 |=(% colspan="3" style="width: 512px;" %)AT+DCS ... ... @@ -738,9 +738,14 @@ 738 738 == 7.4 Data Rate == 739 739 740 740 741 -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 server710 +Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) . 742 742 712 +(% style="color:red" %) 713 +**Notice:** 743 743 715 +* 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. 716 +* 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/]] 717 + 744 744 (% style="color:blue" %)**AT Command: AT+DR** 745 745 746 746 (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %) ... ... @@ -760,6 +760,7 @@ 760 760 * **Example 1**: Downlink Payload: **220001FF** ~/~/ Set AT+DR=1. 761 761 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 762 762 737 + 763 763 == 7.5 Frame Counter Downlink == 764 764 765 765 ... ... @@ -766,7 +766,7 @@ 766 766 Feature: Get or Set the Frame Counter Downlink. 767 767 768 768 769 -(% style="color:blue" %)**AT Command:AT+FCD** 744 +(% style="color:blue" %)**AT Command: AT+FCD** 770 770 771 771 (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %) 772 772 |=(% 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** 761 +(% 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 ... ... @@ -801,7 +801,7 @@ 801 801 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms. 802 802 803 803 804 -(% style="color:blue" %)**AT Command:AT+JN1DL** 779 +(% style="color:blue" %)**AT Command: AT+JN1DL** 805 805 806 806 (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %) 807 807 |=(% colspan="3" style="width: 534px;" %)AT+JN1DL ... ... @@ -815,10 +815,11 @@ 815 815 816 816 == 7.8 Join Accept Delay2 == 817 817 793 + 818 818 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms. 819 819 820 820 821 -(% style="color:blue" %)**AT Command:AT+JN2DL** 797 +(% style="color:blue" %)**AT Command: AT+JN2DL** 822 822 823 823 (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %) 824 824 |=(% colspan="3" style="width: 535px;" %)AT+JN2DL ... ... @@ -838,7 +838,7 @@ 838 838 (% style="color:red" %)**Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network.** 839 839 840 840 841 -(% style="color:blue" %)**AT Command:AT+PNM** 817 +(% style="color:blue" %)**AT Command: AT+PNM** 842 842 843 843 (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %) 844 844 |=(% colspan="3" style="width: 664px;" %)AT+PNM ... ... @@ -863,7 +863,7 @@ 863 863 Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms 864 864 865 865 866 -(% style="color:blue" %)**AT Command:AT+RX1DL** 842 +(% style="color:blue" %)**AT Command: AT+RX1DL** 867 867 868 868 (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %) 869 869 |=(% colspan="3" style="width: 405px;" %)AT+RX1DL ... ... @@ -881,7 +881,7 @@ 881 881 Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms 882 882 883 883 884 -(% style="color:blue" %)**AT Command:AT+RX2DL** 860 +(% style="color:blue" %)**AT Command: AT+RX2DL** 885 885 886 886 (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %) 887 887 |=(% colspan="3" style="width: 478px;" %)AT+RX2DL ... ... @@ -899,7 +899,7 @@ 899 899 Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X) 900 900 901 901 902 -(% style="color:blue" %)**AT Command:AT+RX2DR** 878 +(% style="color:blue" %)**AT Command: AT+RX2DR** 903 903 904 904 (% border="1" style="background-color:#ffffcc; color:green; width:525.222px" %) 905 905 |=(% colspan="3" style="width: 522px;" %)AT+RX2DR ... ... @@ -917,7 +917,7 @@ 917 917 Feature: Get or Set the Rx2 window frequency 918 918 919 919 920 -(% style="color:blue" %)**AT Command:AT+RX2FQ** 896 +(% style="color:blue" %)**AT Command: AT+RX2FQ** 921 921 922 922 (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %) 923 923 |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ ... ... @@ -934,10 +934,10 @@ 934 934 935 935 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. ) 936 936 937 -Notice: Transmit Power might be changed by ADR from LoRaWAN server. So manually change TXP also remember to set AT+ADR=0 in sensor 913 +(% 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** 938 938 939 939 940 -(% style="color:blue" %)**AT Command:AT+TXP** 916 +(% style="color:blue" %)**AT Command: AT+TXP** 941 941 942 942 (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %) 943 943 |=(% colspan="3" style="width: 462px;" %)AT+TXP ... ... @@ -956,7 +956,6 @@ 956 956 * **Example 1**: Downlink Payload: **22000102** ~/~/ Set AT+TXP=2. 957 957 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+TXP=0. 958 958 959 - 960 960 == 7.15 RSSI of the Last Received Packet == 961 961 962 962 ... ... @@ -978,7 +978,7 @@ 978 978 Feature: Get the SNR of the last received packet 979 979 980 980 981 -(% style="color:blue" %)**AT Command:AT+SNR** 956 +(% style="color:blue" %)**AT Command: AT+SNR** 982 982 983 983 (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %) 984 984 |=(% colspan="3" style="width: 568px;" %)AT+SNR ... ... @@ -1012,7 +1012,6 @@ 1012 1012 * **Example 1**: Downlink Payload: **2301** ~/~/ set the application port to 1 1013 1013 * **Example 2**: Downlink Payload:** 2305** ~/~/ set the application port to 5 1014 1014 1015 - 1016 1016 == 7.18 Single Channel Mode == 1017 1017 1018 1018 ... ... @@ -1056,7 +1056,6 @@ 1056 1056 * **Example 1**: Downlink Payload: 2401 ~/~/ set channel mode to 1 1057 1057 * **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1058 1058 1059 - 1060 1060 == 7.20 Get or Set RXwindows1 timeout == 1061 1061 1062 1062 ... ... @@ -1076,8 +1076,9 @@ 1076 1076 ((( 1077 1077 1078 1078 1079 -**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. 1080 1080 1053 +(% 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. 1054 + 1081 1081 1082 1082 ))) 1083 1083 ... ... @@ -1087,6 +1087,7 @@ 1087 1087 ((( 1088 1088 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. 1089 1089 1064 + 1090 1090 1091 1091 ))) 1092 1092 ... ... @@ -1131,7 +1131,6 @@ 1131 1131 * **Example 1**: Downlink Payload: **2501** ~/~/ set uplinkdwelltime to 1 1132 1132 * **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1133 1133 1134 - 1135 1135 == 7.23 Set Packet Receiving Response Level == 1136 1136 1137 1137 ... ... @@ -1171,7 +1171,6 @@ 1171 1171 * **Example 1**: Downlink Payload: **2101** ~/~/ set packet receiving response level to 1 1172 1172 * **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1173 1173 1174 - 1175 1175 == 7.24 Controls NBTrans in unconfirmed uplink mode(LWS007 NBTrans:Set retransmission packets) == 1176 1176 1177 1177 ... ... @@ -1202,7 +1202,6 @@ 1202 1202 * Example 1: Downlink Payload: 330100 ~/~/ Set AT+SETMAXNBTRANS=1,0 1203 1203 * Example 2: Downlink Payload: 330201 ~/~/ Set AT+SETMAXNBTRANS=2,1 1204 1204 1205 - 1206 1206 == 7.25 Device offline rejoining (LWS007) == 1207 1207 1208 1208 ... ... @@ -1247,7 +1247,6 @@ 1247 1247 1248 1248 * **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1249 1249 1250 - 1251 1251 == 7.26 Request the server to send an ACK == 1252 1252 1253 1253 ... ... @@ -1291,17 +1291,14 @@ 1291 1291 * **Example 1:** Downlink Payload: 26000A ~/~/ Set AT+RJTDC=10 1292 1292 * **Example 2: **Downlink Payload: 260002 ~/~/ Set AT+RJTDC=2 1293 1293 1294 - 1295 1295 = 8. AT Commands Combination = 1296 1296 1297 - 1298 1298 == 8.1 Set a fix RX2DR for downlink window == 1299 1299 1300 1300 1301 -* **AT+ADR=0 ** **~-~->** Disable ADR first 1302 -* **AT+RX2DR=xxxx** 1270 +* (% style="color:blue" %)**AT+ADR=0 **(%%) **~-~->** Disable ADR first 1271 +* (% style="color:blue" %)**AT+RX2DR=xxxx** (%%) **~-~->** Set xxxx to your wanted DataRate 1303 1303 1304 - 1305 1305 == 8.2 Use Downlink Command to set a fix uplink DR == 1306 1306 1307 1307