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 ((( ... ... @@ -669,6 +669,7 @@ 669 669 670 670 671 671 666 + 672 672 ==== **Set Payload version** ==== 673 673 674 674 ((( ... ... @@ -703,64 +703,126 @@ 703 703 704 704 ==== **Set RS485 Sampling Commands** ==== 705 705 701 +((( 706 706 AT+COMMANDx or AT+DATACUTx 703 +))) 707 707 705 +((( 708 708 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 +))) 709 709 709 +((( 710 + 711 +))) 710 710 711 -* **AT Command:** 713 +* ((( 714 +**AT Command:** 715 +))) 712 712 713 713 (% class="box infomessage" %) 714 714 ((( 719 +((( 715 715 **AT+COMMANDx: Configure RS485 read command to sensor.** 716 716 ))) 722 +))) 717 717 718 718 (% class="box infomessage" %) 719 719 ((( 726 +((( 720 720 **AT+DATACUTx: Configure how to handle return from RS485 devices.** 721 721 ))) 729 +))) 722 722 731 +((( 732 + 733 +))) 723 723 724 -* **Downlink Payload:** 735 +* ((( 736 +**Downlink Payload:** 737 +))) 725 725 739 +((( 726 726 **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx. 741 +))) 727 727 743 +((( 728 728 (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink. 745 +))) 729 729 747 +((( 730 730 Format: AF MM NN LL XX XX XX XX YY 749 +))) 731 731 751 +((( 732 732 Where: 753 +))) 733 733 734 -* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F, 735 -* NN: 0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value. 736 -* LL: The length of AT+COMMAND or AT+DATACUT command 737 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command 738 -* 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 +))) 739 739 771 +((( 740 740 **Example:** 773 +))) 741 741 775 +((( 742 742 (% 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 +))) 743 743 779 +((( 744 744 (% 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 +))) 745 745 783 +((( 746 746 (% 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 +))) 747 747 748 748 749 749 789 + 750 750 ==== **Fast command to handle MODBUS device** ==== 751 751 792 +((( 752 752 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 +))) 753 753 796 +((( 754 754 This command is valid since v1.3 firmware version 798 +))) 755 755 800 +((( 756 756 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 +))) 757 757 804 +((( 805 + 806 +))) 758 758 808 +((( 759 759 **Example:** 810 +))) 760 760 761 -* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). So RS485-LN. 762 -* 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. 763 -* 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 +))) 764 764 765 765 [[image:image-20220602165351-6.png]] 766 766 ... ... @@ -768,200 +768,373 @@ 768 768 769 769 770 770 828 + 771 771 ==== **RS485 command timeout** ==== 772 772 831 +((( 773 773 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 +))) 774 774 835 +((( 775 775 Default value: 0, range: 0 ~~ 65 seconds 837 +))) 776 776 777 -* **AT Command:** 839 +* ((( 840 +**AT Command:** 841 +))) 778 778 779 779 (% class="box infomessage" %) 780 780 ((( 845 +((( 781 781 **AT+CMDDLaa=hex(bb cc)*1000** 782 782 ))) 848 +))) 783 783 850 +((( 784 784 **Example:** 852 +))) 785 785 854 +((( 786 786 **AT+CMDDL1=1000** to send the open time to 1000ms 856 +))) 787 787 858 +((( 859 + 860 +))) 788 788 789 -* **Downlink Payload:** 862 +* ((( 863 +**Downlink Payload:** 864 +))) 790 790 866 +((( 791 791 **0x AA aa bb cc** 868 +))) 792 792 870 +((( 793 793 Same as: AT+CMDDLaa=hex(bb cc)*1000 872 +))) 794 794 874 +((( 795 795 **Example:** 876 +))) 796 796 878 +((( 797 797 0xAA 01 00 01 ~-~-> Same as **AT+CMDDL1=1000 ms** 880 +))) 798 798 799 799 800 800 884 + 801 801 ==== **Uplink payload mode** ==== 802 802 887 +((( 803 803 Define to use one uplink or multiple uplinks for the sampling. 889 +))) 804 804 891 +((( 805 805 The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]] 893 +))) 806 806 807 -* **AT Command:** 895 +* ((( 896 +**AT Command:** 897 +))) 808 808 809 809 (% class="box infomessage" %) 810 810 ((( 901 +((( 811 811 **AT+DATAUP=0** 812 812 ))) 904 +))) 813 813 814 814 (% class="box infomessage" %) 815 815 ((( 908 +((( 816 816 **AT+DATAUP=1** 817 817 ))) 911 +))) 818 818 913 +((( 914 + 915 +))) 819 819 820 -* **Downlink Payload:** 917 +* ((( 918 +**Downlink Payload:** 919 +))) 821 821 921 +((( 822 822 **0xAD 00** **~-~->** Same as AT+DATAUP=0 923 +))) 823 823 925 +((( 824 824 **0xAD 01** **~-~->** Same as AT+DATAUP=1 927 +))) 825 825 826 826 827 827 931 + 828 828 ==== **Manually trigger an Uplink** ==== 829 829 934 +((( 830 830 Ask device to send an uplink immediately. 936 +))) 831 831 832 -* **AT Command:** 938 +* ((( 939 +**AT Command:** 940 +))) 833 833 942 +((( 834 834 No AT Command for this, user can press the [[ACT button>>||anchor="H3.7Buttons"]] for 1 second for the same. 944 +))) 835 835 946 +((( 947 + 948 +))) 836 836 837 -* **Downlink Payload:** 950 +* ((( 951 +**Downlink Payload:** 952 +))) 838 838 954 +((( 839 839 **0x08 FF**, RS485-LN will immediately send an uplink. 956 +))) 840 840 841 841 842 842 960 + 843 843 ==== **Clear RS485 Command** ==== 844 844 963 +((( 845 845 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 965 +))) 846 846 847 -* **AT Command:** 967 +* ((( 968 +**AT Command:** 969 +))) 848 848 971 +((( 849 849 **AT+CMDEAR=mm,nn** mm: start position of erase ,nn: stop position of erase 973 +))) 850 850 975 +((( 851 851 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10 977 +))) 852 852 979 +((( 853 853 Example screen shot after clear all RS485 commands. 981 +))) 854 854 983 +((( 984 + 985 +))) 855 855 987 +((( 856 856 The uplink screen shot is: 989 +))) 857 857 858 858 [[image:1654160691922-496.png]] 859 859 860 860 861 -* **Downlink Payload:** 994 +* ((( 995 +**Downlink Payload:** 996 +))) 862 862 998 +((( 863 863 **0x09 aa bb** same as AT+CMDEAR=aa,bb 1000 +))) 864 864 865 865 866 866 1004 + 867 867 ==== **Set Serial Communication Parameters** ==== 868 868 1007 +((( 869 869 Set the Rs485 serial communication parameters: 1009 +))) 870 870 871 -* **AT Command:** 1011 +* ((( 1012 +**AT Command:** 1013 +))) 872 872 1015 +((( 873 873 Set Baud Rate: 1017 +))) 874 874 875 875 (% class="box infomessage" %) 876 876 ((( 1021 +((( 877 877 **AT+BAUDR=9600** ~/~/ Options: (1200,2400,4800,14400,19200,115200) 878 878 ))) 1024 +))) 879 879 1026 +((( 880 880 Set UART Parity 1028 +))) 881 881 882 882 (% class="box infomessage" %) 883 883 ((( 1032 +((( 884 884 **AT+PARITY=0** ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity 885 885 ))) 1035 +))) 886 886 1037 +((( 887 887 Set STOPBIT 1039 +))) 888 888 889 889 (% class="box infomessage" %) 890 890 ((( 1043 +((( 891 891 **AT+STOPBIT=0** ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits 892 892 ))) 1046 +))) 893 893 1048 +((( 1049 + 1050 +))) 894 894 895 -* **Downlink Payload:** 1052 +* ((( 1053 +**Downlink Payload:** 1054 +))) 896 896 1056 +((( 897 897 **A7 01 aa bb**: Same AT+BAUDR=hex(aa bb)*100 1058 +))) 898 898 1060 +((( 899 899 **Example:** 1062 +))) 900 900 901 -* A7 01 00 60 same as AT+BAUDR=9600 902 -* 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 +))) 903 903 1071 +((( 904 904 A7 02 aa: Same as AT+PARITY=aa (aa value: 00 , 01 or 02) 1073 +))) 905 905 1075 +((( 906 906 A7 03 aa: Same as AT+STOPBIT=aa (aa value: 00 , 01 or 02) 1077 +))) 907 907 908 908 1080 + 1081 + 909 909 == 3.6 Listening mode for RS485 network == 910 910 1084 +((( 911 911 This feature support since firmware v1.4 1086 +))) 912 912 1088 +((( 913 913 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 +))) 914 914 915 915 [[image:image-20220602171200-8.png||height="567" width="1007"]] 916 916 1094 +((( 917 917 To enable the listening mode, use can run the command AT+RXMODE. 1096 +))) 918 918 1098 +((( 1099 + 1100 +))) 919 919 920 -(% border="1" style="background-color:#ffffcc; width:500px" %) 921 -|=(% style="width: 161px;" %)**Command example:**|=(% style="width: 337px;" %)**Function** 922 -|(% 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. 923 -|(% 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 924 -|(% style="width:161px" %)AT+RXMODE=0,0|(% style="width:337px" %)Disable listening mode. This is the default settings. 925 -|(% 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 +))) 926 926 1129 +((( 927 927 **Downlink Command:** 1131 +))) 928 928 1133 +((( 929 929 **0xA6 aa bb cc ** same as AT+RXMODE=aa,(bb<<8 | cc) 1135 +))) 930 930 1137 +((( 1138 + 1139 +))) 931 931 1141 +((( 932 932 **Example**: 1143 +))) 933 933 1145 +((( 934 934 The RS485-LN is set to AT+RXMODE=2,1000 1147 +))) 935 935 1149 +((( 936 936 There is a two Modbus commands in the RS485 network as below: 1151 +))) 937 937 1153 +((( 938 938 The Modbus master send a command: (% style="background-color:#ffc000" %)01 03 00 00 00 02 c4 0b 1155 +))) 939 939 1157 +((( 940 940 And Modbus slave reply with: (% style="background-color:green" %)01 03 04 00 00 00 00 fa 33 1159 +))) 941 941 1161 +((( 942 942 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 +))) 943 943 1165 +((( 944 944 [[image:image-20220602171200-9.png]] 1167 +))) 945 945 1169 +((( 1170 + 1171 +))) 946 946 1173 +((( 947 947 (% 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 +))) 948 948 949 949 950 950 == 3.7 Buttons == 951 951 952 952 953 -(% border="1" style="background-color:#f7faff; width: 500px" %)954 -|=**Button**|=(% style="width: 1420px;" %)**Feature**955 -|**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**956 -|**RST**|(% style="width: 1420px" %)Reboot RS485957 -|**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"]] 958 958 1187 + 1188 + 959 959 == 3.8 LEDs == 960 960 961 -(% border="1" style="background-color:#f7faff; width:500px" %) 962 -|=**LEDs**|=**Feature** 963 -|**PWR**|Always on if there is power 964 -|**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.1191 +(% border="1" cellspacing="10" style="background-color:#f7faff; width:500px" %) 1192 +|=(% style="width: 30px;" %)**LEDs**|=(% style="width: 400px;" %)**Feature** 1193 +|(% style="width:30px" %)**PWR**|=(% style="width: 400px;" %)Always on if there is power 1194 +|(% 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. 965 965 966 966 = 4. Case Study = 967 967 ... ... @@ -972,19 +972,26 @@ 972 972 973 973 == 5.1 Access AT Command == 974 974 1205 +((( 975 975 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 +))) 976 976 977 977 [[image:1654162355560-817.png]] 978 978 979 979 1212 +((( 980 980 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 +))) 981 981 982 982 [[image:1654162368066-342.png]] 983 983 984 984 1219 +((( 985 985 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 +))) 986 986 987 987 1224 + 988 988 == 5.2 Common AT Command Sequence == 989 989 990 990 === 5.2.1 Multi-channel ABP mode (Use with SX1301/LG308) === ... ... @@ -1139,7 +1139,6 @@ 1139 1139 * (% style="color:blue" %)**RU864**(%%): frequency bands RU864 1140 1140 * (% style="color:blue" %)**KZ865**(%%): frequency bands KZ865 1141 1141 1142 - 1143 1143 = 9.Packing Info = 1144 1144 1145 1145 ... ... @@ -1156,7 +1156,6 @@ 1156 1156 * Package Size / pcs : 14.5 x 8 x 5 cm 1157 1157 * Weight / pcs : 170g 1158 1158 1159 - 1160 1160 = 10. FCC Caution for RS485LN-US915 = 1161 1161 1162 1162 (((