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. Edwin1 +XWiki.Xiaoling - Content
-
... ... @@ -14,6 +14,7 @@ 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 17 18 18 19 19 ))) ... ... @@ -21,13 +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: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: 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]]?28 +** 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 30 30 32 + 31 31 = 3. Support End Node and firmware version = 32 32 33 33 ... ... @@ -103,8 +103,10 @@ 103 103 ))) 104 104 105 105 108 + 106 106 = 4. System Management Commands = 107 107 111 + 108 108 == 4.1 Change Uplink Interval == 109 109 110 110 ... ... @@ -141,6 +141,7 @@ 141 141 * **Example 2**: Downlink Payload:** 0100003C** ~/~/ Set Transmit Interval (TDC) = 60 seconds 142 142 143 143 148 + 144 144 == 4.2 Reboot End Node == 145 145 146 146 ... ... @@ -175,6 +175,7 @@ 175 175 ((( 176 176 If the downlink payload=**04FF**, the end node will reboot. 177 177 183 + 178 178 179 179 ))) 180 180 ... ... @@ -214,6 +214,7 @@ 214 214 ))) 215 215 216 216 223 + 217 217 == 4.4 Show Firmware Version == 218 218 219 219 ... ... @@ -244,6 +244,7 @@ 244 244 ((( 245 245 246 246 254 + 247 247 **xx: Software Type:** 248 248 ))) 249 249 ... ... @@ -277,6 +277,7 @@ 277 277 firmware version: v1.1.0 ~-~-> 110 278 278 279 279 288 + 280 280 == 4.5 Show System Configure == 281 281 282 282 ... ... @@ -303,8 +303,10 @@ 303 303 ))) 304 304 305 305 315 + 306 306 = 5. Keys, IDs and EUIs management = 307 307 318 + 308 308 == 5.1 Application EUI == 309 309 310 310 ... ... @@ -322,6 +322,7 @@ 322 322 |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK 323 323 324 324 336 + 325 325 == 5.2 Application Key == 326 326 327 327 ... ... @@ -339,6 +339,7 @@ 339 339 |(% 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 340 340 341 341 354 + 342 342 == 5.3 Application Session Key == 343 343 344 344 ... ... @@ -358,6 +358,7 @@ 358 358 ))) 359 359 360 360 374 + 361 361 == 5.4 Device Address == 362 362 363 363 ... ... @@ -377,6 +377,7 @@ 377 377 |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK 378 378 379 379 394 + 380 380 == 5.5 Device EUI == 381 381 382 382 ... ... @@ -396,6 +396,7 @@ 396 396 ))) 397 397 398 398 414 + 399 399 == 5.6 Network ID == 400 400 401 401 ... ... @@ -413,6 +413,7 @@ 413 413 |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK 414 414 415 415 432 + 416 416 == 5.7 Network Session Key == 417 417 418 418 ... ... @@ -430,10 +430,13 @@ 430 430 |(% 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 431 431 432 432 450 + 433 433 = 6. Joining and sending date on LoRaWAN network = 434 434 453 + 435 435 == 6.1 Confirm Mode == 436 436 456 + 437 437 === 6.1.1 AT+CFM command before DR-LWS007 software stack === 438 438 439 439 ... ... @@ -461,6 +461,7 @@ 461 461 * **Example 2:** Downlink Payload: 0500 ~/~/ Set AT+CFM=0 462 462 463 463 484 + 464 464 === 6.1.2 AT+CFM command since DR-LWS007 software stack === 465 465 466 466 ... ... @@ -507,6 +507,7 @@ 507 507 * **Example 2:** Downlink Payload: 05000700 ~/~/ Set AT+CFM=0,7,0 508 508 509 509 531 + 510 510 == 6.2 Confirm Status == 511 511 512 512 ... ... @@ -515,14 +515,15 @@ 515 515 516 516 (% style="color:blue" %)**AT Command: AT+CFS** 517 517 518 -(% border="1" style="background-color:#ffffcc; color:green; width: 463px" %)519 -|=(% colspan="3" style="width: 460px;" %)AT+CFS520 -|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:1 07px" %)**Response**521 -|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:1 07px" %)0(((540 +(% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %) 541 +|=(% colspan="3" style="width: 531px;" %)AT+CFS 542 +|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:178px" %)**Response** 543 +|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:178px" %)0((( 522 522 OK 523 523 ))) 524 524 525 525 548 + 526 526 == 6.3 Join LoRa® Network == 527 527 528 528 ... ... @@ -541,6 +541,7 @@ 541 541 ))) 542 542 543 543 567 + 544 544 == 6.4 LoRa® Network Join Mode == 545 545 546 546 ... ... @@ -568,6 +568,7 @@ 568 568 * **Example 2:** Downlink Payload: **2001** ~/~/ Set AT+NJM=1 569 569 570 570 595 + 571 571 == 6.5 LoRa® Network Join Status == 572 572 573 573 ... ... @@ -584,6 +584,7 @@ 584 584 ))) 585 585 586 586 612 + 587 587 == 6.6 Print Last Received Data in Raw Format == 588 588 589 589 ... ... @@ -600,6 +600,7 @@ 600 600 ))) 601 601 602 602 629 + 603 603 == 6.7 Print Last Received Data in Binary Format == 604 604 605 605 ... ... @@ -616,6 +616,7 @@ 616 616 ))) 617 617 618 618 646 + 619 619 == 6.8 Send Text Data == 620 620 621 621 ... ... @@ -636,6 +636,7 @@ 636 636 ))) 637 637 638 638 667 + 639 639 == 6.9 Send Hexadecimal Data == 640 640 641 641 ... ... @@ -655,8 +655,10 @@ 655 655 ))) 656 656 657 657 687 + 658 658 = 7. LoRaWAN network management = 659 659 690 + 660 660 == 7.1 Adaptive Data Rate == 661 661 662 662 ... ... @@ -684,6 +684,7 @@ 684 684 * **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 685 685 686 686 718 + 687 687 == 7.2 LoRa® Class == 688 688 689 689 ... ... @@ -703,6 +703,7 @@ 703 703 ))) 704 704 705 705 738 + 706 706 == 7.3 Duty Cycle Setting == 707 707 708 708 ... ... @@ -722,17 +722,13 @@ 722 722 ))) 723 723 724 724 758 + 725 725 == 7.4 Data Rate == 726 726 727 727 728 -Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) . 762 +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 729 729 730 -(% style="color:red" %) 731 -**Notice:** 732 732 733 -* 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. 734 -* 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/]] 735 - 736 736 (% style="color:blue" %)**AT Command: AT+DR** 737 737 738 738 (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %) ... ... @@ -753,6 +753,7 @@ 753 753 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 754 754 755 755 785 + 756 756 == 7.5 Frame Counter Downlink == 757 757 758 758 ... ... @@ -772,6 +772,7 @@ 772 772 ))) 773 773 774 774 805 + 775 775 == 7.6 Frame Counter Uplink == 776 776 777 777 Feature: Get or Set the Frame Counter Uplink. ... ... @@ -790,6 +790,7 @@ 790 790 ))) 791 791 792 792 824 + 793 793 == 7.7 Join Accept Delay1 == 794 794 795 795 ... ... @@ -809,6 +809,7 @@ 809 809 ))) 810 810 811 811 844 + 812 812 == 7.8 Join Accept Delay2 == 813 813 814 814 ... ... @@ -828,6 +828,7 @@ 828 828 ))) 829 829 830 830 864 + 831 831 == 7.9 Public Network Mode == 832 832 833 833 ... ... @@ -856,6 +856,7 @@ 856 856 |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %) 857 857 858 858 893 + 859 859 == 7.10 Receive Delay1 == 860 860 861 861 ... ... @@ -875,6 +875,7 @@ 875 875 ))) 876 876 877 877 913 + 878 878 == 7.11 Receive Delay2 == 879 879 880 880 ... ... @@ -894,6 +894,7 @@ 894 894 ))) 895 895 896 896 933 + 897 897 == 7.12 Rx2 Window Data Rate == 898 898 899 899 ... ... @@ -913,6 +913,7 @@ 913 913 ))) 914 914 915 915 953 + 916 916 == 7.13 Rx2 Window Frequency == 917 917 918 918 ... ... @@ -932,6 +932,7 @@ 932 932 ))) 933 933 934 934 973 + 935 935 == 7.14 Transmit Power == 936 936 937 937 ... ... @@ -960,6 +960,7 @@ 960 960 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+TXP=0. 961 961 962 962 1002 + 963 963 == 7.15 RSSI of the Last Received Packet == 964 964 965 965 ... ... @@ -976,6 +976,7 @@ 976 976 ))) 977 977 978 978 1019 + 979 979 == 7.16 SNR of the Last Received Packet == 980 980 981 981 ... ... @@ -992,6 +992,7 @@ 992 992 ))) 993 993 994 994 1036 + 995 995 == 7.17 Application Port == 996 996 997 997 ... ... @@ -1018,6 +1018,7 @@ 1018 1018 * **Example 2**: Downlink Payload:** 2305** ~/~/ set the application port to 5 1019 1019 1020 1020 1063 + 1021 1021 == 7.18 Single Channel Mode == 1022 1022 1023 1023 ... ... @@ -1035,6 +1035,7 @@ 1035 1035 |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK 1036 1036 1037 1037 1081 + 1038 1038 == 7.19 Eight Channel Mode == 1039 1039 1040 1040 ... ... @@ -1053,7 +1053,7 @@ 1053 1053 ))) 1054 1054 |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK 1055 1055 1056 -(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**1100 +(% style="color:blue" %)**Downlink Command: 0x24** 1057 1057 1058 1058 Format: Command Code (0x24) followed by 1 bytes channel value. 1059 1059 ... ... @@ -1063,6 +1063,7 @@ 1063 1063 * **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1064 1064 1065 1065 1110 + 1066 1066 == 7.20 Get or Set RXwindows1 timeout == 1067 1067 1068 1068 ... ... @@ -1094,6 +1094,7 @@ 1094 1094 ((( 1095 1095 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. 1096 1096 1142 + 1097 1097 1098 1098 ))) 1099 1099 ... ... @@ -1114,6 +1114,7 @@ 1114 1114 |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK 1115 1115 1116 1116 1163 + 1117 1117 == 7.22 Setting up uplinkdwelltime (as923, au915) == 1118 1118 1119 1119 ... ... @@ -1140,6 +1140,7 @@ 1140 1140 * **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1141 1141 1142 1142 1190 + 1143 1143 == 7.23 Set Packet Receiving Response Level == 1144 1144 1145 1145 ... ... @@ -1160,6 +1160,7 @@ 1160 1160 * For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command. 1161 1161 * For Class C devices used in TTI, need to set AT+RPL=4 because TTI require immediately reply message to Confirmed Data Down & MAC Command. 1162 1162 1211 + 1163 1163 (% style="color:blue" %)**AT Command: AT+RPL** 1164 1164 1165 1165 (% border="1" style="background-color:#ffffcc; color:green; width:536.222px" %) ... ... @@ -1180,6 +1180,7 @@ 1180 1180 * **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1181 1181 1182 1182 1232 + 1183 1183 == 7.24 Controls NBTrans in unconfirmed uplink mode(LWS007 NBTrans:Set retransmission packets) == 1184 1184 1185 1185 ... ... @@ -1211,16 +1211,12 @@ 1211 1211 * Example 2: Downlink Payload: 330201 ~/~/ Set AT+SETMAXNBTRANS=2,1 1212 1212 1213 1213 1264 + 1214 1214 == 7.25 Device offline rejoining (LWS007) == 1215 1215 1216 1216 1217 1217 (% style="color:blue" %)**AT Command: AT+DDETECT** 1218 1218 1219 -AT+DDETECT=<Flag>,<ACK_Timout_1>,<ACK_Timout_2> (Default Value: AT+DDETECT=1,1440,2880) 1220 - 1221 -* ACK_Timout_1: Unit: min 1222 -* ACK_Timout_2: Unit: min 1223 - 1224 1224 (% border="1" style="background-color:#ffffcc; color:green; width:710.222px" %) 1225 1225 |=(% colspan="3" style="width: 707px;" %)AT+**DDETECT** 1226 1226 |(% style="width:160px" %)**Command Example**|(% style="width:198px" %)**Function**|(% style="width:349px" %)**Response** ... ... @@ -1252,19 +1252,16 @@ 1252 1252 OK 1253 1253 ))) 1254 1254 1255 -(% style="color:blue" %)**Downlink Command: 0x3 2**1301 +(% style="color:blue" %)**Downlink Command: 0x33** 1256 1256 1257 1257 Format: Command Code (0x32) followed by 2 bytes mode value. 1258 1258 1259 -If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 3 2.1305 +If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 33. 1260 1260 1261 -* **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1262 -** 0x01 : Flag 1263 -** 0x05A0: ACK_Timout_1 : 1440minutes (24 hours) 1264 -** 0x0B40: ACK_Timout_2 : 2880minutes (48 hours) 1265 -** **Explain**: Enable Online Detect, if end node doesn't receive any downlink within ACK_Timout_1( 1440 minutes or 24 hours). End node will use confirmed uplink to send packets during ACK_Timout_1 (the 24th hour) to ACK_Timout_2 ( the 48th hour). If from the 24th to 48th hour, end node got an downlink from server, it will switch back to unconfirmed uplink. end node will restart ACK_Timout_1. If from the 24th to 48th hour, end node still not got any downlink, means device doesn't get ACK from server within last 48 hours. Device will process rejoin, rejoin request interval is AT+RJTDC period. For AU915/ US915, device will use the sub-band used for last join. 1307 +* **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1266 1266 1267 1267 1310 + 1268 1268 == 7.26 Request the server to send an ACK == 1269 1269 1270 1270 ... ... @@ -1283,6 +1283,8 @@ 1283 1283 ))) 1284 1284 1285 1285 1329 + 1330 + 1286 1286 == 7.27 Adjust network rejoining interval == 1287 1287 1288 1288 ... ... @@ -1291,13 +1291,13 @@ 1291 1291 (% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %) 1292 1292 |=(% colspan="3" style="width: 724px;" %)AT+RJTDC 1293 1293 |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response** 1294 -|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30((( 1339 +|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30000((( 1295 1295 OK 1296 1296 1297 -the interval is 30 in1342 +the interval is 30000ms = 30s 1298 1298 ))) 1299 -|(% style="width:165px" %)AT+RJTDC=60|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK((( 1300 -Set the ReJoin data transmission interval to 60 in1344 +|(% style="width:165px" %)AT+RJTDC=60000|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK((( 1345 +Set the ReJoin data transmission interval to 60000ms = 60 seconds 1301 1301 ))) 1302 1302 1303 1303 (% style="color:blue" %)**Downlink Command: 0x26** ... ... @@ -1310,8 +1310,10 @@ 1310 1310 * **Example 2: **Downlink Payload: 260002 ~/~/ Set AT+RJTDC=2 1311 1311 1312 1312 1358 + 1313 1313 = 8. AT Commands Combination = 1314 1314 1361 + 1315 1315 == 8.1 Set a fix RX2DR for downlink window == 1316 1316 1317 1317 ... ... @@ -1319,6 +1319,7 @@ 1319 1319 * (% style="color:blue" %)**AT+RX2DR=xxxx** (%%) **~-~->** Set xxxx to your wanted DataRate 1320 1320 1321 1321 1369 + 1322 1322 == 8.2 Use Downlink Command to set a fix uplink DR == 1323 1323 1324 1324