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

From version 27.1
edited by Xiaoling
on 2022/05/23 10:28
Change comment: Uploaded new attachment "1653272901032-107.png", version {1}
To version 29.15
edited by Xiaoling
on 2022/06/01 18:05
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,6 +51,8 @@
51 51  
52 52  [[image:1652953304999-717.png||height="424" width="733"]]
53 53  
57 +
58 +
54 54  == 1.2 Specifications ==
55 55  
56 56  **Hardware System:**
... ... @@ -90,6 +90,7 @@
90 90  * 127 dB Dynamic Range RSSI.
91 91  * Automatic RF Sense and CAD with ultra-fast AFC. ​​​
92 92  
98 +
93 93  == 1.3 Features ==
94 94  
95 95  * LoRaWAN Class A & Class C protocol (default Class A)
... ... @@ -101,6 +101,7 @@
101 101  * Support Modbus protocol
102 102  * Support Interrupt uplink
103 103  
110 +
104 104  == 1.4 Applications ==
105 105  
106 106  * Smart Buildings & Home Automation
... ... @@ -110,10 +110,12 @@
110 110  * Smart Cities
111 111  * Smart Factory
112 112  
120 +
113 113  == 1.5 Firmware Change log ==
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  
125 +
117 117  == 1.6 Hardware Change log ==
118 118  
119 119  (((
... ... @@ -140,6 +140,8 @@
140 140  
141 141  (((
142 142  Release version ​​​​​
152 +
153 +
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  
167 +
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.
174 +
175 +
162 162  )))
163 163  
164 164  == 3.2 Example to join LoRaWAN network ==
... ... @@ -222,7 +222,9 @@
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.
239 +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.
240 +
241 +
226 226  )))
227 227  
228 228  === 3.3.1 onfigure UART settings for RS485 or TTL communication ===
... ... @@ -565,21 +565,18 @@
565 565  
566 566  So totally there will be 3 uplinks for this sampling, each uplink includes 6 bytes DATA
567 567  
568 -DATA1=RETURN1 Valid Value = ~(% style="background-color:#4f81bd;color:white" %)(% style="display:none" %) (%%)20 20 0a 33 90 41
584 +DATA1=RETURN1 Valid Value = (% style="background-color:#4f81bd; color:white" %) 20 20 0a 33 90 41
569 569  
570 -DATA2=1^^st^^ ~~ 6^^th^^ byte of Valid value of RETURN10= ~(% style="background-color:#4f81bd;color:white" %)(% style="display:none" %) (%%)02 aa 05 81 0a 20
586 +DATA2=1^^st^^ ~~ 6^^th^^ byte of Valid value of RETURN10= (% style="background-color:#4f81bd; color:white" %)02 aa 05 81 0a 20
571 571  
572 -DATA3=7^^th^^ ~~ 11^^th^^ bytes of Valid value of RETURN10 =~(% style="background-color:#4f81bd;color:white" %)(% style="display:none" %) (%%) 20 20 20 2d 30
588 +DATA3=7^^th^^ ~~ 11^^th^^ bytes of Valid value of RETURN10 =(% style="background-color:#4f81bd; color:white" %) 20 20 20 2d 30
573 573  
574 -
575 -
576 576  Below are the uplink payloads:
577 577  
578 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]]
592 +[[image:1653272901032-107.png]]
579 579  
594 +(% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
580 580  
581 -Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
582 -
583 583   ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
584 584  
585 585   * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
... ... @@ -588,90 +588,121 @@
588 588  
589 589   ~* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
590 590  
604 +=== 3.3.5 Uplink on demand ===
591 591  
592 -
593 -1.
594 -11.
595 -111. Uplink on demand
596 -
606 +(((
597 597  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.
608 +)))
598 598  
610 +(((
599 599  Downlink control command:
612 +)))
600 600  
601 -[[0x08 command>>path:#downlink_08]]: Poll an uplink with current command set in RS485-BL.
614 +(((
615 +**0x08 command**: Poll an uplink with current command set in RS485-BL.
616 +)))
602 602  
603 -[[0xA8 command>>path:#downlink_A8]]: Send a command to RS485-BL and uplink the output from sensors.
618 +(((
619 +**0xA8 command**: Send a command to RS485-BL and uplink the output from sensors.
620 +)))
604 604  
622 +=== 3.3.6 Uplink on Interrupt ===
605 605  
624 +Put the interrupt sensor between 3.3v_out and GPIO ext.
606 606  
607 -1.
608 -11.
609 -111. Uplink on Interrupt
626 +[[image:1653273818896-432.png]]
610 610  
611 -Put the interrupt sensor between 3.3v_out and GPIO ext.[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]]
612 -
628 +(((
613 613  AT+INTMOD=0  Disable Interrupt
630 +)))
614 614  
632 +(((
615 615  AT+INTMOD=1  Interrupt trigger by rising or falling edge.
634 +)))
616 616  
636 +(((
617 617  AT+INTMOD=2  Interrupt trigger by falling edge. ( Default Value)
638 +)))
618 618  
640 +(((
619 619  AT+INTMOD=3  Interrupt trigger by rising edge.
642 +)))
620 620  
644 +== 3.4 Uplink Payload ==
621 621  
622 -1.
623 -11. Uplink Payload
624 -
625 -|**Size(bytes)**|**2**|**1**|**Length depends on the return from the commands**
626 -|Value|(((
646 +(% border="1" style="background-color:#4f81bd; color:white; width:850px" %)
647 +|**Size(bytes)**|(% style="width:130px" %)**2**|(% style="width:93px" %)**1**|(% style="width:509px" %)**Length depends on the return from the commands**
648 +|Value|(% style="width:130px" %)(((
649 +(((
627 627  Battery(mV)
651 +)))
628 628  
653 +(((
629 629  &
655 +)))
630 630  
657 +(((
631 631  Interrupt _Flag
632 -)))|(((
659 +)))
660 +)))|(% style="width:93px" %)(((
633 633  PAYLOAD_VER
634 634  
635 635  
636 -)))|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.
664 +)))|(% 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.
637 637  
638 638  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
639 639  
640 -
668 +(((
641 641  function Decoder(bytes, port) {
670 +)))
642 642  
672 +(((
643 643  ~/~/Payload Formats of RS485-BL Deceive
674 +)))
644 644  
676 +(((
645 645  return {
678 +)))
646 646  
680 +(((
647 647   ~/~/Battery,units:V
682 +)))
648 648  
684 +(((
649 649   BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,
686 +)))
650 650  
688 +(((
651 651   ~/~/GPIO_EXTI 
690 +)))
652 652  
692 +(((
653 653   EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",
694 +)))
654 654  
696 +(((
655 655   ~/~/payload of version
698 +)))
656 656  
700 +(((
657 657   Pay_ver:bytes[2],
702 +)))
658 658  
704 +(((
659 659   };
706 +)))
660 660  
708 +(((
661 661   }
710 +)))
662 662  
663 -
664 -
665 -
666 -
667 -
668 -
712 +(((
669 669  TTN V3 uplink screen shot.
714 +)))
670 670  
671 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
716 +[[image:1653274001211-372.png||height="192" width="732"]]
672 672  
673 -1.
674 -11. Configure RS485-BL via AT or Downlink
718 +== 3.5 Configure RS485-BL via AT or Downlink ==
675 675  
676 676  User can configure RS485-BL via [[AT Commands >>path:#_​Using_the_AT]]or LoRaWAN Downlink Commands
677 677  
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