Skip to Content
Last modified by Xiaoling on 2025/04/23 15:57
From version 29.44
edited by Xiaoling
on 2022/06/02 09:15
Change comment: There is no comment for this version
To version 33.2
edited by Xiaoling
on 2022/06/02 09:54
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -743,7 +743,6 @@
743 743  
744 744  * (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
745 745  
746 -
747 747  === 3.5.1 Common Commands: ===
748 748  
749 749  They should be available for each of Dragino Sensors, such as: change uplink interval, reset device. For firmware v1.3, user can find what common commands it supports: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
... ... @@ -751,7 +751,6 @@
751 751  
752 752  === 3.5.2 Sensor related commands: ===
753 753  
754 -(% class="wikigeneratedid" %)
755 755  ==== ====
756 756  
757 757  ==== **Choose Device Type (RS485 or TTL)** ====
... ... @@ -760,9 +760,15 @@
760 760  
761 761  * **AT Command**
762 762  
761 +(% class="box infomessage" %)
762 +(((
763 763  **AT+MOD=1** ~/~/ Set to support RS485-MODBUS type sensors. User can connect multiply RS485 , Modbus sensors to the A / B pins.
764 +)))
764 764  
766 +(% class="box infomessage" %)
767 +(((
765 765  **AT+MOD=2** ~/~/ Set to support TTL Level sensors, User can connect one TTL Sensor to the TXD/RXD/GND pins.
769 +)))
766 766  
767 767  
768 768  * **Downlink Payload**
... ... @@ -777,7 +777,10 @@
777 777  
778 778  * **AT Command**
779 779  
780 -AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
784 +(% class="box infomessage" %)
785 +(((
786 +**AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
787 +)))
781 781  
782 782  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
783 783  
... ... @@ -793,20 +793,19 @@
793 793  * XX XX XX XX: RS485 command total NN bytes
794 794  * YY: How many bytes will be uplink from the return of this RS485 command, if YY=0, RS485-BL will execute the downlink command without uplink; if YY>0, RS485-BL will uplink total YY bytes from the output of this RS485 command
795 795  
796 -
797 797  **Example 1:**
798 798  
799 799  To connect a Modbus Alarm with below commands.
800 800  
801 -* The command to active alarm is: 0A 05 00 04 00 01 4C B0. Where 0A 05 00 04 00 01 is the Modbus command to read the register 00 40 where stored the DI status. The 4C B0 is the CRC-16/MODBUS which calculate manually.
807 +* The command to active alarm is: 0A 05 00 04 00 01 **4C B0**. Where 0A 05 00 04 00 01 is the Modbus command to read the register 00 40 where stored the DI status. The 4C B0 is the CRC-16/MODBUS which calculate manually.
802 802  
803 -* The command to deactivate alarm is: 0A 05 00 04 00 00 8D 70. Where 0A 05 00 04 00 00 is the Modbus command to read the register 00 40 where stored the DI status. The 8D 70 is the CRC-16/MODBUS which calculate manually.
809 +* The command to deactivate alarm is: 0A 05 00 04 00 00 **8D 70**. Where 0A 05 00 04 00 00 is the Modbus command to read the register 00 40 where stored the DI status. The 8D 70 is the CRC-16/MODBUS which calculate manually.
804 804  
805 805  So if user want to use downlink command to control to RS485 Alarm, he can use:
806 806  
807 -**A8 01 06 0A 05 00 04 00 01 00**: to activate the RS485 Alarm
813 +(% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
808 808  
809 -**A8 01 06 0A 05 00 04 00 00 00**: to deactivate the RS485 Alarm
815 +(% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
810 810  
811 811  A8 is type code and 01 means add CRC-16/MODBUS at the end, the 3^^rd^^ byte is 06, means the next 6 bytes are the command to be sent to the RS485 network, the final byte 00 means this command don’t need to acquire output.
812 812  
... ... @@ -815,48 +815,60 @@
815 815  
816 816  Check TTL Sensor return:
817 817  
818 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]]
824 +[[image:1654132684752-193.png]]
819 819  
820 820  
821 821  
828 +==== **Set Payload version** ====
822 822  
823 -==== Set Payload version ====
824 -
825 825  This is the first byte of the uplink payload. RS485-BL can connect to different sensors. User can set the PAYVER field to tell server how to decode the current payload.
826 826  
827 -* AT Command:
832 +* **AT Command:**
828 828  
829 -AT+PAYVER: Set PAYVER field = 1
834 +(% class="box infomessage" %)
835 +(((
836 +**AT+PAYVER: Set PAYVER field = 1**
837 +)))
830 830  
831 831  
832 -* Downlink Payload:
840 +* **Downlink Payload:**
833 833  
834 -0xAE 01   à Set PAYVER field =  0x01
842 +**0xAE 01**  ~-~-> Set PAYVER field =  0x01
835 835  
836 -0xAE 0F   à Set PAYVER field =  0x0F
844 +**0xAE 0F**   ~-~-> Set PAYVER field =  0x0F
837 837  
838 838  
839 -==== Set RS485 Sampling Commands ====
840 840  
848 +==== **Set RS485 Sampling Commands** ====
849 +
841 841  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
842 842  
843 -These three commands are used to configure how the RS485-BL polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>path:#polling_485]].
852 +These three commands are used to configure how the RS485-BL polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>||anchor="H3.3.3Configurereadcommandsforeachsampling"]].
844 844  
845 845  
846 -* AT Command:
855 +* **AT Command:**
847 847  
848 -AT+COMMANDx: Configure RS485 read command to sensor.
857 +(% class="box infomessage" %)
858 +(((
859 +**AT+COMMANDx: Configure RS485 read command to sensor.**
860 +)))
849 849  
850 -AT+DATACUTx: Configure how to handle return from RS485 devices.
862 +(% class="box infomessage" %)
863 +(((
864 +**AT+DATACUTx: Configure how to handle return from RS485 devices.**
865 +)))
851 851  
852 -AT+SEARCHx: Configure search command
867 +(% class="box infomessage" %)
868 +(((
869 +**AT+SEARCHx: Configure search command**
870 +)))
853 853  
854 854  
855 -* Downlink Payload:
873 +* **Downlink Payload:**
856 856  
857 -0xAF downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
875 +**0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
858 858  
859 -Note: if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
877 +(% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
860 860  
861 861  Format: AF MM NN LL XX XX XX XX YY
862 862  
... ... @@ -863,23 +863,23 @@
863 863  Where:
864 864  
865 865  * MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
866 -* NN: 0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
867 -* LL: The length of AT+COMMAND or AT+DATACUT command
884 +* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
885 +* LL:  The length of AT+COMMAND or AT+DATACUT command
868 868  * XX XX XX XX: AT+COMMAND or AT+DATACUT command
869 -* YY: If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-BL will execute an uplink after got this command.
887 +* YY:  If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-BL will execute an uplink after got this command.
870 870  
871 -Example:
889 +**Example:**
872 872  
873 -**AF 03 01 06 0A 05 00 04 00 01 00**: Same as AT+COMMAND3=0A 05 00 04 00 01,1
891 +(% style="color:#037691" %)**AF 03 01 06 0A 05 00 04 00 01 00**(%%): Same as AT+COMMAND3=0A 05 00 04 00 01,1
874 874  
875 -**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10**
893 +(% style="color:#037691" %)**AF 03 02 06**(% style="color:orange" %)** 10 **(% style="color:red" %)**01 **(% style="color:green" %)**05 06 09 0A**(% style="color:#037691" %)** 00**(%%): Same as AT+DATACUT3=(% style="color:orange" %)**16**(%%),(% style="color:red" %)**1**(%%),(% style="color:green" %)**5+6+9+10**
876 876  
877 -**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~10**
895 +(% style="color:#037691" %)**AF 03 02 06 **(% style="color:orange" %)**0B**(% style="color:red" %)** 02 **(% style="color:green" %)**05 07 08 0A **(% style="color:#037691" %)**00**(%%): Same as AT+DATACUT3=(% style="color:orange" %)**11**(%%),(% style="color:red" %)**2**(%%),(% style="color:green" %)**5~~7+8~~10**
878 878  
879 879  
880 -0xAB downlink command can be used for set AT+SEARCHx
898 +**0xAB** downlink command can be used for set AT+SEARCHx
881 881  
882 -Example: **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
900 +**Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
883 883  
884 884  * AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
885 885  * AB aa 02 03 xx xx xx 02 yy yy(03 means there are 3 bytes after 03, they are xx xx xx;02 means there are 2 bytes after 02, they are yy yy) so the commands
... ... @@ -887,145 +887,164 @@
887 887  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
888 888  
889 889  
890 -==== Fast command to handle MODBUS device ====
891 891  
909 +==== **Fast command to handle MODBUS device** ====
910 +
892 892  AT+MBFUN is valid since v1.3 firmware version. The command is for fast configure to read Modbus devices. It is only valid for the devices which follow the [[MODBUS-RTU protocol>>url:https://www.modbustools.com/modbus.html]].
893 893  
894 894  This command is valid since v1.3 firmware version
895 895  
896 896  
897 -AT+MBFUN has only two value:
916 +**AT+MBFUN has only two value:**
898 898  
899 -* AT+MBFUN=1: Enable Modbus reading. And get response base on the MODBUS return
918 +* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
900 900  
901 901  AT+MBFUN=1, device can auto read the Modbus function code: 01, 02, 03 or 04. AT+MBFUN has lower priority vs AT+DATACUT command. If AT+DATACUT command is configured, AT+MBFUN will be ignore.
902 902  
903 -* AT+MBFUN=0: Disable Modbus fast reading.
922 +* **AT+MBFUN=0**: Disable Modbus fast reading.
904 904  
905 -Example:
924 +**Example:**
906 906  
907 907  * AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
908 908  * AT+COMMAND1= 01 03 00 10 00 08,1 ~-~-> read slave address 01 , function code 03, start address 00 01, quantity of registers 00 08.
909 909  * AT+COMMAND2= 01 02 00 40 00 10,1 ~-~-> read slave address 01 , function code 02, start address 00 40, quantity of inputs 00 10.
910 910  
911 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
930 +[[image:1654133913295-597.png]]
912 912  
913 913  
914 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
933 +[[image:1654133954153-643.png]]
915 915  
916 916  
917 -* Downlink Commands:
936 +* **Downlink Commands:**
918 918  
919 -A9 aa -à Same as AT+MBFUN=aa
938 +**A9 aa** ~-~-> Same as AT+MBFUN=aa
920 920  
921 921  
922 -==== RS485 command timeout ====
923 923  
942 +==== **RS485 command timeout** ====
943 +
924 924  Some Modbus device has slow action to send replies. This command is used to configure the RS485-BL to use longer time to wait for their action.
925 925  
926 926  Default value: 0, range:  0 ~~ 5 seconds
927 927  
928 928  
929 -* AT Command:
949 +* **AT Command:**
930 930  
931 -AT+CMDDLaa=hex(bb cc)
951 +(% class="box infomessage" %)
952 +(((
953 +**AT+CMDDLaa=hex(bb cc)**
954 +)))
932 932  
933 -Example:
956 +**Example:**
934 934  
935 935  **AT+CMDDL1=1000** to send the open time to 1000ms
936 936  
937 937  
938 -* Downlink Payload:
961 +* **Downlink Payload:**
939 939  
940 940  0x AA aa bb cc
941 941  
942 942  Same as: AT+CMDDLaa=hex(bb cc)
943 943  
944 - Example:
967 + **Example:**
945 945  
946 - 0xAA 01 03 E8  à Same as **AT+CMDDL1=1000 ms**
969 + **0xAA 01 03 E8**  ~-~-> Same as **AT+CMDDL1=1000 ms**
947 947  
948 948  
949 -==== [[Uplink>>path:#downlink_A8]] payload mode ====
950 950  
973 +==== **Uplink payload mode** ====
974 +
951 951  Define to use one uplink or multiple uplinks for the sampling.
952 952  
953 -The use of this command please see: [[Compose Uplink payload>>path:#DataUP]]
977 +The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
954 954  
955 -* AT Command:
979 +* **AT Command:**
956 956  
957 -AT+DATAUP=0
981 +(% class="box infomessage" %)
982 +(((
983 +**AT+DATAUP=0**
984 +)))
958 958  
959 -AT+DATAUP=1
986 +(% class="box infomessage" %)
987 +(((
988 +**AT+DATAUP=1**
989 +)))
960 960  
961 961  
962 -* Downlink Payload:
992 +* **Downlink Payload:**
963 963  
964 -0xAD 00   à Same as AT+DATAUP=0
994 +**0xAD 00**  **~-~->** Same as AT+DATAUP=0
965 965  
966 -0xAD 01   à Same as AT+DATAUP=1
996 +**0xAD 01**  **~-~->** Same as AT+DATAUP=1
967 967  
968 968  
969 -==== Manually trigger an Uplink ====
970 970  
1000 +==== **Manually trigger an Uplink** ====
1001 +
971 971  Ask device to send an uplink immediately.
972 972  
973 -* Downlink Payload:
1004 +* **Downlink Payload:**
974 974  
975 -0x08 FF, RS485-BL will immediately send an uplink.
1006 +**0x08 FF**, RS485-BL will immediately send an uplink.
976 976  
977 977  
978 -==== Clear RS485 Command ====
979 979  
1010 +==== **Clear RS485 Command** ====
1011 +
980 980  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
981 981  
982 982  
983 -* AT Command:
1015 +* **AT Command:**
984 984  
985 -**AT+CMDEAR=mm,nn**   mm: start position of erase ,nn: stop position of erase
1017 +(% style="color:#037691" %)**AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
986 986  
987 -Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
988 -
989 989  Example screen shot after clear all RS485 commands. 
990 990  
991 991  
992 -
993 993  The uplink screen shot is:
994 994  
995 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
1024 +[[image:1654134704555-320.png]]
996 996  
997 997  
998 -* Downlink Payload:
1027 +* **Downlink Payload:**
999 999  
1000 -0x09 aa bb same as AT+CMDEAR=aa,bb
1029 +**0x09 aa bb** same as AT+CMDEAR=aa,bb
1001 1001  
1002 1002  
1003 -==== Set Serial Communication Parameters ====
1004 1004  
1033 +==== **Set Serial Communication Parameters** ====
1034 +
1005 1005  Set the Rs485 serial communication parameters:
1006 1006  
1007 -* AT Command:
1037 +* **AT Command:**
1008 1008  
1009 1009  Set Baud Rate:
1010 1010  
1011 -AT+BAUDR=9600    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1041 +(% class="box infomessage" %)
1042 +(((
1043 +**AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1044 +)))
1012 1012  
1046 +Set UART Parity
1013 1013  
1014 -Set UART parity
1048 +(% class="box infomessage" %)
1049 +(((
1050 +**AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1051 +)))
1015 1015  
1016 -AT+PARITY=0    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1017 -
1018 -
1019 1019  Set STOPBIT
1020 1020  
1021 -AT+STOPBIT=0    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1055 +(% class="box infomessage" %)
1056 +(((
1057 +**AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1058 +)))
1022 1022  
1023 1023  
1024 -* Downlink Payload:
1061 +* **Downlink Payload:**
1025 1025  
1026 -A7 01 aa bb: Same  AT+BAUDR=hex(aa bb)*100
1063 +**A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
1027 1027  
1028 -Example:
1065 +**Example:**
1029 1029  
1030 1030  * A7 01 00 60   same as AT+BAUDR=9600
1031 1031  * A7 01 04 80  same as AT+BAUDR=115200
... ... @@ -1035,8 +1035,9 @@
1035 1035  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1036 1036  
1037 1037  
1038 -==== Control output power duration ====
1039 1039  
1076 +==== **Control output power duration** ====
1077 +
1040 1040  User can set the output power duration before each sampling.
1041 1041  
1042 1042  * AT Command:
... ... @@ -1057,13 +1057,13 @@
1057 1057  
1058 1058  
1059 1059  
1060 -1.
1098 +1.
1061 1061  11. Buttons
1062 1062  
1063 1063  |**Button**|**Feature**
1064 1064  |**RST**|Reboot RS485-BL
1065 1065  
1066 -1.
1104 +1.
1067 1067  11. +3V3 Output
1068 1068  
1069 1069  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
... ... @@ -1081,7 +1081,7 @@
1081 1081  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1082 1082  
1083 1083  
1084 -1.
1122 +1.
1085 1085  11. +5V Output
1086 1086  
1087 1087  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
... ... @@ -1101,13 +1101,13 @@
1101 1101  
1102 1102  
1103 1103  
1104 -1.
1142 +1.
1105 1105  11. LEDs
1106 1106  
1107 1107  |**LEDs**|**Feature**
1108 1108  |**LED1**|Blink when device transmit a packet.
1109 1109  
1110 -1.
1148 +1.
1111 1111  11. Switch Jumper
1112 1112  
1113 1113  |**Switch Jumper**|**Feature**
... ... @@ -1153,7 +1153,7 @@
1153 1153  
1154 1154  
1155 1155  
1156 -1.
1194 +1.
1157 1157  11. Common AT Command Sequence
1158 1158  111. Multi-channel ABP mode (Use with SX1301/LG308)
1159 1159  
... ... @@ -1172,8 +1172,8 @@
1172 1172  
1173 1173  ATZ
1174 1174  
1175 -1.
1176 -11.
1213 +1.
1214 +11.
1177 1177  111. Single-channel ABP mode (Use with LG01/LG02)
1178 1178  
1179 1179  AT+FDR   Reset Parameters to Factory Default, Keys Reserve
... ... @@ -1248,7 +1248,7 @@
1248 1248  [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image035.png]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image036.png]]
1249 1249  
1250 1250  
1251 -1.
1289 +1.
1252 1252  11. How to change the LoRa Frequency Bands/Region?
1253 1253  
1254 1254  User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download.
... ... @@ -1255,7 +1255,7 @@
1255 1255  
1256 1256  
1257 1257  
1258 -1.
1296 +1.
1259 1259  11. How many RS485-Slave can RS485-BL connects?
1260 1260  
1261 1261  The RS485-BL can support max 32 RS485 devices. Each uplink command of RS485-BL can support max 16 different RS485 command. So RS485-BL can support max 16 RS485 devices pre-program in the device for uplink. For other devices no pre-program, user can use the [[downlink message (type code 0xA8) to poll their info>>path:#downlink_A8]].
... ... @@ -1272,7 +1272,7 @@
1272 1272  
1273 1273  
1274 1274  
1275 -1.
1313 +1.
1276 1276  11. Why I can’t join TTN V3 in US915 /AU915 bands?
1277 1277  
1278 1278  It might about the channels mapping. Please see for detail.
1654132684752-193.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +22.8 KB
Content
1654133913295-597.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +116.2 KB
Content
1654133954153-643.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +91.2 KB
Content
1654134704555-320.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +91.4 KB
Content