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

From version 29.2
edited by Xiaoling
on 2022/05/23 10:47
Change comment: There is no comment for this version
To version 33.5
edited by Xiaoling
on 2022/06/02 10:01
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 ===
... ... @@ -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]].
339 +Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>||anchor="HRS485DebugCommand28AT2BCFGDEV29"]].
327 327  
341 +
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
439 +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
447 +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:
466 +**Examples:**
453 453  
454 454  * Grab bytes:
455 455  
456 456  [[image:1653271581490-837.png||height="313" width="722"]]
457 457  
472 +
458 458  * Grab a section.
459 459  
460 460  [[image:1653271648378-342.png||height="326" width="720"]]
461 461  
477 +
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  
520 +
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**
528 +(% 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
540 +(% 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  
549 +
550 +
532 532  (((
533 -(% style="color:#4f81bd" %)**Examples: AT+DATAUP=1**
552 +(% style="color:#037691" %)**Examples: AT+DATAUP=1**
553 +
554 +
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
566 +(% style="color:#4f81bd" %)**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
546 546  )))
547 547  
548 548  1. (((
... ... @@ -565,6 +565,7 @@
565 565  
566 566  So totally there will be 3 uplinks for this sampling, each uplink includes 6 bytes DATA
567 567  
589 +
568 568  DATA1=RETURN1 Valid Value = (% style="background-color:#4f81bd; color:white" %) 20 20 0a 33 90 41
569 569  
570 570  DATA2=1^^st^^ ~~ 6^^th^^ byte of Valid value of RETURN10= (% style="background-color:#4f81bd; color:white" %)02 aa 05 81 0a 20
... ... @@ -571,10 +571,12 @@
571 571  
572 572  DATA3=7^^th^^ ~~ 11^^th^^ bytes of Valid value of RETURN10 =(% style="background-color:#4f81bd; color:white" %) 20 20 20 2d 30
573 573  
596 +
574 574  Below are the uplink payloads:
575 575  
576 576  [[image:1653272901032-107.png]]
577 577  
601 +
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)
... ... @@ -585,6 +585,8 @@
585 585  
586 586   ~* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
587 587  
612 +
613 +
588 588  === 3.3.5 Uplink on demand ===
589 589  
590 590  (((
... ... @@ -601,6 +601,8 @@
601 601  
602 602  (((
603 603  **0xA8 command**: Send a command to RS485-BL and uplink the output from sensors.
630 +
631 +
604 604  )))
605 605  
606 606  === 3.3.6 Uplink on Interrupt ===
... ... @@ -609,6 +609,7 @@
609 609  
610 610  [[image:1653273818896-432.png]]
611 611  
640 +
612 612  (((
613 613  AT+INTMOD=0  Disable Interrupt
614 614  )))
... ... @@ -623,6 +623,8 @@
623 623  
624 624  (((
625 625  AT+INTMOD=3  Interrupt trigger by rising edge.
655 +
656 +
626 626  )))
627 627  
628 628  == 3.4 Uplink Payload ==
... ... @@ -650,47 +650,49 @@
650 650  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
651 651  
652 652  (((
653 -function Decoder(bytes, port) {
684 +{{{function Decoder(bytes, port) {}}}
654 654  )))
655 655  
656 656  (((
657 -~/~/Payload Formats of RS485-BL Deceive
688 +{{{//Payload Formats of RS485-BL Deceive}}}
658 658  )))
659 659  
660 660  (((
661 -return {
692 +{{{return {}}}
662 662  )))
663 663  
664 664  (((
665 - ~/~/Battery,units:V
696 +{{{ //Battery,units:V}}}
666 666  )))
667 667  
668 668  (((
669 - BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,
700 +{{{ BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,}}}
670 670  )))
671 671  
672 672  (((
673 - ~/~/GPIO_EXTI 
704 +{{{ //GPIO_EXTI }}}
674 674  )))
675 675  
676 676  (((
677 - EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",
708 +{{{ EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",}}}
678 678  )))
679 679  
680 680  (((
681 - ~/~/payload of version
712 +{{{ //payload of version}}}
682 682  )))
683 683  
684 684  (((
685 - Pay_ver:bytes[2],
716 +{{{ Pay_ver:bytes[2],}}}
686 686  )))
687 687  
688 688  (((
689 - };
720 +{{{ }; }}}
690 690  )))
691 691  
692 692  (((
693 - }
724 +}
725 +
726 +
694 694  )))
695 695  
696 696  (((
... ... @@ -699,59 +699,65 @@
699 699  
700 700  [[image:1653274001211-372.png||height="192" width="732"]]
701 701  
702 -1.
703 -11. Configure RS485-BL via AT or Downlink
704 704  
705 -User can configure RS485-BL via [[AT Commands >>path:#_​Using_the_AT]]or LoRaWAN Downlink Commands
736 +== 3.5 Configure RS485-BL via AT or Downlink ==
706 706  
738 +User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands
739 +
707 707  There are two kinds of Commands:
708 708  
709 -* **Common Commands**: They should be available for each sensor, 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
742 +* (% style="color:#4f81bd" %)**Common Commands**(%%): They should be available for each sensor, 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]]
710 710  
711 -* **Sensor Related Commands**: These commands are special designed for RS485-BL.  User can see these commands below:
744 +* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
712 712  
713 -1.
714 -11.
715 -111. Common Commands:
746 +=== 3.5.1 Common Commands: ===
716 716  
717 -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]]
748 +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]]
718 718  
719 719  
720 -1.
721 -11.
722 -111. Sensor related commands:
751 +=== 3.5.2 Sensor related commands: ===
723 723  
724 -==== Choose Device Type (RS485 or TTL) ====
753 +==== ====
725 725  
755 +==== **Choose Device Type (RS485 or TTL)** ====
756 +
726 726  RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
727 727  
728 -* AT Command
759 +* **AT Command**
729 729  
761 +(% class="box infomessage" %)
762 +(((
730 730  **AT+MOD=1** ~/~/ Set to support RS485-MODBUS type sensors. User can connect multiply RS485 , Modbus sensors to the A / B pins.
764 +)))
731 731  
766 +(% class="box infomessage" %)
767 +(((
732 732  **AT+MOD=2** ~/~/ Set to support TTL Level sensors, User can connect one TTL Sensor to the TXD/RXD/GND pins.
769 +)))
733 733  
734 734  
735 -* Downlink Payload
772 +* **Downlink Payload**
736 736  
737 -**0A aa**     à same as AT+MOD=aa
774 +**0A aa**  ~-~->  same as AT+MOD=aa
738 738  
739 739  
740 740  
741 -==== [[RS485 Debug Command>>path:#downlink_A8]] (AT+CFGDEV) ====
778 +==== **RS485 Debug Command (AT+CFGDEV)** ====
742 742  
743 743  This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
744 744  
745 -* AT Command
782 +* **AT Command**
746 746  
747 -AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
784 +(% class="box infomessage" %)
785 +(((
786 +**AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
787 +)))
748 748  
749 749  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
750 750  
751 751  
792 +* **Downlink Payload**
752 752  
753 -* Downlink Payload
754 -
755 755  Format: A8 MM NN XX XX XX XX YY
756 756  
757 757  Where:
... ... @@ -765,15 +765,15 @@
765 765  
766 766  To connect a Modbus Alarm with below commands.
767 767  
768 -* The command to active alarm is: 0A 05 00 04 00 01 4C B0. Where 0A 05 00 04 00 01 is the Modbus command to read the register 00 40 where stored the DI status. The 4C B0 is the CRC-16/MODBUS which calculate manually.
807 +* The command to active alarm is: 0A 05 00 04 00 01 **4C B0**. Where 0A 05 00 04 00 01 is the Modbus command to read the register 00 40 where stored the DI status. The 4C B0 is the CRC-16/MODBUS which calculate manually.
769 769  
770 -* The command to deactivate alarm is: 0A 05 00 04 00 00 8D 70. Where 0A 05 00 04 00 00 is the Modbus command to read the register 00 40 where stored the DI status. The 8D 70 is the CRC-16/MODBUS which calculate manually.
809 +* The command to deactivate alarm is: 0A 05 00 04 00 00 **8D 70**. Where 0A 05 00 04 00 00 is the Modbus command to read the register 00 40 where stored the DI status. The 8D 70 is the CRC-16/MODBUS which calculate manually.
771 771  
772 772  So if user want to use downlink command to control to RS485 Alarm, he can use:
773 773  
774 -**A8 01 06 0A 05 00 04 00 01 00**: to activate the RS485 Alarm
813 +(% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
775 775  
776 -**A8 01 06 0A 05 00 04 00 00 00**: to deactivate the RS485 Alarm
815 +(% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
777 777  
778 778  A8 is type code and 01 means add CRC-16/MODBUS at the end, the 3^^rd^^ byte is 06, means the next 6 bytes are the command to be sent to the RS485 network, the final byte 00 means this command don’t need to acquire output.
779 779  
... ... @@ -782,48 +782,60 @@
782 782  
783 783  Check TTL Sensor return:
784 784  
785 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]]
824 +[[image:1654132684752-193.png]]
786 786  
787 787  
788 788  
828 +==== **Set Payload version** ====
789 789  
790 -==== Set Payload version ====
791 -
792 792  This is the first byte of the uplink payload. RS485-BL can connect to different sensors. User can set the PAYVER field to tell server how to decode the current payload.
793 793  
794 -* AT Command:
832 +* **AT Command:**
795 795  
796 -AT+PAYVER: Set PAYVER field = 1
834 +(% class="box infomessage" %)
835 +(((
836 +**AT+PAYVER: Set PAYVER field = 1**
837 +)))
797 797  
798 798  
799 -* Downlink Payload:
840 +* **Downlink Payload:**
800 800  
801 -0xAE 01   à Set PAYVER field =  0x01
842 +**0xAE 01**  ~-~-> Set PAYVER field =  0x01
802 802  
803 -0xAE 0F   à Set PAYVER field =  0x0F
844 +**0xAE 0F**   ~-~-> Set PAYVER field =  0x0F
804 804  
805 805  
806 -==== Set RS485 Sampling Commands ====
807 807  
848 +==== **Set RS485 Sampling Commands** ====
849 +
808 808  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
809 809  
810 -These three commands are used to configure how the RS485-BL polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>path:#polling_485]].
852 +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"]].
811 811  
812 812  
813 -* AT Command:
855 +* **AT Command:**
814 814  
815 -AT+COMMANDx: Configure RS485 read command to sensor.
857 +(% class="box infomessage" %)
858 +(((
859 +**AT+COMMANDx: Configure RS485 read command to sensor.**
860 +)))
816 816  
817 -AT+DATACUTx: Configure how to handle return from RS485 devices.
862 +(% class="box infomessage" %)
863 +(((
864 +**AT+DATACUTx: Configure how to handle return from RS485 devices.**
865 +)))
818 818  
819 -AT+SEARCHx: Configure search command
867 +(% class="box infomessage" %)
868 +(((
869 +**AT+SEARCHx: Configure search command**
870 +)))
820 820  
821 821  
822 -* Downlink Payload:
873 +* **Downlink Payload:**
823 823  
824 -0xAF downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
875 +**0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
825 825  
826 -Note: if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
877 +(% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
827 827  
828 828  Format: AF MM NN LL XX XX XX XX YY
829 829  
... ... @@ -830,23 +830,23 @@
830 830  Where:
831 831  
832 832  * MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
833 -* NN: 0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
834 -* LL: The length of AT+COMMAND or AT+DATACUT command
884 +* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
885 +* LL:  The length of AT+COMMAND or AT+DATACUT command
835 835  * XX XX XX XX: AT+COMMAND or AT+DATACUT command
836 -* 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.
887 +* 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.
837 837  
838 -Example:
889 +**Example:**
839 839  
840 -**AF 03 01 06 0A 05 00 04 00 01 00**: Same as AT+COMMAND3=0A 05 00 04 00 01,1
891 +(% 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
841 841  
842 -**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10**
893 +(% 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**
843 843  
844 -**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~10**
895 +(% 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**
845 845  
846 846  
847 -0xAB downlink command can be used for set AT+SEARCHx
898 +**0xAB** downlink command can be used for set AT+SEARCHx
848 848  
849 -Example: **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
900 +**Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
850 850  
851 851  * AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
852 852  * 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
... ... @@ -854,145 +854,164 @@
854 854  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
855 855  
856 856  
857 -==== Fast command to handle MODBUS device ====
858 858  
909 +==== **Fast command to handle MODBUS device** ====
910 +
859 859  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]].
860 860  
861 861  This command is valid since v1.3 firmware version
862 862  
863 863  
864 -AT+MBFUN has only two value:
916 +**AT+MBFUN has only two value:**
865 865  
866 -* AT+MBFUN=1: Enable Modbus reading. And get response base on the MODBUS return
918 +* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
867 867  
868 868  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.
869 869  
870 -* AT+MBFUN=0: Disable Modbus fast reading.
922 +* **AT+MBFUN=0**: Disable Modbus fast reading.
871 871  
872 -Example:
924 +**Example:**
873 873  
874 874  * AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
875 875  * 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.
876 876  * 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.
877 877  
878 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
930 +[[image:1654133913295-597.png]]
879 879  
880 880  
881 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
933 +[[image:1654133954153-643.png]]
882 882  
883 883  
884 -* Downlink Commands:
936 +* **Downlink Commands:**
885 885  
886 -A9 aa -à Same as AT+MBFUN=aa
938 +**A9 aa** ~-~-> Same as AT+MBFUN=aa
887 887  
888 888  
889 -==== RS485 command timeout ====
890 890  
942 +==== **RS485 command timeout** ====
943 +
891 891  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.
892 892  
893 893  Default value: 0, range:  0 ~~ 5 seconds
894 894  
895 895  
896 -* AT Command:
949 +* **AT Command:**
897 897  
898 -AT+CMDDLaa=hex(bb cc)
951 +(% class="box infomessage" %)
952 +(((
953 +**AT+CMDDLaa=hex(bb cc)**
954 +)))
899 899  
900 -Example:
956 +**Example:**
901 901  
902 902  **AT+CMDDL1=1000** to send the open time to 1000ms
903 903  
904 904  
905 -* Downlink Payload:
961 +* **Downlink Payload:**
906 906  
907 907  0x AA aa bb cc
908 908  
909 909  Same as: AT+CMDDLaa=hex(bb cc)
910 910  
911 - Example:
967 + **Example:**
912 912  
913 - 0xAA 01 03 E8  à Same as **AT+CMDDL1=1000 ms**
969 + **0xAA 01 03 E8**  ~-~-> Same as **AT+CMDDL1=1000 ms**
914 914  
915 915  
916 -==== [[Uplink>>path:#downlink_A8]] payload mode ====
917 917  
973 +==== **Uplink payload mode** ====
974 +
918 918  Define to use one uplink or multiple uplinks for the sampling.
919 919  
920 -The use of this command please see: [[Compose Uplink payload>>path:#DataUP]]
977 +The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
921 921  
922 -* AT Command:
979 +* **AT Command:**
923 923  
924 -AT+DATAUP=0
981 +(% class="box infomessage" %)
982 +(((
983 +**AT+DATAUP=0**
984 +)))
925 925  
926 -AT+DATAUP=1
986 +(% class="box infomessage" %)
987 +(((
988 +**AT+DATAUP=1**
989 +)))
927 927  
928 928  
929 -* Downlink Payload:
992 +* **Downlink Payload:**
930 930  
931 -0xAD 00   à Same as AT+DATAUP=0
994 +**0xAD 00**  **~-~->** Same as AT+DATAUP=0
932 932  
933 -0xAD 01   à Same as AT+DATAUP=1
996 +**0xAD 01**  **~-~->** Same as AT+DATAUP=1
934 934  
935 935  
936 -==== Manually trigger an Uplink ====
937 937  
1000 +==== **Manually trigger an Uplink** ====
1001 +
938 938  Ask device to send an uplink immediately.
939 939  
940 -* Downlink Payload:
1004 +* **Downlink Payload:**
941 941  
942 -0x08 FF, RS485-BL will immediately send an uplink.
1006 +**0x08 FF**, RS485-BL will immediately send an uplink.
943 943  
944 944  
945 -==== Clear RS485 Command ====
946 946  
1010 +==== **Clear RS485 Command** ====
1011 +
947 947  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
948 948  
949 949  
950 -* AT Command:
1015 +* **AT Command:**
951 951  
952 -**AT+CMDEAR=mm,nn**   mm: start position of erase ,nn: stop position of erase
1017 +(% 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
953 953  
954 -Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
955 -
956 956  Example screen shot after clear all RS485 commands. 
957 957  
958 958  
959 -
960 960  The uplink screen shot is:
961 961  
962 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
1024 +[[image:1654134704555-320.png]]
963 963  
964 964  
965 -* Downlink Payload:
1027 +* **Downlink Payload:**
966 966  
967 -0x09 aa bb same as AT+CMDEAR=aa,bb
1029 +**0x09 aa bb** same as AT+CMDEAR=aa,bb
968 968  
969 969  
970 -==== Set Serial Communication Parameters ====
971 971  
1033 +==== **Set Serial Communication Parameters** ====
1034 +
972 972  Set the Rs485 serial communication parameters:
973 973  
974 -* AT Command:
1037 +* **AT Command:**
975 975  
976 976  Set Baud Rate:
977 977  
978 -AT+BAUDR=9600    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1041 +(% class="box infomessage" %)
1042 +(((
1043 +**AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1044 +)))
979 979  
1046 +Set UART Parity
980 980  
981 -Set UART parity
1048 +(% class="box infomessage" %)
1049 +(((
1050 +**AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1051 +)))
982 982  
983 -AT+PARITY=0    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
984 -
985 -
986 986  Set STOPBIT
987 987  
988 -AT+STOPBIT=0    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1055 +(% class="box infomessage" %)
1056 +(((
1057 +**AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1058 +)))
989 989  
990 990  
991 -* Downlink Payload:
1061 +* **Downlink Payload:**
992 992  
993 -A7 01 aa bb: Same  AT+BAUDR=hex(aa bb)*100
1063 +**A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
994 994  
995 -Example:
1065 +**Example:**
996 996  
997 997  * A7 01 00 60   same as AT+BAUDR=9600
998 998  * A7 01 04 80  same as AT+BAUDR=115200
... ... @@ -1002,54 +1002,52 @@
1002 1002  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1003 1003  
1004 1004  
1005 -==== Control output power duration ====
1006 1006  
1076 +==== **Control output power duration** ====
1077 +
1007 1007  User can set the output power duration before each sampling.
1008 1008  
1009 -* AT Command:
1080 +* **AT Command:**
1010 1010  
1011 -Example:
1082 +**Example:**
1012 1012  
1013 -AT+3V3T=1000 ~/~/ 3V3 output power will open 1s before each sampling.
1084 +**AT+3V3T=1000**  ~/~/ 3V3 output power will open 1s before each sampling.
1014 1014  
1015 -AT+5VT=1000 ~/~/ +5V output power will open 1s before each sampling.
1086 +**AT+5VT=1000**  ~/~/ +5V output power will open 1s before each sampling.
1016 1016  
1017 1017  
1018 -* LoRaWAN Downlink Command:
1089 +* **LoRaWAN Downlink Command:**
1019 1019  
1020 -07 01 aa bb  Same as AT+5VT=(aa bb)
1091 +**07 01 aa bb**  Same as AT+5VT=(aa bb)
1021 1021  
1022 -07 02 aa bb  Same as AT+3V3T=(aa bb)
1093 +**07 02 aa bb**  Same as AT+3V3T=(aa bb)
1023 1023  
1024 1024  
1096 +== 3.6 Buttons ==
1025 1025  
1098 +(% border="1" style="background-color:#ffffcc; color:green; width:233px" %)
1099 +|=(% style="width: 89px;" %)**Button**|=(% style="width: 141px;" %)**Feature**
1100 +|(% style="width:89px" %)**RST**|(% style="width:141px" %)Reboot RS485-BL
1026 1026  
1027 -1.
1028 -11. Buttons
1029 1029  
1030 -|**Button**|**Feature**
1031 -|**RST**|Reboot RS485-BL
1103 +== 3.7 +3V3 Output ==
1032 1032  
1033 -1.
1034 -11. +3V3 Output
1035 -
1036 1036  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
1037 1037  
1038 1038  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 1039  
1040 -
1041 1041  The +3V3 output time can be controlled by AT Command.
1042 1042  
1043 -**AT+3V3T=1000**
1044 1044  
1045 -Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors.
1112 +(% style="color:#037691" %)**AT+3V3T=1000**
1046 1046  
1047 1047  
1115 +Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors.
1116 +
1048 1048  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1049 1049  
1050 1050  
1051 -1.
1052 -11. +5V Output
1120 +== 3.8 +5V Output ==
1053 1053  
1054 1054  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
1055 1055  
... ... @@ -1058,7 +1058,7 @@
1058 1058  
1059 1059  The 5V output time can be controlled by AT Command.
1060 1060  
1061 -**AT+5VT=1000**
1129 +(% style="color:#037691" %)**AT+5VT=1000**
1062 1062  
1063 1063  Means set 5V valid time to have 1000ms. So, the real 5V output will actually have 1000ms + sampling time for other sensors.
1064 1064  
... ... @@ -1067,15 +1067,12 @@
1067 1067  
1068 1068  
1069 1069  
1138 +== 3.9 LEDs ==
1070 1070  
1071 -1.
1072 -11. LEDs
1073 -
1074 1074  |**LEDs**|**Feature**
1075 1075  |**LED1**|Blink when device transmit a packet.
1076 1076  
1077 -1.
1078 -11. Switch Jumper
1143 +== 3.10 Switch Jumper ==
1079 1079  
1080 1080  |**Switch Jumper**|**Feature**
1081 1081  |**SW1**|(((
1654132684752-193.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +22.8 KB
Content
1654133913295-597.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +116.2 KB
Content
1654133954153-643.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +91.2 KB
Content
1654134704555-320.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +91.4 KB
Content