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
-
... ... @@ -9,26 +9,25 @@ 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.** 17 - 18 18 ))) 19 19 19 + 20 20 = 2. How to use AT Commands or Downlink command = 21 21 22 22 23 -* 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/]]24 -* 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:23 +* **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/]] 24 +* **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: 25 25 ** Use HEX format to send a downlink: [[TTN v3>>Notes for TTN]] 26 -** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]] 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" %) (%%) 29 29 30 - 31 - 32 32 = 3. Support End Node and firmware version = 33 33 34 34 ... ... @@ -103,12 +103,10 @@ 103 103 ))) 104 104 ))) 105 105 105 +(% style="display:none" %) (%%) 106 106 107 - 108 - 109 109 = 4. System Management Commands = 110 110 111 - 112 112 == 4.1 Change Uplink Interval == 113 113 114 114 ... ... @@ -138,15 +138,14 @@ 138 138 ))) 139 139 140 140 ((( 141 -If the downlink payload=0100003C, it means set the END Node ’s Transmit Interval to 0x00003C=60(S), while type code is 01.138 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01. 142 142 ))) 143 143 144 -* **Example 1**: Downlink Payload:** 0100001E** ~/~/ Set Transmit Interval (TDC) = 30 seconds 145 -* **Example 2**: Downlink Payload:** 0100003C** ~/~/ Set Transmit Interval (TDC) = 60 seconds 141 +* **Example 1**: Downlink Payload:** 0100001E** ~/~/ Set Transmit Interval (TDC) = 30 seconds 142 +* **Example 2**: Downlink Payload:** 0100003C** ~/~/ Set Transmit Interval (TDC) = 60 seconds 146 146 144 +(% style="display:none" %) (%%) 147 147 148 - 149 - 150 150 == 4.2 Reboot End Node == 151 151 152 152 ... ... @@ -155,10 +155,10 @@ 155 155 156 156 (% style="color:blue" %)**AT Command: ATZ** 157 157 158 -(% border="1" style="background-color:#ffffcc; color:green; width: 727.222px" %)159 -|=(% colspan="3" %)ATZ: Trig a reset of the MCU 160 -|**Command Example**|**Function**|**Response** 161 -|ATZ|Reset MCU|((( 154 +(% border="1" style="background-color:#ffffcc; color:green; width:546px" %) 155 +|=(% colspan="3" style="width: 543px;" %)ATZ: Trig a reset of the MCU 156 +|(% style="width:157px" %)**Command Example**|(% style="width:92px" %)**Function**|(% style="width:294px" %)**Response** 157 +|(% style="width:157px" %)ATZ|(% style="width:92px" %)Reset MCU|(% style="width:294px" %)((( 162 162 Device reset and show booting info 163 163 164 164 LSN50 Device/LoRa ST Module ... ... @@ -179,11 +179,10 @@ 179 179 ))) 180 180 181 181 ((( 182 -If the downlink payload=**04FF**, the end node will reboot. 183 - 184 - 178 +If the downlink payload=**04FF**, the end node will reboot. 185 185 ))) 186 186 181 + 187 187 == 4.3 Reset to factory Default == 188 188 189 189 ... ... @@ -192,10 +192,10 @@ 192 192 193 193 (% style="color:blue" %)**AT Command: AT+FDR** 194 194 195 -(% border="1" style="background-color:#ffffcc; color:green; width:8 31.222px" %)196 -|=(% colspan="3" style="width: 8 28px;" %)Reset to factory default197 -|(% style="width:1 81px" %)**Command Example**|(% style="width:181px" %)**Function**|(% style="width:465px" %)**Response**198 -|(% style="width:1 81px" %)AT+FDR|(% style="width:181px" %)Reset to factory default|(% style="width:465px" %)(((190 +(% border="1" style="background-color:#ffffcc; color:green; width:789px" %) 191 +|=(% colspan="3" style="width: 786px;" %)Reset to factory default 192 +|(% style="width:154px" %)**Command Example**|(% style="width:175px" %)**Function**|(% style="width:456px" %)**Response** 193 +|(% style="width:154px" %)AT+FDR|(% style="width:175px" %)Reset to factory default|(% style="width:456px" %)((( 199 199 Device reset to factory default parameters and show booting info 200 200 201 201 LSN50 Device/LoRa ST Module ... ... @@ -228,10 +228,10 @@ 228 228 229 229 (% style="color:blue" %)**AT Command: AT+VER** 230 230 231 -(% border="1" style="background-color:#ffffcc; color:green; width:5 86px" %)232 -|=(% colspan="3" style="width: 5 83px;" %)AT+VER: Image Version and Frequency Band233 -|(% style="width:17 0px" %)**Command Example**|(% style="width:300px" %)**Function**|(% style="width:113px" %)**Response**234 -|(% style="width:17 0px" %)AT+VER=?|(% style="width:300px" %)Show Image version and Frequency Band|(% style="width:113px" %)(((226 +(% border="1" style="background-color:#ffffcc; color:green; width:542px" %) 227 +|=(% colspan="3" style="width: 539px;" %)AT+VER: Image Version and Frequency Band 228 +|(% style="width:157px" %)**Command Example**|(% style="width:295px" %)**Function**|(% style="width:86px" %)**Response** 229 +|(% style="width:157px" %)AT+VER=?|(% style="width:295px" %)Show Image version and Frequency Band|(% style="width:86px" %)((( 235 235 1.3 EU868 236 236 237 237 OK ... ... @@ -250,7 +250,6 @@ 250 250 ((( 251 251 252 252 253 - 254 254 **xx: Software Type:** 255 255 ))) 256 256 ... ... @@ -309,11 +309,8 @@ 309 309 OK 310 310 ))) 311 311 312 - 313 - 314 314 = 5. Keys, IDs and EUIs management = 315 315 316 - 317 317 == 5.1 Application EUI == 318 318 319 319 ... ... @@ -330,8 +330,8 @@ 330 330 ))) 331 331 |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK 332 332 324 +(% style="display:none" %) (%%) 333 333 334 - 335 335 == 5.2 Application Key == 336 336 337 337 ... ... @@ -348,8 +348,8 @@ 348 348 ))) 349 349 |(% 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 350 350 342 +(% style="display:none" %) (%%) 351 351 352 - 353 353 == 5.3 Application Session Key == 354 354 355 355 ... ... @@ -368,8 +368,8 @@ 368 368 OK 369 369 ))) 370 370 362 +(% style="display:none" %) (%%) 371 371 372 - 373 373 == 5.4 Device Address == 374 374 375 375 ... ... @@ -388,8 +388,8 @@ 388 388 ))) 389 389 |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK 390 390 382 +(% style="display:none" %) (%%) 391 391 392 - 393 393 == 5.5 Device EUI == 394 394 395 395 ... ... @@ -408,8 +408,8 @@ 408 408 OK 409 409 ))) 410 410 402 +(% style="display:none" %) (%%) 411 411 412 - 413 413 == 5.6 Network ID == 414 414 415 415 ... ... @@ -426,8 +426,8 @@ 426 426 ))) 427 427 |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK 428 428 420 +(% style="display:none" %) (%%) 429 429 430 - 431 431 == 5.7 Network Session Key == 432 432 433 433 ... ... @@ -444,14 +444,12 @@ 444 444 ))) 445 445 |(% 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 446 446 438 +(% style="display:none" %) (%%) 447 447 448 - 449 449 = 6. Joining and sending date on LoRaWAN network = 450 450 451 - 452 452 == 6.1 Confirm Mode == 453 453 454 - 455 455 === 6.1.1 AT+CFM command before DR-LWS007 software stack === 456 456 457 457 ... ... @@ -475,12 +475,11 @@ 475 475 476 476 If the downlink payload=0501, it means set end node to use confirm mode, while type code is 05. 477 477 478 -* Example 1: Downlink Payload: 0501 ~/~/ Set AT+CFM=1 479 -* Example 2: Downlink Payload: 0500 ~/~/ Set AT+CFM=0 467 +* **Example 1:** Downlink Payload: 0501 ~/~/ Set AT+CFM=1 468 +* **Example 2:** Downlink Payload: 0500 ~/~/ Set AT+CFM=0 480 480 470 +(% style="display:none" %) (%%) 481 481 482 - 483 - 484 484 === 6.1.2 AT+CFM command since DR-LWS007 software stack === 485 485 486 486 ... ... @@ -523,12 +523,11 @@ 523 523 524 524 If the downlink payload=05010101, it means set end node to use confirm mode, while type code is 05. 525 525 526 -* Example 1: Downlink Payload: 05010101 ~/~/ Set AT+CFM=1,1,1 527 -* Example 2: Downlink Payload: 05000700 ~/~/ Set AT+CFM=0,7,0 514 +* **Example 1:** Downlink Payload: 05010101 ~/~/ Set AT+CFM=1,1,1 515 +* **Example 2:** Downlink Payload: 05000700 ~/~/ Set AT+CFM=0,7,0 528 528 517 +(% style="display:none" %) (%%) 529 529 530 - 531 - 532 532 == 6.2 Confirm Status == 533 533 534 534 ... ... @@ -537,15 +537,13 @@ 537 537 538 538 (% style="color:blue" %)**AT Command: AT+CFS** 539 539 540 -(% border="1" style="background-color:#ffffcc; color:green; width: 534.222px" %)541 -|=(% colspan="3" style="width: 531px;" %)AT+CFS542 -|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:17 8px" %)**Response**543 -|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:17 8px" %)0(((527 +(% border="1" style="background-color:#ffffcc; color:green; width:463px" %) 528 +|=(% colspan="3" style="width: 460px;" %)AT+CFS 529 +|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:107px" %)**Response** 530 +|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:107px" %)0((( 544 544 OK 545 545 ))) 546 546 547 - 548 - 549 549 == 6.3 Join LoRa® Network == 550 550 551 551 ... ... @@ -563,8 +563,6 @@ 563 563 While Error in format, return AT_BUSY_ERROR 564 564 ))) 565 565 566 - 567 - 568 568 == 6.4 LoRa® Network Join Mode == 569 569 570 570 ... ... @@ -588,12 +588,11 @@ 588 588 589 589 If the downlink payload=2000, it means set the Network Join Mode, while type code is 20. 590 590 591 -* **Example 1: **Downlink Payload: **2000** 592 -* **Example 2:** Downlink Payload: **2001** ~/~/ Set AT+NJM=1 574 +* **Example 1: **Downlink Payload: **2000 ** ~/~/ Set AT+NJM=0 575 +* **Example 2:** Downlink Payload: **2001** ~/~/ Set AT+NJM=1 593 593 577 +(% style="display:none" %) (%%) 594 594 595 - 596 - 597 597 == 6.5 LoRa® Network Join Status == 598 598 599 599 ... ... @@ -609,8 +609,8 @@ 609 609 OK 610 610 ))) 611 611 594 +(% style="display:none" %) (%%) 612 612 613 - 614 614 == 6.6 Print Last Received Data in Raw Format == 615 615 616 616 ... ... @@ -626,6 +626,8 @@ 626 626 OK 627 627 ))) 628 628 611 +(% style="display:none" %) (%%) 612 + 629 629 == 6.7 Print Last Received Data in Binary Format == 630 630 631 631 ... ... @@ -641,6 +641,8 @@ 641 641 OK 642 642 ))) 643 643 628 +(% style="display:none" %) (%%) 629 + 644 644 == 6.8 Send Text Data == 645 645 646 646 ... ... @@ -654,12 +654,11 @@ 654 654 |(% style="width:201px" %)**Command Example**|(% style="width:340px" %)**Function**|(% style="width:446px" %)**Response** 655 655 |(% style="width:201px" %)AT+SEND=12:hello world|(% style="width:340px" %)Send text data along with the application port.|(% style="width:446px" %)OK((( 656 656 While Error in format, return 657 - 658 658 AT_BUSY_ERROR/AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 659 - 660 - 661 661 ))) 662 662 646 +(% style="display:none" %) (%%) 647 + 663 663 == 6.9 Send Hexadecimal Data == 664 664 665 665 ... ... @@ -668,19 +668,18 @@ 668 668 669 669 (% style="color:blue" %)**AT Command: AT+SENDB** 670 670 671 -(% border="1" style="background-color:#ffffcc; color:green; width:1120.22px" %) 672 -|=(% colspan="3" style="width: 1117px;" %)AT+SENDB 673 -|(% style="width:257px" %)**Command Example**|(% style="width:406px" %)**Function**|(% style="width:453px" %)**Response** 674 -|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:406px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK 675 -|(% 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((( 676 -AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 677 - 678 - 656 +(% border="1" style="background-color:#ffffcc; color:green; width:1101px" %) 657 +|=(% colspan="3" style="width: 1098px;" %)AT+SENDB 658 +|(% style="width:257px" %)**Command Example**|(% style="width:394px" %)**Function**|(% style="width:446px" %)**Response** 659 +|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)OK 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 679 679 ))) 680 680 664 +(% style="display:none" %) (%%) 665 + 681 681 = 7. LoRaWAN network management = 682 682 683 - 684 684 == 7.1 Adaptive Data Rate == 685 685 686 686 ... ... @@ -704,9 +704,10 @@ 704 704 705 705 If the downlink payload=2201, it means setting the adaptive data rate to 1, while type code is 22. 706 706 707 -* **Example 1**: Downlink Payload: **2201** ~/~/ Set AT+ADR=1. 708 -* **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 691 +* **Example 1**: Downlink Payload: **2201** ~/~/ Set AT+ADR=1. 692 +* **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 709 709 694 +(% style="display:none" %) (%%) 710 710 711 711 == 7.2 LoRa® Class == 712 712 ... ... @@ -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** 702 +(% 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 ... ... @@ -723,16 +723,17 @@ 723 723 OK 724 724 ))) 725 725 |(% style="width:163px" %)AT+CLASS=C|(% style="width:166px" %)Set the Device Class.|(% style="width:175px" %)OK((( 726 - 727 727 ))) 728 728 713 +(% style="display:none" %) (%%) 714 + 729 729 == 7.3 Duty Cycle Setting == 730 730 731 731 732 -Feature: Get or Set the ETSI Duty Cycle setting 718 +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** 721 +(% 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 ... ... @@ -741,15 +741,21 @@ 741 741 OK 742 742 ))) 743 743 |(% style="width:165px" %)AT+DCS=1|(% style="width:239px" %)Set the ETSI Duty Cycle setting.|(% style="width:107px" %)OK((( 744 - 745 745 ))) 746 746 732 +(% style="display:none" %) (%%) 733 + 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 server737 +Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) . 751 751 739 +(% style="color:red" %) 740 +**Notice:** 752 752 742 +* 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. 743 +* 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/]] 744 + 753 753 (% style="color:blue" %)**AT Command: AT+DR** 754 754 755 755 (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %) ... ... @@ -766,9 +766,10 @@ 766 766 767 767 If the downlink payload=220001FF, it means setting the data rate to 1, while type code is 22 00 aa FF. 768 768 769 -* **Example 1**: Downlink Payload: **220001FF** ~/~/ Set AT+DR=1. 770 -* **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 761 +* **Example 1**: Downlink Payload: **220001FF** ~/~/ Set AT+DR=1. 762 +* **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 771 771 764 +(% style="display:none" %) (%%) 772 772 773 773 == 7.5 Frame Counter Downlink == 774 774 ... ... @@ -776,7 +776,7 @@ 776 776 Feature: Get or Set the Frame Counter Downlink. 777 777 778 778 779 -(% style="color:blue" %)**AT Command:AT+FCD** 772 +(% style="color:blue" %)**AT Command: AT+FCD** 780 780 781 781 (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %) 782 782 |=(% colspan="3" style="width: 690px;" %)AT+FCD ... ... @@ -793,7 +793,7 @@ 793 793 Feature: Get or Set the Frame Counter Uplink. 794 794 795 795 796 -(% style="color:blue" %)**AT Command:AT+FCU** 789 +(% style="color:blue" %)**AT Command: AT+FCU** 797 797 798 798 (% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %) 799 799 |=(% colspan="3" style="width: 531px;" %)AT+FCU ... ... @@ -802,9 +802,10 @@ 802 802 OK 803 803 ))) 804 804 |(% style="width:177px" %)AT+FCU=10|(% style="width:239px" %)Set the Frame Counter Uplink.|(% style="width:113px" %)OK((( 805 - 806 806 ))) 807 807 800 +(% style="display:none" %) (%%) 801 + 808 808 == 7.7 Join Accept Delay1 == 809 809 810 810 ... ... @@ -811,7 +811,7 @@ 811 811 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms. 812 812 813 813 814 -(% style="color:blue" %)**AT Command:AT+JN1DL** 808 +(% style="color:blue" %)**AT Command: AT+JN1DL** 815 815 816 816 (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %) 817 817 |=(% colspan="3" style="width: 534px;" %)AT+JN1DL ... ... @@ -820,15 +820,17 @@ 820 820 OK 821 821 ))) 822 822 |(% style="width:164px" %)AT+JN1DL=10000|(% style="width:229px" %)Set the Join Accept Delay.|(% style="width:140px" %)OK((( 823 - 824 824 ))) 825 825 819 +(% style="display:none" %) (%%) 820 + 826 826 == 7.8 Join Accept Delay2 == 827 827 823 + 828 828 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms. 829 829 830 830 831 -(% style="color:blue" %)**AT Command:AT+JN2DL** 827 +(% style="color:blue" %)**AT Command: AT+JN2DL** 832 832 833 833 (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %) 834 834 |=(% colspan="3" style="width: 535px;" %)AT+JN2DL ... ... @@ -837,18 +837,19 @@ 837 837 OK 838 838 ))) 839 839 |(% style="width:160px" %)AT+JN2DL=20000|(% style="width:228px" %)Set the Join Accept Delay.|(% style="width:146px" %)OK((( 840 - 841 841 ))) 842 842 838 +(% style="display:none" %) (%%) 839 + 843 843 == 7.9 Public Network Mode == 844 844 845 845 846 846 Feature: Get or Set the public network mode. (0: off, 1: on). A Public LoRaWAN network use 0x34 as syncword. Default Settings; PNM=1 847 847 848 -(% style="color:red" %)Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network 845 +(% style="color:red" %)**Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network.** 849 849 850 850 851 -(% style="color:blue" %)**AT Command:AT+PNM** 848 +(% style="color:blue" %)**AT Command: AT+PNM** 852 852 853 853 (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %) 854 854 |=(% colspan="3" style="width: 664px;" %)AT+PNM ... ... @@ -867,6 +867,8 @@ 867 867 ))) 868 868 |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %) 869 869 867 +(% style="display:none" %) (%%) 868 + 870 870 == 7.10 Receive Delay1 == 871 871 872 872 ... ... @@ -873,7 +873,7 @@ 873 873 Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms 874 874 875 875 876 -(% style="color:blue" %)**AT Command:AT+RX1DL** 875 +(% style="color:blue" %)**AT Command: AT+RX1DL** 877 877 878 878 (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %) 879 879 |=(% colspan="3" style="width: 405px;" %)AT+RX1DL ... ... @@ -882,9 +882,9 @@ 882 882 OK 883 883 ))) 884 884 |(% style="width:155px" %)AT+RX1DL=1500|(% style="width:128px" %)Set the delay.|(% style="width:122px" %)OK((( 885 - 886 886 ))) 887 887 886 +(% style="display:none" %) (%%) 888 888 889 889 == 7.11 Receive Delay2 == 890 890 ... ... @@ -892,7 +892,7 @@ 892 892 Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms 893 893 894 894 895 -(% style="color:blue" %)**AT Command:AT+RX2DL** 894 +(% style="color:blue" %)**AT Command: AT+RX2DL** 896 896 897 897 (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %) 898 898 |=(% colspan="3" style="width: 478px;" %)AT+RX2DL ... ... @@ -901,9 +901,9 @@ 901 901 OK 902 902 ))) 903 903 |(% style="width:175px" %)AT+RX2DL=2500|(% style="width:152px" %)Set the delay.|(% style="width:150px" %)OK((( 904 - 905 905 ))) 906 906 905 +(% style="display:none" %) (%%) 907 907 908 908 == 7.12 Rx2 Window Data Rate == 909 909 ... ... @@ -911,7 +911,7 @@ 911 911 Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X) 912 912 913 913 914 -(% style="color:blue" %)**AT Command:AT+RX2DR** 913 +(% style="color:blue" %)**AT Command: AT+RX2DR** 915 915 916 916 (% border="1" style="background-color:#ffffcc; color:green; width:525.222px" %) 917 917 |=(% colspan="3" style="width: 522px;" %)AT+RX2DR ... ... @@ -920,9 +920,9 @@ 920 920 OK 921 921 ))) 922 922 |(% style="width:160px" %)AT+RX2DR=6|(% style="width:232px" %)Set the Rx2 window data rate.|(% style="width:130px" %)OK((( 923 - 924 924 ))) 925 925 924 +(% style="display:none" %) (%%) 926 926 927 927 == 7.13 Rx2 Window Frequency == 928 928 ... ... @@ -930,7 +930,7 @@ 930 930 Feature: Get or Set the Rx2 window frequency 931 931 932 932 933 -(% style="color:blue" %)**AT Command:AT+RX2FQ** 932 +(% style="color:blue" %)**AT Command: AT+RX2FQ** 934 934 935 935 (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %) 936 936 |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ ... ... @@ -939,9 +939,9 @@ 939 939 OK 940 940 ))) 941 941 |(% style="width:183px" %)AT+RX2FQ=434665000|(% style="width:240px" %)Set the Rx2 window frequency.|(% style="width:160px" %)OK((( 942 - 943 943 ))) 944 944 943 +(% style="display:none" %) (%%) 945 945 946 946 == 7.14 Transmit Power == 947 947 ... ... @@ -948,9 +948,11 @@ 948 948 949 949 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. ) 950 950 950 +(% 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** 951 951 952 -(% style="color:blue" %)**AT Command:AT+TXP** 953 953 953 +(% style="color:blue" %)**AT Command: AT+TXP** 954 + 954 954 (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %) 955 955 |=(% colspan="3" style="width: 462px;" %)AT+TXP 956 956 |(% style="width:161px" %)**Command Example**|(% style="width:189px" %)**Function**|(% style="width:112px" %)**Response** ... ... @@ -958,7 +958,6 @@ 958 958 OK 959 959 ))) 960 960 |(% style="width:161px" %)AT+TXP=1|(% style="width:189px" %)Set the Transmit Power.|(% style="width:112px" %)OK((( 961 - 962 962 ))) 963 963 964 964 Downlink Payload. The 4th byte of 0x22 downlink. ... ... @@ -965,11 +965,11 @@ 965 965 966 966 If the downlink payload=22000100, it means setting the TXP to 0. 967 967 968 -* **Example 1**: Downlink Payload: **22000102** ~/~/ Set AT+TXP=2. 969 -* **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+TXP=0. 968 +* **Example 1**: Downlink Payload: **22000102** ~/~/ Set AT+TXP=2. 969 +* **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+TXP=0. 970 970 971 +(% style="display:none" %) (%%) 971 971 972 - 973 973 == 7.15 RSSI of the Last Received Packet == 974 974 975 975 ... ... @@ -985,6 +985,7 @@ 985 985 OK 986 986 ))) 987 987 988 +(% style="display:none" %) (%%) 988 988 989 989 == 7.16 SNR of the Last Received Packet == 990 990 ... ... @@ -992,7 +992,7 @@ 992 992 Feature: Get the SNR of the last received packet 993 993 994 994 995 -(% style="color:blue" %)**AT Command:AT+SNR** 996 +(% style="color:blue" %)**AT Command: AT+SNR** 996 996 997 997 (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %) 998 998 |=(% colspan="3" style="width: 568px;" %)AT+SNR ... ... @@ -1001,6 +1001,7 @@ 1001 1001 OK 1002 1002 ))) 1003 1003 1005 +(% style="display:none" %) (%%) 1004 1004 1005 1005 == 7.17 Application Port == 1006 1006 ... ... @@ -1024,11 +1024,11 @@ 1024 1024 1025 1025 If the downlink payload=2301, it means set the application port to 1, while type code is 23. 1026 1026 1027 -* **Example 1**: Downlink Payload: **2301** ~/~/ set the application port to 1 1028 -* **Example 2**: Downlink Payload:** 2305** ~/~/ set the application port to 5 1029 +* **Example 1**: Downlink Payload: **2301** ~/~/ set the application port to 1 1030 +* **Example 2**: Downlink Payload:** 2305** ~/~/ set the application port to 5 1029 1029 1032 +(% style="display:none" %) (%%) 1030 1030 1031 - 1032 1032 == 7.18 Single Channel Mode == 1033 1033 1034 1034 ... ... @@ -1045,9 +1045,11 @@ 1045 1045 ))) 1046 1046 |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK 1047 1047 1050 +(% style="display:none" %) (%%) 1048 1048 1049 1049 == 7.19 Eight Channel Mode == 1050 1050 1054 + 1051 1051 Feature: Get or Set eight channels mode,Only for US915,AU915,CN470. 1052 1052 1053 1053 ... ... @@ -1063,17 +1063,17 @@ 1063 1063 ))) 1064 1064 |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK 1065 1065 1066 -(% style="color:blue" %)**Downlink Command: 0x24** 1070 +(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)** 1067 1067 1068 1068 Format: Command Code (0x24) followed by 1 bytes channel value. 1069 1069 1070 1070 If the downlink payload=2401, it means set channel mode to 1, while type code is 24. 1071 1071 1072 -* **Example 1**: Downlink Payload: 2401 ~/~/ set channel mode to 1 1073 -* **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1076 +* **Example 1**: Downlink Payload: 2401 ~/~/ set channel mode to 1 1077 +* **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1074 1074 1079 +(% style="display:none" %) (%%) 1075 1075 1076 - 1077 1077 == 7.20 Get or Set RXwindows1 timeout == 1078 1078 1079 1079 ... ... @@ -1090,23 +1090,19 @@ 1090 1090 ))) 1091 1091 |(% style="width:163px" %)AT+RX1WTO=60|(% style="width:201px" %)Set RXwindows1 timeout|(% style="width:93px" %)OK 1092 1092 1093 -((( 1094 - 1097 +(% style="display:none" %) (%%) 1095 1095 1096 -**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. 1097 - 1098 - 1099 +((( 1100 +(% 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. 1099 1099 ))) 1100 1100 1101 1101 [[image:image-20220526162535-1.png]] 1102 1102 1103 - 1104 1104 ((( 1105 1105 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. 1106 - 1107 - 1108 1108 ))) 1109 1109 1109 + 1110 1110 == 7.21 Get or Set RXwindows2 timeout == 1111 1111 1112 1112 ... ... @@ -1123,6 +1123,7 @@ 1123 1123 ))) 1124 1124 |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK 1125 1125 1126 +(% style="display:none" %) (%%) 1126 1126 1127 1127 == 7.22 Setting up uplinkdwelltime (as923, au915) == 1128 1128 ... ... @@ -1146,11 +1146,11 @@ 1146 1146 1147 1147 If the downlink payload=2501, it means set uplinkdwelltime to 1, while type code is 25. 1148 1148 1149 -* **Example 1**: Downlink Payload: **2501** ~/~/ set uplinkdwelltime to 1 1150 -* **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1150 +* **Example 1**: Downlink Payload: **2501** ~/~/ set uplinkdwelltime to 1 1151 +* **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1151 1151 1153 +(% style="display:none" %) (%%) 1152 1152 1153 - 1154 1154 == 7.23 Set Packet Receiving Response Level == 1155 1155 1156 1156 ... ... @@ -1157,7 +1157,7 @@ 1157 1157 Feature: Get or Set packet receiving response level. This feature is used to set compatible with different LoRaWAN servers. If RPL doesn;t match , user will see strange message in the server portal. 1158 1158 1159 1159 1160 -RPL value: 1161 +**RPL value:** 1161 1161 1162 1162 * **AT+RPL=0:** Device won't immediately reply any downlink commands from platform. 1163 1163 * **AT+RPL=1:** Device will immediately reply message to Unconfirmed Data Down. Payload is 0x00. ... ... @@ -1165,14 +1165,12 @@ 1165 1165 * **AT+RPL=3:** Device will immediately reply message to MAC Command. Payload is 0x00 and requied response header for this command. 1166 1166 * **AT+RPL=4: **Device will immediately reply message to Confirmed Data Down & MAC Command. Payload is 0x00 and requied response header for these two commands. 1167 1167 1169 +**Case Analyes:** 1168 1168 1169 -Case Analyes: 1170 - 1171 1171 * For Class A devices, AT+RPL=0 is ok. that is defaut settings in software. 1172 1172 * For Class C devices used in ChirpStack, need to set AT+RPL=4 because Chirpstack require immedietely reply message to MAC Command. 1173 1173 * 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. 1174 1174 1175 - 1176 1176 (% style="color:blue" %)**AT Command: AT+RPL** 1177 1177 1178 1178 (% border="1" style="background-color:#ffffcc; color:green; width:536.222px" %) ... ... @@ -1189,23 +1189,27 @@ 1189 1189 1190 1190 If the downlink payload=2101, it means set packet receiving response level to 1, while type code is 21. 1191 1191 1192 -* **Example 1**: Downlink Payload: **2101** ~/~/ set packet receiving response level to 1 1193 -* **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1191 +* **Example 1**: Downlink Payload: **2101** ~/~/ set packet receiving response level to 1 1192 +* **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1194 1194 1194 +(% style="display:none" %) (%%) 1195 1195 1196 - 1197 1197 == 7.24 Controls NBTrans in unconfirmed uplink mode(LWS007 NBTrans:Set retransmission packets) == 1198 1198 1199 1199 1200 1200 (% style="color:blue" %)**AT Command: AT+SETMAXNBTRANS ** 1201 1201 1202 -(% border="1" style="background-color:#ffffcc; color:green; width:5 36.222px" %)1203 -|=(% colspan="3" style="width: 5 33px;" %)AT+**SETMAXNBTRANS**1204 -|(% style="width: 160px" %)**Command Example**|(% style="width:263px" %)**Function**|(% style="width:109px" %)**Response**1205 -|(% style="width: 160px" %)**AT+SETMAXNBTRANS=1,0**|(% style="width:263px" %)Value1: set the maximum NBTrans.|(% style="width:109px" %)1(((1201 +(% border="1" style="background-color:#ffffcc; color:green; width:589px" %) 1202 +|=(% colspan="3" style="width: 586px;" %)AT+**SETMAXNBTRANS** 1203 +|(% style="width:227px" %)**Command Example**|(% style="width:300px" %)**Function**|(% style="width:87px" %)**Response** 1204 +|(% style="width:227px" %)**AT+SETMAXNBTRANS=1,0**|(% style="width:300px" %)Value1: set the maximum NBTrans.|(% style="width:87px" %)1((( 1206 1206 OK 1207 1207 ))) 1208 -|(% style="width:160px" %)**AT+SETMAXNBTRANS=?,1**|(% style="width:263px" %)value2: 0: uplink fcnt doesn't change for each NBTrans; 1: uplink fcnt increase by 1 for each NBTrans.|(% style="width:109px" %)((( 1207 +|(% style="width:227px" %)**AT+SETMAXNBTRANS=?,1**|(% style="width:300px" %)((( 1208 +value2: 0: uplink fcnt doesn't change for each NBTrans; 1209 + 1210 +1: uplink fcnt increase by 1 for each NBTrans. 1211 +)))|(% style="width:87px" %)((( 1209 1209 1 1210 1210 1211 1211 OK ... ... @@ -1217,16 +1217,21 @@ 1217 1217 1218 1218 If the downlink payload=330100, it means set end node to use confirm mode, while type code is 33. 1219 1219 1220 -* Example 1: Downlink Payload: 330100 ~/~/ Set AT+SETMAXNBTRANS=1,0 1221 -* Example 2: Downlink Payload: 330201 ~/~/ Set AT+SETMAXNBTRANS=2,1 1223 +* Example 1: Downlink Payload: 330100 ~/~/ Set AT+SETMAXNBTRANS=1,0 1224 +* Example 2: Downlink Payload: 330201 ~/~/ Set AT+SETMAXNBTRANS=2,1 1222 1222 1226 +(% style="display:none" %) (%%) 1223 1223 1224 - 1225 1225 == 7.25 Device offline rejoining (LWS007) == 1226 1226 1227 1227 1228 1228 (% style="color:blue" %)**AT Command: AT+DDETECT** 1229 1229 1233 +AT+DDETECT=<Flag>,<ACK_Timout_1>,<ACK_Timout_2> (Default Value: AT+DDETECT=1,1440,2880) 1234 + 1235 +* ACK_Timout_1: Unit: min 1236 +* ACK_Timout_2: Unit: min 1237 + 1230 1230 (% border="1" style="background-color:#ffffcc; color:green; width:710.222px" %) 1231 1231 |=(% colspan="3" style="width: 707px;" %)AT+**DDETECT** 1232 1232 |(% style="width:160px" %)**Command Example**|(% style="width:198px" %)**Function**|(% style="width:349px" %)**Response** ... ... @@ -1258,16 +1258,20 @@ 1258 1258 OK 1259 1259 ))) 1260 1260 1261 -(% style="color:blue" %)**Downlink Command: 0x3 3**1269 +(% style="color:blue" %)**Downlink Command: 0x32** 1262 1262 1263 1263 Format: Command Code (0x32) followed by 2 bytes mode value. 1264 1264 1265 -If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 3 3.1273 +If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 32. 1266 1266 1267 -* Example 1: Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1275 +* **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1276 +** 0x01 : Flag 1277 +** 0x05A0: ACK_Timout_1 : 1440minutes (24 hours) 1278 +** 0x0B40: ACK_Timout_2 : 2880minutes (48 hours) 1279 +** **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. 1268 1268 1281 +(% style="display:none" %) (%%) 1269 1269 1270 - 1271 1271 == 7.26 Request the server to send an ACK == 1272 1272 1273 1273 ... ... @@ -1281,10 +1281,10 @@ 1281 1281 ))) 1282 1282 |(% style="width:160px" %)**AT+PNACKMD=0**|(% style="width:263px" %)off request the server to send an ACK|(% style="width:109px" %)((( 1283 1283 0 1284 - 1285 1285 OK 1286 1286 ))) 1287 1287 1299 +(% style="display:none" %) (%%) 1288 1288 1289 1289 == 7.27 Adjust network rejoining interval == 1290 1290 ... ... @@ -1294,13 +1294,13 @@ 1294 1294 (% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %) 1295 1295 |=(% colspan="3" style="width: 724px;" %)AT+RJTDC 1296 1296 |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response** 1297 -|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30 000(((1309 +|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30((( 1298 1298 OK 1299 1299 1300 -the interval is 30 000ms= 30s1312 +the interval is 30 min 1301 1301 ))) 1302 -|(% style="width:165px" %)AT+RJTDC=60 000|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK(((1303 -Set the ReJoin data transmission interval to 60 000ms= 60 seconds1314 +|(% style="width:165px" %)AT+RJTDC=60|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK((( 1315 +Set the ReJoin data transmission interval to 60 min 1304 1304 ))) 1305 1305 1306 1306 (% style="color:blue" %)**Downlink Command: 0x26** ... ... @@ -1309,22 +1309,21 @@ 1309 1309 1310 1310 If the downlink payload=26000A, it means set end node to use confirm mode, while type code is 26. 1311 1311 1312 -* Example 1: Downlink Payload: 26000A ~/~/ Set AT+RJTDC=10 1313 -* Example 2: Downlink Payload: 260002 ~/~/ Set AT+RJTDC=2 1324 +* **Example 1:** Downlink Payload: 26000A ~/~/ Set AT+RJTDC=10 1325 +* **Example 2: **Downlink Payload: 260002 ~/~/ Set AT+RJTDC=2 1314 1314 1327 +(% style="display:none" %) (%%) 1315 1315 1316 - 1317 1317 = 8. AT Commands Combination = 1318 1318 1319 - 1320 1320 == 8.1 Set a fix RX2DR for downlink window == 1321 1321 1322 1322 1323 -* **AT+ADR=0 ** **~-~->** Disable ADR first 1324 -* **AT+RX2DR=xxxx** 1334 +* (% style="color:blue" %)**AT+ADR=0 **(%%) **~-~->** Disable ADR first 1335 +* (% style="color:blue" %)**AT+RX2DR=xxxx** (%%) **~-~->** Set xxxx to your wanted DataRate 1325 1325 1337 +(% style="display:none" %) (%%) 1326 1326 1327 - 1328 1328 == 8.2 Use Downlink Command to set a fix uplink DR == 1329 1329 1330 1330 ... ... @@ -1332,6 +1332,10 @@ 1332 1332 1333 1333 **Same as:** 1334 1334 1335 -* AT+ADR=0 [[Reference>>||anchor="H7.1AdaptiveDataRate"]] 1336 -* AT+DR=5 [[Reference>>||anchor="H7.4DataRate"]] 1337 -* AT+TXP=0 [[Reference>>||anchor="H7.14TransmitPower"]] 1346 +* AT+ADR=0 [[Reference>>||anchor="H7.1AdaptiveDataRate"]] 1347 + 1348 +* AT+DR=5 [[Reference>>||anchor="H7.4DataRate"]] 1349 + 1350 +* AT+TXP=0 [[Reference>>||anchor="H7.14TransmitPower"]] 1351 + 1352 +