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