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. Bei1 +XWiki.Edwin - Content
-
... ... @@ -9,12 +9,11 @@ 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 - 18 18 19 19 ))) 20 20 ... ... @@ -21,12 +21,14 @@ 21 21 = 2. How to use AT Commands or Downlink command = 22 22 23 23 24 -* **AT Command**:See Devices User Manual forhow to connect to devicevia USB TTL adapter and use. The user manual can be found in each product page of [[Dragino Official Website>>url:http://www.dragino.com/]]25 -* **LoRaWAN DownlinkCommand**: The gateway transfer downlink command in HEX format. This page shows theDownlinkCommandIn HEXformat.PleasenotesomeLoRaWANservers use base64 as downlink codeso user need to convert HEX to Base64 and use. Below are referencesfor how to use downlink command:23 +* 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/]] 24 +* 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: 26 26 ** Use HEX format to send a downlink: [[TTN v3>>Notes for TTN]] 27 -** 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]] 28 28 ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server) 29 29 29 + 30 + 30 30 = 3. Support End Node and firmware version = 31 31 32 32 ... ... @@ -102,8 +102,10 @@ 102 102 ))) 103 103 104 104 106 + 105 105 = 4. System Management Commands = 106 106 109 + 107 107 == 4.1 Change Uplink Interval == 108 108 109 109 ... ... @@ -133,7 +133,7 @@ 133 133 ))) 134 134 135 135 ((( 136 -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. 137 137 ))) 138 138 139 139 * **Example 1**: Downlink Payload:** 0100001E** ~/~/ Set Transmit Interval (TDC) = 30 seconds ... ... @@ -140,6 +140,7 @@ 140 140 * **Example 2**: Downlink Payload:** 0100003C** ~/~/ Set Transmit Interval (TDC) = 60 seconds 141 141 142 142 146 + 143 143 == 4.2 Reboot End Node == 144 144 145 145 ... ... @@ -148,10 +148,10 @@ 148 148 149 149 (% style="color:blue" %)**AT Command: ATZ** 150 150 151 -(% border="1" style="background-color:#ffffcc; color:green; width: 546px" %)152 -|=(% colspan="3" style="width: 543px;"%)ATZ: Trig a reset of the MCU153 -| (% style="width:157px" %)**Command Example**|(% style="width:92px" %)**Function**|(% style="width:294px" %)**Response**154 -| (% 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|((( 155 155 Device reset and show booting info 156 156 157 157 LSN50 Device/LoRa ST Module ... ... @@ -185,10 +185,10 @@ 185 185 186 186 (% style="color:blue" %)**AT Command: AT+FDR** 187 187 188 -(% border="1" style="background-color:#ffffcc; color:green; width: 789px" %)189 -|=(% colspan="3" style="width: 786px;" %)Reset to factory default190 -|(% style="width:1 54px" %)**Command Example**|(% style="width:175px" %)**Function**|(% style="width:456px" %)**Response**191 -|(% style="width:1 54px" %)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" %)((( 192 192 Device reset to factory default parameters and show booting info 193 193 194 194 LSN50 Device/LoRa ST Module ... ... @@ -221,10 +221,10 @@ 221 221 222 222 (% style="color:blue" %)**AT Command: AT+VER** 223 223 224 -(% border="1" style="background-color:#ffffcc; color:green; width:5 42px" %)225 -|=(% colspan="3" style="width: 53 9px;" %)AT+VER: Image Version and Frequency Band226 -|(% style="width:1 57px" %)**Command Example**|(% style="width:295px" %)**Function**|(% style="width:86px" %)**Response**227 -|(% style="width:1 57px" %)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" %)((( 228 228 1.3 EU868 229 229 230 230 OK ... ... @@ -243,6 +243,7 @@ 243 243 ((( 244 244 245 245 250 + 246 246 **xx: Software Type:** 247 247 ))) 248 248 ... ... @@ -304,6 +304,7 @@ 304 304 305 305 = 5. Keys, IDs and EUIs management = 306 306 312 + 307 307 == 5.1 Application EUI == 308 308 309 309 ... ... @@ -431,8 +431,10 @@ 431 431 432 432 = 6. Joining and sending date on LoRaWAN network = 433 433 440 + 434 434 == 6.1 Confirm Mode == 435 435 443 + 436 436 === 6.1.1 AT+CFM command before DR-LWS007 software stack === 437 437 438 438 ... ... @@ -460,6 +460,7 @@ 460 460 * **Example 2:** Downlink Payload: 0500 ~/~/ Set AT+CFM=0 461 461 462 462 471 + 463 463 === 6.1.2 AT+CFM command since DR-LWS007 software stack === 464 464 465 465 ... ... @@ -506,6 +506,7 @@ 506 506 * **Example 2:** Downlink Payload: 05000700 ~/~/ Set AT+CFM=0,7,0 507 507 508 508 518 + 509 509 == 6.2 Confirm Status == 510 510 511 511 ... ... @@ -567,6 +567,7 @@ 567 567 * **Example 2:** Downlink Payload: **2001** ~/~/ Set AT+NJM=1 568 568 569 569 580 + 570 570 == 6.5 LoRa® Network Join Status == 571 571 572 572 ... ... @@ -643,11 +643,11 @@ 643 643 644 644 (% style="color:blue" %)**AT Command: AT+SENDB** 645 645 646 -(% border="1" style="background-color:#ffffcc; color:green; width:110 1px" %)647 -|=(% colspan="3" style="width: 1 098px;" %)AT+SENDB648 -|(% style="width:257px" %)**Command Example**|(% style="width: 394px" %)**Function**|(% style="width:446px" %)**Response**649 -|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width: 394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)OK650 -|(% 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((( 651 651 AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 652 652 653 653 ... ... @@ -656,6 +656,7 @@ 656 656 657 657 = 7. LoRaWAN network management = 658 658 670 + 659 659 == 7.1 Adaptive Data Rate == 660 660 661 661 ... ... @@ -683,6 +683,7 @@ 683 683 * **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 684 684 685 685 698 + 686 686 == 7.2 LoRa® Class == 687 687 688 688 ... ... @@ -689,7 +689,7 @@ 689 689 Feature: Get or Set the Device Class(Currently only support class A, class C). 690 690 691 691 692 -(% style="color:blue" %)**AT Command: 705 +(% style="color:blue" %)**AT Command:AT+CLASS** 693 693 694 694 (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %) 695 695 |=(% colspan="3" style="width: 504px;" %)AT+CLASS ... ... @@ -705,10 +705,10 @@ 705 705 == 7.3 Duty Cycle Setting == 706 706 707 707 708 -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. 709 709 710 710 711 -(% style="color:blue" %)**AT Command: 724 +(% style="color:blue" %)**AT Command:AT+DCS** 712 712 713 713 (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %) 714 714 |=(% colspan="3" style="width: 512px;" %)AT+DCS ... ... @@ -724,14 +724,9 @@ 724 724 == 7.4 Data Rate == 725 725 726 726 727 -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 728 728 729 -(% style="color:red" %) 730 -**Notice:** 731 731 732 -* 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. 733 -* 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/]] 734 - 735 735 (% style="color:blue" %)**AT Command: AT+DR** 736 736 737 737 (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %) ... ... @@ -752,6 +752,7 @@ 752 752 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 753 753 754 754 763 + 755 755 == 7.5 Frame Counter Downlink == 756 756 757 757 ... ... @@ -758,7 +758,7 @@ 758 758 Feature: Get or Set the Frame Counter Downlink. 759 759 760 760 761 -(% style="color:blue" %)**AT Command: 770 +(% style="color:blue" %)**AT Command:AT+FCD** 762 762 763 763 (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %) 764 764 |=(% colspan="3" style="width: 690px;" %)AT+FCD ... ... @@ -776,7 +776,7 @@ 776 776 Feature: Get or Set the Frame Counter Uplink. 777 777 778 778 779 -(% style="color:blue" %)**AT Command: 788 +(% style="color:blue" %)**AT Command:AT+FCU** 780 780 781 781 (% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %) 782 782 |=(% colspan="3" style="width: 531px;" %)AT+FCU ... ... @@ -795,7 +795,7 @@ 795 795 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms. 796 796 797 797 798 -(% style="color:blue" %)**AT Command: 807 +(% style="color:blue" %)**AT Command:AT+JN1DL** 799 799 800 800 (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %) 801 801 |=(% colspan="3" style="width: 534px;" %)AT+JN1DL ... ... @@ -810,11 +810,10 @@ 810 810 811 811 == 7.8 Join Accept Delay2 == 812 812 813 - 814 814 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms. 815 815 816 816 817 -(% style="color:blue" %)**AT Command: 825 +(% style="color:blue" %)**AT Command:AT+JN2DL** 818 818 819 819 (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %) 820 820 |=(% colspan="3" style="width: 535px;" %)AT+JN2DL ... ... @@ -832,10 +832,10 @@ 832 832 833 833 Feature: Get or Set the public network mode. (0: off, 1: on). A Public LoRaWAN network use 0x34 as syncword. Default Settings; PNM=1 834 834 835 -(% 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 836 836 837 837 838 -(% style="color:blue" %)**AT Command: 846 +(% style="color:blue" %)**AT Command:AT+PNM** 839 839 840 840 (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %) 841 841 |=(% colspan="3" style="width: 664px;" %)AT+PNM ... ... @@ -861,7 +861,7 @@ 861 861 Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms 862 862 863 863 864 -(% style="color:blue" %)**AT Command: 872 +(% style="color:blue" %)**AT Command:AT+RX1DL** 865 865 866 866 (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %) 867 867 |=(% colspan="3" style="width: 405px;" %)AT+RX1DL ... ... @@ -880,7 +880,7 @@ 880 880 Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms 881 881 882 882 883 -(% style="color:blue" %)**AT Command: 891 +(% style="color:blue" %)**AT Command:AT+RX2DL** 884 884 885 885 (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %) 886 886 |=(% 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: 910 +(% 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 ... ... @@ -918,7 +918,7 @@ 918 918 Feature: Get or Set the Rx2 window frequency 919 919 920 920 921 -(% style="color:blue" %)**AT Command: 929 +(% style="color:blue" %)**AT Command:AT+RX2FQ** 922 922 923 923 (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %) 924 924 |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ ... ... @@ -936,10 +936,10 @@ 936 936 937 937 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. ) 938 938 939 - (% 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 940 940 941 941 942 -(% style="color:blue" %)**AT Command: 950 +(% style="color:blue" %)**AT Command:AT+TXP** 943 943 944 944 (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %) 945 945 |=(% colspan="3" style="width: 462px;" %)AT+TXP ... ... @@ -959,6 +959,7 @@ 959 959 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+TXP=0. 960 960 961 961 970 + 962 962 == 7.15 RSSI of the Last Received Packet == 963 963 964 964 ... ... @@ -981,7 +981,7 @@ 981 981 Feature: Get the SNR of the last received packet 982 982 983 983 984 -(% style="color:blue" %)**AT Command: 993 +(% style="color:blue" %)**AT Command:AT+SNR** 985 985 986 986 (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %) 987 987 |=(% colspan="3" style="width: 568px;" %)AT+SNR ... ... @@ -1036,7 +1036,6 @@ 1036 1036 1037 1037 == 7.19 Eight Channel Mode == 1038 1038 1039 - 1040 1040 Feature: Get or Set eight channels mode,Only for US915,AU915,CN470. 1041 1041 1042 1042 ... ... @@ -1052,7 +1052,7 @@ 1052 1052 ))) 1053 1053 |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK 1054 1054 1055 -(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**1063 +(% style="color:blue" %)**Downlink Command: 0x24** 1056 1056 1057 1057 Format: Command Code (0x24) followed by 1 bytes channel value. 1058 1058 ... ... @@ -1062,6 +1062,7 @@ 1062 1062 * **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1063 1063 1064 1064 1073 + 1065 1065 == 7.20 Get or Set RXwindows1 timeout == 1066 1066 1067 1067 ... ... @@ -1081,9 +1081,8 @@ 1081 1081 ((( 1082 1082 1083 1083 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. 1084 1084 1085 -(% 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. 1086 - 1087 1087 1088 1088 ))) 1089 1089 ... ... @@ -1139,6 +1139,7 @@ 1139 1139 * **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1140 1140 1141 1141 1150 + 1142 1142 == 7.23 Set Packet Receiving Response Level == 1143 1143 1144 1144 ... ... @@ -1179,6 +1179,7 @@ 1179 1179 * **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1180 1180 1181 1181 1191 + 1182 1182 == 7.24 Controls NBTrans in unconfirmed uplink mode(LWS007 NBTrans:Set retransmission packets) == 1183 1183 1184 1184 ... ... @@ -1281,13 +1281,13 @@ 1281 1281 (% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %) 1282 1282 |=(% colspan="3" style="width: 724px;" %)AT+RJTDC 1283 1283 |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response** 1284 -|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30((( 1294 +|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30000((( 1285 1285 OK 1286 1286 1287 -the interval is 30 in1297 +the interval is 30000ms = 30s 1288 1288 ))) 1289 -|(% style="width:165px" %)AT+RJTDC=60|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK((( 1290 -Set the ReJoin data transmission interval to 60 in1299 +|(% style="width:165px" %)AT+RJTDC=60000|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK((( 1300 +Set the ReJoin data transmission interval to 60000ms = 60 seconds 1291 1291 ))) 1292 1292 1293 1293 (% style="color:blue" %)**Downlink Command: 0x26** ... ... @@ -1302,11 +1302,12 @@ 1302 1302 1303 1303 = 8. AT Commands Combination = 1304 1304 1315 + 1305 1305 == 8.1 Set a fix RX2DR for downlink window == 1306 1306 1307 1307 1308 -* (% style="color:blue" %)**AT+ADR=0 **(%%)**~-~->** Disable ADR first1309 -* (% style="color:blue" %)**AT+RX2DR=xxxx**(%%)**~-~->** Set xxxx to your wanted DataRate1319 +* **AT+ADR=0 ** **~-~->** Disable ADR first 1320 +* **AT+RX2DR=xxxx** **~-~->** Set xxxx to your wanted DataRate 1310 1310 1311 1311 1312 1312 == 8.2 Use Downlink Command to set a fix uplink DR == ... ... @@ -1319,5 +1319,3 @@ 1319 1319 * AT+ADR=0 [[Reference>>||anchor="H7.1AdaptiveDataRate"]] 1320 1320 * AT+DR=5 [[Reference>>||anchor="H7.4DataRate"]] 1321 1321 * AT+TXP=0 [[Reference>>||anchor="H7.14TransmitPower"]] 1322 - 1323 -