Changes for page End Device AT Commands and Downlink Command
Last modified by kai on 2024/09/06 10:00
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -14,9 +14,10 @@ 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 + 17 17 ))) 18 18 19 - 20 20 = 2. How to use AT Commands or Downlink command = 21 21 22 22 ... ... @@ -26,8 +26,8 @@ 26 26 ** 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]]? 27 27 ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server) 28 28 29 -(% style="display:none" %) (%%) 30 30 31 + 31 31 = 3. Support End Node and firmware version = 32 32 33 33 ... ... @@ -102,8 +102,8 @@ 102 102 ))) 103 103 ))) 104 104 105 -(% style="display:none" %) (%%) 106 106 107 + 107 107 = 4. System Management Commands = 108 108 109 109 == 4.1 Change Uplink Interval == ... ... @@ -141,8 +141,8 @@ 141 141 * **Example 1**: Downlink Payload:** 0100001E** ~/~/ Set Transmit Interval (TDC) = 30 seconds 142 142 * **Example 2**: Downlink Payload:** 0100003C** ~/~/ Set Transmit Interval (TDC) = 60 seconds 143 143 144 -(% style="display:none" %) (%%) 145 145 146 + 146 146 == 4.2 Reboot End Node == 147 147 148 148 ... ... @@ -175,10 +175,11 @@ 175 175 ))) 176 176 177 177 ((( 178 -If the downlink payload=**04FF**, the end node will reboot. 179 +If the downlink payload=**04FF**, the end node will reboot. 180 + 181 + 179 179 ))) 180 180 181 - 182 182 == 4.3 Reset to factory Default == 183 183 184 184 ... ... @@ -303,6 +303,8 @@ 303 303 OK 304 304 ))) 305 305 308 + 309 + 306 306 = 5. Keys, IDs and EUIs management = 307 307 308 308 == 5.1 Application EUI == ... ... @@ -321,8 +321,8 @@ 321 321 ))) 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 -(% style="display:none" %) (%%) 325 325 329 + 326 326 == 5.2 Application Key == 327 327 328 328 ... ... @@ -339,8 +339,8 @@ 339 339 ))) 340 340 |(% 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 341 341 342 -(% style="display:none" %) (%%) 343 343 347 + 344 344 == 5.3 Application Session Key == 345 345 346 346 ... ... @@ -359,8 +359,8 @@ 359 359 OK 360 360 ))) 361 361 362 -(% style="display:none" %) (%%) 363 363 367 + 364 364 == 5.4 Device Address == 365 365 366 366 ... ... @@ -379,8 +379,8 @@ 379 379 ))) 380 380 |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK 381 381 382 -(% style="display:none" %) (%%) 383 383 387 + 384 384 == 5.5 Device EUI == 385 385 386 386 ... ... @@ -399,8 +399,8 @@ 399 399 OK 400 400 ))) 401 401 402 -(% style="display:none" %) (%%) 403 403 407 + 404 404 == 5.6 Network ID == 405 405 406 406 ... ... @@ -417,8 +417,8 @@ 417 417 ))) 418 418 |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK 419 419 420 -(% style="display:none" %) (%%) 421 421 425 + 422 422 == 5.7 Network Session Key == 423 423 424 424 ... ... @@ -435,8 +435,8 @@ 435 435 ))) 436 436 |(% 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 437 437 438 -(% style="display:none" %) (%%) 439 439 443 + 440 440 = 6. Joining and sending date on LoRaWAN network = 441 441 442 442 == 6.1 Confirm Mode == ... ... @@ -467,8 +467,8 @@ 467 467 * **Example 1:** Downlink Payload: 0501 ~/~/ Set AT+CFM=1 468 468 * **Example 2:** Downlink Payload: 0500 ~/~/ Set AT+CFM=0 469 469 470 -(% style="display:none" %) (%%) 471 471 475 + 472 472 === 6.1.2 AT+CFM command since DR-LWS007 software stack === 473 473 474 474 ... ... @@ -514,8 +514,8 @@ 514 514 * **Example 1:** Downlink Payload: 05010101 ~/~/ Set AT+CFM=1,1,1 515 515 * **Example 2:** Downlink Payload: 05000700 ~/~/ Set AT+CFM=0,7,0 516 516 517 -(% style="display:none" %) (%%) 518 518 522 + 519 519 == 6.2 Confirm Status == 520 520 521 521 ... ... @@ -531,6 +531,8 @@ 531 531 OK 532 532 ))) 533 533 538 + 539 + 534 534 == 6.3 Join LoRa® Network == 535 535 536 536 ... ... @@ -548,6 +548,8 @@ 548 548 While Error in format, return AT_BUSY_ERROR 549 549 ))) 550 550 557 + 558 + 551 551 == 6.4 LoRa® Network Join Mode == 552 552 553 553 ... ... @@ -574,8 +574,8 @@ 574 574 * **Example 1: **Downlink Payload: **2000 ** ~/~/ Set AT+NJM=0 575 575 * **Example 2:** Downlink Payload: **2001** ~/~/ Set AT+NJM=1 576 576 577 -(% style="display:none" %) (%%) 578 578 586 + 579 579 == 6.5 LoRa® Network Join Status == 580 580 581 581 ... ... @@ -591,8 +591,8 @@ 591 591 OK 592 592 ))) 593 593 594 -(% style="display:none" %) (%%) 595 595 603 + 596 596 == 6.6 Print Last Received Data in Raw Format == 597 597 598 598 ... ... @@ -608,8 +608,8 @@ 608 608 OK 609 609 ))) 610 610 611 -(% style="display:none" %) (%%) 612 612 620 + 613 613 == 6.7 Print Last Received Data in Binary Format == 614 614 615 615 ... ... @@ -625,8 +625,8 @@ 625 625 OK 626 626 ))) 627 627 628 -(% style="display:none" %) (%%) 629 629 637 + 630 630 == 6.8 Send Text Data == 631 631 632 632 ... ... @@ -640,11 +640,14 @@ 640 640 |(% style="width:201px" %)**Command Example**|(% style="width:340px" %)**Function**|(% style="width:446px" %)**Response** 641 641 |(% style="width:201px" %)AT+SEND=12:hello world|(% style="width:340px" %)Send text data along with the application port.|(% style="width:446px" %)OK((( 642 642 While Error in format, return 651 + 643 643 AT_BUSY_ERROR/AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 653 + 654 + 644 644 ))) 645 645 646 -(% style="display:none" %) (%%) 647 647 658 + 648 648 == 6.9 Send Hexadecimal Data == 649 649 650 650 ... ... @@ -658,11 +658,13 @@ 658 658 |(% style="width:257px" %)**Command Example**|(% style="width:394px" %)**Function**|(% style="width:446px" %)**Response** 659 659 |(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)OK 660 660 |(% 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((( 661 -AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 672 +AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 673 + 674 + 662 662 ))) 663 663 664 -(% style="display:none" %) (%%) 665 665 678 + 666 666 = 7. LoRaWAN network management = 667 667 668 668 == 7.1 Adaptive Data Rate == ... ... @@ -691,8 +691,8 @@ 691 691 * **Example 1**: Downlink Payload: **2201** ~/~/ Set AT+ADR=1. 692 692 * **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 693 693 694 -(% style="display:none" %) (%%) 695 695 708 + 696 696 == 7.2 LoRa® Class == 697 697 698 698 ... ... @@ -708,10 +708,11 @@ 708 708 OK 709 709 ))) 710 710 |(% style="width:163px" %)AT+CLASS=C|(% style="width:166px" %)Set the Device Class.|(% style="width:175px" %)OK((( 724 + 711 711 ))) 712 712 713 -(% style="display:none" %) (%%) 714 714 728 + 715 715 == 7.3 Duty Cycle Setting == 716 716 717 717 ... ... @@ -727,10 +727,11 @@ 727 727 OK 728 728 ))) 729 729 |(% style="width:165px" %)AT+DCS=1|(% style="width:239px" %)Set the ETSI Duty Cycle setting.|(% style="width:107px" %)OK((( 744 + 730 730 ))) 731 731 732 -(% style="display:none" %) (%%) 733 733 748 + 734 734 == 7.4 Data Rate == 735 735 736 736 ... ... @@ -761,8 +761,8 @@ 761 761 * **Example 1**: Downlink Payload: **220001FF** ~/~/ Set AT+DR=1. 762 762 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 763 763 764 -(% style="display:none" %) (%%) 765 765 780 + 766 766 == 7.5 Frame Counter Downlink == 767 767 768 768 ... ... @@ -781,6 +781,8 @@ 781 781 OK 782 782 ))) 783 783 799 + 800 + 784 784 == 7.6 Frame Counter Uplink == 785 785 786 786 Feature: Get or Set the Frame Counter Uplink. ... ... @@ -798,6 +798,8 @@ 798 798 799 799 ))) 800 800 818 + 819 + 801 801 == 7.7 Join Accept Delay1 == 802 802 803 803 ... ... @@ -816,6 +816,8 @@ 816 816 817 817 ))) 818 818 838 + 839 + 819 819 == 7.8 Join Accept Delay2 == 820 820 821 821 ... ... @@ -834,6 +834,8 @@ 834 834 835 835 ))) 836 836 858 + 859 + 837 837 == 7.9 Public Network Mode == 838 838 839 839 ... ... @@ -861,6 +861,8 @@ 861 861 ))) 862 862 |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %) 863 863 887 + 888 + 864 864 == 7.10 Receive Delay1 == 865 865 866 866 ... ... @@ -879,6 +879,8 @@ 879 879 880 880 ))) 881 881 907 + 908 + 882 882 == 7.11 Receive Delay2 == 883 883 884 884 ... ... @@ -897,6 +897,8 @@ 897 897 898 898 ))) 899 899 927 + 928 + 900 900 == 7.12 Rx2 Window Data Rate == 901 901 902 902 ... ... @@ -915,6 +915,8 @@ 915 915 916 916 ))) 917 917 947 + 948 + 918 918 == 7.13 Rx2 Window Frequency == 919 919 920 920 ... ... @@ -933,6 +933,8 @@ 933 933 934 934 ))) 935 935 967 + 968 + 936 936 == 7.14 Transmit Power == 937 937 938 938 ... ... @@ -960,6 +960,8 @@ 960 960 * **Example 1**: Downlink Payload: **22000102** ~/~/ Set AT+TXP=2. 961 961 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+TXP=0. 962 962 996 + 997 + 963 963 == 7.15 RSSI of the Last Received Packet == 964 964 965 965 ... ... @@ -975,6 +975,8 @@ 975 975 OK 976 976 ))) 977 977 1013 + 1014 + 978 978 == 7.16 SNR of the Last Received Packet == 979 979 980 980 ... ... @@ -990,6 +990,8 @@ 990 990 OK 991 991 ))) 992 992 1030 + 1031 + 993 993 == 7.17 Application Port == 994 994 995 995 ... ... @@ -1015,6 +1015,8 @@ 1015 1015 * **Example 1**: Downlink Payload: **2301** ~/~/ set the application port to 1 1016 1016 * **Example 2**: Downlink Payload:** 2305** ~/~/ set the application port to 5 1017 1017 1057 + 1058 + 1018 1018 == 7.18 Single Channel Mode == 1019 1019 1020 1020 ... ... @@ -1031,6 +1031,8 @@ 1031 1031 ))) 1032 1032 |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK 1033 1033 1075 + 1076 + 1034 1034 == 7.19 Eight Channel Mode == 1035 1035 1036 1036 ... ... @@ -1058,6 +1058,8 @@ 1058 1058 * **Example 1**: Downlink Payload: 2401 ~/~/ set channel mode to 1 1059 1059 * **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1060 1060 1104 + 1105 + 1061 1061 == 7.20 Get or Set RXwindows1 timeout == 1062 1062 1063 1063 ... ... @@ -1108,6 +1108,8 @@ 1108 1108 ))) 1109 1109 |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK 1110 1110 1156 + 1157 + 1111 1111 == 7.22 Setting up uplinkdwelltime (as923, au915) == 1112 1112 1113 1113 ... ... @@ -1133,6 +1133,8 @@ 1133 1133 * **Example 1**: Downlink Payload: **2501** ~/~/ set uplinkdwelltime to 1 1134 1134 * **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1135 1135 1183 + 1184 + 1136 1136 == 7.23 Set Packet Receiving Response Level == 1137 1137 1138 1138 ... ... @@ -1172,6 +1172,8 @@ 1172 1172 * **Example 1**: Downlink Payload: **2101** ~/~/ set packet receiving response level to 1 1173 1173 * **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1174 1174 1224 + 1225 + 1175 1175 == 7.24 Controls NBTrans in unconfirmed uplink mode(LWS007 NBTrans:Set retransmission packets) == 1176 1176 1177 1177 ... ... @@ -1202,16 +1202,13 @@ 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 1256 + 1257 + 1205 1205 == 7.25 Device offline rejoining (LWS007) == 1206 1206 1207 1207 1208 1208 (% style="color:blue" %)**AT Command: AT+DDETECT** 1209 1209 1210 -AT+DDETECT=<Flag>,<ACK_Timout_1>,<ACK_Timout_2> (Default Value: AT+DDETECT=1,1440,2880) 1211 - 1212 -* ACK_Timout_1: Unit: min 1213 -* ACK_Timout_2: Unit: min 1214 - 1215 1215 (% border="1" style="background-color:#ffffcc; color:green; width:710.222px" %) 1216 1216 |=(% colspan="3" style="width: 707px;" %)AT+**DDETECT** 1217 1217 |(% style="width:160px" %)**Command Example**|(% style="width:198px" %)**Function**|(% style="width:349px" %)**Response** ... ... @@ -1243,18 +1243,16 @@ 1243 1243 OK 1244 1244 ))) 1245 1245 1246 -(% style="color:blue" %)**Downlink Command: 0x3 2**1294 +(% style="color:blue" %)**Downlink Command: 0x33** 1247 1247 1248 1248 Format: Command Code (0x32) followed by 2 bytes mode value. 1249 1249 1250 -If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 3 2.1298 +If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 33. 1251 1251 1252 -* **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1253 -** 0x01 : Flag 1254 -** 0x05A0: ACK_Timout_1 : 1440minutes (24 hours) 1255 -** 0x0B40: ACK_Timout_2 : 2880minutes (48 hours) 1256 -** **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. 1300 +* **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1257 1257 1302 + 1303 + 1258 1258 == 7.26 Request the server to send an ACK == 1259 1259 1260 1260 ... ... @@ -1272,6 +1272,8 @@ 1272 1272 OK 1273 1273 ))) 1274 1274 1321 + 1322 + 1275 1275 == 7.27 Adjust network rejoining interval == 1276 1276 1277 1277 ... ... @@ -1298,6 +1298,8 @@ 1298 1298 * **Example 1:** Downlink Payload: 26000A ~/~/ Set AT+RJTDC=10 1299 1299 * **Example 2: **Downlink Payload: 260002 ~/~/ Set AT+RJTDC=2 1300 1300 1349 + 1350 + 1301 1301 = 8. AT Commands Combination = 1302 1302 1303 1303 == 8.1 Set a fix RX2DR for downlink window == ... ... @@ -1306,6 +1306,8 @@ 1306 1306 * (% style="color:blue" %)**AT+ADR=0 **(%%) **~-~->** Disable ADR first 1307 1307 * (% style="color:blue" %)**AT+RX2DR=xxxx** (%%) **~-~->** Set xxxx to your wanted DataRate 1308 1308 1359 + 1360 + 1309 1309 == 8.2 Use Downlink Command to set a fix uplink DR == 1310 1310 1311 1311