Changes for page RS485-LN – RS485 to LoRaWAN Converter User Manual
Last modified by Bei Jinggeng on 2025/01/16 11:36
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -103,7 +103,6 @@ 103 103 * Support Modbus protocol 104 104 * Support Interrupt uplink (Since hardware version v1.2) 105 105 106 - 107 107 == 1.4 Applications == 108 108 109 109 * Smart Buildings & Home Automation ... ... @@ -113,7 +113,6 @@ 113 113 * Smart Cities 114 114 * Smart Factory 115 115 116 - 117 117 == 1.5 Firmware Change log == 118 118 119 119 [[RS485-LN Image files – Download link and Change log>>url:http://www.dragino.com/downloads/index.php?dir=RS485-LN/]] ... ... @@ -307,8 +307,6 @@ 307 307 ))) 308 308 ))) 309 309 310 - 311 - 312 312 === 3.3.2 Configure sensors === 313 313 314 314 ((( ... ... @@ -327,8 +327,6 @@ 327 327 mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command 328 328 )))|(% style="width:190px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m 329 329 330 - 331 - 332 332 === 3.3.3 Configure read commands for each sampling === 333 333 334 334 ((( ... ... @@ -704,64 +704,126 @@ 704 704 705 705 ==== **Set RS485 Sampling Commands** ==== 706 706 701 +((( 707 707 AT+COMMANDx or AT+DATACUTx 703 +))) 708 708 705 +((( 709 709 These three commands are used to configure how the RS485-LN polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>||anchor="H3.3.3Configurereadcommandsforeachsampling"]]. 707 +))) 710 710 709 +((( 710 + 711 +))) 711 711 712 -* **AT Command:** 713 +* ((( 714 +**AT Command:** 715 +))) 713 713 714 714 (% class="box infomessage" %) 715 715 ((( 719 +((( 716 716 **AT+COMMANDx: Configure RS485 read command to sensor.** 717 717 ))) 722 +))) 718 718 719 719 (% class="box infomessage" %) 720 720 ((( 726 +((( 721 721 **AT+DATACUTx: Configure how to handle return from RS485 devices.** 722 722 ))) 729 +))) 723 723 731 +((( 732 + 733 +))) 724 724 725 -* **Downlink Payload:** 735 +* ((( 736 +**Downlink Payload:** 737 +))) 726 726 739 +((( 727 727 **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx. 741 +))) 728 728 743 +((( 729 729 (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink. 745 +))) 730 730 747 +((( 731 731 Format: AF MM NN LL XX XX XX XX YY 749 +))) 732 732 751 +((( 733 733 Where: 753 +))) 734 734 735 -* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F, 736 -* NN: 0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value. 737 -* LL: The length of AT+COMMAND or AT+DATACUT command 738 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command 739 -* YY: If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command. 755 +* ((( 756 +MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F, 757 +))) 758 +* ((( 759 +NN: 0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value. 760 +))) 761 +* ((( 762 +LL: The length of AT+COMMAND or AT+DATACUT command 763 +))) 764 +* ((( 765 +XX XX XX XX: AT+COMMAND or AT+DATACUT command 766 +))) 767 +* ((( 768 +YY: If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command. 769 +))) 740 740 771 +((( 741 741 **Example:** 773 +))) 742 742 775 +((( 743 743 (% 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 777 +))) 744 744 779 +((( 745 745 (% 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** 781 +))) 746 746 783 +((( 747 747 (% 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** 785 +))) 748 748 749 749 750 750 789 + 751 751 ==== **Fast command to handle MODBUS device** ==== 752 752 792 +((( 753 753 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]]. 794 +))) 754 754 796 +((( 755 755 This command is valid since v1.3 firmware version 798 +))) 756 756 800 +((( 757 757 AT+MBFUN 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. 802 +))) 758 758 804 +((( 805 + 806 +))) 759 759 808 +((( 760 760 **Example:** 810 +))) 761 761 762 -* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). So RS485-LN. 763 -* 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. 764 -* 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. 812 +* ((( 813 +AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). So RS485-LN. 814 +))) 815 +* ((( 816 +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. 817 +))) 818 +* ((( 819 +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. 820 +))) 765 765 766 766 [[image:image-20220602165351-6.png]] 767 767 ... ... @@ -769,201 +769,374 @@ 769 769 770 770 771 771 828 + 772 772 ==== **RS485 command timeout** ==== 773 773 831 +((( 774 774 Some Modbus device has slow action to send replies. This command is used to configure the RS485-LN to use longer time to wait for their action. 833 +))) 775 775 835 +((( 776 776 Default value: 0, range: 0 ~~ 65 seconds 837 +))) 777 777 778 -* **AT Command:** 839 +* ((( 840 +**AT Command:** 841 +))) 779 779 780 780 (% class="box infomessage" %) 781 781 ((( 845 +((( 782 782 **AT+CMDDLaa=hex(bb cc)*1000** 783 783 ))) 848 +))) 784 784 850 +((( 785 785 **Example:** 852 +))) 786 786 854 +((( 787 787 **AT+CMDDL1=1000** to send the open time to 1000ms 856 +))) 788 788 858 +((( 859 + 860 +))) 789 789 790 -* **Downlink Payload:** 862 +* ((( 863 +**Downlink Payload:** 864 +))) 791 791 866 +((( 792 792 **0x AA aa bb cc** 868 +))) 793 793 870 +((( 794 794 Same as: AT+CMDDLaa=hex(bb cc)*1000 872 +))) 795 795 874 +((( 796 796 **Example:** 876 +))) 797 797 878 +((( 798 798 0xAA 01 00 01 ~-~-> Same as **AT+CMDDL1=1000 ms** 880 +))) 799 799 800 800 801 801 884 + 802 802 ==== **Uplink payload mode** ==== 803 803 887 +((( 804 804 Define to use one uplink or multiple uplinks for the sampling. 889 +))) 805 805 891 +((( 806 806 The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]] 893 +))) 807 807 808 -* **AT Command:** 895 +* ((( 896 +**AT Command:** 897 +))) 809 809 810 810 (% class="box infomessage" %) 811 811 ((( 901 +((( 812 812 **AT+DATAUP=0** 813 813 ))) 904 +))) 814 814 815 815 (% class="box infomessage" %) 816 816 ((( 908 +((( 817 817 **AT+DATAUP=1** 818 818 ))) 911 +))) 819 819 913 +((( 914 + 915 +))) 820 820 821 -* **Downlink Payload:** 917 +* ((( 918 +**Downlink Payload:** 919 +))) 822 822 921 +((( 823 823 **0xAD 00** **~-~->** Same as AT+DATAUP=0 923 +))) 824 824 925 +((( 825 825 **0xAD 01** **~-~->** Same as AT+DATAUP=1 927 +))) 826 826 827 827 828 828 931 + 829 829 ==== **Manually trigger an Uplink** ==== 830 830 934 +((( 831 831 Ask device to send an uplink immediately. 936 +))) 832 832 833 -* **AT Command:** 938 +* ((( 939 +**AT Command:** 940 +))) 834 834 942 +((( 835 835 No AT Command for this, user can press the [[ACT button>>||anchor="H3.7Buttons"]] for 1 second for the same. 944 +))) 836 836 946 +((( 947 + 948 +))) 837 837 838 -* **Downlink Payload:** 950 +* ((( 951 +**Downlink Payload:** 952 +))) 839 839 954 +((( 840 840 **0x08 FF**, RS485-LN will immediately send an uplink. 956 +))) 841 841 842 842 843 843 960 + 844 844 ==== **Clear RS485 Command** ==== 845 845 963 +((( 846 846 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 965 +))) 847 847 848 -* **AT Command:** 967 +* ((( 968 +**AT Command:** 969 +))) 849 849 971 +((( 850 850 **AT+CMDEAR=mm,nn** mm: start position of erase ,nn: stop position of erase 973 +))) 851 851 975 +((( 852 852 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 977 +))) 853 853 979 +((( 854 854 Example screen shot after clear all RS485 commands. 981 +))) 855 855 983 +((( 984 + 985 +))) 856 856 987 +((( 857 857 The uplink screen shot is: 989 +))) 858 858 859 859 [[image:1654160691922-496.png]] 860 860 861 861 862 -* **Downlink Payload:** 994 +* ((( 995 +**Downlink Payload:** 996 +))) 863 863 998 +((( 864 864 **0x09 aa bb** same as AT+CMDEAR=aa,bb 1000 +))) 865 865 866 866 867 867 1004 + 868 868 ==== **Set Serial Communication Parameters** ==== 869 869 1007 +((( 870 870 Set the Rs485 serial communication parameters: 1009 +))) 871 871 872 -* **AT Command:** 1011 +* ((( 1012 +**AT Command:** 1013 +))) 873 873 1015 +((( 874 874 Set Baud Rate: 1017 +))) 875 875 876 876 (% class="box infomessage" %) 877 877 ((( 1021 +((( 878 878 **AT+BAUDR=9600** ~/~/ Options: (1200,2400,4800,14400,19200,115200) 879 879 ))) 1024 +))) 880 880 1026 +((( 881 881 Set UART Parity 1028 +))) 882 882 883 883 (% class="box infomessage" %) 884 884 ((( 1032 +((( 885 885 **AT+PARITY=0** ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity 886 886 ))) 1035 +))) 887 887 1037 +((( 888 888 Set STOPBIT 1039 +))) 889 889 890 890 (% class="box infomessage" %) 891 891 ((( 1043 +((( 892 892 **AT+STOPBIT=0** ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits 893 893 ))) 1046 +))) 894 894 1048 +((( 1049 + 1050 +))) 895 895 896 -* **Downlink Payload:** 1052 +* ((( 1053 +**Downlink Payload:** 1054 +))) 897 897 1056 +((( 898 898 **A7 01 aa bb**: Same AT+BAUDR=hex(aa bb)*100 1058 +))) 899 899 1060 +((( 900 900 **Example:** 1062 +))) 901 901 902 -* A7 01 00 60 same as AT+BAUDR=9600 903 -* A7 01 04 80 same as AT+BAUDR=115200 1064 +* ((( 1065 +A7 01 00 60 same as AT+BAUDR=9600 1066 +))) 1067 +* ((( 1068 +A7 01 04 80 same as AT+BAUDR=115200 1069 +))) 904 904 1071 +((( 905 905 A7 02 aa: Same as AT+PARITY=aa (aa value: 00 , 01 or 02) 1073 +))) 906 906 1075 +((( 907 907 A7 03 aa: Same as AT+STOPBIT=aa (aa value: 00 , 01 or 02) 1077 +))) 908 908 909 909 1080 + 1081 + 910 910 == 3.6 Listening mode for RS485 network == 911 911 1084 +((( 912 912 This feature support since firmware v1.4 1086 +))) 913 913 1088 +((( 914 914 RS485-LN supports listening mode, it can listen the RS485 network packets and send them via LoRaWAN uplink. Below is the structure. The blue arrow shows the RS485 network packets to RS485-LN. 1090 +))) 915 915 916 916 [[image:image-20220602171200-8.png||height="567" width="1007"]] 917 917 1094 +((( 918 918 To enable the listening mode, use can run the command AT+RXMODE. 1096 +))) 919 919 1098 +((( 1099 + 1100 +))) 920 920 921 -(% border="1" style="background-color:#ffffcc; width:500px" %) 922 -|=(% style="width: 161px;" %)**Command example:**|=(% style="width: 337px;" %)**Function** 923 -|(% style="width:161px" %)AT+RXMODE=1,10 |(% style="width:337px" %)Enable listening mode 1, if RS485-LN has received more than 10 RS485 commands from the network. RS485-LN will send these commands via LoRaWAN uplinks. 924 -|(% style="width:161px" %)AT+RXMODE=2,500|(% style="width:337px" %)Enable listening mode 2, RS485-LN will capture and send a 500ms content once from the first detect of character. Max value is 65535 ms 925 -|(% style="width:161px" %)AT+RXMODE=0,0|(% style="width:337px" %)Disable listening mode. This is the default settings. 926 -|(% style="width:161px" %) |(% style="width:337px" %)A6 aa bb cc same as AT+RXMODE=aa,(bb<<8 ~| cc) 1102 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 1103 +|=(% style="width: 161px;" %)((( 1104 +**Command example:** 1105 +)))|=(% style="width: 337px;" %)((( 1106 +**Function** 1107 +))) 1108 +|(% style="width:161px" %)((( 1109 +AT+RXMODE=1,10 1110 +)))|(% style="width:337px" %)((( 1111 +Enable listening mode 1, if RS485-LN has received more than 10 RS485 commands from the network. RS485-LN will send these commands via LoRaWAN uplinks. 1112 +))) 1113 +|(% style="width:161px" %)((( 1114 +AT+RXMODE=2,500 1115 +)))|(% style="width:337px" %)((( 1116 +Enable listening mode 2, RS485-LN will capture and send a 500ms content once from the first detect of character. Max value is 65535 ms 1117 +))) 1118 +|(% style="width:161px" %)((( 1119 +AT+RXMODE=0,0 1120 +)))|(% style="width:337px" %)((( 1121 +Disable listening mode. This is the default settings. 1122 +))) 1123 +|(% style="width:161px" %)((( 1124 + 1125 +)))|(% style="width:337px" %)((( 1126 +A6 aa bb cc same as AT+RXMODE=aa,(bb<<8 | cc) 1127 +))) 927 927 1129 +((( 928 928 **Downlink Command:** 1131 +))) 929 929 1133 +((( 930 930 **0xA6 aa bb cc ** same as AT+RXMODE=aa,(bb<<8 | cc) 1135 +))) 931 931 1137 +((( 1138 + 1139 +))) 932 932 1141 +((( 933 933 **Example**: 1143 +))) 934 934 1145 +((( 935 935 The RS485-LN is set to AT+RXMODE=2,1000 1147 +))) 936 936 1149 +((( 937 937 There is a two Modbus commands in the RS485 network as below: 1151 +))) 938 938 1153 +((( 939 939 The Modbus master send a command: (% style="background-color:#ffc000" %)01 03 00 00 00 02 c4 0b 1155 +))) 940 940 1157 +((( 941 941 And Modbus slave reply with: (% style="background-color:green" %)01 03 04 00 00 00 00 fa 33 1159 +))) 942 942 1161 +((( 943 943 RS485-LN will capture both and send the uplink: (% style="background-color:#ffc000" %)01 03 00 00 00 02 c4 0b (% style="background-color:green" %)01 03 04 00 00 00 00 fa 33 1163 +))) 944 944 1165 +((( 945 945 [[image:image-20220602171200-9.png]] 1167 +))) 946 946 1169 +((( 1170 + 1171 +))) 947 947 1173 +((( 948 948 (% style="color:red" %)Notice: Listening mode can work with the default polling mode of RS485-LN. When RS485-LN is in to send the RS485 commands (from AT+COMMANDx), the listening mode will be interrupt for a while. 1175 +))) 949 949 950 950 951 951 == 3.7 Buttons == 952 952 953 953 954 -(% border="1" style="background-color:#f7faff; width: 500px" %)955 -|=**Button**|=(% style="width: 1420px;" %)**Feature**956 -|**ACT**|(% style="width: 1420px" %)If RS485 joined in network, press this button for more than 1 second, RS485 will upload a packet, and the SYS LED will give a (% style="color:blue" %)**Blue blink**957 -|**RST**|(% style="width: 1420px" %)Reboot RS485958 -|**PRO**|(% style="width: 1420px" %)Use for upload image, see [[How to Update Image>>||anchor="H6.1Howtoupgradetheimage3F"]]1181 +(% border="1" cellspacing="10" style="background-color:#f7faff; width:430px" %) 1182 +|=(% style="width: 30px;" %)**Button**|=(% style="width: 355px;" %)**Feature** 1183 +|(% style="width:30px" %)**ACT**|(% style="width:355px" %)If RS485 joined in network, press this button for more than 1 second, RS485 will upload a packet, and the SYS LED will give a (% style="color:blue" %)**Blue blink** 1184 +|(% style="width:30px" %)**RST**|(% style="width:355px" %)Reboot RS485 1185 +|(% style="width:30px" %)**PRO**|(% style="width:355px" %)Use for upload image, see [[How to Update Image>>||anchor="H6.1Howtoupgradetheimage3F"]] 959 959 1187 + 960 960 == 3.8 LEDs == 961 961 962 -(% border="1" style="background-color:#f7faff; width: 500px" %)963 -|=**LEDs**|=**Feature** 964 -|**PWR**|Always on if there is power 965 -|**SYS**|After device is powered on, the SYS will (% style="color:green" %) **fast blink in GREEN**(%%)for 5 times, means RS485-LN start to join LoRaWAN network. If join success, SYS will be (% style="color:green" %)**on GREEN for 5 seconds**(%%)**.**SYS will (% style="color:green" %)**blink Blue**(%%) on every upload and (% style="color:green" %)**blink Green**(%%) once receive a downlink message.1190 +(% border="1" cellspacing="10" style="background-color:#f7faff; width:430px" %) 1191 +|=(% style="width: 30px;" %)**LEDs**|=(% style="width: 400px;" %)**Feature** 1192 +|(% style="width:30px" %)**PWR**|=(% style="width: 400px;" %)Always on if there is power 1193 +|(% style="width:30px" %)**SYS**|=(% style="width: 400px;" %)After device is powered on, the SYS will (% style="color:green" %)fast blink in GREEN (%%)for 5 times, means RS485-LN start to join LoRaWAN network. If join success, SYS will be (% style="color:green" %)on GREEN for 5 seconds(%%). SYS will (% style="color:green" %)blink Blue(%%) on every upload and (% style="color:green" %)blink Green(%%) once receive a downlink message. 966 966 1195 + 967 967 = 4. Case Study = 968 968 969 969 User can check this URL for some case studies: [[APP RS485 COMMUNICATE WITH SENSORS>>doc:Main.Application Note \: Communicate with Different Sensors ----- RS485-LN RS485-BL.WebHome]] ... ... @@ -973,19 +973,26 @@ 973 973 974 974 == 5.1 Access AT Command == 975 975 1205 +((( 976 976 RS485-BL supports AT Command set. User can use a USB to TTL adapter plus the 3.5mm Program Cable to connect to RS485-BL to use AT command, as below. 1207 +))) 977 977 978 978 [[image:1654162355560-817.png]] 979 979 980 980 1212 +((( 981 981 In PC, User needs to set (% style="color:blue" %)**serial tool**(%%)(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to (% style="color:green" %)**9600**(%%) to access to access serial console of RS485-BL. The default password is 123456. Below is the output for reference: 1214 +))) 982 982 983 983 [[image:1654162368066-342.png]] 984 984 985 985 1219 +((( 986 986 More detail AT Command manual can be found at [[AT Command Manual>>https://www.dragino.com/downloads/index.php?dir=LT_LoRa_IO_Controller/LT33222-L/]] 1221 +))) 987 987 988 988 1224 + 989 989 == 5.2 Common AT Command Sequence == 990 990 991 991 === 5.2.1 Multi-channel ABP mode (Use with SX1301/LG308) === ... ... @@ -1059,13 +1059,23 @@ 1059 1059 1060 1060 == 6.1 How to upgrade the image? == 1061 1061 1298 +((( 1062 1062 The RS485-LN LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-LN to: 1300 +))) 1063 1063 1064 -* Support new features 1065 -* For bug fix 1066 -* Change LoRaWAN bands. 1302 +* ((( 1303 +Support new features 1304 +))) 1305 +* ((( 1306 +For bug fix 1307 +))) 1308 +* ((( 1309 +Change LoRaWAN bands. 1310 +))) 1067 1067 1312 +((( 1068 1068 Below shows the hardware connection for how to upload an image to RS485-LN: 1314 +))) 1069 1069 1070 1070 [[image:1654162535040-878.png]] 1071 1071 ... ... @@ -1140,7 +1140,6 @@ 1140 1140 * (% style="color:blue" %)**RU864**(%%): frequency bands RU864 1141 1141 * (% style="color:blue" %)**KZ865**(%%): frequency bands KZ865 1142 1142 1143 - 1144 1144 = 9.Packing Info = 1145 1145 1146 1146 ... ... @@ -1157,7 +1157,6 @@ 1157 1157 * Package Size / pcs : 14.5 x 8 x 5 cm 1158 1158 * Weight / pcs : 170g 1159 1159 1160 - 1161 1161 = 10. FCC Caution for RS485LN-US915 = 1162 1162 1163 1163 (((