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,11 +9,12 @@ 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 19 ))) ... ... @@ -21,13 +21,14 @@ 21 21 = 2. How to use AT Commands or Downlink command = 22 22 23 23 24 -* **AT Command**:See Devices User Manual forhow to connect to devicevia USB TTL adapter and use. The user manual can be found in each product page of [[Dragino Official Website>>url:http://www.dragino.com/]]25 -* **LoRaWAN DownlinkCommand**: The gateway transfer downlink command in HEX format. This page shows theDownlinkCommandIn HEXformat.PleasenotesomeLoRaWANservers use base64 as downlink codeso user need to convert HEX to Base64 and use. Below are referencesfor how to use downlink command:25 +* For AT Command , See Devices User Manual for Device. The user manual can be found in each product page of [[Dragino Official Website>>url:http://www.dragino.com/]] 26 +* For LoRaWAN Downlink: The gateway transfer downlink command in HEX format. This page shows the HEX format downlink code for each command. but some servers use base64 as downlink code. Below are reference for how to use downlink command: 26 26 ** Use HEX format to send a downlink: [[TTN v3>>Notes for TTN]] 27 -** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]] , [[How to Convert>>http://wiki.dragino.com/xwiki/bin/view/Main/Notes%20for%20ChirpStack/#H4.1ConvertHEXtoBase64]]?28 +** Use Base64 format to send a downlink: [[Chirpstack>>Notes for ChirpStack]] 28 28 ** See use note for more serves [[Servers Note>>doc:Main.WebHome]](IoT LoRaWAN Server) 29 29 30 30 32 + 31 31 = 3. Support End Node and firmware version = 32 32 33 33 ... ... @@ -103,9 +103,9 @@ 103 103 ))) 104 104 105 105 106 - 107 107 = 4. System Management Commands = 108 108 110 + 109 109 == 4.1 Change Uplink Interval == 110 110 111 111 ... ... @@ -135,7 +135,7 @@ 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.140 +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,7 +142,6 @@ 142 142 * **Example 2**: Downlink Payload:** 0100003C** ~/~/ Set Transmit Interval (TDC) = 60 seconds 143 143 144 144 145 - 146 146 == 4.2 Reboot End Node == 147 147 148 148 ... ... @@ -177,6 +177,7 @@ 177 177 ((( 178 178 If the downlink payload=**04FF**, the end node will reboot. 179 179 181 + 180 180 181 181 ))) 182 182 ... ... @@ -216,6 +216,7 @@ 216 216 ))) 217 217 218 218 221 + 219 219 == 4.4 Show Firmware Version == 220 220 221 221 ... ... @@ -246,6 +246,7 @@ 246 246 ((( 247 247 248 248 252 + 249 249 **xx: Software Type:** 250 250 ))) 251 251 ... ... @@ -279,6 +279,7 @@ 279 279 firmware version: v1.1.0 ~-~-> 110 280 280 281 281 286 + 282 282 == 4.5 Show System Configure == 283 283 284 284 ... ... @@ -305,9 +305,9 @@ 305 305 ))) 306 306 307 307 308 - 309 309 = 5. Keys, IDs and EUIs management = 310 310 315 + 311 311 == 5.1 Application EUI == 312 312 313 313 ... ... @@ -325,7 +325,6 @@ 325 325 |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK 326 326 327 327 328 - 329 329 == 5.2 Application Key == 330 330 331 331 ... ... @@ -343,7 +343,6 @@ 343 343 |(% 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 344 344 345 345 346 - 347 347 == 5.3 Application Session Key == 348 348 349 349 ... ... @@ -363,7 +363,6 @@ 363 363 ))) 364 364 365 365 366 - 367 367 == 5.4 Device Address == 368 368 369 369 ... ... @@ -383,7 +383,6 @@ 383 383 |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK 384 384 385 385 386 - 387 387 == 5.5 Device EUI == 388 388 389 389 ... ... @@ -403,7 +403,6 @@ 403 403 ))) 404 404 405 405 406 - 407 407 == 5.6 Network ID == 408 408 409 409 ... ... @@ -421,7 +421,6 @@ 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 - 425 425 == 5.7 Network Session Key == 426 426 427 427 ... ... @@ -439,11 +439,12 @@ 439 439 |(% 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 440 440 441 441 442 - 443 443 = 6. Joining and sending date on LoRaWAN network = 444 444 443 + 445 445 == 6.1 Confirm Mode == 446 446 446 + 447 447 === 6.1.1 AT+CFM command before DR-LWS007 software stack === 448 448 449 449 ... ... @@ -535,7 +535,6 @@ 535 535 ))) 536 536 537 537 538 - 539 539 == 6.3 Join LoRa® Network == 540 540 541 541 ... ... @@ -554,7 +554,6 @@ 554 554 ))) 555 555 556 556 557 - 558 558 == 6.4 LoRa® Network Join Mode == 559 559 560 560 ... ... @@ -599,7 +599,6 @@ 599 599 ))) 600 600 601 601 602 - 603 603 == 6.6 Print Last Received Data in Raw Format == 604 604 605 605 ... ... @@ -616,7 +616,6 @@ 616 616 ))) 617 617 618 618 619 - 620 620 == 6.7 Print Last Received Data in Binary Format == 621 621 622 622 ... ... @@ -633,7 +633,6 @@ 633 633 ))) 634 634 635 635 636 - 637 637 == 6.8 Send Text Data == 638 638 639 639 ... ... @@ -654,7 +654,6 @@ 654 654 ))) 655 655 656 656 657 - 658 658 == 6.9 Send Hexadecimal Data == 659 659 660 660 ... ... @@ -663,11 +663,11 @@ 663 663 664 664 (% style="color:blue" %)**AT Command: AT+SENDB** 665 665 666 -(% border="1" style="background-color:#ffffcc; color:green; width:110 1px" %)667 -|=(% colspan="3" style="width: 1 098px;" %)AT+SENDB668 -|(% 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" %)OK670 -|(% 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(((660 +(% border="1" style="background-color:#ffffcc; color:green; width:1120.22px" %) 661 +|=(% colspan="3" style="width: 1117px;" %)AT+SENDB 662 +|(% style="width:257px" %)**Command Example**|(% style="width:406px" %)**Function**|(% style="width:453px" %)**Response** 663 +|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:406px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK 664 +|(% 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((( 671 671 AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 672 672 673 673 ... ... @@ -674,9 +674,9 @@ 674 674 ))) 675 675 676 676 677 - 678 678 = 7. LoRaWAN network management = 679 679 673 + 680 680 == 7.1 Adaptive Data Rate == 681 681 682 682 ... ... @@ -704,7 +704,6 @@ 704 704 * **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 705 705 706 706 707 - 708 708 == 7.2 LoRa® Class == 709 709 710 710 ... ... @@ -711,7 +711,7 @@ 711 711 Feature: Get or Set the Device Class(Currently only support class A, class C). 712 712 713 713 714 -(% style="color:blue" %)**AT Command: 707 +(% style="color:blue" %)**AT Command:AT+CLASS** 715 715 716 716 (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %) 717 717 |=(% colspan="3" style="width: 504px;" %)AT+CLASS ... ... @@ -724,14 +724,13 @@ 724 724 ))) 725 725 726 726 727 - 728 728 == 7.3 Duty Cycle Setting == 729 729 730 730 731 -Feature: Get or Set the ETSI Duty Cycle setting **- 0**=disable,**1**=enable - Only for testing.723 +Feature: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing. 732 732 733 733 734 -(% style="color:blue" %)**AT Command: 726 +(% style="color:blue" %)**AT Command:AT+DCS** 735 735 736 736 (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %) 737 737 |=(% colspan="3" style="width: 512px;" %)AT+DCS ... ... @@ -744,18 +744,12 @@ 744 744 ))) 745 745 746 746 747 - 748 748 == 7.4 Data Rate == 749 749 750 750 751 -Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) . 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 server 752 752 753 -(% style="color:red" %) 754 -**Notice:** 755 755 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 - 759 759 (% style="color:blue" %)**AT Command: AT+DR** 760 760 761 761 (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %) ... ... @@ -776,7 +776,6 @@ 776 776 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 777 777 778 778 779 - 780 780 == 7.5 Frame Counter Downlink == 781 781 782 782 ... ... @@ -783,7 +783,7 @@ 783 783 Feature: Get or Set the Frame Counter Downlink. 784 784 785 785 786 -(% style="color:blue" %)**AT Command: 771 +(% style="color:blue" %)**AT Command:AT+FCD** 787 787 788 788 (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %) 789 789 |=(% colspan="3" style="width: 690px;" %)AT+FCD ... ... @@ -796,13 +796,12 @@ 796 796 ))) 797 797 798 798 799 - 800 800 == 7.6 Frame Counter Uplink == 801 801 802 802 Feature: Get or Set the Frame Counter Uplink. 803 803 804 804 805 -(% style="color:blue" %)**AT Command: 789 +(% style="color:blue" %)**AT Command:AT+FCU** 806 806 807 807 (% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %) 808 808 |=(% colspan="3" style="width: 531px;" %)AT+FCU ... ... @@ -815,7 +815,6 @@ 815 815 ))) 816 816 817 817 818 - 819 819 == 7.7 Join Accept Delay1 == 820 820 821 821 ... ... @@ -822,7 +822,7 @@ 822 822 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms. 823 823 824 824 825 -(% style="color:blue" %)**AT Command: 808 +(% style="color:blue" %)**AT Command:AT+JN1DL** 826 826 827 827 (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %) 828 828 |=(% colspan="3" style="width: 534px;" %)AT+JN1DL ... ... @@ -835,14 +835,12 @@ 835 835 ))) 836 836 837 837 838 - 839 839 == 7.8 Join Accept Delay2 == 840 840 841 - 842 842 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms. 843 843 844 844 845 -(% style="color:blue" %)**AT Command: 826 +(% style="color:blue" %)**AT Command:AT+JN2DL** 846 846 847 847 (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %) 848 848 |=(% colspan="3" style="width: 535px;" %)AT+JN2DL ... ... @@ -855,7 +855,6 @@ 855 855 ))) 856 856 857 857 858 - 859 859 == 7.9 Public Network Mode == 860 860 861 861 ... ... @@ -864,7 +864,7 @@ 864 864 (% style="color:red" %)**Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network.** 865 865 866 866 867 -(% style="color:blue" %)**AT Command: 847 +(% style="color:blue" %)**AT Command:AT+PNM** 868 868 869 869 (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %) 870 870 |=(% colspan="3" style="width: 664px;" %)AT+PNM ... ... @@ -884,7 +884,6 @@ 884 884 |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %) 885 885 886 886 887 - 888 888 == 7.10 Receive Delay1 == 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 1 in ms 892 892 893 893 894 -(% style="color:blue" %)**AT Command: 873 +(% style="color:blue" %)**AT Command:AT+RX1DL** 895 895 896 896 (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %) 897 897 |=(% colspan="3" style="width: 405px;" %)AT+RX1DL ... ... @@ -904,7 +904,6 @@ 904 904 ))) 905 905 906 906 907 - 908 908 == 7.11 Receive Delay2 == 909 909 910 910 ... ... @@ -911,7 +911,7 @@ 911 911 Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms 912 912 913 913 914 -(% style="color:blue" %)**AT Command: 892 +(% style="color:blue" %)**AT Command:AT+RX2DL** 915 915 916 916 (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %) 917 917 |=(% colspan="3" style="width: 478px;" %)AT+RX2DL ... ... @@ -924,7 +924,6 @@ 924 924 ))) 925 925 926 926 927 - 928 928 == 7.12 Rx2 Window Data Rate == 929 929 930 930 ... ... @@ -931,7 +931,7 @@ 931 931 Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X) 932 932 933 933 934 -(% style="color:blue" %)**AT Command: 911 +(% style="color:blue" %)**AT Command:AT+RX2DR** 935 935 936 936 (% border="1" style="background-color:#ffffcc; color:green; width:525.222px" %) 937 937 |=(% colspan="3" style="width: 522px;" %)AT+RX2DR ... ... @@ -944,7 +944,6 @@ 944 944 ))) 945 945 946 946 947 - 948 948 == 7.13 Rx2 Window Frequency == 949 949 950 950 ... ... @@ -951,7 +951,7 @@ 951 951 Feature: Get or Set the Rx2 window frequency 952 952 953 953 954 -(% style="color:blue" %)**AT Command: 930 +(% style="color:blue" %)**AT Command:AT+RX2FQ** 955 955 956 956 (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %) 957 957 |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ ... ... @@ -964,16 +964,15 @@ 964 964 ))) 965 965 966 966 967 - 968 968 == 7.14 Transmit Power == 969 969 970 970 971 971 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. ) 972 972 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**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 974 974 975 975 976 -(% style="color:blue" %)**AT Command: 951 +(% style="color:blue" %)**AT Command:AT+TXP** 977 977 978 978 (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %) 979 979 |=(% colspan="3" style="width: 462px;" %)AT+TXP ... ... @@ -1010,7 +1010,6 @@ 1010 1010 ))) 1011 1011 1012 1012 1013 - 1014 1014 == 7.16 SNR of the Last Received Packet == 1015 1015 1016 1016 ... ... @@ -1017,7 +1017,7 @@ 1017 1017 Feature: Get the SNR of the last received packet 1018 1018 1019 1019 1020 -(% style="color:blue" %)**AT Command: 994 +(% style="color:blue" %)**AT Command:AT+SNR** 1021 1021 1022 1022 (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %) 1023 1023 |=(% colspan="3" style="width: 568px;" %)AT+SNR ... ... @@ -1027,7 +1027,6 @@ 1027 1027 ))) 1028 1028 1029 1029 1030 - 1031 1031 == 7.17 Application Port == 1032 1032 1033 1033 ... ... @@ -1072,7 +1072,6 @@ 1072 1072 |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK 1073 1073 1074 1074 1075 - 1076 1076 == 7.19 Eight Channel Mode == 1077 1077 1078 1078 ... ... @@ -1091,7 +1091,7 @@ 1091 1091 ))) 1092 1092 |(% style="width:160px" %)AT+CHE=1|(% style="width:198px" %)Set eight channels mode|(% style="width:349px" %)OK 1093 1093 1094 -(% style="color:blue" %)**Downlink Command: 0x24 (LHT65,LHT65N Downlink Command:0x07)**1066 +(% style="color:blue" %)**Downlink Command: 0x24** 1095 1095 1096 1096 Format: Command Code (0x24) followed by 1 bytes channel value. 1097 1097 ... ... @@ -1121,9 +1121,8 @@ 1121 1121 ((( 1122 1122 1123 1123 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. 1124 1124 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 - 1127 1127 1128 1128 ))) 1129 1129 ... ... @@ -1153,7 +1153,6 @@ 1153 1153 |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK 1154 1154 1155 1155 1156 - 1157 1157 == 7.22 Setting up uplinkdwelltime (as923, au915) == 1158 1158 1159 1159 ... ... @@ -1318,7 +1318,6 @@ 1318 1318 ))) 1319 1319 1320 1320 1321 - 1322 1322 == 7.27 Adjust network rejoining interval == 1323 1323 1324 1324 ... ... @@ -1349,11 +1349,12 @@ 1349 1349 1350 1350 = 8. AT Commands Combination = 1351 1351 1321 + 1352 1352 == 8.1 Set a fix RX2DR for downlink window == 1353 1353 1354 1354 1355 -* (% style="color:blue" %)**AT+ADR=0 **(%%)**~-~->** Disable ADR first1356 -* (% style="color:blue" %)**AT+RX2DR=xxxx**(%%)**~-~->** Set xxxx to your wanted DataRate1325 +* **AT+ADR=0 ** **~-~->** Disable ADR first 1326 +* **AT+RX2DR=xxxx** **~-~->** Set xxxx to your wanted DataRate 1357 1357 1358 1358 1359 1359