Skip to Content
Last modified by Xiaoling on 2025/04/23 15:57
From version 40.35
edited by Xiaoling
on 2022/06/06 09:56
Change comment: There is no comment for this version
To version 44.7
edited by Xiaoling
on 2022/06/14 10:04
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:
... ... @@ -95,6 +95,8 @@
95 95  * Automatic RF Sense and CAD with ultra-fast AFC. ​​​
96 96  
97 97  
96 +
97 +
98 98  == 1.3 Features ==
99 99  
100 100  * LoRaWAN Class A & Class C protocol (default Class A)
... ... @@ -107,6 +107,8 @@
107 107  * Support Interrupt uplink
108 108  
109 109  
110 +
111 +
110 110  == 1.4 Applications ==
111 111  
112 112  * Smart Buildings & Home Automation
... ... @@ -117,6 +117,8 @@
117 117  * Smart Factory
118 118  
119 119  
122 +
123 +
120 120  == 1.5 Firmware Change log ==
121 121  
122 122  [[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);"]]
... ... @@ -200,6 +200,7 @@
200 200  
201 201  [[image:1652953414711-647.png||height="337" width="723"]]
202 202  
207 +
203 203  (((
204 204  The RS485-BL in this example connected to two RS485 devices for demonstration, user can connect to other RS485 devices via the same method.
205 205  )))
... ... @@ -285,29 +285,29 @@
285 285  RS485-BL default UART settings is **9600, no parity, stop bit 1**. If the sensor has a different settings, user can change the RS485-BL setting to match.
286 286  )))
287 287  
288 -(% border="1" style="background-color:#ffffcc; color:green; width:795px" %)
289 -|(((
293 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
294 +|=(% style="width: 80px;" %)(((
290 290  (((
291 291  **AT Commands**
292 292  )))
293 -)))|(% style="width:285px" %)(((
298 +)))|=(% style="width: 210px;" %)(((
294 294  (((
295 295  **Description**
296 296  )))
297 -)))|(% style="width:347px" %)(((
302 +)))|=(% style="width: 210px;" %)(((
298 298  (((
299 299  **Example**
300 300  )))
301 301  )))
302 -|(((
307 +|(% style="width:80px" %)(((
303 303  (((
304 304  AT+BAUDR
305 305  )))
306 -)))|(% style="width:285px" %)(((
311 +)))|(% style="width:210px" %)(((
307 307  (((
308 308  Set the baud rate (for RS485 connection). Default Value is: 9600.
309 309  )))
310 -)))|(% style="width:347px" %)(((
315 +)))|(% style="width:210px" %)(((
311 311  (((
312 312  (((
313 313  AT+BAUDR=9600
... ... @@ -320,11 +320,11 @@
320 320  )))
321 321  )))
322 322  )))
323 -|(((
328 +|(% style="width:80px" %)(((
324 324  (((
325 325  AT+PARITY
326 326  )))
327 -)))|(% style="width:285px" %)(((
332 +)))|(% style="width:210px" %)(((
328 328  (((
329 329  (((
330 330  Set UART parity (for RS485 connection)
... ... @@ -336,7 +336,7 @@
336 336  Default Value is: no parity.
337 337  )))
338 338  )))
339 -)))|(% style="width:347px" %)(((
344 +)))|(% style="width:210px" %)(((
340 340  (((
341 341  (((
342 342  AT+PARITY=0
... ... @@ -349,11 +349,11 @@
349 349  )))
350 350  )))
351 351  )))
352 -|(((
357 +|(% style="width:80px" %)(((
353 353  (((
354 354  AT+STOPBIT
355 355  )))
356 -)))|(% style="width:285px" %)(((
361 +)))|(% style="width:210px" %)(((
357 357  (((
358 358  (((
359 359  Set serial stopbit (for RS485 connection)
... ... @@ -365,7 +365,7 @@
365 365  Default Value is: 1bit.
366 366  )))
367 367  )))
368 -)))|(% style="width:347px" %)(((
373 +)))|(% style="width:210px" %)(((
369 369  (((
370 370  (((
371 371  AT+STOPBIT=0 for 1bit
... ... @@ -385,7 +385,6 @@
385 385  )))
386 386  )))
387 387  
388 -
389 389  === 3.3.2 Configure sensors ===
390 390  
391 391  (((
... ... @@ -396,19 +396,26 @@
396 396  When user issue an (% style="color:#4f81bd" %)**AT+CFGDEV**(%%) command, Each (% style="color:#4f81bd" %)**AT+CFGDEV**(%%) equals to send a command to the RS485 or TTL sensors. This command will only run when user input it and won’t run during each sampling.
397 397  )))
398 398  
399 -(% border="1" style="background-color:#ffffcc; color:green; width:806px" %)
400 -|**AT Commands**|(% style="width:418px" %)**Description**|(% style="width:256px" %)**Example**
401 -|AT+CFGDEV|(% style="width:418px" %)(((
403 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
404 +|=(% style="width: 80px;" %)**AT Commands**|=(% style="width: 210px;" %)**Description**|=(% style="width: 210px;" %)**Example**
405 +|AT+CFGDEV|(% style="width:80px" %)(((
406 +(((
402 402  This command is used to configure the RS485/TTL devices; they won’t be used during sampling.
408 +)))
403 403  
410 +(((
404 404  AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,
412 +)))
405 405  
414 +(((
406 406  mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
407 -)))|(% style="width:256px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
416 +)))
417 +)))|(% style="width:210px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
408 408  
409 409  Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>||anchor="HRS485DebugCommand28AT2BCFGDEV29"]].
410 410  
411 411  
422 +
412 412  === 3.3.3 Configure read commands for each sampling ===
413 413  
414 414  (((
... ... @@ -475,117 +475,213 @@
475 475  After we got the valid value from each RS485 commands, we need to combine them together with the command **AT+DATAUP**.
476 476  )))
477 477  
489 +(((
478 478  **Examples:**
491 +)))
479 479  
493 +(((
480 480  Below are examples for the how above AT Commands works.
495 +)))
481 481  
497 +(((
482 482  **AT+COMMANDx : **This command will be sent to RS485/TTL devices during each sampling, Max command length is 14 bytes. The grammar is:
499 +)))
483 483  
484 -(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:501px" %)
501 +(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:500px" %)
485 485  |(% style="width:498px" %)(((
503 +(((
486 486  **AT+COMMANDx=xx xx xx xx xx xx xx xx xx xx xx xx,m**
505 +)))
487 487  
507 +(((
488 488  **xx xx xx xx xx xx xx xx xx xx xx xx: The RS485 command to be sent**
509 +)))
489 489  
511 +(((
490 490  **m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command**
491 491  )))
514 +)))
492 492  
516 +(((
493 493  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.
518 +)))
494 494  
520 +(((
495 495  In the RS485-BL, we should use this command AT+COMMAND1=01 03 0B B8 00 02,1 for the same.
522 +)))
496 496  
524 +(((
525 +
526 +)))
527 +
528 +(((
497 497  **AT+SEARCHx**: This command defines how to handle the return from AT+COMMANDx.
530 +)))
498 498  
499 -(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:580px" %)
532 +(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:500px" %)
500 500  |(% style="width:577px" %)(((
534 +(((
501 501  **AT+SEARCHx=aa,xx xx xx xx xx**
536 +)))
502 502  
503 -* **aa: 1: prefix match mode; 2: prefix and suffix match mode**
504 -* **xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix**
538 +* (((
539 +**aa: 1: prefix match mode; 2: prefix and suffix match mode**
505 505  )))
541 +* (((
542 +**xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix**
543 +)))
544 +)))
506 506  
546 +(((
507 507  **Examples:**
548 +)))
508 508  
550 +(((
509 509  1）For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
552 +)))
510 510  
554 +(((
511 511  If we set AT+SEARCH1=1,1E 56 34.      (max 5 bytes for prefix)
556 +)))
512 512  
558 +(((
513 513  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**
560 +)))
514 514  
562 +(((
515 515  [[image:1653271044481-711.png]]
564 +)))
516 516  
566 +(((
517 517  2）For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
568 +)))
518 518  
570 +(((
519 519  If we set AT+SEARCH1=2, 1E 56 34+31 00 49
572 +)))
520 520  
574 +(((
521 521  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**
576 +)))
522 522  
578 +(((
523 523  [[image:1653271276735-972.png]]
580 +)))
524 524  
582 +(((
525 525  **AT+DATACUTx : **This command defines how to handle the return from AT+COMMANDx, max return length is 45 bytes.
584 +)))
526 526  
527 -(% style="background-color:#4f81bd; color:white; width:729px" %)
586 +(% style="background-color:#4f81bd; color:white; width:510px" %)
528 528  |(% style="width:726px" %)(((
588 +(((
529 529  **AT+DATACUTx=a,b,c**
590 +)))
530 530  
531 -* **a: length for the return of AT+COMMAND**
532 -* **b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
533 -* **c: define the position for valid value.  **
592 +* (((
593 +**a: length for the return of AT+COMMAND**
534 534  )))
595 +* (((
596 +**b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
597 +)))
598 +* (((
599 +**c: define the position for valid value.  **
600 +)))
601 +)))
535 535  
603 +(((
536 536  **Examples:**
605 +)))
537 537  
538 -* Grab bytes:
607 +* (((
608 +Grab bytes:
609 +)))
539 539  
611 +(((
540 540  [[image:1653271581490-837.png||height="313" width="722"]]
613 +)))
541 541  
615 +(((
616 +
617 +)))
542 542  
543 -* Grab a section.
619 +* (((
620 +Grab a section.
621 +)))
544 544  
623 +(((
545 545  [[image:1653271648378-342.png||height="326" width="720"]]
625 +)))
546 546  
627 +(((
628 +
629 +)))
547 547  
548 -* Grab different sections.
631 +* (((
632 +Grab different sections.
633 +)))
549 549  
635 +(((
550 550  [[image:1653271657255-576.png||height="305" width="730"]]
637 +)))
551 551  
552 552  (((
640 +(((
553 553  (% style="color:red" %)**Note:**
554 554  )))
643 +)))
555 555  
556 556  (((
646 +(((
557 557  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.
558 558  )))
649 +)))
559 559  
560 560  (((
652 +(((
561 561  **Example:**
562 562  )))
655 +)))
563 563  
564 564  (((
658 +(((
565 565  (% style="color:red" %)AT+COMMAND1=11 01 1E D0,0
566 566  )))
661 +)))
567 567  
568 568  (((
664 +(((
569 569  (% style="color:red" %)AT+SEARCH1=1,1E 56 34
570 570  )))
667 +)))
571 571  
572 572  (((
670 +(((
573 573  (% style="color:red" %)AT+DATACUT1=0,2,1~~5
574 574  )))
673 +)))
575 575  
576 576  (((
676 +(((
577 577  (% style="color:red" %)Return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
578 578  )))
679 +)))
579 579  
580 580  (((
682 +(((
581 581  (% style="color:red" %)String after SEARCH command: 2e 30 58 5f 36 41 30 31 00 49
582 582  )))
685 +)))
583 583  
584 584  (((
688 +(((
585 585  (% style="color:red" %)Valid payload after DataCUT command: 2e 30 58 5f 36
586 586  )))
691 +)))
587 587  
693 +(((
588 588  [[image:1653271763403-806.png]]
695 +)))
589 589  
590 590  
591 591  === 3.3.4 Compose the uplink payload ===
... ... @@ -592,10 +592,14 @@
592 592  
593 593  (((
594 594  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.**
702 +
703 +
595 595  )))
596 596  
597 597  (((
598 598  (% style="color:#037691" %)**Examples: AT+DATAUP=0**
708 +
709 +
599 599  )))
600 600  
601 601  (((
... ... @@ -728,26 +728,8 @@
728 728  
729 729  == 3.4 Uplink Payload ==
730 730  
731 -(% border="1" style="background-color:#4f81bd; color:white; width:850px" %)
732 -|**Size(bytes)**|(% style="width:130px" %)**2**|(% style="width:93px" %)**1**|(% style="width:509px" %)**Length depends on the return from the commands**
733 -|Value|(% style="width:130px" %)(((
734 -(((
735 -Battery(mV)
736 -)))
842 +[[image:image-20220606105412-1.png]]
737 737  
738 -(((
739 -&
740 -)))
741 -
742 -(((
743 -Interrupt _Flag
744 -)))
745 -)))|(% style="width:93px" %)(((
746 -PAYLOAD_VER
747 -
748 -
749 -)))|(% 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.
750 -
751 751  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
752 752  
753 753  (((
... ... @@ -805,15 +805,22 @@
805 805  
806 806  == 3.5 Configure RS485-BL via AT or Downlink ==
807 807  
901 +(((
808 808  User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands
903 +)))
809 809  
905 +(((
810 810  There are two kinds of Commands:
907 +)))
811 811  
812 -* (% 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]]
909 +* (((
910 +(% 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]]
911 +)))
813 813  
814 -* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
913 +* (((
914 +(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
915 +)))
815 815  
816 -
817 817  === 3.5.1 Common Commands: ===
818 818  
819 819  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]]
... ... @@ -822,6 +822,7 @@
822 822  === 3.5.2 Sensor related commands: ===
823 823  
824 824  
925 +
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  
949 +
848 848  ==== **RS485 Debug Command (AT+CFGDEV)** ====
849 849  
952 +(((
850 850  This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
954 +)))
851 851  
852 -* **AT Command**
956 +* (((
957 +**AT Command**
958 +)))
853 853  
854 854  (% class="box infomessage" %)
855 855  (((
962 +(((
856 856  **AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
857 857  )))
965 +)))
858 858  
967 +(((
859 859  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
969 +)))
860 860  
971 +(((
972 +
973 +)))
861 861  
862 -* **Downlink Payload**
975 +* (((
976 +**Downlink Payload**
977 +)))
863 863  
979 +(((
864 864  Format: A8 MM NN XX XX XX XX YY
981 +)))
865 865  
983 +(((
866 866  Where:
985 +)))
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
987 +* (((
988 +MM: 1: add CRC-16/MODBUS ; 0: no CRC
989 +)))
990 +* (((
991 +NN: The length of RS485 command
992 +)))
993 +* (((
994 +XX XX XX XX: RS485 command total NN bytes
995 +)))
996 +* (((
997 +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
998 +)))
872 872  
1000 +(((
873 873  **Example 1:**
1002 +)))
874 874  
1004 +(((
875 875  To connect a Modbus Alarm with below commands.
1006 +)))
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.
1008 +* (((
1009 +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.
1010 +)))
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.
1012 +* (((
1013 +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.
1014 +)))
880 880  
1016 +(((
881 881  So if user want to use downlink command to control to RS485 Alarm, he can use:
1018 +)))
882 882  
1020 +(((
883 883  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
1022 +)))
884 884  
1024 +(((
885 885  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
1026 +)))
886 886  
1028 +(((
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.
1030 +)))
888 888  
1032 +(((
1033 +
1034 +)))
889 889  
1036 +(((
890 890  **Example 2:**
1038 +)))
891 891  
1040 +(((
892 892  Check TTL Sensor return:
1042 +)))
893 893  
1044 +(((
894 894  [[image:1654132684752-193.png]]
1046 +)))
895 895  
896 896  
897 897  
898 898  
1051 +
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  
1072 +
919 919  ==== **Set RS485 Sampling Commands** ====
920 920  
1075 +(((
921 921  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
1077 +)))
922 922  
1079 +(((
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"]].
1081 +)))
924 924  
1083 +(((
1084 +
1085 +)))
925 925  
926 -* **AT Command:**
1087 +* (((
1088 +**AT Command:**
1089 +)))
927 927  
928 928  (% class="box infomessage" %)
929 929  (((
1093 +(((
930 930  **AT+COMMANDx: Configure RS485 read command to sensor.**
931 931  )))
1096 +)))
932 932  
933 933  (% class="box infomessage" %)
934 934  (((
1100 +(((
935 935  **AT+DATACUTx: Configure how to handle return from RS485 devices.**
936 936  )))
1103 +)))
937 937  
938 938  (% class="box infomessage" %)
939 939  (((
1107 +(((
940 940  **AT+SEARCHx: Configure search command**
941 941  )))
1110 +)))
942 942  
1112 +(((
1113 +
1114 +)))
943 943  
944 -* **Downlink Payload:**
1116 +* (((
1117 +**Downlink Payload:**
1118 +)))
945 945  
1120 +(((
946 946  **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
1122 +)))
947 947  
1124 +(((
948 948  (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
1126 +)))
949 949  
1128 +(((
950 950  Format: AF MM NN LL XX XX XX XX YY
1130 +)))
951 951  
1132 +(((
952 952  Where:
1134 +)))
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.
1136 +* (((
1137 +MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
1138 +)))
1139 +* (((
1140 +NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
1141 +)))
1142 +* (((
1143 +LL:  The length of AT+COMMAND or AT+DATACUT command
1144 +)))
1145 +* (((
1146 +XX XX XX XX: AT+COMMAND or AT+DATACUT command
1147 +)))
1148 +* (((
1149 +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.
1150 +)))
959 959  
1152 +(((
960 960  **Example:**
1154 +)))
961 961  
1156 +(((
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
1158 +)))
963 963  
1160 +(((
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**
1162 +)))
965 965  
1164 +(((
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**
1166 +)))
967 967  
1168 +(((
1169 +
1170 +)))
968 968  
1172 +(((
969 969  **0xAB** downlink command can be used for set AT+SEARCHx
1174 +)))
970 970  
1176 +(((
971 971  **Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
1178 +)))
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
1180 +* (((
1181 +AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
1182 +)))
1183 +* (((
1184 +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
1185 +)))
975 975  
1187 +(((
976 976  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
1189 +)))
977 977  
978 978  
979 979  
1193 +
980 980  ==== **Fast command to handle MODBUS device** ====
981 981  
1196 +(((
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]].
1198 +)))
983 983  
1200 +(((
984 984  This command is valid since v1.3 firmware version
1202 +)))
985 985  
1204 +(((
1205 +
1206 +)))
986 986  
1208 +(((
987 987  **AT+MBFUN has only two value:**
1210 +)))
988 988  
989 -* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1212 +* (((
1213 +**AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1214 +)))
990 990  
1216 +(((
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.
1218 +)))
992 992  
993 -* **AT+MBFUN=0**: Disable Modbus fast reading.
1220 +* (((
1221 +**AT+MBFUN=0**: Disable Modbus fast reading.
1222 +)))
994 994  
1224 +(((
995 995  **Example:**
1226 +)))
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.
1228 +* (((
1229 +AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
1230 +)))
1231 +* (((
1232 +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.
1233 +)))
1234 +* (((
1235 +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.
1236 +)))
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:**
1244 +* (((
1245 +**Downlink Commands:**
1246 +)))
1008 1008  
1248 +(((
1009 1009  **A9 aa** ~-~-> Same as AT+MBFUN=aa
1250 +)))
1010 1010  
1011 1011  
1012 1012  
1254 +
1013 1013  ==== **RS485 command timeout** ====
1014 1014  
1257 +(((
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.
1259 +)))
1016 1016  
1261 +(((
1017 1017  Default value: 0, range:  0 ~~ 5 seconds
1263 +)))
1018 1018  
1265 +(((
1266 +
1267 +)))
1019 1019  
1020 -* **AT Command:**
1269 +* (((
1270 +**AT Command:**
1271 +)))
1021 1021  
1022 1022  (% class="box infomessage" %)
1023 1023  (((
1275 +(((
1024 1024  **AT+CMDDLaa=hex(bb cc)**
1025 1025  )))
1278 +)))
1026 1026  
1280 +(((
1027 1027  **Example:**
1282 +)))
1028 1028  
1284 +(((
1029 1029  **AT+CMDDL1=1000** to send the open time to 1000ms
1286 +)))
1030 1030  
1288 +(((
1289 +
1290 +)))
1031 1031  
1032 -* **Downlink Payload:**
1292 +* (((
1293 +**Downlink Payload:**
1294 +)))
1033 1033  
1296 +(((
1034 1034  0x AA aa bb cc
1298 +)))
1035 1035  
1300 +(((
1036 1036  Same as: AT+CMDDLaa=hex(bb cc)
1302 +)))
1037 1037  
1304 +(((
1038 1038   **Example:**
1306 +)))
1039 1039  
1308 +(((
1040 1040   **0xAA 01 03 E8**  ~-~-> Same as **AT+CMDDL1=1000 ms**
1310 +)))
1041 1041  
1042 1042  
1043 1043  
1314 +
1044 1044  ==== **Uplink payload mode** ====
1045 1045  
1317 +(((
1046 1046  Define to use one uplink or multiple uplinks for the sampling.
1319 +)))
1047 1047  
1321 +(((
1048 1048  The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
1323 +)))
1049 1049  
1050 -* **AT Command:**
1325 +* (((
1326 +**AT Command:**
1327 +)))
1051 1051  
1052 1052  (% class="box infomessage" %)
1053 1053  (((
1331 +(((
1054 1054  **AT+DATAUP=0**
1055 1055  )))
1334 +)))
1056 1056  
1057 1057  (% class="box infomessage" %)
1058 1058  (((
1338 +(((
1059 1059  **AT+DATAUP=1**
1060 1060  )))
1341 +)))
1061 1061  
1343 +(((
1344 +
1345 +)))
1062 1062  
1063 -* **Downlink Payload:**
1347 +* (((
1348 +**Downlink Payload:**
1349 +)))
1064 1064  
1351 +(((
1065 1065  **0xAD 00**  **~-~->** Same as AT+DATAUP=0
1353 +)))
1066 1066  
1355 +(((
1067 1067  **0xAD 01**  **~-~->** Same as AT+DATAUP=1
1357 +)))
1068 1068  
1069 1069  
1070 1070  
... ... @@ -1082,132 +1082,229 @@
1082 1082  
1083 1083  ==== **Clear RS485 Command** ====
1084 1084  
1375 +(((
1085 1085  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
1377 +)))
1086 1086  
1379 +(((
1380 +
1381 +)))
1087 1087  
1088 -* **AT Command:**
1383 +* (((
1384 +**AT Command:**
1385 +)))
1089 1089  
1387 +(((
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
1389 +)))
1091 1091  
1391 +(((
1092 1092  Example screen shot after clear all RS485 commands. 
1393 +)))
1093 1093  
1395 +(((
1396 +
1397 +)))
1094 1094  
1399 +(((
1095 1095  The uplink screen shot is:
1401 +)))
1096 1096  
1403 +(((
1097 1097  [[image:1654134704555-320.png]]
1405 +)))
1098 1098  
1407 +(((
1408 +
1409 +)))
1099 1099  
1100 -* **Downlink Payload:**
1411 +* (((
1412 +**Downlink Payload:**
1413 +)))
1101 1101  
1415 +(((
1102 1102  **0x09 aa bb** same as AT+CMDEAR=aa,bb
1417 +)))
1103 1103  
1104 1104  
1105 1105  
1421 +
1106 1106  ==== **Set Serial Communication Parameters** ====
1107 1107  
1424 +(((
1108 1108  Set the Rs485 serial communication parameters:
1426 +)))
1109 1109  
1110 -* **AT Command:**
1428 +* (((
1429 +**AT Command:**
1430 +)))
1111 1111  
1432 +(((
1112 1112  Set Baud Rate:
1434 +)))
1113 1113  
1114 1114  (% class="box infomessage" %)
1115 1115  (((
1438 +(((
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  )))
1448 +)))
1132 1132  
1133 1133  
1134 -* **Downlink Payload:**
1451 +* (((
1452 +**Downlink Payload:**
1453 +)))
1135 1135  
1455 +(((
1136 1136  **A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
1457 +)))
1137 1137  
1459 +(((
1138 1138  **Example:**
1461 +)))
1139 1139  
1140 -* A7 01 00 60   same as AT+BAUDR=9600
1141 -* A7 01 04 80  same as AT+BAUDR=115200
1463 +* (((
1464 +A7 01 00 60   same as AT+BAUDR=9600
1465 +)))
1466 +* (((
1467 +A7 01 04 80  same as AT+BAUDR=115200
1468 +)))
1142 1142  
1470 +(((
1143 1143  A7 02 aa: Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
1472 +)))
1144 1144  
1474 +(((
1145 1145  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1476 +)))
1146 1146  
1147 1147  
1148 1148  
1480 +
1149 1149  ==== **Control output power duration** ====
1150 1150  
1483 +(((
1151 1151  User can set the output power duration before each sampling.
1485 +)))
1152 1152  
1153 -* **AT Command:**
1487 +* (((
1488 +**AT Command:**
1489 +)))
1154 1154  
1491 +(((
1155 1155  **Example:**
1493 +)))
1156 1156  
1495 +(((
1157 1157  **AT+3V3T=1000**  ~/~/ 3V3 output power will open 1s before each sampling.
1497 +)))
1158 1158  
1499 +(((
1159 1159  **AT+5VT=1000**  ~/~/ +5V output power will open 1s before each sampling.
1501 +)))
1160 1160  
1503 +(((
1504 +
1505 +)))
1161 1161  
1162 -* **LoRaWAN Downlink Command:**
1507 +* (((
1508 +**LoRaWAN Downlink Command:**
1509 +)))
1163 1163  
1511 +(((
1164 1164  **07 01 aa bb**  Same as AT+5VT=(aa bb)
1513 +)))
1165 1165  
1515 +(((
1166 1166  **07 02 aa bb**  Same as AT+3V3T=(aa bb)
1517 +)))
1167 1167  
1168 1168  
1169 1169  
1170 1170  == 3.6 Buttons ==
1171 1171  
1172 -(% border="1" style="background-color:#ffffcc; color:green; width:233px" %)
1523 +(% 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 -
1177 1177  == 3.7 +3V3 Output ==
1178 1178  
1529 +(((
1179 1179  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
1531 +)))
1180 1180  
1533 +(((
1181 1181  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. 
1535 +)))
1182 1182  
1537 +(((
1183 1183  The +3V3 output time can be controlled by AT Command.
1539 +)))
1184 1184  
1541 +(((
1542 +
1543 +)))
1185 1185  
1545 +(((
1186 1186  (% style="color:#037691" %)**AT+3V3T=1000**
1547 +)))
1187 1187  
1549 +(((
1550 +
1551 +)))
1188 1188  
1553 +(((
1189 1189  Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors.
1555 +)))
1190 1190  
1557 +(((
1191 1191  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1559 +)))
1192 1192  
1193 1193  
1194 1194  == 3.8 +5V Output ==
1195 1195  
1564 +(((
1196 1196  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
1566 +)))
1197 1197  
1568 +(((
1198 1198  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. 
1570 +)))
1199 1199  
1572 +(((
1200 1200  The 5V output time can be controlled by AT Command.
1574 +)))
1201 1201  
1576 +(((
1577 +
1578 +)))
1202 1202  
1580 +(((
1203 1203  (% style="color:#037691" %)**AT+5VT=1000**
1582 +)))
1204 1204  
1584 +(((
1585 +
1586 +)))
1205 1205  
1588 +(((
1206 1206  Means set 5V valid time to have 1000ms. So, the real 5V output will actually have 1000ms + sampling time for other sensors.
1590 +)))
1207 1207  
1592 +(((
1208 1208  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.
1594 +)))
1209 1209  
1210 1210  
1597 +
1211 1211  == 3.9 LEDs ==
1212 1212  
1213 1213  (% border="1" style="background-color:#ffffcc; color:green; width:332px" %)
... ... @@ -1214,25 +1214,22 @@
1214 1214  |=**LEDs**|=(% style="width: 274px;" %)**Feature**
1215 1215  |**LED1**|(% style="width:274px" %)Blink when device transmit a packet.
1216 1216  
1217 -
1218 1218  == 3.10 Switch Jumper ==
1219 1219  
1220 -(% border="1" style="background-color:#ffffcc; color:green; width:515px" %)
1221 -|=(% style="width: 124px;" %)**Switch Jumper**|=(% style="width: 388px;" %)**Feature**
1222 -|(% style="width:124px" %)**SW1**|(% style="width:388px" %)(((
1223 -ISP position: Upgrade firmware via UART
1224 -
1606 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:463px" %)
1607 +|=(% style="width: 123px;" %)**Switch Jumper**|=(% style="width: 336px;" %)**Feature**
1608 +|(% style="width:123px" %)**SW1**|(% style="width:336px" %)ISP position: Upgrade firmware via UART
1225 1225  Flash position: Configure device, check running status.
1226 -)))
1227 -|(% style="width:124px" %)**SW2**|(% style="width:388px" %)(((
1228 -5V position: set to compatible with 5v I/O.
1229 -
1610 +|(% style="width:123px" %)**SW2**|(% style="width:336px" %)5V position: set to compatible with 5v I/O.
1230 1230  3.3v position: set to compatible with 3.3v I/O.,
1231 -)))
1232 1232  
1613 +(((
1233 1233  **+3.3V**: is always ON
1615 +)))
1234 1234  
1617 +(((
1235 1235  **+5V**: Only open before every sampling. The time is by default, it is AT+5VT=0.  Max open time. 5000 ms.
1619 +)))
1236 1236  
1237 1237  
1238 1238  = 4. Case Study =
... ... @@ -1244,17 +1244,23 @@
1244 1244  
1245 1245  == 5.1 Access AT Command ==
1246 1246  
1631 +(((
1247 1247  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.
1633 +)))
1248 1248  
1249 1249  [[image:1654135840598-282.png]]
1250 1250  
1251 1251  
1638 +(((
1252 1252  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:
1640 +)))
1253 1253  
1254 1254  [[image:1654136105500-922.png]]
1255 1255  
1256 1256  
1645 +(((
1257 1257  More detail AT Command manual can be found at [[AT Command Manual>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]]
1647 +)))
1258 1258  
1259 1259  
1260 1260  == 5.2 Common AT Command Sequence ==
... ... @@ -1266,20 +1266,14 @@
1266 1266  (% class="box infomessage" %)
1267 1267  (((
1268 1268  **AT+FDR**
1269 -)))
1270 -
1271 -(% class="box infomessage" %)
1272 -(((
1273 1273  **AT+NJM=0**
1274 -)))
1275 -
1276 -(% class="box infomessage" %)
1277 -(((
1278 1278  **ATZ**
1279 1279  )))
1280 1280  
1281 1281  
1664 +(((
1282 1282  If device already joined network:
1666 +)))
1283 1283  
1284 1284  (% class="box infomessage" %)
1285 1285  (((
... ... @@ -1318,10 +1318,12 @@
1318 1318  
1319 1319  (% style="color:red" %)**Note:**
1320 1320  
1705 +(((
1321 1321  (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server.
1322 1322  2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
1323 1323  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.
1324 1324  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
1710 +)))
1325 1325  
1326 1326  [[image:1654136435598-589.png]]
1327 1327  
... ... @@ -1330,13 +1330,23 @@
1330 1330  
1331 1331  == 6.1 How to upgrade the image? ==
1332 1332  
1719 +(((
1333 1333  The RS485-BL LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-BL to:
1721 +)))
1334 1334  
1335 -* Support new features
1336 -* For bug fix
1337 -* Change LoRaWAN bands.
1723 +* (((
1724 +Support new features
1725 +)))
1726 +* (((
1727 +For bug fix
1728 +)))
1729 +* (((
1730 +Change LoRaWAN bands.
1731 +)))
1338 1338  
1733 +(((
1339 1339  Below shows the hardware connection for how to upload an image to RS485-BL:
1735 +)))
1340 1340  
1341 1341  [[image:1654136646995-976.png]]
1342 1342  
... ... @@ -1402,8 +1402,6 @@
1402 1402  * (% style="color:blue" %)**RU864**(%%): frequency bands RU864
1403 1403  * (% style="color:blue" %)**KZ865**(%%): frequency bands KZ865
1404 1404  
1405 -
1406 -
1407 1407  = 9. Packing Info =
1408 1408  
1409 1409  (((
image-20220606105412-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +13.9 KB
Content