Last modified by kai on 2024/09/06 10:00
<
From version < 52.7 >
edited by Xiaoling
on 2022/08/12 16:47
To version < 55.1 >
edited by Edwin Chen
on 2022/10/16 07:43
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Edwin
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,10 @@
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 -
33 33  = 3. Support End Node and firmware version =
34 34  
35 35  
... ... @@ -105,11 +105,8 @@
105 105  )))
106 106  
107 107  
108 -
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.
138 +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
... ... @@ -146,9 +146,6 @@
146 146  * **Example 2**: Downlink Payload:** 0100003C**  ~/~/ Set Transmit Interval (TDC) = 60 seconds
147 147  
148 148  
149 -
150 -
151 -
152 152  == 4.2 Reboot End Node ==
153 153  
154 154  
... ... @@ -315,11 +315,8 @@
315 315  )))
316 316  
317 317  
318 -
319 -
320 320  = 5. Keys, IDs and EUIs management =
321 321  
322 -
323 323  == 5.1 Application EUI ==
324 324  
325 325  
... ... @@ -337,8 +337,6 @@
337 337  |(% style="width:305px" %)AT+APPEUI=00 b3 d5 7e f0 00 4d 34|(% style="width:186px" %)Set the Application EUI|(% style="width:191px" %)OK
338 338  
339 339  
340 -
341 -
342 342  == 5.2 Application Key ==
343 343  
344 344  
... ... @@ -356,8 +356,6 @@
356 356  |(% 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
357 357  
358 358  
359 -
360 -
361 361  == 5.3 Application Session Key ==
362 362  
363 363  
... ... @@ -377,8 +377,6 @@
377 377  )))
378 378  
379 379  
380 -
381 -
382 382  == 5.4 Device Address ==
383 383  
384 384  
... ... @@ -398,8 +398,6 @@
398 398  |(% style="width:192px" %)AT+DADDR=A8 40 41 FF|(% style="width:241px" %)Set the Application Session Key.|(% style="width:359px" %)OK
399 399  
400 400  
401 -
402 -
403 403  == 5.5 Device EUI ==
404 404  
405 405  
... ... @@ -419,8 +419,6 @@
419 419  )))
420 420  
421 421  
422 -
423 -
424 424  == 5.6 Network ID ==
425 425  
426 426  
... ... @@ -438,8 +438,6 @@
438 438  |(% style="width:191px" %)AT+NWKID=A8 40 41 FF|(% style="width:153px" %)Set the Network ID.|(% style="width:101px" %)OK
439 439  
440 440  
441 -
442 -
443 443  == 5.7 Network Session Key ==
444 444  
445 445  
... ... @@ -457,14 +457,10 @@
457 457  |(% 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
458 458  
459 459  
460 -
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,8 +492,6 @@
492 492  * **Example 2:** Downlink Payload: 0500  ~/~/ Set AT+CFM=0
493 493  
494 494  
495 -
496 -
497 497  === 6.1.2  AT+CFM command since DR-LWS007 software stack ===
498 498  
499 499  
... ... @@ -540,8 +540,6 @@
540 540  * **Example 2:** Downlink Payload: 05000700  ~/~/ Set AT+CFM=0,7,0
541 541  
542 542  
543 -
544 -
545 545  == 6.2 Confirm Status ==
546 546  
547 547  
... ... @@ -558,8 +558,6 @@
558 558  )))
559 559  
560 560  
561 -
562 -
563 563  == 6.3 Join LoRa® Network ==
564 564  
565 565  
... ... @@ -578,8 +578,6 @@
578 578  )))
579 579  
580 580  
581 -
582 -
583 583  == 6.4 LoRa® Network Join Mode ==
584 584  
585 585  
... ... @@ -607,8 +607,6 @@
607 607  * **Example 2:** Downlink Payload: **2001**  ~/~/ Set AT+NJM=1
608 608  
609 609  
610 -
611 -
612 612  == 6.5 LoRa® Network Join Status ==
613 613  
614 614  
... ... @@ -625,8 +625,6 @@
625 625  )))
626 626  
627 627  
628 -
629 -
630 630  == 6.6 Print Last Received Data in Raw Format ==
631 631  
632 632  
... ... @@ -643,8 +643,6 @@
643 643  )))
644 644  
645 645  
646 -
647 -
648 648  == 6.7 Print Last Received Data in Binary Format ==
649 649  
650 650  
... ... @@ -661,8 +661,6 @@
661 661  )))
662 662  
663 663  
664 -
665 -
666 666  == 6.8 Send Text Data ==
667 667  
668 668  
... ... @@ -683,8 +683,6 @@
683 683  )))
684 684  
685 685  
686 -
687 -
688 688  == 6.9 Send Hexadecimal Data ==
689 689  
690 690  
... ... @@ -693,11 +693,11 @@
693 693  
694 694  (% style="color:blue" %)**AT Command: AT+SENDB**
695 695  
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(((
652 +(% border="1" style="background-color:#ffffcc; color:green; width:1101px" %)
653 +|=(% colspan="3" style="width: 1098px;" %)AT+SENDB
654 +|(% style="width:257px" %)**Command Example**|(% style="width:394px" %)**Function**|(% style="width:446px" %)**Response**
655 +|(% style="width:257px" %)AT+SENDB=12:abcdef0123456789|(% style="width:394px" %)Send hexadecimal data along with the application port.|(% style="width:446px" %)OK
656 +|(% 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(((
701 701  AT_PARAM_ERROR AT_BUSY_ERROR/AT_NO_NETWORK_JOINED
702 702  
703 703  
... ... @@ -704,11 +704,8 @@
704 704  )))
705 705  
706 706  
707 -
708 -
709 709  = 7. LoRaWAN network management =
710 710  
711 -
712 712  == 7.1 Adaptive Data Rate ==
713 713  
714 714  
... ... @@ -736,9 +736,6 @@
736 736  * **Example 2**: Downlink Payload: **2200FFFF**  ~/~/ Set AT+ADR=0.
737 737  
738 738  
739 -
740 -
741 -
742 742  == 7.2 LoRa® Class ==
743 743  
744 744  
... ... @@ -745,7 +745,7 @@
745 745  Feature: Get or Set the Device Class(Currently only support class A, class C).
746 746  
747 747  
748 -(% style="color:blue" %)**AT Command:AT+CLASS**
698 +(% style="color:blue" %)**AT Command:  AT+CLASS**
749 749  
750 750  (% border="1" style="background-color:#ffffcc; color:green; width:507.222px" %)
751 751  |=(% colspan="3" style="width: 504px;" %)AT+CLASS
... ... @@ -758,15 +758,13 @@
758 758  )))
759 759  
760 760  
761 -
762 -
763 763  == 7.3 Duty Cycle Setting ==
764 764  
765 765  
766 -Feature: Get or Set the ETSI Duty Cycle setting - 0=disable, 1=enable - Only for testing.
714 +Feature: Get or Set the ETSI Duty Cycle setting** - 0**=disable, **1**=enable - Only for testing.
767 767  
768 768  
769 -(% style="color:blue" %)**AT Command:AT+DCS**
717 +(% style="color:blue" %)**AT Command:  AT+DCS**
770 770  
771 771  (% border="1" style="background-color:#ffffcc; color:green; width:515.222px" %)
772 772  |=(% colspan="3" style="width: 512px;" %)AT+DCS
... ... @@ -778,12 +778,19 @@
778 778  
779 779  )))
780 780  
729 +
781 781  == 7.4 Data Rate ==
782 782  
783 783  
784 -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
733 +Feature: Get or Set the Data Rate. (0-7 corresponding to DR_X) .
785 785  
735 +(% style="color:red" %)
736 +**Notice:**
786 786  
738 +* 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.
739 +* Data Rate specifies Spreading Factor. The mapping various in different frequency band. 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/]]
740 +
741 +
787 787  (% style="color:blue" %)**AT Command: AT+DR**
788 788  
789 789  (% border="1" style="background-color:#ffffcc; color:green; width:466.222px" %)
... ... @@ -803,6 +803,7 @@
803 803  * **Example 1**: Downlink Payload: **220001FF**  ~/~/ Set AT+DR=1.
804 804  * **Example 2**: Downlink Payload: **220000FF**  ~/~/ Set AT+DR=0.
805 805  
761 +
806 806  == 7.5 Frame Counter Downlink ==
807 807  
808 808  
... ... @@ -809,7 +809,7 @@
809 809  Feature: Get or Set the Frame Counter Downlink.
810 810  
811 811  
812 -(% style="color:blue" %)**AT Command:AT+FCD**
768 +(% style="color:blue" %)**AT Command:  AT+FCD**
813 813  
814 814  (% border="1" style="background-color:#ffffcc; color:green; width:693.222px" %)
815 815  |=(% colspan="3" style="width: 690px;" %)AT+FCD
... ... @@ -821,12 +821,13 @@
821 821  OK
822 822  )))
823 823  
780 +
824 824  == 7.6 Frame Counter Uplink ==
825 825  
826 826  Feature: Get or Set the Frame Counter Uplink.
827 827  
828 828  
829 -(% style="color:blue" %)**AT Command:AT+FCU**
786 +(% style="color:blue" %)**AT Command:  AT+FCU**
830 830  
831 831  (% border="1" style="background-color:#ffffcc; color:green; width:534.222px" %)
832 832  |=(% colspan="3" style="width: 531px;" %)AT+FCU
... ... @@ -838,6 +838,7 @@
838 838  
839 839  )))
840 840  
798 +
841 841  == 7.7 Join Accept Delay1 ==
842 842  
843 843  
... ... @@ -844,7 +844,7 @@
844 844  Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 1 in ms.
845 845  
846 846  
847 -(% style="color:blue" %)**AT Command:AT+JN1DL**
805 +(% style="color:blue" %)**AT Command:  AT+JN1DL**
848 848  
849 849  (% border="1" style="background-color:#ffffcc; color:green; width:537.222px" %)
850 850  |=(% colspan="3" style="width: 534px;" %)AT+JN1DL
... ... @@ -856,12 +856,14 @@
856 856  
857 857  )))
858 858  
817 +
859 859  == 7.8 Join Accept Delay2 ==
860 860  
820 +
861 861  Feature: Get or Set the Join Accept Delay between the end of the Tx and the Join Rx Window 2 in ms.
862 862  
863 863  
864 -(% style="color:blue" %)**AT Command:AT+JN2DL**
824 +(% style="color:blue" %)**AT Command:  AT+JN2DL**
865 865  
866 866  (% border="1" style="background-color:#ffffcc; color:green; width:538.222px" %)
867 867  |=(% colspan="3" style="width: 535px;" %)AT+JN2DL
... ... @@ -873,6 +873,7 @@
873 873  
874 874  )))
875 875  
836 +
876 876  == 7.9 Public Network Mode ==
877 877  
878 878  
... ... @@ -881,7 +881,7 @@
881 881  (% style="color:red" %)**Notice: If user build their own LoRaWAN server but still use syncword=0x34, this is still considered a public LoRaWAN network.**
882 882  
883 883  
884 -(% style="color:blue" %)**AT Command:AT+PNM**
845 +(% style="color:blue" %)**AT Command:  AT+PNM**
885 885  
886 886  (% border="1" style="background-color:#ffffcc; color:green; width:667.222px" %)
887 887  |=(% colspan="3" style="width: 664px;" %)AT+PNM
... ... @@ -900,6 +900,7 @@
900 900  )))
901 901  |(% style="width:166px" %)AT+PNM=0|(% style="width:225px" %)Set to use private network autoset syncword=0x12|(% style="width:272px" %)
902 902  
864 +
903 903  == 7.10 Receive Delay1 ==
904 904  
905 905  
... ... @@ -906,7 +906,7 @@
906 906  Feature: Get or Set the delay between the end of the Tx and the Rx Window 1 in ms
907 907  
908 908  
909 -(% style="color:blue" %)**AT Command:AT+RX1DL**
871 +(% style="color:blue" %)**AT Command: AT+RX1DL**
910 910  
911 911  (% border="1" style="background-color:#ffffcc; color:green; width:408.222px" %)
912 912  |=(% colspan="3" style="width: 405px;" %)AT+RX1DL
... ... @@ -918,6 +918,7 @@
918 918  
919 919  )))
920 920  
883 +
921 921  == 7.11 Receive Delay2 ==
922 922  
923 923  
... ... @@ -924,7 +924,7 @@
924 924  Feature: Get or Set the delay between the end of the Tx and the Rx Window 2 in ms
925 925  
926 926  
927 -(% style="color:blue" %)**AT Command:AT+RX2DL**
890 +(% style="color:blue" %)**AT Command: AT+RX2DL**
928 928  
929 929  (% border="1" style="background-color:#ffffcc; color:green; width:481.222px" %)
930 930  |=(% colspan="3" style="width: 478px;" %)AT+RX2DL
... ... @@ -936,6 +936,7 @@
936 936  
937 937  )))
938 938  
902 +
939 939  == 7.12 Rx2 Window Data Rate ==
940 940  
941 941  
... ... @@ -942,7 +942,7 @@
942 942  Feature: Get or Set the Rx2 window data rate (0-7 corresponding to DR_X)
943 943  
944 944  
945 -(% style="color:blue" %)**AT Command:AT+RX2DR**
909 +(% style="color:blue" %)**AT Command:  AT+RX2DR**
946 946  
947 947  (% border="1" style="background-color:#ffffcc; color:green; width:525.222px" %)
948 948  |=(% colspan="3" style="width: 522px;" %)AT+RX2DR
... ... @@ -954,6 +954,7 @@
954 954  
955 955  )))
956 956  
921 +
957 957  == 7.13 Rx2 Window Frequency ==
958 958  
959 959  
... ... @@ -960,7 +960,7 @@
960 960  Feature: Get or Set the Rx2 window frequency
961 961  
962 962  
963 -(% style="color:blue" %)**AT Command:AT+RX2FQ**
928 +(% style="color:blue" %)**AT Command:  AT+RX2FQ**
964 964  
965 965  (% border="1" style="background-color:#ffffcc; color:green; width:587.222px" %)
966 966  |=(% colspan="3" style="width: 584px;" %)AT+RX2FQ
... ... @@ -972,15 +972,16 @@
972 972  
973 973  )))
974 974  
940 +
975 975  == 7.14 Transmit Power ==
976 976  
977 977  
978 978  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. )
979 979  
980 -Notice: Transmit Power might be changed by ADR from LoRaWAN server. So manually change TXP also remember to set AT+ADR=0 in sensor
946 +(% 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**
981 981  
982 982  
983 -(% style="color:blue" %)**AT Command:AT+TXP**
949 +(% style="color:blue" %)**AT Command:  AT+TXP**
984 984  
985 985  (% border="1" style="background-color:#ffffcc; color:green; width:465.222px" %)
986 986  |=(% colspan="3" style="width: 462px;" %)AT+TXP
... ... @@ -1015,6 +1015,7 @@
1015 1015  OK
1016 1016  )))
1017 1017  
984 +
1018 1018  == 7.16 SNR of the Last Received Packet ==
1019 1019  
1020 1020  
... ... @@ -1021,7 +1021,7 @@
1021 1021  Feature: Get the SNR of the last received packet
1022 1022  
1023 1023  
1024 -(% style="color:blue" %)**AT Command:AT+SNR**
991 +(% style="color:blue" %)**AT Command:  AT+SNR**
1025 1025  
1026 1026  (% border="1" style="background-color:#ffffcc; color:green; width:571.222px" %)
1027 1027  |=(% colspan="3" style="width: 568px;" %)AT+SNR
... ... @@ -1030,6 +1030,7 @@
1030 1030  OK
1031 1031  )))
1032 1032  
1000 +
1033 1033  == 7.17 Application Port ==
1034 1034  
1035 1035  
... ... @@ -1072,6 +1072,7 @@
1072 1072  )))
1073 1073  |(% style="width:182px" %)AT+CHS=868100000|(% style="width:295px" %)Set Frequency for Single Channel Mode|(% style="width:122px" %)OK
1074 1074  
1043 +
1075 1075  == 7.19 Eight Channel Mode ==
1076 1076  
1077 1077  
... ... @@ -1119,8 +1119,9 @@
1119 1119  (((
1120 1120  
1121 1121  
1122 -**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.
1123 1123  
1092 +(% 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.
1093 +
1124 1124  
1125 1125  )))
1126 1126  
... ... @@ -1130,6 +1130,7 @@
1130 1130  (((
1131 1131  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.
1132 1132  
1103 +
1133 1133  
1134 1134  )))
1135 1135  
... ... @@ -1149,6 +1149,7 @@
1149 1149  )))
1150 1150  |(% style="width:190px" %)AT+RX2WTO=20|(% style="width:199px" %)Set RXwindows2 timeout|(% style="width:104px" %)OK
1151 1151  
1123 +
1152 1152  == 7.22 Setting up uplinkdwelltime (as923, au915) ==
1153 1153  
1154 1154  
... ... @@ -1308,6 +1308,7 @@
1308 1308  OK
1309 1309  )))
1310 1310  
1283 +
1311 1311  == 7.27 Adjust network rejoining interval ==
1312 1312  
1313 1313  
... ... @@ -1337,12 +1337,11 @@
1337 1337  
1338 1338  = 8. AT Commands Combination =
1339 1339  
1340 -
1341 1341  == 8.1 Set a fix RX2DR for downlink window ==
1342 1342  
1343 1343  
1344 -* **AT+ADR=0             ** **~-~->**  Disable ADR first
1345 -* **AT+RX2DR=xxxx**  **~-~->**  Set xxxx to your wanted DataRate
1316 +* (% style="color:blue" %)**AT+ADR=0             **(%%) **~-~->**  Disable ADR first
1317 +* (% style="color:blue" %)**AT+RX2DR=xxxx**   (%%) **~-~->**  Set xxxx to your wanted DataRate
1346 1346  
1347 1347  
1348 1348  == 8.2 Use Downlink Command to set a fix uplink DR ==

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0