Version 68.4 by Xiaoling on 2022/08/18 14:30

Show last authors
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" %)​
5
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 )))
8
9
10
11
12
13
14
15 **Table of Contents:**
16
17 {{toc/}}
18
19
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 )))
24
25
26
27
28
29
30
31 = 1.Introduction =
32
33 == 1.1 What is RS485-LN RS485 to LoRaWAN Converter ==
34
35 (((
36 (((
37 (((
38
39
40 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.
41 )))
42 )))
43
44 (((
45 (((
46 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.
47 )))
48 )))
49
50 (((
51 (((
52 (% style="color:blue" %)**For data uplink**(%%), RS485-LN sends user-defined commands to RS485 devices and gets the return from the RS485 devices. RS485-LN will process these returns according to user-define rules to get the final payload and upload to LoRaWAN server.
53 )))
54 )))
55
56 (((
57 (((
58 (% 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.
59 )))
60
61 (((
62 (% 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]]
63
64
65 )))
66 )))
67 )))
68
69 (% 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" %)​
70
71
72
73 == 1.2 Specifications ==
74
75
76 **Hardware System:**
77
78 * STM32L072CZT6 MCU
79 * SX1276/78 Wireless Chip 
80 * Power Consumption (exclude RS485 device):
81 ** Idle: 32mA@12v
82 ** 20dB Transmit: 65mA@12v
83
84 **Interface for Model:**
85
86 * RS485
87 * Power Input 7~~ 24V DC. 
88
89 **LoRa Spec:**
90
91 * Frequency Range:
92 ** Band 1 (HF): 862 ~~ 1020 Mhz
93 ** Band 2 (LF): 410 ~~ 528 Mhz
94 * 168 dB maximum link budget.
95 * +20 dBm - 100 mW constant RF output vs.
96 * +14 dBm high efficiency PA.
97 * Programmable bit rate up to 300 kbps.
98 * High sensitivity: down to -148 dBm.
99 * Bullet-proof front end: IIP3 = -12.5 dBm.
100 * Excellent blocking immunity.
101 * Low RX current of 10.3 mA, 200 nA register retention.
102 * Fully integrated synthesizer with a resolution of 61 Hz.
103 * FSK, GFSK, MSK, GMSK, LoRaTM and OOK modulation.
104 * Built-in bit synchronizer for clock recovery.
105 * Preamble detection.
106 * 127 dB Dynamic Range RSSI.
107 * Automatic RF Sense and CAD with ultra-fast AFC.
108 * Packet engine up to 256 bytes with CRC
109
110
111 == 1.3 Features ==
112
113
114 * LoRaWAN Class A & Class C protocol (default Class C)
115 * Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865/RU864
116 * AT Commands to change parameters
117 * Remote configure parameters via LoRa Downlink
118 * Firmware upgradable via program port
119 * Support multiply RS485 devices by flexible rules
120 * Support Modbus protocol
121 * Support Interrupt uplink (Since hardware version v1.2)
122
123
124 == 1.4 Applications ==
125
126
127 * Smart Buildings & Home Automation
128 * Logistics and Supply Chain Management
129 * Smart Metering
130 * Smart Agriculture
131 * Smart Cities
132 * Smart Factory
133
134
135 == 1.5 Firmware Change log ==
136
137
138 [[RS485-LN Image files – Download link and Change log>>url:http://www.dragino.com/downloads/index.php?dir=RS485-LN/]]
139
140
141
142 == 1.6 Hardware Change log ==
143
144
145 (((
146 (((
147 (((
148 v1.2: Add External Interrupt Pin.
149 )))
150
151 (((
152 v1.0: Release
153 )))
154
155
156
157 )))
158 )))
159
160 = 2. Power ON Device =
161
162
163 (((
164 The RS485-LN can be powered by 7 ~~ 24V DC power source. Connection as below
165
166 * Power Source VIN to RS485-LN VIN+
167 * Power Source GND to RS485-LN VIN-
168
169 (((
170 Once there is power, the RS485-LN will be on.
171 )))
172
173 (% 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" %)​
174
175
176
177 )))
178
179 = 3. Operation Mode =
180
181 == 3.1 How it works? ==
182
183
184 (((
185 (((
186 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.
187 )))
188
189
190
191 )))
192
193 == 3.2 Example to join LoRaWAN network ==
194
195
196 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. 
197
198 (% 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" %)​
199
200
201 (((
202 (((
203 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:
204 )))
205
206 (((
207 485A+ and 485B- of the sensor are connected to RS485A and RA485B of RS485-LN respectively.
208 )))
209
210 (% 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" %)​
211
212
213 (((
214 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:
215 )))
216
217 (((
218 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN V3 with the OTAA keys from RS485-LN.
219 )))
220
221 (((
222 Each RS485-LN is shipped with a sticker with unique device EUI:
223 )))
224 )))
225
226 (% aria-label="1652953462722-299.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1652953462722-299.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" %)​
227
228
229 (((
230 (((
231 User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:
232 )))
233
234 (((
235 **Add APP EUI in the application.**
236 )))
237 )))
238
239 (% 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" %)​
240
241 (% 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" %)​
242
243 (% 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" %)​
244
245 (% 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"]](% title="Click and drag to resize" %)​
246
247 You can also choose to create the device manually.
248
249 (% 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" %)​
250
251
252
253 **Add APP KEY and DEV EUI**
254
255 (% 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" %)​
256
257
258 (((
259 (% 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.
260 )))
261
262 (% 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" %)​
263
264
265
266 == 3.3 Configure Commands to read data ==
267
268
269 (((
270 (((
271 (((
272 There are plenty of RS485 devices in the market and each device has different command to read the valid data. To support these devices in flexible, RS485-LN supports flexible command set. User can use [[AT Commands>>||anchor="H3.5ConfigureRS485-LNviaATorDownlink"]] or LoRaWAN Downlink Command to configure what commands RS485-LN should send for each sampling and how to handle the return from RS485 devices.
273 )))
274 )))
275
276 (((
277 (((
278 (% 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**
279 )))
280
281
282
283 )))
284 )))
285
286 === 3.3.1 Configure UART settings for RS485 or TTL communication ===
287
288
289 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:
290
291 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
292 |=(% style="width: 110px;" %)(((
293 **AT Commands**
294 )))|=(% style="width: 190px;" %)(((
295 **Description**
296 )))|=(% style="width: 190px;" %)(((
297 **Example**
298 )))
299 |(% style="width:110px" %)(((
300 AT+BAUDR
301 )))|(% style="width:190px" %)(((
302 Set the baud rate (for RS485 connection). Default Value is: 9600.
303 )))|(% style="width:190px" %)(((
304 (((
305 AT+BAUDR=9600
306 )))
307
308 (((
309 Options: (1200,2400,4800,14400,19200,115200)
310 )))
311 )))
312 |(% style="width:110px" %)(((
313 AT+PARITY
314 )))|(% style="width:190px" %)(((
315 Set UART parity (for RS485 connection)
316 )))|(% style="width:190px" %)(((
317 (((
318 AT+PARITY=0
319 )))
320
321 (((
322 Option: 0: no parity, 1: odd parity, 2: even parity
323 )))
324 )))
325 |(% style="width:110px" %)(((
326 AT+STOPBIT
327 )))|(% style="width:190px" %)(((
328 (((
329 Set serial stopbit (for RS485 connection)
330 )))
331
332 (((
333
334 )))
335 )))|(% style="width:190px" %)(((
336 (((
337 AT+STOPBIT=0 for 1bit
338 )))
339
340 (((
341 AT+STOPBIT=1 for 1.5 bit
342 )))
343
344 (((
345 AT+STOPBIT=2 for 2 bits
346 )))
347 )))
348
349
350 === 3.3.2 Configure sensors ===
351
352
353 (((
354 (((
355 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.
356
357
358 )))
359 )))
360
361 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
362 |=(% style="width: 110px;" %)**AT Commands**|=(% style="width: 190px;" %)**Description**|=(% style="width: 190px;" %)**Example**
363 |AT+CFGDEV|(% style="width:110px" %)(((
364 (((
365 This command is used to configure the RS485/TTL devices; they won’t be used during sampling.
366 )))
367
368 (((
369 AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,
370 )))
371
372 (((
373 mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
374 )))
375 )))|(% style="width:190px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
376
377
378 === 3.3.3 Configure read commands for each sampling ===
379
380
381 (((
382 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.
383
384 To save the LoRaWAN network bandwidth, we might need to read data from different sensors and combine their valid value into a short payload.
385
386 This section describes how to achieve above goals.
387
388 During each sampling, the RS485-LN can support 15 commands to read sensors. And combine the return to one or several uplink payloads.
389
390
391 (% style="color:#037691" %)**Each RS485 commands include two parts:**
392
393 ~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.
394
395 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.
396
397 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
398
399
400 After we got the valid value from each RS485 commands, we need to combine them together with the command **AT+DATAUP**.
401
402 Below are examples for the how above AT Commands works.
403
404
405 (% 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:
406
407 (% border="1" style="background-color:#4bacc6; color:white; width:499px" %)
408 |(% style="width:496px" %)(((
409 (% style="color:#037691" %)**AT+COMMANDx=xx xx xx xx xx xx xx xx xx xx xx xx,m**
410
411 **xx xx xx xx xx xx xx xx xx xx xx xx: The RS485 command to be sent**
412
413 **m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command**
414 )))
415
416 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.
417
418 In the RS485-LN, we should use this command AT+COMMAND1=01 03 0B B8 00 02,1 for the same.
419
420
421 (% style="color:#037691" %)**AT+DATACUTx **(%%)**: **This command defines how to handle the return from AT+COMMANDx, max return length is 45 bytes.
422
423 (% border="1" style="background-color:#4bacc6; color:white; width:510px" %)
424 |(% style="width:510px" %)(((
425 **AT+DATACUTx=a,b,c**
426
427 * **a: length for the return of AT+COMMAND**
428 * **b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
429 * **c: define the position for valid value.  **
430 )))
431
432 **Examples:**
433
434 * (% style="color:#037691" %)**Grab bytes**
435
436 (% 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" %)​
437
438
439 * (% style="color:#037691" %)**Grab a section**
440
441 (% 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" %)​
442
443
444 * (% style="color:#037691" %)**Grab different sections**
445
446 (% 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" %)​
447
448
449
450 )))
451
452 === 3.3.4 Compose the uplink payload ===
453
454
455 (((
456 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.**
457
458
459 )))
460
461 (((
462 (% style="color:#037691" %)**Examples: AT+DATAUP=0**
463
464
465 )))
466
467 (((
468 Compose the uplink payload with value returns in sequence and send with (% style="color:red" %)**A SIGNLE UPLINK**.
469 )))
470
471 (((
472 Final Payload is
473 )))
474
475 (((
476 (% style="color:#4f81bd" %)**Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx**
477 )))
478
479 (((
480 Where PAYVER is defined by AT+PAYVER, below is an example screen shot.
481 )))
482
483 (% aria-label="1653269759169-150.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1653269759169-150.png||data-widget="image" height="513" width="716"]](% 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" %)​
484
485
486 (% style="color:#037691" %)**Examples: AT+DATAUP=1**
487
488
489 Compose the uplink payload with value returns in sequence and send with (% style="color:red" %)**Multiply UPLINKs**.
490
491 Final Payload is
492
493 (% style="color:#4f81bd" %)**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
494
495
496 1. PAYVER: Defined by AT+PAYVER
497 1. PAYLOAD COUNT: Total how many uplinks of this sampling.
498 1. PAYLOAD#: Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
499 1. 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
500
501 (% 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" %)​
502
503
504 So totally there will be 3 uplinks for this sampling, each uplink include 8 bytes DATA
505
506 DATA1=RETURN1 Valid Value + the first two of Valid value of RETURN10= **20 20 0a 33 90 41 02 aa**
507
508 DATA2=3^^rd^^ ~~ 10^^th^^ byte of Valid value of RETURN10= **05 81 0a 20 20 20 20 2d**
509
510 DATA3=the rest of Valid value of RETURN10= **30**
511
512
513 (% 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:**
514
515 ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink.
516
517 * For AU915/AS923 bands, if UplinkDwell time=0, max 11 bytes for each uplink.
518
519 * For US915 band, max 11 bytes for each uplink.
520
521 ~* For all other bands: max 51 bytes for each uplink.
522
523
524 Below are the uplink payloads:
525
526 (% 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" %)​
527
528
529
530 === 3.3.5 Uplink on demand ===
531
532
533 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.
534
535 Downlink control command:
536
537 **0x08 command**: Poll an uplink with current command set in RS485-LN.
538
539 **0xA8 command**: Send a command to RS485-LN and uplink the output from sensors.
540
541
542
543 === 3.3.6 Uplink on Interrupt ===
544
545
546 RS485-LN support external Interrupt uplink since hardware v1.2 release.
547
548 (% 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" %)​
549
550 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.
551
552
553
554 == 3.4 Uplink Payload ==
555
556
557 (% aria-label="image-20220606110929-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220606110929-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" %)​
558
559 Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
560
561
562
563 == 3.5 Configure RS485-LN via AT or Downlink ==
564
565
566 (((
567 User can configure RS485-LN via AT Commands or LoRaWAN Downlink Commands
568 )))
569
570 (((
571 There are two kinds of Commands:
572 )))
573
574 * (((
575 (% 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]]
576 )))
577
578 * (((
579 (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-LN.  User can see these commands below:
580 )))
581
582 (((
583
584 )))
585
586
587
588 === 3.5.1 Common Commands ===
589
590
591 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]]
592
593
594
595 === 3.5.2 Downlink Response(Since firmware v1.4) ===
596
597
598 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.
599
600 (% 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"]](% title="Click and drag to resize" %)​
601
602 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)
603
604
605
606 === 3.5.3 Sensor related commands ===
607
608
609
610
611 ==== (% style="color:blue" %)**RS485 Debug Command**(%%) ====
612
613 (((
614 This command is used to configure the RS485 devices; they won't be used during sampling.
615 )))
616
617 * (((
618 (% style="color:#037691" %)**AT Command**
619
620 (((
621 **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
622 )))
623 )))
624
625 (((
626
627 )))
628
629 * (((
630 (% style="color:#037691" %)**Downlink Payload**
631 )))
632
633 (((
634 Format: A8 MM NN XX XX XX XX YY
635 )))
636
637 (((
638 Where:
639 )))
640
641 * (((
642 MM: 1: add CRC-16/MODBUS ; 0: no CRC
643 )))
644 * (((
645 NN: The length of RS485 command
646 )))
647 * (((
648 XX XX XX XX: RS485 command total NN bytes
649 )))
650 * (((
651 (((
652 YY: How many bytes will be uplink from the return of this RS485 command,
653 )))
654
655 * (((
656 if YY=0, RS485-LN will execute the downlink command without uplink;
657 )))
658 * (((
659 if YY>0, RS485-LN will uplink total YY bytes from the output of this RS485 command; Fport=200
660 )))
661 * (((
662 if YY=FF, RS485-LN will uplink RS485 output with the downlink command content; Fport=200.
663 )))
664 )))
665
666 (((
667
668
669 **Example 1**  ~-~-> Configure without ask for uplink (YY=0)
670 )))
671
672 (((
673 To connect a Modbus Alarm with below commands.
674 )))
675
676 * (((
677 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.
678 )))
679
680 * (((
681 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.
682 )))
683
684 (((
685
686
687 So if user want to use downlink command to control to RS485 Alarm, he can use:
688 )))
689
690 (((
691 (% style="color:#4f81bd" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
692 )))
693
694 (((
695 (% style="color:#4f81bd" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
696 )))
697
698 (((
699 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.
700 )))
701
702 (((
703
704 )))
705
706 (((
707 **Example 2**  ~-~-> Configure with requesting uplink and original downlink command (**YY=FF**)
708 )))
709
710 (((
711 User in IoT server send a downlink command: (% style="color:#4f81bd" %)**A8 01 06 0A 08 00 04 00 01 YY**
712 )))
713
714 (((
715
716 )))
717
718 (((
719 (((
720 RS485-LN got this downlink command and send (% style="color:#4f81bd" %)**0A 08 00 04 00 01 **(%%)to Modbus network. One of the RS485 sensor in the network send back Modbus reply **0A 08 00 04 00 00**. RS485-LN get this reply and combine with the original downlink command and uplink. The uplink message is:  **A8** (% style="color:#4f81bd" %)**0A 08 00 04 00  **(% style="color:red" %)**01 06** ** **(% style="color:green" %)**0A 08 00 04 00 00**
721 )))
722
723
724 )))
725
726 (((
727 (% aria-label="1654159460680-153.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1654159460680-153.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" %)​
728 )))
729
730
731
732
733 ==== (% style="color:blue" %)**Set Payload version**(%%) ====
734
735 (((
736 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.
737 )))
738
739 * (((
740 (% style="color:#037691" %)**AT Command:**
741
742 **AT+PAYVER:    **Set PAYVER field = 1
743
744
745 )))
746 * (((
747 (% style="color:#037691" %)**Downlink Payload:**
748 )))
749
750 (((
751 **0xAE 01**  ~-~->  Set PAYVER field =  0x01
752 )))
753
754 (((
755 **0xAE 0F**   ~-~->  Set PAYVER field =  0x0F
756 )))
757
758
759
760
761 ==== (% style="color:blue" %)**Set RS485 Sampling Commands**(%%) ====
762
763 (((
764 AT+COMMANDx or AT+DATACUTx
765 )))
766
767 (((
768 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"]].
769 )))
770
771 (((
772
773 )))
774
775 * (((
776 (% style="color:#037691" %)**AT Command:**
777 )))
778
779 **AT+COMMANDx:    **Configure RS485 read command to sensor.
780
781 **AT+DATACUTx:        **Configure how to handle return from RS485 devices.
782
783
784 * (((
785 (% style="color:#037691" %)**Downlink Payload:**
786 )))
787
788 (((
789 **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
790 )))
791
792 (((
793 (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
794 )))
795
796 (((
797 Format: AF MM NN LL XX XX XX XX YY
798 )))
799
800 (((
801 Where:
802 )))
803
804 * (((
805 MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
806 )))
807 * (((
808 NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
809 )))
810 * (((
811 LL:  The length of AT+COMMAND or AT+DATACUT command
812 )))
813 * (((
814 XX XX XX XX: AT+COMMAND or AT+DATACUT command
815 )))
816 * (((
817 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.
818 )))
819
820 (((
821
822
823 **Example:**
824 )))
825
826 (((
827 (% 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
828 )))
829
830 (((
831 (% 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**
832 )))
833
834 (((
835 (% 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**
836 )))
837
838
839
840
841 ==== (% style="color:blue" %)**Fast command to handle MODBUS device**(%%) ====
842
843 (((
844 **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]].
845 )))
846
847 (((
848 This command is valid since v1.3 firmware version
849 )))
850
851 (((
852 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.
853 )))
854
855 (((
856
857 )))
858
859 (((
860 **Example:**
861 )))
862
863 * (((
864 AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2  are not configure (0,0,0). So RS485-LN.
865 )))
866 * (((
867 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.
868 )))
869 * (((
870 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.
871
872
873 )))
874
875 (% aria-label="image-20220602165351-6.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220602165351-6.png||data-widget="image"]](% title="Click and drag to resize" %)​
876
877 (% 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" %)​
878
879
880
881
882 ==== (% style="color:blue" %)**RS485 command timeout**(%%) ====
883
884 (((
885 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.
886 )))
887
888 (((
889 Default value: 0, range:  0 ~~ 65 seconds
890 )))
891
892 * (((
893 (% style="color:#037691" %)** AT Command:**
894
895 **AT+CMDDLaa=hex(bb cc)*1000**
896 )))
897
898 (((
899
900
901 **Example:**
902 )))
903
904 (((
905 **AT+CMDDL1=1000** to send the open time to 1000ms
906 )))
907
908 (((
909
910 )))
911
912 * (((
913 (% style="color:#037691" %)** Downlink Payload:**
914 )))
915
916 (((
917 **0x AA aa bb cc**
918 )))
919
920 (((
921 Same as: AT+CMDDLaa=hex(bb cc)*1000
922 )))
923
924 (((
925 **Example:**
926 )))
927
928 (((
929 **0xAA 01 00 01**  ~-~-> Same as  **AT+CMDDL1=1000 ms**
930 )))
931
932
933
934
935 ==== (% style="color:blue" %)**Uplink payload mode**(%%) ====
936
937 (((
938 Define to use one uplink or multiple uplinks for the sampling.
939 )))
940
941 (((
942 The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
943
944
945 )))
946
947 * (((
948 (% style="color:#037691" %)** AT Command:**
949 )))
950
951 **AT+DATAUP=0**
952
953 **AT+DATAUP=1**
954
955
956 * (((
957 (% style="color:#037691" %)** Downlink Payload:**
958 )))
959
960 (((
961 **0xAD 00**  **~-~->** Same as AT+DATAUP=0
962 )))
963
964 (((
965 **0xAD 01**  **~-~->** Same as AT+DATAUP=1
966 )))
967
968
969
970
971 ==== (% style="color:blue" %)**Manually trigger an Uplink**(%%) ====
972
973 (((
974 Ask device to send an uplink immediately.
975 )))
976
977 * (((
978 (% style="color:#037691" %)** AT Command:**
979 )))
980
981 (((
982 No AT Command for this, user can press the [[ACT button>>||anchor="H3.7Buttons"]] for 1 second for the same.
983 )))
984
985 (((
986
987 )))
988
989 * (((
990 (% style="color:#037691" %)** Downlink Payload:**
991 )))
992
993 (((
994 **0x08 FF**, RS485-LN will immediately send an uplink.
995 )))
996
997
998
999
1000 ==== (% style="color:blue" %)**Clear RS485 Command**(%%) ====
1001
1002 (((
1003 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
1004
1005
1006 )))
1007
1008 * (((
1009 (% style="color:#037691" %)** AT Command:**
1010 )))
1011
1012 (((
1013 **AT+CMDEAR=mm,nn**   mm: start position of erase ,nn: stop position of erase
1014 )))
1015
1016 (((
1017 Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
1018 )))
1019
1020 (((
1021 Example screen shot after clear all RS485 commands. 
1022 )))
1023
1024 (((
1025
1026 )))
1027
1028 (((
1029 The uplink screen shot is:
1030 )))
1031
1032 (% 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" %)​
1033
1034
1035 * (((
1036 (% style="color:#037691" %)** Downlink Payload:**
1037 )))
1038
1039 (((
1040 **0x09 aa bb** same as AT+CMDEAR=aa,bb
1041 )))
1042
1043
1044
1045
1046 ==== (% style="color:blue" %)**Set Serial Communication Parameters**(%%) ====
1047
1048 (((
1049 Set the Rs485 serial communication parameters:
1050 )))
1051
1052 * (((
1053 (% style="color:#037691" %)** AT Command:**
1054 )))
1055
1056 (((
1057
1058
1059 * Set Baud Rate
1060 )))
1061
1062 **AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1063
1064
1065 (((
1066 * Set UART Parity
1067 )))
1068
1069 **AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1070
1071
1072 (((
1073 * Set STOPBIT
1074 )))
1075
1076 **AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1077
1078
1079
1080 * (((
1081 (% style="color:#037691" %)** Downlink Payload:**
1082 )))
1083
1084 (((
1085 **A7 01 aa bb**:  Same  AT+BAUDR=hex(aa bb)*100
1086 )))
1087
1088 (((
1089 **Example:**
1090 )))
1091
1092 * (((
1093 A7 01 00 60   same as AT+BAUDR=9600
1094 )))
1095 * (((
1096 A7 01 04 80  same as AT+BAUDR=115200
1097 )))
1098
1099 (((
1100 A7 02 aa:  Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
1101 )))
1102
1103 (((
1104 A7 03 aa:  Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1105 )))
1106
1107
1108
1109
1110 == 3.6 Listening mode for RS485 network ==
1111
1112
1113 (((
1114 This feature support since firmware v1.4
1115 )))
1116
1117 (((
1118 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.
1119
1120
1121 )))
1122
1123 (% 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"]](% title="Click and drag to resize" %)​
1124
1125 (((
1126 To enable the listening mode, use can run the command AT+RXMODE.
1127 )))
1128
1129 (((
1130
1131 )))
1132
1133 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
1134 |=(% style="width: 100px;" %)(((
1135 **Command example**
1136 )))|=(% style="width: 400px;" %)(((
1137 **Function**
1138 )))
1139 |(% style="width:100px" %)(((
1140 AT+RXMODE=1,10
1141 )))|(% style="width:400px" %)(((
1142 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.
1143 )))
1144 |(% style="width:100px" %)(((
1145 AT+RXMODE=2,500
1146 )))|(% style="width:400px" %)(((
1147 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
1148 )))
1149 |(% style="width:100px" %)(((
1150 AT+RXMODE=0,0
1151 )))|(% style="width:400px" %)(((
1152 Disable listening mode. This is the default settings.
1153 )))
1154 |(% style="width:100px" %)(((
1155
1156 )))|(% style="width:400px" %)(((
1157 A6 aa bb cc  same as AT+RXMODE=aa,(bb<<8 | cc)
1158 )))
1159
1160 (((
1161 (% style="color:#037691" %)** Downlink Command:**
1162 )))
1163
1164 (((
1165 **0xA6 aa bb cc ** same as AT+RXMODE=aa,(bb<<8 | cc)
1166 )))
1167
1168 (((
1169
1170 )))
1171
1172 (((
1173 **Example**:
1174 )))
1175
1176 (((
1177 The RS485-LN is set to AT+RXMODE=2,1000
1178 )))
1179
1180 (((
1181 There is a two Modbus commands in the RS485 network as below:
1182 )))
1183
1184 (((
1185 The Modbus master send a command: (% style="background-color:#ffc000" %)01 03 00 00 00 02 c4 0b
1186 )))
1187
1188 (((
1189 And Modbus slave reply with: (% style="background-color:green" %)01 03 04 00 00 00 00 fa 33
1190 )))
1191
1192 (((
1193 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
1194 )))
1195
1196 (((
1197 (% 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" %)​
1198 )))
1199
1200 (((
1201
1202 )))
1203
1204 (((
1205 (((
1206 (% 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.**
1207 )))
1208 )))
1209
1210
1211
1212 == 3.7 Buttons ==
1213
1214
1215 (% border="1" cellspacing="10" style="background-color:#f7faff; width:430px" %)
1216 |=(% style="width: 50px;" %)**Button**|=(% style="width: 361px;" %)**Feature**
1217 |(% 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**
1218 |(% style="width:50px" %)**RST**|(% style="width:361px" %)Reboot RS485
1219 |(% style="width:50px" %)**PRO**|(% style="width:361px" %)Use for upload image, see [[How to Update Image>>||anchor="H6.1Howtoupgradetheimage3F"]]
1220
1221
1222 == 3.8 LEDs ==
1223
1224
1225 (% border="1" cellspacing="10" style="background-color:#f7faff; width:430px" %)
1226 |=(% style="width: 50px;" %)**LEDs**|=(% style="width: 380px;" %)**Feature**
1227 |**PWR**|Always on if there is power
1228 |**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.
1229
1230
1231 = 4. Case Study =
1232
1233
1234 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]]
1235
1236
1237
1238 = 5. Use AT Command =
1239
1240 == 5.1 Access AT Command ==
1241
1242
1243 (((
1244 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.
1245 )))
1246
1247 (% 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" %)​
1248
1249
1250 (((
1251 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:
1252 )))
1253
1254 (% 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" %)​
1255
1256
1257 (((
1258 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/]]
1259 )))
1260
1261
1262
1263 == 5.2 Common AT Command Sequence ==
1264
1265
1266 === 5.2.1 Multi-channel ABP mode (Use with SX1301/LG308) ===
1267
1268
1269 If device has not joined network yet:
1270
1271 * (% style="color:#037691" %)**AT+FDR**
1272 * (% style="color:#037691" %)**AT+NJM=0**
1273 * (% style="color:#037691" %)**ATZ**
1274
1275 (((
1276
1277
1278 If device already joined network:
1279
1280 * (% style="color:#037691" %)**AT+NJM=0**
1281 * (% style="color:#037691" %)**ATZ**
1282
1283
1284 )))
1285
1286
1287
1288 === 5.5.2 Single-channel ABP mode (Use with LG01/LG02) ===
1289
1290
1291 (% style="background-color:#dcdcdc" %)**AT+FDR** (%%) Reset Parameters to Factory Default, Keys Reserve
1292
1293 (% style="background-color:#dcdcdc" %)**AT+NJM=0 **(%%) Set to ABP mode
1294
1295 (% style="background-color:#dcdcdc" %)**AT+ADR=0** (%%) Set the Adaptive Data Rate Off
1296
1297 (% style="background-color:#dcdcdc" %)**AT+DR=5**   (%%) Set Data Rate
1298
1299 (% style="background-color:#dcdcdc" %)**AT+TDC=60000** (%%) Set transmit interval to 60 seconds
1300
1301 (% style="background-color:#dcdcdc" %)**AT+CHS=868400000**(%%)  Set transmit frequency to 868.4Mhz
1302
1303 (% style="background-color:#dcdcdc" %)**AT+RX2FQ=868400000** (%%) Set RX2Frequency to 868.4Mhz (according to the result from server)
1304
1305 (% style="background-color:#dcdcdc" %)**AT+RX2DR=5**  (%%) Set RX2DR to match the downlink DR from server. see below
1306
1307 (% 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.
1308
1309 (% style="background-color:#dcdcdc" %)**ATZ**       (%%) Reset MCU
1310
1311
1312 (% style="color:red" %)**Note:**
1313
1314 (((
1315 (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server.
1316 2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
1317 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.
1318 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
1319 )))
1320
1321 (% 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" %)​
1322
1323
1324
1325 = 6. FAQ =
1326
1327 == 6.1 How to upgrade the image? ==
1328
1329
1330 (((
1331 The RS485-LN LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-LN to:
1332 )))
1333
1334 * (((
1335 Support new features
1336 )))
1337 * (((
1338 For bug fix
1339 )))
1340 * (((
1341 Change LoRaWAN bands.
1342 )))
1343
1344 (((
1345 Below shows the hardware connection for how to upload an image to RS485-LN:
1346 )))
1347
1348 (% 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"]]
1349
1350 (% title="Click and drag to resize" %)​
1351
1352 (((
1353 (% 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]].
1354 )))
1355
1356 (((
1357 (% style="color:blue" %)**Step2**(%%)**:** Download the [[LT Image files>>url:https://www.dragino.com/downloads/index.php?dir=RS485-LN/Firmware/]].
1358 )))
1359
1360 (((
1361 (% style="color:blue" %)**Step3**(%%)**: **Open flashloader; choose the correct COM port to update.
1362 )))
1363
1364 (((
1365 (((
1366 (((
1367 (% 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.
1368 )))
1369 )))
1370 )))
1371
1372
1373 (% 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" %)​
1374
1375
1376 (% 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" %)​
1377
1378
1379 (% 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" %)​
1380
1381
1382 (% 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:**
1383
1384 (% 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" %)​
1385
1386
1387
1388 == 6.2 How to change the LoRa Frequency Bands/Region? ==
1389
1390
1391 User can follow the introduction for [[how to upgrade image>>||anchor="H6.1Howtoupgradetheimage3F"]]. When download the images, choose the required image file for download.
1392
1393
1394
1395 == 6.3 How many RS485-Slave can RS485-LN connects? ==
1396
1397
1398 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"]].
1399
1400
1401
1402 == 6.4 Compatible question to ChirpStack and TTI LoRaWAN server ? ==
1403
1404
1405 When user need to use with ChirpStack or TTI. Please set AT+RPL=4.
1406
1407 Detail info check this link: [[Set Packet Receiving Response Level>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H7.23SetPacketReceivingResponseLevel"]]
1408
1409
1410
1411 == 6.5 Can i use point to point communication for RS485-LN? ==
1412
1413
1414 Yes, please refer [[Point to Point Communication for RS485-LN>>Point to Point Communication for RS485-LN]].
1415
1416
1417
1418 == 6.6 How to Use RS485-LN  to connect to RS232 devices? ==
1419
1420
1421 [[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/]]
1422
1423
1424
1425 = 7. Trouble Shooting =
1426
1427
1428 == 7.1 Downlink doesn't work, how to solve it? ==
1429
1430
1431 Please see this link for debug: [[LoRaWAN Communication Debug>>doc:Main.LoRaWAN Communication Debug.WebHome]]
1432
1433
1434
1435 == 7.2 Why I can't join TTN V3 in US915 /AU915 bands? ==
1436
1437
1438 It might about the channels mapping. Please see for detail: [[Notice of Frequency band>>doc:Main.LoRaWAN Communication Debug.WebHome||anchor="H2.NoticeofUS9152FCN4702FAU915Frequencyband"]]
1439
1440
1441
1442 = 8. Order Info =
1443
1444
1445 (% style="color:blue" %)**Part Number: RS485-LN-XXX**
1446
1447 (% style="color:blue" %)**XXX:**
1448
1449 * (% style="color:red" %)**EU433**(%%):  frequency bands EU433
1450 * (% style="color:red" %)**EU868**(%%):  frequency bands EU868
1451 * (% style="color:red" %)**KR920**(%%):  frequency bands KR920
1452 * (% style="color:red" %)**CN470**(%%):  frequency bands CN470
1453 * (% style="color:red" %)**AS923**(%%):  frequency bands AS923
1454 * (% style="color:red" %)**AU915**(%%):  frequency bands AU915
1455 * (% style="color:red" %)**US915**(%%):  frequency bands US915
1456 * (% style="color:red" %)**IN865**(%%):  frequency bands IN865
1457 * (% style="color:red" %)**RU864**(%%):  frequency bands RU864
1458 * (% style="color:red" %)**KZ865**(%%):  frequency bands KZ865
1459
1460
1461 = 9.Packing Info =
1462
1463
1464 **Package Includes**:
1465
1466 * RS485-LN x 1
1467 * Stick Antenna for LoRa RF part x 1
1468 * Program cable x 1
1469
1470 **Dimension and weight**:
1471
1472 * Device Size: 13.5 x 7 x 3 cm
1473 * Device Weight: 105g
1474 * Package Size / pcs : 14.5 x 8 x 5 cm
1475 * Weight / pcs : 170g
1476
1477
1478 = 10. FCC Caution for RS485LN-US915 =
1479
1480
1481 (((
1482 Any Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
1483 )))
1484
1485 (((
1486 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.
1487 )))
1488
1489 (((
1490
1491 )))
1492
1493 (((
1494 (% style="color:red" %)**IMPORTANT NOTE:**
1495 )))
1496
1497 (((
1498 **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:
1499 )))
1500
1501 (((
1502 —Reorient or relocate the receiving antenna.
1503 )))
1504
1505 (((
1506 —Increase the separation between the equipment and receiver.
1507 )))
1508
1509 (((
1510 —Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
1511 )))
1512
1513 (((
1514 —Consult the dealer or an experienced radio/TV technician for help.
1515 )))
1516
1517 (((
1518
1519 )))
1520
1521 (((
1522 (% style="color:red" %)**FCC Radiation Exposure Statement:**
1523 )))
1524
1525 (((
1526 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.
1527 )))
1528
1529
1530
1531 = 11. Support =
1532
1533
1534 * (((
1535 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.
1536 )))
1537 * (((
1538 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]].
1539 )))