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

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0