Skip to Content
Last modified by Xiaoling on 2025/04/23 15:57
From version 29.28
edited by Xiaoling
on 2022/06/02 08:54
Change comment: There is no comment for this version
To version 30.8
edited by Xiaoling
on 2022/06/02 09:37
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -316,8 +316,6 @@
316 316  )))
317 317  )))
318 318  
319 -
320 -
321 321  === 3.3.2 Configure sensors ===
322 322  
323 323  (((
... ... @@ -465,7 +465,6 @@
465 465  * **c: define the position for valid value.  **
466 466  )))
467 467  
468 -
469 469  **Examples:**
470 470  
471 471  * Grab bytes:
... ... @@ -477,6 +477,7 @@
477 477  
478 478  [[image:1653271648378-342.png||height="326" width="720"]]
479 479  
477 +
480 480  * Grab different sections.
481 481  
482 482  [[image:1653271657255-576.png||height="305" width="730"]]
... ... @@ -519,6 +519,7 @@
519 519  
520 520  [[image:1653271763403-806.png]]
521 521  
520 +
522 522  === 3.3.4 Compose the uplink payload ===
523 523  
524 524  (((
... ... @@ -526,7 +526,7 @@
526 526  )))
527 527  
528 528  (((
529 -(% style="color:#4f81bd" %)**Examples: AT+DATAUP=0**
528 +(% style="color:#037691" %)**Examples: AT+DATAUP=0**
530 530  )))
531 531  
532 532  (((
... ... @@ -538,7 +538,7 @@
538 538  )))
539 539  
540 540  (((
541 -(% 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**
542 542  )))
543 543  
544 544  (((
... ... @@ -547,8 +547,12 @@
547 547  
548 548  [[image:1653272787040-634.png||height="515" width="719"]]
549 549  
549 +
550 +
550 550  (((
551 -(% style="color:#4f81bd" %)**Examples: AT+DATAUP=1**
552 +(% style="color:#037691" %)**Examples: AT+DATAUP=1**
553 +
554 +
552 552  )))
553 553  
554 554  (((
... ... @@ -560,7 +560,7 @@
560 560  )))
561 561  
562 562  (((
563 -(% style="color:#4f81bd" %)Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA
566 +(% style="color:#4f81bd" %)**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
564 564  )))
565 565  
566 566  1. (((
... ... @@ -583,6 +583,7 @@
583 583  
584 584  So totally there will be 3 uplinks for this sampling, each uplink includes 6 bytes DATA
585 585  
589 +
586 586  DATA1=RETURN1 Valid Value = (% style="background-color:#4f81bd; color:white" %) 20 20 0a 33 90 41
587 587  
588 588  DATA2=1^^st^^ ~~ 6^^th^^ byte of Valid value of RETURN10= (% style="background-color:#4f81bd; color:white" %)02 aa 05 81 0a 20
... ... @@ -589,10 +589,12 @@
589 589  
590 590  DATA3=7^^th^^ ~~ 11^^th^^ bytes of Valid value of RETURN10 =(% style="background-color:#4f81bd; color:white" %) 20 20 20 2d 30
591 591  
596 +
592 592  Below are the uplink payloads:
593 593  
594 594  [[image:1653272901032-107.png]]
595 595  
601 +
596 596  (% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
597 597  
598 598   ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
... ... @@ -603,6 +603,8 @@
603 603  
604 604   ~* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
605 605  
612 +
613 +
606 606  === 3.3.5 Uplink on demand ===
607 607  
608 608  (((
... ... @@ -619,6 +619,8 @@
619 619  
620 620  (((
621 621  **0xA8 command**: Send a command to RS485-BL and uplink the output from sensors.
630 +
631 +
622 622  )))
623 623  
624 624  === 3.3.6 Uplink on Interrupt ===
... ... @@ -627,6 +627,7 @@
627 627  
628 628  [[image:1653273818896-432.png]]
629 629  
640 +
630 630  (((
631 631  AT+INTMOD=0  Disable Interrupt
632 632  )))
... ... @@ -641,6 +641,8 @@
641 641  
642 642  (((
643 643  AT+INTMOD=3  Interrupt trigger by rising edge.
655 +
656 +
644 644  )))
645 645  
646 646  == 3.4 Uplink Payload ==
... ... @@ -668,47 +668,49 @@
668 668  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
669 669  
670 670  (((
671 -function Decoder(bytes, port) {
684 +{{{function Decoder(bytes, port) {}}}
672 672  )))
673 673  
674 674  (((
675 -~/~/Payload Formats of RS485-BL Deceive
688 +{{{//Payload Formats of RS485-BL Deceive}}}
676 676  )))
677 677  
678 678  (((
679 -return {
692 +{{{return {}}}
680 680  )))
681 681  
682 682  (((
683 - ~/~/Battery,units:V
696 +{{{ //Battery,units:V}}}
684 684  )))
685 685  
686 686  (((
687 - BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,
700 +{{{ BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,}}}
688 688  )))
689 689  
690 690  (((
691 - ~/~/GPIO_EXTI 
704 +{{{ //GPIO_EXTI }}}
692 692  )))
693 693  
694 694  (((
695 - EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",
708 +{{{ EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",}}}
696 696  )))
697 697  
698 698  (((
699 - ~/~/payload of version
712 +{{{ //payload of version}}}
700 700  )))
701 701  
702 702  (((
703 - Pay_ver:bytes[2],
716 +{{{ Pay_ver:bytes[2],}}}
704 704  )))
705 705  
706 706  (((
707 - };
720 +{{{ }; }}}
708 708  )))
709 709  
710 710  (((
711 - }
724 +}
725 +
726 +
712 712  )))
713 713  
714 714  (((
... ... @@ -717,58 +717,65 @@
717 717  
718 718  [[image:1653274001211-372.png||height="192" width="732"]]
719 719  
735 +
720 720  == 3.5 Configure RS485-BL via AT or Downlink ==
721 721  
722 -User can configure RS485-BL via [[AT Commands >>path:#_​Using_the_AT]]or LoRaWAN Downlink Commands
738 +User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands
723 723  
724 724  There are two kinds of Commands:
725 725  
726 -* **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]]
727 727  
728 -* **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:
729 729  
730 -1.
731 -11.
732 -111. Common Commands:
746 +=== 3.5.1 Common Commands: ===
733 733  
734 -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]]
735 735  
736 736  
737 -1.
738 -11.
739 -111. Sensor related commands:
751 +=== 3.5.2 Sensor related commands: ===
740 740  
741 -==== Choose Device Type (RS485 or TTL) ====
753 +==== ====
742 742  
755 +==== **Choose Device Type (RS485 or TTL)** ====
756 +
743 743  RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
744 744  
745 -* AT Command
759 +* **AT Command**
746 746  
761 +(% class="box infomessage" %)
762 +(((
747 747  **AT+MOD=1** ~/~/ Set to support RS485-MODBUS type sensors. User can connect multiply RS485 , Modbus sensors to the A / B pins.
764 +)))
748 748  
766 +(% class="box infomessage" %)
767 +(((
749 749  **AT+MOD=2** ~/~/ Set to support TTL Level sensors, User can connect one TTL Sensor to the TXD/RXD/GND pins.
769 +)))
750 750  
751 751  
752 -* Downlink Payload
772 +* **Downlink Payload**
753 753  
754 -**0A aa**     à same as AT+MOD=aa
774 +**0A aa**  ~-~->  same as AT+MOD=aa
755 755  
756 756  
757 757  
758 -==== [[RS485 Debug Command>>path:#downlink_A8]] (AT+CFGDEV) ====
778 +==== **RS485 Debug Command (AT+CFGDEV)** ====
759 759  
760 760  This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
761 761  
762 -* AT Command
782 +* **AT Command**
763 763  
764 -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 +)))
765 765  
766 766  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
767 767  
768 768  
792 +* **Downlink Payload**
769 769  
770 -* Downlink Payload
771 -
772 772  Format: A8 MM NN XX XX XX XX YY
773 773  
774 774  Where:
... ... @@ -782,15 +782,15 @@
782 782  
783 783  To connect a Modbus Alarm with below commands.
784 784  
785 -* 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.
786 786  
787 -* 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.
788 788  
789 789  So if user want to use downlink command to control to RS485 Alarm, he can use:
790 790  
791 -**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
792 792  
793 -**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
794 794  
795 795  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.
796 796  
... ... @@ -799,48 +799,60 @@
799 799  
800 800  Check TTL Sensor return:
801 801  
802 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]]
824 +[[image:1654132684752-193.png]]
803 803  
804 804  
805 805  
828 +==== **Set Payload version** ====
806 806  
807 -==== Set Payload version ====
808 -
809 809  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.
810 810  
811 -* AT Command:
832 +* **AT Command:**
812 812  
813 -AT+PAYVER: Set PAYVER field = 1
834 +(% class="box infomessage" %)
835 +(((
836 +**AT+PAYVER: Set PAYVER field = 1**
837 +)))
814 814  
815 815  
816 -* Downlink Payload:
840 +* **Downlink Payload:**
817 817  
818 -0xAE 01   à Set PAYVER field =  0x01
842 +**0xAE 01**  ~-~-> Set PAYVER field =  0x01
819 819  
820 -0xAE 0F   à Set PAYVER field =  0x0F
844 +**0xAE 0F**   ~-~-> Set PAYVER field =  0x0F
821 821  
822 822  
823 -==== Set RS485 Sampling Commands ====
824 824  
848 +==== **Set RS485 Sampling Commands** ====
849 +
825 825  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
826 826  
827 -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"]].
828 828  
829 829  
830 -* AT Command:
855 +* **AT Command:**
831 831  
832 -AT+COMMANDx: Configure RS485 read command to sensor.
857 +(% class="box infomessage" %)
858 +(((
859 +**AT+COMMANDx: Configure RS485 read command to sensor.**
860 +)))
833 833  
834 -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 +)))
835 835  
836 -AT+SEARCHx: Configure search command
867 +(% class="box infomessage" %)
868 +(((
869 +**AT+SEARCHx: Configure search command**
870 +)))
837 837  
838 838  
839 -* Downlink Payload:
873 +* **Downlink Payload:**
840 840  
841 -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.
842 842  
843 -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.
844 844  
845 845  Format: AF MM NN LL XX XX XX XX YY
846 846  
... ... @@ -847,23 +847,23 @@
847 847  Where:
848 848  
849 849  * MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
850 -* NN: 0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
851 -* 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
852 852  * XX XX XX XX: AT+COMMAND or AT+DATACUT command
853 -* 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.
854 854  
855 -Example:
889 +**Example:**
856 856  
857 -**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
858 858  
859 -**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**
860 860  
861 -**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**
862 862  
863 863  
864 -0xAB downlink command can be used for set AT+SEARCHx
898 +**0xAB** downlink command can be used for set AT+SEARCHx
865 865  
866 -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
867 867  
868 868  * AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
869 869  * 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
... ... @@ -871,6 +871,7 @@
871 871  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
872 872  
873 873  
908 +
874 874  ==== Fast command to handle MODBUS device ====
875 875  
876 876  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]].
... ... @@ -1041,13 +1041,13 @@
1041 1041  
1042 1042  
1043 1043  
1044 -1.
1079 +1.
1045 1045  11. Buttons
1046 1046  
1047 1047  |**Button**|**Feature**
1048 1048  |**RST**|Reboot RS485-BL
1049 1049  
1050 -1.
1085 +1.
1051 1051  11. +3V3 Output
1052 1052  
1053 1053  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
... ... @@ -1065,7 +1065,7 @@
1065 1065  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1066 1066  
1067 1067  
1068 -1.
1103 +1.
1069 1069  11. +5V Output
1070 1070  
1071 1071  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
... ... @@ -1085,13 +1085,13 @@
1085 1085  
1086 1086  
1087 1087  
1088 -1.
1123 +1.
1089 1089  11. LEDs
1090 1090  
1091 1091  |**LEDs**|**Feature**
1092 1092  |**LED1**|Blink when device transmit a packet.
1093 1093  
1094 -1.
1129 +1.
1095 1095  11. Switch Jumper
1096 1096  
1097 1097  |**Switch Jumper**|**Feature**
... ... @@ -1137,7 +1137,7 @@
1137 1137  
1138 1138  
1139 1139  
1140 -1.
1175 +1.
1141 1141  11. Common AT Command Sequence
1142 1142  111. Multi-channel ABP mode (Use with SX1301/LG308)
1143 1143  
... ... @@ -1156,8 +1156,8 @@
1156 1156  
1157 1157  ATZ
1158 1158  
1159 -1.
1160 -11.
1194 +1.
1195 +11.
1161 1161  111. Single-channel ABP mode (Use with LG01/LG02)
1162 1162  
1163 1163  AT+FDR   Reset Parameters to Factory Default, Keys Reserve
... ... @@ -1232,7 +1232,7 @@
1232 1232  [[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]]
1233 1233  
1234 1234  
1235 -1.
1270 +1.
1236 1236  11. How to change the LoRa Frequency Bands/Region?
1237 1237  
1238 1238  User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download.
... ... @@ -1239,7 +1239,7 @@
1239 1239  
1240 1240  
1241 1241  
1242 -1.
1277 +1.
1243 1243  11. How many RS485-Slave can RS485-BL connects?
1244 1244  
1245 1245  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]].
... ... @@ -1256,7 +1256,7 @@
1256 1256  
1257 1257  
1258 1258  
1259 -1.
1294 +1.
1260 1260  11. Why I can’t join TTN V3 in US915 /AU915 bands?
1261 1261  
1262 1262  It might about the channels mapping. Please see for detail.
1654132684752-193.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +22.8 KB
Content