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,12 +9,11 @@ 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 20 20 ))) ... ... @@ -22,14 +22,13 @@ 22 22 = 2. How to use AT Commands or Downlink command = 23 23 24 24 25 -* 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/]]26 -* 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:24 +* **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/]] 25 +* **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: 27 27 ** Use HEX format to send a downlink: [[TTN v3>>Notes for TTN]] 28 -** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]] 27 +** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]], [[How to Convert>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.1ConvertHEXtoBase64]]? 29 29 ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server) 30 30 31 31 32 - 33 33 = 3. Support End Node and firmware version = 34 34 35 35 ... ... @@ -105,9 +105,9 @@ 105 105 ))) 106 106 107 107 106 + 108 108 = 4. System Management Commands = 109 109 110 - 111 111 == 4.1 Change Uplink Interval == 112 112 113 113 ... ... @@ -137,7 +137,7 @@ 137 137 ))) 138 138 139 139 ((( 140 -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. 141 141 ))) 142 142 143 143 * **Example 1**: Downlink Payload:** 0100001E** ~/~/ Set Transmit Interval (TDC) = 30 seconds ... ... @@ -144,6 +144,7 @@ 144 144 * **Example 2**: Downlink Payload:** 0100003C** ~/~/ Set Transmit Interval (TDC) = 60 seconds 145 145 146 146 145 + 147 147 == 4.2 Reboot End Node == 148 148 149 149 ... ... @@ -178,7 +178,6 @@ 178 178 ((( 179 179 If the downlink payload=**04FF**, the end node will reboot. 180 180 181 - 182 182 183 183 ))) 184 184 ... ... @@ -218,7 +218,6 @@ 218 218 ))) 219 219 220 220 221 - 222 222 == 4.4 Show Firmware Version == 223 223 224 224 ... ... @@ -249,7 +249,6 @@ 249 249 ((( 250 250 251 251 252 - 253 253 **xx: Software Type:** 254 254 ))) 255 255 ... ... @@ -283,7 +283,6 @@ 283 283 firmware version: v1.1.0 ~-~-> 110 284 284 285 285 286 - 287 287 == 4.5 Show System Configure == 288 288 289 289 ... ... @@ -310,9 +310,9 @@ 310 310 ))) 311 311 312 312 308 + 313 313 = 5. Keys, IDs and EUIs management = 314 314 315 - 316 316 == 5.1 Application EUI == 317 317 318 318 ... ... @@ -330,6 +330,7 @@ 330 330 |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK 331 331 332 332 328 + 333 333 == 5.2 Application Key == 334 334 335 335 ... ... @@ -347,6 +347,7 @@ 347 347 |(% 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 348 348 349 349 346 + 350 350 == 5.3 Application Session Key == 351 351 352 352 ... ... @@ -366,6 +366,7 @@ 366 366 ))) 367 367 368 368 366 + 369 369 == 5.4 Device Address == 370 370 371 371 ... ... @@ -385,6 +385,7 @@ 385 385 |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK 386 386 387 387 386 + 388 388 == 5.5 Device EUI == 389 389 390 390 ... ... @@ -404,6 +404,7 @@ 404 404 ))) 405 405 406 406 406 + 407 407 == 5.6 Network ID == 408 408 409 409 ... ... @@ -421,6 +421,7 @@ 421 421 |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK 422 422 423 423 424 + 424 424 == 5.7 Network Session Key == 425 425 426 426 ... ... @@ -438,12 +438,11 @@ 438 438 |(% 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 439 439 440 440 442 + 441 441 = 6. Joining and sending date on LoRaWAN network = 442 442 443 - 444 444 == 6.1 Confirm Mode == 445 445 446 - 447 447 === 6.1.1 AT+CFM command before DR-LWS007 software stack === 448 448 449 449 ... ... @@ -535,6 +535,7 @@ 535 535 ))) 536 536 537 537 538 + 538 538 == 6.3 Join LoRa® Network == 539 539 540 540 ... ... @@ -553,6 +553,7 @@ 553 553 ))) 554 554 555 555 557 + 556 556 == 6.4 LoRa® Network Join Mode == 557 557 558 558 ... ... @@ -597,6 +597,7 @@ 597 597 ))) 598 598 599 599 602 + 600 600 == 6.6 Print Last Received Data in Raw Format == 601 601 602 602 ... ... @@ -613,6 +613,7 @@ 613 613 ))) 614 614 615 615 619 + 616 616 == 6.7 Print Last Received Data in Binary Format == 617 617 618 618 ... ... @@ -629,6 +629,7 @@ 629 629 ))) 630 630 631 631 636 + 632 632 == 6.8 Send Text Data == 633 633 634 634 ... ... @@ -649,6 +649,7 @@ 649 649 ))) 650 650 651 651 657 + 652 652 == 6.9 Send Hexadecimal Data == 653 653 654 654 ... ... @@ -657,11 +657,11 @@ 657 657 658 658 (% style="color:blue" %)**AT Command: AT+SENDB** 659 659 660 -(% border="1" style="background-color:#ffffcc; color:green; width:11 20.22px" %)661 -|=(% colspan="3" style="width: 1 117px;" %)AT+SENDB662 -|(% style="width:257px" %)**Command Example**|(% style="width:4 06px" %)**Function**|(% style="width:453px" %)**Response**663 -|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:4 06px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK664 -|(% style="width:257px" %)AT+SENDB=abcdef0123456789|(% style="width:4 06px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)While Error in format, return(((666 +(% border="1" style="background-color:#ffffcc; color:green; width:1101px" %) 667 +|=(% colspan="3" style="width: 1098px;" %)AT+SENDB 668 +|(% style="width:257px" %)**Command Example**|(% style="width:394px" %)**Function**|(% style="width:446px" %)**Response** 669 +|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)OK 670 +|(% 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((( 665 665 AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 666 666 667 667 ... ... @@ -668,9 +668,9 @@ 668 668 ))) 669 669 670 670 677 + 671 671 = 7. LoRaWAN network management = 672 672 673 - 674 674 == 7.1 Adaptive Data Rate == 675 675 676 676 ... ... @@ -698,6 +698,7 @@ 698 698 * **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 699 699 700 700 707 + 701 701 == 7.2 LoRa® Class == 702 702 703 703 ... ... @@ -704,7 +704,7 @@ 704 704 Feature: Get or Set the Device Class(Currently only support class A, class C). 705 705 706 706 707 -(% style="color:blue" %)**AT Command:AT+CLASS** 714 +(% style="color:blue" %)**AT Command: AT+CLASS** 708 708 709 709 (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %) 710 710 |=(% colspan="3" style="width: 504px;" %)AT+CLASS ... ... @@ -717,13 +717,14 @@ 717 717 ))) 718 718 719 719 727 + 720 720 == 7.3 Duty Cycle Setting == 721 721 722 722 723 -Feature: Get or Set the ETSI Duty Cycle setting 731 +Feature: Get or Set the ETSI Duty Cycle setting** - 0**=disable, **1**=enable - Only for testing. 724 724 725 725 726 -(% style="color:blue" %)**AT Command:AT+DCS** 734 +(% style="color:blue" %)**AT Command: AT+DCS** 727 727 728 728 (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %) 729 729 |=(% colspan="3" style="width: 512px;" %)AT+DCS ... ... @@ -736,12 +736,18 @@ 736 736 ))) 737 737 738 738 747 + 739 739 == 7.4 Data Rate == 740 740 741 741 742 -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 server751 +Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) . 743 743 753 +(% style="color:red" %) 754 +**Notice:** 744 744 756 +* 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. 757 +* 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/]] 758 + 745 745 (% style="color:blue" %)**AT Command: AT+DR** 746 746 747 747 (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %) ... ... @@ -762,6 +762,7 @@ 762 762 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 763 763 764 764 779 + 765 765 == 7.5 Frame Counter Downlink == 766 766 767 767 ... ... @@ -768,7 +768,7 @@ 768 768 Feature: Get or Set the Frame Counter Downlink. 769 769 770 770 771 -(% style="color:blue" %)**AT Command:AT+FCD** 786 +(% style="color:blue" %)**AT Command: AT+FCD** 772 772 773 773 (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %) 774 774 |=(% colspan="3" style="width: 690px;" %)AT+FCD ... ... @@ -781,12 +781,13 @@ 781 781 ))) 782 782 783 783 799 + 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:AT+FCU** 805 +(% 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 ... ... @@ -799,6 +799,7 @@ 799 799 ))) 800 800 801 801 818 + 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:AT+JN1DL** 825 +(% 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 ... ... @@ -818,12 +818,14 @@ 818 818 ))) 819 819 820 820 838 + 821 821 == 7.8 Join Accept Delay2 == 822 822 841 + 823 823 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms. 824 824 825 825 826 -(% style="color:blue" %)**AT Command:AT+JN2DL** 845 +(% style="color:blue" %)**AT Command: AT+JN2DL** 827 827 828 828 (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %) 829 829 |=(% colspan="3" style="width: 535px;" %)AT+JN2DL ... ... @@ -836,6 +836,7 @@ 836 836 ))) 837 837 838 838 858 + 839 839 == 7.9 Public Network Mode == 840 840 841 841 ... ... @@ -844,7 +844,7 @@ 844 844 (% 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 845 846 846 847 -(% style="color:blue" %)**AT Command:AT+PNM** 867 +(% style="color:blue" %)**AT Command: AT+PNM** 848 848 849 849 (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %) 850 850 |=(% colspan="3" style="width: 664px;" %)AT+PNM ... ... @@ -864,6 +864,7 @@ 864 864 |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %) 865 865 866 866 887 + 867 867 == 7.10 Receive Delay1 == 868 868 869 869 ... ... @@ -870,7 +870,7 @@ 870 870 Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms 871 871 872 872 873 -(% style="color:blue" %)**AT Command:AT+RX1DL** 894 +(% style="color:blue" %)**AT Command: AT+RX1DL** 874 874 875 875 (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %) 876 876 |=(% colspan="3" style="width: 405px;" %)AT+RX1DL ... ... @@ -883,6 +883,7 @@ 883 883 ))) 884 884 885 885 907 + 886 886 == 7.11 Receive Delay2 == 887 887 888 888 ... ... @@ -889,7 +889,7 @@ 889 889 Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms 890 890 891 891 892 -(% style="color:blue" %)**AT Command:AT+RX2DL** 914 +(% style="color:blue" %)**AT Command: AT+RX2DL** 893 893 894 894 (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %) 895 895 |=(% colspan="3" style="width: 478px;" %)AT+RX2DL ... ... @@ -902,6 +902,7 @@ 902 902 ))) 903 903 904 904 927 + 905 905 == 7.12 Rx2 Window Data Rate == 906 906 907 907 ... ... @@ -908,7 +908,7 @@ 908 908 Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X) 909 909 910 910 911 -(% style="color:blue" %)**AT Command:AT+RX2DR** 934 +(% style="color:blue" %)**AT Command: AT+RX2DR** 912 912 913 913 (% border="1" style="background-color:#ffffcc; color:green; width:525.222px" %) 914 914 |=(% colspan="3" style="width: 522px;" %)AT+RX2DR ... ... @@ -921,6 +921,7 @@ 921 921 ))) 922 922 923 923 947 + 924 924 == 7.13 Rx2 Window Frequency == 925 925 926 926 ... ... @@ -927,7 +927,7 @@ 927 927 Feature: Get or Set the Rx2 window frequency 928 928 929 929 930 -(% style="color:blue" %)**AT Command:AT+RX2FQ** 954 +(% style="color:blue" %)**AT Command: AT+RX2FQ** 931 931 932 932 (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %) 933 933 |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ ... ... @@ -940,15 +940,16 @@ 940 940 ))) 941 941 942 942 967 + 943 943 == 7.14 Transmit Power == 944 944 945 945 946 946 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. ) 947 947 948 -Notice: Transmit Power might be changed by ADR from LoRaWAN server. So manually change TXP also remember to set AT+ADR=0 in sensor 973 +(% 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** 949 949 950 950 951 -(% style="color:blue" %)**AT Command:AT+TXP** 976 +(% style="color:blue" %)**AT Command: AT+TXP** 952 952 953 953 (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %) 954 954 |=(% colspan="3" style="width: 462px;" %)AT+TXP ... ... @@ -985,6 +985,7 @@ 985 985 ))) 986 986 987 987 1013 + 988 988 == 7.16 SNR of the Last Received Packet == 989 989 990 990 ... ... @@ -991,7 +991,7 @@ 991 991 Feature: Get the SNR of the last received packet 992 992 993 993 994 -(% style="color:blue" %)**AT Command:AT+SNR** 1020 +(% style="color:blue" %)**AT Command: AT+SNR** 995 995 996 996 (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %) 997 997 |=(% colspan="3" style="width: 568px;" %)AT+SNR ... ... @@ -1001,6 +1001,7 @@ 1001 1001 ))) 1002 1002 1003 1003 1030 + 1004 1004 == 7.17 Application Port == 1005 1005 1006 1006 ... ... @@ -1045,6 +1045,7 @@ 1045 1045 |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK 1046 1046 1047 1047 1075 + 1048 1048 == 7.19 Eight Channel Mode == 1049 1049 1050 1050 ... ... @@ -1063,7 +1063,7 @@ 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** 1094 +(% 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 ... ... @@ -1093,8 +1093,9 @@ 1093 1093 ((( 1094 1094 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 1097 1125 +(% 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. 1126 + 1098 1098 1099 1099 ))) 1100 1100 ... ... @@ -1124,6 +1124,7 @@ 1124 1124 |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK 1125 1125 1126 1126 1156 + 1127 1127 == 7.22 Setting up uplinkdwelltime (as923, au915) == 1128 1128 1129 1129 ... ... @@ -1288,6 +1288,7 @@ 1288 1288 ))) 1289 1289 1290 1290 1321 + 1291 1291 == 7.27 Adjust network rejoining interval == 1292 1292 1293 1293 ... ... @@ -1318,12 +1318,11 @@ 1318 1318 1319 1319 = 8. AT Commands Combination = 1320 1320 1321 - 1322 1322 == 8.1 Set a fix RX2DR for downlink window == 1323 1323 1324 1324 1325 -* **AT+ADR=0 ** **~-~->** Disable ADR first 1326 -* **AT+RX2DR=xxxx** 1355 +* (% style="color:blue" %)**AT+ADR=0 **(%%) **~-~->** Disable ADR first 1356 +* (% style="color:blue" %)**AT+RX2DR=xxxx** (%%) **~-~->** Set xxxx to your wanted DataRate 1327 1327 1328 1328 1329 1329