<
From version < 57.3 >
edited by Xiaoling
on 2022/06/06 08:41
To version < 59.2 >
edited by Xiaoling
on 2022/06/06 14:20
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -6,12 +6,18 @@
6 6  **RS485-LN – RS485 to LoRaWAN Converter User Manual**
7 7  
8 8  
9 +
10 +
9 9  **Table of Contents:**
10 10  
13 +{{toc/}}
11 11  
12 12  
13 13  
14 14  
18 +
19 +
20 +
15 15  = 1.Introduction =
16 16  
17 17  == 1.1 What is RS485-LN RS485 to LoRaWAN Converter ==
... ... @@ -18,23 +18,33 @@
18 18  
19 19  (((
20 20  (((
27 +(((
21 21  The Dragino RS485-LN is a (% style="color:blue" %)**RS485 to LoRaWAN Converter**(%%). It converts the RS485 signal into LoRaWAN wireless signal which simplify the IoT installation and reduce the installation/maintaining cost.
22 22  )))
30 +)))
23 23  
24 24  (((
33 +(((
25 25  RS485-LN allows user to (% style="color:blue" %)**monitor / control RS485 devices**(%%) and reach extremely long ranges. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. It targets professional wireless sensor network applications such as irrigation systems, smart metering, smart cities, smartphone detection, building automation, and so on.
26 26  )))
36 +)))
27 27  
28 28  (((
39 +(((
29 29  (% 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.
30 30  )))
42 +)))
31 31  
32 32  (((
45 +(((
33 33  (% style="color:blue" %)**For data downlink**(%%), RS485-LN runs in LoRaWAN Class C. When there downlink commands from LoRaWAN server, RS485-LN will forward the commands from LoRaWAN server to RS485 devices.
47 +)))
34 34  
49 +(((
35 35  (% style="color:blue" %)**Demo Dashboard for RS485-LN**(%%) connect to two energy meters: [[https:~~/~~/app.datacake.de/dashboard/d/58844a26-378d-4c5a-aaf5-b5b5b153447a>>url:https://app.datacake.de/dashboard/d/58844a26-378d-4c5a-aaf5-b5b5b153447a]]
36 36  )))
37 37  )))
53 +)))
38 38  
39 39  [[image:1653267211009-519.png||height="419" width="724"]]
40 40  
... ... @@ -89,8 +89,6 @@
89 89  * Support Modbus protocol
90 90  * Support Interrupt uplink (Since hardware version v1.2)
91 91  
92 -
93 -
94 94  == 1.4 Applications ==
95 95  
96 96  * Smart Buildings & Home Automation
... ... @@ -109,9 +109,13 @@
109 109  
110 110  (((
111 111  (((
126 +(((
112 112  v1.2: Add External Interrupt Pin.
128 +)))
113 113  
130 +(((
114 114  v1.0: Release
132 +)))
115 115  
116 116  
117 117  )))
... ... @@ -139,7 +139,9 @@
139 139  == 3.1 How it works? ==
140 140  
141 141  (((
160 +(((
142 142  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.
162 +)))
143 143  
144 144  
145 145  )))
... ... @@ -163,7 +163,7 @@
163 163  [[image:1653268227651-549.png||height="592" width="720"]]
164 164  
165 165  (((
166 -The LG308 is already set to connect to [[TTN V3 network >>path:eu1.cloud.thethings.network/]]. So what we need to now is only configure the TTN V3:
186 +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:
167 167  )))
168 168  
169 169  (((
... ... @@ -215,11 +215,15 @@
215 215  
216 216  (((
217 217  (((
218 -There are plenty of RS485 devices in the market and each device has different command to read the valid data. To support these devices in flexible, RS485-LN supports flexible command set. User can use [[AT Commands>>path:#AT_COMMAND]] or LoRaWAN Downlink Command to configure what commands RS485-LN should send for each sampling and how to handle the return from RS485 devices.
238 +(((
239 +There are plenty of RS485 devices in the market and each device has different command to read the valid data. To support these devices in flexible, RS485-LN supports flexible command set. User can use [[AT Commands>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]] or LoRaWAN Downlink Command to configure what commands RS485-LN should send for each sampling and how to handle the return from RS485 devices.
219 219  )))
241 +)))
220 220  
221 221  (((
244 +(((
222 222  (% 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
246 +)))
223 223  
224 224  
225 225  )))
... ... @@ -229,19 +229,19 @@
229 229  
230 230  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:
231 231  
232 -(% border="1" style="background-color:#ffffcc; color:green; width:782px" %)
233 -|(% style="width:128px" %)(((
256 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
257 +|=(% style="width: 110px;" %)(((
234 234  **AT Commands**
235 -)))|(% style="width:305px" %)(((
259 +)))|=(% style="width: 190px;" %)(((
236 236  **Description**
237 -)))|(% style="width:346px" %)(((
261 +)))|=(% style="width: 190px;" %)(((
238 238  **Example**
239 239  )))
240 -|(% style="width:128px" %)(((
264 +|(% style="width:110px" %)(((
241 241  AT+BAUDR
242 -)))|(% style="width:305px" %)(((
266 +)))|(% style="width:190px" %)(((
243 243  Set the baud rate (for RS485 connection). Default Value is: 9600.
244 -)))|(% style="width:346px" %)(((
268 +)))|(% style="width:190px" %)(((
245 245  (((
246 246  AT+BAUDR=9600
247 247  )))
... ... @@ -250,11 +250,11 @@
250 250  Options: (1200,2400,4800,14400,19200,115200)
251 251  )))
252 252  )))
253 -|(% style="width:128px" %)(((
277 +|(% style="width:110px" %)(((
254 254  AT+PARITY
255 -)))|(% style="width:305px" %)(((
279 +)))|(% style="width:190px" %)(((
256 256  Set UART parity (for RS485 connection)
257 -)))|(% style="width:346px" %)(((
281 +)))|(% style="width:190px" %)(((
258 258  (((
259 259  AT+PARITY=0
260 260  )))
... ... @@ -263,9 +263,9 @@
263 263  Option: 0: no parity, 1: odd parity, 2: even parity
264 264  )))
265 265  )))
266 -|(% style="width:128px" %)(((
290 +|(% style="width:110px" %)(((
267 267  AT+STOPBIT
268 -)))|(% style="width:305px" %)(((
292 +)))|(% style="width:190px" %)(((
269 269  (((
270 270  Set serial stopbit (for RS485 connection)
271 271  )))
... ... @@ -273,7 +273,7 @@
273 273  (((
274 274  
275 275  )))
276 -)))|(% style="width:346px" %)(((
300 +)))|(% style="width:190px" %)(((
277 277  (((
278 278  AT+STOPBIT=0 for 1bit
279 279  )))
... ... @@ -295,15 +295,21 @@
295 295  )))
296 296  )))
297 297  
298 -(% border="1" style="background-color:#ffffcc; color:green; width:806px" %)
299 -|**AT Commands**|(% style="width:418px" %)**Description**|(% style="width:256px" %)**Example**
300 -|AT+CFGDEV|(% style="width:418px" %)(((
322 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
323 +|=(% style="width: 110px;" %)**AT Commands**|=(% style="width: 190px;" %)**Description**|=(% style="width: 190px;" %)**Example**
324 +|AT+CFGDEV|(% style="width:110px" %)(((
325 +(((
301 301  This command is used to configure the RS485/TTL devices; they won’t be used during sampling.
327 +)))
302 302  
329 +(((
303 303  AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,
331 +)))
304 304  
333 +(((
305 305  mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
306 -)))|(% style="width:256px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
335 +)))
336 +)))|(% style="width:190px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
307 307  
308 308  === 3.3.3 Configure read commands for each sampling ===
309 309  
... ... @@ -350,8 +350,8 @@
350 350  
351 351  **AT+DATACUTx : **This command defines how to handle the return from AT+COMMANDx, max return length is 45 bytes.
352 352  
353 -(% border="1" style="background-color:#4bacc6; color:white; width:725px" %)
354 -|(% style="width:722px" %)(((
383 +(% border="1" style="background-color:#4bacc6; color:white; width:510px" %)
384 +|(% style="width:510px" %)(((
355 355  **AT+DATACUTx=a,b,c**
356 356  
357 357  * **a: length for the return of AT+COMMAND**
... ... @@ -420,6 +420,7 @@
420 420  
421 421  (% style="color:#4f81bd" %)**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
422 422  
453 +
423 423  1. PAYVER: Defined by AT+PAYVER
424 424  1. PAYLOAD COUNT: Total how many uplinks of this sampling.
425 425  1. PAYLOAD#: Number of this uplink. (from 0,1,2,3…,to PAYLOAD COUNT)
... ... @@ -476,33 +476,35 @@
476 476  
477 477  == 3.4 Uplink Payload ==
478 478  
479 -(% border="1" style="background-color:#4bacc6; color:white; width:734px" %)
480 -|**Size(bytes)**|(% style="width:120px" %)**2**|(% style="width:116px" %)**1**|(% style="width:386px" %)**Length depends on the return from the commands**
481 -|Value|(% style="width:120px" %)(((
482 -Battery(mV)
483 483  
484 -&
511 +[[image:image-20220606110929-1.png]]
485 485  
486 -Interrupt _Flag
487 -)))|(% style="width:116px" %)(((
488 -PAYLOAD_VER
489 -
490 -
491 -)))|(% style="width:386px" %)If the valid payload is too long and exceed the maximum support payload length in server, server will show payload not provided in the LoRaWAN server.
492 -
493 493  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
494 494  
495 495  
496 496  == 3.5 Configure RS485-BL via AT or Downlink ==
497 497  
518 +(((
498 498  User can configure RS485-LN via AT Commands or LoRaWAN Downlink Commands
520 +)))
499 499  
522 +(((
500 500  There are two kinds of Commands:
524 +)))
501 501  
502 -* (% 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: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
526 +* (((
527 +(% 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]]
528 +)))
503 503  
504 -* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-LN.  User can see these commands below:
530 +* (((
531 +(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-LN.  User can see these commands below:
532 +)))
505 505  
534 +(((
535 +
536 +)))
537 +
538 +
506 506  === 3.5.1 Common Commands ===
507 507  
508 508  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]]
... ... @@ -519,144 +519,284 @@
519 519  
520 520  === 3.5.3 Sensor related commands ===
521 521  
522 -==== ====
523 523  
556 +
557 +
524 524  ==== **RS485 Debug Command** ====
525 525  
560 +(((
526 526  This command is used to configure the RS485 devices; they won’t be used during sampling.
562 +)))
527 527  
528 -* **AT Command**
564 +* (((
565 +**AT Command**
566 +)))
529 529  
530 530  (% class="box infomessage" %)
531 531  (((
570 +(((
532 532  **AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
533 533  )))
573 +)))
534 534  
575 +(((
535 535  m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
577 +)))
536 536  
537 -* **Downlink Payload**
579 +* (((
580 +**Downlink Payload**
581 +)))
538 538  
583 +(((
539 539  Format: A8 MM NN XX XX XX XX YY
585 +)))
540 540  
587 +(((
541 541  Where:
589 +)))
542 542  
543 -* MM: 1: add CRC-16/MODBUS ; 0: no CRC
544 -* NN: The length of RS485 command
545 -* XX XX XX XX: RS485 command total NN bytes
546 -* YY: How many bytes will be uplink from the return of this RS485 command,
547 -** if YY=0, RS485-LN will execute the downlink command without uplink;
548 -** if YY>0, RS485-LN will uplink total YY bytes from the output of this RS485 command; Fport=200
549 -** if YY=FF, RS485-LN will uplink RS485 output with the downlink command content; Fport=200.
591 +* (((
592 +MM: 1: add CRC-16/MODBUS ; 0: no CRC
593 +)))
594 +* (((
595 +NN: The length of RS485 command
596 +)))
597 +* (((
598 +XX XX XX XX: RS485 command total NN bytes
599 +)))
600 +* (((
601 +(((
602 +YY: How many bytes will be uplink from the return of this RS485 command,
603 +)))
550 550  
605 +* (((
606 +if YY=0, RS485-LN will execute the downlink command without uplink;
607 +)))
608 +* (((
609 +if YY>0, RS485-LN will uplink total YY bytes from the output of this RS485 command; Fport=200
610 +)))
611 +* (((
612 +if YY=FF, RS485-LN will uplink RS485 output with the downlink command content; Fport=200.
613 +)))
614 +)))
615 +
616 +(((
551 551  **Example 1** ~-~-> Configure without ask for uplink (YY=0)
618 +)))
552 552  
620 +(((
553 553  To connect a Modbus Alarm with below commands.
622 +)))
554 554  
555 -* 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.
624 +* (((
625 +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.
626 +)))
556 556  
557 -* 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.
628 +* (((
629 +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.
630 +)))
558 558  
632 +(((
559 559  So if user want to use downlink command to control to RS485 Alarm, he can use:
634 +)))
560 560  
636 +(((
561 561  (% style="color:#4f81bd" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
638 +)))
562 562  
640 +(((
563 563  (% style="color:#4f81bd" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
642 +)))
564 564  
644 +(((
565 565  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.
646 +)))
566 566  
648 +(((
649 +
650 +)))
567 567  
652 +(((
568 568  **Example 2** ~-~-> Configure with requesting uplink and original downlink command (**YY=FF**)
654 +)))
569 569  
656 +(((
570 570  User in IoT server send a downlink command: (% style="color:#4f81bd" %)**A8 01 06 0A 08 00 04 00 01 YY**
658 +)))
571 571  
660 +(((
661 +
662 +)))
572 572  
664 +(((
573 573  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:
666 +)))
574 574  
668 +(((
575 575   **A8** (% style="color:#4f81bd" %)**0A 08 00 04 00  **(% style="color:red" %)**01 06** ** **(% style="color:green" %)**0A 08 00 04 00 00**
670 +)))
576 576  
672 +(((
577 577   [[image:1654159460680-153.png]]
674 +)))
578 578  
579 579  
580 580  
678 +
581 581  ==== **Set Payload version** ====
582 582  
681 +(((
583 583  This is the first byte of the uplink payload. RS485-BL can connect to different sensors. User can set the PAYVER field to tell server how to decode the current payload.
683 +)))
584 584  
585 -* **AT Command:**
685 +* (((
686 +**AT Command:**
687 +)))
586 586  
587 587  (% class="box infomessage" %)
588 588  (((
691 +(((
589 589  **AT+PAYVER: Set PAYVER field = 1**
590 590  )))
694 +)))
591 591  
592 -* **Downlink Payload:**
696 +* (((
697 +**Downlink Payload:**
698 +)))
593 593  
700 +(((
594 594  **0xAE 01**  ~-~-> Set PAYVER field =  0x01
702 +)))
595 595  
704 +(((
596 596  **0xAE 0F**   ~-~-> Set PAYVER field =  0x0F
706 +)))
597 597  
598 598  
599 599  
710 +
600 600  ==== **Set RS485 Sampling Commands** ====
601 601  
713 +(((
602 602  AT+COMMANDx or AT+DATACUTx
715 +)))
603 603  
717 +(((
604 604  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"]].
719 +)))
605 605  
721 +(((
722 +
723 +)))
606 606  
607 -* **AT Command:**
725 +* (((
726 +**AT Command:**
727 +)))
608 608  
609 609  (% class="box infomessage" %)
610 610  (((
731 +(((
611 611  **AT+COMMANDx: Configure RS485 read command to sensor.**
612 612  )))
734 +)))
613 613  
614 614  (% class="box infomessage" %)
615 615  (((
738 +(((
616 616  **AT+DATACUTx: Configure how to handle return from RS485 devices.**
617 617  )))
741 +)))
618 618  
743 +(((
744 +
745 +)))
619 619  
620 -* **Downlink Payload:**
747 +* (((
748 +**Downlink Payload:**
749 +)))
621 621  
751 +(((
622 622  **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
753 +)))
623 623  
755 +(((
624 624  (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
757 +)))
625 625  
759 +(((
626 626  Format: AF MM NN LL XX XX XX XX YY
761 +)))
627 627  
763 +(((
628 628  Where:
765 +)))
629 629  
630 -* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
631 -* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
632 -* LL:  The length of AT+COMMAND or AT+DATACUT command
633 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command
634 -* YY:  If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command.
767 +* (((
768 +MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
769 +)))
770 +* (((
771 +NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
772 +)))
773 +* (((
774 +LL:  The length of AT+COMMAND or AT+DATACUT command
775 +)))
776 +* (((
777 +XX XX XX XX: AT+COMMAND or AT+DATACUT command
778 +)))
779 +* (((
780 +YY:  If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command.
781 +)))
635 635  
783 +(((
636 636  **Example:**
785 +)))
637 637  
787 +(((
638 638  (% 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
789 +)))
639 639  
791 +(((
640 640  (% 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**
793 +)))
641 641  
795 +(((
642 642  (% 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**
797 +)))
643 643  
644 644  
645 645  
801 +
646 646  ==== **Fast command to handle MODBUS device** ====
647 647  
804 +(((
648 648  AT+MBFUN is valid since v1.3 firmware version. The command is for fast configure to read Modbus devices. It is only valid for the devices which follow the [[MODBUS-RTU protocol>>url:https://www.modbustools.com/modbus.html]].
806 +)))
649 649  
808 +(((
650 650  This command is valid since v1.3 firmware version
810 +)))
651 651  
812 +(((
652 652  AT+MBFUN can auto read the Modbus function code: 01, 02, 03 or 04. AT+MBFUN has lower priority vs AT+DATACUT command. If AT+DATACUT command is configured, AT+MBFUN will be ignore.
814 +)))
653 653  
816 +(((
817 +
818 +)))
654 654  
820 +(((
655 655  **Example:**
822 +)))
656 656  
657 -* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). So RS485-LN.
658 -* 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.
659 -* AT+COMMAND2= 01 02 00 40 00 10,1 ~-~-> read slave address 01 , function code 02, start address 00 40, quantity of inputs 00 10.
824 +* (((
825 +AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). So RS485-LN.
826 +)))
827 +* (((
828 +AT+COMMAND1= 01 03 00 10 00 08,1 ~-~-> read slave address 01 , function code 03, start address 00 01, quantity of registers 00 08.
829 +)))
830 +* (((
831 +AT+COMMAND2= 01 02 00 40 00 10,1 ~-~-> read slave address 01 , function code 02, start address 00 40, quantity of inputs 00 10.
832 +)))
660 660  
661 661  [[image:image-20220602165351-6.png]]
662 662  
... ... @@ -664,201 +664,374 @@
664 664  
665 665  
666 666  
840 +
667 667  ==== **RS485 command timeout** ====
668 668  
843 +(((
669 669  Some Modbus device has slow action to send replies. This command is used to configure the RS485-LN to use longer time to wait for their action.
845 +)))
670 670  
847 +(((
671 671  Default value: 0, range:  0 ~~ 65 seconds
849 +)))
672 672  
673 -* **AT Command:**
851 +* (((
852 +**AT Command:**
853 +)))
674 674  
675 675  (% class="box infomessage" %)
676 676  (((
857 +(((
677 677  **AT+CMDDLaa=hex(bb cc)*1000**
678 678  )))
860 +)))
679 679  
862 +(((
680 680  **Example:**
864 +)))
681 681  
866 +(((
682 682  **AT+CMDDL1=1000** to send the open time to 1000ms
868 +)))
683 683  
870 +(((
871 +
872 +)))
684 684  
685 -* **Downlink Payload:**
874 +* (((
875 +**Downlink Payload:**
876 +)))
686 686  
878 +(((
687 687  **0x AA aa bb cc**
880 +)))
688 688  
882 +(((
689 689  Same as: AT+CMDDLaa=hex(bb cc)*1000
884 +)))
690 690  
886 +(((
691 691   **Example:**
888 +)))
692 692  
890 +(((
693 693   0xAA 01 00 01  ~-~-> Same as **AT+CMDDL1=1000 ms**
892 +)))
694 694  
695 695  
696 696  
896 +
697 697  ==== **Uplink payload mode** ====
698 698  
899 +(((
699 699  Define to use one uplink or multiple uplinks for the sampling.
901 +)))
700 700  
903 +(((
701 701  The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
905 +)))
702 702  
703 -* **AT Command:**
907 +* (((
908 +**AT Command:**
909 +)))
704 704  
705 705  (% class="box infomessage" %)
706 706  (((
913 +(((
707 707  **AT+DATAUP=0**
708 708  )))
916 +)))
709 709  
710 710  (% class="box infomessage" %)
711 711  (((
920 +(((
712 712  **AT+DATAUP=1**
713 713  )))
923 +)))
714 714  
925 +(((
926 +
927 +)))
715 715  
716 -* **Downlink Payload:**
929 +* (((
930 +**Downlink Payload:**
931 +)))
717 717  
933 +(((
718 718  **0xAD 00**  **~-~->** Same as AT+DATAUP=0
935 +)))
719 719  
937 +(((
720 720  **0xAD 01**  **~-~->** Same as AT+DATAUP=1
939 +)))
721 721  
722 722  
723 723  
943 +
724 724  ==== **Manually trigger an Uplink** ====
725 725  
946 +(((
726 726  Ask device to send an uplink immediately.
948 +)))
727 727  
728 -* **AT Command:**
950 +* (((
951 +**AT Command:**
952 +)))
729 729  
730 -No AT Command for this, user can press the [[ACT button>>path:#Button]] for 1 second for the same.
954 +(((
955 +No AT Command for this, user can press the [[ACT button>>||anchor="H3.7Buttons"]] for 1 second for the same.
956 +)))
731 731  
958 +(((
959 +
960 +)))
732 732  
733 -* **Downlink Payload:**
962 +* (((
963 +**Downlink Payload:**
964 +)))
734 734  
966 +(((
735 735  **0x08 FF**, RS485-LN will immediately send an uplink.
968 +)))
736 736  
737 737  
738 -==== ====
739 739  
972 +
740 740  ==== **Clear RS485 Command** ====
741 741  
975 +(((
742 742  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
977 +)))
743 743  
744 -* **AT Command:**
979 +* (((
980 +**AT Command:**
981 +)))
745 745  
983 +(((
746 746  **AT+CMDEAR=mm,nn**   mm: start position of erase ,nn: stop position of erase
985 +)))
747 747  
987 +(((
748 748  Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
989 +)))
749 749  
991 +(((
750 750  Example screen shot after clear all RS485 commands. 
993 +)))
751 751  
995 +(((
996 +
997 +)))
752 752  
999 +(((
753 753  The uplink screen shot is:
1001 +)))
754 754  
755 -[[image:1654160691922-496.png]][[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]
1003 +[[image:1654160691922-496.png]]
756 756  
757 757  
758 -* **Downlink Payload:**
1006 +* (((
1007 +**Downlink Payload:**
1008 +)))
759 759  
1010 +(((
760 760  **0x09 aa bb** same as AT+CMDEAR=aa,bb
1012 +)))
761 761  
762 762  
763 763  
1016 +
764 764  ==== **Set Serial Communication Parameters** ====
765 765  
1019 +(((
766 766  Set the Rs485 serial communication parameters:
1021 +)))
767 767  
768 -* **AT Command:**
1023 +* (((
1024 +**AT Command:**
1025 +)))
769 769  
1027 +(((
770 770  Set Baud Rate:
1029 +)))
771 771  
772 772  (% class="box infomessage" %)
773 773  (((
1033 +(((
774 774  **AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
775 775  )))
1036 +)))
776 776  
1038 +(((
777 777  Set UART Parity
1040 +)))
778 778  
779 779  (% class="box infomessage" %)
780 780  (((
1044 +(((
781 781  **AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
782 782  )))
1047 +)))
783 783  
1049 +(((
784 784  Set STOPBIT
1051 +)))
785 785  
786 786  (% class="box infomessage" %)
787 787  (((
1055 +(((
788 788  **AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
789 789  )))
1058 +)))
790 790  
1060 +(((
1061 +
1062 +)))
791 791  
792 -* **Downlink Payload:**
1064 +* (((
1065 +**Downlink Payload:**
1066 +)))
793 793  
1068 +(((
794 794  **A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
1070 +)))
795 795  
1072 +(((
796 796  **Example:**
1074 +)))
797 797  
798 -* A7 01 00 60   same as AT+BAUDR=9600
799 -* A7 01 04 80  same as AT+BAUDR=115200
1076 +* (((
1077 +A7 01 00 60   same as AT+BAUDR=9600
1078 +)))
1079 +* (((
1080 +A7 01 04 80  same as AT+BAUDR=115200
1081 +)))
800 800  
1083 +(((
801 801  A7 02 aa: Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
1085 +)))
802 802  
1087 +(((
803 803  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1089 +)))
804 804  
805 805  
1092 +
1093 +
806 806  == 3.6 Listening mode for RS485 network ==
807 807  
1096 +(((
808 808  This feature support since firmware v1.4
1098 +)))
809 809  
1100 +(((
810 810  RS485-LN supports listening mode, it can listen the RS485 network packets and send them via LoRaWAN uplink. Below is the structure. The blue arrow shows the RS485 network packets to RS485-LN.
1102 +)))
811 811  
812 812  [[image:image-20220602171200-8.png||height="567" width="1007"]]
813 813  
1106 +(((
814 814  To enable the listening mode, use can run the command AT+RXMODE.
1108 +)))
815 815  
1110 +(((
1111 +
1112 +)))
816 816  
817 -(% border="1" style="background-color:#ffffcc; width:500px" %)
818 -|=(% style="width: 161px;" %)**Command example:**|=(% style="width: 337px;" %)**Function**
819 -|(% style="width:161px" %)AT+RXMODE=1,10 |(% style="width:337px" %)Enable listening mode 1, if RS485-LN has received more than 10 RS485 commands from the network. RS485-LN will send these commands via LoRaWAN uplinks.
820 -|(% style="width:161px" %)AT+RXMODE=2,500|(% style="width:337px" %)Enable listening mode 2, RS485-LN will capture and send a 500ms content once from the first detect of character. Max value is 65535 ms
821 -|(% style="width:161px" %)AT+RXMODE=0,0|(% style="width:337px" %)Disable listening mode. This is the default settings.
822 -|(% style="width:161px" %) |(% style="width:337px" %)A6 aa bb cc  same as AT+RXMODE=aa,(bb<<8 ~| cc)
1114 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
1115 +|=(% style="width: 100px;" %)(((
1116 +**Command example**
1117 +)))|=(% style="width: 400px;" %)(((
1118 +**Function**
1119 +)))
1120 +|(% style="width:100px" %)(((
1121 +AT+RXMODE=1,10
1122 +)))|(% style="width:400px" %)(((
1123 +Enable listening mode 1, if RS485-LN has received more than 10 RS485 commands from the network. RS485-LN will send these commands via LoRaWAN uplinks.
1124 +)))
1125 +|(% style="width:100px" %)(((
1126 +AT+RXMODE=2,500
1127 +)))|(% style="width:400px" %)(((
1128 +Enable listening mode 2, RS485-LN will capture and send a 500ms content once from the first detect of character. Max value is 65535 ms
1129 +)))
1130 +|(% style="width:100px" %)(((
1131 +AT+RXMODE=0,0
1132 +)))|(% style="width:400px" %)(((
1133 +Disable listening mode. This is the default settings.
1134 +)))
1135 +|(% style="width:100px" %)(((
1136 +
1137 +)))|(% style="width:400px" %)(((
1138 +A6 aa bb cc  same as AT+RXMODE=aa,(bb<<8 | cc)
1139 +)))
823 823  
1141 +(((
824 824  **Downlink Command:**
1143 +)))
825 825  
1145 +(((
826 826  **0xA6 aa bb cc ** same as AT+RXMODE=aa,(bb<<8 | cc)
1147 +)))
827 827  
1149 +(((
1150 +
1151 +)))
828 828  
1153 +(((
829 829  **Example**:
1155 +)))
830 830  
1157 +(((
831 831  The RS485-LN is set to AT+RXMODE=2,1000
1159 +)))
832 832  
1161 +(((
833 833  There is a two Modbus commands in the RS485 network as below:
1163 +)))
834 834  
1165 +(((
835 835  The Modbus master send a command: (% style="background-color:#ffc000" %)01 03 00 00 00 02 c4 0b
1167 +)))
836 836  
1169 +(((
837 837  And Modbus slave reply with: (% style="background-color:green" %)01 03 04 00 00 00 00 fa 33
1171 +)))
838 838  
1173 +(((
839 839  RS485-LN will capture both and send the uplink: (% style="background-color:#ffc000" %)01 03 00 00 00 02 c4 0b  (% style="background-color:green" %)01 03 04 00 00 00 00 fa 33
1175 +)))
840 840  
1177 +(((
841 841  [[image:image-20220602171200-9.png]]
1179 +)))
842 842  
1181 +(((
1182 +
1183 +)))
843 843  
1185 +(((
1186 +(((
844 844  (% style="color:red" %)Notice: Listening mode can work with the default polling mode of RS485-LN. When RS485-LN is in to send the RS485 commands (from AT+COMMANDx), the listening mode will be interrupt for a while.
1188 +)))
1189 +)))
845 845  
846 846  
847 847  == 3.7 Buttons ==
848 848  
849 849  
850 -(% border="1" style="background-color:#f7faff; width:500px" %)
851 -|=**Button**|=(% style="width: 1420px;" %)**Feature**
852 -|**ACT**|(% style="width:1420px" %)If RS485 joined in network, press this button for more than 1 second, RS485 will upload a packet, and the SYS LED will give a (% style="color:blue" %)**Blue blink**
853 -|**RST**|(% style="width:1420px" %)Reboot RS485
854 -|**PRO**|(% style="width:1420px" %)Use for upload image, see [[How to Update Image>>path:#upgrade_image]]
1195 +(% border="1" cellspacing="10" style="background-color:#f7faff; width:400px" %)
1196 +|=(% style="width: 50px;" %)**Button**|=(% style="width: 350px;" %)**Feature**
1197 +|(% style="width:50px" %)**ACT**|(% style="width:350px" %)If RS485 joined in network, press this button for more than 1 second, RS485 will upload a packet, and the SYS LED will give a (% style="color:blue" %)**Blue blink**
1198 +|(% style="width:50px" %)**RST**|(% style="width:350px" %)Reboot RS485
1199 +|(% style="width:50px" %)**PRO**|(% style="width:350px" %)Use for upload image, see [[How to Update Image>>||anchor="H6.1Howtoupgradetheimage3F"]]
855 855  
856 856  == 3.8 LEDs ==
857 857  
858 -(% border="1" style="background-color:#f7faff; width:500px" %)
859 -|=**LEDs**|=**Feature**
1203 +
1204 +(% border="1" cellspacing="10" style="background-color:#f7faff; width:430px" %)
1205 +|=(% style="width: 50px;" %)**LEDs**|=(% style="width: 380px;" %)**Feature**
860 860  |**PWR**|Always on if there is power
861 -|**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.
1207 +|**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.
862 862  
863 863  = 4. Case Study =
864 864  
... ... @@ -869,19 +869,26 @@
869 869  
870 870  == 5.1 Access AT Command ==
871 871  
1218 +(((
872 872  RS485-BL supports AT Command set. User can use a USB to TTL adapter plus the 3.5mm Program Cable to connect to RS485-BL to use AT command, as below.
1220 +)))
873 873  
874 874  [[image:1654162355560-817.png]]
875 875  
876 876  
1225 +(((
877 877  In PC, User needs to set (% style="color:blue" %)**serial tool**(%%)(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to (% style="color:green" %)**9600**(%%) to access to access serial console of RS485-BL. The default password is 123456. Below is the output for reference:
1227 +)))
878 878  
879 879  [[image:1654162368066-342.png]]
880 880  
881 881  
882 -More detail AT Command manual can be found at [[AT Command Manual>>||anchor="3.5ConfigureRS485-BLviaATorDownlink"]]
1232 +(((
1233 +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/]]
1234 +)))
883 883  
884 884  
1237 +
885 885  == 5.2 Common AT Command Sequence ==
886 886  
887 887  === 5.2.1 Multi-channel ABP mode (Use with SX1301/LG308) ===
... ... @@ -904,7 +904,9 @@
904 904  )))
905 905  
906 906  
1260 +(((
907 907  If device already joined network:
1262 +)))
908 908  
909 909  (% class="box infomessage" %)
910 910  (((
... ... @@ -943,10 +943,12 @@
943 943  
944 944  (% style="color:red" %)**Note:**
945 945  
1301 +(((
946 946  (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server.
947 947  2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
948 948  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.
949 949  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
1306 +)))
950 950  
951 951  [[image:1654162478620-421.png]]
952 952  
... ... @@ -955,23 +955,45 @@
955 955  
956 956  == 6.1 How to upgrade the image? ==
957 957  
1315 +(((
958 958  The RS485-LN LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-LN to:
1317 +)))
959 959  
960 -* Support new features
961 -* For bug fix
962 -* Change LoRaWAN bands.
1319 +* (((
1320 +Support new features
1321 +)))
1322 +* (((
1323 +For bug fix
1324 +)))
1325 +* (((
1326 +Change LoRaWAN bands.
1327 +)))
963 963  
1329 +(((
964 964  Below shows the hardware connection for how to upload an image to RS485-LN:
1331 +)))
965 965  
966 966  [[image:1654162535040-878.png]]
967 967  
1335 +(((
968 968  **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]].
1337 +)))
969 969  
1339 +(((
970 970  **Step2**: Download the [[LT Image files>>url:http://www.dragino.com/downloads/index.php?dir=LT_LoRa_IO_Controller/LT33222-L/image/]].
1341 +)))
971 971  
1343 +(((
972 972  **Step3: **Open flashloader; choose the correct COM port to update.
1345 +)))
973 973  
1347 +(((
1348 +(((
1349 +(((
974 974  (% 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.
1351 +)))
1352 +)))
1353 +)))
975 975  
976 976  
977 977  [[image:image-20220602175818-12.png]]
... ... @@ -1052,30 +1052,60 @@
1052 1052  
1053 1053  = 10. FCC Caution for RS485LN-US915 =
1054 1054  
1434 +(((
1055 1055  Any Changes or modifications not expressly approved by the party responsible for compliance could void the user's authority to operate the equipment.
1436 +)))
1056 1056  
1438 +(((
1057 1057  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.
1440 +)))
1058 1058  
1442 +(((
1443 +
1444 +)))
1059 1059  
1446 +(((
1060 1060  **IMPORTANT NOTE:**
1448 +)))
1061 1061  
1450 +(((
1062 1062  **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:
1452 +)))
1063 1063  
1454 +(((
1064 1064  —Reorient or relocate the receiving antenna.
1456 +)))
1065 1065  
1458 +(((
1066 1066  —Increase the separation between the equipment and receiver.
1460 +)))
1067 1067  
1462 +(((
1068 1068  —Connect the equipment into an outlet on a circuit different from that to which the receiver is connected.
1464 +)))
1069 1069  
1466 +(((
1070 1070  —Consult the dealer or an experienced radio/TV technician for help.
1468 +)))
1071 1071  
1470 +(((
1471 +
1472 +)))
1072 1072  
1474 +(((
1073 1073  **FCC Radiation Exposure Statement:**
1476 +)))
1074 1074  
1478 +(((
1075 1075  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.
1480 +)))
1076 1076  
1077 1077  
1078 1078  = 11. Support =
1079 1079  
1080 -* 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.
1081 -* 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]].
1485 +* (((
1486 +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.
1487 +)))
1488 +* (((
1489 +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]].
1490 +)))
image-20220606110929-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +13.9 KB
Content
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0