Skip to Content
Last modified by Xiaoling on 2025/04/23 15:57
From version 40.52
edited by Xiaoling
on 2022/06/06 10:50
Change comment: There is no comment for this version
To version 44.11
edited by Xiaoling
on 2022/06/14 10:05
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,13 +1,9 @@
1 1  (% style="text-align:center" %)
2 -[[image:1652947681187-144.png||height="385" width="385"]]
2 +[[image:1652947681187-144.png||height="404" width="404"]]
3 3  
4 4  
5 5  
6 6  
7 -**RS485-BL – Waterproof RS485 to LoRaWAN Converter User Manual**
8 -
9 -
10 -
11 11  **Table of Contents:**
12 12  
13 13  {{toc/}}
... ... @@ -67,6 +67,7 @@
67 67  ** Idle: 6uA@3.3v
68 68  ** 20dB Transmit: 130mA@3.3v
69 69  
66 +
70 70  **Interface for Model:**
71 71  
72 72  * 1 x RS485 Interface
... ... @@ -76,6 +76,7 @@
76 76  * 1 x Interrupt Interface
77 77  * 1 x Controllable 5V output, max
78 78  
76 +
79 79  **LoRa Spec:**
80 80  
81 81  * Frequency Range:
... ... @@ -94,6 +94,9 @@
94 94  * 127 dB Dynamic Range RSSI.
95 95  * Automatic RF Sense and CAD with ultra-fast AFC. ​​​
96 96  
95 +
96 +
97 +
97 97  == 1.3 Features ==
98 98  
99 99  * LoRaWAN Class A & Class C protocol (default Class A)
... ... @@ -105,6 +105,9 @@
105 105  * Support Modbus protocol
106 106  * Support Interrupt uplink
107 107  
109 +
110 +
111 +
108 108  == 1.4 Applications ==
109 109  
110 110  * Smart Buildings & Home Automation
... ... @@ -114,6 +114,9 @@
114 114  * Smart Cities
115 115  * Smart Factory
116 116  
121 +
122 +
123 +
117 117  == 1.5 Firmware Change log ==
118 118  
119 119  [[RS485-BL Image files – Download link and Change log>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/RS485-BL/Firmware/||style="background-color: rgb(255, 255, 255);"]]
... ... @@ -197,6 +197,7 @@
197 197  
198 198  [[image:1652953414711-647.png||height="337" width="723"]]
199 199  
207 +
200 200  (((
201 201  The RS485-BL in this example connected to two RS485 devices for demonstration, user can connect to other RS485 devices via the same method.
202 202  )))
... ... @@ -206,7 +206,7 @@
206 206  )))
207 207  
208 208  (((
209 -**Step 1**: Create a device in TTN V3 with the OTAA keys from RS485-BL.
217 +**(% style="color:blue" %)Step 1**(%%): Create a device in TTN V3 with the OTAA keys from RS485-BL.
210 210  )))
211 211  
212 212  (((
... ... @@ -215,12 +215,13 @@
215 215  
216 216  [[image:1652953462722-299.png]]
217 217  
226 +
218 218  (((
219 219  User can enter this key in their LoRaWAN Server portal. Below is TTN V3 screen shot:
220 220  )))
221 221  
222 222  (((
223 -Add APP EUI in the application.
232 +**Add APP EUI in the application.**
224 224  )))
225 225  
226 226  
... ... @@ -232,17 +232,20 @@
232 232  
233 233  [[image:image-20220519174512-4.png]]
234 234  
244 +
235 235  You can also choose to create the device manually.
236 236  
237 237  [[image:1652953542269-423.png||height="710" width="723"]]
238 238  
249 +
239 239  Add APP KEY and DEV EUI
240 240  
241 241  [[image:1652953553383-907.png||height="514" width="724"]]
242 242  
243 243  
255 +
244 244  (((
245 -**Step 2**: Power on RS485-BL 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.
257 +**(% style="color:blue" %)Step 2**(%%): Power on RS485-BL 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.
246 246  )))
247 247  
248 248  [[image:1652953568895-172.png||height="232" width="724"]]
... ... @@ -283,28 +283,28 @@
283 283  )))
284 284  
285 285  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
286 -|=(% style="width: 120px;" %)(((
298 +|=(% style="width: 80px;" %)(((
287 287  (((
288 288  **AT Commands**
289 289  )))
290 -)))|=(% style="width: 190px;" %)(((
302 +)))|=(% style="width: 210px;" %)(((
291 291  (((
292 292  **Description**
293 293  )))
294 -)))|=(% style="width: 190px;" %)(((
306 +)))|=(% style="width: 210px;" %)(((
295 295  (((
296 296  **Example**
297 297  )))
298 298  )))
299 -|(% style="width:120px" %)(((
311 +|(% style="width:80px" %)(((
300 300  (((
301 301  AT+BAUDR
302 302  )))
303 -)))|(% style="width:190px" %)(((
315 +)))|(% style="width:210px" %)(((
304 304  (((
305 305  Set the baud rate (for RS485 connection). Default Value is: 9600.
306 306  )))
307 -)))|(% style="width:190px" %)(((
319 +)))|(% style="width:210px" %)(((
308 308  (((
309 309  (((
310 310  AT+BAUDR=9600
... ... @@ -317,11 +317,11 @@
317 317  )))
318 318  )))
319 319  )))
320 -|(% style="width:120px" %)(((
332 +|(% style="width:80px" %)(((
321 321  (((
322 322  AT+PARITY
323 323  )))
324 -)))|(% style="width:190px" %)(((
336 +)))|(% style="width:210px" %)(((
325 325  (((
326 326  (((
327 327  Set UART parity (for RS485 connection)
... ... @@ -333,7 +333,7 @@
333 333  Default Value is: no parity.
334 334  )))
335 335  )))
336 -)))|(% style="width:190px" %)(((
348 +)))|(% style="width:210px" %)(((
337 337  (((
338 338  (((
339 339  AT+PARITY=0
... ... @@ -346,11 +346,11 @@
346 346  )))
347 347  )))
348 348  )))
349 -|(% style="width:120px" %)(((
361 +|(% style="width:80px" %)(((
350 350  (((
351 351  AT+STOPBIT
352 352  )))
353 -)))|(% style="width:190px" %)(((
365 +)))|(% style="width:210px" %)(((
354 354  (((
355 355  (((
356 356  Set serial stopbit (for RS485 connection)
... ... @@ -362,7 +362,7 @@
362 362  Default Value is: 1bit.
363 363  )))
364 364  )))
365 -)))|(% style="width:190px" %)(((
377 +)))|(% style="width:210px" %)(((
366 366  (((
367 367  (((
368 368  AT+STOPBIT=0 for 1bit
... ... @@ -393,14 +393,20 @@
393 393  )))
394 394  
395 395  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
396 -|=(% style="width: 120px;" %)**AT Commands**|=(% style="width: 190px;" %)**Description**|=(% style="width: 190px;" %)**Example**
397 -|AT+CFGDEV|(% style="width:120px" %)(((
408 +|=(% style="width: 80px;" %)**AT Commands**|=(% style="width: 210px;" %)**Description**|=(% style="width: 210px;" %)**Example**
409 +|AT+CFGDEV|(% style="width:80px" %)(((
410 +(((
398 398  This command is used to configure the RS485/TTL devices; they won’t be used during sampling.
412 +)))
399 399  
414 +(((
400 400  AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,
416 +)))
401 401  
418 +(((
402 402  mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
403 -)))|(% style="width:190px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
420 +)))
421 +)))|(% style="width:210px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
404 404  
405 405  Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>||anchor="HRS485DebugCommand28AT2BCFGDEV29"]].
406 406  
... ... @@ -472,117 +472,213 @@
472 472  After we got the valid value from each RS485 commands, we need to combine them together with the command **AT+DATAUP**.
473 473  )))
474 474  
493 +(((
475 475  **Examples:**
495 +)))
476 476  
497 +(((
477 477  Below are examples for the how above AT Commands works.
499 +)))
478 478  
501 +(((
479 479  **AT+COMMANDx : **This command will be sent to RS485/TTL devices during each sampling, Max command length is 14 bytes. The grammar is:
503 +)))
480 480  
481 481  (% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:500px" %)
482 482  |(% style="width:498px" %)(((
507 +(((
483 483  **AT+COMMANDx=xx xx xx xx xx xx xx xx xx xx xx xx,m**
509 +)))
484 484  
511 +(((
485 485  **xx xx xx xx xx xx xx xx xx xx xx xx: The RS485 command to be sent**
513 +)))
486 486  
515 +(((
487 487  **m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command**
488 488  )))
518 +)))
489 489  
520 +(((
490 490  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.
522 +)))
491 491  
524 +(((
492 492  In the RS485-BL, we should use this command AT+COMMAND1=01 03 0B B8 00 02,1 for the same.
526 +)))
493 493  
528 +(((
529 +
530 +)))
531 +
532 +(((
494 494  **AT+SEARCHx**: This command defines how to handle the return from AT+COMMANDx.
534 +)))
495 495  
496 496  (% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:500px" %)
497 497  |(% style="width:577px" %)(((
538 +(((
498 498  **AT+SEARCHx=aa,xx xx xx xx xx**
540 +)))
499 499  
500 -* **aa: 1: prefix match mode; 2: prefix and suffix match mode**
501 -* **xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix**
542 +* (((
543 +**aa: 1: prefix match mode; 2: prefix and suffix match mode**
502 502  )))
545 +* (((
546 +**xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix**
547 +)))
548 +)))
503 503  
550 +(((
504 504  **Examples:**
552 +)))
505 505  
554 +(((
506 506  1）For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
556 +)))
507 507  
558 +(((
508 508  If we set AT+SEARCH1=1,1E 56 34.      (max 5 bytes for prefix)
560 +)))
509 509  
562 +(((
510 510  The valid data will be all bytes after 1E 56 34 , so it is (% style="background-color:yellow" %)**2e 30 58 5f 36 41 30 31 00 49**
564 +)))
511 511  
566 +(((
512 512  [[image:1653271044481-711.png]]
568 +)))
513 513  
570 +(((
514 514  2）For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
572 +)))
515 515  
574 +(((
516 516  If we set AT+SEARCH1=2, 1E 56 34+31 00 49
576 +)))
517 517  
578 +(((
518 518  Device will search the bytes between 1E 56 34 and 31 00 49. So it is(% style="background-color:yellow" %) **2e 30 58 5f 36 41 30**
580 +)))
519 519  
582 +(((
520 520  [[image:1653271276735-972.png]]
584 +)))
521 521  
586 +(((
522 522  **AT+DATACUTx : **This command defines how to handle the return from AT+COMMANDx, max return length is 45 bytes.
588 +)))
523 523  
524 524  (% style="background-color:#4f81bd; color:white; width:510px" %)
525 525  |(% style="width:726px" %)(((
592 +(((
526 526  **AT+DATACUTx=a,b,c**
594 +)))
527 527  
528 -* **a: length for the return of AT+COMMAND**
529 -* **b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
530 -* **c: define the position for valid value.  **
596 +* (((
597 +**a: length for the return of AT+COMMAND**
531 531  )))
599 +* (((
600 +**b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
601 +)))
602 +* (((
603 +**c: define the position for valid value.  **
604 +)))
605 +)))
532 532  
607 +(((
533 533  **Examples:**
609 +)))
534 534  
535 -* Grab bytes:
611 +* (((
612 +Grab bytes:
613 +)))
536 536  
615 +(((
537 537  [[image:1653271581490-837.png||height="313" width="722"]]
617 +)))
538 538  
619 +(((
620 +
621 +)))
539 539  
540 -* Grab a section.
623 +* (((
624 +Grab a section.
625 +)))
541 541  
627 +(((
542 542  [[image:1653271648378-342.png||height="326" width="720"]]
629 +)))
543 543  
631 +(((
632 +
633 +)))
544 544  
545 -* Grab different sections.
635 +* (((
636 +Grab different sections.
637 +)))
546 546  
639 +(((
547 547  [[image:1653271657255-576.png||height="305" width="730"]]
641 +)))
548 548  
549 549  (((
644 +(((
550 550  (% style="color:red" %)**Note:**
551 551  )))
647 +)))
552 552  
553 553  (((
650 +(((
554 554  AT+SEARCHx and AT+DATACUTx can be used together, if both commands are set, RS485-BL will first process AT+SEARCHx on the return string and get a temporary string, and then process AT+DATACUTx on this temporary string to get the final payload. In this case, AT+DATACUTx need to set to format AT+DATACUTx=0,xx,xx where the return bytes set to 0.
555 555  )))
653 +)))
556 556  
557 557  (((
656 +(((
558 558  **Example:**
559 559  )))
659 +)))
560 560  
561 561  (((
662 +(((
562 562  (% style="color:red" %)AT+COMMAND1=11 01 1E D0,0
563 563  )))
665 +)))
564 564  
565 565  (((
668 +(((
566 566  (% style="color:red" %)AT+SEARCH1=1,1E 56 34
567 567  )))
671 +)))
568 568  
569 569  (((
674 +(((
570 570  (% style="color:red" %)AT+DATACUT1=0,2,1~~5
571 571  )))
677 +)))
572 572  
573 573  (((
680 +(((
574 574  (% style="color:red" %)Return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
575 575  )))
683 +)))
576 576  
577 577  (((
686 +(((
578 578  (% style="color:red" %)String after SEARCH command: 2e 30 58 5f 36 41 30 31 00 49
579 579  )))
689 +)))
580 580  
581 581  (((
692 +(((
582 582  (% style="color:red" %)Valid payload after DataCUT command: 2e 30 58 5f 36
583 583  )))
695 +)))
584 584  
697 +(((
585 585  [[image:1653271763403-806.png]]
699 +)))
586 586  
587 587  
588 588  === 3.3.4 Compose the uplink payload ===
... ... @@ -729,26 +729,8 @@
729 729  
730 730  == 3.4 Uplink Payload ==
731 731  
732 -(% border="1" style="background-color:#4f81bd; color:white; width:850px" %)
733 -|**Size(bytes)**|(% style="width:130px" %)**2**|(% style="width:93px" %)**1**|(% style="width:509px" %)**Length depends on the return from the commands**
734 -|Value|(% style="width:130px" %)(((
735 -(((
736 -Battery(mV)
737 -)))
846 +[[image:image-20220606105412-1.png]]
738 738  
739 -(((
740 -&
741 -)))
742 -
743 -(((
744 -Interrupt _Flag
745 -)))
746 -)))|(% style="width:93px" %)(((
747 -PAYLOAD_VER
748 -
749 -
750 -)))|(% style="width:509px" %)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.
751 -
752 752  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
753 753  
754 754  (((
... ... @@ -806,13 +806,21 @@
806 806  
807 807  == 3.5 Configure RS485-BL via AT or Downlink ==
808 808  
905 +(((
809 809  User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands
907 +)))
810 810  
909 +(((
811 811  There are two kinds of Commands:
911 +)))
812 812  
813 -* (% 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]]
913 +* (((
914 +(% 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]]
915 +)))
814 814  
815 -* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
917 +* (((
918 +(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
919 +)))
816 816  
817 817  === 3.5.1 Common Commands: ===
818 818  
... ... @@ -822,6 +822,7 @@
822 822  === 3.5.2 Sensor related commands: ===
823 823  
824 824  
929 +
825 825  ==== **Choose Device Type (RS485 or TTL)** ====
826 826  
827 827  RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
... ... @@ -845,57 +845,109 @@
845 845  
846 846  
847 847  
953 +
848 848  ==== **RS485 Debug Command (AT+CFGDEV)** ====
849 849  
956 +(((
850 850  This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
958 +)))
851 851  
852 -* **AT Command**
960 +* (((
961 +**AT Command**
962 +)))
853 853  
854 854  (% class="box infomessage" %)
855 855  (((
966 +(((
856 856  **AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
857 857  )))
969 +)))
858 858  
971 +(((
859 859  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
973 +)))
860 860  
975 +(((
976 +
977 +)))
861 861  
862 -* **Downlink Payload**
979 +* (((
980 +**Downlink Payload**
981 +)))
863 863  
983 +(((
864 864  Format: A8 MM NN XX XX XX XX YY
985 +)))
865 865  
987 +(((
866 866  Where:
989 +)))
867 867  
868 -* MM: 1: add CRC-16/MODBUS ; 0: no CRC
869 -* NN: The length of RS485 command
870 -* XX XX XX XX: RS485 command total NN bytes
871 -* YY: How many bytes will be uplink from the return of this RS485 command, if YY=0, RS485-BL will execute the downlink command without uplink; if YY>0, RS485-BL will uplink total YY bytes from the output of this RS485 command
991 +* (((
992 +MM: 1: add CRC-16/MODBUS ; 0: no CRC
993 +)))
994 +* (((
995 +NN: The length of RS485 command
996 +)))
997 +* (((
998 +XX XX XX XX: RS485 command total NN bytes
999 +)))
1000 +* (((
1001 +YY: How many bytes will be uplink from the return of this RS485 command, if YY=0, RS485-BL will execute the downlink command without uplink; if YY>0, RS485-BL will uplink total YY bytes from the output of this RS485 command
1002 +)))
872 872  
1004 +(((
873 873  **Example 1:**
1006 +)))
874 874  
1008 +(((
875 875  To connect a Modbus Alarm with below commands.
1010 +)))
876 876  
877 -* 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.
1012 +* (((
1013 +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.
1014 +)))
878 878  
879 -* 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.
1016 +* (((
1017 +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.
1018 +)))
880 880  
1020 +(((
881 881  So if user want to use downlink command to control to RS485 Alarm, he can use:
1022 +)))
882 882  
1024 +(((
883 883  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
1026 +)))
884 884  
1028 +(((
885 885  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
1030 +)))
886 886  
1032 +(((
887 887  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.
1034 +)))
888 888  
1036 +(((
1037 +
1038 +)))
889 889  
1040 +(((
890 890  **Example 2:**
1042 +)))
891 891  
1044 +(((
892 892  Check TTL Sensor return:
1046 +)))
893 893  
1048 +(((
894 894  [[image:1654132684752-193.png]]
1050 +)))
895 895  
896 896  
897 897  
898 898  
1055 +
899 899  ==== **Set Payload version** ====
900 900  
901 901  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.
... ... @@ -916,87 +916,171 @@
916 916  
917 917  
918 918  
1076 +
919 919  ==== **Set RS485 Sampling Commands** ====
920 920  
1079 +(((
921 921  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
1081 +)))
922 922  
1083 +(((
923 923  These three commands are used to configure how the RS485-BL polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>||anchor="H3.3.3Configurereadcommandsforeachsampling"]].
1085 +)))
924 924  
1087 +(((
1088 +
1089 +)))
925 925  
926 -* **AT Command:**
1091 +* (((
1092 +**AT Command:**
1093 +)))
927 927  
928 928  (% class="box infomessage" %)
929 929  (((
1097 +(((
930 930  **AT+COMMANDx: Configure RS485 read command to sensor.**
931 931  )))
1100 +)))
932 932  
933 933  (% class="box infomessage" %)
934 934  (((
1104 +(((
935 935  **AT+DATACUTx: Configure how to handle return from RS485 devices.**
936 936  )))
1107 +)))
937 937  
938 938  (% class="box infomessage" %)
939 939  (((
1111 +(((
940 940  **AT+SEARCHx: Configure search command**
941 941  )))
1114 +)))
942 942  
1116 +(((
1117 +
1118 +)))
943 943  
944 -* **Downlink Payload:**
1120 +* (((
1121 +**Downlink Payload:**
1122 +)))
945 945  
1124 +(((
946 946  **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
1126 +)))
947 947  
1128 +(((
948 948  (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
1130 +)))
949 949  
1132 +(((
950 950  Format: AF MM NN LL XX XX XX XX YY
1134 +)))
951 951  
1136 +(((
952 952  Where:
1138 +)))
953 953  
954 -* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
955 -* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
956 -* LL:  The length of AT+COMMAND or AT+DATACUT command
957 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command
958 -* YY:  If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-BL will execute an uplink after got this command.
1140 +* (((
1141 +MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
1142 +)))
1143 +* (((
1144 +NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
1145 +)))
1146 +* (((
1147 +LL:  The length of AT+COMMAND or AT+DATACUT command
1148 +)))
1149 +* (((
1150 +XX XX XX XX: AT+COMMAND or AT+DATACUT command
1151 +)))
1152 +* (((
1153 +YY:  If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-BL will execute an uplink after got this command.
1154 +)))
959 959  
1156 +(((
960 960  **Example:**
1158 +)))
961 961  
1160 +(((
962 962  (% 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
1162 +)))
963 963  
1164 +(((
964 964  (% 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**
1166 +)))
965 965  
1168 +(((
966 966  (% 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**
1170 +)))
967 967  
1172 +(((
1173 +
1174 +)))
968 968  
1176 +(((
969 969  **0xAB** downlink command can be used for set AT+SEARCHx
1178 +)))
970 970  
1180 +(((
971 971  **Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
1182 +)))
972 972  
973 -* AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
974 -* AB aa 02 03 xx xx xx 02 yy yy(03 means there are 3 bytes after 03, they are xx xx xx;02 means there are 2 bytes after 02, they are yy yy) so the commands
1184 +* (((
1185 +AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
1186 +)))
1187 +* (((
1188 +AB aa 02 03 xx xx xx 02 yy yy(03 means there are 3 bytes after 03, they are xx xx xx;02 means there are 2 bytes after 02, they are yy yy) so the commands
1189 +)))
975 975  
1191 +(((
976 976  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
1193 +)))
977 977  
978 978  
979 979  
1197 +
980 980  ==== **Fast command to handle MODBUS device** ====
981 981  
1200 +(((
982 982  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]].
1202 +)))
983 983  
1204 +(((
984 984  This command is valid since v1.3 firmware version
1206 +)))
985 985  
1208 +(((
1209 +
1210 +)))
986 986  
1212 +(((
987 987  **AT+MBFUN has only two value:**
1214 +)))
988 988  
989 -* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1216 +* (((
1217 +**AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1218 +)))
990 990  
1220 +(((
991 991  AT+MBFUN=1, device can auto read the Modbus function code: 01, 02, 03 or 04. AT+MBFUN has lower priority vs AT+DATACUT command. If AT+DATACUT command is configured, AT+MBFUN will be ignore.
1222 +)))
992 992  
993 -* **AT+MBFUN=0**: Disable Modbus fast reading.
1224 +* (((
1225 +**AT+MBFUN=0**: Disable Modbus fast reading.
1226 +)))
994 994  
1228 +(((
995 995  **Example:**
1230 +)))
996 996  
997 -* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
998 -* 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.
999 -* 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.
1232 +* (((
1233 +AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
1234 +)))
1235 +* (((
1236 +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.
1237 +)))
1238 +* (((
1239 +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.
1240 +)))
1000 1000  
1001 1001  [[image:1654133913295-597.png]]
1002 1002  
... ... @@ -1004,67 +1004,120 @@
1004 1004  [[image:1654133954153-643.png]]
1005 1005  
1006 1006  
1007 -* **Downlink Commands:**
1248 +* (((
1249 +**Downlink Commands:**
1250 +)))
1008 1008  
1252 +(((
1009 1009  **A9 aa** ~-~-> Same as AT+MBFUN=aa
1254 +)))
1010 1010  
1011 1011  
1012 1012  
1258 +
1013 1013  ==== **RS485 command timeout** ====
1014 1014  
1261 +(((
1015 1015  Some Modbus device has slow action to send replies. This command is used to configure the RS485-BL to use longer time to wait for their action.
1263 +)))
1016 1016  
1265 +(((
1017 1017  Default value: 0, range:  0 ~~ 5 seconds
1267 +)))
1018 1018  
1269 +(((
1270 +
1271 +)))
1019 1019  
1020 -* **AT Command:**
1273 +* (((
1274 +**AT Command:**
1275 +)))
1021 1021  
1022 1022  (% class="box infomessage" %)
1023 1023  (((
1279 +(((
1024 1024  **AT+CMDDLaa=hex(bb cc)**
1025 1025  )))
1282 +)))
1026 1026  
1284 +(((
1027 1027  **Example:**
1286 +)))
1028 1028  
1288 +(((
1029 1029  **AT+CMDDL1=1000** to send the open time to 1000ms
1290 +)))
1030 1030  
1292 +(((
1293 +
1294 +)))
1031 1031  
1032 -* **Downlink Payload:**
1296 +* (((
1297 +**Downlink Payload:**
1298 +)))
1033 1033  
1300 +(((
1034 1034  0x AA aa bb cc
1302 +)))
1035 1035  
1304 +(((
1036 1036  Same as: AT+CMDDLaa=hex(bb cc)
1306 +)))
1037 1037  
1308 +(((
1038 1038   **Example:**
1310 +)))
1039 1039  
1312 +(((
1040 1040   **0xAA 01 03 E8**  ~-~-> Same as **AT+CMDDL1=1000 ms**
1314 +)))
1041 1041  
1042 1042  
1043 1043  
1318 +
1044 1044  ==== **Uplink payload mode** ====
1045 1045  
1321 +(((
1046 1046  Define to use one uplink or multiple uplinks for the sampling.
1323 +)))
1047 1047  
1325 +(((
1048 1048  The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
1327 +)))
1049 1049  
1050 -* **AT Command:**
1329 +* (((
1330 +**AT Command:**
1331 +)))
1051 1051  
1052 1052  (% class="box infomessage" %)
1053 1053  (((
1335 +(((
1054 1054  **AT+DATAUP=0**
1055 1055  )))
1338 +)))
1056 1056  
1057 1057  (% class="box infomessage" %)
1058 1058  (((
1342 +(((
1059 1059  **AT+DATAUP=1**
1060 1060  )))
1345 +)))
1061 1061  
1347 +(((
1348 +
1349 +)))
1062 1062  
1063 -* **Downlink Payload:**
1351 +* (((
1352 +**Downlink Payload:**
1353 +)))
1064 1064  
1355 +(((
1065 1065  **0xAD 00**  **~-~->** Same as AT+DATAUP=0
1357 +)))
1066 1066  
1359 +(((
1067 1067  **0xAD 01**  **~-~->** Same as AT+DATAUP=1
1361 +)))
1068 1068  
1069 1069  
1070 1070  
... ... @@ -1082,131 +1082,229 @@
1082 1082  
1083 1083  ==== **Clear RS485 Command** ====
1084 1084  
1379 +(((
1085 1085  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
1381 +)))
1086 1086  
1383 +(((
1384 +
1385 +)))
1087 1087  
1088 -* **AT Command:**
1387 +* (((
1388 +**AT Command:**
1389 +)))
1089 1089  
1391 +(((
1090 1090  (% style="color:#037691" %)**AT+CMDEAR=mm,nn** (%%) mm: start position of erase ,nn: stop position of erase Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
1393 +)))
1091 1091  
1395 +(((
1092 1092  Example screen shot after clear all RS485 commands. 
1397 +)))
1093 1093  
1399 +(((
1400 +
1401 +)))
1094 1094  
1403 +(((
1095 1095  The uplink screen shot is:
1405 +)))
1096 1096  
1407 +(((
1097 1097  [[image:1654134704555-320.png]]
1409 +)))
1098 1098  
1411 +(((
1412 +
1413 +)))
1099 1099  
1100 -* **Downlink Payload:**
1415 +* (((
1416 +**Downlink Payload:**
1417 +)))
1101 1101  
1419 +(((
1102 1102  **0x09 aa bb** same as AT+CMDEAR=aa,bb
1421 +)))
1103 1103  
1104 1104  
1105 1105  
1425 +
1106 1106  ==== **Set Serial Communication Parameters** ====
1107 1107  
1428 +(((
1108 1108  Set the Rs485 serial communication parameters:
1430 +)))
1109 1109  
1110 -* **AT Command:**
1432 +* (((
1433 +**AT Command:**
1434 +)))
1111 1111  
1436 +(((
1112 1112  Set Baud Rate:
1438 +)))
1113 1113  
1114 1114  (% class="box infomessage" %)
1115 1115  (((
1442 +(((
1116 1116  **AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1117 -)))
1118 1118  
1119 1119  Set UART Parity
1120 -
1121 -(% class="box infomessage" %)
1122 -(((
1123 1123  **AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1124 -)))
1125 1125  
1126 1126  Set STOPBIT
1127 1127  
1128 -(% class="box infomessage" %)
1129 -(((
1130 1130  **AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1131 1131  )))
1452 +)))
1132 1132  
1133 1133  
1134 -* **Downlink Payload:**
1455 +* (((
1456 +**Downlink Payload:**
1457 +)))
1135 1135  
1459 +(((
1136 1136  **A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
1461 +)))
1137 1137  
1463 +(((
1138 1138  **Example:**
1465 +)))
1139 1139  
1140 -* A7 01 00 60   same as AT+BAUDR=9600
1141 -* A7 01 04 80  same as AT+BAUDR=115200
1467 +* (((
1468 +A7 01 00 60   same as AT+BAUDR=9600
1469 +)))
1470 +* (((
1471 +A7 01 04 80  same as AT+BAUDR=115200
1472 +)))
1142 1142  
1474 +(((
1143 1143  A7 02 aa: Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
1476 +)))
1144 1144  
1478 +(((
1145 1145  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1480 +)))
1146 1146  
1147 1147  
1148 1148  
1484 +
1149 1149  ==== **Control output power duration** ====
1150 1150  
1487 +(((
1151 1151  User can set the output power duration before each sampling.
1489 +)))
1152 1152  
1153 -* **AT Command:**
1491 +* (((
1492 +**AT Command:**
1493 +)))
1154 1154  
1495 +(((
1155 1155  **Example:**
1497 +)))
1156 1156  
1499 +(((
1157 1157  **AT+3V3T=1000**  ~/~/ 3V3 output power will open 1s before each sampling.
1501 +)))
1158 1158  
1503 +(((
1159 1159  **AT+5VT=1000**  ~/~/ +5V output power will open 1s before each sampling.
1505 +)))
1160 1160  
1507 +(((
1508 +
1509 +)))
1161 1161  
1162 -* **LoRaWAN Downlink Command:**
1511 +* (((
1512 +**LoRaWAN Downlink Command:**
1513 +)))
1163 1163  
1515 +(((
1164 1164  **07 01 aa bb**  Same as AT+5VT=(aa bb)
1517 +)))
1165 1165  
1519 +(((
1166 1166  **07 02 aa bb**  Same as AT+3V3T=(aa bb)
1521 +)))
1167 1167  
1168 1168  
1169 1169  
1170 1170  == 3.6 Buttons ==
1171 1171  
1172 -(% border="1" style="background-color:#ffffcc; color:green; width:233px" %)
1527 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:233px" %)
1173 1173  |=(% style="width: 89px;" %)**Button**|=(% style="width: 141px;" %)**Feature**
1174 1174  |(% style="width:89px" %)**RST**|(% style="width:141px" %)Reboot RS485-BL
1175 1175  
1176 1176  == 3.7 +3V3 Output ==
1177 1177  
1533 +(((
1178 1178  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
1535 +)))
1179 1179  
1537 +(((
1180 1180  The +3V3 output will be valid for every sampling. RS485-BL will enable +3V3 output before all sampling and disable the +3V3 after all sampling. 
1539 +)))
1181 1181  
1541 +(((
1182 1182  The +3V3 output time can be controlled by AT Command.
1543 +)))
1183 1183  
1545 +(((
1546 +
1547 +)))
1184 1184  
1549 +(((
1185 1185  (% style="color:#037691" %)**AT+3V3T=1000**
1551 +)))
1186 1186  
1553 +(((
1554 +
1555 +)))
1187 1187  
1557 +(((
1188 1188  Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors.
1559 +)))
1189 1189  
1561 +(((
1190 1190  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1563 +)))
1191 1191  
1192 1192  
1193 1193  == 3.8 +5V Output ==
1194 1194  
1568 +(((
1195 1195  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
1570 +)))
1196 1196  
1572 +(((
1197 1197  The +5V output will be valid for every sampling. RS485-BL will enable +5V output before all sampling and disable the +5v after all sampling. 
1574 +)))
1198 1198  
1576 +(((
1199 1199  The 5V output time can be controlled by AT Command.
1578 +)))
1200 1200  
1580 +(((
1581 +
1582 +)))
1201 1201  
1584 +(((
1202 1202  (% style="color:#037691" %)**AT+5VT=1000**
1586 +)))
1203 1203  
1588 +(((
1589 +
1590 +)))
1204 1204  
1592 +(((
1205 1205  Means set 5V valid time to have 1000ms. So, the real 5V output will actually have 1000ms + sampling time for other sensors.
1594 +)))
1206 1206  
1596 +(((
1207 1207  By default, the AT+5VT=0. If the external sensor which require 5v and require more time to get stable state, user can use this command to increase the power ON duration for this sensor.
1598 +)))
1208 1208  
1209 1209  
1601 +
1210 1210  == 3.9 LEDs ==
1211 1211  
1212 1212  (% border="1" style="background-color:#ffffcc; color:green; width:332px" %)
... ... @@ -1215,22 +1215,20 @@
1215 1215  
1216 1216  == 3.10 Switch Jumper ==
1217 1217  
1218 -(% border="1" style="background-color:#ffffcc; color:green; width:515px" %)
1219 -|=(% style="width: 124px;" %)**Switch Jumper**|=(% style="width: 388px;" %)**Feature**
1220 -|(% style="width:124px" %)**SW1**|(% style="width:388px" %)(((
1221 -ISP position: Upgrade firmware via UART
1222 -
1610 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:463px" %)
1611 +|=(% style="width: 123px;" %)**Switch Jumper**|=(% style="width: 336px;" %)**Feature**
1612 +|(% style="width:123px" %)**SW1**|(% style="width:336px" %)ISP position: Upgrade firmware via UART
1223 1223  Flash position: Configure device, check running status.
1224 -)))
1225 -|(% style="width:124px" %)**SW2**|(% style="width:388px" %)(((
1226 -5V position: set to compatible with 5v I/O.
1227 -
1614 +|(% style="width:123px" %)**SW2**|(% style="width:336px" %)5V position: set to compatible with 5v I/O.
1228 1228  3.3v position: set to compatible with 3.3v I/O.,
1229 -)))
1230 1230  
1617 +(((
1231 1231  **+3.3V**: is always ON
1619 +)))
1232 1232  
1621 +(((
1233 1233  **+5V**: Only open before every sampling. The time is by default, it is AT+5VT=0.  Max open time. 5000 ms.
1623 +)))
1234 1234  
1235 1235  
1236 1236  = 4. Case Study =
... ... @@ -1242,17 +1242,23 @@
1242 1242  
1243 1243  == 5.1 Access AT Command ==
1244 1244  
1635 +(((
1245 1245  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.
1637 +)))
1246 1246  
1247 1247  [[image:1654135840598-282.png]]
1248 1248  
1249 1249  
1642 +(((
1250 1250  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:
1644 +)))
1251 1251  
1252 1252  [[image:1654136105500-922.png]]
1253 1253  
1254 1254  
1649 +(((
1255 1255  More detail AT Command manual can be found at [[AT Command Manual>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]]
1651 +)))
1256 1256  
1257 1257  
1258 1258  == 5.2 Common AT Command Sequence ==
... ... @@ -1264,20 +1264,14 @@
1264 1264  (% class="box infomessage" %)
1265 1265  (((
1266 1266  **AT+FDR**
1267 -)))
1268 -
1269 -(% class="box infomessage" %)
1270 -(((
1271 1271  **AT+NJM=0**
1272 -)))
1273 -
1274 -(% class="box infomessage" %)
1275 -(((
1276 1276  **ATZ**
1277 1277  )))
1278 1278  
1279 1279  
1668 +(((
1280 1280  If device already joined network:
1670 +)))
1281 1281  
1282 1282  (% class="box infomessage" %)
1283 1283  (((
... ... @@ -1316,10 +1316,12 @@
1316 1316  
1317 1317  (% style="color:red" %)**Note:**
1318 1318  
1709 +(((
1319 1319  (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server.
1320 1320  2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
1321 1321  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.
1322 1322  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
1714 +)))
1323 1323  
1324 1324  [[image:1654136435598-589.png]]
1325 1325  
... ... @@ -1328,13 +1328,23 @@
1328 1328  
1329 1329  == 6.1 How to upgrade the image? ==
1330 1330  
1723 +(((
1331 1331  The RS485-BL LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-BL to:
1725 +)))
1332 1332  
1333 -* Support new features
1334 -* For bug fix
1335 -* Change LoRaWAN bands.
1727 +* (((
1728 +Support new features
1729 +)))
1730 +* (((
1731 +For bug fix
1732 +)))
1733 +* (((
1734 +Change LoRaWAN bands.
1735 +)))
1336 1336  
1737 +(((
1337 1337  Below shows the hardware connection for how to upload an image to RS485-BL:
1739 +)))
1338 1338  
1339 1339  [[image:1654136646995-976.png]]
1340 1340  
image-20220606105412-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +13.9 KB
Content