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

From version 41.33
edited by Xiaoling
on 2022/06/06 11:18
Change comment: There is no comment for this version
To version 42.5
edited by Xiaoling
on 2022/06/06 13:41
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -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;" %)(((
286 +|=(% style="width: 80px;" %)(((
287 287  (((
288 288  **AT Commands**
289 289  )))
290 -)))|=(% style="width: 190px;" %)(((
290 +)))|=(% style="width: 210px;" %)(((
291 291  (((
292 292  **Description**
293 293  )))
294 -)))|=(% style="width: 190px;" %)(((
294 +)))|=(% style="width: 210px;" %)(((
295 295  (((
296 296  **Example**
297 297  )))
298 298  )))
299 -|(% style="width:120px" %)(((
299 +|(% style="width:80px" %)(((
300 300  (((
301 301  AT+BAUDR
302 302  )))
303 -)))|(% style="width:190px" %)(((
303 +)))|(% style="width:210px" %)(((
304 304  (((
305 305  Set the baud rate (for RS485 connection). Default Value is: 9600.
306 306  )))
307 -)))|(% style="width:190px" %)(((
307 +)))|(% 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" %)(((
320 +|(% style="width:80px" %)(((
321 321  (((
322 322  AT+PARITY
323 323  )))
324 -)))|(% style="width:190px" %)(((
324 +)))|(% 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" %)(((
336 +)))|(% 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" %)(((
349 +|(% style="width:80px" %)(((
350 350  (((
351 351  AT+STOPBIT
352 352  )))
353 -)))|(% style="width:190px" %)(((
353 +)))|(% 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" %)(((
365 +)))|(% 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,14 @@
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" %)(((
396 +|=(% style="width: 80px;" %)**AT Commands**|=(% style="width: 210px;" %)**Description**|=(% style="width: 210px;" %)**Example**
397 +|AT+CFGDEV|(% style="width:80px" %)(((
400 400  This command is used to configure the RS485/TTL devices; they won’t be used during sampling.
401 401  
402 402  AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,
403 403  
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
403 +)))|(% 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  
... ... @@ -872,7 +872,7 @@
872 872  )))
873 873  
874 874  (((
875 -{{{}}}}
873 +}
876 876  
877 877  
878 878  )))
... ... @@ -902,8 +902,6 @@
902 902  (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
903 903  )))
904 904  
905 -
906 -
907 907  === 3.5.1 Common Commands: ===
908 908  
909 909  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]]
... ... @@ -1062,62 +1062,121 @@
1062 1062  
1063 1063  ==== **Set RS485 Sampling Commands** ====
1064 1064  
1061 +(((
1065 1065  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
1063 +)))
1066 1066  
1065 +(((
1067 1067  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"]].
1067 +)))
1068 1068  
1069 +(((
1070 +
1071 +)))
1069 1069  
1070 -* **AT Command:**
1073 +* (((
1074 +**AT Command:**
1075 +)))
1071 1071  
1072 1072  (% class="box infomessage" %)
1073 1073  (((
1079 +(((
1074 1074  **AT+COMMANDx: Configure RS485 read command to sensor.**
1075 1075  )))
1082 +)))
1076 1076  
1077 1077  (% class="box infomessage" %)
1078 1078  (((
1086 +(((
1079 1079  **AT+DATACUTx: Configure how to handle return from RS485 devices.**
1080 1080  )))
1089 +)))
1081 1081  
1082 1082  (% class="box infomessage" %)
1083 1083  (((
1093 +(((
1084 1084  **AT+SEARCHx: Configure search command**
1085 1085  )))
1096 +)))
1086 1086  
1098 +(((
1099 +
1100 +)))
1087 1087  
1088 -* **Downlink Payload:**
1102 +* (((
1103 +**Downlink Payload:**
1104 +)))
1089 1089  
1106 +(((
1090 1090  **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
1108 +)))
1091 1091  
1110 +(((
1092 1092  (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
1112 +)))
1093 1093  
1114 +(((
1094 1094  Format: AF MM NN LL XX XX XX XX YY
1116 +)))
1095 1095  
1118 +(((
1096 1096  Where:
1120 +)))
1097 1097  
1098 -* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
1099 -* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
1100 -* LL:  The length of AT+COMMAND or AT+DATACUT command
1101 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command
1102 -* 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.
1122 +* (((
1123 +MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
1124 +)))
1125 +* (((
1126 +NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
1127 +)))
1128 +* (((
1129 +LL:  The length of AT+COMMAND or AT+DATACUT command
1130 +)))
1131 +* (((
1132 +XX XX XX XX: AT+COMMAND or AT+DATACUT command
1133 +)))
1134 +* (((
1135 +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.
1136 +)))
1103 1103  
1138 +(((
1104 1104  **Example:**
1140 +)))
1105 1105  
1142 +(((
1106 1106  (% 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
1144 +)))
1107 1107  
1146 +(((
1108 1108  (% 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**
1148 +)))
1109 1109  
1150 +(((
1110 1110  (% 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**
1152 +)))
1111 1111  
1154 +(((
1155 +
1156 +)))
1112 1112  
1158 +(((
1113 1113  **0xAB** downlink command can be used for set AT+SEARCHx
1160 +)))
1114 1114  
1162 +(((
1115 1115  **Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
1164 +)))
1116 1116  
1117 -* AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
1118 -* 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
1166 +* (((
1167 +AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
1168 +)))
1169 +* (((
1170 +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
1171 +)))
1119 1119  
1173 +(((
1120 1120  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
1175 +)))
1121 1121  
1122 1122  
1123 1123  
... ... @@ -1124,24 +1124,47 @@
1124 1124  
1125 1125  ==== **Fast command to handle MODBUS device** ====
1126 1126  
1182 +(((
1127 1127  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]].
1184 +)))
1128 1128  
1186 +(((
1129 1129  This command is valid since v1.3 firmware version
1188 +)))
1130 1130  
1190 +(((
1191 +
1192 +)))
1131 1131  
1194 +(((
1132 1132  **AT+MBFUN has only two value:**
1196 +)))
1133 1133  
1134 -* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1198 +* (((
1199 +**AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1200 +)))
1135 1135  
1202 +(((
1136 1136  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.
1204 +)))
1137 1137  
1138 -* **AT+MBFUN=0**: Disable Modbus fast reading.
1206 +* (((
1207 +**AT+MBFUN=0**: Disable Modbus fast reading.
1208 +)))
1139 1139  
1210 +(((
1140 1140  **Example:**
1212 +)))
1141 1141  
1142 -* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
1143 -* 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.
1144 -* 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.
1214 +* (((
1215 +AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
1216 +)))
1217 +* (((
1218 +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.
1219 +)))
1220 +* (((
1221 +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.
1222 +)))
1145 1145  
1146 1146  [[image:1654133913295-597.png]]
1147 1147  
... ... @@ -1149,9 +1149,13 @@
1149 1149  [[image:1654133954153-643.png]]
1150 1150  
1151 1151  
1152 -* **Downlink Commands:**
1230 +* (((
1231 +**Downlink Commands:**
1232 +)))
1153 1153  
1234 +(((
1154 1154  **A9 aa** ~-~-> Same as AT+MBFUN=aa
1236 +)))
1155 1155  
1156 1156  
1157 1157  
... ... @@ -1158,32 +1158,60 @@
1158 1158  
1159 1159  ==== **RS485 command timeout** ====
1160 1160  
1243 +(((
1161 1161  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.
1245 +)))
1162 1162  
1247 +(((
1163 1163  Default value: 0, range:  0 ~~ 5 seconds
1249 +)))
1164 1164  
1251 +(((
1252 +
1253 +)))
1165 1165  
1166 -* **AT Command:**
1255 +* (((
1256 +**AT Command:**
1257 +)))
1167 1167  
1168 1168  (% class="box infomessage" %)
1169 1169  (((
1261 +(((
1170 1170  **AT+CMDDLaa=hex(bb cc)**
1171 1171  )))
1264 +)))
1172 1172  
1266 +(((
1173 1173  **Example:**
1268 +)))
1174 1174  
1270 +(((
1175 1175  **AT+CMDDL1=1000** to send the open time to 1000ms
1272 +)))
1176 1176  
1274 +(((
1275 +
1276 +)))
1177 1177  
1178 -* **Downlink Payload:**
1278 +* (((
1279 +**Downlink Payload:**
1280 +)))
1179 1179  
1282 +(((
1180 1180  0x AA aa bb cc
1284 +)))
1181 1181  
1286 +(((
1182 1182  Same as: AT+CMDDLaa=hex(bb cc)
1288 +)))
1183 1183  
1290 +(((
1184 1184   **Example:**
1292 +)))
1185 1185  
1294 +(((
1186 1186   **0xAA 01 03 E8**  ~-~-> Same as **AT+CMDDL1=1000 ms**
1296 +)))
1187 1187  
1188 1188  
1189 1189  
... ... @@ -1190,28 +1190,47 @@
1190 1190  
1191 1191  ==== **Uplink payload mode** ====
1192 1192  
1303 +(((
1193 1193  Define to use one uplink or multiple uplinks for the sampling.
1305 +)))
1194 1194  
1307 +(((
1195 1195  The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
1309 +)))
1196 1196  
1197 -* **AT Command:**
1311 +* (((
1312 +**AT Command:**
1313 +)))
1198 1198  
1199 1199  (% class="box infomessage" %)
1200 1200  (((
1317 +(((
1201 1201  **AT+DATAUP=0**
1202 1202  )))
1320 +)))
1203 1203  
1204 1204  (% class="box infomessage" %)
1205 1205  (((
1324 +(((
1206 1206  **AT+DATAUP=1**
1207 1207  )))
1327 +)))
1208 1208  
1329 +(((
1330 +
1331 +)))
1209 1209  
1210 -* **Downlink Payload:**
1333 +* (((
1334 +**Downlink Payload:**
1335 +)))
1211 1211  
1337 +(((
1212 1212  **0xAD 00**  **~-~->** Same as AT+DATAUP=0
1339 +)))
1213 1213  
1341 +(((
1214 1214  **0xAD 01**  **~-~->** Same as AT+DATAUP=1
1343 +)))
1215 1215  
1216 1216  
1217 1217  
... ... @@ -1229,26 +1229,49 @@
1229 1229  
1230 1230  ==== **Clear RS485 Command** ====
1231 1231  
1361 +(((
1232 1232  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
1363 +)))
1233 1233  
1365 +(((
1366 +
1367 +)))
1234 1234  
1235 -* **AT Command:**
1369 +* (((
1370 +**AT Command:**
1371 +)))
1236 1236  
1237 1237  (((
1238 1238  (% 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
1239 1239  )))
1240 1240  
1377 +(((
1241 1241  Example screen shot after clear all RS485 commands. 
1379 +)))
1242 1242  
1381 +(((
1382 +
1383 +)))
1243 1243  
1385 +(((
1244 1244  The uplink screen shot is:
1387 +)))
1245 1245  
1389 +(((
1246 1246  [[image:1654134704555-320.png]]
1391 +)))
1247 1247  
1393 +(((
1394 +
1395 +)))
1248 1248  
1249 -* **Downlink Payload:**
1397 +* (((
1398 +**Downlink Payload:**
1399 +)))
1250 1250  
1401 +(((
1251 1251  **0x09 aa bb** same as AT+CMDEAR=aa,bb
1403 +)))
1252 1252  
1253 1253  
1254 1254  
... ... @@ -1255,44 +1255,77 @@
1255 1255  
1256 1256  ==== **Set Serial Communication Parameters** ====
1257 1257  
1410 +(((
1258 1258  Set the Rs485 serial communication parameters:
1412 +)))
1259 1259  
1260 -* **AT Command:**
1414 +* (((
1415 +**AT Command:**
1416 +)))
1261 1261  
1418 +(((
1262 1262  Set Baud Rate:
1420 +)))
1263 1263  
1264 1264  (% class="box infomessage" %)
1265 1265  (((
1424 +(((
1266 1266  **AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1267 1267  )))
1427 +)))
1268 1268  
1429 +(((
1269 1269  Set UART Parity
1431 +)))
1270 1270  
1271 1271  (% class="box infomessage" %)
1272 1272  (((
1435 +(((
1273 1273  **AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1274 1274  )))
1438 +)))
1275 1275  
1440 +(((
1276 1276  Set STOPBIT
1442 +)))
1277 1277  
1278 1278  (% class="box infomessage" %)
1279 1279  (((
1446 +(((
1280 1280  **AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1281 1281  )))
1449 +)))
1282 1282  
1451 +(((
1452 +
1453 +)))
1283 1283  
1284 -* **Downlink Payload:**
1455 +* (((
1456 +**Downlink Payload:**
1457 +)))
1285 1285  
1459 +(((
1286 1286  **A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
1461 +)))
1287 1287  
1463 +(((
1288 1288  **Example:**
1465 +)))
1289 1289  
1290 -* A7 01 00 60   same as AT+BAUDR=9600
1291 -* A7 01 04 80  same as AT+BAUDR=115200
1467 +* (((
1468 +A7 01 00 60   same as AT+BAUDR=9600
1469 +)))
1470 +* (((
1471 +A7 01 04 80  same as AT+BAUDR=115200
1472 +)))
1292 1292  
1474 +(((
1293 1293  A7 02 aa: Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
1476 +)))
1294 1294  
1478 +(((
1295 1295  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1480 +)))
1296 1296  
1297 1297  
1298 1298  
... ... @@ -1299,22 +1299,41 @@
1299 1299  
1300 1300  ==== **Control output power duration** ====
1301 1301  
1487 +(((
1302 1302  User can set the output power duration before each sampling.
1489 +)))
1303 1303  
1304 -* **AT Command:**
1491 +* (((
1492 +**AT Command:**
1493 +)))
1305 1305  
1495 +(((
1306 1306  **Example:**
1497 +)))
1307 1307  
1499 +(((
1308 1308  **AT+3V3T=1000**  ~/~/ 3V3 output power will open 1s before each sampling.
1501 +)))
1309 1309  
1503 +(((
1310 1310  **AT+5VT=1000**  ~/~/ +5V output power will open 1s before each sampling.
1505 +)))
1311 1311  
1507 +(((
1508 +
1509 +)))
1312 1312  
1313 -* **LoRaWAN Downlink Command:**
1511 +* (((
1512 +**LoRaWAN Downlink Command:**
1513 +)))
1314 1314  
1515 +(((
1315 1315  **07 01 aa bb**  Same as AT+5VT=(aa bb)
1517 +)))
1316 1316  
1519 +(((
1317 1317  **07 02 aa bb**  Same as AT+3V3T=(aa bb)
1521 +)))
1318 1318  
1319 1319  
1320 1320  
... ... @@ -1403,8 +1403,6 @@
1403 1403  |=**LEDs**|=(% style="width: 274px;" %)**Feature**
1404 1404  |**LED1**|(% style="width:274px" %)Blink when device transmit a packet.
1405 1405  
1406 -
1407 -
1408 1408  == 3.10 Switch Jumper ==
1409 1409  
1410 1410  (% border="1" style="background-color:#ffffcc; color:green; width:515px" %)
... ... @@ -1616,8 +1616,6 @@
1616 1616  * (% style="color:blue" %)**RU864**(%%): frequency bands RU864
1617 1617  * (% style="color:blue" %)**KZ865**(%%): frequency bands KZ865
1618 1618  
1619 -
1620 -
1621 1621  = 9. Packing Info =
1622 1622  
1623 1623  (((