Last modified by Mengting Qiu on 2025/07/14 09:59

From version 32.15
edited by Xiaoling
on 2022/06/02 15:26
Change comment: There is no comment for this version
To version 117.1
edited by Mengting Qiu
on 2024/09/25 14:40
Change comment: Uploaded new attachment "image-20240925144019-1.jpeg", version {1}

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -RS485-LN – RS485 to LoRaWAN Converter
1 +RS485-LN – RS485 to LoRaWAN Converter User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.ting
Content
... ... @@ -1,28 +1,44 @@
1 -(% style="text-align:center" %)
2 -[[image:1653266934636-343.png||height="385" width="385"]]
1 +(% aria-label="1653266934636-343.png image widget" contenteditable="false" role="region" tabindex="-1" %)
2 +(((
3 +(% data-widget="image" style="text-align:center" %)
4 +[[image:1653266934636-343.png||height="385" width="385"]](% title="Click and drag to resize" %)​
3 3  
6 +(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
7 +)))
4 4  
5 5  
6 -**RS485-LN – RS485 to LoRaWAN Converter User Manual**
7 7  
8 8  
12 +
13 +
14 +
9 9  **Table of Contents:**
10 10  
17 +{{toc/}}
11 11  
12 12  
20 +(% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %)
21 +(((
22 +(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
23 +)))
13 13  
14 14  
15 -= 1.Introduction =
16 16  
27 +
28 +
29 +
30 +
31 += 1. Introduction =
32 +
17 17  == 1.1 What is RS485-LN RS485 to LoRaWAN Converter ==
18 18  
35 +
19 19  (((
20 -(((
21 21  The Dragino RS485-LN is a (% style="color:blue" %)**RS485 to LoRaWAN Converter**(%%). It converts the RS485 signal into LoRaWAN wireless signal which simplify the IoT installation and reduce the installation/maintaining cost.
22 22  )))
23 23  
24 24  (((
25 -RS485-LN allows user to (% style="color:blue" %)**monitor / control RS485 devices**(%%) and reach extremely long ranges. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. It targets professional wireless sensor network applications such as irrigation systems, smart metering, smart cities, smartphone detection, building automation, and so on.
41 +RS485-LN allows user to (% style="color:blue" %)**monitor / control RS485 devices**(%%) and reach extremely long ranges. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. It targets professional wireless sensor network applications such as irrigation systems, smart metering, smart cities, building automation, and so on.
26 26  )))
27 27  
28 28  (((
... ... @@ -31,31 +31,33 @@
31 31  
32 32  (((
33 33  (% style="color:blue" %)**For data downlink**(%%), RS485-LN runs in LoRaWAN Class C. When there downlink commands from LoRaWAN server, RS485-LN will forward the commands from LoRaWAN server to RS485 devices.
50 +)))
34 34  
52 +(((
35 35  (% style="color:blue" %)**Demo Dashboard for RS485-LN**(%%) connect to two energy meters: [[https:~~/~~/app.datacake.de/dashboard/d/58844a26-378d-4c5a-aaf5-b5b5b153447a>>url:https://app.datacake.de/dashboard/d/58844a26-378d-4c5a-aaf5-b5b5b153447a]]
36 36  )))
37 -)))
38 38  
39 -[[image:1653267211009-519.png||height="419" width="724"]]
40 40  
57 +(% aria-label="1653267211009-519.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1653267211009-519.png||data-widget="image" height="419" width="724"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
41 41  
59 +
42 42  == 1.2 Specifications ==
43 43  
44 44  
45 -**Hardware System:**
63 +(% style="color:#037691" %)**Hardware System:**
46 46  
47 -* STM32L072CZT6 MCU
65 +* STM32L072xxxx MCU
48 48  * SX1276/78 Wireless Chip 
49 49  * Power Consumption (exclude RS485 device):
50 50  ** Idle: 32mA@12v
51 51  ** 20dB Transmit: 65mA@12v
52 52  
53 -**Interface for Model:**
71 +(% style="color:#037691" %)**Interface for Model:**
54 54  
55 55  * RS485
56 56  * Power Input 7~~ 24V DC. 
57 57  
58 -**LoRa Spec:**
76 +(% style="color:#037691" %)**LoRa Spec:**
59 59  
60 60  * Frequency Range:
61 61  ** Band 1 (HF): 862 ~~ 1020 Mhz
... ... @@ -74,14 +74,13 @@
74 74  * Preamble detection.
75 75  * 127 dB Dynamic Range RSSI.
76 76  * Automatic RF Sense and CAD with ultra-fast AFC.
77 -* Packet engine up to 256 bytes with CRC.
95 +* Packet engine up to 256 bytes with CRC
78 78  
79 -
80 -
81 81  == 1.3 Features ==
82 82  
99 +
83 83  * LoRaWAN Class A & Class C protocol (default Class C)
84 -* Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865/RU864
101 +* Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865/RU864/MA869
85 85  * AT Commands to change parameters
86 86  * Remote configure parameters via LoRa Downlink
87 87  * Firmware upgradable via program port
... ... @@ -89,10 +89,9 @@
89 89  * Support Modbus protocol
90 90  * Support Interrupt uplink (Since hardware version v1.2)
91 91  
92 -
93 -
94 94  == 1.4 Applications ==
95 95  
111 +
96 96  * Smart Buildings & Home Automation
97 97  * Logistics and Supply Chain Management
98 98  * Smart Metering
... ... @@ -100,20 +100,24 @@
100 100  * Smart Cities
101 101  * Smart Factory
102 102  
103 -
104 -
105 105  == 1.5 Firmware Change log ==
106 106  
121 +
107 107  [[RS485-LN Image files – Download link and Change log>>url:http://www.dragino.com/downloads/index.php?dir=RS485-LN/]]
108 108  
109 109  
110 110  == 1.6 Hardware Change log ==
111 111  
127 +
112 112  (((
113 113  (((
130 +(((
114 114  v1.2: Add External Interrupt Pin.
132 +)))
115 115  
134 +(((
116 116  v1.0: Release
136 +)))
117 117  
118 118  
119 119  )))
... ... @@ -121,6 +121,7 @@
121 121  
122 122  = 2. Power ON Device =
123 123  
144 +
124 124  (((
125 125  The RS485-LN can be powered by 7 ~~ 24V DC power source. Connection as below
126 126  
... ... @@ -131,7 +131,7 @@
131 131  Once there is power, the RS485-LN will be on.
132 132  )))
133 133  
134 -[[image:1653268091319-405.png]]
155 +(% aria-label="1653268091319-405.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1653268091319-405.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
135 135  
136 136  
137 137  )))
... ... @@ -140,8 +140,11 @@
140 140  
141 141  == 3.1 How it works? ==
142 142  
164 +
143 143  (((
166 +(((
144 144  The RS485-LN is configured as LoRaWAN OTAA Class C mode by default. It has OTAA keys to join network. To connect a local LoRaWAN network, user just need to input the OTAA keys in the network server and power on the RS485-LN. It will auto join the network via OTAA.
168 +)))
145 145  
146 146  
147 147  )))
... ... @@ -148,11 +148,13 @@
148 148  
149 149  == 3.2 Example to join LoRaWAN network ==
150 150  
175 +
151 151  Here shows an example for how to join the TTN V3 Network. Below is the network structure, we use [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]] as LoRaWAN gateway here. 
152 152  
153 -[[image:1653268155545-638.png||height="334" width="724"]]
154 154  
179 +(% aria-label="1653268155545-638.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1653268155545-638.png||data-widget="image" height="334" width="724"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
155 155  
181 +
156 156  (((
157 157  (((
158 158  The RS485-LN in this example connected to two RS485 devices for demonstration, user can connect to other RS485 devices via the same method. The connection is as below:
... ... @@ -160,16 +160,21 @@
160 160  
161 161  (((
162 162  485A+ and 485B- of the sensor are connected to RS485A and RA485B of RS485-LN respectively.
189 +
190 +
163 163  )))
164 164  
165 -[[image:1653268227651-549.png||height="592" width="720"]]
193 +(% aria-label="1653268227651-549.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1653268227651-549.png||data-widget="image" height="592" width="720"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
166 166  
195 +
167 167  (((
168 -The LG308 is already set to connect to [[TTN V3 network >>path:eu1.cloud.thethings.network/]]. So what we need to now is only configure the TTN V3:
197 +The LG308 is already set to connect to [[TTN V3 network >>path:https://www.thethingsnetwork.org/]]. So what we need to now is only configure the TTN V3:
198 +
199 +
169 169  )))
170 170  
171 171  (((
172 -**Step 1**: Create a device in TTN V3 with the OTAA keys from RS485-LN.
203 +(% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from RS485-LN.
173 173  )))
174 174  
175 175  (((
... ... @@ -177,106 +177,133 @@
177 177  )))
178 178  )))
179 179  
180 -[[image:1652953462722-299.png]]
211 +(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]][[image:image-20230425175410-2.png]](% title="Click and drag to resize" %)​
181 181  
213 +
182 182  (((
183 183  (((
184 184  User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:
217 +
218 +
185 185  )))
186 186  
187 187  (((
188 -Add APP EUI in the application.
222 +**Add APP EUI in the application.**
189 189  )))
190 190  )))
191 191  
192 -[[image:image-20220519174512-1.png]]
226 +(% aria-label="image-20220519174512-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220519174512-1.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
193 193  
194 -[[image:image-20220519174512-2.png||height="323" width="720"]]
228 +(% aria-label="image-20220519174512-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220519174512-2.png||data-widget="image" height="323" width="720"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
195 195  
196 -[[image:image-20220519174512-3.png||height="556" width="724"]]
230 +(% aria-label="image-20220519174512-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220519174512-3.png||data-widget="image" height="556" width="724"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
197 197  
198 -[[image:image-20220519174512-4.png]]
232 +(% aria-label="image-20220519174512-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220519174512-4.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]]
199 199  
234 +
235 +(% title="Click and drag to resize" %)​
236 +
200 200  You can also choose to create the device manually.
201 201  
202 -[[image:1652953542269-423.png||height="710" width="723"]]
239 +(% aria-label="1652953542269-423.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1652953542269-423.png||data-widget="image" height="710" width="723"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
203 203  
204 -Add APP KEY and DEV EUI
205 205  
206 -[[image:1652953553383-907.png||height="514" width="724"]]
207 207  
243 +**Add APP KEY and DEV EUI**
208 208  
245 +(% aria-label="1652953553383-907.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1652953553383-907.png||data-widget="image" height="514" width="724"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
246 +
247 +
209 209  (((
210 -**Step 2**: Power on RS485-LN and it will auto join to the TTN V3 network. After join success, it will start to upload message to TTN V3 and user can see in the panel.
249 +(% style="color:blue" %)**Step 2**(%%): Power on RS485-LN and it will auto join to the TTN V3 network. After join success, it will start to upload message to TTN V3 and user can see in the panel.
250 +
251 +
211 211  )))
212 212  
213 -[[image:1652953568895-172.png||height="232" width="724"]]
254 +(% aria-label="1652953568895-172.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1652953568895-172.png||data-widget="image" height="232" width="724"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
214 214  
215 215  
216 -== 3.3 Configure Commands to read data ==
257 +== 3.3 Configure Device to Read RS485 Sensors ==
217 217  
259 +
260 +There are plenty of RS485 and TTL level devices in the market and each device has different commands to read the valid data. To support these devices in most flexible, RS485-LN supports flexible command set. User can use [[Dragino RS485 Tool>>url:https://www.dropbox.com/sh/us9qecn39fwt8n1/AABREdqUCzEmJMRrfuWuXasoa?dl=0]],  [[AT Commands or LoRaWAN Downlink>>url:http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/#H3.5ConfigureRS485-LBviaATorDownlink]] Command to configure how RS485-LN should read the sensor and how to handle the return from RS485 or TTL sensors.
261 +
262 +
218 218  (((
219 219  (((
220 -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>>path:#AT_COMMAND]] or LoRaWAN Downlink Command to configure what commands RS485-LN should send for each sampling and how to handle the return from RS485 devices.
265 +(((
266 +(% 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**
221 221  )))
222 222  
223 -(((
224 -(% 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
225 225  
226 -
270 +=== 3.3.1 Method 1 ~-~- via RS485 Configure Tool ===
271 +
272 +
273 +Use the RS485 Configure tool is the recommand method. Please see the instruction of how to use the tool:
274 +
275 +* **[[RS485 Configure Tool Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/RS485_Configure_Tool/]]**
276 +
277 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/RS485-LB_Waterproof_RS485UART_to_LoRaWAN_Converter/WebHome/image-20231127144411-1.png?width=494&height=368&rev=1.1||alt="image-20231127144411-1.png" height="368" width="494"]]
278 +
279 +
280 +=== 3.3.2  Method 2 ~-~- via AT Commands ===
227 227  )))
228 228  )))
229 229  
230 -=== 3.3.1 onfigure UART settings for RS485 or TTL communication ===
284 +==== 3.3.2.1 Configure UART settings for RS485 communication ====
231 231  
232 -To use RS485-LN to read data from RS485 sensors, connect the RS485-LN A/B traces to the sensors. And user need to make sure RS485-LN use the match UART setting to access the sensors. The related commands for UART settings are:
233 233  
234 -(% border="1" style="background-color:#ffffcc; color:green; width:795px" %)
235 -|(((
287 +To use RS485-LN to read data from RS485 sensors, connect the RS485-LN A/B traces to the sensors. The related commands for UART settings are:
288 +
289 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
290 +|=(% style="width: 126px; background-color:#4F81BD;color:white" %)(((
236 236  **AT Commands**
237 -)))|(% style="width:285px" %)(((
292 +)))|=(% style="width: 187px; background-color:#4F81BD;color:white" %)(((
238 238  **Description**
239 -)))|(% style="width:347px" %)(((
294 +)))|=(% style="width: 197px;background-color:#4F81BD;color:white" %)(((
240 240  **Example**
241 241  )))
242 -|(((
297 +|(% style="width:126px" %)(((
298 +
299 +
300 +(((
243 243  AT+BAUDR
244 -)))|(% style="width:285px" %)(((
302 +)))
303 +)))|(% style="width:177px" %)(((
245 245  Set the baud rate (for RS485 connection). Default Value is: 9600.
246 -)))|(% style="width:347px" %)(((
305 +)))|(% style="width:193px" %)(((
247 247  (((
248 248  AT+BAUDR=9600
249 249  )))
250 250  
251 251  (((
252 -Options: (1200,2400,4800,14400,19200,115200)
311 +Options: (1200,2400,4800,
312 +14400,19200,115200)
253 253  )))
254 254  )))
255 -|(((
315 +|(% style="width:126px" %)(((
256 256  AT+PARITY
257 -)))|(% style="width:285px" %)(((
317 +)))|(% style="width:177px" %)(((
258 258  Set UART parity (for RS485 connection)
259 -)))|(% style="width:347px" %)(((
319 +)))|(% style="width:193px" %)(((
260 260  (((
261 261  AT+PARITY=0
262 262  )))
263 263  
264 264  (((
265 -Option: 0: no parity, 1: odd parity, 2: even parity
325 +Option: 0: no parity,
326 +1: odd parity,
327 +2: even parity
266 266  )))
267 267  )))
268 -|(((
330 +|(% style="width:126px" %)(((
269 269  AT+STOPBIT
270 -)))|(% style="width:285px" %)(((
332 +)))|(% style="width:177px" %)(((
271 271  (((
272 272  Set serial stopbit (for RS485 connection)
273 273  )))
274 -
336 +)))|(% style="width:193px" %)(((
275 275  (((
276 -
277 -)))
278 -)))|(% style="width:347px" %)(((
279 -(((
280 280  AT+STOPBIT=0 for 1bit
281 281  )))
282 282  
... ... @@ -289,906 +289,1519 @@
289 289  )))
290 290  )))
291 291  
292 -=== 3.3.2 Configure sensors ===
350 +=== 3.3.3 Configure sensors ===
293 293  
352 +
294 294  (((
295 -(((
296 -Some sensors might need to configure before normal operation. User can configure such sensor via PC and RS485 adapter or through RS485-LN AT Commands (% style="color:#4f81bd" %)**AT+CFGDEV**(%%). Each (% style="color:#4f81bd" %)**AT+CFGDEV **(%%)equals to send a RS485 command to sensors. This command will only run when user input it and won’t run during each sampling.
354 +Some sensors might need to configure before normal operation. User can configure such sensor via PC and RS485 adapter or through RS485-LN AT Commands (% style="color:#4f81bd" %)**AT+CFGDEV**(%%). Each (% style="color:#4f81bd" %)**AT+CFGDEV **(%%)equals to send a RS485 command to sensors. This command will only run when user input it and won't run during each sampling.
297 297  )))
298 -)))
299 299  
300 -(% border="1" style="background-color:#ffffcc; color:green; width:806px" %)
301 -|**AT Commands**|(% style="width:418px" %)**Description**|(% style="width:256px" %)**Example**
302 -|AT+CFGDEV|(% style="width:418px" %)(((
357 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
358 +|=(% style="width: 122px; background-color:#4F81BD;color:white" %)**AT Commands**|=(% style="width: 198px; background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 190px;background-color:#4F81BD;color:white" %)**Example**
359 +|(% style="width:122px" %)AT+CFGDEV|(% style="width:196px" %)(((
360 +(((
303 303  This command is used to configure the RS485/TTL devices; they won’t be used during sampling.
362 +)))
304 304  
364 +(((
305 305  AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,
366 +)))
306 306  
368 +(((
307 307  mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
308 -)))|(% style="width:256px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
370 +)))
371 +)))|(% style="width:190px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
309 309  
310 -=== 3.3.3 Configure read commands for each sampling ===
373 +=== 3.3.4 Configure read commands for each sampling ===
311 311  
375 +
312 312  (((
313 -RS485-BL is a battery powered device; it will sleep most of time. And wake up on each period and read RS485 / TTL sensor data and uplink.
377 +During each sampling, we need confirm what commands we need to send to the RS485 sensors to read data. After the RS485 sensors send back the value, it normally include some bytes and we only need a few from them for a shorten payload.
378 +
379 +To save the LoRaWAN network bandwidth, we might need to read data from different sensors and combine their valid value into a short payload.
380 +
381 +This section describes how to achieve above goals.
382 +
383 +During each sampling, the RS485-LN can support 15 commands to read sensors. And combine the return to one or several uplink payloads.
384 +
385 +
386 +(% style="color:#037691" %)**Each RS485 commands include two parts:**
387 +
388 +
389 +~1. What commands RS485-LN will send to the RS485 sensors. There are total 15 commands from **AT+COMMAD1**, **ATCOMMAND2**,…, to **AT+COMMANDF**. All commands are of same grammar.
390 +
391 +2. How to get wanted value the from RS485 sensors returns from by 1). There are total 15 AT Commands to handle the return, commands are **AT+DATACUT1**,**AT+DATACUT2**,…, **AT+DATACUTF** corresponding to the commands from 1). All commands are of same grammar.
392 +
393 +3. Some RS485 device might has longer delay on reply, so user can use AT+CMDDL to set the timeout for getting reply after the RS485 command is sent. For example **AT+CMDDL1=1000** to send the open time to 1000ms
394 +
395 +
396 +After we got the valid value from each RS485 commands, we need to combine them together with the command **AT+DATAUP**.
397 +
398 +Below are examples for the how above AT Commands works.
399 +
400 +
401 +(% style="color:#037691" %)**AT+COMMANDx **(%%)**: **This command will be sent to RS485 devices during each sampling, Max command length is 14 bytes. The grammar is:
402 +
403 +(% border="1" style="background-color:#f2f2f2; width:499px" %)
404 +|(% style="width:496px" %)(((
405 +**AT+COMMANDx=xx xx xx xx xx xx xx xx xx xx xx xx,m**
406 +
407 +**xx xx xx xx xx xx xx xx xx xx xx xx: The RS485 command to be sent**
408 +
409 +**m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command**
314 314  )))
315 315  
412 +For example, if we have a RS485 sensor. The command to get sensor value is: 01 03 0B B8 00 02 46 0A. Where 01 03 0B B8 00 02 is the Modbus command to read the register 0B B8 where stored the sensor value. The 46 0A is the CRC-16/MODBUS which calculate manually.
413 +
414 +In the RS485-LN, we should use this command AT+COMMAND1=01 03 0B B8 00 02,1 for the same.
415 +
416 +
417 +If a single command exceeds 14 bytes, you can use the command splicing function.
418 +
419 +When AT+CMDDLx=1, the commands of AT+COMMANDx and AT+COMMAND(x+1) will be merged.
420 +
421 +
422 +**Examples:** To send 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F data it should be configured:
423 +
424 + AT+COMMAND1=00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D,0
425 +
426 + AT+COMMAND1=1
427 +
428 + AT+COMMAND2=0E 0F,0
429 +
430 +
431 +(% style="color:#037691" %)**AT+DATACUTx **(%%)**: **This command defines how to handle the return from AT+COMMANDx, max return length is 100 bytes.
432 +
433 +(% border="1" style="background-color:#f2f2f2; width:510px" %)
434 +|(% style="width:510px" %)(((
435 +**AT+DATACUTx=a,b,c**
436 +
437 +* **a: length for the return of AT+COMMAND**
438 +* **b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
439 +* **c: define the position for valid value.  **
440 +)))
441 +
442 +**Examples:**
443 +
444 +
445 +* (% style="color:#037691" %)**Grab bytes**
446 +
447 +(% aria-label="image-20220602153621-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602153621-1.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
448 +
449 +
450 +
451 +* (% style="color:#037691" %)**Grab a section**
452 +
453 +(% aria-label="image-20220602153621-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602153621-2.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
454 +
455 +
456 +
457 +* (% style="color:#037691" %)**Grab different sections**
458 +
459 +(% aria-label="image-20220602153621-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602153621-3.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
460 +
461 +
462 +)))
463 +
464 +=== 3.3.5 Compose the uplink payload ===
465 +
466 +
316 316  (((
317 -During each sampling, we need to confirm what commands we need to send to the sensors to read data. After the RS485/TTL sensors send back the value, it normally includes some bytes and we only need a few from them for a shorten payload.
468 +Through AT+COMMANDx and AT+DATACUTx we got valid value from each RS485 commands, Assume these valid value are RETURN1, RETURN2, .., to RETURNx. The next step is how to compose the LoRa Uplink Payload by these RETURNs. The command is **AT+DATAUP.**
469 +
470 +
318 318  )))
319 319  
320 320  (((
321 -To save the LoRaWAN network bandwidth, we might need to read data from different sensors and combine their valid value into a short payload.
474 +(% style="color:#037691" %)**Examples: AT+DATAUP=0**
475 +
476 +
322 322  )))
323 323  
324 324  (((
325 -This section describes how to achieve above goals.
480 +Compose the uplink payload with value returns in sequence and send with (% style="color:red" %)**A SIGNLE UPLINK**.
326 326  )))
327 327  
328 328  (((
329 -During each sampling, the RS485-BL can support 15 commands to read sensors. And combine the return to one or several uplink payloads.
484 +Final Payload is (% style="color:#4f81bd" %)**Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx**
330 330  )))
331 331  
332 332  (((
333 -**Command from RS485-BL to Sensor:**
488 +Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
489 +
490 +
334 334  )))
335 335  
493 +[[image:image-20220929111027-1.png||height="509" width="685"]](% title="Click and drag to resize" %)​
494 +
495 +
496 +(% style="color:#037691" %)**Examples: AT+DATAUP=1**
497 +
498 +
499 +Compose the uplink payload with value returns in sequence and send with (% style="color:red" %)**Multiply UPLINKs**.
500 +
501 +Final Payload is (% style="color:#4f81bd" %)**PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
502 +
503 +
504 +~1. PAYVER: Defined by AT+PAYVER
505 +
506 +2. PAYLOAD COUNT: Total how many uplinks of this sampling.
507 +
508 +3. PAYLOAD#: Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
509 +
510 +4. DATA: Valid value: max 8 bytes for each uplink so each uplink <= 11 bytes. For the last uplink, DATA will might less than 8 bytes
511 +
512 +
513 +(% aria-label="image-20220602155039-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602155039-4.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
514 +
515 +
516 +So totally there will be 3 uplinks for this sampling, each uplink include 8 bytes DATA
517 +
518 +DATA1=RETURN1 Valid Value + the first two of Valid value of RETURN10= **20 20 0a 33 90 41 02 aa**
519 +
520 +DATA2=3^^rd^^ ~~ 10^^th^^ byte of Valid value of RETURN10= **05 81 0a 20 20 20 20 2d**
521 +
522 +DATA3=the rest of Valid value of RETURN10= **30**
523 +
524 +
525 +(% style="color:red" %)**Notice: In firmware v1.3, the Max bytes has been changed according to the max bytes in different Frequency Bands for lowest SF. As below:**
526 +
527 +
528 + ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink.
529 +
530 + * For AU915/AS923 bands, if UplinkDwell time=0, max 11 bytes for each uplink.
531 +
532 + * For US915 band, max 11 bytes for each uplink.
533 +
534 + ~* For all other bands: max 51 bytes for each uplink.
535 +
536 +
537 +(% style="color:red" %)** When AT+DATAUP=1, the maximum number of segments is 15, and the maximum total number of bytes is 1500;**
538 +
539 +(% style="color:red" %)** When AT+DATAUP=1 and AT+ADR=0, the maximum number of bytes of each payload is determined by the DR value. (Since v1.4.0)**
540 +
541 +
542 +
543 +Below are the uplink payloads:
544 +
545 +
546 +(% aria-label="1654157178836-407.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1654157178836-407.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
547 +
548 +
549 +=== 3.3.6 Uplink on demand ===
550 +
551 +
552 +Except uplink periodically, RS485-LN is able to uplink on demand. The server send downlink command to RS485-LN and RS485 will uplink data base on the command.
553 +
554 +(% style="color:blue" %)**Downlink control command:**
555 +
556 +(% style="color:#4472c4" %)** 0x08 command**(%%): Poll an uplink with current command set in RS485-LN.
557 +
558 +(% style="color:#4472c4" %)** 0xA8 command**(%%): Send a command to RS485-LN and uplink the output from sensors.
559 +
560 +
561 +=== 3.3.7 Uplink on Interrupt ===
562 +
563 +
564 +RS485-LN support external Interrupt uplink since hardware v1.2 release.
565 +
566 +(% aria-label="1654157342174-798.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1654157342174-798.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
567 +
568 +Connect the Interrupt pin to RS485-LN INT port and connect the GND pin to V- port. When there is a high voltage (Max 24v) on INT pin. Device will send an uplink packet.
569 +
570 +
571 +== 3.4 Uplink Payload ==
572 +
573 +
574 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
575 +|(% style="background-color:#4f81bd; color:white; width:70px" %)(((
576 +**Size(bytes)**
577 +)))|(% style="background-color:#4f81bd; color:white; width:80px" %)**1**|(% style="background-color:#4f81bd; color:white; width:360px" %)(((
578 +**Length depends on the return from the commands**
579 +)))
580 +|(% style="width:90px" %)(((
581 +Value
582 +)))|(% style="width:114px" %)(((
583 +PAYLOAD_VER
584 +)))|(% style="width:353px" %)(((
585 +If the valid payload is too long and exceed the maximum
586 +
587 +support payload length in server, server will show payload not
588 +
589 +provided in the LoRaWAN server.
590 +)))
591 +
592 +(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](%%)Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
593 +
594 +
595 +== 3.5 Configure RS485-LN via AT or Downlink ==
596 +
597 +
336 336  (((
337 -RS485-BL can send out pre-set max 15 strings via **AT+COMMAD1**, **ATCOMMAND2**,…, to **AT+COMMANDF** . All commands are of same grammar.
599 +User can configure RS485-LN via AT Commands or LoRaWAN Downlink Commands
338 338  )))
339 339  
340 340  (((
341 -**Handle return from sensors to RS485-BL**:
603 +There are two kinds of Commands:
342 342  )))
343 343  
606 +* (((
607 +(% 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: [[AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
608 +)))
609 +
610 +* (((
611 +(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-LN.  User can see these commands below:
612 +)))
613 +
344 344  (((
345 -After RS485-BL send out a string to sensor, RS485-BL will wait for the return from RS485 or TTL sensor. And user can specify how to handle the return, by **AT+DATACUT or AT+SEARCH commands**
615 +
346 346  )))
347 347  
618 +
619 +=== 3.5.1 Common Commands ===
620 +
621 +
622 +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]]
623 +
624 +
625 +=== 3.5.2 Downlink Response(Since firmware v1.4) ===
626 +
627 +
628 +Response feature is added to the server's downlink, a special package with a FPort of 200 will be uploaded immediately after receiving the data sent by the server.
629 +
630 +
631 +(% aria-label="image-20220602163333-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602163333-5.png||data-widget="image" height="263" width="1160"]]
632 +
633 +(% title="Click and drag to resize" %)​
634 +
635 +The first byte of this package represents whether the configuration is successful, 00 represents failure, 01 represents success. Except for the first byte, the other is the previous downlink. (All commands except A8 type commands are applicable)
636 +
637 +
638 +=== 3.5.3 Sensor related commands ===
639 +
640 +
641 +
642 +==== (% style="color:blue" %)**RS485 Debug Command**(%%) ====
643 +
644 +
645 +(((
646 +This command is used to configure the RS485 devices; they won't be used during sampling. Max Length of AT+CFGDEV is **40 bytes**.
647 +)))
648 +
649 +(((
650 +* (% style="color:#037691" %)**AT Command**
651 +
652 +(((
653 +(% style="color:#4472c4" %)** AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**  (%%) m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
654 +)))
655 +)))
656 +
657 +(((
658 +
659 +)))
660 +
348 348  * (((
349 -**AT+DATACUT**
662 +(% style="color:#037691" %)**Downlink Payload**
350 350  )))
351 351  
352 352  (((
353 -When the return value from sensor have fix length and we know which position the valid value we should get, we can use AT+DATACUT command.
666 +Format: (% style="color:#4472c4" %)** A8 MM NN XX XX XX XX YY**
354 354  )))
355 355  
669 +(((
670 +Where:
671 +)))
672 +
356 356  * (((
357 -**AT+SEARCH**
674 +MM: 1: add CRC-16/MODBUS ; 0: no CRC
358 358  )))
676 +* (((
677 +NN: The length of RS485 command
678 +)))
679 +* (((
680 +XX XX XX XX: RS485 command total NN bytes
681 +)))
682 +* (((
683 +(((
684 +YY: How many bytes will be uplink from the return of this RS485 command,
685 +)))
359 359  
687 +* (((
688 +if YY=0, RS485-LN will execute the downlink command without uplink;
689 +)))
690 +* (((
691 +if YY>0, RS485-LN will uplink total YY bytes from the output of this RS485 command; Fport=200
692 +)))
693 +* (((
694 +if YY=FF, RS485-LN will uplink RS485 output with the downlink command content; Fport=200.
695 +)))
696 +)))
697 +
360 360  (((
361 -When the return value from sensor is dynamic length and we are not sure which bytes the valid data is, instead, we know what value the valid value following. We can use AT+SEARCH to search the valid value in the return string.
699 +
700 +
701 +(% style="color:blue" %)**Example 1:**  (%%) ~-~-> Configure without ask for uplink (YY=0)
362 362  )))
363 363  
364 364  (((
365 -**Define wait timeout:**
705 +To connect a Modbus Alarm with below commands.
366 366  )))
367 367  
708 +* (((
709 +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.
710 +)))
711 +
712 +* (((
713 +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.
714 +)))
715 +
368 368  (((
369 -Some RS485 device might has longer delay on reply, so user can use AT+CMDDL to set the timeout for getting reply after the RS485 command is sent. For example, AT+CMDDL1=1000 to send the open time to 1000ms
717 +
718 +
719 +So if user want to use downlink command to control to RS485 Alarm, he can use:
370 370  )))
371 371  
372 372  (((
373 -After we got the valid value from each RS485 commands, we need to combine them together with the command **AT+DATAUP**.
723 +(% style="color:#4f81bd" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
374 374  )))
375 375  
376 -**Examples:**
726 +(((
727 +(% style="color:#4f81bd" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
728 +)))
377 377  
378 -Below are examples for the how above AT Commands works.
730 +(((
731 +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.
732 +)))
379 379  
380 -**AT+COMMANDx : **This command will be sent to RS485/TTL devices during each sampling, Max command length is 14 bytes. The grammar is:
734 +(((
735 +
736 +)))
381 381  
382 -(% border="1" class="table-bordered" %)
383 -|(((
384 -**AT+COMMANDx=xx xx xx xx xx xx xx xx xx xx xx xx,m**
738 +(((
739 +(% style="color:blue" %)**Example 2:**  (%%)
740 +)))
385 385  
386 -**xx xx xx xx xx xx xx xx xx xx xx xx: The RS485 command to be sent**
742 +(((
743 +Check TTL Sensor return:
744 +)))
387 387  
388 -**m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command**
746 +(((
747 +(((
748 +[[image:http://8.211.40.43/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/test/WebHome/1654132684752-193.png?rev=1.1||alt="1654132684752-193.png"]](% title="Click and drag to resize" %)​
389 389  )))
750 +)))
390 390  
752 +
753 +
754 +==== (% style="color:blue" %)**Set Payload version**(%%) ====
755 +
756 +
391 391  (((
392 -For example, if we have a RS485 sensor. The command to get sensor value is: 01 03 0B B8 00 02 46 0A. Where 01 03 0B B8 00 02 is the Modbus command to read the register 0B B8 where stored the sensor value. The 46 0A is the CRC-16/MODBUS which calculate manually.
758 +This is the first byte of the uplink payload. RS485-LN can connect to different sensors. User can set the PAYVER field to tell server how to decode the current payload.
393 393  )))
394 394  
395 395  (((
396 -In the RS485-BL, we should use this command AT+COMMAND1=01 03 0B B8 00 02,1 for the same.
762 +* (% style="color:#037691" %)**AT Command:**
763 +
764 +(% style="color:#4472c4" %)** AT+PAYVER:    ** (%%) Set PAYVER field = 1
765 +
766 +
397 397  )))
398 398  
769 +* (((
770 +(% style="color:#037691" %)**Downlink Payload:**
771 +)))
772 +
399 399  (((
400 -**AT+SEARCHx**: This command defines how to handle the return from AT+COMMANDx.
774 +(% style="color:#4472c4" %)** 0xAE 01** (%%) ~-~->  Set PAYVER field =  0x01
401 401  )))
402 402  
403 -(% border="1" class="table-bordered" %)
404 -|(((
405 -**AT+SEARCHx=aa,xx xx xx xx xx**
777 +(((
778 +(% style="color:#4472c4" %)** 0xAE 0F**   (%%) ~-~->  Set PAYVER field =  0x0F
779 +)))
406 406  
407 -* **aa: 1: prefix match mode; 2: prefix and suffix match mode**
408 -* **xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix**
409 409  
782 +**1 )  Add the interrupt flag at the highest bit of the Payver byte, that is, Byte7 of the first byte. (Since v1.4.0)**
783 +
784 +
785 +[[image:image-20220824145428-2.png||height="168" width="1300"]]
786 +
787 +
788 +
789 +**2 )  if the data intercepted by AT+DATACUT or AT+MBFUN is empty, it will display NULL, and the payload will be filled with n FFs.**
790 +
791 +
792 +[[image:image-20220824145428-3.png||height="308" width="1200"]]
793 +
794 +
795 +
796 +==== (% style="color:blue" %)**Set RS485 Sampling Commands**(%%) ====
797 +
798 +
799 +(((
800 +AT+COMMANDx or AT+DATACUTx
801 +)))
802 +
803 +(((
804 +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"]].
805 +)))
806 +
807 +(((
410 410  
411 411  )))
412 412  
413 -**Examples:**
811 +* (((
812 +(% style="color:#037691" %)**AT Command:**
813 +)))
414 414  
415 -~1. For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
815 +(% style="color:#4472c4" %)** AT+COMMANDx:    ** (%%) Configure RS485 read command to sensor.
416 416  
417 -If we set AT+SEARCH1=1,1E 56 34.      (max 5 bytes for prefix)
817 +(% style="color:#4472c4" %)** AT+DATACUTx:        **(%%) Configure how to handle return from RS485 devices.
418 418  
419 -The valid data will be all bytes after 1E 56 34 , so it is (% style="background-color:yellow" %)** 2e 30 58 5f 36 41 30 31 00 49**
420 420  
421 -[[image:1653269403619-508.png]]
820 +* (((
821 +(% style="color:#037691" %)**Downlink Payload:**
822 +)))
422 422  
423 -2. For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
824 +(((
825 +(% style="color:#4472c4" %)** 0xAF**(%%) downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
424 424  
425 -If we set AT+SEARCH1=2, 1E 56 34+31 00 49
827 +
828 +)))
426 426  
427 -Device will search the bytes between 1E 56 34 and 31 00 49. So it is (% style="background-color:yellow" %)** 2e 30 58 5f 36 41 30**
830 +(((
831 +(% style="color:red" %)**Note : if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.**
428 428  
429 -[[image:1653269438444-278.png]]
833 +
834 +)))
430 430  
431 -**AT+DATACUTx : **This command defines how to handle the return from AT+COMMANDx, max return length is 45 bytes.
836 +(((
837 +Format: (% style="color:#4472c4" %)** AF MM NN LL XX XX XX XX YY**
838 +)))
432 432  
433 -|(((
434 -**AT+DATACUTx=a,b,c**
840 +(((
841 +Where:
842 +)))
435 435  
436 -* **a: length for the return of AT+COMMAND**
437 -* **b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
438 -* **c: define the position for valid value.  **
844 +* (((
845 +MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
439 439  )))
847 +* (((
848 +NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
849 +)))
850 +* (((
851 +LL:  The length of AT+COMMAND or AT+DATACUT command
852 +)))
853 +* (((
854 +XX XX XX XX: AT+COMMAND or AT+DATACUT command
855 +)))
856 +* (((
857 +YY:  If YY=0, RS485-LN will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command.
858 +)))
440 440  
441 -Examples:
860 +(((
861 +
442 442  
443 -* Grab bytes:
863 +**Example:**
864 +)))
444 444  
445 -[[image:1653269551753-223.png||height="311" width="717"]]
866 +(((
867 +(% 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
868 +)))
446 446  
447 -* Grab a section.
870 +(((
871 +(% 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**
872 +)))
448 448  
449 -[[image:1653269568276-930.png||height="325" width="718"]]
874 +(((
875 +(% 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**
876 +)))
450 450  
451 -* Grab different sections.
452 452  
453 -[[image:1653269593172-426.png||height="303" width="725"]]
454 454  
455 -(% style="color:red" %)**Note:**
880 +==== (% style="color:blue" %)**Fast command to handle MODBUS device**(%%) ====
456 456  
457 -AT+SEARCHx and AT+DATACUTx can be used together, if both commands are set, RS485-BL will first process AT+SEARCHx on the return string and get a temporary string, and then process AT+DATACUTx on this temporary string to get the final payload. In this case, AT+DATACUTx need to set to format AT+DATACUTx=0,xx,xx where the return bytes set to 0.
458 458  
459 -Example:
883 +(((
884 +(% style="color:#4472c4" %)** 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]].
885 +)))
460 460  
461 -(% style="color:red" %)AT+COMMAND1=11 01 1E D0,0
887 +(((
888 +This command is valid since v1.3 firmware version
889 +)))
462 462  
463 -(% style="color:red" %)AT+SEARCH1=1,1E 56 34
891 +(((
892 +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.
893 +)))
464 464  
465 -(% style="color:red" %)AT+DATACUT1=0,2,1~~5
895 +(((
896 +
897 +)))
466 466  
467 -(% style="color:red" %)Return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
899 +(((
900 +**Example:**
901 +)))
468 468  
469 -(% style="color:red" %)String after SEARCH command: 2e 30 58 5f 36 41 30 31 00 49
903 +* (((
904 +AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2  are not configure (0,0,0). So RS485-LN.
905 +)))
906 +* (((
907 +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.
908 +)))
909 +* (((
910 +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.
470 470  
471 -(% style="color:red" %)Valid payload after DataCUT command: 2e 30 58 5f 36
912 +
913 +)))
472 472  
473 -[[image:1653269618463-608.png]]
915 +(% aria-label="image-20220602165351-6.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602165351-6.png||data-widget="image"]]
474 474  
475 -=== 3.3.4 Compose the uplink payload ===
917 +(% title="Click and drag to resize" %)​
476 476  
919 +(% aria-label="image-20220602165351-7.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602165351-7.png||data-widget="image"]](% title="Click and drag to resize" %)​
920 +
921 +* (((
922 +(% style="color:#037691" %)**Downlink Command:**
923 +)))
924 +
925 +**~ (% style="color:#4472c4" %)A9 aa(%%)** ~-~-> Same as AT+MBFUN=aa
926 +
927 +
928 +==== (% style="color:blue" %)**RS485 command timeout**(%%) ====
929 +
930 +
477 477  (((
478 -Through AT+COMMANDx and AT+DATACUTx we got valid value from each RS485 commands, Assume these valid value are RETURN1, RETURN2, .., to RETURNx. The next step is how to compose the LoRa Uplink Payload by these RETURNs. The command is **AT+DATAUP.**
932 +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.
479 479  )))
480 480  
481 481  (((
482 -(% style="color:#4f81bd" %)**Examples: AT+DATAUP=0**
936 +Default value: 0, range:  0 ~~ 65 seconds
483 483  )))
484 484  
485 485  (((
486 -Compose the uplink payload with value returns in sequence and send with (% style="color:red" %)**A SIGNLE UPLINK**.
940 +* (% style="color:#037691" %)** AT Command:**
941 +
942 +(% style="color:#4472c4" %)** AT+CMDDLaa=hex(bb cc)*1000**
487 487  )))
488 488  
489 489  (((
490 -Final Payload is
946 +
947 +
948 +**Example:**
491 491  )))
492 492  
493 493  (((
494 -(% style="color:#4f81bd" %)**Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx**
952 +(% style="color:#4472c4" %)** AT+CMDDL1=1000** (%%)to send the open time to 1000ms
495 495  )))
496 496  
497 497  (((
498 -Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
956 +
499 499  )))
500 500  
501 -[[image:1653269759169-150.png||height="513" width="716"]]
959 +* (((
960 +(% style="color:#037691" %)** Downlink Payload:**
961 +)))
502 502  
503 -(% style="color:#4f81bd" %)**Examples: AT+DATAUP=1**
963 +(((
964 +(% style="color:#4472c4" %)** 0x AA aa bb cc**(%%) Same as: AT+CMDDLaa=hex (bb cc)
965 +)))
504 504  
505 -Compose the uplink payload with value returns in sequence and send with (% style="color:red" %)**Multiply UPLINKs**.
967 +(((
968 +
506 506  
507 -Final Payload is
970 +**Example:**
971 +)))
508 508  
509 -(% style="color:#4f81bd" %)**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
973 +(((
974 +**0xAA 01 03 E8**  ~-~-> Same as  **AT+CMDDL1=1000 ms**
975 +)))
510 510  
511 -1. Battery Info (2 bytes): Battery voltage
512 -1. PAYVER (1 byte): Defined by AT+PAYVER
513 -1. PAYLOAD COUNT (1 byte): Total how many uplinks of this sampling.
514 -1. PAYLOAD# (1 byte): Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
515 -1. DATA: Valid value: max 6 bytes(US915 version here, Notice*!) for each uplink so each uplink <= 11 bytes. For the last uplink, DATA will might less than 6 bytes
516 516  
517 -[[image:1653269916228-732.png||height="433" width="711"]]
518 518  
979 +==== (% style="color:blue" %)**Uplink payload mode**(%%) ====
519 519  
520 -So totally there will be 3 uplinks for this sampling, each uplink includes 6 bytes DATA
521 521  
522 -DATA1=RETURN1 Valid Value = (% style="background-color:green; color:white" %)20 20 0a 33 90 41
982 +(((
983 +Define to use one uplink or multiple uplinks for the sampling.
984 +)))
523 523  
524 -DATA2=1^^st^^ ~~ 6^^th^^ byte of Valid value of RETURN10=(% style="background-color:green; color:white" %) 02 aa 05 81 0a 20
986 +(((
987 +The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
525 525  
526 -DATA3=7^^th^^ ~~ 11^^th^^ bytes of Valid value of RETURN10 = (% style="background-color:green; color:white" %)20 20 20 2d 30
989 +
990 +)))
527 527  
528 -Below are the uplink payloads:
992 +(((
993 +* (% style="color:#037691" %)** AT Command:**
529 529  
530 -[[image:1653270130359-810.png]]
995 +(% style="color:#4472c4" %)** AT+DATAUP=0**
531 531  
997 +(% style="color:#4472c4" %)** AT+DATAUP=1**
532 532  
533 -(% style="color:red" %)**Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:**
999 +
1000 +)))
534 534  
535 - ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
1002 +(% style="color:#4472c4" %)** 0xAD 01 00 00 14** (%%) **~-~->** Same as AT+DATAUP=1,20000  ~/~/  (00 00 14 is 20 seconds)
536 536  
537 - * For AU915/AS923 bands, if UplinkDwell time=1, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
1004 +Each uplink is sent to the server at 20-second intervals when segmented.
538 538  
539 - * For US915 band, max 11 bytes for each uplink ( so 11 -5 = 6 max valid date).
540 540  
541 - ~* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
1007 +* (((
1008 +(% style="color:#037691" %)** Downlink Payload:**
1009 +)))
542 542  
543 -=== 3.3.5 Uplink on demand ===
1011 +(% style="color:#4472c4" %)** 0xAD 00** (%%) **~-~->** Same as AT+DATAUP=0
544 544  
545 -Except uplink periodically, RS485-BL is able to uplink on demand. The server sends downlink command to RS485-BL and RS485 will uplink data base on the command.
1013 +(% style="color:#4472c4" %)** 0xAD 01**  (%%) **~-~->** Same as AT+DATAUP=1  ~/~/Each uplink is sent to the server one after the other as it is segmented.
546 546  
547 -Downlink control command:
548 548  
549 -[[0x08 command>>path:#downlink_08]]: Poll an uplink with current command set in RS485-BL.
1016 +(Since firmware v1.4.0)
550 550  
551 -[[0xA8 command>>path:#downlink_A8]]: Send a command to RS485-BL and uplink the output from sensors.
1018 +* (((
1019 +(% style="color:#037691" %)** AT Command:**
1020 +)))
552 552  
1022 +(% style="color:#4472c4" %)** AT+DATAUP=1,Timeout**
553 553  
554 554  
555 -1.
556 -11.
557 -111. Uplink on Interrupt
1025 +* (((
1026 +(% style="color:#037691" %)** Downlink Payload:**
1027 +)))
558 558  
559 -Put the interrupt sensor between 3.3v_out and GPIO ext.[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]]
1029 +(% style="color:#4472c4" %)** 0xAD 01 00 00 14** (%%) **~-~->** Same as AT+DATAUP=1,20000  ~/~/  (00 00 14 is 20 seconds)
560 560  
561 -AT+INTMOD=0  Disable Interrupt
1031 +Each uplink is sent to the server at 20-second intervals when segmented.
562 562  
563 -AT+INTMOD=1  Interrupt trigger by rising or falling edge.
564 564  
565 -AT+INTMOD= Interrupt trigger by falling edge. ( Default Value)
1034 +==== (% style="color:blue" %)**Cut data separation processing(Since Version 1.4.2)**(%%) ====
566 566  
567 -AT+INTMOD=3  Interrupt trigger by rising edge.
568 568  
1037 +AT+NEWLINE command, which only takes effect when AT+DATAUP=1 or AT+DATAUP=1, timeout.
569 569  
570 -1.
571 -11. Uplink Payload
1039 +When not set, each part of AT+DATAUP is sent according to the maximum number of bytes of DR.
572 572  
573 -|**Size(bytes)**|**2**|**1**|**Length depends on the return from the commands**
574 -|Value|(((
575 -Battery(mV)
1041 +When setting, each part of AT+DATAUP is sent according to the value set by AT+NEWLINE.
576 576  
577 -&
578 578  
579 -Interrupt _Flag
580 -)))|(((
581 -PAYLOAD_VER
1044 +* (((
1045 +(% style="color:#037691" %)** AT Command:**
1046 +)))
582 582  
583 -
584 -)))|If the valid payload is too long and exceed the maximum support payload length in server, server will show payload not provided in the LoRaWAN server.
1048 +(% style="color:#4472c4" %)//**AT+NEWLINE=ALL**//(%%)//   //The data cut out by each AT+COMMANDx command is sent separately as an uplink.
585 585  
586 -Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
1050 +(% style="color:#4472c4" %)//**AT+NEWLINE=ALL**//(%%)//   equal:  (% style="color:#4472c4" %)**AT+NEWLINE=1+2+3+4+5+6+7+8+9+10+11+12+13+14+15**//
587 587  
588 588  
589 -function Decoder(bytes, port) {
1053 +(% style="color:#4472c4" %)//**AT+NEWLINE=a+b+c**//(%%)//  //The data returned by all commands is divided into three parts, COMMAND(1~~a) is the first part, COMMAND(a+1~~b) is the second part,COMMAND(b+1~~c) is the third part.
590 590  
591 -~/~/Payload Formats of RS485-BL Deceive
592 592  
593 -return {
1056 +(% style="color:#4472c4" %)//**AT+NEWLINE=NULL**//(%%)//  //Turn off the functionality of this AT command.
594 594  
595 - ~/~/Battery,units:V
596 596  
597 - BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,
1059 +* (((
1060 +(% style="color:#037691" %)** Downlink Payload:**
1061 +)))
598 598  
599 - ~/~/GPIO_EXTI 
1063 +//AT+NEWLINE=ALL  ~-~-->  (% style="color:#4472c4" %)**0xAC 01**//
600 600  
601 - EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",
1065 +// AT+NEWLINE= NULL  ~-~-->  (% style="color:#4472c4" %)**0xAC 00**//
602 602  
603 - ~/~/payload of version
1067 +//AT+NEWLINE= a+b+c   ~-~-->  (% style="color:#4472c4" %)**0xAC number of bytes a b c**//
604 604  
605 - Pay_ver:bytes[2],
1069 +//AT+NEWLINE= 1+5+15 ~-~-->  (% style="color:#4472c4" %)**0xAC 03 01 05 0F**//
606 606  
607 - };
608 608  
609 - }
1072 +==== (% style="color:blue" %)**Manually trigger an Uplink**(%%) ====
610 610  
611 611  
1075 +(((
1076 +Ask device to send an uplink immediately.
1077 +)))
612 612  
1079 +* (((
1080 +(% style="color:#037691" %)** AT Command:**
1081 +)))
613 613  
1083 +(((
1084 +No AT Command for this, user can press the [[ACT button>>||anchor="H3.7Buttons"]] for 1 second for the same.
1085 +)))
614 614  
1087 +(((
1088 +
1089 +)))
615 615  
1091 +* (((
1092 +(% style="color:#037691" %)** Downlink Payload:**
1093 +)))
616 616  
617 -TTN V3 uplink screen shot.
1095 +(((
1096 +(% style="color:#4472c4" %)** 0x08 FF**(%%), RS485-LN will immediately send an uplink.
1097 +)))
618 618  
619 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
620 620  
621 -1.
622 -11. Configure RS485-BL via AT or Downlink
623 623  
624 -User can configure RS485-BL via [[AT Commands >>path:#_​Using_the_AT]]or LoRaWAN Downlink Commands
1101 +==== (% style="color:blue" %)**Clear RS485 Command**(%%) ====
625 625  
626 -There are two kinds of Commands:
627 627  
628 -* **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
1104 +(((
1105 +The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
629 629  
630 -* **Sensor Related Commands**: These commands are special designed for RS485-BL.  User can see these commands below:
1107 +
1108 +)))
631 631  
632 -1.
633 -11.
634 -111. Common Commands:
1110 +* (((
1111 +(% style="color:#037691" %)** AT Command:**
1112 +)))
635 635  
636 -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]]
1114 +(((
1115 +(% style="color:#4472c4" %)** AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase
1116 +)))
637 637  
1118 +(((
1119 +
638 638  
639 -1.
640 -11.
641 -111. Sensor related commands:
1121 +Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
1122 +)))
642 642  
643 -==== Choose Device Type (RS485 or TTL) ====
1124 +(((
1125 +Example screen shot after clear all RS485 commands. 
1126 +)))
644 644  
645 -RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
1128 +(((
1129 +
1130 +)))
646 646  
647 -* AT Command
1132 +(((
1133 +The uplink screen shot is:
1134 +)))
648 648  
649 -**AT+MOD=1** ~/~/ Set to support RS485-MODBUS type sensors. User can connect multiply RS485 , Modbus sensors to the A / B pins.
1136 +(% aria-label="1654160691922-496.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1654160691922-496.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
650 650  
651 -**AT+MOD=2** ~/~/ Set to support TTL Level sensors, User can connect one TTL Sensor to the TXD/RXD/GND pins.
652 652  
1139 +* (((
1140 +(% style="color:#037691" %)** Downlink Payload:**
1141 +)))
653 653  
654 -* Downlink Payload
1143 +(((
1144 +(% style="color:#4472c4" %)** 0x09 aa bb** (%%) same as AT+CMDEAR=aa,bb
1145 +)))
655 655  
656 -**0A aa**     à same as AT+MOD=aa
657 657  
658 658  
1149 +==== (% style="color:blue" %)**Set Serial Communication Parameters**(%%) ====
659 659  
660 -==== [[RS485 Debug Command>>path:#downlink_A8]] (AT+CFGDEV) ====
661 661  
662 -This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
1152 +(((
1153 +Set the Rs485 serial communication parameters:
1154 +)))
663 663  
664 -* AT Command
1156 +(((
1157 +(% style="color:#037691" %)**AT Command:**
1158 +)))
665 665  
666 -AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
1160 +(((
1161 +* Set Baud Rate
1162 +)))
667 667  
668 -m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
1164 +(% style="color:#4472c4" %)** AT+BAUDR=9600** (%%) ~/~/  Options: (200~~115200)  When using low baud rate or receiving multiple bytes, you need to use AT+CMDDL to increase the receive timeout (the default receive timeout is 400ms), otherwise data will be lost
669 669  
670 670  
1167 +(((
1168 +* Set UART Parity
1169 +)))
671 671  
672 -* Downlink Payload
1171 +(% style="color:#4472c4" %)** AT+PARITY=0** (%%) ~/~/  Option: 0: no parity, 1: odd parity, 2: even parity
673 673  
674 -Format: A8 MM NN XX XX XX XX YY
675 675  
676 -Where:
1174 +(((
1175 +* Set STOPBIT
1176 +)))
677 677  
678 -* MM: 1: add CRC-16/MODBUS ; 0: no CRC
679 -* NN: The length of RS485 command
680 -* XX XX XX XX: RS485 command total NN bytes
681 -* YY: How many bytes will be uplink from the return of this RS485 command, if YY=0, RS485-BL will execute the downlink command without uplink; if YY>0, RS485-BL will uplink total YY bytes from the output of this RS485 command
1178 +(% style="color:#4472c4" %)** AT+STOPBIT=0** (%%) ~/~/  Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
682 682  
683 -**Example 1:**
684 684  
685 -To connect a Modbus Alarm with below commands.
1181 +(((
1182 +(% style="color:#037691" %)**Downlink Payload:**
1183 +)))
686 686  
687 -* 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.
1185 +(((
1186 +(% style="color:#4472c4" %)** A7 01 aa bb**:   (%%) Same  AT+BAUDR=hex(aa bb)*100
1187 +)))
688 688  
689 -* 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.
1189 +(((
1190 +**Example:**
1191 +)))
690 690  
691 -So if user want to use downlink command to control to RS485 Alarm, he can use:
1193 +* (((
1194 +A7 01 00 60  same as AT+BAUDR=9600
1195 +)))
1196 +* (((
1197 +A7 01 04 80  same as AT+BAUDR=115200
1198 +)))
692 692  
693 -**A8 01 06 0A 05 00 04 00 01 00**: to activate the RS485 Alarm
1200 +(((
1201 +* A7 02 aa:  Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
1202 +)))
694 694  
695 -**A8 01 06 0A 05 00 04 00 00 00**: to deactivate the RS485 Alarm
1204 +(((
1205 +* A7 03 aa:  Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1206 +)))
696 696  
697 -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.
698 698  
699 699  
700 -**Example 2:**
701 701  
702 -Check TTL Sensor return:
1211 +==== (% style="color:blue" %)**Configure Databit (Since Version 1.4.0)**(%%) ====
703 703  
704 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]]
705 705  
1214 +* (((
1215 +(% style="color:#037691" %)** AT Command:**
1216 +)))
706 706  
1218 +(% style="color:#4472c4" %)** AT+DATABIT=7    **(%%)~/~/ Set the data bits to 7
707 707  
1220 +(% style="color:#4472c4" %)** AT+DATABIT=8    **(%%)~/~/ Set the data bits to 8
708 708  
709 -==== Set Payload version ====
1222 +* (((
1223 +(% style="color:#037691" %)**Downlink Payload:**
1224 +)))
710 710  
711 -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.
1226 +(% style="color:#4472c4" %)** A7 04 07**(%%): Same as  AT+DATABIT=7
712 712  
713 -* AT Command:
1228 +(% style="color:#4472c4" %)** A7 04 08**(%%): Same as  AT+DATABIT=8
714 714  
715 -AT+PAYVER: Set PAYVER field = 1
716 716  
717 717  
718 -* Downlink Payload:
1232 +==== (% style="color:blue" %)**Encrypted payload(Since Version 1.4.0)**(%%) ====
719 719  
720 -0xAE 01   à Set PAYVER field =  0x01
1234 +(((
1235 +
1236 +)))
721 721  
722 -0xAE 0F   à Set PAYVER field =  0x0F
1238 +* (((
1239 +(% style="color:#037691" %)** AT Command:**
1240 +)))
723 723  
1242 +(% style="color:#4472c4" %)** AT+DECRYPT=1  ** (%%) ~/~/ The payload is uploaded without encryption
724 724  
725 -==== Set RS485 Sampling Commands ====
1244 +(% style="color:#4472c4" %)** AT+DECRYPT= ** (%%) ~/~/ Encrypt when uploading payload (default)
726 726  
727 -AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
728 728  
729 -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]].
730 730  
1248 +==== (% style="color:blue" %)**Get sensor value(Since Version 1.4.0)**(%%) ====
731 731  
732 -* AT Command:
733 733  
734 -AT+COMMANDx: Configure RS485 read command to sensor.
1251 +* (((
1252 +(% style="color:#037691" %)** AT Command:**
1253 +)))
735 735  
736 -AT+DATACUTx: Configure how to handle return from RS485 devices.
1255 +(% style="color:#4472c4" %)** AT+GETSENSORVALUE=0  **(%%) ~/~/ The serial port gets the reading of the current sensor
737 737  
738 -AT+SEARCHx: Configure search command
1257 +(% style="color:#4472c4" %)** AT+GETSENSORVALUE=1  **(%%) ~/~/ The serial port gets the current sensor reading and uploads it.
739 739  
740 740  
741 -* Downlink Payload:
742 742  
743 -0xAF downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
1261 +==== (% style="color:blue" %)**Resets the downlink packet count(Since Version 1.4.0)**(%%) ====
744 744  
745 -Note: if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
746 746  
747 -Format: AF MM NN LL XX XX XX XX YY
1264 +* (((
1265 +(% style="color:#037691" %)** AT Command:**
1266 +)))
748 748  
749 -Where:
1268 +(% style="color:#4472c4" %)** AT+DISFCNTCHECK=0  **(%%) ~/~/  When the downlink packet count sent by the server is less than the node downlink packet count or exceeds 16384, the node will no longer receive downlink packets (default)
750 750  
751 -* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
752 -* NN: 0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
753 -* LL: The length of AT+COMMAND or AT+DATACUT command
754 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command
755 -* 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.
1270 +(% style="color:#4472c4" %)** AT+DISFCNTCHECK=1  **(%%) ~/~/  When the downlink packet count sent by the server is less than the node downlink packet count or exceeds 16384, the node resets the downlink packet count and keeps it consistent with the server downlink packet count.
756 756  
757 -Example:
758 758  
759 -**AF 03 01 06 0A 05 00 04 00 01 00**: Same as AT+COMMAND3=0A 05 00 04 00 01,1
760 760  
761 -**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10**
1274 +==== (% style="color:blue" %)**When the limit bytes are exceeded, upload in batches(Since Version 1.4.0)**(%%) ====
762 762  
763 -**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~10**
764 764  
1277 +* (((
1278 +(% style="color:#037691" %)** AT Command:**
1279 +)))
765 765  
766 -0xAB downlink command can be used for set AT+SEARCHx
1281 + (% style="color:#4472c4" %)** AT+DISMACANS=0**  (%%) ~/~/  When the MACANS of the reply server plus the payload exceeds the maximum number of bytes of 11 bytes (DR0 of US915, DR2 of AS923, DR2 of AU195), the node will send a packet with a payload of 00 and a port of 4. (default)
767 767  
768 -Example: **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
1283 + (% style="color:#4472c4" %)** AT+DISMACANS=1**   (%%) ~/~/  When the MACANS of the reply server plus the payload exceeds the maximum number of bytes of the DR, the node will ignore the MACANS and not reply, and only upload the payload part.
769 769  
770 -* AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
771 -* 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
772 772  
773 -**AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
1286 +* (((
1287 +(% style="color:#037691" %)** Downlink Payload:**
1288 +)))
774 774  
1290 +(% style="color:#4472c4" %)** 0x21 00 01 ** (%%) ~/~/ Set  the DISMACANS=1
775 775  
776 -==== Fast command to handle MODBUS device ====
777 777  
778 -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]].
779 779  
780 -This command is valid since v1.3 firmware version
1294 +==== (% style="color:blue" %)**Copy downlink to uplink (Since Version 1.4.0)**(%%) ====
781 781  
782 782  
783 -AT+MBFUN has only two value:
1297 +* (((
1298 +(% style="color:#037691" %)** AT Command:**
1299 +)))
784 784  
785 -* AT+MBFUN=1: Enable Modbus reading. And get response base on the MODBUS return
1301 +(% style="color:#4472c4" %)** AT+RPL=5**  (%%) ~/~/ After receiving the package from the server, it will immediately upload the content of the package to the server, the port number is 100.
786 786  
787 -AT+MBFUN=1, device 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.
1303 +Example:**aa xx xx xx xx**         ~/~/ aa indicates whether the configuration has changed, 00 is yes, 01 is no; xx xx xx xx are the bytes sent.
788 788  
789 -* AT+MBFUN=0: Disable Modbus fast reading.
790 790  
791 -Example:
1306 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/image-20220823173747-6.png?width=1124&height=165&rev=1.1||alt="image-20220823173747-6.png"]]
792 792  
793 -* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
794 -* 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.
795 -* 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.
1308 +For example, sending 11 22 33 44 55 66 77 will return invalid configuration 00 11 22 33 44 55 66 77.
796 796  
797 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
798 798  
799 799  
800 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
1312 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/image-20220823173833-7.png?width=1124&height=149&rev=1.1||alt="image-20220823173833-7.png"]]
801 801  
1314 +For example, if 01 00 02 58 is issued, a valid configuration of 01 01 00 02 58 will be returned.
802 802  
803 -* Downlink Commands:
804 804  
805 -A9 aa -à Same as AT+MBFUN=aa
806 806  
1318 +==== (% style="color:blue" %)**Query version number and frequency band 、TDC(Since Version 1.4.0)**(%%) ====
807 807  
808 -==== RS485 command timeout ====
809 809  
810 -Some Modbus device has slow action to send replies. This command is used to configure the RS485-BL to use longer time to wait for their action.
1321 +(((
1322 +* (% style="color:#037691" %)**Downlink Payload:**
811 811  
812 -Default value: 0, range:  0 ~~ 5 seconds
1324 +(% style="color:#4472c4" %)** 26 01  ** (%%) ~/~/  Downlink 26 01 can query device upload frequency, frequency band, software version number, TDC time.
1325 +)))
813 813  
814 814  
815 -* AT Command:
1328 +Example:
816 816  
817 -AT+CMDDLaa=hex(bb cc)
818 818  
819 -Example:
1331 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50%20%26%20LSN50-V2%20-%20LoRaWAN%20Sensor%20Node%20User%20Manual/WebHome/image-20220823173929-8.png?width=1205&height=76&rev=1.1||alt="image-20220823173929-8.png"]]
820 820  
821 -**AT+CMDDL1=1000** to send the open time to 1000ms
822 822  
823 823  
824 -* Downlink Payload:
1335 +==== (% style="color:blue" %)** Monitor RS485 communication of other devices(Since Version 1.4.0)**(%%) ====
825 825  
826 -0x AA aa bb cc
827 827  
828 -Same as: AT+CMDDLaa=hex(bb cc)
1338 +* (((
1339 +(% style="color:#037691" %)** AT Command:**
1340 +)))
829 829  
830 - Example:
1342 +(% style="color:#4472c4" %)**AT+RXMODE=1,10**    (%%) ~/~/ When the RS485-LN receives more than 10 bytes from the RS485, it immediately sends the uplink of the received data.
831 831  
832 - 0xAA 01 03 E8  à Same as **AT+CMDDL1=1000 ms**
1344 +(% style="color:#4472c4" %)**AT+RXMODE=2,500    ** (%%) ~/~/  RS485-LN uploads data as uplink from the first byte received by RS485 to the data received within 500ms after that.
833 833  
1346 +(% style="color:#4472c4" %)**AT+RXMODE=0,0  ** (%%) ~/~/  Disable this mode (default)
834 834  
835 -==== [[Uplink>>path:#downlink_A8]] payload mode ====
836 836  
837 -Define to use one uplink or multiple uplinks for the sampling.
1349 +* (((
1350 +(% style="color:#037691" %)**Downlink Payload:**
1351 +)))
838 838  
839 -The use of this command please see: [[Compose Uplink payload>>path:#DataUP]]
1353 +(% style="color:#4472c4" %)** A6 aa bb bb               ** (%%) ~/~/ same as AT+RXMODE=aa,bb
840 840  
841 -* AT Command:
1355 +[[image:image-20220824144240-1.png]]
842 842  
843 -AT+DATAUP=0
844 844  
845 -AT+DATAUP=1
1358 +== 3.6 Listening mode for RS485 network ==
846 846  
847 847  
848 -* Downlink Payload:
1361 +(((
1362 +This feature support since firmware v1.4
1363 +)))
849 849  
850 -0xAD 00   à Same as AT+DATAUP=0
1365 +(((
1366 +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.
851 851  
852 -0xAD 01   à Same as AT+DATAUP=1
1368 +
1369 +)))
853 853  
1371 +(% aria-label="image-20220602171200-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602171200-8.png||data-widget="image" height="567" width="1007"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]]
854 854  
855 -==== Manually trigger an Uplink ====
1373 +(% title="Click and drag to resize" %)​
856 856  
857 -Ask device to send an uplink immediately.
1375 +(((
1376 +To enable the listening mode, use can run the command (% style="color:#4472c4" %)** AT+RXMODE**.
1377 +)))
858 858  
859 -* Downlink Payload:
1379 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
1380 +|=(% style="width: 156px; background-color:#4F81BD;color:white" %)(((
1381 +**Command example**
1382 +)))|=(% style="width: 355px; background-color:#4F81BD;color:white" %)(((
1383 +**Function**
1384 +)))
1385 +|(% style="width:156px" %)(((
1386 +AT+RXMODE=1,10
1387 +)))|(% style="width:352px" %)(((
1388 +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.
1389 +)))
1390 +|(% style="width:156px" %)(((
1391 +AT+RXMODE=2,500
1392 +)))|(% style="width:352px" %)(((
1393 +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
1394 +)))
1395 +|(% style="width:156px" %)(((
1396 +AT+RXMODE=0,0
1397 +)))|(% style="width:352px" %)(((
1398 +Disable listening mode. This is the default settings.
1399 +)))
1400 +|(% style="width:156px" %)(((
1401 +
1402 +)))|(% style="width:352px" %)(((
1403 +A6 aa bb cc  same as AT+RXMODE=aa,(bb<<8 | cc)
1404 +)))
860 860  
861 -0x08 FF, RS485-BL will immediately send an uplink.
1406 +(((
1407 +
862 862  
1409 +(% style="color:#037691" %)**Downlink Command:**
1410 +)))
863 863  
864 -==== Clear RS485 Command ====
1412 +(((
1413 +(% style="color:#4472c4" %)** 0xA6 aa bb cc **(%%) same as AT+RXMODE=aa,(bb<<8 | cc)
1414 +)))
865 865  
866 -The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
1416 +(((
1417 +
1418 +)))
867 867  
1420 +(((
1421 +**Example**:
1422 +)))
868 868  
869 -* AT Command:
1424 +(((
1425 +The RS485-LN is set to AT+RXMODE=2,1000
1426 +)))
870 870  
871 -**AT+CMDEAR=mm,nn**   mm: start position of erase ,nn: stop position of erase
1428 +(((
1429 +There is a two Modbus commands in the RS485 network as below:
1430 +)))
872 872  
873 -Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
1432 +(((
1433 +The Modbus master send a command: (% style="background-color:#ffc000" %)**01 03 00 00 00 02 c4 0b**
1434 +)))
874 874  
875 -Example screen shot after clear all RS485 commands. 
1436 +(((
1437 +And Modbus slave reply with: (% style="background-color:green" %)**01 03 04 00 00 00 00 fa 33**
1438 +)))
876 876  
1440 +(((
1441 +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**
877 877  
1443 +
1444 +)))
878 878  
879 -The uplink screen shot is:
1446 +(((
1447 +(% aria-label="image-20220602171200-9.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602171200-9.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
1448 +)))
880 880  
881 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
882 882  
883 883  
884 -* Downlink Payload:
1452 +(((
1453 +(% 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.**
1454 +)))
885 885  
886 -0x09 aa bb same as AT+CMDEAR=aa,bb
887 887  
1457 +== 3.7 Buttons ==
888 888  
889 -==== Set Serial Communication Parameters ====
890 890  
891 -Set the Rs485 serial communication parameters:
1460 +(% border="1.5" cellspacing="4" style="background-color:#f2f2f2; width:430px" %)
1461 +|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**Button**|=(% style="width: 380px;background-color:#4F81BD;color:white" %)**Feature**
1462 +|(% style="width:50px" %)ACT|(% style="width:361px" %)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**
1463 +|(% style="width:50px" %)RST|(% style="width:361px" %)Reboot RS485
1464 +|(% style="width:50px" %)PRO|(% style="width:361px" %)Use for upload image, see [[How to Update Image>>||anchor="H6.1Howtoupgradetheimage3F"]]
892 892  
893 -* AT Command:
1466 +== 3.8 LEDs ==
894 894  
895 -Set Baud Rate:
896 896  
897 -AT+BAUDR=9600    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1469 +(% border="1.5" cellspacing="4" style="background-color:#f2f2f2; width:430px" %)
1470 +|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**LEDs**|=(% style="width: 380px;background-color:#4F81BD;color:white" %)**Feature**
1471 +|PWR|Always on if there is power
1472 +|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.
898 898  
1474 += 4. Case Study =
899 899  
900 -Set UART parity
901 901  
902 -AT+PARITY=0    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1477 +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]]
903 903  
904 904  
905 -Set STOPBIT
1480 += 5. Use AT Command =
906 906  
907 -AT+STOPBIT=0    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1482 +== 5.1 Access AT Command ==
908 908  
909 909  
910 -* Downlink Payload:
1485 +(((
1486 +RS485-LN supports AT Command set. User can use a USB to TTL adapter plus the 3.5mm Program Cable to connect to RS485-LN to use AT command, as below.
911 911  
912 -A7 01 aa bb: Same  AT+BAUDR=hex(aa bb)*100
1488 +
1489 +)))
913 913  
914 -Example:
1491 +(% aria-label="1654162355560-817.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1654162355560-817.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
915 915  
916 -* A7 01 00 60   same as AT+BAUDR=9600
917 -* A7 01 04 80  same as AT+BAUDR=115200
918 918  
919 -A7 02 aa: Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
920 920  
921 -A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1495 +(((
1496 +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-LN. The default password is 123456. Below is the output for reference:
922 922  
1498 +
1499 +)))
923 923  
924 -==== Control output power duration ====
1501 +(% aria-label="1654162368066-342.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1654162368066-342.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
925 925  
926 -User can set the output power duration before each sampling.
927 927  
928 -* AT Command:
1504 +(((
1505 +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/]]
1506 +)))
929 929  
930 -Example:
931 931  
932 -AT+3V3T=1000 ~/~/ 3V3 output power will open 1s before each sampling.
1509 +== 5.2 Common AT Command Sequence ==
933 933  
934 -AT+5VT=1000 ~/~/ +5V output power will open 1s before each sampling.
1511 +=== 5.2.1 Multi-channel ABP mode (Use with SX1301/LG308) ===
935 935  
936 936  
937 -* LoRaWAN Downlink Command:
1514 +If device has not joined network yet:
938 938  
939 -07 01 aa bb  Same as AT+5VT=(aa bb)
1516 +* (% style="color:#037691" %)**AT+FDR**
1517 +* (% style="color:#037691" %)**AT+NJM=0**
1518 +* (% style="color:#037691" %)**ATZ**
940 940  
941 -07 02 aa bb  Same as AT+3V3T=(aa bb)
1520 +(((
1521 +
942 942  
1523 +If device already joined network:
943 943  
1525 +* (% style="color:#037691" %)**AT+NJM=0**
1526 +* (% style="color:#037691" %)**ATZ**
1527 +)))
944 944  
945 945  
946 -1.
947 -11. Buttons
948 948  
949 -|**Button**|**Feature**
950 -|**RST**|Reboot RS485-BL
1531 +=== 5.5.2 Single-channel ABP mode (Use with LG01/LG02) ===
951 951  
952 -1.
953 -11. +3V3 Output
954 954  
955 -RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
1534 +(% style="background-color:#dcdcdc" %)**AT+FDR** (%%) Reset Parameters to Factory Default, Keys Reserve
956 956  
957 -The +3V3 output will be valid for every sampling. RS485-BL will enable +3V3 output before all sampling and disable the +3V3 after all sampling. 
1536 +(% style="background-color:#dcdcdc" %)**AT+NJM=0 **(%%) Set to ABP mode
958 958  
1538 +(% style="background-color:#dcdcdc" %)**AT+ADR=0** (%%) Set the Adaptive Data Rate Off
959 959  
960 -The +3V3 output time can be controlled by AT Command.
1540 +(% style="background-color:#dcdcdc" %)**AT+DR=5**   (%%) Set Data Rate
961 961  
962 -**AT+3V3T=1000**
1542 +(% style="background-color:#dcdcdc" %)**AT+TDC=60000** (%%) Set transmit interval to 60 seconds
963 963  
964 -Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors.
1544 +(% style="background-color:#dcdcdc" %)**AT+CHS=868400000**(%%)  Set transmit frequency to 868.4Mhz
965 965  
1546 +(% style="background-color:#dcdcdc" %)**AT+RX2FQ=868400000** (%%) Set RX2Frequency to 868.4Mhz (according to the result from server)
966 966  
967 -By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1548 +(% style="background-color:#dcdcdc" %)**AT+RX2DR=5**  (%%) Set RX2DR to match the downlink DR from server. see below
968 968  
1550 +(% style="background-color:#dcdcdc" %)**AT+DADDR=26** (%%) 01 1A F1 Set Device Address to 26 01 1A F1, this ID can be found in the LoRa Server portal.
969 969  
970 -1.
971 -11. +5V Output
1552 +(% style="background-color:#dcdcdc" %)**ATZ**       (%%) Reset MCU
972 972  
973 -RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
974 974  
975 -The +5V output will be valid for every sampling. RS485-BL will enable +5V output before all sampling and disable the +5v after all sampling. 
1555 +(% style="color:red" %)**Note:**
976 976  
1557 +(((
1558 +(% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server.
1559 +2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
1560 +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.
1561 +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
977 977  
978 -The 5V output time can be controlled by AT Command.
1563 +
1564 +)))
979 979  
980 -**AT+5VT=1000**
1566 +(% aria-label="1654162478620-421.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1654162478620-421.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
981 981  
982 -Means set 5V valid time to have 1000ms. So, the real 5V output will actually have 1000ms + sampling time for other sensors.
983 983  
1569 += 6. FAQ =
984 984  
985 -By default, the AT+5VT=0. If the external sensor which require 5v and require more time to get stable state, user can use this command to increase the power ON duration for this sensor.
1571 +== 6.1 How to upgrade the image? ==
986 986  
987 987  
1574 +(((
1575 +The RS485-LN LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-LN to:
1576 +)))
988 988  
1578 +* (((
1579 +Support new features
1580 +)))
1581 +* (((
1582 +For bug fix
1583 +)))
1584 +* (((
1585 +Change LoRaWAN bands.
1586 +)))
989 989  
990 -1.
991 -11. LEDs
1588 +(((
1589 +Below shows the hardware connection for how to upload an image to RS485-LN:
1590 +)))
992 992  
993 -|**LEDs**|**Feature**
994 -|**LED1**|Blink when device transmit a packet.
1592 +(% aria-label="1654162535040-878.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1654162535040-878.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]]
995 995  
996 -1.
997 -11. Switch Jumper
1594 +(% title="Click and drag to resize" %)​
998 998  
999 -|**Switch Jumper**|**Feature**
1000 -|**SW1**|(((
1001 -ISP position: Upgrade firmware via UART
1596 +(((
1597 +(% style="color:blue" %)**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]].
1002 1002  
1003 -Flash position: Configure device, check running status.
1599 +
1004 1004  )))
1005 -|**SW2**|(((
1006 -5V position: set to compatible with 5v I/O.
1007 1007  
1008 -3.3v position: set to compatible with 3.3v I/O.,
1602 +(((
1603 +(% style="color:blue" %)**Step2**(%%)**:** Download the [[LT Image files>>url:https://www.dropbox.com/sh/g99v0fxcltn9r1y/AACP33wo_ZQLsxW2MJ70oUoba/RS485-LN/Firmware?dl=0&subfolder_nav_tracking=1]].
1604 +
1605 +
1009 1009  )))
1010 1010  
1011 -+3.3V: is always ON
1608 +(((
1609 +(% style="color:blue" %)**Step3**(%%)**: **Open flashloader; choose the correct COM port to update.
1012 1012  
1013 -+5V: Only open before every sampling. The time is by default, it is AT+5VT=0.  Max open time. 5000 ms.
1611 +
1612 +)))
1014 1014  
1015 -1. Case Study
1614 +(((
1615 +(((
1616 +(((
1617 +(% 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.
1618 +)))
1619 +)))
1620 +)))
1016 1016  
1017 -User can check this URL for some case studies.
1018 1018  
1019 -[[http:~~/~~/wiki.dragino.com/index.php?title=APP_RS485_COMMUNICATE_WITH_SENSORS>>url:http://wiki.dragino.com/index.php?title=APP_RS485_COMMUNICATE_WITH_SENSORS]]
1623 +(% aria-label="image-20220602175818-12.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602175818-12.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
1020 1020  
1021 1021  
1626 +(% aria-label="image-20220602175848-13.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602175848-13.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
1022 1022  
1023 1023  
1024 -1. Use AT Command
1025 -11. Access AT Command
1629 +(% aria-label="image-20220602175912-14.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602175912-14.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
1026 1026  
1027 -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.
1028 1028  
1029 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image027.png]]
1030 1030  
1633 +(% style="color:red" %)**Users can select the new burning software STM32Cubeprogramer for firmware upgrade and follow the same connection steps to enter burning mode (until SYS LED is RED ON):**
1031 1031  
1032 -In PC, User needs to set **serial tool**(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to **9600** to access to access serial console of RS485-BL. The default password is 123456. Below is the output for reference:
1635 +[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H4.2.FirmwareupgradeusingSTM32Cubeprogramer>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H4.2.FirmwareupgradeusingSTM32Cubeprogramer]]
1033 1033  
1034 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image028.png]]
1035 1035  
1638 +(% style="color:red" %)**Notice**: **In case user has lost the program cable. User can hand made one from a 3.5mm cable. The pin mapping is:**
1036 1036  
1640 +(% aria-label="image-20220602175638-10.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602175638-10.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
1037 1037  
1038 -More detail AT Command manual can be found at [[AT Command Manual>>path:#AT_COMMAND]]
1039 1039  
1643 +== 6.2 How to change the LoRa Frequency Bands/Region? ==
1040 1040  
1041 1041  
1042 -1.
1043 -11. Common AT Command Sequence
1044 -111. Multi-channel ABP mode (Use with SX1301/LG308)
1646 +User can follow the introduction for [[how to upgrade image>>||anchor="H6.1Howtoupgradetheimage3F"]]. When download the images, choose the required image file for download.
1045 1045  
1046 -If device has not joined network yet:
1047 1047  
1048 -AT+FDR
1649 +== 6.3 How many RS485-Slave can RS485-LN connects? ==
1049 1049  
1050 -AT+NJM=0
1051 1051  
1052 -ATZ
1652 +The RS485-LN can support max 32 RS485 devices. Each uplink command of RS485-LN can support max 16 different RS485 command. So RS485-LN 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>>||anchor="H3.3.3Configurereadcommandsforeachsampling"]].
1053 1053  
1054 1054  
1055 -If device already joined network:
1655 +== 6.4 Compatible question to ChirpStack and TTI LoRaWAN server ? ==
1056 1056  
1057 -AT+NJM=0
1058 1058  
1059 -ATZ
1658 +When user need to use with ChirpStack or TTI. Please set AT+RPL=4.
1060 1060  
1061 -1.
1062 -11.
1063 -111. Single-channel ABP mode (Use with LG01/LG02)
1660 +Detail info check this link: [[Set Packet Receiving Response Level>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H7.23SetPacketReceivingResponseLevel"]]
1064 1064  
1065 -AT+FDR   Reset Parameters to Factory Default, Keys Reserve
1066 1066  
1067 -AT+NJM=0 Set to ABP mode
1663 +== 6.5 Can i use point to point communication for RS485-LN? ==
1068 1068  
1069 -AT+ADR=0 Set the Adaptive Data Rate Off
1070 1070  
1071 -AT+DR=5  Set Data Rate
1666 +Yes, please updating point-to-point [[firmware>>https://www.dropbox.com/sh/g99v0fxcltn9r1y/AACP33wo_ZQLsxW2MJ70oUoba/RS485-LN/Firmware?dl=0&subfolder_nav_tracking=1]],then refer [[Point to Point Communication for RS485-LN>>Point to Point Communication for RS485-LN]].
1072 1072  
1073 -AT+TDC=60000  Set transmit interval to 60 seconds
1074 1074  
1075 -AT+CHS=868400000 Set transmit frequency to 868.4Mhz
1669 +== 6.6 How to Use RS485-LN  to connect to RS232 devices? ==
1076 1076  
1077 -AT+RX2FQ=868400000 Set RX2Frequency to 868.4Mhz (according to the result from server)
1078 1078  
1079 -AT+RX2DR=5  Set RX2DR to match the downlink DR from server. see below
1672 +[[Use RS485-BL or RS485-LN to connect to RS232 devices. - DRAGINO>>url:http://8.211.40.43:8080/xwiki/bin/view/Main/RS485%20to%20RS232/]]
1080 1080  
1081 -AT+DADDR=26 01 1A F1 Set Device Address to 26 01 1A F1, this ID can be found in the LoRa Server portal.
1082 1082  
1083 -ATZ          Reset MCU
1675 +== 6.7 How to judge whether there is a problem with the set COMMAND ==
1084 1084  
1085 -**Note:**
1677 +=== 6.7.1 Introduce: ===
1086 1086  
1087 -1. Make sure the device is set to ABP mode in the IoT Server.
1088 -1. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
1089 -1. 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.
1090 -1. 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
1091 1091  
1092 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image029.png]]
1680 +Users can use below the structure to fast debug the communication between RS485BL and RS485-LN. The principle is to put the PC in the RS485 network and sniff the packet between Modbus MTU and RS485-BL/LN. We can use this way to:
1093 1093  
1682 +1. Test if Modbus-MTU works with PC commands.
1683 +1. Check if RS485-LN sent the expected command to Mobus-MTU
1684 +1. Check if Modbus-MTU return back the expected result to RS485-LN.
1685 +1. If both b) and c) has issue, we can compare PC’s output and RS485-LN output.
1094 1094  
1095 -1. FAQ
1096 -11. How to upgrade the image?
1687 +[[image:image-20240816112950-1.png||height="382" width="731"]]
1097 1097  
1098 -The RS485-BL LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-BL to:
1099 1099  
1100 -* Support new features
1101 -* For bug fix
1102 -* Change LoRaWAN bands.
1690 +Example Connection:
1103 1103  
1104 -Below shows the hardware connection for how to upload an image to RS485-BL:
1692 +[[image:image-20221130104310-2.png]]
1105 1105  
1106 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image030.png]]
1107 1107  
1108 -**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]].
1695 +=== 6.7.2 Set up PC to monitor RS485 network With Serial tool ===
1109 1109  
1110 -**Step2**: Download the [[LT Image files>>url:http://www.dragino.com/downloads/index.php?dir=LT_LoRa_IO_Controller/LT33222-L/image/]].
1111 1111  
1112 -**Step3: **Open flashloader; choose the correct COM port to update.
1698 +(% style="color:red" %)**Note: Receive and send set to hex mode**
1113 1113  
1700 +[[image:image-20221130104310-3.png||height="616" width="714"]]
1114 1114  
1115 -|(((
1116 -HOLD PRO then press the RST button, SYS will be ON, then click next
1117 -)))
1118 1118  
1119 -|(((
1120 -Board detected
1121 -)))
1703 +=== 6.7.3 With ModRSsim2: ===
1122 1122  
1123 -|(((
1124 -
1125 -)))
1126 1126  
1127 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image031.png]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image032.png]]
1706 +(% style="color:blue" %)**(1) Select serial port MODBUS RS-232**
1128 1128  
1708 +[[image:image-20221130104310-4.png||height="390" width="865"]]
1129 1129  
1130 1130  
1131 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image033.png]] [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image034.png]]
1711 +(% style="color:blue" %)**(2) Click the serial port icon**
1132 1132  
1713 +[[image:image-20221130104310-5.png||height="392" width="870"]]
1133 1133  
1134 -[[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]]
1135 1135  
1716 +(% style="color:blue" %)**(3) After selecting the correct serial port and baud rate, click ok**
1136 1136  
1137 -1.
1138 -11. How to change the LoRa Frequency Bands/Region?
1718 +[[image:image-20221130104310-6.png]]
1139 1139  
1140 -User can follow the introduction for [[how to upgrade image>>path:#upgrade_image]]. When download the images, choose the required image file for download.
1141 1141  
1721 +(% style="color:blue" %)**(4) Click the comms.**
1142 1142  
1723 +[[image:image-20221130104310-7.png||height="376" width="835"]]
1143 1143  
1144 -1.
1145 -11. How many RS485-Slave can RS485-BL connects?
1725 +(% class="wikigeneratedid" id="HRunRS485-LN2FBLcommandandmonitorifitiscorrect." %)
1726 +**Run RS485-LN/BL command and monitor if it is correct.**
1146 1146  
1147 -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]].
1148 1148  
1729 +=== 6.7.4 Example – Test the CFGDEV command ===
1149 1149  
1150 1150  
1732 +RS485-LN sent below command:
1151 1151  
1152 -1. Trouble Shooting     
1153 -11. Downlink doesn’t work, how to solve it?
1734 +(% style="color:blue" %)**AT+CFGDEV=01 03 00 20 00 01,1**(%%) to RS485 network, and PC is able to get this command and return commands from MTU to show in the serial tool.
1154 1154  
1155 -Please see this link for debug:
1156 1156  
1157 -[[http:~~/~~/wiki.dragino.com/index.php?title=Main_Page#LoRaWAN_Communication_Debug>>url:http://wiki.dragino.com/index.php?title=Main_Page#LoRaWAN_Communication_Debug]] 
1737 +We can see the output from the Serial port tool to analyze. And check if they are expected result.
1158 1158  
1739 +[[image:image-20221130104310-8.png||height="214" width="797"]]
1159 1159  
1160 1160  
1161 -1.
1162 -11. Why I can’t join TTN V3 in US915 /AU915 bands?
1742 +We can also use (% style="color:blue" %)**ModRSsim2**(%%) to see the output.
1163 1163  
1164 -It might about the channels mapping. Please see for detail.
1744 +[[image:image-20221130104310-9.png||height="531" width="729"]]
1165 1165  
1166 -[[http:~~/~~/wiki.dragino.com/index.php?title=LoRaWAN_Communication_Debug#Notice_of_US915.2FCN470.2FAU915_Frequency_band>>url:http://wiki.dragino.com/index.php?title=LoRaWAN_Communication_Debug#Notice_of_US915.2FCN470.2FAU915_Frequency_band]]
1167 1167  
1747 +=== 6.7.5 Example – Test CMD command sets. ===
1168 1168  
1169 1169  
1170 -1. Order Info
1750 +Run (% style="color:blue" %)**AT+SENSORVALUE=1**(%%) to test the CMD commands set in RS485-LN.
1171 1171  
1172 -**Part Number: RS485-BL-XXX**
1173 1173  
1174 -**XXX:**
1753 +(% style="color:blue" %)**Serial port tool:**
1175 1175  
1176 -* **EU433**: frequency bands EU433
1177 -* **EU868**: frequency bands EU868
1178 -* **KR920**: frequency bands KR920
1179 -* **CN470**: frequency bands CN470
1180 -* **AS923**: frequency bands AS923
1181 -* **AU915**: frequency bands AU915
1182 -* **US915**: frequency bands US915
1183 -* **IN865**: frequency bands IN865
1184 -* **RU864**: frequency bands RU864
1185 -* **KZ865: **frequency bands KZ865
1755 +[[image:image-20221130104310-10.png||height="339" width="844"]]
1186 1186  
1187 -1. Packing Info
1188 1188  
1758 +(% style="color:blue" %)**ModRSsim2:**
1759 +
1760 +[[image:image-20221130104310-11.png||height="281" width="962"]]
1761 +
1762 +
1763 +=== 6.7.6 Test with PC ===
1764 +
1765 +
1766 +If there is still have problem to set up correctly the commands between RS485-LN and MTU. User can test the correct RS485 command set in PC and compare with the RS485 command sent out via RS485-LN. as long as both commands are the same, the MTU should return correct result.
1767 +
1768 +
1769 +Or User can send the working commands set in PC serial tool to Dragino Support to check what should be configured in RS485-LN.
1770 +
1771 +(% style="color:blue" %)**Connection method:**
1772 +
1773 +[[image:image-20221130104310-12.png]]
1774 +
1775 +
1776 +(% style="color:blue" %)**Link situation:**
1777 +
1778 +[[image:image-20221130104310-13.png||height="458" width="486"]]
1779 +
1780 +
1781 +[[image:image-20221130104310-14.png||height="371" width="823"]]
1782 +
1783 +
1784 +== 6.8 Where to get the decoder for RS485-LN? ==
1785 +
1786 +
1787 +The decoder for RS485-LN needs to be written by yourself. Because the sensor to which the user is connected is custom, the read device data bytes also need custom parsing, so there is no universal decoder. We can only provide [[templates>>https://github.com/dragino/dragino-end-node-decoder/tree/main/RS485-LN]] for decoders (no intermediate data parsing part involved)
1788 +
1789 +
1790 +== 6.9 How to configure RS485 commands more conveniently? ==
1791 +
1792 +
1793 +Dragino has developed an application for the RS485 series of products.
1794 +
1795 +It can help you configure RS485 sensors more conveniently
1796 +Please refer to the link below for specific usage:
1797 +
1798 +[[RS485 Configure Tool - DRAGINO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/RS485_Configure_Tool/#HTableofContentsFF1A]]
1799 +
1800 +
1801 += 7. Trouble Shooting =
1802 +
1803 +== 7.1 Downlink doesn't work, how to solve it? ==
1804 +
1805 +
1806 +Please see this link for debug: [[LoRaWAN Communication Debug>>doc:Main.LoRaWAN Communication Debug.WebHome]]
1807 +
1808 +
1809 +== 7.2 Why customers can't join TTN V3 in US915 /AU915 bands? ==
1810 +
1811 +
1812 +It might about the channels mapping. Please see for detail: [[Notice of Frequency band>>doc:Main.LoRaWAN Communication Debug.WebHome||anchor="H2.NoticeofUS9152FCN4702FAU915Frequencyband"]]
1813 +
1814 +
1815 +== 7.3 Why can't customers see the device's data in the server when the data is too long? ==
1816 +
1817 +This is due to the limitation of the lorawan protocol, and the fixed DR needs to be adjusted to improve this problem.
1818 +
1819 +Please refer to the following link for the number of bytes limited by different frequencies and different DRs in the lorawan protocol
1820 +
1821 +[[lora-alliance.org/wp-content/uploads/2021/05/RP002-1.0.3-FINAL-1.pdf>>url:https://lora-alliance.org/wp-content/uploads/2021/05/RP002-1.0.3-FINAL-1.pdf]]
1822 +
1823 +Example:
1824 +
1825 +[[image:image-20240620145456-1.png]]
1826 +
1827 +Please refer to the following command to fix DR
1828 +
1829 +AT+ADR=0
1830 +
1831 +AT+DR=3
1832 +
1833 +Downlink command:
1834 +
1835 +[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H7.4DataRate>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H7.4DataRate]]
1836 +
1837 +
1838 +
1839 += 8. Order Info =
1840 +
1841 +
1842 +(% style="color:blue" %)**Part Number: RS485-LN-XXX**
1843 +
1844 +(% style="color:blue" %)**XXX:**
1845 +
1846 +* (% style="color:red" %)**EU433**(%%):  frequency bands EU433
1847 +* (% style="color:red" %)**EU868**(%%):  frequency bands EU868
1848 +* (% style="color:red" %)**KR920**(%%):  frequency bands KR920
1849 +* (% style="color:red" %)**CN470**(%%):  frequency bands CN470
1850 +* (% style="color:red" %)**AS923**(%%):  frequency bands AS923
1851 +* (% style="color:red" %)**AU915**(%%):  frequency bands AU915
1852 +* (% style="color:red" %)**US915**(%%):  frequency bands US915
1853 +* (% style="color:red" %)**IN865**(%%):  frequency bands IN865
1854 +* (% style="color:red" %)**RU864**(%%):  frequency bands RU864
1855 +* (% style="color:red" %)**KZ865**(%%):  frequency bands KZ865
1856 +
1857 += 9. Packing Info =
1858 +
1859 +
1189 1189  **Package Includes**:
1190 1190  
1191 -* RS485-BL x 1
1862 +* RS485-LN x 1
1192 1192  * Stick Antenna for LoRa RF part x 1
1193 1193  * Program cable x 1
1194 1194  
... ... @@ -1199,9 +1199,67 @@
1199 1199  * Package Size / pcs : 14.5 x 8 x 5 cm
1200 1200  * Weight / pcs : 170g
1201 1201  
1202 -1. Support
1873 += 10. FCC Caution for RS485LN-US915 =
1203 1203  
1204 -* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
1205 -* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to
1206 1206  
1207 -[[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]]
1876 +(((
1877 +Any Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
1878 +)))
1879 +
1880 +(((
1881 +This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
1882 +)))
1883 +
1884 +(((
1885 +
1886 +)))
1887 +
1888 +(((
1889 +(% style="color:red" %)**IMPORTANT NOTE:**
1890 +)))
1891 +
1892 +(((
1893 +(% style="color:red" %)**Note: **(%%)This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures:
1894 +)))
1895 +
1896 +(((
1897 +—Reorient or relocate the receiving antenna.
1898 +)))
1899 +
1900 +(((
1901 +—Increase the separation between the equipment and receiver.
1902 +)))
1903 +
1904 +(((
1905 +—Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
1906 +)))
1907 +
1908 +(((
1909 +—Consult the dealer or an experienced radio/TV technician for help.
1910 +)))
1911 +
1912 +(((
1913 +
1914 +)))
1915 +
1916 +(((
1917 +(% style="color:red" %)**FCC Radiation Exposure Statement:**
1918 +)))
1919 +
1920 +(((
1921 +This equipment complies with FCC radiation exposure limits set forth for an uncontrolled environment.This equipment should be installed and operated with minimum distance 20cm between the radiator& your body.
1922 +)))
1923 +
1924 +
1925 += 11. Support =
1926 +
1927 +
1928 +* (((
1929 +Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
1930 +)))
1931 +* (((
1932 +Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]].
1933 +
1934 +
1935 +
1936 +)))
1654157178836-407.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +179.9 KB
Content
1654157342174-798.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +31.9 KB
Content
1654158783574-851.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +40.6 KB
Content
1654159460680-153.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +24.9 KB
Content
1654160691922-496.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +109.3 KB
Content
1654162355560-817.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +670.0 KB
Content
1654162368066-342.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +192.9 KB
Content
1654162478620-421.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +158.9 KB
Content
1654162535040-878.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +670.0 KB
Content
image-20220602153621-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +23.4 KB
Content
image-20220602153621-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +22.2 KB
Content
image-20220602153621-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +22.3 KB
Content
image-20220602155039-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +24.6 KB
Content
image-20220602163333-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +48.2 KB
Content
image-20220602165351-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +10.6 KB
Content
image-20220602165351-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +19.3 KB
Content
image-20220602171200-8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +276.1 KB
Content
image-20220602171200-9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +10.0 KB
Content
image-20220602175638-10.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +85.5 KB
Content
image-20220602175743-11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +85.5 KB
Content
image-20220602175818-12.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +102.5 KB
Content
image-20220602175848-13.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +250.9 KB
Content
image-20220602175912-14.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +176.1 KB
Content
image-20220606110929-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +13.9 KB
Content
image-20220824144240-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +110.9 KB
Content
image-20220824145428-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +12.6 KB
Content
image-20220824145428-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +17.7 KB
Content
image-20220929111027-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +240.0 KB
Content
image-20221130104310-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +82.0 KB
Content
image-20221130104310-10.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +17.4 KB
Content
image-20221130104310-11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +27.7 KB
Content
image-20221130104310-12.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +392.9 KB
Content
image-20221130104310-13.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +23.3 KB
Content
image-20221130104310-14.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +25.4 KB
Content
image-20221130104310-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +392.9 KB
Content
image-20221130104310-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +30.4 KB
Content
image-20221130104310-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +25.8 KB
Content
image-20221130104310-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +22.9 KB
Content
image-20221130104310-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +12.9 KB
Content
image-20221130104310-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +25.1 KB
Content
image-20221130104310-8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +9.9 KB
Content
image-20221130104310-9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +29.1 KB
Content
image-20230425175403-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +150.1 KB
Content
image-20230425175410-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +150.1 KB
Content
image-20240620145456-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +50.3 KB
Content
image-20240816112950-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.karry
Size
... ... @@ -1,0 +1,1 @@
1 +230.3 KB
Content
image-20240925144019-1.jpeg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +1.6 MB
Content