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.** ... ... @@ -22,14 +22,12 @@ 22 22 = 2. How to use AT Commands or Downlink command = 23 23 24 24 25 -* ForAT Command,See Devices User Manual forDevice. The user manual can be found in each product page of [[Dragino Official Website>>url:http://www.dragino.com/]]26 -* ForLoRaWAN Downlink: The gateway transfer downlink command in HEX format. This page shows theHEX format downlinkcodefor eachcommand. 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:11 20.22px" %)673 -|=(% colspan="3" style="width: 1 117px;" %)AT+SENDB674 -|(% style="width:257px" %)**Command Example**|(% style="width:4 06px" %)**Function**|(% style="width:453px" %)**Response**675 -|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:4 06px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK676 -|(% 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((( 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 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 server709 +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 ... ... @@ -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** 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