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

From version 28.1
edited by Xiaoling
on 2022/05/23 10:43
Change comment: Uploaded new attachment "1653273818896-432.png", version {1}
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. (((
... ... @@ -565,20 +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
590 +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
592 +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
594 +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]]
598 +[[image:1653272901032-107.png]]
579 579  
580 580  
581 -Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
601 +(% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
582 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  
... ... @@ -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  
611 +=== 3.3.5 Uplink on demand ===
591 591  
592 -
593 -1.
594 -11.
595 -111. Uplink on demand
596 -
613 +(((
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.
615 +)))
598 598  
617 +(((
599 599  Downlink control command:
619 +)))
600 600  
601 -[[0x08 command>>path:#downlink_08]]: Poll an uplink with current command set in RS485-BL.
621 +(((
622 +**0x08 command**: Poll an uplink with current command set in RS485-BL.
623 +)))
602 602  
603 -[[0xA8 command>>path:#downlink_A8]]: Send a command to RS485-BL and uplink the output from sensors.
625 +(((
626 +**0xA8 command**: Send a command to RS485-BL and uplink the output from sensors.
627 +)))
604 604  
629 +=== 3.3.6 Uplink on Interrupt ===
605 605  
631 +Put the interrupt sensor between 3.3v_out and GPIO ext.
606 606  
607 -1.
608 -11.
609 -111. Uplink on Interrupt
633 +[[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 -
635 +(((
613 613  AT+INTMOD=0  Disable Interrupt
637 +)))
614 614  
639 +(((
615 615  AT+INTMOD=1  Interrupt trigger by rising or falling edge.
641 +)))
616 616  
643 +(((
617 617  AT+INTMOD=2  Interrupt trigger by falling edge. ( Default Value)
645 +)))
618 618  
647 +(((
619 619  AT+INTMOD=3  Interrupt trigger by rising edge.
649 +)))
620 620  
651 +== 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|(((
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 +(((
627 627  Battery(mV)
658 +)))
628 628  
660 +(((
629 629  &
662 +)))
630 630  
664 +(((
631 631  Interrupt _Flag
632 -)))|(((
666 +)))
667 +)))|(% 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.
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.
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 -
675 +(((
641 641  function Decoder(bytes, port) {
677 +)))
642 642  
679 +(((
643 643  ~/~/Payload Formats of RS485-BL Deceive
681 +)))
644 644  
683 +(((
645 645  return {
685 +)))
646 646  
687 +(((
647 647   ~/~/Battery,units:V
689 +)))
648 648  
691 +(((
649 649   BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,
693 +)))
650 650  
695 +(((
651 651   ~/~/GPIO_EXTI 
697 +)))
652 652  
699 +(((
653 653   EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",
701 +)))
654 654  
703 +(((
655 655   ~/~/payload of version
705 +)))
656 656  
707 +(((
657 657   Pay_ver:bytes[2],
709 +)))
658 658  
711 +(((
659 659   };
713 +)))
660 660  
715 +(((
661 661   }
717 +)))
662 662  
663 -
664 -
665 -
666 -
667 -
668 -
719 +(((
669 669  TTN V3 uplink screen shot.
721 +)))
670 670  
671 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
723 +[[image:1653274001211-372.png||height="192" width="732"]]
672 672  
673 -1.
674 -11. Configure RS485-BL via AT or Downlink
725 +== 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  
... ... @@ -681,15 +681,15 @@
681 681  
682 682  * **Sensor Related Commands**: These commands are special designed for RS485-BL.  User can see these commands below:
683 683  
684 -1.
685 -11.
735 +1.
736 +11.
686 686  111. Common Commands:
687 687  
688 688  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]]
689 689  
690 690  
691 -1.
692 -11.
742 +1.
743 +11.
693 693  111. Sensor related commands:
694 694  
695 695  ==== Choose Device Type (RS485 or TTL) ====
... ... @@ -995,13 +995,13 @@
995 995  
996 996  
997 997  
998 -1.
1049 +1.
999 999  11. Buttons
1000 1000  
1001 1001  |**Button**|**Feature**
1002 1002  |**RST**|Reboot RS485-BL
1003 1003  
1004 -1.
1055 +1.
1005 1005  11. +3V3 Output
1006 1006  
1007 1007  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
... ... @@ -1019,7 +1019,7 @@
1019 1019  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1020 1020  
1021 1021  
1022 -1.
1073 +1.
1023 1023  11. +5V Output
1024 1024  
1025 1025  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
... ... @@ -1039,13 +1039,13 @@
1039 1039  
1040 1040  
1041 1041  
1042 -1.
1093 +1.
1043 1043  11. LEDs
1044 1044  
1045 1045  |**LEDs**|**Feature**
1046 1046  |**LED1**|Blink when device transmit a packet.
1047 1047  
1048 -1.
1099 +1.
1049 1049  11. Switch Jumper
1050 1050  
1051 1051  |**Switch Jumper**|**Feature**
... ... @@ -1091,7 +1091,7 @@
1091 1091  
1092 1092  
1093 1093  
1094 -1.
1145 +1.
1095 1095  11. Common AT Command Sequence
1096 1096  111. Multi-channel ABP mode (Use with SX1301/LG308)
1097 1097  
... ... @@ -1110,8 +1110,8 @@
1110 1110  
1111 1111  ATZ
1112 1112  
1113 -1.
1114 -11.
1164 +1.
1165 +11.
1115 1115  111. Single-channel ABP mode (Use with LG01/LG02)
1116 1116  
1117 1117  AT+FDR   Reset Parameters to Factory Default, Keys Reserve
... ... @@ -1186,7 +1186,7 @@
1186 1186  [[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]]
1187 1187  
1188 1188  
1189 -1.
1240 +1.
1190 1190  11. How to change the LoRa Frequency Bands/Region?
1191 1191  
1192 1192  User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download.
... ... @@ -1193,7 +1193,7 @@
1193 1193  
1194 1194  
1195 1195  
1196 -1.
1247 +1.
1197 1197  11. How many RS485-Slave can RS485-BL connects?
1198 1198  
1199 1199  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]].
... ... @@ -1210,7 +1210,7 @@
1210 1210  
1211 1211  
1212 1212  
1213 -1.
1264 +1.
1214 1214  11. Why I can’t join TTN V3 in US915 /AU915 bands?
1215 1215  
1216 1216  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