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

From version 4.1
edited by Xiaoling
on 2022/05/19 17:37
Change comment: Uploaded new attachment "1652953055962-143.png", version {1}
To version 29.4
edited by Xiaoling
on 2022/06/01 17:59
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,7 +1,6 @@
1 1  (% style="text-align:center" %)
2 2  [[image:1652947681187-144.png||height="385" width="385"]]
3 3  
4 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.jpg]]
5 5  
6 6  
7 7  
... ... @@ -8,6 +8,7 @@
8 8  **RS485-BL – Waterproof RS485 to LoRaWAN Converter User Manual**
9 9  
10 10  
10 +
11 11  **Table of Contents:**
12 12  
13 13  
... ... @@ -14,6 +14,7 @@
14 14  
15 15  
16 16  
17 +
17 17  = 1.Introduction =
18 18  
19 19  == 1.1 What is RS485-BL RS485 to LoRaWAN Converter ==
... ... @@ -27,7 +27,7 @@
27 27  )))
28 28  
29 29  (((
30 -RS485-BL can interface to RS485 sensor, 3.3v/5v UART sensor or interrupt sensor. RS485-BL provides **a 3.3v output** and** a 5v output** to power external sensors. Both output voltages are controllable to minimize the total system power consumption.
31 +RS485-BL can interface to RS485 sensor, 3.3v/5v UART sensor or interrupt sensor. RS485-BL provides **a 3.3v output** and** a 5v output** to power external sensors. Both output voltages are controllable to minimize the total system power consumption.
31 31  )))
32 32  
33 33  (((
... ... @@ -50,7 +50,7 @@
50 50  Each RS485-BL pre-load with a set of unique keys for LoRaWAN registration, register these keys to LoRaWAN server and it will auto connect after power on.
51 51  )))
52 52  
53 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]]
54 +[[image:1652953304999-717.png||height="424" width="733"]]
54 54  
55 55  == 1.2 Specifications ==
56 56  
... ... @@ -57,11 +57,11 @@
57 57  **Hardware System:**
58 58  
59 59  * STM32L072CZT6 MCU
60 -* SX1276/78 Wireless Chip
61 +* SX1276/78 Wireless Chip 
61 61  * Power Consumption (exclude RS485 device):
62 62  ** Idle: 6uA@3.3v
63 63  
64 -*
65 +*
65 65  ** 20dB Transmit: 130mA@3.3v
66 66  
67 67  **Interface for Model:**
... ... @@ -111,264 +111,295 @@
111 111  * Smart Cities
112 112  * Smart Factory
113 113  
115 +== 1.5 Firmware Change log ==
114 114  
115 -1.
116 -11. Firmware Change log
117 +[[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);"]]
117 117  
118 -[[RS485-BL Image files – Download link and Change log>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/RS485-BL/Firmware/]]
119 +== 1.6 Hardware Change log ==
119 119  
120 -
121 -1.
122 -11. Hardware Change log
123 -
124 -
121 +(((
125 125  v1.4
123 +)))
126 126  
125 +(((
127 127  ~1. Change Power IC to TPS22916
127 +)))
128 128  
129 129  
130 +(((
130 130  v1.3
132 +)))
131 131  
134 +(((
132 132  ~1. Change JP3 from KF350-8P to KF350-11P, Add one extra interface for I2C and one extra interface for one-wire
136 +)))
133 133  
134 134  
139 +(((
135 135  v1.2
141 +)))
136 136  
137 -Release version
143 +(((
144 +Release version ​​​​​
145 +)))
138 138  
147 += 2. Pin mapping and Power ON Device =
139 139  
140 -
141 -
142 -
143 -1. Pin mapping and Power ON Device
144 -
149 +(((
145 145  The RS485-BL is powered on by 8500mAh battery. To save battery life, RS485-BL is shipped with power off. User can put the jumper to power on RS485-BL.
151 +)))
146 146  
153 +[[image:1652953055962-143.png||height="387" width="728"]]
147 147  
148 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]]
149 149  
150 -
151 -
152 152  The Left TXD and RXD are TTL interface for external sensor. TTL level is controlled by 3.3/5v Jumper.
153 153  
158 += 3. Operation Mode =
154 154  
160 +== 3.1 How it works? ==
155 155  
156 -
157 -
158 -
159 -1. Operation Mode
160 -11. How it works?
161 -
162 +(((
162 162  The RS485-BL is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join network. To connect a local LoRaWAN network, user just need to input the OTAA keys in the network server and power on the RS485-BL. It will auto join the network via OTAA.
164 +)))
163 163  
166 +== 3.2 Example to join LoRaWAN network ==
164 164  
165 -1.
166 -11. Example to join LoRaWAN network
168 +Here shows an example for how to join the TTN V3 Network. Below is the network structure, we use [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]] as LoRaWAN gateway here. 
167 167  
168 -Here shows an example for how to join the TTN V3 Network. Below is the network structure, we use [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]] as LoRaWAN gateway here.
170 +[[image:1652953414711-647.png||height="337" width="723"]]
169 169  
170 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
171 -
172 -
172 +(((
173 173  The RS485-BL in this example connected to two RS485 devices for demonstration, user can connect to other RS485 devices via the same method.
174 +)))
174 174  
175 -
176 +(((
176 176  The LG308 is already set to connect to [[TTN V3 network >>url:https://www.thethingsnetwork.org/]]. So what we need to now is only configure the TTN V3:
178 +)))
177 177  
180 +(((
178 178  **Step 1**: Create a device in TTN V3 with the OTAA keys from RS485-BL.
182 +)))
179 179  
184 +(((
180 180  Each RS485-BL is shipped with a sticker with unique device EUI:
186 +)))
181 181  
182 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
188 +[[image:1652953462722-299.png]]
183 183  
184 -
185 -
186 -
190 +(((
187 187  User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:
192 +)))
188 188  
194 +(((
189 189  Add APP EUI in the application.
196 +)))
190 190  
191 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
192 192  
193 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
194 194  
195 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
196 196  
197 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]]
201 +[[image:image-20220519174512-1.png]]
198 198  
203 +[[image:image-20220519174512-2.png||height="328" width="731"]]
199 199  
205 +[[image:image-20220519174512-3.png||height="556" width="724"]]
200 200  
207 +[[image:image-20220519174512-4.png]]
201 201  
202 -
203 -
204 -
205 -
206 -
207 -
208 -
209 -
210 -
211 -
212 -
213 -
214 -
215 215  You can also choose to create the device manually.
216 216  
217 -|(((
218 -
219 -)))
211 +[[image:1652953542269-423.png||height="710" width="723"]]
220 220  
221 -
222 -
223 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
224 -
225 225  Add APP KEY and DEV EUI
226 226  
227 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
215 +[[image:1652953553383-907.png||height="514" width="724"]]
228 228  
229 229  
218 +(((
230 230  **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.
220 +)))
231 231  
232 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]]
222 +[[image:1652953568895-172.png||height="232" width="724"]]
233 233  
224 +== 3.3 Configure Commands to read data ==
234 234  
235 -
236 -
237 -1.
238 -11. Configure Commands to read data
239 -
226 +(((
240 240  There are plenty of RS485 and TTL level devices in the market and each device has different command to read the valid data. To support these devices in flexible, RS485-BL supports flexible command set. User can use [[AT Commands or LoRaWAN Downlink>>path:#AT_COMMAND]] Command to configure how RS485-BL should read the sensor and how to handle the return from RS485 or TTL sensors.
228 +)))
241 241  
230 +=== 3.3.1 onfigure UART settings for RS485 or TTL communication ===
242 242  
243 -1.
244 -11.
245 -111. Configure UART settings for RS485 or TTL communication
246 -
247 247  RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
248 248  
249 -1. RS485-MODBUS mode:
234 +**~1. RS485-MODBUS mode:**
250 250  
251 251  AT+MOD=1 ~/~/ Support RS485-MODBUS type sensors. User can connect multiply RS485 , Modbus sensors to the A / B pins.
252 252  
238 +**2. TTL mode:**
253 253  
254 -1. TTL mode:
255 -
256 256  AT+MOD=2 ~/~/ Support TTL Level sensors, User can connect one TTL Sensor to the TXD/RXD/GND pins.
257 257  
258 -
259 259  RS485-BL default UART settings is **9600, no parity, stop bit 1**. If the sensor has a different settings, user can change the RS485-BL setting to match.
260 260  
261 -
262 -|**AT Commands**|**Description**|**Example**
263 -|AT+BAUDR|Set the baud rate (for RS485 connection). Default Value is: 9600.|(((
244 +(% border="1" style="background-color:#ffffcc; color:green; width:795px" %)
245 +|(((
246 +**AT Commands**
247 +)))|(% style="width:285px" %)(((
248 +**Description**
249 +)))|(% style="width:347px" %)(((
250 +**Example**
251 +)))
252 +|(((
253 +AT+BAUDR
254 +)))|(% style="width:285px" %)(((
255 +Set the baud rate (for RS485 connection). Default Value is: 9600.
256 +)))|(% style="width:347px" %)(((
257 +(((
264 264  AT+BAUDR=9600
259 +)))
265 265  
261 +(((
266 266  Options: (1200,2400,4800,14400,19200,115200)
267 267  )))
268 -|AT+PARITY|(((
264 +)))
265 +|(((
266 +AT+PARITY
267 +)))|(% style="width:285px" %)(((
268 +(((
269 269  Set UART parity (for RS485 connection)
270 +)))
270 270  
272 +(((
271 271  Default Value is: no parity.
272 -)))|(((
274 +)))
275 +)))|(% style="width:347px" %)(((
276 +(((
273 273  AT+PARITY=0
278 +)))
274 274  
280 +(((
275 275  Option: 0: no parity, 1: odd parity, 2: even parity
276 276  )))
277 -|AT+STOPBIT|(((
283 +)))
284 +|(((
285 +AT+STOPBIT
286 +)))|(% style="width:285px" %)(((
287 +(((
278 278  Set serial stopbit (for RS485 connection)
289 +)))
279 279  
291 +(((
280 280  Default Value is: 1bit.
281 -)))|(((
293 +)))
294 +)))|(% style="width:347px" %)(((
295 +(((
282 282  AT+STOPBIT=0 for 1bit
297 +)))
283 283  
299 +(((
284 284  AT+STOPBIT=1 for 1.5 bit
301 +)))
285 285  
303 +(((
286 286  AT+STOPBIT=2 for 2 bits
287 287  )))
306 +)))
288 288  
308 +=== 3.3.2 Configure sensors ===
289 289  
310 +(((
311 +Some sensors might need to configure before normal operation. User can configure such sensor via PC or through RS485-BL AT Commands (% style="color:#4f81bd" %)**AT+CFGDEV**.
312 +)))
290 290  
314 +(((
315 +When user issue an (% style="color:#4f81bd" %)**AT+CFGDEV**(%%) command, Each (% style="color:#4f81bd" %)**AT+CFGDEV**(%%) equals to send a command to the RS485 or TTL sensors. This command will only run when user input it and won’t run during each sampling.
316 +)))
291 291  
292 -
293 -1.
294 -11.
295 -111. Configure sensors
296 -
297 -Some sensors might need to configure before normal operation. User can configure such sensor via PC or through RS485-BL AT Commands AT+CFGDEV.
298 -
299 -
300 -When user issue an AT+CFGDEV command, Each AT+CFGDEV equals to send a command to the RS485 or TTL sensors. This command will only run when user input it and won’t run during each sampling.
301 -
302 -|**AT Commands**|**Description**|**Example**
303 -|AT+CFGDEV|(((
318 +(% border="1" style="background-color:#ffffcc; color:green; width:806px" %)
319 +|**AT Commands**|(% style="width:418px" %)**Description**|(% style="width:256px" %)**Example**
320 +|AT+CFGDEV|(% style="width:418px" %)(((
304 304  This command is used to configure the RS485/TTL devices; they won’t be used during sampling.
305 305  
306 -AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
323 +AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,
307 307  
308 -m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
309 -)))|AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
325 +mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
326 +)))|(% style="width:256px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
310 310  
311 311  Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>path:#AT_CFGDEV]].
312 312  
330 +=== 3.3.3 Configure read commands for each sampling ===
313 313  
314 -
315 -
316 -
317 -1.
318 -11.
319 -111. Configure read commands for each sampling
320 -
332 +(((
321 321  RS485-BL is a battery powered device; it will sleep most of time. And wake up on each period and read RS485 / TTL sensor data and uplink.
334 +)))
322 322  
323 -
336 +(((
324 324  During each sampling, we need to confirm what commands we need to send to the sensors to read data. After the RS485/TTL sensors send back the value, it normally includes some bytes and we only need a few from them for a shorten payload.
338 +)))
325 325  
326 -
340 +(((
327 327  To save the LoRaWAN network bandwidth, we might need to read data from different sensors and combine their valid value into a short payload.
342 +)))
328 328  
329 -
344 +(((
330 330  This section describes how to achieve above goals.
346 +)))
331 331  
332 -
348 +(((
333 333  During each sampling, the RS485-BL can support 15 commands to read sensors. And combine the return to one or several uplink payloads.
350 +)))
334 334  
335 -
352 +(((
336 336  **Command from RS485-BL to Sensor:**
354 +)))
337 337  
356 +(((
338 338  RS485-BL can send out pre-set max 15 strings via **AT+COMMAD1**, **ATCOMMAND2**,…, to **AT+COMMANDF** . All commands are of same grammar.
358 +)))
339 339  
340 -
360 +(((
341 341  **Handle return from sensors to RS485-BL**:
362 +)))
342 342  
364 +(((
343 343  After RS485-BL send out a string to sensor, RS485-BL will wait for the return from RS485 or TTL sensor. And user can specify how to handle the return, by **AT+DATACUT or AT+SEARCH commands**
366 +)))
344 344  
368 +* (((
369 +**AT+DATACUT**
370 +)))
345 345  
346 -* **AT+DATACUT**
347 -
372 +(((
348 348  When the return value from sensor have fix length and we know which position the valid value we should get, we can use AT+DATACUT command.
374 +)))
349 349  
376 +* (((
377 +**AT+SEARCH**
378 +)))
350 350  
351 -* **AT+SEARCH**
352 -
380 +(((
353 353  When the return value from sensor is dynamic length and we are not sure which bytes the valid data is, instead, we know what value the valid value following. We can use AT+SEARCH to search the valid value in the return string.
382 +)))
354 354  
355 -
384 +(((
356 356  **Define wait timeout:**
386 +)))
357 357  
388 +(((
358 358  Some RS485 device might has longer delay on reply, so user can use AT+CMDDL to set the timeout for getting reply after the RS485 command is sent. For example, AT+CMDDL1=1000 to send the open time to 1000ms
390 +)))
359 359  
360 -
392 +(((
361 361  After we got the valid value from each RS485 commands, we need to combine them together with the command **AT+DATAUP**.
394 +)))
362 362  
363 -
364 364  **Examples:**
365 365  
366 366  Below are examples for the how above AT Commands works.
367 367  
368 -
369 369  **AT+COMMANDx : **This command will be sent to RS485/TTL devices during each sampling, Max command length is 14 bytes. The grammar is:
370 370  
371 -|(((
402 +(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:501px" %)
403 +|(% style="width:498px" %)(((
372 372  **AT+COMMANDx=xx xx xx xx xx xx xx xx xx xx xx xx,m**
373 373  
374 374  **xx xx xx xx xx xx xx xx xx xx xx xx: The RS485 command to be sent**
... ... @@ -380,46 +380,43 @@
380 380  
381 381  In the RS485-BL, we should use this command AT+COMMAND1=01 03 0B B8 00 02,1 for the same.
382 382  
383 -
384 384  **AT+SEARCHx**: This command defines how to handle the return from AT+COMMANDx.
385 385  
386 -|(((
417 +(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:580px" %)
418 +|(% style="width:577px" %)(((
387 387  **AT+SEARCHx=aa,xx xx xx xx xx**
388 388  
389 389  * **aa: 1: prefix match mode; 2: prefix and suffix match mode**
390 390  * **xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix**
391 -
392 -
393 393  )))
394 394  
395 -Examples:
425 +**Examples:**
396 396  
397 397  1. For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
398 398  
399 399  If we set AT+SEARCH1=1,1E 56 34.      (max 5 bytes for prefix)
400 400  
401 -The valid data will be all bytes after 1E 56 34 , so it is 2e 30 58 5f 36 41 30 31 00 49
431 +The valid data will be all bytes after 1E 56 34 , so it is (% style="background-color:yellow" %)**2e 30 58 5f 36 41 30 31 00 49**
402 402  
403 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]]
433 +[[image:1653271044481-711.png]]
404 404  
405 -
406 406  1. For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
407 407  
408 408  If we set AT+SEARCH1=2, 1E 56 34+31 00 49
409 409  
410 -Device will search the bytes between 1E 56 34 and 31 00 49. So it is 2e 30 58 5f 36 41 30
439 +Device will search the bytes between 1E 56 34 and 31 00 49. So it is(% style="background-color:yellow" %) **2e 30 58 5f 36 41 30**
411 411  
412 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]]
441 +[[image:1653271276735-972.png]]
413 413  
414 -
415 415  **AT+DATACUTx : **This command defines how to handle the return from AT+COMMANDx, max return length is 45 bytes.
416 416  
417 -|(((
445 +(% style="background-color:#4f81bd; color:white; width:729px" %)
446 +|(% style="width:726px" %)(((
418 418  **AT+DATACUTx=a,b,c**
419 419  
420 420  * **a: length for the return of AT+COMMAND**
421 421  * **b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
422 -* **c: define the position for valid value. **
451 +* **c: define the position for valid value.  **
423 423  )))
424 424  
425 425  Examples:
... ... @@ -426,95 +426,130 @@
426 426  
427 427  * Grab bytes:
428 428  
429 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]]
458 +[[image:1653271581490-837.png||height="313" width="722"]]
430 430  
431 431  * Grab a section.
432 432  
433 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]]
462 +[[image:1653271648378-342.png||height="326" width="720"]]
434 434  
435 435  * Grab different sections.
436 436  
437 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]]
466 +[[image:1653271657255-576.png||height="305" width="730"]]
438 438  
468 +(((
469 +(% style="color:red" %)**Note:**
470 +)))
439 439  
440 -Note:
441 -
472 +(((
442 442  AT+SEARCHx and AT+DATACUTx can be used together, if both commands are set, RS485-BL will first process AT+SEARCHx on the return string and get a temporary string, and then process AT+DATACUTx on this temporary string to get the final payload. In this case, AT+DATACUTx need to set to format AT+DATACUTx=0,xx,xx where the return bytes set to 0.
474 +)))
443 443  
444 -Example:
476 +(((
477 +**Example:**
478 +)))
445 445  
446 -AT+COMMAND1=11 01 1E D0,0
480 +(((
481 +(% style="color:red" %)AT+COMMAND1=11 01 1E D0,0
482 +)))
447 447  
448 -AT+SEARCH1=1,1E 56 34
484 +(((
485 +(% style="color:red" %)AT+SEARCH1=1,1E 56 34
486 +)))
449 449  
450 -AT+DATACUT1=0,2,1~~5
488 +(((
489 +(% style="color:red" %)AT+DATACUT1=0,2,1~~5
490 +)))
451 451  
452 -Return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
492 +(((
493 +(% style="color:red" %)Return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
494 +)))
453 453  
454 -String after SEARCH command: 2e 30 58 5f 36 41 30 31 00 49
496 +(((
497 +(% style="color:red" %)String after SEARCH command: 2e 30 58 5f 36 41 30 31 00 49
498 +)))
455 455  
456 -Valid payload after DataCUT command: 2e 30 58 5f 36
500 +(((
501 +(% style="color:red" %)Valid payload after DataCUT command: 2e 30 58 5f 36
502 +)))
457 457  
458 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]]
504 +[[image:1653271763403-806.png]]
459 459  
506 +=== 3.3.4 Compose the uplink payload ===
460 460  
461 -
462 -
463 -1.
464 -11.
465 -111. Compose the uplink payload
466 -
508 +(((
467 467  Through AT+COMMANDx and AT+DATACUTx we got valid value from each RS485 commands, Assume these valid value are RETURN1, RETURN2, .., to RETURNx. The next step is how to compose the LoRa Uplink Payload by these RETURNs. The command is **AT+DATAUP.**
510 +)))
468 468  
512 +(((
513 +(% style="color:#4f81bd" %)**Examples: AT+DATAUP=0**
514 +)))
469 469  
470 -**Examples: AT+DATAUP=0**
516 +(((
517 +Compose the uplink payload with value returns in sequence and send with (% style="color:red" %)**A SIGNLE UPLINK**.
518 +)))
471 471  
472 -Compose the uplink payload with value returns in sequence and send with **A SIGNLE UPLINK**.
473 -
520 +(((
474 474  Final Payload is
522 +)))
475 475  
476 -Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx
524 +(((
525 +(% style="color:#4f81bd" %)Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx
526 +)))
477 477  
528 +(((
478 478  Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
530 +)))
479 479  
480 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]]
532 +[[image:1653272787040-634.png||height="515" width="719"]]
481 481  
534 +(((
535 +(% style="color:#4f81bd" %)**Examples: AT+DATAUP=1**
536 +)))
482 482  
538 +(((
539 +Compose the uplink payload with value returns in sequence and send with (% style="color:red" %)**Multiply UPLINKs**.
540 +)))
483 483  
484 -**Examples: AT+DATAUP=1**
485 -
486 -Compose the uplink payload with value returns in sequence and send with **Multiply UPLINKs**.
487 -
542 +(((
488 488  Final Payload is
544 +)))
489 489  
490 -Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA
546 +(((
547 +(% style="color:#4f81bd" %)Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA
548 +)))
491 491  
492 -1. Battery Info (2 bytes): Battery voltage
493 -1. PAYVER (1 byte): Defined by AT+PAYVER
494 -1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
495 -1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
496 -1. DATA: Valid value: max 6 bytes(US915 version here, [[Notice*!>>path:#max_byte]]) for each uplink so each uplink <= 11 bytes. For the last uplink, DATA will might less than 6 bytes
550 +1. (((
551 +Battery Info (2 bytes): Battery voltage
552 +)))
553 +1. (((
554 +PAYVER (1 byte): Defined by AT+PAYVER
555 +)))
556 +1. (((
557 +PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
558 +)))
559 +1. (((
560 +PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
561 +)))
562 +1. (((
563 +DATA: Valid value: max 6 bytes(US915 version here, Notice*!) for each uplink so each uplink <= 11 bytes. For the last uplink, DATA will might less than 6 bytes
564 +)))
497 497  
498 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]
566 +[[image:1653272817147-600.png||height="437" width="717"]]
499 499  
500 -
501 501  So totally there will be 3 uplinks for this sampling, each uplink includes 6 bytes DATA
502 502  
503 -DATA1=RETURN1 Valid Value = 20 20 0a 33 90 41
570 +DATA1=RETURN1 Valid Value = (% style="background-color:#4f81bd; color:white" %) 20 20 0a 33 90 41
504 504  
505 -DATA2=1^^st^^ ~~ 6^^th^^ byte of Valid value of RETURN10= 02 aa 05 81 0a 20
572 +DATA2=1^^st^^ ~~ 6^^th^^ byte of Valid value of RETURN10= (% style="background-color:#4f81bd; color:white" %)02 aa 05 81 0a 20
506 506  
507 -DATA3=7^^th^^ ~~ 11^^th^^ bytes of Valid value of RETURN10 = 20 20 20 2d 30
574 +DATA3=7^^th^^ ~~ 11^^th^^ bytes of Valid value of RETURN10 =(% style="background-color:#4f81bd; color:white" %) 20 20 20 2d 30
508 508  
509 -
510 -
511 511  Below are the uplink payloads:
512 512  
513 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]]
578 +[[image:1653272901032-107.png]]
514 514  
580 +(% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
515 515  
516 -Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
517 -
518 518   ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
519 519  
520 520   * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
... ... @@ -523,91 +523,121 @@
523 523  
524 524   ~* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
525 525  
590 +=== 3.3.5 Uplink on demand ===
526 526  
527 -
528 -1.
529 -11.
530 -111. Uplink on demand
531 -
592 +(((
532 532  Except uplink periodically, RS485-BL is able to uplink on demand. The server sends downlink command to RS485-BL and RS485 will uplink data base on the command.
594 +)))
533 533  
596 +(((
534 534  Downlink control command:
598 +)))
535 535  
536 -[[0x08 command>>path:#downlink_08]]: Poll an uplink with current command set in RS485-BL.
600 +(((
601 +**0x08 command**: Poll an uplink with current command set in RS485-BL.
602 +)))
537 537  
538 -[[0xA8 command>>path:#downlink_A8]]: Send a command to RS485-BL and uplink the output from sensors.
604 +(((
605 +**0xA8 command**: Send a command to RS485-BL and uplink the output from sensors.
606 +)))
539 539  
608 +=== 3.3.6 Uplink on Interrupt ===
540 540  
610 +Put the interrupt sensor between 3.3v_out and GPIO ext.
541 541  
542 -1.
543 -11.
544 -111. Uplink on Interrupt
612 +[[image:1653273818896-432.png]]
545 545  
546 -Put the interrupt sensor between 3.3v_out and GPIO ext.[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]]
547 -
614 +(((
548 548  AT+INTMOD=0  Disable Interrupt
616 +)))
549 549  
618 +(((
550 550  AT+INTMOD=1  Interrupt trigger by rising or falling edge.
620 +)))
551 551  
622 +(((
552 552  AT+INTMOD=2  Interrupt trigger by falling edge. ( Default Value)
624 +)))
553 553  
626 +(((
554 554  AT+INTMOD=3  Interrupt trigger by rising edge.
628 +)))
555 555  
630 +== 3.4 Uplink Payload ==
556 556  
557 -1.
558 -11. Uplink Payload
559 -
560 -
561 -|**Size(bytes)**|**2**|**1**|**Length depends on the return from the commands**
562 -|Value|(((
632 +(% border="1" style="background-color:#4f81bd; color:white; width:850px" %)
633 +|**Size(bytes)**|(% style="width:130px" %)**2**|(% style="width:93px" %)**1**|(% style="width:509px" %)**Length depends on the return from the commands**
634 +|Value|(% style="width:130px" %)(((
635 +(((
563 563  Battery(mV)
637 +)))
564 564  
639 +(((
565 565  &
641 +)))
566 566  
643 +(((
567 567  Interrupt _Flag
568 -)))|(((
645 +)))
646 +)))|(% style="width:93px" %)(((
569 569  PAYLOAD_VER
570 570  
571 571  
572 -)))|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.
650 +)))|(% 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.
573 573  
574 574  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
575 575  
576 -
654 +(((
577 577  function Decoder(bytes, port) {
656 +)))
578 578  
658 +(((
579 579  ~/~/Payload Formats of RS485-BL Deceive
660 +)))
580 580  
662 +(((
581 581  return {
664 +)))
582 582  
666 +(((
583 583   ~/~/Battery,units:V
668 +)))
584 584  
670 +(((
585 585   BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,
672 +)))
586 586  
674 +(((
587 587   ~/~/GPIO_EXTI 
676 +)))
588 588  
678 +(((
589 589   EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",
680 +)))
590 590  
682 +(((
591 591   ~/~/payload of version
684 +)))
592 592  
686 +(((
593 593   Pay_ver:bytes[2],
688 +)))
594 594  
690 +(((
595 595   };
692 +)))
596 596  
694 +(((
597 597   }
696 +)))
598 598  
599 -
600 -
601 -
602 -
603 -
604 -
698 +(((
605 605  TTN V3 uplink screen shot.
700 +)))
606 606  
607 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
702 +[[image:1653274001211-372.png||height="192" width="732"]]
608 608  
609 -1.
610 -11. Configure RS485-BL via AT or Downlink
704 +== 3.5 Configure RS485-BL via AT or Downlink ==
611 611  
612 612  User can configure RS485-BL via [[AT Commands >>path:#_​Using_the_AT]]or LoRaWAN Downlink Commands
613 613  
... ... @@ -617,20 +617,17 @@
617 617  
618 618  * **Sensor Related Commands**: These commands are special designed for RS485-BL.  User can see these commands below:
619 619  
620 -
621 -1.
622 -11.
714 +1.
715 +11.
623 623  111. Common Commands:
624 624  
625 -
626 626  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: [[http:~~/~~/wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands>>url:http://wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands]]
627 627  
628 628  
629 -1.
630 -11.
721 +1.
722 +11.
631 631  111. Sensor related commands:
632 632  
633 -
634 634  ==== Choose Device Type (RS485 or TTL) ====
635 635  
636 636  RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
... ... @@ -671,7 +671,6 @@
671 671  * XX XX XX XX: RS485 command total NN bytes
672 672  * 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
673 673  
674 -
675 675  **Example 1:**
676 676  
677 677  To connect a Modbus Alarm with below commands.
... ... @@ -780,7 +780,6 @@
780 780  
781 781  * AT+MBFUN=0: Disable Modbus fast reading.
782 782  
783 -
784 784  Example:
785 785  
786 786  * AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
... ... @@ -865,7 +865,7 @@
865 865  
866 866  Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
867 867  
868 -Example screen shot after clear all RS485 commands.
957 +Example screen shot after clear all RS485 commands. 
869 869  
870 870  
871 871  
... ... @@ -909,7 +909,6 @@
909 909  * A7 01 00 60   same as AT+BAUDR=9600
910 910  * A7 01 04 80  same as AT+BAUDR=115200
911 911  
912 -
913 913  A7 02 aa: Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
914 914  
915 915  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
... ... @@ -937,20 +937,18 @@
937 937  
938 938  
939 939  
940 -1.
1028 +1.
941 941  11. Buttons
942 942  
943 -
944 944  |**Button**|**Feature**
945 945  |**RST**|Reboot RS485-BL
946 946  
947 -
948 -1.
1034 +1.
949 949  11. +3V3 Output
950 950  
951 951  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
952 952  
953 -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.
1039 +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. 
954 954  
955 955  
956 956  The +3V3 output time can be controlled by AT Command.
... ... @@ -963,12 +963,12 @@
963 963  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
964 964  
965 965  
966 -1.
1052 +1.
967 967  11. +5V Output
968 968  
969 969  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
970 970  
971 -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.
1057 +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. 
972 972  
973 973  
974 974  The 5V output time can be controlled by AT Command.
... ... @@ -983,14 +983,13 @@
983 983  
984 984  
985 985  
986 -1.
1072 +1.
987 987  11. LEDs
988 988  
989 989  |**LEDs**|**Feature**
990 990  |**LED1**|Blink when device transmit a packet.
991 991  
992 -
993 -1.
1078 +1.
994 994  11. Switch Jumper
995 995  
996 996  |**Switch Jumper**|**Feature**
... ... @@ -1011,7 +1011,6 @@
1011 1011  
1012 1012  1. Case Study
1013 1013  
1014 -
1015 1015  User can check this URL for some case studies.
1016 1016  
1017 1017  [[http:~~/~~/wiki.dragino.com/index.php?title=APP_RS485_COMMUNICATE_WITH_SENSORS>>url:http://wiki.dragino.com/index.php?title=APP_RS485_COMMUNICATE_WITH_SENSORS]]
... ... @@ -1037,7 +1037,7 @@
1037 1037  
1038 1038  
1039 1039  
1040 -1.
1124 +1.
1041 1041  11. Common AT Command Sequence
1042 1042  111. Multi-channel ABP mode (Use with SX1301/LG308)
1043 1043  
... ... @@ -1056,8 +1056,8 @@
1056 1056  
1057 1057  ATZ
1058 1058  
1059 -1.
1060 -11.
1143 +1.
1144 +11.
1061 1061  111. Single-channel ABP mode (Use with LG01/LG02)
1062 1062  
1063 1063  AT+FDR   Reset Parameters to Factory Default, Keys Reserve
... ... @@ -1099,7 +1099,6 @@
1099 1099  * For bug fix
1100 1100  * Change LoRaWAN bands.
1101 1101  
1102 -
1103 1103  Below shows the hardware connection for how to upload an image to RS485-BL:
1104 1104  
1105 1105  [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]]
... ... @@ -1133,7 +1133,7 @@
1133 1133  [[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]]
1134 1134  
1135 1135  
1136 -1.
1219 +1.
1137 1137  11. How to change the LoRa Frequency Bands/Region?
1138 1138  
1139 1139  User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download.
... ... @@ -1140,10 +1140,9 @@
1140 1140  
1141 1141  
1142 1142  
1143 -1.
1226 +1.
1144 1144  11. How many RS485-Slave can RS485-BL connects?
1145 1145  
1146 -
1147 1147  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]].
1148 1148  
1149 1149  
... ... @@ -1154,11 +1154,11 @@
1154 1154  
1155 1155  Please see this link for debug:
1156 1156  
1157 -[[http:~~/~~/wiki.dragino.com/index.php?title=Main_Page#LoRaWAN_Communication_Debug>>url:http://wiki.dragino.com/index.php?title=Main_Page#LoRaWAN_Communication_Debug]]
1239 +[[http:~~/~~/wiki.dragino.com/index.php?title=Main_Page#LoRaWAN_Communication_Debug>>url:http://wiki.dragino.com/index.php?title=Main_Page#LoRaWAN_Communication_Debug]] 
1158 1158  
1159 1159  
1160 1160  
1161 -1.
1243 +1.
1162 1162  11. Why I can’t join TTN V3 in US915 /AU915 bands?
1163 1163  
1164 1164  It might about the channels mapping. Please see for detail.
... ... @@ -1169,7 +1169,6 @@
1169 1169  
1170 1170  1. Order Info
1171 1171  
1172 -
1173 1173  **Part Number: RS485-BL-XXX**
1174 1174  
1175 1175  **XXX:**
... ... @@ -1185,7 +1185,6 @@
1185 1185  * **RU864**: frequency bands RU864
1186 1186  * **KZ865: **frequency bands KZ865
1187 1187  
1188 -
1189 1189  1. Packing Info
1190 1190  
1191 1191  **Package Includes**:
... ... @@ -1194,7 +1194,6 @@
1194 1194  * Stick Antenna for LoRa RF part x 1
1195 1195  * Program cable x 1
1196 1196  
1197 -
1198 1198  **Dimension and weight**:
1199 1199  
1200 1200  * Device Size: 13.5 x 7 x 3 cm
... ... @@ -1202,7 +1202,6 @@
1202 1202  * Package Size / pcs : 14.5 x 8 x 5 cm
1203 1203  * Weight / pcs : 170g
1204 1204  
1205 -
1206 1206  1. Support
1207 1207  
1208 1208  * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
1652953304999-717.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +139.7 KB
Content
1652953414711-647.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +119.3 KB
Content
1652953462722-299.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +202.7 KB
Content
1652953542269-423.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +118.5 KB
Content
1652953553383-907.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +94.0 KB
Content
1652953568895-172.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +109.3 KB
Content
1652954654347-831.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +138.7 KB
Content
1653271044481-711.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +27.8 KB
Content
1653271276735-972.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +26.6 KB
Content
1653271581490-837.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +138.7 KB
Content
1653271648378-342.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +131.4 KB
Content
1653271657255-576.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +142.6 KB
Content
1653271763403-806.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +27.7 KB
Content
1653272787040-634.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +294.0 KB
Content
1653272817147-600.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +143.3 KB
Content
1653272901032-107.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +197.8 KB
Content
1653273818896-432.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +31.6 KB
Content
1653274001211-372.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +91.4 KB
Content
image-20220519174512-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +32.2 KB
Content
image-20220519174512-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +42.7 KB
Content
image-20220519174512-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +36.3 KB
Content
image-20220519174512-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +19.1 KB
Content