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,8 +9,8 @@ 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.** ... ... @@ -25,11 +25,12 @@ 25 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 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: 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]] 28 +** 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 32 33 + 33 33 = 3. Support End Node and firmware version = 34 34 35 35 ... ... @@ -109,7 +109,6 @@ 109 109 110 110 = 4. System Management Commands = 111 111 112 - 113 113 == 4.1 Change Uplink Interval == 114 114 115 115 ... ... @@ -139,7 +139,7 @@ 139 139 ))) 140 140 141 141 ((( 142 -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. 143 143 ))) 144 144 145 145 * **Example 1**: Downlink Payload:** 0100001E** ~/~/ Set Transmit Interval (TDC) = 30 seconds ... ... @@ -148,7 +148,6 @@ 148 148 149 149 150 150 151 - 152 152 == 4.2 Reboot End Node == 153 153 154 154 ... ... @@ -319,7 +319,6 @@ 319 319 320 320 = 5. Keys, IDs and EUIs management = 321 321 322 - 323 323 == 5.1 Application EUI == 324 324 325 325 ... ... @@ -461,10 +461,8 @@ 461 461 462 462 = 6. Joining and sending date on LoRaWAN network = 463 463 464 - 465 465 == 6.1 Confirm Mode == 466 466 467 - 468 468 === 6.1.1 AT+CFM command before DR-LWS007 software stack === 469 469 470 470 ... ... @@ -492,6 +492,8 @@ 492 492 * **Example 2:** Downlink Payload: 0500 ~/~/ Set AT+CFM=0 493 493 494 494 491 + 492 + 495 495 === 6.1.2 AT+CFM command since DR-LWS007 software stack === 496 496 497 497 ... ... @@ -538,6 +538,8 @@ 538 538 * **Example 2:** Downlink Payload: 05000700 ~/~/ Set AT+CFM=0,7,0 539 539 540 540 539 + 540 + 541 541 == 6.2 Confirm Status == 542 542 543 543 ... ... @@ -553,6 +553,9 @@ 553 553 OK 554 554 ))) 555 555 556 + 557 + 558 + 556 556 == 6.3 Join LoRa® Network == 557 557 558 558 ... ... @@ -570,6 +570,9 @@ 570 570 While Error in format, return AT_BUSY_ERROR 571 571 ))) 572 572 576 + 577 + 578 + 573 573 == 6.4 LoRa® Network Join Mode == 574 574 575 575 ... ... @@ -597,6 +597,8 @@ 597 597 * **Example 2:** Downlink Payload: **2001** ~/~/ Set AT+NJM=1 598 598 599 599 606 + 607 + 600 600 == 6.5 LoRa® Network Join Status == 601 601 602 602 ... ... @@ -612,6 +612,9 @@ 612 612 OK 613 613 ))) 614 614 623 + 624 + 625 + 615 615 == 6.6 Print Last Received Data in Raw Format == 616 616 617 617 ... ... @@ -627,6 +627,9 @@ 627 627 OK 628 628 ))) 629 629 641 + 642 + 643 + 630 630 == 6.7 Print Last Received Data in Binary Format == 631 631 632 632 ... ... @@ -642,6 +642,9 @@ 642 642 OK 643 643 ))) 644 644 659 + 660 + 661 + 645 645 == 6.8 Send Text Data == 646 646 647 647 ... ... @@ -661,6 +661,9 @@ 661 661 662 662 ))) 663 663 681 + 682 + 683 + 664 664 == 6.9 Send Hexadecimal Data == 665 665 666 666 ... ... @@ -669,19 +669,21 @@ 669 669 670 670 (% style="color:blue" %)**AT Command: AT+SENDB** 671 671 672 -(% border="1" style="background-color:#ffffcc; color:green; width:11 20.22px" %)673 -|=(% colspan="3" style="width: 1 117px;" %)AT+SENDB674 -|(% style="width:257px" %)**Command Example**|(% style="width:4 06px" %)**Function**|(% style="width:453px" %)**Response**675 -|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:4 06px" %)Send hexadecimal data along with the application port.|(% style="width:453px" %)OK676 -|(% 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(((692 +(% border="1" style="background-color:#ffffcc; color:green; width:1101px" %) 693 +|=(% colspan="3" style="width: 1098px;" %)AT+SENDB 694 +|(% style="width:257px" %)**Command Example**|(% style="width:394px" %)**Function**|(% style="width:446px" %)**Response** 695 +|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)OK 696 +|(% 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((( 677 677 AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED 678 678 679 679 680 680 ))) 681 681 682 -= 7. LoRaWAN network management = 683 683 684 684 704 + 705 += 7. LoRaWAN network management = 706 + 685 685 == 7.1 Adaptive Data Rate == 686 686 687 687 ... ... @@ -708,6 +708,9 @@ 708 708 * **Example 1**: Downlink Payload: **2201** ~/~/ Set AT+ADR=1. 709 709 * **Example 2**: Downlink Payload: **2200FFFF** ~/~/ Set AT+ADR=0. 710 710 733 + 734 + 735 + 711 711 == 7.2 LoRa® Class == 712 712 713 713 ... ... @@ -714,7 +714,7 @@ 714 714 Feature: Get or Set the Device Class(Currently only support class A, class C). 715 715 716 716 717 -(% style="color:blue" %)**AT Command:AT+CLASS** 742 +(% style="color:blue" %)**AT Command: AT+CLASS** 718 718 719 719 (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %) 720 720 |=(% colspan="3" style="width: 504px;" %)AT+CLASS ... ... @@ -726,13 +726,16 @@ 726 726 727 727 ))) 728 728 754 + 755 + 756 + 729 729 == 7.3 Duty Cycle Setting == 730 730 731 731 732 -Feature: Get or Set the ETSI Duty Cycle setting 760 +Feature: Get or Set the ETSI Duty Cycle setting** - 0**=disable, **1**=enable - Only for testing. 733 733 734 734 735 -(% style="color:blue" %)**AT Command:AT+DCS** 763 +(% style="color:blue" %)**AT Command: AT+DCS** 736 736 737 737 (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %) 738 738 |=(% colspan="3" style="width: 512px;" %)AT+DCS ... ... @@ -744,6 +744,9 @@ 744 744 745 745 ))) 746 746 775 + 776 + 777 + 747 747 == 7.4 Data Rate == 748 748 749 749 ... ... @@ -769,6 +769,9 @@ 769 769 * **Example 1**: Downlink Payload: **220001FF** ~/~/ Set AT+DR=1. 770 770 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+DR=0. 771 771 803 + 804 + 805 + 772 772 == 7.5 Frame Counter Downlink == 773 773 774 774 ... ... @@ -775,7 +775,7 @@ 775 775 Feature: Get or Set the Frame Counter Downlink. 776 776 777 777 778 -(% style="color:blue" %)**AT Command:AT+FCD** 812 +(% style="color:blue" %)**AT Command: AT+FCD** 779 779 780 780 (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %) 781 781 |=(% colspan="3" style="width: 690px;" %)AT+FCD ... ... @@ -787,12 +787,15 @@ 787 787 OK 788 788 ))) 789 789 824 + 825 + 826 + 790 790 == 7.6 Frame Counter Uplink == 791 791 792 792 Feature: Get or Set the Frame Counter Uplink. 793 793 794 794 795 -(% style="color:blue" %)**AT Command:AT+FCU** 832 +(% style="color:blue" %)**AT Command: AT+FCU** 796 796 797 797 (% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %) 798 798 |=(% colspan="3" style="width: 531px;" %)AT+FCU ... ... @@ -804,6 +804,9 @@ 804 804 805 805 ))) 806 806 844 + 845 + 846 + 807 807 == 7.7 Join Accept Delay1 == 808 808 809 809 ... ... @@ -810,7 +810,7 @@ 810 810 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms. 811 811 812 812 813 -(% style="color:blue" %)**AT Command:AT+JN1DL** 853 +(% style="color:blue" %)**AT Command: AT+JN1DL** 814 814 815 815 (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %) 816 816 |=(% colspan="3" style="width: 534px;" %)AT+JN1DL ... ... @@ -822,12 +822,16 @@ 822 822 823 823 ))) 824 824 865 + 866 + 867 + 825 825 == 7.8 Join Accept Delay2 == 826 826 870 + 827 827 Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms. 828 828 829 829 830 -(% style="color:blue" %)**AT Command:AT+JN2DL** 874 +(% style="color:blue" %)**AT Command: AT+JN2DL** 831 831 832 832 (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %) 833 833 |=(% colspan="3" style="width: 535px;" %)AT+JN2DL ... ... @@ -839,6 +839,9 @@ 839 839 840 840 ))) 841 841 886 + 887 + 888 + 842 842 == 7.9 Public Network Mode == 843 843 844 844 ... ... @@ -847,7 +847,7 @@ 847 847 (% style="color:red" %)**Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network.** 848 848 849 849 850 -(% style="color:blue" %)**AT Command:AT+PNM** 897 +(% style="color:blue" %)**AT Command: AT+PNM** 851 851 852 852 (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %) 853 853 |=(% colspan="3" style="width: 664px;" %)AT+PNM ... ... @@ -866,6 +866,9 @@ 866 866 ))) 867 867 |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %) 868 868 916 + 917 + 918 + 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:AT+RX1DL** 925 +(% 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 ... ... @@ -884,6 +884,9 @@ 884 884 885 885 ))) 886 886 937 + 938 + 939 + 887 887 == 7.11 Receive Delay2 == 888 888 889 889 ... ... @@ -890,7 +890,7 @@ 890 890 Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms 891 891 892 892 893 -(% style="color:blue" %)**AT Command:AT+RX2DL** 946 +(% style="color:blue" %)**AT Command: AT+RX2DL** 894 894 895 895 (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %) 896 896 |=(% colspan="3" style="width: 478px;" %)AT+RX2DL ... ... @@ -902,6 +902,9 @@ 902 902 903 903 ))) 904 904 958 + 959 + 960 + 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** 967 +(% 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 ... ... @@ -920,6 +920,9 @@ 920 920 921 921 ))) 922 922 979 + 980 + 981 + 923 923 == 7.13 Rx2 Window Frequency == 924 924 925 925 ... ... @@ -926,7 +926,7 @@ 926 926 Feature: Get or Set the Rx2 window frequency 927 927 928 928 929 -(% style="color:blue" %)**AT Command:AT+RX2FQ** 988 +(% style="color:blue" %)**AT Command: AT+RX2FQ** 930 930 931 931 (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %) 932 932 |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ ... ... @@ -938,15 +938,18 @@ 938 938 939 939 ))) 940 940 1000 + 1001 + 1002 + 941 941 == 7.14 Transmit Power == 942 942 943 943 944 944 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. ) 945 945 946 -Notice: Transmit Power might be changed by ADR from LoRaWAN server. So manually change TXP also remember to set AT+ADR=0 in sensor 1008 +(% 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** 947 947 948 948 949 -(% style="color:blue" %)**AT Command:AT+TXP** 1011 +(% style="color:blue" %)**AT Command: AT+TXP** 950 950 951 951 (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %) 952 952 |=(% colspan="3" style="width: 462px;" %)AT+TXP ... ... @@ -966,6 +966,8 @@ 966 966 * **Example 2**: Downlink Payload: **220000FF** ~/~/ Set AT+TXP=0. 967 967 968 968 1031 + 1032 + 969 969 == 7.15 RSSI of the Last Received Packet == 970 970 971 971 ... ... @@ -981,6 +981,9 @@ 981 981 OK 982 982 ))) 983 983 1048 + 1049 + 1050 + 984 984 == 7.16 SNR of the Last Received Packet == 985 985 986 986 ... ... @@ -987,7 +987,7 @@ 987 987 Feature: Get the SNR of the last received packet 988 988 989 989 990 -(% style="color:blue" %)**AT Command:AT+SNR** 1057 +(% style="color:blue" %)**AT Command: AT+SNR** 991 991 992 992 (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %) 993 993 |=(% colspan="3" style="width: 568px;" %)AT+SNR ... ... @@ -996,6 +996,9 @@ 996 996 OK 997 997 ))) 998 998 1066 + 1067 + 1068 + 999 999 == 7.17 Application Port == 1000 1000 1001 1001 ... ... @@ -1022,6 +1022,8 @@ 1022 1022 * **Example 2**: Downlink Payload:** 2305** ~/~/ set the application port to 5 1023 1023 1024 1024 1095 + 1096 + 1025 1025 == 7.18 Single Channel Mode == 1026 1026 1027 1027 ... ... @@ -1038,6 +1038,9 @@ 1038 1038 ))) 1039 1039 |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK 1040 1040 1113 + 1114 + 1115 + 1041 1041 == 7.19 Eight Channel Mode == 1042 1042 1043 1043 ... ... @@ -1066,6 +1066,8 @@ 1066 1066 * **Example 2**: Downlink Payload: 2405 ~/~/ set channel mode to 5 1067 1067 1068 1068 1144 + 1145 + 1069 1069 == 7.20 Get or Set RXwindows1 timeout == 1070 1070 1071 1071 ... ... @@ -1085,8 +1085,9 @@ 1085 1085 ((( 1086 1086 1087 1087 1088 -**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. 1089 1089 1166 +(% 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. 1167 + 1090 1090 1091 1091 ))) 1092 1092 ... ... @@ -1096,6 +1096,7 @@ 1096 1096 ((( 1097 1097 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. 1098 1098 1177 + 1099 1099 1100 1100 ))) 1101 1101 ... ... @@ -1115,6 +1115,9 @@ 1115 1115 ))) 1116 1116 |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK 1117 1117 1197 + 1198 + 1199 + 1118 1118 == 7.22 Setting up uplinkdwelltime (as923, au915) == 1119 1119 1120 1120 ... ... @@ -1141,6 +1141,8 @@ 1141 1141 * **Example 2**: Downlink Payload: **2500** ~/~/ set uplinkdwelltime to 0 1142 1142 1143 1143 1226 + 1227 + 1144 1144 == 7.23 Set Packet Receiving Response Level == 1145 1145 1146 1146 ... ... @@ -1181,6 +1181,8 @@ 1181 1181 * **Example 2**: Downlink Payload: **2102** ~/~/ set packet receiving response level to 2 1182 1182 1183 1183 1268 + 1269 + 1184 1184 == 7.24 Controls NBTrans in unconfirmed uplink mode(LWS007 NBTrans:Set retransmission packets) == 1185 1185 1186 1186 ... ... @@ -1212,6 +1212,8 @@ 1212 1212 * Example 2: Downlink Payload: 330201 ~/~/ Set AT+SETMAXNBTRANS=2,1 1213 1213 1214 1214 1301 + 1302 + 1215 1215 == 7.25 Device offline rejoining (LWS007) == 1216 1216 1217 1217 ... ... @@ -1257,6 +1257,8 @@ 1257 1257 * **Example 1:** Downlink Payload: 320105A00B40 ~/~/ Set AT+DDETECT=1,1440,2880 1258 1258 1259 1259 1348 + 1349 + 1260 1260 == 7.26 Request the server to send an ACK == 1261 1261 1262 1262 ... ... @@ -1274,6 +1274,9 @@ 1274 1274 OK 1275 1275 ))) 1276 1276 1367 + 1368 + 1369 + 1277 1277 == 7.27 Adjust network rejoining interval == 1278 1278 1279 1279 ... ... @@ -1301,16 +1301,19 @@ 1301 1301 * **Example 2: **Downlink Payload: 260002 ~/~/ Set AT+RJTDC=2 1302 1302 1303 1303 1304 -= 8. AT Commands Combination = 1305 1305 1306 1306 1399 += 8. AT Commands Combination = 1400 + 1307 1307 == 8.1 Set a fix RX2DR for downlink window == 1308 1308 1309 1309 1310 -* **AT+ADR=0 ** **~-~->** Disable ADR first 1311 -* **AT+RX2DR=xxxx** 1404 +* (% style="color:blue" %)**AT+ADR=0 **(%%) **~-~->** Disable ADR first 1405 +* (% style="color:blue" %)**AT+RX2DR=xxxx** (%%) **~-~->** Set xxxx to your wanted DataRate 1312 1312 1313 1313 1408 + 1409 + 1314 1314 == 8.2 Use Downlink Command to set a fix uplink DR == 1315 1315 1316 1316