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 ... ... @@ -104,8 +104,10 @@ 104 104 105 105 106 106 109 + 107 107 = 4. System Management Commands = 108 108 112 + 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.142 +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 ... ... @@ -143,6 +143,8 @@ 143 143 144 144 145 145 150 + 151 + 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 186 + 180 180 181 181 ))) 182 182 ... ... @@ -216,6 +216,7 @@ 216 216 ))) 217 217 218 218 226 + 219 219 == 4.4 Show Firmware Version == 220 220 221 221 ... ... @@ -246,6 +246,7 @@ 246 246 ((( 247 247 248 248 257 + 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 291 + 282 282 == 4.5 Show System Configure == 283 283 284 284 ... ... @@ -306,8 +306,10 @@ 306 306 307 307 308 308 319 + 309 309 = 5. Keys, IDs and EUIs management = 310 310 322 + 311 311 == 5.1 Application EUI == 312 312 313 313 ... ... @@ -326,6 +326,7 @@ 326 326 327 327 328 328 341 + 329 329 == 5.2 Application Key == 330 330 331 331 ... ... @@ -344,6 +344,7 @@ 344 344 345 345 346 346 360 + 347 347 == 5.3 Application Session Key == 348 348 349 349 ... ... @@ -364,6 +364,7 @@ 364 364 365 365 366 366 381 + 367 367 == 5.4 Device Address == 368 368 369 369 ... ... @@ -384,6 +384,7 @@ 384 384 385 385 386 386 402 + 387 387 == 5.5 Device EUI == 388 388 389 389 ... ... @@ -404,6 +404,7 @@ 404 404 405 405 406 406 423 + 407 407 == 5.6 Network ID == 408 408 409 409 ... ... @@ -422,6 +422,7 @@ 422 422 423 423 424 424 442 + 425 425 == 5.7 Network Session Key == 426 426 427 427 ... ... @@ -440,10 +440,13 @@ 440 440 441 441 442 442 461 + 443 443 = 6. Joining and sending date on LoRaWAN network = 444 444 464 + 445 445 == 6.1 Confirm Mode == 446 446 467 + 447 447 === 6.1.1 AT+CFM command before DR-LWS007 software stack === 448 448 449 449 ... ... @@ -472,6 +472,7 @@ 472 472 473 473 474 474 496 + 475 475 === 6.1.2 AT+CFM command since DR-LWS007 software stack === 476 476 477 477 ... ... @@ -519,6 +519,7 @@ 519 519 520 520 521 521 544 + 522 522 == 6.2 Confirm Status == 523 523 524 524 ... ... @@ -536,6 +536,7 @@ 536 536 537 537 538 538 562 + 539 539 == 6.3 Join LoRa® Network == 540 540 541 541 ... ... @@ -555,6 +555,7 @@ 555 555 556 556 557 557 582 + 558 558 == 6.4 LoRa® Network Join Mode == 559 559 560 560 ... ... @@ -583,6 +583,7 @@ 583 583 584 584 585 585 611 + 586 586 == 6.5 LoRa® Network Join Status == 587 587 588 588 ... ... @@ -600,6 +600,7 @@ 600 600 601 601 602 602 629 + 603 603 == 6.6 Print Last Received Data in Raw Format == 604 604 605 605 ... ... @@ -617,6 +617,7 @@ 617 617 618 618 619 619 647 + 620 620 == 6.7 Print Last Received Data in Binary Format == 621 621 622 622 ... ... @@ -634,6 +634,7 @@ 634 634 635 635 636 636 665 + 637 637 == 6.8 Send Text Data == 638 638 639 639 ... ... @@ -655,6 +655,7 @@ 655 655 656 656 657 657 687 + 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(((696 +(% border="1" style="background-color:#ffffcc; color:green; width:1120.22px" %) 697 +|=(% colspan="3" style="width: 1117px;" %)AT+SENDB 698 +|(% style="width:257px" %)**Command Example**|(% style="width:406px" %)**Function**|(% style="width:453px" %)**Response** 699 +|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:406px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK 700 +|(% 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 ... ... @@ -675,8 +675,10 @@ 675 675 676 676 677 677 708 + 678 678 = 7. LoRaWAN network management = 679 679 711 + 680 680 == 7.1 Adaptive Data Rate == 681 681 682 682 ... ... @@ -705,6 +705,8 @@ 705 705 706 706 707 707 740 + 741 + 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: 748 +(% 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 ... ... @@ -725,13 +725,14 @@ 725 725 726 726 727 727 762 + 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.766 +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: 769 +(% 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 ... ... @@ -745,17 +745,13 @@ 745 745 746 746 747 747 783 + 748 748 == 7.4 Data Rate == 749 749 750 750 751 -Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) . 787 +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" %) ... ... @@ -777,6 +777,8 @@ 777 777 778 778 779 779 811 + 812 + 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: 819 +(% 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 ... ... @@ -797,12 +797,13 @@ 797 797 798 798 799 799 833 + 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: 839 +(% 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 ... ... @@ -816,6 +816,7 @@ 816 816 817 817 818 818 853 + 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: 860 +(% 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 ... ... @@ -836,13 +836,13 @@ 836 836 837 837 838 838 874 + 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: 880 +(% 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 ... ... @@ -856,6 +856,7 @@ 856 856 857 857 858 858 894 + 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: 903 +(% 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 ... ... @@ -885,6 +885,7 @@ 885 885 886 886 887 887 924 + 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: 931 +(% 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 ... ... @@ -905,6 +905,7 @@ 905 905 906 906 907 907 945 + 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: 952 +(% 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 ... ... @@ -925,6 +925,7 @@ 925 925 926 926 927 927 966 + 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: 973 +(% 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 ... ... @@ -945,6 +945,7 @@ 945 945 946 946 947 947 987 + 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: 994 +(% 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 ... ... @@ -963,17 +963,15 @@ 963 963 964 964 ))) 965 965 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**1011 +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: 1014 +(% 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 ... ... @@ -993,7 +993,6 @@ 993 993 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+TXP=0. 994 994 995 995 996 - 997 997 == 7.15 RSSI of the Last Received Packet == 998 998 999 999 ... ... @@ -1009,8 +1009,6 @@ 1009 1009 OK 1010 1010 ))) 1011 1011 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: 1055 +(% 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 ... ... @@ -1026,8 +1026,6 @@ 1026 1026 OK 1027 1027 ))) 1028 1028 1029 - 1030 - 1031 1031 == 7.17 Application Port == 1032 1032 1033 1033 ... ... @@ -1054,7 +1054,6 @@ 1054 1054 * **Example 2**: Downlink Payload:** 2305** ~/~/ set the application port to 5 1055 1055 1056 1056 1057 - 1058 1058 == 7.18 Single Channel Mode == 1059 1059 1060 1060 ... ... @@ -1071,8 +1071,6 @@ 1071 1071 ))) 1072 1072 |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK 1073 1073 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)**1124 +(% style="color:blue" %)**Downlink Command: 0x24** 1095 1095 1096 1096 Format: Command Code (0x24) followed by 1 bytes channel value. 1097 1097 ... ... @@ -1101,7 +1101,6 @@ 1101 1101 * **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1102 1102 1103 1103 1104 - 1105 1105 == 7.20 Get or Set RXwindows1 timeout == 1106 1106 1107 1107 ... ... @@ -1121,9 +1121,8 @@ 1121 1121 ((( 1122 1122 1123 1123 1153 +**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 ... ... @@ -1152,8 +1152,6 @@ 1152 1152 ))) 1153 1153 |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK 1154 1154 1155 - 1156 - 1157 1157 == 7.22 Setting up uplinkdwelltime (as923, au915) == 1158 1158 1159 1159 ... ... @@ -1180,7 +1180,6 @@ 1180 1180 * **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1181 1181 1182 1182 1183 - 1184 1184 == 7.23 Set Packet Receiving Response Level == 1185 1185 1186 1186 ... ... @@ -1221,7 +1221,6 @@ 1221 1221 * **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1222 1222 1223 1223 1224 - 1225 1225 == 7.24 Controls NBTrans in unconfirmed uplink mode(LWS007 NBTrans:Set retransmission packets) == 1226 1226 1227 1227 ... ... @@ -1253,7 +1253,6 @@ 1253 1253 * Example 2: Downlink Payload: 330201 ~/~/ Set AT+SETMAXNBTRANS=2,1 1254 1254 1255 1255 1256 - 1257 1257 == 7.25 Device offline rejoining (LWS007) == 1258 1258 1259 1259 ... ... @@ -1299,7 +1299,6 @@ 1299 1299 * **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1300 1300 1301 1301 1302 - 1303 1303 == 7.26 Request the server to send an ACK == 1304 1304 1305 1305 ... ... @@ -1317,8 +1317,6 @@ 1317 1317 OK 1318 1318 ))) 1319 1319 1320 - 1321 - 1322 1322 == 7.27 Adjust network rejoining interval == 1323 1323 1324 1324 ... ... @@ -1346,17 +1346,16 @@ 1346 1346 * **Example 2: **Downlink Payload: 260002 ~/~/ Set AT+RJTDC=2 1347 1347 1348 1348 1349 - 1350 1350 = 8. AT Commands Combination = 1351 1351 1371 + 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 DataRate1375 +* **AT+ADR=0 ** **~-~->** Disable ADR first 1376 +* **AT+RX2DR=xxxx** **~-~->** Set xxxx to your wanted DataRate 1357 1357 1358 1358 1359 - 1360 1360 == 8.2 Use Downlink Command to set a fix uplink DR == 1361 1361 1362 1362