Skip to Content
Last modified by Xiaoling on 2025/04/23 15:57
From version 40.55
edited by Xiaoling
on 2022/06/06 10:52
Change comment: There is no comment for this version
To version 41.34
edited by Xiaoling
on 2022/06/06 11:19
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -510,6 +510,10 @@
510 510  )))
511 511  
512 512  (((
513 +
514 +)))
515 +
516 +(((
513 513  **AT+SEARCHx**: This command defines how to handle the return from AT+COMMANDx.
514 514  )))
515 515  
... ... @@ -823,26 +823,8 @@
823 823  
824 824  == 3.4 Uplink Payload ==
825 825  
826 -(% border="1" style="background-color:#4f81bd; color:white; width:850px" %)
827 -|**Size(bytes)**|(% style="width:130px" %)**2**|(% style="width:93px" %)**1**|(% style="width:509px" %)**Length depends on the return from the commands**
828 -|Value|(% style="width:130px" %)(((
829 -(((
830 -Battery(mV)
831 -)))
830 +[[image:image-20220606105412-1.png]]
832 832  
833 -(((
834 -&
835 -)))
836 -
837 -(((
838 -Interrupt _Flag
839 -)))
840 -)))|(% style="width:93px" %)(((
841 -PAYLOAD_VER
842 -
843 -
844 -)))|(% style="width:509px" %)If the valid payload is too long and exceed the maximum support payload length in server, server will show payload not provided in the LoRaWAN server.
845 -
846 846  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
847 847  
848 848  (((
... ... @@ -886,7 +886,7 @@
886 886  )))
887 887  
888 888  (((
889 -**}**
875 +{{{}}}}
890 890  
891 891  
892 892  )))
... ... @@ -900,14 +900,24 @@
900 900  
901 901  == 3.5 Configure RS485-BL via AT or Downlink ==
902 902  
889 +(((
903 903  User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands
891 +)))
904 904  
893 +(((
905 905  There are two kinds of Commands:
895 +)))
906 906  
907 -* (% style="color:#4f81bd" %)**Common Commands**(%%): They should be available for each sensor, such as: change uplink interval, reset device. For firmware v1.3, user can find what common commands it supports: [[AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
897 +* (((
898 +(% style="color:#4f81bd" %)**Common Commands**(%%): They should be available for each sensor, such as: change uplink interval, reset device. For firmware v1.3, user can find what common commands it supports: [[AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
899 +)))
908 908  
909 -* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
901 +* (((
902 +(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
903 +)))
910 910  
905 +
906 +
911 911  === 3.5.1 Common Commands: ===
912 912  
913 913  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]]
... ... @@ -916,6 +916,7 @@
916 916  === 3.5.2 Sensor related commands: ===
917 917  
918 918  
915 +
919 919  ==== **Choose Device Type (RS485 or TTL)** ====
920 920  
921 921  RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
... ... @@ -939,57 +939,109 @@
939 939  
940 940  
941 941  
939 +
942 942  ==== **RS485 Debug Command (AT+CFGDEV)** ====
943 943  
942 +(((
944 944  This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
944 +)))
945 945  
946 -* **AT Command**
946 +* (((
947 +**AT Command**
948 +)))
947 947  
948 948  (% class="box infomessage" %)
949 949  (((
952 +(((
950 950  **AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
951 951  )))
955 +)))
952 952  
957 +(((
953 953  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
959 +)))
954 954  
961 +(((
962 +
963 +)))
955 955  
956 -* **Downlink Payload**
965 +* (((
966 +**Downlink Payload**
967 +)))
957 957  
969 +(((
958 958  Format: A8 MM NN XX XX XX XX YY
971 +)))
959 959  
973 +(((
960 960  Where:
975 +)))
961 961  
962 -* MM: 1: add CRC-16/MODBUS ; 0: no CRC
963 -* NN: The length of RS485 command
964 -* XX XX XX XX: RS485 command total NN bytes
965 -* 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
977 +* (((
978 +MM: 1: add CRC-16/MODBUS ; 0: no CRC
979 +)))
980 +* (((
981 +NN: The length of RS485 command
982 +)))
983 +* (((
984 +XX XX XX XX: RS485 command total NN bytes
985 +)))
986 +* (((
987 +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
988 +)))
966 966  
990 +(((
967 967  **Example 1:**
992 +)))
968 968  
994 +(((
969 969  To connect a Modbus Alarm with below commands.
996 +)))
970 970  
971 -* 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.
998 +* (((
999 +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.
1000 +)))
972 972  
973 -* 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.
1002 +* (((
1003 +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.
1004 +)))
974 974  
1006 +(((
975 975  So if user want to use downlink command to control to RS485 Alarm, he can use:
1008 +)))
976 976  
1010 +(((
977 977  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
1012 +)))
978 978  
1014 +(((
979 979  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
1016 +)))
980 980  
1018 +(((
981 981  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.
1020 +)))
982 982  
1022 +(((
1023 +
1024 +)))
983 983  
1026 +(((
984 984  **Example 2:**
1028 +)))
985 985  
1030 +(((
986 986  Check TTL Sensor return:
1032 +)))
987 987  
1034 +(((
988 988  [[image:1654132684752-193.png]]
1036 +)))
989 989  
990 990  
991 991  
992 992  
1041 +
993 993  ==== **Set Payload version** ====
994 994  
995 995  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.
... ... @@ -1010,67 +1010,128 @@
1010 1010  
1011 1011  
1012 1012  
1062 +
1013 1013  ==== **Set RS485 Sampling Commands** ====
1014 1014  
1065 +(((
1015 1015  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
1067 +)))
1016 1016  
1069 +(((
1017 1017  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"]].
1071 +)))
1018 1018  
1073 +(((
1074 +
1075 +)))
1019 1019  
1020 -* **AT Command:**
1077 +* (((
1078 +**AT Command:**
1079 +)))
1021 1021  
1022 1022  (% class="box infomessage" %)
1023 1023  (((
1083 +(((
1024 1024  **AT+COMMANDx: Configure RS485 read command to sensor.**
1025 1025  )))
1086 +)))
1026 1026  
1027 1027  (% class="box infomessage" %)
1028 1028  (((
1090 +(((
1029 1029  **AT+DATACUTx: Configure how to handle return from RS485 devices.**
1030 1030  )))
1093 +)))
1031 1031  
1032 1032  (% class="box infomessage" %)
1033 1033  (((
1097 +(((
1034 1034  **AT+SEARCHx: Configure search command**
1035 1035  )))
1100 +)))
1036 1036  
1102 +(((
1103 +
1104 +)))
1037 1037  
1038 -* **Downlink Payload:**
1106 +* (((
1107 +**Downlink Payload:**
1108 +)))
1039 1039  
1110 +(((
1040 1040  **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
1112 +)))
1041 1041  
1114 +(((
1042 1042  (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
1116 +)))
1043 1043  
1118 +(((
1044 1044  Format: AF MM NN LL XX XX XX XX YY
1120 +)))
1045 1045  
1122 +(((
1046 1046  Where:
1124 +)))
1047 1047  
1048 -* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
1049 -* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
1050 -* LL:  The length of AT+COMMAND or AT+DATACUT command
1051 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command
1052 -* 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.
1126 +* (((
1127 +MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
1128 +)))
1129 +* (((
1130 +NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
1131 +)))
1132 +* (((
1133 +LL:  The length of AT+COMMAND or AT+DATACUT command
1134 +)))
1135 +* (((
1136 +XX XX XX XX: AT+COMMAND or AT+DATACUT command
1137 +)))
1138 +* (((
1139 +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.
1140 +)))
1053 1053  
1142 +(((
1054 1054  **Example:**
1144 +)))
1055 1055  
1146 +(((
1056 1056  (% 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
1148 +)))
1057 1057  
1150 +(((
1058 1058  (% 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**
1152 +)))
1059 1059  
1154 +(((
1060 1060  (% 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**
1156 +)))
1061 1061  
1158 +(((
1159 +
1160 +)))
1062 1062  
1162 +(((
1063 1063  **0xAB** downlink command can be used for set AT+SEARCHx
1164 +)))
1064 1064  
1166 +(((
1065 1065  **Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
1168 +)))
1066 1066  
1067 -* AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
1068 -* 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
1170 +* (((
1171 +AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
1172 +)))
1173 +* (((
1174 +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
1175 +)))
1069 1069  
1177 +(((
1070 1070  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
1179 +)))
1071 1071  
1072 1072  
1073 1073  
1183 +
1074 1074  ==== **Fast command to handle MODBUS device** ====
1075 1075  
1076 1076  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]].
... ... @@ -1104,6 +1104,7 @@
1104 1104  
1105 1105  
1106 1106  
1217 +
1107 1107  ==== **RS485 command timeout** ====
1108 1108  
1109 1109  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.
... ... @@ -1135,6 +1135,7 @@
1135 1135  
1136 1136  
1137 1137  
1249 +
1138 1138  ==== **Uplink payload mode** ====
1139 1139  
1140 1140  Define to use one uplink or multiple uplinks for the sampling.
... ... @@ -1181,7 +1181,9 @@
1181 1181  
1182 1182  * **AT Command:**
1183 1183  
1296 +(((
1184 1184  (% 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
1298 +)))
1185 1185  
1186 1186  Example screen shot after clear all RS485 commands. 
1187 1187  
... ... @@ -1197,6 +1197,7 @@
1197 1197  
1198 1198  
1199 1199  
1314 +
1200 1200  ==== **Set Serial Communication Parameters** ====
1201 1201  
1202 1202  Set the Rs485 serial communication parameters:
... ... @@ -1240,6 +1240,7 @@
1240 1240  
1241 1241  
1242 1242  
1358 +
1243 1243  ==== **Control output power duration** ====
1244 1244  
1245 1245  User can set the output power duration before each sampling.
... ... @@ -1263,44 +1263,83 @@
1263 1263  
1264 1264  == 3.6 Buttons ==
1265 1265  
1266 -(% border="1" style="background-color:#ffffcc; color:green; width:233px" %)
1382 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:233px" %)
1267 1267  |=(% style="width: 89px;" %)**Button**|=(% style="width: 141px;" %)**Feature**
1268 1268  |(% style="width:89px" %)**RST**|(% style="width:141px" %)Reboot RS485-BL
1269 1269  
1386 +
1387 +
1270 1270  == 3.7 +3V3 Output ==
1271 1271  
1390 +(((
1272 1272  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
1392 +)))
1273 1273  
1394 +(((
1274 1274  The +3V3 output will be valid for every sampling. RS485-BL will enable +3V3 output before all sampling and disable the +3V3 after all sampling. 
1396 +)))
1275 1275  
1398 +(((
1276 1276  The +3V3 output time can be controlled by AT Command.
1400 +)))
1277 1277  
1402 +(((
1403 +
1404 +)))
1278 1278  
1406 +(((
1279 1279  (% style="color:#037691" %)**AT+3V3T=1000**
1408 +)))
1280 1280  
1410 +(((
1411 +
1412 +)))
1281 1281  
1414 +(((
1282 1282  Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors.
1416 +)))
1283 1283  
1418 +(((
1284 1284  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1420 +)))
1285 1285  
1286 1286  
1287 1287  == 3.8 +5V Output ==
1288 1288  
1425 +(((
1289 1289  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
1427 +)))
1290 1290  
1429 +(((
1291 1291  The +5V output will be valid for every sampling. RS485-BL will enable +5V output before all sampling and disable the +5v after all sampling. 
1431 +)))
1292 1292  
1433 +(((
1293 1293  The 5V output time can be controlled by AT Command.
1435 +)))
1294 1294  
1437 +(((
1438 +
1439 +)))
1295 1295  
1441 +(((
1296 1296  (% style="color:#037691" %)**AT+5VT=1000**
1443 +)))
1297 1297  
1445 +(((
1446 +
1447 +)))
1298 1298  
1449 +(((
1299 1299  Means set 5V valid time to have 1000ms. So, the real 5V output will actually have 1000ms + sampling time for other sensors.
1451 +)))
1300 1300  
1453 +(((
1301 1301  By default, the AT+5VT=0. If the external sensor which require 5v and require more time to get stable state, user can use this command to increase the power ON duration for this sensor.
1455 +)))
1302 1302  
1303 1303  
1458 +
1304 1304  == 3.9 LEDs ==
1305 1305  
1306 1306  (% border="1" style="background-color:#ffffcc; color:green; width:332px" %)
... ... @@ -1307,6 +1307,8 @@
1307 1307  |=**LEDs**|=(% style="width: 274px;" %)**Feature**
1308 1308  |**LED1**|(% style="width:274px" %)Blink when device transmit a packet.
1309 1309  
1465 +
1466 +
1310 1310  == 3.10 Switch Jumper ==
1311 1311  
1312 1312  (% border="1" style="background-color:#ffffcc; color:green; width:515px" %)
... ... @@ -1322,9 +1322,13 @@
1322 1322  3.3v position: set to compatible with 3.3v I/O.,
1323 1323  )))
1324 1324  
1482 +(((
1325 1325  **+3.3V**: is always ON
1484 +)))
1326 1326  
1486 +(((
1327 1327  **+5V**: Only open before every sampling. The time is by default, it is AT+5VT=0.  Max open time. 5000 ms.
1488 +)))
1328 1328  
1329 1329  
1330 1330  = 4. Case Study =
... ... @@ -1336,17 +1336,23 @@
1336 1336  
1337 1337  == 5.1 Access AT Command ==
1338 1338  
1500 +(((
1339 1339  RS485-BL supports AT Command set. User can use a USB to TTL adapter plus the 3.5mm Program Cable to connect to RS485-BL to use AT command, as below.
1502 +)))
1340 1340  
1341 1341  [[image:1654135840598-282.png]]
1342 1342  
1343 1343  
1507 +(((
1344 1344  In PC, User needs to set (% style="color:blue" %)**serial tool**(%%)(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to (% style="color:green" %)**9600**(%%) to access to access serial console of RS485-BL. The default password is 123456. Below is the output for reference:
1509 +)))
1345 1345  
1346 1346  [[image:1654136105500-922.png]]
1347 1347  
1348 1348  
1514 +(((
1349 1349  More detail AT Command manual can be found at [[AT Command Manual>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]]
1516 +)))
1350 1350  
1351 1351  
1352 1352  == 5.2 Common AT Command Sequence ==
... ... @@ -1371,7 +1371,9 @@
1371 1371  )))
1372 1372  
1373 1373  
1541 +(((
1374 1374  If device already joined network:
1543 +)))
1375 1375  
1376 1376  (% class="box infomessage" %)
1377 1377  (((
... ... @@ -1410,10 +1410,12 @@
1410 1410  
1411 1411  (% style="color:red" %)**Note:**
1412 1412  
1582 +(((
1413 1413  (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server.
1414 1414  2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
1415 1415  3. Make sure SF / bandwidth setting in LG01/LG02 match the settings of AT+DR. refer [[this link>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/&file=LoRaWAN%201.0.3%20Regional%20Parameters.xlsx]] to see what DR means.
1416 1416  4. The command AT+RX2FQ and AT+RX2DR is to let downlink work. to set the correct parameters, user can check the actually downlink parameters to be used. As below. Which shows the RX2FQ should use 868400000 and RX2DR should be 5
1587 +)))
1417 1417  
1418 1418  [[image:1654136435598-589.png]]
1419 1419  
... ... @@ -1422,13 +1422,23 @@
1422 1422  
1423 1423  == 6.1 How to upgrade the image? ==
1424 1424  
1596 +(((
1425 1425  The RS485-BL LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-BL to:
1598 +)))
1426 1426  
1427 -* Support new features
1428 -* For bug fix
1429 -* Change LoRaWAN bands.
1600 +* (((
1601 +Support new features
1602 +)))
1603 +* (((
1604 +For bug fix
1605 +)))
1606 +* (((
1607 +Change LoRaWAN bands.
1608 +)))
1430 1430  
1610 +(((
1431 1431  Below shows the hardware connection for how to upload an image to RS485-BL:
1612 +)))
1432 1432  
1433 1433  [[image:1654136646995-976.png]]
1434 1434  
... ... @@ -1494,6 +1494,8 @@
1494 1494  * (% style="color:blue" %)**RU864**(%%): frequency bands RU864
1495 1495  * (% style="color:blue" %)**KZ865**(%%): frequency bands KZ865
1496 1496  
1678 +
1679 +
1497 1497  = 9. Packing Info =
1498 1498  
1499 1499  (((
image-20220606105412-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +13.9 KB
Content