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

From version 28.2
edited by Xiaoling
on 2022/05/23 10:44
Change comment: There is no comment for this version
To version 29.34
edited by Xiaoling
on 2022/06/02 08:59
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -7,12 +7,15 @@
7 7  **RS485-BL – Waterproof RS485 to LoRaWAN Converter User Manual**
8 8  
9 9  
10 +
10 10  **Table of Contents:**
11 11  
13 +{{toc/}}
12 12  
13 13  
14 14  
15 15  
18 +
16 16  = 1.Introduction =
17 17  
18 18  == 1.1 What is RS485-BL RS485 to LoRaWAN Converter ==
... ... @@ -22,19 +22,19 @@
22 22  )))
23 23  
24 24  (((
25 -The Dragino RS485-BL is a **RS485 / UART to LoRaWAN Converter** for Internet of Things solutions. User can connect RS485 or UART sensor to RS485-BL converter, and configure RS485-BL to periodically read sensor data and upload via LoRaWAN network to IoT server.
28 +The Dragino RS485-BL is a (% style="color:blue" %)**RS485 / UART to LoRaWAN Converter**(%%) for Internet of Things solutions. User can connect RS485 or UART sensor to RS485-BL converter, and configure RS485-BL to periodically read sensor data and upload via LoRaWAN network to IoT server.
26 26  )))
27 27  
28 28  (((
29 -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.
32 +RS485-BL can interface to RS485 sensor, 3.3v/5v UART sensor or interrupt sensor. RS485-BL provides (% style="color:blue" %)**a 3.3v output**(%%) and** (% style="color:blue" %)a 5v output(%%)** to power external sensors. Both output voltages are controllable to minimize the total system power consumption.
30 30  )))
31 31  
32 32  (((
33 -RS485-BL is IP67 **waterproof** and powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use for several years.
36 +RS485-BL is IP67 (% style="color:blue" %)**waterproof**(%%) and powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use for several years.
34 34  )))
35 35  
36 36  (((
37 -RS485-BL runs standard **LoRaWAN 1.0.3 in Class A**. It can reach long transfer range and easy to integrate with LoRaWAN compatible gateway and IoT server.
40 +RS485-BL runs standard (% style="color:blue" %)**LoRaWAN 1.0.3 in Class A**(%%). It can reach long transfer range and easy to integrate with LoRaWAN compatible gateway and IoT server.
38 38  )))
39 39  
40 40  (((
... ... @@ -51,8 +51,11 @@
51 51  
52 52  [[image:1652953304999-717.png||height="424" width="733"]]
53 53  
57 +
58 +
54 54  == 1.2 Specifications ==
55 55  
61 +
56 56  **Hardware System:**
57 57  
58 58  * STM32L072CZT6 MCU
... ... @@ -59,8 +59,6 @@
59 59  * SX1276/78 Wireless Chip 
60 60  * Power Consumption (exclude RS485 device):
61 61  ** Idle: 6uA@3.3v
62 -
63 -*
64 64  ** 20dB Transmit: 130mA@3.3v
65 65  
66 66  **Interface for Model:**
... ... @@ -114,9 +114,12 @@
114 114  
115 115  [[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);"]]
116 116  
121 +
117 117  == 1.6 Hardware Change log ==
118 118  
119 119  (((
125 +
126 +
120 120  v1.4
121 121  )))
122 122  
... ... @@ -140,6 +140,8 @@
140 140  
141 141  (((
142 142  Release version ​​​​​
150 +
151 +
143 143  )))
144 144  
145 145  = 2. Pin mapping and Power ON Device =
... ... @@ -153,6 +153,7 @@
153 153  
154 154  The Left TXD and RXD are TTL interface for external sensor. TTL level is controlled by 3.3/5v Jumper.
155 155  
165 +
156 156  = 3. Operation Mode =
157 157  
158 158  == 3.1 How it works? ==
... ... @@ -159,6 +159,8 @@
159 159  
160 160  (((
161 161  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.
172 +
173 +
162 162  )))
163 163  
164 164  == 3.2 Example to join LoRaWAN network ==
... ... @@ -194,8 +194,6 @@
194 194  )))
195 195  
196 196  
197 -
198 -
199 199  [[image:image-20220519174512-1.png]]
200 200  
201 201  [[image:image-20220519174512-2.png||height="328" width="731"]]
... ... @@ -219,10 +219,13 @@
219 219  
220 220  [[image:1652953568895-172.png||height="232" width="724"]]
221 221  
232 +
222 222  == 3.3 Configure Commands to read data ==
223 223  
224 224  (((
225 -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.
236 +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>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]] Command to configure how RS485-BL should read the sensor and how to handle the return from RS485 or TTL sensors.
237 +
238 +
226 226  )))
227 227  
228 228  === 3.3.1 onfigure UART settings for RS485 or TTL communication ===
... ... @@ -303,6 +303,7 @@
303 303  )))
304 304  )))
305 305  
319 +
306 306  === 3.3.2 Configure sensors ===
307 307  
308 308  (((
... ... @@ -323,8 +323,9 @@
323 323  mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
324 324  )))|(% style="width:256px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
325 325  
326 -Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>path:#AT_CFGDEV]].
340 +Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>||anchor="HRS485DebugCommand28AT2BCFGDEV29"]].
327 327  
342 +
328 328  === 3.3.3 Configure read commands for each sampling ===
329 329  
330 330  (((
... ... @@ -422,7 +422,7 @@
422 422  
423 423  **Examples:**
424 424  
425 -1. For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
440 +1For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
426 426  
427 427  If we set AT+SEARCH1=1,1E 56 34.      (max 5 bytes for prefix)
428 428  
... ... @@ -430,7 +430,7 @@
430 430  
431 431  [[image:1653271044481-711.png]]
432 432  
433 -1. For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
448 +2)For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
434 434  
435 435  If we set AT+SEARCH1=2, 1E 56 34+31 00 49
436 436  
... ... @@ -449,16 +449,18 @@
449 449  * **c: define the position for valid value.  **
450 450  )))
451 451  
452 -Examples:
467 +**Examples:**
453 453  
454 454  * Grab bytes:
455 455  
456 456  [[image:1653271581490-837.png||height="313" width="722"]]
457 457  
473 +
458 458  * Grab a section.
459 459  
460 460  [[image:1653271648378-342.png||height="326" width="720"]]
461 461  
478 +
462 462  * Grab different sections.
463 463  
464 464  [[image:1653271657255-576.png||height="305" width="730"]]
... ... @@ -501,6 +501,7 @@
501 501  
502 502  [[image:1653271763403-806.png]]
503 503  
521 +
504 504  === 3.3.4 Compose the uplink payload ===
505 505  
506 506  (((
... ... @@ -508,7 +508,7 @@
508 508  )))
509 509  
510 510  (((
511 -(% style="color:#4f81bd" %)**Examples: AT+DATAUP=0**
529 +(% style="color:#037691" %)**Examples: AT+DATAUP=0**
512 512  )))
513 513  
514 514  (((
... ... @@ -520,7 +520,7 @@
520 520  )))
521 521  
522 522  (((
523 -(% style="color:#4f81bd" %)Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx
541 +(% style="color:#4f81bd" %)**Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx**
524 524  )))
525 525  
526 526  (((
... ... @@ -529,8 +529,12 @@
529 529  
530 530  [[image:1653272787040-634.png||height="515" width="719"]]
531 531  
550 +
551 +
532 532  (((
533 -(% style="color:#4f81bd" %)**Examples: AT+DATAUP=1**
553 +(% style="color:#037691" %)**Examples: AT+DATAUP=1**
554 +
555 +
534 534  )))
535 535  
536 536  (((
... ... @@ -542,7 +542,7 @@
542 542  )))
543 543  
544 544  (((
545 -(% style="color:#4f81bd" %)Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA
567 +(% style="color:#4f81bd" %)**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
546 546  )))
547 547  
548 548  1. (((
... ... @@ -575,6 +575,7 @@
575 575  
576 576  [[image:1653272901032-107.png]]
577 577  
600 +
578 578  (% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
579 579  
580 580   ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
... ... @@ -609,66 +609,97 @@
609 609  
610 610  [[image:1653273818896-432.png]]
611 611  
635 +(((
612 612  AT+INTMOD=0  Disable Interrupt
637 +)))
613 613  
639 +(((
614 614  AT+INTMOD=1  Interrupt trigger by rising or falling edge.
641 +)))
615 615  
643 +(((
616 616  AT+INTMOD=2  Interrupt trigger by falling edge. ( Default Value)
645 +)))
617 617  
647 +(((
618 618  AT+INTMOD=3  Interrupt trigger by rising edge.
649 +)))
619 619  
620 620  == 3.4 Uplink Payload ==
621 621  
622 -|**Size(bytes)**|**2**|**1**|**Length depends on the return from the commands**
623 -|Value|(((
653 +(% border="1" style="background-color:#4f81bd; color:white; width:850px" %)
654 +|**Size(bytes)**|(% style="width:130px" %)**2**|(% style="width:93px" %)**1**|(% style="width:509px" %)**Length depends on the return from the commands**
655 +|Value|(% style="width:130px" %)(((
656 +(((
624 624  Battery(mV)
658 +)))
625 625  
660 +(((
626 626  &
662 +)))
627 627  
664 +(((
628 628  Interrupt _Flag
629 -)))|(((
666 +)))
667 +)))|(% style="width:93px" %)(((
630 630  PAYLOAD_VER
631 631  
632 632  
633 -)))|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.
671 +)))|(% 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.
634 634  
635 635  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
636 636  
637 -
675 +(((
638 638  function Decoder(bytes, port) {
677 +)))
639 639  
679 +(((
640 640  ~/~/Payload Formats of RS485-BL Deceive
681 +)))
641 641  
683 +(((
642 642  return {
685 +)))
643 643  
687 +(((
644 644   ~/~/Battery,units:V
689 +)))
645 645  
691 +(((
646 646   BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,
693 +)))
647 647  
695 +(((
648 648   ~/~/GPIO_EXTI 
697 +)))
649 649  
699 +(((
650 650   EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",
701 +)))
651 651  
703 +(((
652 652   ~/~/payload of version
705 +)))
653 653  
707 +(((
654 654   Pay_ver:bytes[2],
709 +)))
655 655  
711 +(((
656 656   };
713 +)))
657 657  
715 +(((
658 658   }
717 +)))
659 659  
660 -
661 -
662 -
663 -
664 -
665 -
719 +(((
666 666  TTN V3 uplink screen shot.
721 +)))
667 667  
668 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
723 +[[image:1653274001211-372.png||height="192" width="732"]]
669 669  
670 -1.
671 -11. Configure RS485-BL via AT or Downlink
725 +== 3.5 Configure RS485-BL via AT or Downlink ==
672 672  
673 673  User can configure RS485-BL via [[AT Commands >>path:#_​Using_the_AT]]or LoRaWAN Downlink Commands
674 674  
... ... @@ -678,15 +678,15 @@
678 678  
679 679  * **Sensor Related Commands**: These commands are special designed for RS485-BL.  User can see these commands below:
680 680  
681 -1.
682 -11.
735 +1.
736 +11.
683 683  111. Common Commands:
684 684  
685 685  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]]
686 686  
687 687  
688 -1.
689 -11.
742 +1.
743 +11.
690 690  111. Sensor related commands:
691 691  
692 692  ==== Choose Device Type (RS485 or TTL) ====
... ... @@ -992,13 +992,13 @@
992 992  
993 993  
994 994  
995 -1.
1049 +1.
996 996  11. Buttons
997 997  
998 998  |**Button**|**Feature**
999 999  |**RST**|Reboot RS485-BL
1000 1000  
1001 -1.
1055 +1.
1002 1002  11. +3V3 Output
1003 1003  
1004 1004  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
... ... @@ -1016,7 +1016,7 @@
1016 1016  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1017 1017  
1018 1018  
1019 -1.
1073 +1.
1020 1020  11. +5V Output
1021 1021  
1022 1022  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
... ... @@ -1036,13 +1036,13 @@
1036 1036  
1037 1037  
1038 1038  
1039 -1.
1093 +1.
1040 1040  11. LEDs
1041 1041  
1042 1042  |**LEDs**|**Feature**
1043 1043  |**LED1**|Blink when device transmit a packet.
1044 1044  
1045 -1.
1099 +1.
1046 1046  11. Switch Jumper
1047 1047  
1048 1048  |**Switch Jumper**|**Feature**
... ... @@ -1088,7 +1088,7 @@
1088 1088  
1089 1089  
1090 1090  
1091 -1.
1145 +1.
1092 1092  11. Common AT Command Sequence
1093 1093  111. Multi-channel ABP mode (Use with SX1301/LG308)
1094 1094  
... ... @@ -1107,8 +1107,8 @@
1107 1107  
1108 1108  ATZ
1109 1109  
1110 -1.
1111 -11.
1164 +1.
1165 +11.
1112 1112  111. Single-channel ABP mode (Use with LG01/LG02)
1113 1113  
1114 1114  AT+FDR   Reset Parameters to Factory Default, Keys Reserve
... ... @@ -1183,7 +1183,7 @@
1183 1183  [[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]]
1184 1184  
1185 1185  
1186 -1.
1240 +1.
1187 1187  11. How to change the LoRa Frequency Bands/Region?
1188 1188  
1189 1189  User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download.
... ... @@ -1190,7 +1190,7 @@
1190 1190  
1191 1191  
1192 1192  
1193 -1.
1247 +1.
1194 1194  11. How many RS485-Slave can RS485-BL connects?
1195 1195  
1196 1196  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]].
... ... @@ -1207,7 +1207,7 @@
1207 1207  
1208 1208  
1209 1209  
1210 -1.
1264 +1.
1211 1211  11. Why I can’t join TTN V3 in US915 /AU915 bands?
1212 1212  
1213 1213  It might about the channels mapping. Please see for detail.
1653274001211-372.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +91.4 KB
Content