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/]] ... ... @@ -235,11 +235,15 @@ 235 235 236 236 ((( 237 237 ((( 236 +((( 238 238 There are plenty of RS485 devices in the market and each device has different command to read the valid data. To support these devices in flexible, RS485-LN supports flexible command set. User can use [[AT Commands>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]] or LoRaWAN Downlink Command to configure what commands RS485-LN should send for each sampling and how to handle the return from RS485 devices. 239 239 ))) 239 +))) 240 240 241 241 ((( 242 +((( 242 242 (% style="color:red" %)Note: below description and commands are for firmware version >v1.1, if you have firmware version v1.0. Please check the [[user manual v1.0>>url:http://www.dragino.com/downloads/index.php?dir=RS485-LN/&file=RS485-LN_UserManual_v1.0.1.pdf]] or upgrade the firmware to v1.1 244 +))) 243 243 244 244 245 245 ))) ... ... @@ -308,7 +308,6 @@ 308 308 ))) 309 309 310 310 311 - 312 312 === 3.3.2 Configure sensors === 313 313 314 314 ((( ... ... @@ -320,15 +320,20 @@ 320 320 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 321 321 |=(% style="width: 110px;" %)**AT Commands**|=(% style="width: 190px;" %)**Description**|=(% style="width: 190px;" %)**Example** 322 322 |AT+CFGDEV|(% style="width:110px" %)((( 324 +((( 323 323 This command is used to configure the RS485/TTL devices; they won’t be used during sampling. 326 +))) 324 324 328 +((( 325 325 AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx, 330 +))) 326 326 332 +((( 327 327 mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command 334 +))) 328 328 )))|(% style="width:190px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m 329 329 330 330 331 - 332 332 === 3.3.3 Configure read commands for each sampling === 333 333 334 334 ((( ... ... @@ -795,18 +795,35 @@ 795 795 796 796 ==== **Fast command to handle MODBUS device** ==== 797 797 804 +((( 798 798 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]]. 806 +))) 799 799 808 +((( 800 800 This command is valid since v1.3 firmware version 810 +))) 801 801 812 +((( 802 802 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. 814 +))) 803 803 816 +((( 817 + 818 +))) 804 804 820 +((( 805 805 **Example:** 822 +))) 806 806 807 -* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). So RS485-LN. 808 -* 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. 809 -* 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. 824 +* ((( 825 +AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). So RS485-LN. 826 +))) 827 +* ((( 828 +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. 829 +))) 830 +* ((( 831 +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. 832 +))) 810 810 811 811 [[image:image-20220602165351-6.png]] 812 812 ... ... @@ -814,201 +814,377 @@ 814 814 815 815 816 816 840 + 817 817 ==== **RS485 command timeout** ==== 818 818 843 +((( 819 819 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. 845 +))) 820 820 847 +((( 821 821 Default value: 0, range: 0 ~~ 65 seconds 849 +))) 822 822 823 -* **AT Command:** 851 +* ((( 852 +**AT Command:** 853 +))) 824 824 825 825 (% class="box infomessage" %) 826 826 ((( 857 +((( 827 827 **AT+CMDDLaa=hex(bb cc)*1000** 828 828 ))) 860 +))) 829 829 862 +((( 830 830 **Example:** 864 +))) 831 831 866 +((( 832 832 **AT+CMDDL1=1000** to send the open time to 1000ms 868 +))) 833 833 870 +((( 871 + 872 +))) 834 834 835 -* **Downlink Payload:** 874 +* ((( 875 +**Downlink Payload:** 876 +))) 836 836 878 +((( 837 837 **0x AA aa bb cc** 880 +))) 838 838 882 +((( 839 839 Same as: AT+CMDDLaa=hex(bb cc)*1000 884 +))) 840 840 886 +((( 841 841 **Example:** 888 +))) 842 842 890 +((( 843 843 0xAA 01 00 01 ~-~-> Same as **AT+CMDDL1=1000 ms** 892 +))) 844 844 845 845 846 846 896 + 847 847 ==== **Uplink payload mode** ==== 848 848 899 +((( 849 849 Define to use one uplink or multiple uplinks for the sampling. 901 +))) 850 850 903 +((( 851 851 The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]] 905 +))) 852 852 853 -* **AT Command:** 907 +* ((( 908 +**AT Command:** 909 +))) 854 854 855 855 (% class="box infomessage" %) 856 856 ((( 913 +((( 857 857 **AT+DATAUP=0** 858 858 ))) 916 +))) 859 859 860 860 (% class="box infomessage" %) 861 861 ((( 920 +((( 862 862 **AT+DATAUP=1** 863 863 ))) 923 +))) 864 864 925 +((( 926 + 927 +))) 865 865 866 -* **Downlink Payload:** 929 +* ((( 930 +**Downlink Payload:** 931 +))) 867 867 933 +((( 868 868 **0xAD 00** **~-~->** Same as AT+DATAUP=0 935 +))) 869 869 937 +((( 870 870 **0xAD 01** **~-~->** Same as AT+DATAUP=1 939 +))) 871 871 872 872 873 873 943 + 874 874 ==== **Manually trigger an Uplink** ==== 875 875 946 +((( 876 876 Ask device to send an uplink immediately. 948 +))) 877 877 878 -* **AT Command:** 950 +* ((( 951 +**AT Command:** 952 +))) 879 879 954 +((( 880 880 No AT Command for this, user can press the [[ACT button>>||anchor="H3.7Buttons"]] for 1 second for the same. 956 +))) 881 881 958 +((( 959 + 960 +))) 882 882 883 -* **Downlink Payload:** 962 +* ((( 963 +**Downlink Payload:** 964 +))) 884 884 966 +((( 885 885 **0x08 FF**, RS485-LN will immediately send an uplink. 968 +))) 886 886 887 887 888 888 972 + 889 889 ==== **Clear RS485 Command** ==== 890 890 975 +((( 891 891 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 977 +))) 892 892 893 -* **AT Command:** 979 +* ((( 980 +**AT Command:** 981 +))) 894 894 983 +((( 895 895 **AT+CMDEAR=mm,nn** mm: start position of erase ,nn: stop position of erase 985 +))) 896 896 987 +((( 897 897 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 989 +))) 898 898 991 +((( 899 899 Example screen shot after clear all RS485 commands. 993 +))) 900 900 995 +((( 996 + 997 +))) 901 901 999 +((( 902 902 The uplink screen shot is: 1001 +))) 903 903 904 904 [[image:1654160691922-496.png]] 905 905 906 906 907 -* **Downlink Payload:** 1006 +* ((( 1007 +**Downlink Payload:** 1008 +))) 908 908 1010 +((( 909 909 **0x09 aa bb** same as AT+CMDEAR=aa,bb 1012 +))) 910 910 911 911 912 912 1016 + 913 913 ==== **Set Serial Communication Parameters** ==== 914 914 1019 +((( 915 915 Set the Rs485 serial communication parameters: 1021 +))) 916 916 917 -* **AT Command:** 1023 +* ((( 1024 +**AT Command:** 1025 +))) 918 918 1027 +((( 919 919 Set Baud Rate: 1029 +))) 920 920 921 921 (% class="box infomessage" %) 922 922 ((( 1033 +((( 923 923 **AT+BAUDR=9600** ~/~/ Options: (1200,2400,4800,14400,19200,115200) 924 924 ))) 1036 +))) 925 925 1038 +((( 926 926 Set UART Parity 1040 +))) 927 927 928 928 (% class="box infomessage" %) 929 929 ((( 1044 +((( 930 930 **AT+PARITY=0** ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity 931 931 ))) 1047 +))) 932 932 1049 +((( 933 933 Set STOPBIT 1051 +))) 934 934 935 935 (% class="box infomessage" %) 936 936 ((( 1055 +((( 937 937 **AT+STOPBIT=0** ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits 938 938 ))) 1058 +))) 939 939 1060 +((( 1061 + 1062 +))) 940 940 941 -* **Downlink Payload:** 1064 +* ((( 1065 +**Downlink Payload:** 1066 +))) 942 942 1068 +((( 943 943 **A7 01 aa bb**: Same AT+BAUDR=hex(aa bb)*100 1070 +))) 944 944 1072 +((( 945 945 **Example:** 1074 +))) 946 946 947 -* A7 01 00 60 same as AT+BAUDR=9600 948 -* A7 01 04 80 same as AT+BAUDR=115200 1076 +* ((( 1077 +A7 01 00 60 same as AT+BAUDR=9600 1078 +))) 1079 +* ((( 1080 +A7 01 04 80 same as AT+BAUDR=115200 1081 +))) 949 949 1083 +((( 950 950 A7 02 aa: Same as AT+PARITY=aa (aa value: 00 , 01 or 02) 1085 +))) 951 951 1087 +((( 952 952 A7 03 aa: Same as AT+STOPBIT=aa (aa value: 00 , 01 or 02) 1089 +))) 953 953 954 954 1092 + 1093 + 955 955 == 3.6 Listening mode for RS485 network == 956 956 1096 +((( 957 957 This feature support since firmware v1.4 1098 +))) 958 958 1100 +((( 959 959 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. 1102 +))) 960 960 961 961 [[image:image-20220602171200-8.png||height="567" width="1007"]] 962 962 1106 +((( 963 963 To enable the listening mode, use can run the command AT+RXMODE. 1108 +))) 964 964 1110 +((( 1111 + 1112 +))) 965 965 966 -(% border="1" style="background-color:#ffffcc; width:500px" %) 967 -|=(% style="width: 161px;" %)**Command example:**|=(% style="width: 337px;" %)**Function** 968 -|(% 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. 969 -|(% 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 970 -|(% style="width:161px" %)AT+RXMODE=0,0|(% style="width:337px" %)Disable listening mode. This is the default settings. 971 -|(% style="width:161px" %) |(% style="width:337px" %)A6 aa bb cc same as AT+RXMODE=aa,(bb<<8 ~| cc) 1114 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %) 1115 +|=(% style="width: 100px;" %)((( 1116 +**Command example** 1117 +)))|=(% style="width: 400px;" %)((( 1118 +**Function** 1119 +))) 1120 +|(% style="width:100px" %)((( 1121 +AT+RXMODE=1,10 1122 +)))|(% style="width:400px" %)((( 1123 +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. 1124 +))) 1125 +|(% style="width:100px" %)((( 1126 +AT+RXMODE=2,500 1127 +)))|(% style="width:400px" %)((( 1128 +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 1129 +))) 1130 +|(% style="width:100px" %)((( 1131 +AT+RXMODE=0,0 1132 +)))|(% style="width:400px" %)((( 1133 +Disable listening mode. This is the default settings. 1134 +))) 1135 +|(% style="width:100px" %)((( 1136 + 1137 +)))|(% style="width:400px" %)((( 1138 +A6 aa bb cc same as AT+RXMODE=aa,(bb<<8 | cc) 1139 +))) 972 972 1141 +((( 973 973 **Downlink Command:** 1143 +))) 974 974 1145 +((( 975 975 **0xA6 aa bb cc ** same as AT+RXMODE=aa,(bb<<8 | cc) 1147 +))) 976 976 1149 +((( 1150 + 1151 +))) 977 977 1153 +((( 978 978 **Example**: 1155 +))) 979 979 1157 +((( 980 980 The RS485-LN is set to AT+RXMODE=2,1000 1159 +))) 981 981 1161 +((( 982 982 There is a two Modbus commands in the RS485 network as below: 1163 +))) 983 983 1165 +((( 984 984 The Modbus master send a command: (% style="background-color:#ffc000" %)01 03 00 00 00 02 c4 0b 1167 +))) 985 985 1169 +((( 986 986 And Modbus slave reply with: (% style="background-color:green" %)01 03 04 00 00 00 00 fa 33 1171 +))) 987 987 1173 +((( 988 988 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 1175 +))) 989 989 1177 +((( 990 990 [[image:image-20220602171200-9.png]] 1179 +))) 991 991 1181 +((( 1182 + 1183 +))) 992 992 1185 +((( 1186 +((( 993 993 (% 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. 1188 +))) 1189 +))) 994 994 995 995 996 996 == 3.7 Buttons == 997 997 998 998 999 -(% border="1" style="background-color:#f7faff; width: 500px" %)1000 -|=**Button**|=(% style="width: 1420px;" %)**Feature**1001 -|**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**1002 -|**RST**|(% style="width: 1420px" %)Reboot RS4851003 -|**PRO**|(% style="width: 1420px" %)Use for upload image, see [[How to Update Image>>||anchor="H6.1Howtoupgradetheimage3F"]]1195 +(% border="1" cellspacing="10" style="background-color:#f7faff; width:400px" %) 1196 +|=(% style="width: 50px;" %)**Button**|=(% style="width: 350px;" %)**Feature** 1197 +|(% style="width:50px" %)**ACT**|(% style="width:350px" %)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** 1198 +|(% style="width:50px" %)**RST**|(% style="width:350px" %)Reboot RS485 1199 +|(% style="width:50px" %)**PRO**|(% style="width:350px" %)Use for upload image, see [[How to Update Image>>||anchor="H6.1Howtoupgradetheimage3F"]] 1004 1004 1201 + 1005 1005 == 3.8 LEDs == 1006 1006 1007 -(% border="1" style="background-color:#f7faff; width:500px" %) 1008 -|=**LEDs**|=**Feature** 1204 + 1205 +(% border="1" cellspacing="10" style="background-color:#f7faff; width:430px" %) 1206 +|=(% style="width: 50px;" %)**LEDs**|=(% style="width: 380px;" %)**Feature** 1009 1009 |**PWR**|Always on if there is power 1010 -|**SYS**|After device is powered on, the SYS will (% style="color:green" %)**fast blink 1208 +|**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. 1011 1011 1210 + 1012 1012 = 4. Case Study = 1013 1013 1014 1014 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]] ... ... @@ -1018,19 +1018,26 @@ 1018 1018 1019 1019 == 5.1 Access AT Command == 1020 1020 1220 +((( 1021 1021 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. 1222 +))) 1022 1022 1023 1023 [[image:1654162355560-817.png]] 1024 1024 1025 1025 1227 +((( 1026 1026 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: 1229 +))) 1027 1027 1028 1028 [[image:1654162368066-342.png]] 1029 1029 1030 1030 1234 +((( 1031 1031 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/]] 1236 +))) 1032 1032 1033 1033 1239 + 1034 1034 == 5.2 Common AT Command Sequence == 1035 1035 1036 1036 === 5.2.1 Multi-channel ABP mode (Use with SX1301/LG308) === ... ... @@ -1053,7 +1053,9 @@ 1053 1053 ))) 1054 1054 1055 1055 1262 +((( 1056 1056 If device already joined network: 1264 +))) 1057 1057 1058 1058 (% class="box infomessage" %) 1059 1059 ((( ... ... @@ -1092,10 +1092,12 @@ 1092 1092 1093 1093 (% style="color:red" %)**Note:** 1094 1094 1303 +((( 1095 1095 (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server. 1096 1096 2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting. 1097 1097 3. Make sure SF / bandwidth setting in LG01/LG02 match the settings of AT+DR. refer [[this link>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/&file=LoRaWAN%201.0.3%20Regional%20Parameters.xlsx]] to see what DR means. 1098 1098 4. The command AT+RX2FQ and AT+RX2DR is to let downlink work. to set the correct parameters, user can check the actually downlink parameters to be used. As below. Which shows the RX2FQ should use 868400000 and RX2DR should be 5 1308 +))) 1099 1099 1100 1100 [[image:1654162478620-421.png]] 1101 1101 ... ... @@ -1104,25 +1104,45 @@ 1104 1104 1105 1105 == 6.1 How to upgrade the image? == 1106 1106 1317 +((( 1107 1107 The RS485-LN LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-LN to: 1319 +))) 1108 1108 1109 -* Support new features 1110 -* For bug fix 1111 -* Change LoRaWAN bands. 1321 +* ((( 1322 +Support new features 1323 +))) 1324 +* ((( 1325 +For bug fix 1326 +))) 1327 +* ((( 1328 +Change LoRaWAN bands. 1329 +))) 1112 1112 1331 +((( 1113 1113 Below shows the hardware connection for how to upload an image to RS485-LN: 1333 +))) 1114 1114 1115 1115 [[image:1654162535040-878.png]] 1116 1116 1337 +((( 1117 1117 **Step1:** Download [[flash loader>>url:https://www.st.com/content/st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-programmers/flasher-stm32.html]]. 1339 +))) 1118 1118 1341 +((( 1119 1119 **Step2**: Download the [[LT Image files>>url:http://www.dragino.com/downloads/index.php?dir=LT_LoRa_IO_Controller/LT33222-L/image/]]. 1343 +))) 1120 1120 1345 +((( 1121 1121 **Step3: **Open flashloader; choose the correct COM port to update. 1347 +))) 1122 1122 1123 1123 ((( 1350 +((( 1351 +((( 1124 1124 (% style="color:blue" %) Hold down the PRO button and then momentarily press the RST reset button and the SYS led will change from OFF to ON, While SYS LED is RED ON, it means the RS485-LN is ready to be program. 1125 1125 ))) 1354 +))) 1355 +))) 1126 1126 1127 1127 1128 1128 [[image:image-20220602175818-12.png]] ... ... @@ -1185,7 +1185,6 @@ 1185 1185 * (% style="color:blue" %)**RU864**(%%): frequency bands RU864 1186 1186 * (% style="color:blue" %)**KZ865**(%%): frequency bands KZ865 1187 1187 1188 - 1189 1189 = 9.Packing Info = 1190 1190 1191 1191 ... ... @@ -1202,7 +1202,6 @@ 1202 1202 * Package Size / pcs : 14.5 x 8 x 5 cm 1203 1203 * Weight / pcs : 170g 1204 1204 1205 - 1206 1206 = 10. FCC Caution for RS485LN-US915 = 1207 1207 1208 1208 (((