Last modified by Xiaoling on 2025/04/23 15:57

From version 41.9
edited by Xiaoling
on 2022/06/06 10:57
Change comment: There is no comment for this version
To version 44.12
edited by Xiaoling
on 2022/06/14 10:06
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,13 +1,9 @@
1 1  (% style="text-align:center" %)
2 -[[image:1652947681187-144.png||height="385" width="385"]]
2 +[[image:1652947681187-144.png||height="404" width="404"]]
3 3  
4 4  
5 5  
6 6  
7 -**RS485-BL – Waterproof RS485 to LoRaWAN Converter User Manual**
8 -
9 -
10 -
11 11  **Table of Contents:**
12 12  
13 13  {{toc/}}
... ... @@ -94,6 +94,8 @@
94 94  * 127 dB Dynamic Range RSSI.
95 95  * Automatic RF Sense and CAD with ultra-fast AFC. ​​​
96 96  
93 +
94 +
97 97  == 1.3 Features ==
98 98  
99 99  * LoRaWAN Class A & Class C protocol (default Class A)
... ... @@ -105,6 +105,8 @@
105 105  * Support Modbus protocol
106 106  * Support Interrupt uplink
107 107  
106 +
107 +
108 108  == 1.4 Applications ==
109 109  
110 110  * Smart Buildings & Home Automation
... ... @@ -114,6 +114,8 @@
114 114  * Smart Cities
115 115  * Smart Factory
116 116  
117 +
118 +
117 117  == 1.5 Firmware Change log ==
118 118  
119 119  [[RS485-BL Image files – Download link and Change log>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/RS485-BL/Firmware/||style="background-color: rgb(255, 255, 255);"]]
... ... @@ -197,6 +197,7 @@
197 197  
198 198  [[image:1652953414711-647.png||height="337" width="723"]]
199 199  
202 +
200 200  (((
201 201  The RS485-BL in this example connected to two RS485 devices for demonstration, user can connect to other RS485 devices via the same method.
202 202  )))
... ... @@ -206,7 +206,7 @@
206 206  )))
207 207  
208 208  (((
209 -**Step 1**: Create a device in TTN V3 with the OTAA keys from RS485-BL.
212 +(% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from RS485-BL.
210 210  )))
211 211  
212 212  (((
... ... @@ -215,12 +215,13 @@
215 215  
216 216  [[image:1652953462722-299.png]]
217 217  
221 +
218 218  (((
219 219  User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:
220 220  )))
221 221  
222 222  (((
223 -Add APP EUI in the application.
227 +**Add APP EUI in the application.**
224 224  )))
225 225  
226 226  
... ... @@ -232,17 +232,20 @@
232 232  
233 233  [[image:image-20220519174512-4.png]]
234 234  
239 +
235 235  You can also choose to create the device manually.
236 236  
237 237  [[image:1652953542269-423.png||height="710" width="723"]]
238 238  
244 +
239 239  Add APP KEY and DEV EUI
240 240  
241 241  [[image:1652953553383-907.png||height="514" width="724"]]
242 242  
243 243  
250 +
244 244  (((
245 -**Step 2**: Power on RS485-BL and it will auto join to the TTN V3 network. After join success, it will start to upload message to TTN V3 and user can see in the panel.
252 +(% style="color:blue" %)**Step 2**(%%): Power on RS485-BL and it will auto join to the TTN V3 network. After join success, it will start to upload message to TTN V3 and user can see in the panel.
246 246  )))
247 247  
248 248  [[image:1652953568895-172.png||height="232" width="724"]]
... ... @@ -283,28 +283,28 @@
283 283  )))
284 284  
285 285  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
286 -|=(% style="width: 120px;" %)(((
293 +|=(% style="width: 80px;" %)(((
287 287  (((
288 288  **AT Commands**
289 289  )))
290 -)))|=(% style="width: 190px;" %)(((
297 +)))|=(% style="width: 210px;" %)(((
291 291  (((
292 292  **Description**
293 293  )))
294 -)))|=(% style="width: 190px;" %)(((
301 +)))|=(% style="width: 210px;" %)(((
295 295  (((
296 296  **Example**
297 297  )))
298 298  )))
299 -|(% style="width:120px" %)(((
306 +|(% style="width:80px" %)(((
300 300  (((
301 301  AT+BAUDR
302 302  )))
303 -)))|(% style="width:190px" %)(((
310 +)))|(% style="width:210px" %)(((
304 304  (((
305 305  Set the baud rate (for RS485 connection). Default Value is: 9600.
306 306  )))
307 -)))|(% style="width:190px" %)(((
314 +)))|(% style="width:210px" %)(((
308 308  (((
309 309  (((
310 310  AT+BAUDR=9600
... ... @@ -317,11 +317,11 @@
317 317  )))
318 318  )))
319 319  )))
320 -|(% style="width:120px" %)(((
327 +|(% style="width:80px" %)(((
321 321  (((
322 322  AT+PARITY
323 323  )))
324 -)))|(% style="width:190px" %)(((
331 +)))|(% style="width:210px" %)(((
325 325  (((
326 326  (((
327 327  Set UART parity (for RS485 connection)
... ... @@ -333,7 +333,7 @@
333 333  Default Value is: no parity.
334 334  )))
335 335  )))
336 -)))|(% style="width:190px" %)(((
343 +)))|(% style="width:210px" %)(((
337 337  (((
338 338  (((
339 339  AT+PARITY=0
... ... @@ -346,11 +346,11 @@
346 346  )))
347 347  )))
348 348  )))
349 -|(% style="width:120px" %)(((
356 +|(% style="width:80px" %)(((
350 350  (((
351 351  AT+STOPBIT
352 352  )))
353 -)))|(% style="width:190px" %)(((
360 +)))|(% style="width:210px" %)(((
354 354  (((
355 355  (((
356 356  Set serial stopbit (for RS485 connection)
... ... @@ -362,7 +362,7 @@
362 362  Default Value is: 1bit.
363 363  )))
364 364  )))
365 -)))|(% style="width:190px" %)(((
372 +)))|(% style="width:210px" %)(((
366 366  (((
367 367  (((
368 368  AT+STOPBIT=0 for 1bit
... ... @@ -382,8 +382,6 @@
382 382  )))
383 383  )))
384 384  
385 -
386 -
387 387  === 3.3.2 Configure sensors ===
388 388  
389 389  (((
... ... @@ -395,14 +395,20 @@
395 395  )))
396 396  
397 397  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
398 -|=(% style="width: 120px;" %)**AT Commands**|=(% style="width: 190px;" %)**Description**|=(% style="width: 190px;" %)**Example**
399 -|AT+CFGDEV|(% style="width:120px" %)(((
403 +|=(% style="width: 80px;" %)**AT Commands**|=(% style="width: 210px;" %)**Description**|=(% style="width: 210px;" %)**Example**
404 +|AT+CFGDEV|(% style="width:80px" %)(((
405 +(((
400 400  This command is used to configure the RS485/TTL devices; they won’t be used during sampling.
407 +)))
401 401  
409 +(((
402 402  AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,
411 +)))
403 403  
413 +(((
404 404  mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
405 -)))|(% style="width:190px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
415 +)))
416 +)))|(% style="width:210px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
406 406  
407 407  Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>||anchor="HRS485DebugCommand28AT2BCFGDEV29"]].
408 408  
... ... @@ -510,6 +510,10 @@
510 510  )))
511 511  
512 512  (((
524 +
525 +)))
526 +
527 +(((
513 513  **AT+SEARCHx**: This command defines how to handle the return from AT+COMMANDx.
514 514  )))
515 515  
... ... @@ -882,16 +882,22 @@
882 882  
883 883  == 3.5 Configure RS485-BL via AT or Downlink ==
884 884  
900 +(((
885 885  User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands
902 +)))
886 886  
904 +(((
887 887  There are two kinds of Commands:
906 +)))
888 888  
889 -* (% 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]]
908 +* (((
909 +(% 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]]
910 +)))
890 890  
891 -* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
912 +* (((
913 +(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
914 +)))
892 892  
893 -
894 -
895 895  === 3.5.1 Common Commands: ===
896 896  
897 897  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]]
... ... @@ -927,51 +927,101 @@
927 927  
928 928  ==== **RS485 Debug Command (AT+CFGDEV)** ====
929 929  
951 +(((
930 930  This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
953 +)))
931 931  
932 -* **AT Command**
955 +* (((
956 +**AT Command**
957 +)))
933 933  
934 934  (% class="box infomessage" %)
935 935  (((
961 +(((
936 936  **AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
937 937  )))
964 +)))
938 938  
966 +(((
939 939  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
968 +)))
940 940  
970 +(((
971 +
972 +)))
941 941  
942 -* **Downlink Payload**
974 +* (((
975 +**Downlink Payload**
976 +)))
943 943  
978 +(((
944 944  Format: A8 MM NN XX XX XX XX YY
980 +)))
945 945  
982 +(((
946 946  Where:
984 +)))
947 947  
948 -* MM: 1: add CRC-16/MODBUS ; 0: no CRC
949 -* NN: The length of RS485 command
950 -* XX XX XX XX: RS485 command total NN bytes
951 -* 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
986 +* (((
987 +MM: 1: add CRC-16/MODBUS ; 0: no CRC
988 +)))
989 +* (((
990 +NN: The length of RS485 command
991 +)))
992 +* (((
993 +XX XX XX XX: RS485 command total NN bytes
994 +)))
995 +* (((
996 +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
997 +)))
952 952  
999 +(((
953 953  **Example 1:**
1001 +)))
954 954  
1003 +(((
955 955  To connect a Modbus Alarm with below commands.
1005 +)))
956 956  
957 -* 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.
1007 +* (((
1008 +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.
1009 +)))
958 958  
959 -* 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.
1011 +* (((
1012 +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.
1013 +)))
960 960  
1015 +(((
961 961  So if user want to use downlink command to control to RS485 Alarm, he can use:
1017 +)))
962 962  
1019 +(((
963 963  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
1021 +)))
964 964  
1023 +(((
965 965  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
1025 +)))
966 966  
1027 +(((
967 967  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.
1029 +)))
968 968  
1031 +(((
1032 +
1033 +)))
969 969  
1035 +(((
970 970  **Example 2:**
1037 +)))
971 971  
1039 +(((
972 972  Check TTL Sensor return:
1041 +)))
973 973  
1043 +(((
974 974  [[image:1654132684752-193.png]]
1045 +)))
975 975  
976 976  
977 977  
... ... @@ -1000,62 +1000,121 @@
1000 1000  
1001 1001  ==== **Set RS485 Sampling Commands** ====
1002 1002  
1074 +(((
1003 1003  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
1076 +)))
1004 1004  
1078 +(((
1005 1005  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"]].
1080 +)))
1006 1006  
1082 +(((
1083 +
1084 +)))
1007 1007  
1008 -* **AT Command:**
1086 +* (((
1087 +**AT Command:**
1088 +)))
1009 1009  
1010 1010  (% class="box infomessage" %)
1011 1011  (((
1092 +(((
1012 1012  **AT+COMMANDx: Configure RS485 read command to sensor.**
1013 1013  )))
1095 +)))
1014 1014  
1015 1015  (% class="box infomessage" %)
1016 1016  (((
1099 +(((
1017 1017  **AT+DATACUTx: Configure how to handle return from RS485 devices.**
1018 1018  )))
1102 +)))
1019 1019  
1020 1020  (% class="box infomessage" %)
1021 1021  (((
1106 +(((
1022 1022  **AT+SEARCHx: Configure search command**
1023 1023  )))
1109 +)))
1024 1024  
1111 +(((
1112 +
1113 +)))
1025 1025  
1026 -* **Downlink Payload:**
1115 +* (((
1116 +**Downlink Payload:**
1117 +)))
1027 1027  
1119 +(((
1028 1028  **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
1121 +)))
1029 1029  
1123 +(((
1030 1030  (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
1125 +)))
1031 1031  
1127 +(((
1032 1032  Format: AF MM NN LL XX XX XX XX YY
1129 +)))
1033 1033  
1131 +(((
1034 1034  Where:
1133 +)))
1035 1035  
1036 -* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
1037 -* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
1038 -* LL:  The length of AT+COMMAND or AT+DATACUT command
1039 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command
1040 -* 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.
1135 +* (((
1136 +MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
1137 +)))
1138 +* (((
1139 +NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
1140 +)))
1141 +* (((
1142 +LL:  The length of AT+COMMAND or AT+DATACUT command
1143 +)))
1144 +* (((
1145 +XX XX XX XX: AT+COMMAND or AT+DATACUT command
1146 +)))
1147 +* (((
1148 +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.
1149 +)))
1041 1041  
1151 +(((
1042 1042  **Example:**
1153 +)))
1043 1043  
1155 +(((
1044 1044  (% 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
1157 +)))
1045 1045  
1159 +(((
1046 1046  (% 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**
1161 +)))
1047 1047  
1163 +(((
1048 1048  (% 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**
1165 +)))
1049 1049  
1167 +(((
1168 +
1169 +)))
1050 1050  
1171 +(((
1051 1051  **0xAB** downlink command can be used for set AT+SEARCHx
1173 +)))
1052 1052  
1175 +(((
1053 1053  **Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
1177 +)))
1054 1054  
1055 -* AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
1056 -* 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
1179 +* (((
1180 +AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
1181 +)))
1182 +* (((
1183 +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
1184 +)))
1057 1057  
1186 +(((
1058 1058  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
1188 +)))
1059 1059  
1060 1060  
1061 1061  
... ... @@ -1062,24 +1062,47 @@
1062 1062  
1063 1063  ==== **Fast command to handle MODBUS device** ====
1064 1064  
1195 +(((
1065 1065  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]].
1197 +)))
1066 1066  
1199 +(((
1067 1067  This command is valid since v1.3 firmware version
1201 +)))
1068 1068  
1203 +(((
1204 +
1205 +)))
1069 1069  
1207 +(((
1070 1070  **AT+MBFUN has only two value:**
1209 +)))
1071 1071  
1072 -* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1211 +* (((
1212 +**AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1213 +)))
1073 1073  
1215 +(((
1074 1074  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.
1217 +)))
1075 1075  
1076 -* **AT+MBFUN=0**: Disable Modbus fast reading.
1219 +* (((
1220 +**AT+MBFUN=0**: Disable Modbus fast reading.
1221 +)))
1077 1077  
1223 +(((
1078 1078  **Example:**
1225 +)))
1079 1079  
1080 -* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
1081 -* 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.
1082 -* 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.
1227 +* (((
1228 +AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
1229 +)))
1230 +* (((
1231 +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.
1232 +)))
1233 +* (((
1234 +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.
1235 +)))
1083 1083  
1084 1084  [[image:1654133913295-597.png]]
1085 1085  
... ... @@ -1087,67 +1087,120 @@
1087 1087  [[image:1654133954153-643.png]]
1088 1088  
1089 1089  
1090 -* **Downlink Commands:**
1243 +* (((
1244 +**Downlink Commands:**
1245 +)))
1091 1091  
1247 +(((
1092 1092  **A9 aa** ~-~-> Same as AT+MBFUN=aa
1249 +)))
1093 1093  
1094 1094  
1095 1095  
1253 +
1096 1096  ==== **RS485 command timeout** ====
1097 1097  
1256 +(((
1098 1098  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.
1258 +)))
1099 1099  
1260 +(((
1100 1100  Default value: 0, range:  0 ~~ 5 seconds
1262 +)))
1101 1101  
1264 +(((
1265 +
1266 +)))
1102 1102  
1103 -* **AT Command:**
1268 +* (((
1269 +**AT Command:**
1270 +)))
1104 1104  
1105 1105  (% class="box infomessage" %)
1106 1106  (((
1274 +(((
1107 1107  **AT+CMDDLaa=hex(bb cc)**
1108 1108  )))
1277 +)))
1109 1109  
1279 +(((
1110 1110  **Example:**
1281 +)))
1111 1111  
1283 +(((
1112 1112  **AT+CMDDL1=1000** to send the open time to 1000ms
1285 +)))
1113 1113  
1287 +(((
1288 +
1289 +)))
1114 1114  
1115 -* **Downlink Payload:**
1291 +* (((
1292 +**Downlink Payload:**
1293 +)))
1116 1116  
1295 +(((
1117 1117  0x AA aa bb cc
1297 +)))
1118 1118  
1299 +(((
1119 1119  Same as: AT+CMDDLaa=hex(bb cc)
1301 +)))
1120 1120  
1303 +(((
1121 1121   **Example:**
1305 +)))
1122 1122  
1307 +(((
1123 1123   **0xAA 01 03 E8**  ~-~-> Same as **AT+CMDDL1=1000 ms**
1309 +)))
1124 1124  
1125 1125  
1126 1126  
1313 +
1127 1127  ==== **Uplink payload mode** ====
1128 1128  
1316 +(((
1129 1129  Define to use one uplink or multiple uplinks for the sampling.
1318 +)))
1130 1130  
1320 +(((
1131 1131  The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
1322 +)))
1132 1132  
1133 -* **AT Command:**
1324 +* (((
1325 +**AT Command:**
1326 +)))
1134 1134  
1135 1135  (% class="box infomessage" %)
1136 1136  (((
1330 +(((
1137 1137  **AT+DATAUP=0**
1138 1138  )))
1333 +)))
1139 1139  
1140 1140  (% class="box infomessage" %)
1141 1141  (((
1337 +(((
1142 1142  **AT+DATAUP=1**
1143 1143  )))
1340 +)))
1144 1144  
1342 +(((
1343 +
1344 +)))
1145 1145  
1146 -* **Downlink Payload:**
1346 +* (((
1347 +**Downlink Payload:**
1348 +)))
1147 1147  
1350 +(((
1148 1148  **0xAD 00**  **~-~->** Same as AT+DATAUP=0
1352 +)))
1149 1149  
1354 +(((
1150 1150  **0xAD 01**  **~-~->** Same as AT+DATAUP=1
1356 +)))
1151 1151  
1152 1152  
1153 1153  
... ... @@ -1165,131 +1165,229 @@
1165 1165  
1166 1166  ==== **Clear RS485 Command** ====
1167 1167  
1374 +(((
1168 1168  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
1376 +)))
1169 1169  
1378 +(((
1379 +
1380 +)))
1170 1170  
1171 -* **AT Command:**
1382 +* (((
1383 +**AT Command:**
1384 +)))
1172 1172  
1386 +(((
1173 1173  (% 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
1388 +)))
1174 1174  
1390 +(((
1175 1175  Example screen shot after clear all RS485 commands. 
1392 +)))
1176 1176  
1394 +(((
1395 +
1396 +)))
1177 1177  
1398 +(((
1178 1178  The uplink screen shot is:
1400 +)))
1179 1179  
1402 +(((
1180 1180  [[image:1654134704555-320.png]]
1404 +)))
1181 1181  
1406 +(((
1407 +
1408 +)))
1182 1182  
1183 -* **Downlink Payload:**
1410 +* (((
1411 +**Downlink Payload:**
1412 +)))
1184 1184  
1414 +(((
1185 1185  **0x09 aa bb** same as AT+CMDEAR=aa,bb
1416 +)))
1186 1186  
1187 1187  
1188 1188  
1420 +
1189 1189  ==== **Set Serial Communication Parameters** ====
1190 1190  
1423 +(((
1191 1191  Set the Rs485 serial communication parameters:
1425 +)))
1192 1192  
1193 -* **AT Command:**
1427 +* (((
1428 +**AT Command:**
1429 +)))
1194 1194  
1431 +(((
1195 1195  Set Baud Rate:
1433 +)))
1196 1196  
1197 1197  (% class="box infomessage" %)
1198 1198  (((
1437 +(((
1199 1199  **AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1200 -)))
1201 1201  
1202 1202  Set UART Parity
1203 -
1204 -(% class="box infomessage" %)
1205 -(((
1206 1206  **AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1207 -)))
1208 1208  
1209 1209  Set STOPBIT
1210 1210  
1211 -(% class="box infomessage" %)
1212 -(((
1213 1213  **AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1214 1214  )))
1447 +)))
1215 1215  
1216 1216  
1217 -* **Downlink Payload:**
1450 +* (((
1451 +**Downlink Payload:**
1452 +)))
1218 1218  
1454 +(((
1219 1219  **A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
1456 +)))
1220 1220  
1458 +(((
1221 1221  **Example:**
1460 +)))
1222 1222  
1223 -* A7 01 00 60   same as AT+BAUDR=9600
1224 -* A7 01 04 80  same as AT+BAUDR=115200
1462 +* (((
1463 +A7 01 00 60   same as AT+BAUDR=9600
1464 +)))
1465 +* (((
1466 +A7 01 04 80  same as AT+BAUDR=115200
1467 +)))
1225 1225  
1469 +(((
1226 1226  A7 02 aa: Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
1471 +)))
1227 1227  
1473 +(((
1228 1228  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1475 +)))
1229 1229  
1230 1230  
1231 1231  
1479 +
1232 1232  ==== **Control output power duration** ====
1233 1233  
1482 +(((
1234 1234  User can set the output power duration before each sampling.
1484 +)))
1235 1235  
1236 -* **AT Command:**
1486 +* (((
1487 +**AT Command:**
1488 +)))
1237 1237  
1490 +(((
1238 1238  **Example:**
1492 +)))
1239 1239  
1494 +(((
1240 1240  **AT+3V3T=1000**  ~/~/ 3V3 output power will open 1s before each sampling.
1496 +)))
1241 1241  
1498 +(((
1242 1242  **AT+5VT=1000**  ~/~/ +5V output power will open 1s before each sampling.
1500 +)))
1243 1243  
1502 +(((
1503 +
1504 +)))
1244 1244  
1245 -* **LoRaWAN Downlink Command:**
1506 +* (((
1507 +**LoRaWAN Downlink Command:**
1508 +)))
1246 1246  
1510 +(((
1247 1247  **07 01 aa bb**  Same as AT+5VT=(aa bb)
1512 +)))
1248 1248  
1514 +(((
1249 1249  **07 02 aa bb**  Same as AT+3V3T=(aa bb)
1516 +)))
1250 1250  
1251 1251  
1252 1252  
1253 1253  == 3.6 Buttons ==
1254 1254  
1255 -(% border="1" style="background-color:#ffffcc; color:green; width:233px" %)
1522 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:233px" %)
1256 1256  |=(% style="width: 89px;" %)**Button**|=(% style="width: 141px;" %)**Feature**
1257 1257  |(% style="width:89px" %)**RST**|(% style="width:141px" %)Reboot RS485-BL
1258 1258  
1259 1259  == 3.7 +3V3 Output ==
1260 1260  
1528 +(((
1261 1261  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
1530 +)))
1262 1262  
1532 +(((
1263 1263  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. 
1534 +)))
1264 1264  
1536 +(((
1265 1265  The +3V3 output time can be controlled by AT Command.
1538 +)))
1266 1266  
1540 +(((
1541 +
1542 +)))
1267 1267  
1544 +(((
1268 1268  (% style="color:#037691" %)**AT+3V3T=1000**
1546 +)))
1269 1269  
1548 +(((
1549 +
1550 +)))
1270 1270  
1552 +(((
1271 1271  Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors.
1554 +)))
1272 1272  
1556 +(((
1273 1273  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1558 +)))
1274 1274  
1275 1275  
1276 1276  == 3.8 +5V Output ==
1277 1277  
1563 +(((
1278 1278  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
1565 +)))
1279 1279  
1567 +(((
1280 1280  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. 
1569 +)))
1281 1281  
1571 +(((
1282 1282  The 5V output time can be controlled by AT Command.
1573 +)))
1283 1283  
1575 +(((
1576 +
1577 +)))
1284 1284  
1579 +(((
1285 1285  (% style="color:#037691" %)**AT+5VT=1000**
1581 +)))
1286 1286  
1583 +(((
1584 +
1585 +)))
1287 1287  
1587 +(((
1288 1288  Means set 5V valid time to have 1000ms. So, the real 5V output will actually have 1000ms + sampling time for other sensors.
1589 +)))
1289 1289  
1591 +(((
1290 1290  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.
1593 +)))
1291 1291  
1292 1292  
1596 +
1293 1293  == 3.9 LEDs ==
1294 1294  
1295 1295  (% border="1" style="background-color:#ffffcc; color:green; width:332px" %)
... ... @@ -1298,22 +1298,20 @@
1298 1298  
1299 1299  == 3.10 Switch Jumper ==
1300 1300  
1301 -(% border="1" style="background-color:#ffffcc; color:green; width:515px" %)
1302 -|=(% style="width: 124px;" %)**Switch Jumper**|=(% style="width: 388px;" %)**Feature**
1303 -|(% style="width:124px" %)**SW1**|(% style="width:388px" %)(((
1304 -ISP position: Upgrade firmware via UART
1305 -
1605 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:463px" %)
1606 +|=(% style="width: 123px;" %)**Switch Jumper**|=(% style="width: 336px;" %)**Feature**
1607 +|(% style="width:123px" %)**SW1**|(% style="width:336px" %)ISP position: Upgrade firmware via UART
1306 1306  Flash position: Configure device, check running status.
1307 -)))
1308 -|(% style="width:124px" %)**SW2**|(% style="width:388px" %)(((
1309 -5V position: set to compatible with 5v I/O.
1310 -
1609 +|(% style="width:123px" %)**SW2**|(% style="width:336px" %)5V position: set to compatible with 5v I/O.
1311 1311  3.3v position: set to compatible with 3.3v I/O.,
1312 -)))
1313 1313  
1612 +(((
1314 1314  **+3.3V**: is always ON
1614 +)))
1315 1315  
1616 +(((
1316 1316  **+5V**: Only open before every sampling. The time is by default, it is AT+5VT=0.  Max open time. 5000 ms.
1618 +)))
1317 1317  
1318 1318  
1319 1319  = 4. Case Study =
... ... @@ -1325,17 +1325,23 @@
1325 1325  
1326 1326  == 5.1 Access AT Command ==
1327 1327  
1630 +(((
1328 1328  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.
1632 +)))
1329 1329  
1330 1330  [[image:1654135840598-282.png]]
1331 1331  
1332 1332  
1637 +(((
1333 1333  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:
1639 +)))
1334 1334  
1335 1335  [[image:1654136105500-922.png]]
1336 1336  
1337 1337  
1644 +(((
1338 1338  More detail AT Command manual can be found at [[AT Command Manual>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]]
1646 +)))
1339 1339  
1340 1340  
1341 1341  == 5.2 Common AT Command Sequence ==
... ... @@ -1347,20 +1347,14 @@
1347 1347  (% class="box infomessage" %)
1348 1348  (((
1349 1349  **AT+FDR**
1350 -)))
1351 -
1352 -(% class="box infomessage" %)
1353 -(((
1354 1354  **AT+NJM=0**
1355 -)))
1356 -
1357 -(% class="box infomessage" %)
1358 -(((
1359 1359  **ATZ**
1360 1360  )))
1361 1361  
1362 1362  
1663 +(((
1363 1363  If device already joined network:
1665 +)))
1364 1364  
1365 1365  (% class="box infomessage" %)
1366 1366  (((
... ... @@ -1399,10 +1399,12 @@
1399 1399  
1400 1400  (% style="color:red" %)**Note:**
1401 1401  
1704 +(((
1402 1402  (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server.
1403 1403  2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
1404 1404  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.
1405 1405  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
1709 +)))
1406 1406  
1407 1407  [[image:1654136435598-589.png]]
1408 1408  
... ... @@ -1411,13 +1411,23 @@
1411 1411  
1412 1412  == 6.1 How to upgrade the image? ==
1413 1413  
1718 +(((
1414 1414  The RS485-BL LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-BL to:
1720 +)))
1415 1415  
1416 -* Support new features
1417 -* For bug fix
1418 -* Change LoRaWAN bands.
1722 +* (((
1723 +Support new features
1724 +)))
1725 +* (((
1726 +For bug fix
1727 +)))
1728 +* (((
1729 +Change LoRaWAN bands.
1730 +)))
1419 1419  
1732 +(((
1420 1420  Below shows the hardware connection for how to upload an image to RS485-BL:
1734 +)))
1421 1421  
1422 1422  [[image:1654136646995-976.png]]
1423 1423