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,25 +9,26 @@ 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 + 17 17 ))) 18 18 19 - 20 20 = 2. How to use AT Commands or Downlink command = 21 21 22 22 23 -* **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/]]24 -* **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: 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]] , [[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]] 27 27 ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server) 28 28 29 -(% style="display:none" %) (%%) 30 30 30 + 31 + 31 31 = 3. Support End Node and firmware version = 32 32 33 33 ... ... @@ -102,10 +102,12 @@ 102 102 ))) 103 103 ))) 104 104 105 -(% style="display:none" %) (%%) 106 106 107 + 108 + 107 107 = 4. System Management Commands = 108 108 111 + 109 109 == 4.1 Change Uplink Interval == 110 110 111 111 ... ... @@ -135,14 +135,15 @@ 135 135 ))) 136 136 137 137 ((( 138 -If the downlink payload=0100003C, it means set the END Node 's Transmit Interval to 0x00003C=60(S), while type code is 01.141 +If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01. 139 139 ))) 140 140 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 148 + 149 + 146 146 == 4.2 Reboot End Node == 147 147 148 148 ... ... @@ -151,10 +151,10 @@ 151 151 152 152 (% style="color:blue" %)**AT Command: ATZ** 153 153 154 -(% border="1" style="background-color:#ffffcc; color:green; width: 546px" %)155 -|=(% colspan="3" style="width: 543px;"%)ATZ: Trig a reset of the MCU156 -| (% 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" %)(((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|((( 158 158 Device reset and show booting info 159 159 160 160 LSN50 Device/LoRa ST Module ... ... @@ -168,6 +168,7 @@ 168 168 <followed by the Tx and Rx information> 169 169 ))) 170 170 175 + 171 171 (% style="color:blue" %)**Downlink Command: 0x04** 172 172 173 173 ((( ... ... @@ -175,10 +175,11 @@ 175 175 ))) 176 176 177 177 ((( 178 -If the downlink payload=**04FF**, the end node will reboot. 183 +If the downlink payload=**04FF**, the end node will reboot. 184 + 185 + 179 179 ))) 180 180 181 - 182 182 == 4.3 Reset to factory Default == 183 183 184 184 ... ... @@ -187,10 +187,10 @@ 187 187 188 188 (% style="color:blue" %)**AT Command: AT+FDR** 189 189 190 -(% border="1" style="background-color:#ffffcc; color:green; width: 789px" %)191 -|=(% colspan="3" style="width: 786px;" %)Reset to factory default192 -|(% style="width:1 54px" %)**Command Example**|(% style="width:175px" %)**Function**|(% style="width:456px" %)**Response**193 -|(% style="width:1 54px" %)AT+FDR|(% style="width:175px" %)Reset to factory default|(% style="width:456px" %)(((196 +(% border="1" style="background-color:#ffffcc; color:green; width:831.222px" %) 197 +|=(% colspan="3" style="width: 828px;" %)Reset to factory default 198 +|(% style="width:181px" %)**Command Example**|(% style="width:181px" %)**Function**|(% style="width:465px" %)**Response** 199 +|(% style="width:181px" %)AT+FDR|(% style="width:181px" %)Reset to factory default|(% style="width:465px" %)((( 194 194 Device reset to factory default parameters and show booting info 195 195 196 196 LSN50 Device/LoRa ST Module ... ... @@ -204,6 +204,7 @@ 204 204 Please set the parameters or reset Device to apply change 205 205 ))) 206 206 213 + 207 207 (% style="color:blue" %)**Downlink Command: 0x04** 208 208 209 209 ((( ... ... @@ -223,15 +223,16 @@ 223 223 224 224 (% style="color:blue" %)**AT Command: AT+VER** 225 225 226 -(% border="1" style="background-color:#ffffcc; color:green; width:5 42px" %)227 -|=(% colspan="3" style="width: 53 9px;" %)AT+VER: Image Version and Frequency Band228 -|(% style="width:1 57px" %)**Command Example**|(% style="width:295px" %)**Function**|(% style="width:86px" %)**Response**229 -|(% style="width:1 57px" %)AT+VER=?|(% style="width:295px" %)Show Image version and Frequency Band|(% style="width:86px" %)(((233 +(% border="1" style="background-color:#ffffcc; color:green; width:586px" %) 234 +|=(% colspan="3" style="width: 583px;" %)AT+VER: Image Version and Frequency Band 235 +|(% style="width:170px" %)**Command Example**|(% style="width:300px" %)**Function**|(% style="width:113px" %)**Response** 236 +|(% style="width:170px" %)AT+VER=?|(% style="width:300px" %)Show Image version and Frequency Band|(% style="width:113px" %)((( 230 230 1.3 EU868 231 231 232 232 OK 233 233 ))) 234 234 242 + 235 235 (% style="color:blue" %)**Downlink Command: 0x26 (Valid in 006 stack)** 236 236 237 237 ((( ... ... @@ -245,6 +245,7 @@ 245 245 ((( 246 246 247 247 256 + 248 248 **xx: Software Type:** 249 249 ))) 250 250 ... ... @@ -303,8 +303,11 @@ 303 303 OK 304 304 ))) 305 305 315 + 316 + 306 306 = 5. Keys, IDs and EUIs management = 307 307 319 + 308 308 == 5.1 Application EUI == 309 309 310 310 ... ... @@ -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 337 + 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 355 + 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 375 + 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 395 + 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 415 + 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 433 + 422 422 == 5.7 Network Session Key == 423 423 424 424 ... ... @@ -435,12 +435,14 @@ 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 451 + 440 440 = 6. Joining and sending date on LoRaWAN network = 441 441 454 + 442 442 == 6.1 Confirm Mode == 443 443 457 + 444 444 === 6.1.1 AT+CFM command before DR-LWS007 software stack === 445 445 446 446 ... ... @@ -458,6 +458,7 @@ 458 458 |(% style="width:155px" %)AT+CFM=1|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)OK 459 459 |(% style="width:155px" %)AT+CFM=2|(% style="width:205px" %)Set the confirmation mode|(% style="width:346px" %)While Error in format, return AT_PARAM_ERROR 460 460 475 + 461 461 (% style="color:blue" %)**Downlink Command: 0x05** 462 462 463 463 Format: Command Code (0x05) followed by 2 bytes mode value. ... ... @@ -467,8 +467,9 @@ 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 486 + 487 + 472 472 === 6.1.2 AT+CFM command since DR-LWS007 software stack === 473 473 474 474 ... ... @@ -505,6 +505,7 @@ 505 505 OK 506 506 ))) 507 507 524 + 508 508 (% style="color:blue" %)**Downlink Command: 0x05** 509 509 510 510 Format: Command Code (0x05) followed by 2 bytes mode value. ... ... @@ -514,8 +514,9 @@ 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 535 + 536 + 519 519 == 6.2 Confirm Status == 520 520 521 521 ... ... @@ -524,13 +524,15 @@ 524 524 525 525 (% style="color:blue" %)**AT Command: AT+CFS** 526 526 527 -(% border="1" style="background-color:#ffffcc; color:green; width: 463px" %)528 -|=(% colspan="3" style="width: 460px;" %)AT+CFS529 -|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:1 07px" %)**Response**530 -|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:1 07px" %)0(((545 +(% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %) 546 +|=(% colspan="3" style="width: 531px;" %)AT+CFS 547 +|(% style="width:156px" %)**Command Example**|(% style="width:193px" %)**Function**|(% style="width:178px" %)**Response** 548 +|(% style="width:156px" %)AT+CFS=?|(% style="width:193px" %)Get confirmation status|(% style="width:178px" %)0((( 531 531 OK 532 532 ))) 533 533 552 + 553 + 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 571 + 572 + 551 551 == 6.4 LoRa® Network Join Mode == 552 552 553 553 ... ... @@ -565,6 +565,7 @@ 565 565 |(% style="width:162px" %)AT+NJM=0|(% style="width:227px" %)Set the Network Join Mode|(% style="width:361px" %)OK 566 566 |(% style="width:162px" %)AT+NJM=2|(% style="width:227px" %)Set the Network Join Mode|(% style="width:361px" %)While Error in format, return AT_PARAM_ERROR 567 567 590 + 568 568 (% style="color:blue" %)**Downlink Command: 0x20** 569 569 570 570 Format: Command Code (0x20) followed by 1 bytes mode value. ... ... @@ -571,11 +571,12 @@ 571 571 572 572 If the downlink payload=2000, it means set the Network Join Mode, while type code is 20. 573 573 574 -* **Example 1: **Downlink Payload: **2000 597 +* **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 601 + 602 + 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 619 + 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 636 + 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 653 + 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 667 + 643 643 AT_BUSY_ERROR/AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 669 + 670 + 644 644 ))) 645 645 646 -(% style="display:none" %) (%%) 647 647 674 + 648 648 == 6.9 Send Hexadecimal Data == 649 649 650 650 ... ... @@ -653,18 +653,21 @@ 653 653 654 654 (% style="color:blue" %)**AT Command: AT+SENDB** 655 655 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 683 +(% border="1" style="background-color:#ffffcc; color:green; width:1120.22px" %) 684 +|=(% colspan="3" style="width: 1117px;" %)AT+SENDB 685 +|(% style="width:257px" %)**Command Example**|(% style="width:406px" %)**Function**|(% style="width:453px" %)**Response** 686 +|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:406px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK 687 +|(% 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((( 688 +AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 689 + 690 + 662 662 ))) 663 663 664 -(% style="display:none" %) (%%) 665 665 694 + 666 666 = 7. LoRaWAN network management = 667 667 697 + 668 668 == 7.1 Adaptive Data Rate == 669 669 670 670 ... ... @@ -684,6 +684,7 @@ 684 684 AT_PARAM_ERROR 685 685 ))) 686 686 717 + 687 687 (% style="color:blue" %)**Downlink Command: 0x22** 688 688 689 689 If the downlink payload=2201, it means setting the adaptive data rate to 1, while type code is 22. ... ... @@ -691,8 +691,9 @@ 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 726 + 727 + 696 696 == 7.2 LoRa® Class == 697 697 698 698 ... ... @@ -699,7 +699,7 @@ 699 699 Feature: Get or Set the Device Class(Currently only support class A, class C). 700 700 701 701 702 -(% style="color:blue" %)**AT Command: 734 +(% style="color:blue" %)**AT Command:AT+CLASS** 703 703 704 704 (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %) 705 705 |=(% colspan="3" style="width: 504px;" %)AT+CLASS ... ... @@ -708,17 +708,18 @@ 708 708 OK 709 709 ))) 710 710 |(% style="width:163px" %)AT+CLASS=C|(% style="width:166px" %)Set the Device Class.|(% style="width:175px" %)OK((( 743 + 711 711 ))) 712 712 713 -(% style="display:none" %) (%%) 714 714 747 + 715 715 == 7.3 Duty Cycle Setting == 716 716 717 717 718 -Feature: Get or Set the ETSI Duty Cycle setting **- 0**=disable,**1**=enable - Only for testing.751 +Feature: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing. 719 719 720 720 721 -(% style="color:blue" %)**AT Command: 754 +(% style="color:blue" %)**AT Command:AT+DCS** 722 722 723 723 (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %) 724 724 |=(% colspan="3" style="width: 512px;" %)AT+DCS ... ... @@ -727,21 +727,17 @@ 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((( 763 + 730 730 ))) 731 731 732 -(% style="display:none" %) (%%) 733 733 767 + 734 734 == 7.4 Data Rate == 735 735 736 736 737 -Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) . 771 +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 738 738 739 -(% style="color:red" %) 740 -**Notice:** 741 741 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 - 745 745 (% style="color:blue" %)**AT Command: AT+DR** 746 746 747 747 (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %) ... ... @@ -754,6 +754,7 @@ 754 754 755 755 ))) 756 756 786 + 757 757 (% style="color:blue" %)**Downlink Command: 0x2200aaFF** 758 758 759 759 If the downlink payload=220001FF, it means setting the data rate to 1, while type code is 22 00 aa FF. ... ... @@ -761,8 +761,9 @@ 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 795 + 796 + 766 766 == 7.5 Frame Counter Downlink == 767 767 768 768 ... ... @@ -769,7 +769,7 @@ 769 769 Feature: Get or Set the Frame Counter Downlink. 770 770 771 771 772 -(% style="color:blue" %)**AT Command: 803 +(% style="color:blue" %)**AT Command:AT+FCD** 773 773 774 774 (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %) 775 775 |=(% colspan="3" style="width: 690px;" %)AT+FCD ... ... @@ -781,12 +781,14 @@ 781 781 OK 782 782 ))) 783 783 815 + 816 + 784 784 == 7.6 Frame Counter Uplink == 785 785 786 786 Feature: Get or Set the Frame Counter Uplink. 787 787 788 788 789 -(% style="color:blue" %)**AT Command: 822 +(% style="color:blue" %)**AT Command:AT+FCU** 790 790 791 791 (% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %) 792 792 |=(% colspan="3" style="width: 531px;" %)AT+FCU ... ... @@ -795,10 +795,11 @@ 795 795 OK 796 796 ))) 797 797 |(% style="width:177px" %)AT+FCU=10|(% style="width:239px" %)Set the Frame Counter Uplink.|(% style="width:113px" %)OK((( 831 + 798 798 ))) 799 799 800 -(% style="display:none" %) (%%) 801 801 835 + 802 802 == 7.7 Join Accept Delay1 == 803 803 804 804 ... ... @@ -805,7 +805,7 @@ 805 805 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms. 806 806 807 807 808 -(% style="color:blue" %)**AT Command: 842 +(% style="color:blue" %)**AT Command:AT+JN1DL** 809 809 810 810 (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %) 811 811 |=(% colspan="3" style="width: 534px;" %)AT+JN1DL ... ... @@ -814,17 +814,17 @@ 814 814 OK 815 815 ))) 816 816 |(% style="width:164px" %)AT+JN1DL=10000|(% style="width:229px" %)Set the Join Accept Delay.|(% style="width:140px" %)OK((( 851 + 817 817 ))) 818 818 819 -(% style="display:none" %) (%%) 820 820 855 + 821 821 == 7.8 Join Accept Delay2 == 822 822 823 - 824 824 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms. 825 825 826 826 827 -(% style="color:blue" %)**AT Command: 861 +(% style="color:blue" %)**AT Command:AT+JN2DL** 828 828 829 829 (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %) 830 830 |=(% colspan="3" style="width: 535px;" %)AT+JN2DL ... ... @@ -833,19 +833,20 @@ 833 833 OK 834 834 ))) 835 835 |(% style="width:160px" %)AT+JN2DL=20000|(% style="width:228px" %)Set the Join Accept Delay.|(% style="width:146px" %)OK((( 870 + 836 836 ))) 837 837 838 -(% style="display:none" %) (%%) 839 839 874 + 840 840 == 7.9 Public Network Mode == 841 841 842 842 843 843 Feature: Get or Set the public network mode. (0: off, 1: on). A Public LoRaWAN network use 0x34 as syncword. Default Settings; PNM=1 844 844 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.**880 +(% style="color:red" %)Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network 846 846 847 847 848 -(% style="color:blue" %)**AT Command: 883 +(% style="color:blue" %)**AT Command:AT+PNM** 849 849 850 850 (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %) 851 851 |=(% colspan="3" style="width: 664px;" %)AT+PNM ... ... @@ -864,8 +864,8 @@ 864 864 ))) 865 865 |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %) 866 866 867 -(% style="display:none" %) (%%) 868 868 903 + 869 869 == 7.10 Receive Delay1 == 870 870 871 871 ... ... @@ -872,7 +872,7 @@ 872 872 Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms 873 873 874 874 875 -(% style="color:blue" %)**AT Command: 910 +(% style="color:blue" %)**AT Command:AT+RX1DL** 876 876 877 877 (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %) 878 878 |=(% colspan="3" style="width: 405px;" %)AT+RX1DL ... ... @@ -881,10 +881,11 @@ 881 881 OK 882 882 ))) 883 883 |(% style="width:155px" %)AT+RX1DL=1500|(% style="width:128px" %)Set the delay.|(% style="width:122px" %)OK((( 919 + 884 884 ))) 885 885 886 -(% style="display:none" %) (%%) 887 887 923 + 888 888 == 7.11 Receive Delay2 == 889 889 890 890 ... ... @@ -891,7 +891,7 @@ 891 891 Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms 892 892 893 893 894 -(% style="color:blue" %)**AT Command: 930 +(% style="color:blue" %)**AT Command:AT+RX2DL** 895 895 896 896 (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %) 897 897 |=(% colspan="3" style="width: 478px;" %)AT+RX2DL ... ... @@ -900,10 +900,11 @@ 900 900 OK 901 901 ))) 902 902 |(% style="width:175px" %)AT+RX2DL=2500|(% style="width:152px" %)Set the delay.|(% style="width:150px" %)OK((( 939 + 903 903 ))) 904 904 905 -(% style="display:none" %) (%%) 906 906 943 + 907 907 == 7.12 Rx2 Window Data Rate == 908 908 909 909 ... ... @@ -910,7 +910,7 @@ 910 910 Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X) 911 911 912 912 913 -(% style="color:blue" %)**AT Command: 950 +(% style="color:blue" %)**AT Command:AT+RX2DR** 914 914 915 915 (% border="1" style="background-color:#ffffcc; color:green; width:525.222px" %) 916 916 |=(% colspan="3" style="width: 522px;" %)AT+RX2DR ... ... @@ -919,10 +919,11 @@ 919 919 OK 920 920 ))) 921 921 |(% style="width:160px" %)AT+RX2DR=6|(% style="width:232px" %)Set the Rx2 window data rate.|(% style="width:130px" %)OK((( 959 + 922 922 ))) 923 923 924 -(% style="display:none" %) (%%) 925 925 963 + 926 926 == 7.13 Rx2 Window Frequency == 927 927 928 928 ... ... @@ -929,7 +929,7 @@ 929 929 Feature: Get or Set the Rx2 window frequency 930 930 931 931 932 -(% style="color:blue" %)**AT Command: 970 +(% style="color:blue" %)**AT Command:AT+RX2FQ** 933 933 934 934 (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %) 935 935 |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ ... ... @@ -938,20 +938,19 @@ 938 938 OK 939 939 ))) 940 940 |(% style="width:183px" %)AT+RX2FQ=434665000|(% style="width:240px" %)Set the Rx2 window frequency.|(% style="width:160px" %)OK((( 979 + 941 941 ))) 942 942 943 -(% style="display:none" %) (%%) 944 944 983 + 945 945 == 7.14 Transmit Power == 946 946 947 947 948 948 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. ) 949 949 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 990 +(% style="color:blue" %)**AT Command:AT+TXP** 952 952 953 -(% style="color:blue" %)**AT Command: AT+TXP** 954 - 955 955 (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %) 956 956 |=(% colspan="3" style="width: 462px;" %)AT+TXP 957 957 |(% style="width:161px" %)**Command Example**|(% style="width:189px" %)**Function**|(% style="width:112px" %)**Response** ... ... @@ -959,8 +959,10 @@ 959 959 OK 960 960 ))) 961 961 |(% style="width:161px" %)AT+TXP=1|(% style="width:189px" %)Set the Transmit Power.|(% style="width:112px" %)OK((( 999 + 962 962 ))) 963 963 1002 + 964 964 Downlink Payload. The 4th byte of 0x22 downlink. 965 965 966 966 If the downlink payload=22000100, it means setting the TXP to 0. ... ... @@ -968,8 +968,9 @@ 968 968 * **Example 1**: Downlink Payload: **22000102** ~/~/ Set AT+TXP=2. 969 969 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+TXP=0. 970 970 971 -(% style="display:none" %) (%%) 972 972 1011 + 1012 + 973 973 == 7.15 RSSI of the Last Received Packet == 974 974 975 975 ... ... @@ -985,8 +985,8 @@ 985 985 OK 986 986 ))) 987 987 988 -(% style="display:none" %) (%%) 989 989 1029 + 990 990 == 7.16 SNR of the Last Received Packet == 991 991 992 992 ... ... @@ -993,7 +993,7 @@ 993 993 Feature: Get the SNR of the last received packet 994 994 995 995 996 -(% style="color:blue" %)**AT Command: 1036 +(% style="color:blue" %)**AT Command:AT+SNR** 997 997 998 998 (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %) 999 999 |=(% colspan="3" style="width: 568px;" %)AT+SNR ... ... @@ -1002,8 +1002,8 @@ 1002 1002 OK 1003 1003 ))) 1004 1004 1005 -(% style="display:none" %) (%%) 1006 1006 1046 + 1007 1007 == 7.17 Application Port == 1008 1008 1009 1009 ... ... @@ -1020,6 +1020,7 @@ 1020 1020 ))) 1021 1021 |(% style="width:157px" %)AT+PORT=21|(% style="width:204px" %)Set the application port|(% style="width:135px" %)OK 1022 1022 1063 + 1023 1023 (% style="color:blue" %)**Downlink Command: 0x23** 1024 1024 1025 1025 Format: Command Code (0x23) followed by 1 bytes port value. ... ... @@ -1029,8 +1029,8 @@ 1029 1029 * **Example 1**: Downlink Payload: **2301** ~/~/ set the application port to 1 1030 1030 * **Example 2**: Downlink Payload:** 2305** ~/~/ set the application port to 5 1031 1031 1032 -(% style="display:none" %) (%%) 1033 1033 1074 + 1034 1034 == 7.18 Single Channel Mode == 1035 1035 1036 1036 ... ... @@ -1047,11 +1047,10 @@ 1047 1047 ))) 1048 1048 |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK 1049 1049 1050 -(% style="display:none" %) (%%) 1051 1051 1092 + 1052 1052 == 7.19 Eight Channel Mode == 1053 1053 1054 - 1055 1055 Feature: Get or Set eight channels mode,Only for US915,AU915,CN470. 1056 1056 1057 1057 ... ... @@ -1067,8 +1067,9 @@ 1067 1067 ))) 1068 1068 |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK 1069 1069 1070 -(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)** 1071 1071 1111 +(% style="color:blue" %)**Downlink Command: 0x24** 1112 + 1072 1072 Format: Command Code (0x24) followed by 1 bytes channel value. 1073 1073 1074 1074 If the downlink payload=2401, it means set channel mode to 1, while type code is 24. ... ... @@ -1076,8 +1076,9 @@ 1076 1076 * **Example 1**: Downlink Payload: 2401 ~/~/ set channel mode to 1 1077 1077 * **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1078 1078 1079 -(% style="display:none" %) (%%) 1080 1080 1121 + 1122 + 1081 1081 == 7.20 Get or Set RXwindows1 timeout == 1082 1082 1083 1083 ... ... @@ -1094,19 +1094,23 @@ 1094 1094 ))) 1095 1095 |(% style="width:163px" %)AT+RX1WTO=60|(% style="width:201px" %)Set RXwindows1 timeout|(% style="width:93px" %)OK 1096 1096 1097 -(% style="display:none" %) (%%) 1098 - 1099 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. 1140 + 1141 + 1142 +**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. 1143 + 1144 + 1101 1101 ))) 1102 1102 1103 1103 [[image:image-20220526162535-1.png]] 1104 1104 1149 + 1105 1105 ((( 1106 1106 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. 1152 + 1153 + 1107 1107 ))) 1108 1108 1109 - 1110 1110 == 7.21 Get or Set RXwindows2 timeout == 1111 1111 1112 1112 ... ... @@ -1123,8 +1123,8 @@ 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" %) (%%) 1127 1127 1173 + 1128 1128 == 7.22 Setting up uplinkdwelltime (as923, au915) == 1129 1129 1130 1130 ... ... @@ -1141,6 +1141,7 @@ 1141 1141 ))) 1142 1142 |(% style="width:183px" %)AT+DWELLT=0|(% style="width:179px" %)Set uplinkdwelltime|(% style="width:131px" %)OK 1143 1143 1190 + 1144 1144 (% style="color:blue" %)**Downlink Command: 0x25** 1145 1145 1146 1146 Format: Command Code (0x25) followed by 1 bytes state value. ... ... @@ -1150,8 +1150,9 @@ 1150 1150 * **Example 1**: Downlink Payload: **2501** ~/~/ set uplinkdwelltime to 1 1151 1151 * **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1152 1152 1153 -(% style="display:none" %) (%%) 1154 1154 1201 + 1202 + 1155 1155 == 7.23 Set Packet Receiving Response Level == 1156 1156 1157 1157 ... ... @@ -1166,6 +1166,7 @@ 1166 1166 * **AT+RPL=3:** Device will immediately reply message to MAC Command. Payload is 0x00 and requied response header for this command. 1167 1167 * **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. 1168 1168 1217 + 1169 1169 **Case Analyes:** 1170 1170 1171 1171 * For Class A devices, AT+RPL=0 is ok. that is defaut settings in software. ... ... @@ -1172,6 +1172,7 @@ 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 1224 + 1175 1175 (% style="color:blue" %)**AT Command: AT+RPL** 1176 1176 1177 1177 (% border="1" style="background-color:#ffffcc; color:green; width:536.222px" %) ... ... @@ -1182,6 +1182,7 @@ 1182 1182 ))) 1183 1183 |(% style="width:160px" %)AT+RPL=0|(% style="width:263px" %)Set packet receiving response level|(% style="width:109px" %)OK 1184 1184 1235 + 1185 1185 (% style="color:blue" %)**Downlink Command: 0x21** 1186 1186 1187 1187 Format: Command Code (0x21) followed by 1 bytes level value. ... ... @@ -1191,8 +1191,9 @@ 1191 1191 * **Example 1**: Downlink Payload: **2101** ~/~/ set packet receiving response level to 1 1192 1192 * **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1193 1193 1194 -(% style="display:none" %) (%%) 1195 1195 1246 + 1247 + 1196 1196 == 7.24 Controls NBTrans in unconfirmed uplink mode(LWS007 NBTrans:Set retransmission packets) == 1197 1197 1198 1198 ... ... @@ -1214,6 +1214,7 @@ 1214 1214 OK 1215 1215 ))) 1216 1216 1269 + 1217 1217 (% style="color:blue" %)**Downlink Command: 0x33** 1218 1218 1219 1219 Format: Command Code (0x33) followed by 2 bytes mode value. ... ... @@ -1223,18 +1223,13 @@ 1223 1223 * Example 1: Downlink Payload: 330100 ~/~/ Set AT+SETMAXNBTRANS=1,0 1224 1224 * Example 2: Downlink Payload: 330201 ~/~/ Set AT+SETMAXNBTRANS=2,1 1225 1225 1226 -(% style="display:none" %) (%%) 1227 1227 1280 + 1228 1228 == 7.25 Device offline rejoining (LWS007) == 1229 1229 1230 1230 1231 1231 (% style="color:blue" %)**AT Command: AT+DDETECT** 1232 1232 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 - 1238 1238 (% border="1" style="background-color:#ffffcc; color:green; width:710.222px" %) 1239 1239 |=(% colspan="3" style="width: 707px;" %)AT+**DDETECT** 1240 1240 |(% style="width:160px" %)**Command Example**|(% style="width:198px" %)**Function**|(% style="width:349px" %)**Response** ... ... @@ -1266,20 +1266,17 @@ 1266 1266 OK 1267 1267 ))) 1268 1268 1269 -(% style="color:blue" %)**Downlink Command: 0x32** 1270 1270 1318 +(% style="color:blue" %)**Downlink Command: 0x33** 1319 + 1271 1271 Format: Command Code (0x32) followed by 2 bytes mode value. 1272 1272 1273 -If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 3 2.1322 +If the downlink payload=320105A00B40, it means set end node to use confirm mode, while type code is 33. 1274 1274 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. 1324 +* **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1280 1280 1281 -(% style="display:none" %) (%%) 1282 1282 1327 + 1283 1283 == 7.26 Request the server to send an ACK == 1284 1284 1285 1285 ... ... @@ -1293,11 +1293,12 @@ 1293 1293 ))) 1294 1294 |(% style="width:160px" %)**AT+PNACKMD=0**|(% style="width:263px" %)off request the server to send an ACK|(% style="width:109px" %)((( 1295 1295 0 1341 + 1296 1296 OK 1297 1297 ))) 1298 1298 1299 -(% style="display:none" %) (%%) 1300 1300 1346 + 1301 1301 == 7.27 Adjust network rejoining interval == 1302 1302 1303 1303 ... ... @@ -1306,15 +1306,16 @@ 1306 1306 (% border="1" style="background-color:#ffffcc; color:green; width:727.222px" %) 1307 1307 |=(% colspan="3" style="width: 724px;" %)AT+RJTDC 1308 1308 |(% style="width:165px" %)**Command Example**|(% style="width:227px" %)**Function**|(% style="width:329px" %)**Response** 1309 -|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30((( 1355 +|(% style="width:165px" %)AT+RJTDC=?|(% style="width:227px" %)Show the ReJoin data transmission interval in min|(% style="width:329px" %)30000((( 1310 1310 OK 1311 1311 1312 -the interval is 30 in1358 +the interval is 30000ms = 30s 1313 1313 ))) 1314 -|(% 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 in1360 +|(% style="width:165px" %)AT+RJTDC=60000|(% style="width:227px" %)Set the ReJoin data transmission interval in min|(% style="width:329px" %)OK((( 1361 +Set the ReJoin data transmission interval to 60000ms = 60 seconds 1316 1316 ))) 1317 1317 1364 + 1318 1318 (% style="color:blue" %)**Downlink Command: 0x26** 1319 1319 1320 1320 Format: Command Code (0x26) followed by 2 bytes mode value. ... ... @@ -1324,18 +1324,19 @@ 1324 1324 * **Example 1:** Downlink Payload: 26000A ~/~/ Set AT+RJTDC=10 1325 1325 * **Example 2: **Downlink Payload: 260002 ~/~/ Set AT+RJTDC=2 1326 1326 1327 -(% style="display:none" %) (%%) 1328 1328 1375 + 1329 1329 = 8. AT Commands Combination = 1330 1330 1378 + 1331 1331 == 8.1 Set a fix RX2DR for downlink window == 1332 1332 1333 1333 1334 -* (% style="color:blue" %)**AT+ADR=0 **(%%)**~-~->** Disable ADR first1335 -* (% style="color:blue" %)**AT+RX2DR=xxxx**(%%)**~-~->** Set xxxx to your wanted DataRate1382 +* **AT+ADR=0 ** **~-~->** Disable ADR first 1383 +* **AT+RX2DR=xxxx** **~-~->** Set xxxx to your wanted DataRate 1336 1336 1337 -(% style="display:none" %) (%%) 1338 1338 1386 + 1339 1339 == 8.2 Use Downlink Command to set a fix uplink DR == 1340 1340 1341 1341 ... ... @@ -1344,9 +1344,5 @@ 1344 1344 **Same as:** 1345 1345 1346 1346 * AT+ADR=0 [[Reference>>||anchor="H7.1AdaptiveDataRate"]] 1347 - 1348 1348 * AT+DR=5 [[Reference>>||anchor="H7.4DataRate"]] 1349 - 1350 1350 * AT+TXP=0 [[Reference>>||anchor="H7.14TransmitPower"]] 1351 - 1352 -