Last modified by Xiaoling on 2025/04/23 15:57

From version 42.21
edited by Xiaoling
on 2022/06/06 14:26
Change comment: There is no comment for this version
To version 40.48
edited by Xiaoling
on 2022/06/06 10:37
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -94,8 +94,6 @@
94 94  * 127 dB Dynamic Range RSSI.
95 95  * Automatic RF Sense and CAD with ultra-fast AFC. ​​​
96 96  
97 -
98 -
99 99  == 1.3 Features ==
100 100  
101 101  * LoRaWAN Class A & Class C protocol (default Class A)
... ... @@ -107,8 +107,6 @@
107 107  * Support Modbus protocol
108 108  * Support Interrupt uplink
109 109  
110 -
111 -
112 112  == 1.4 Applications ==
113 113  
114 114  * Smart Buildings & Home Automation
... ... @@ -118,8 +118,6 @@
118 118  * Smart Cities
119 119  * Smart Factory
120 120  
121 -
122 -
123 123  == 1.5 Firmware Change log ==
124 124  
125 125  [[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);"]]
... ... @@ -289,28 +289,28 @@
289 289  )))
290 290  
291 291  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
292 -|=(% style="width: 80px;" %)(((
286 +|=(% style="width: 120px;" %)(((
293 293  (((
294 294  **AT Commands**
295 295  )))
296 -)))|=(% style="width: 210px;" %)(((
290 +)))|=(% style="width: 190px;" %)(((
297 297  (((
298 298  **Description**
299 299  )))
300 -)))|=(% style="width: 210px;" %)(((
294 +)))|=(% style="width: 190px;" %)(((
301 301  (((
302 302  **Example**
303 303  )))
304 304  )))
305 -|(% style="width:80px" %)(((
299 +|(% style="width:120px" %)(((
306 306  (((
307 307  AT+BAUDR
308 308  )))
309 -)))|(% style="width:210px" %)(((
303 +)))|(% style="width:190px" %)(((
310 310  (((
311 311  Set the baud rate (for RS485 connection). Default Value is: 9600.
312 312  )))
313 -)))|(% style="width:210px" %)(((
307 +)))|(% style="width:190px" %)(((
314 314  (((
315 315  (((
316 316  AT+BAUDR=9600
... ... @@ -323,11 +323,11 @@
323 323  )))
324 324  )))
325 325  )))
326 -|(% style="width:80px" %)(((
320 +|(% style="width:120px" %)(((
327 327  (((
328 328  AT+PARITY
329 329  )))
330 -)))|(% style="width:210px" %)(((
324 +)))|(% style="width:190px" %)(((
331 331  (((
332 332  (((
333 333  Set UART parity (for RS485 connection)
... ... @@ -339,7 +339,7 @@
339 339  Default Value is: no parity.
340 340  )))
341 341  )))
342 -)))|(% style="width:210px" %)(((
336 +)))|(% style="width:190px" %)(((
343 343  (((
344 344  (((
345 345  AT+PARITY=0
... ... @@ -352,11 +352,11 @@
352 352  )))
353 353  )))
354 354  )))
355 -|(% style="width:80px" %)(((
349 +|(% style="width:120px" %)(((
356 356  (((
357 357  AT+STOPBIT
358 358  )))
359 -)))|(% style="width:210px" %)(((
353 +)))|(% style="width:190px" %)(((
360 360  (((
361 361  (((
362 362  Set serial stopbit (for RS485 connection)
... ... @@ -368,7 +368,7 @@
368 368  Default Value is: 1bit.
369 369  )))
370 370  )))
371 -)))|(% style="width:210px" %)(((
365 +)))|(% style="width:190px" %)(((
372 372  (((
373 373  (((
374 374  AT+STOPBIT=0 for 1bit
... ... @@ -389,7 +389,6 @@
389 389  )))
390 390  
391 391  
392 -
393 393  === 3.3.2 Configure sensors ===
394 394  
395 395  (((
... ... @@ -401,19 +401,18 @@
401 401  )))
402 402  
403 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" %)(((
397 +|=**AT Commands**|=(% style="width: 110px;" %)**Description**|=(% style="width: 190px;" %)**Example**
398 +|AT+CFGDEV|(% style="width:190px" %)(((
406 406  This command is used to configure the RS485/TTL devices; they won’t be used during sampling.
407 407  
408 408  AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,
409 409  
410 410  mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
411 -)))|(% style="width:210px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
404 +)))|(% style="width:190px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
412 412  
413 413  Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>||anchor="HRS485DebugCommand28AT2BCFGDEV29"]].
414 414  
415 415  
416 -
417 417  === 3.3.3 Configure read commands for each sampling ===
418 418  
419 419  (((
... ... @@ -480,213 +480,117 @@
480 480  After we got the valid value from each RS485 commands, we need to combine them together with the command **AT+DATAUP**.
481 481  )))
482 482  
483 -(((
484 484  **Examples:**
485 -)))
486 486  
487 -(((
488 488  Below are examples for the how above AT Commands works.
489 -)))
490 490  
491 -(((
492 492  **AT+COMMANDx : **This command will be sent to RS485/TTL devices during each sampling, Max command length is 14 bytes. The grammar is:
493 -)))
494 494  
495 -(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:500px" %)
481 +(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:501px" %)
496 496  |(% style="width:498px" %)(((
497 -(((
498 498  **AT+COMMANDx=xx xx xx xx xx xx xx xx xx xx xx xx,m**
499 -)))
500 500  
501 -(((
502 502  **xx xx xx xx xx xx xx xx xx xx xx xx: The RS485 command to be sent**
503 -)))
504 504  
505 -(((
506 506  **m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command**
507 507  )))
508 -)))
509 509  
510 -(((
511 511  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.
512 -)))
513 513  
514 -(((
515 515  In the RS485-BL, we should use this command AT+COMMAND1=01 03 0B B8 00 02,1 for the same.
516 -)))
517 517  
518 -(((
519 -
520 -)))
521 -
522 -(((
523 523  **AT+SEARCHx**: This command defines how to handle the return from AT+COMMANDx.
524 -)))
525 525  
526 -(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:500px" %)
496 +(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:580px" %)
527 527  |(% style="width:577px" %)(((
528 -(((
529 529  **AT+SEARCHx=aa,xx xx xx xx xx**
530 -)))
531 531  
532 -* (((
533 -**aa: 1: prefix match mode; 2: prefix and suffix match mode**
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**
534 534  )))
535 -* (((
536 -**xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix**
537 -)))
538 -)))
539 539  
540 -(((
541 541  **Examples:**
542 -)))
543 543  
544 -(((
545 545  1)For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
546 -)))
547 547  
548 -(((
549 549  If we set AT+SEARCH1=1,1E 56 34.      (max 5 bytes for prefix)
550 -)))
551 551  
552 -(((
553 553  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**
554 -)))
555 555  
556 -(((
557 557  [[image:1653271044481-711.png]]
558 -)))
559 559  
560 -(((
561 561  2)For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
562 -)))
563 563  
564 -(((
565 565  If we set AT+SEARCH1=2, 1E 56 34+31 00 49
566 -)))
567 567  
568 -(((
569 569  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**
570 -)))
571 571  
572 -(((
573 573  [[image:1653271276735-972.png]]
574 -)))
575 575  
576 -(((
577 577  **AT+DATACUTx : **This command defines how to handle the return from AT+COMMANDx, max return length is 45 bytes.
578 -)))
579 579  
580 -(% style="background-color:#4f81bd; color:white; width:510px" %)
524 +(% style="background-color:#4f81bd; color:white; width:729px" %)
581 581  |(% style="width:726px" %)(((
582 -(((
583 583  **AT+DATACUTx=a,b,c**
584 -)))
585 585  
586 -* (((
587 -**a: length for the return of AT+COMMAND**
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.  **
588 588  )))
589 -* (((
590 -**b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
591 -)))
592 -* (((
593 -**c: define the position for valid value.  **
594 -)))
595 -)))
596 596  
597 -(((
598 598  **Examples:**
599 -)))
600 600  
601 -* (((
602 -Grab bytes:
603 -)))
535 +* Grab bytes:
604 604  
605 -(((
606 606  [[image:1653271581490-837.png||height="313" width="722"]]
607 -)))
608 608  
609 -(((
610 -
611 -)))
612 612  
613 -* (((
614 -Grab a section.
615 -)))
540 +* Grab a section.
616 616  
617 -(((
618 618  [[image:1653271648378-342.png||height="326" width="720"]]
619 -)))
620 620  
621 -(((
622 -
623 -)))
624 624  
625 -* (((
626 -Grab different sections.
627 -)))
545 +* Grab different sections.
628 628  
629 -(((
630 630  [[image:1653271657255-576.png||height="305" width="730"]]
631 -)))
632 632  
633 633  (((
634 -(((
635 635  (% style="color:red" %)**Note:**
636 636  )))
637 -)))
638 638  
639 639  (((
640 -(((
641 641  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.
642 642  )))
643 -)))
644 644  
645 645  (((
646 -(((
647 647  **Example:**
648 648  )))
649 -)))
650 650  
651 651  (((
652 -(((
653 653  (% style="color:red" %)AT+COMMAND1=11 01 1E D0,0
654 654  )))
655 -)))
656 656  
657 657  (((
658 -(((
659 659  (% style="color:red" %)AT+SEARCH1=1,1E 56 34
660 660  )))
661 -)))
662 662  
663 663  (((
664 -(((
665 665  (% style="color:red" %)AT+DATACUT1=0,2,1~~5
666 666  )))
667 -)))
668 668  
669 669  (((
670 -(((
671 671  (% style="color:red" %)Return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
672 672  )))
673 -)))
674 674  
675 675  (((
676 -(((
677 677  (% style="color:red" %)String after SEARCH command: 2e 30 58 5f 36 41 30 31 00 49
678 678  )))
679 -)))
680 680  
681 681  (((
682 -(((
683 683  (% style="color:red" %)Valid payload after DataCUT command: 2e 30 58 5f 36
684 684  )))
685 -)))
686 686  
687 -(((
688 688  [[image:1653271763403-806.png]]
689 -)))
690 690  
691 691  
692 692  === 3.3.4 Compose the uplink payload ===
... ... @@ -693,14 +693,10 @@
693 693  
694 694  (((
695 695  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.**
696 -
697 -
698 698  )))
699 699  
700 700  (((
701 701  (% style="color:#037691" %)**Examples: AT+DATAUP=0**
702 -
703 -
704 704  )))
705 705  
706 706  (((
... ... @@ -833,8 +833,26 @@
833 833  
834 834  == 3.4 Uplink Payload ==
835 835  
836 -[[image:image-20220606105412-1.png]]
728 +(% border="1" style="background-color:#4f81bd; color:white; width:850px" %)
729 +|**Size(bytes)**|(% style="width:130px" %)**2**|(% style="width:93px" %)**1**|(% style="width:509px" %)**Length depends on the return from the commands**
730 +|Value|(% style="width:130px" %)(((
731 +(((
732 +Battery(mV)
733 +)))
837 837  
735 +(((
736 +&
737 +)))
738 +
739 +(((
740 +Interrupt _Flag
741 +)))
742 +)))|(% style="width:93px" %)(((
743 +PAYLOAD_VER
744 +
745 +
746 +)))|(% 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.
747 +
838 838  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
839 839  
840 840  (((
... ... @@ -878,7 +878,7 @@
878 878  )))
879 879  
880 880  (((
881 -}
791 +**}**
882 882  
883 883  
884 884  )))
... ... @@ -892,23 +892,14 @@
892 892  
893 893  == 3.5 Configure RS485-BL via AT or Downlink ==
894 894  
895 -(((
896 896  User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands
897 -)))
898 898  
899 -(((
900 900  There are two kinds of Commands:
901 -)))
902 902  
903 -* (((
904 -(% 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]]
905 -)))
809 +* (% 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]]
906 906  
907 -* (((
908 -(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
909 -)))
811 +* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
910 910  
911 -
912 912  === 3.5.1 Common Commands: ===
913 913  
914 914  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]]
... ... @@ -917,7 +917,6 @@
917 917  === 3.5.2 Sensor related commands: ===
918 918  
919 919  
920 -
921 921  ==== **Choose Device Type (RS485 or TTL)** ====
922 922  
923 923  RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
... ... @@ -941,109 +941,57 @@
941 941  
942 942  
943 943  
944 -
945 945  ==== **RS485 Debug Command (AT+CFGDEV)** ====
946 946  
947 -(((
948 948  This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
949 -)))
950 950  
951 -* (((
952 -**AT Command**
953 -)))
848 +* **AT Command**
954 954  
955 955  (% class="box infomessage" %)
956 956  (((
957 -(((
958 958  **AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
959 959  )))
960 -)))
961 961  
962 -(((
963 963  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
964 -)))
965 965  
966 -(((
967 -
968 -)))
969 969  
970 -* (((
971 -**Downlink Payload**
972 -)))
858 +* **Downlink Payload**
973 973  
974 -(((
975 975  Format: A8 MM NN XX XX XX XX YY
976 -)))
977 977  
978 -(((
979 979  Where:
980 -)))
981 981  
982 -* (((
983 -MM: 1: add CRC-16/MODBUS ; 0: no CRC
984 -)))
985 -* (((
986 -NN: The length of RS485 command
987 -)))
988 -* (((
989 -XX XX XX XX: RS485 command total NN bytes
990 -)))
991 -* (((
992 -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
993 -)))
864 +* MM: 1: add CRC-16/MODBUS ; 0: no CRC
865 +* NN: The length of RS485 command
866 +* XX XX XX XX: RS485 command total NN bytes
867 +* 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
994 994  
995 -(((
996 996  **Example 1:**
997 -)))
998 998  
999 -(((
1000 1000  To connect a Modbus Alarm with below commands.
1001 -)))
1002 1002  
1003 -* (((
1004 -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.
1005 -)))
873 +* 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.
1006 1006  
1007 -* (((
1008 -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.
1009 -)))
875 +* 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.
1010 1010  
1011 -(((
1012 1012  So if user want to use downlink command to control to RS485 Alarm, he can use:
1013 -)))
1014 1014  
1015 -(((
1016 1016  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
1017 -)))
1018 1018  
1019 -(((
1020 1020  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
1021 -)))
1022 1022  
1023 -(((
1024 1024  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.
1025 -)))
1026 1026  
1027 -(((
1028 -
1029 -)))
1030 1030  
1031 -(((
1032 1032  **Example 2:**
1033 -)))
1034 1034  
1035 -(((
1036 1036  Check TTL Sensor return:
1037 -)))
1038 1038  
1039 -(((
1040 1040  [[image:1654132684752-193.png]]
1041 -)))
1042 1042  
1043 1043  
1044 1044  
1045 1045  
1046 -
1047 1047  ==== **Set Payload version** ====
1048 1048  
1049 1049  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.
... ... @@ -1064,171 +1064,87 @@
1064 1064  
1065 1065  
1066 1066  
1067 -
1068 1068  ==== **Set RS485 Sampling Commands** ====
1069 1069  
1070 -(((
1071 1071  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
1072 -)))
1073 1073  
1074 -(((
1075 1075  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"]].
1076 -)))
1077 1077  
1078 -(((
1079 -
1080 -)))
1081 1081  
1082 -* (((
1083 -**AT Command:**
1084 -)))
922 +* **AT Command:**
1085 1085  
1086 1086  (% class="box infomessage" %)
1087 1087  (((
1088 -(((
1089 1089  **AT+COMMANDx: Configure RS485 read command to sensor.**
1090 1090  )))
1091 -)))
1092 1092  
1093 1093  (% class="box infomessage" %)
1094 1094  (((
1095 -(((
1096 1096  **AT+DATACUTx: Configure how to handle return from RS485 devices.**
1097 1097  )))
1098 -)))
1099 1099  
1100 1100  (% class="box infomessage" %)
1101 1101  (((
1102 -(((
1103 1103  **AT+SEARCHx: Configure search command**
1104 1104  )))
1105 -)))
1106 1106  
1107 -(((
1108 -
1109 -)))
1110 1110  
1111 -* (((
1112 -**Downlink Payload:**
1113 -)))
940 +* **Downlink Payload:**
1114 1114  
1115 -(((
1116 1116  **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
1117 -)))
1118 1118  
1119 -(((
1120 1120  (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
1121 -)))
1122 1122  
1123 -(((
1124 1124  Format: AF MM NN LL XX XX XX XX YY
1125 -)))
1126 1126  
1127 -(((
1128 1128  Where:
1129 -)))
1130 1130  
1131 -* (((
1132 -MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
1133 -)))
1134 -* (((
1135 -NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
1136 -)))
1137 -* (((
1138 -LL:  The length of AT+COMMAND or AT+DATACUT command
1139 -)))
1140 -* (((
1141 -XX XX XX XX: AT+COMMAND or AT+DATACUT command
1142 -)))
1143 -* (((
1144 -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.
1145 -)))
950 +* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
951 +* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
952 +* LL:  The length of AT+COMMAND or AT+DATACUT command
953 +* XX XX XX XX: AT+COMMAND or AT+DATACUT command
954 +* 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.
1146 1146  
1147 -(((
1148 1148  **Example:**
1149 -)))
1150 1150  
1151 -(((
1152 1152  (% 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
1153 -)))
1154 1154  
1155 -(((
1156 1156  (% 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**
1157 -)))
1158 1158  
1159 -(((
1160 1160  (% 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**
1161 -)))
1162 1162  
1163 -(((
1164 -
1165 -)))
1166 1166  
1167 -(((
1168 1168  **0xAB** downlink command can be used for set AT+SEARCHx
1169 -)))
1170 1170  
1171 -(((
1172 1172  **Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
1173 -)))
1174 1174  
1175 -* (((
1176 -AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
1177 -)))
1178 -* (((
1179 -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 -)))
969 +* AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
970 +* 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
1181 1181  
1182 -(((
1183 1183  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
1184 -)))
1185 1185  
1186 1186  
1187 1187  
1188 -
1189 1189  ==== **Fast command to handle MODBUS device** ====
1190 1190  
1191 -(((
1192 1192  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]].
1193 -)))
1194 1194  
1195 -(((
1196 1196  This command is valid since v1.3 firmware version
1197 -)))
1198 1198  
1199 -(((
1200 -
1201 -)))
1202 1202  
1203 -(((
1204 1204  **AT+MBFUN has only two value:**
1205 -)))
1206 1206  
1207 -* (((
1208 -**AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1209 -)))
985 +* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
1210 1210  
1211 -(((
1212 1212  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.
1213 -)))
1214 1214  
1215 -* (((
1216 -**AT+MBFUN=0**: Disable Modbus fast reading.
1217 -)))
989 +* **AT+MBFUN=0**: Disable Modbus fast reading.
1218 1218  
1219 -(((
1220 1220  **Example:**
1221 -)))
1222 1222  
1223 -* (((
1224 -AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
1225 -)))
1226 -* (((
1227 -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.
1228 -)))
1229 -* (((
1230 -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.
1231 -)))
993 +* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
994 +* 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.
995 +* 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 1232  
1233 1233  [[image:1654133913295-597.png]]
1234 1234  
... ... @@ -1236,120 +1236,67 @@
1236 1236  [[image:1654133954153-643.png]]
1237 1237  
1238 1238  
1239 -* (((
1240 -**Downlink Commands:**
1241 -)))
1003 +* **Downlink Commands:**
1242 1242  
1243 -(((
1244 1244  **A9 aa** ~-~-> Same as AT+MBFUN=aa
1245 -)))
1246 1246  
1247 1247  
1248 1248  
1249 -
1250 1250  ==== **RS485 command timeout** ====
1251 1251  
1252 -(((
1253 1253  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.
1254 -)))
1255 1255  
1256 -(((
1257 1257  Default value: 0, range:  0 ~~ 5 seconds
1258 -)))
1259 1259  
1260 -(((
1261 -
1262 -)))
1263 1263  
1264 -* (((
1265 -**AT Command:**
1266 -)))
1016 +* **AT Command:**
1267 1267  
1268 1268  (% class="box infomessage" %)
1269 1269  (((
1270 -(((
1271 1271  **AT+CMDDLaa=hex(bb cc)**
1272 1272  )))
1273 -)))
1274 1274  
1275 -(((
1276 1276  **Example:**
1277 -)))
1278 1278  
1279 -(((
1280 1280  **AT+CMDDL1=1000** to send the open time to 1000ms
1281 -)))
1282 1282  
1283 -(((
1284 -
1285 -)))
1286 1286  
1287 -* (((
1288 -**Downlink Payload:**
1289 -)))
1028 +* **Downlink Payload:**
1290 1290  
1291 -(((
1292 1292  0x AA aa bb cc
1293 -)))
1294 1294  
1295 -(((
1296 1296  Same as: AT+CMDDLaa=hex(bb cc)
1297 -)))
1298 1298  
1299 -(((
1300 1300   **Example:**
1301 -)))
1302 1302  
1303 -(((
1304 1304   **0xAA 01 03 E8**  ~-~-> Same as **AT+CMDDL1=1000 ms**
1305 -)))
1306 1306  
1307 1307  
1308 1308  
1309 -
1310 1310  ==== **Uplink payload mode** ====
1311 1311  
1312 -(((
1313 1313  Define to use one uplink or multiple uplinks for the sampling.
1314 -)))
1315 1315  
1316 -(((
1317 1317  The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
1318 -)))
1319 1319  
1320 -* (((
1321 -**AT Command:**
1322 -)))
1046 +* **AT Command:**
1323 1323  
1324 1324  (% class="box infomessage" %)
1325 1325  (((
1326 -(((
1327 1327  **AT+DATAUP=0**
1328 1328  )))
1329 -)))
1330 1330  
1331 1331  (% class="box infomessage" %)
1332 1332  (((
1333 -(((
1334 1334  **AT+DATAUP=1**
1335 1335  )))
1336 -)))
1337 1337  
1338 -(((
1339 -
1340 -)))
1341 1341  
1342 -* (((
1343 -**Downlink Payload:**
1344 -)))
1059 +* **Downlink Payload:**
1345 1345  
1346 -(((
1347 1347  **0xAD 00**  **~-~->** Same as AT+DATAUP=0
1348 -)))
1349 1349  
1350 -(((
1351 1351  **0xAD 01**  **~-~->** Same as AT+DATAUP=1
1352 -)))
1353 1353  
1354 1354  
1355 1355  
... ... @@ -1367,248 +1367,131 @@
1367 1367  
1368 1368  ==== **Clear RS485 Command** ====
1369 1369  
1370 -(((
1371 1371  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
1372 -)))
1373 1373  
1374 -(((
1375 -
1376 -)))
1377 1377  
1378 -* (((
1379 -**AT Command:**
1380 -)))
1084 +* **AT Command:**
1381 1381  
1382 -(((
1383 1383  (% 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
1384 -)))
1385 1385  
1386 -(((
1387 1387  Example screen shot after clear all RS485 commands. 
1388 -)))
1389 1389  
1390 -(((
1391 -
1392 -)))
1393 1393  
1394 -(((
1395 1395  The uplink screen shot is:
1396 -)))
1397 1397  
1398 -(((
1399 1399  [[image:1654134704555-320.png]]
1400 -)))
1401 1401  
1402 -(((
1403 -
1404 -)))
1405 1405  
1406 -* (((
1407 -**Downlink Payload:**
1408 -)))
1096 +* **Downlink Payload:**
1409 1409  
1410 -(((
1411 1411  **0x09 aa bb** same as AT+CMDEAR=aa,bb
1412 -)))
1413 1413  
1414 1414  
1415 1415  
1416 -
1417 1417  ==== **Set Serial Communication Parameters** ====
1418 1418  
1419 -(((
1420 1420  Set the Rs485 serial communication parameters:
1421 -)))
1422 1422  
1423 -* (((
1424 -**AT Command:**
1425 -)))
1106 +* **AT Command:**
1426 1426  
1427 -(((
1428 1428  Set Baud Rate:
1429 -)))
1430 1430  
1431 1431  (% class="box infomessage" %)
1432 1432  (((
1433 -(((
1434 1434  **AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
1435 1435  )))
1436 -)))
1437 1437  
1438 -(((
1439 1439  Set UART Parity
1440 -)))
1441 1441  
1442 1442  (% class="box infomessage" %)
1443 1443  (((
1444 -(((
1445 1445  **AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
1446 1446  )))
1447 -)))
1448 1448  
1449 -(((
1450 1450  Set STOPBIT
1451 -)))
1452 1452  
1453 1453  (% class="box infomessage" %)
1454 1454  (((
1455 -(((
1456 1456  **AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
1457 1457  )))
1458 -)))
1459 1459  
1460 -(((
1461 -
1462 -)))
1463 1463  
1464 -* (((
1465 -**Downlink Payload:**
1466 -)))
1130 +* **Downlink Payload:**
1467 1467  
1468 -(((
1469 1469  **A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
1470 -)))
1471 1471  
1472 -(((
1473 1473  **Example:**
1474 -)))
1475 1475  
1476 -* (((
1477 -A7 01 00 60   same as AT+BAUDR=9600
1478 -)))
1479 -* (((
1480 -A7 01 04 80  same as AT+BAUDR=115200
1481 -)))
1136 +* A7 01 00 60   same as AT+BAUDR=9600
1137 +* A7 01 04 80  same as AT+BAUDR=115200
1482 1482  
1483 -(((
1484 1484  A7 02 aa: Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
1485 -)))
1486 1486  
1487 -(((
1488 1488  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
1489 -)))
1490 1490  
1491 1491  
1492 1492  
1493 -
1494 1494  ==== **Control output power duration** ====
1495 1495  
1496 -(((
1497 1497  User can set the output power duration before each sampling.
1498 -)))
1499 1499  
1500 -* (((
1501 -**AT Command:**
1502 -)))
1149 +* **AT Command:**
1503 1503  
1504 -(((
1505 1505  **Example:**
1506 -)))
1507 1507  
1508 -(((
1509 1509  **AT+3V3T=1000**  ~/~/ 3V3 output power will open 1s before each sampling.
1510 -)))
1511 1511  
1512 -(((
1513 1513  **AT+5VT=1000**  ~/~/ +5V output power will open 1s before each sampling.
1514 -)))
1515 1515  
1516 -(((
1517 -
1518 -)))
1519 1519  
1520 -* (((
1521 -**LoRaWAN Downlink Command:**
1522 -)))
1158 +* **LoRaWAN Downlink Command:**
1523 1523  
1524 -(((
1525 1525  **07 01 aa bb**  Same as AT+5VT=(aa bb)
1526 -)))
1527 1527  
1528 -(((
1529 1529  **07 02 aa bb**  Same as AT+3V3T=(aa bb)
1530 -)))
1531 1531  
1532 1532  
1533 1533  
1534 1534  == 3.6 Buttons ==
1535 1535  
1536 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:233px" %)
1168 +(% border="1" style="background-color:#ffffcc; color:green; width:233px" %)
1537 1537  |=(% style="width: 89px;" %)**Button**|=(% style="width: 141px;" %)**Feature**
1538 1538  |(% style="width:89px" %)**RST**|(% style="width:141px" %)Reboot RS485-BL
1539 1539  
1540 -
1541 1541  == 3.7 +3V3 Output ==
1542 1542  
1543 -(((
1544 1544  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
1545 -)))
1546 1546  
1547 -(((
1548 1548  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. 
1549 -)))
1550 1550  
1551 -(((
1552 1552  The +3V3 output time can be controlled by AT Command.
1553 -)))
1554 1554  
1555 -(((
1556 -
1557 -)))
1558 1558  
1559 -(((
1560 1560  (% style="color:#037691" %)**AT+3V3T=1000**
1561 -)))
1562 1562  
1563 -(((
1564 -
1565 -)))
1566 1566  
1567 -(((
1568 1568  Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors.
1569 -)))
1570 1570  
1571 -(((
1572 1572  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1573 -)))
1574 1574  
1575 1575  
1576 1576  == 3.8 +5V Output ==
1577 1577  
1578 -(((
1579 1579  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
1580 -)))
1581 1581  
1582 -(((
1583 1583  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. 
1584 -)))
1585 1585  
1586 -(((
1587 1587  The 5V output time can be controlled by AT Command.
1588 -)))
1589 1589  
1590 -(((
1591 -
1592 -)))
1593 1593  
1594 -(((
1595 1595  (% style="color:#037691" %)**AT+5VT=1000**
1596 -)))
1597 1597  
1598 -(((
1599 -
1600 -)))
1601 1601  
1602 -(((
1603 1603  Means set 5V valid time to have 1000ms. So, the real 5V output will actually have 1000ms + sampling time for other sensors.
1604 -)))
1605 1605  
1606 -(((
1607 1607  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.
1608 -)))
1609 1609  
1610 1610  
1611 -
1612 1612  == 3.9 LEDs ==
1613 1613  
1614 1614  (% border="1" style="background-color:#ffffcc; color:green; width:332px" %)
... ... @@ -1615,23 +1615,24 @@
1615 1615  |=**LEDs**|=(% style="width: 274px;" %)**Feature**
1616 1616  |**LED1**|(% style="width:274px" %)Blink when device transmit a packet.
1617 1617  
1618 -
1619 1619  == 3.10 Switch Jumper ==
1620 1620  
1621 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:400px" %)
1622 -|=(% style="width: 123px;" %)**Switch Jumper**|=(% style="width: 277px;" %)**Feature**
1623 -|(% style="width:123px" %)**SW1**|(% style="width:277px" %)ISP position: Upgrade firmware via UART
1214 +(% border="1" style="background-color:#ffffcc; color:green; width:515px" %)
1215 +|=(% style="width: 124px;" %)**Switch Jumper**|=(% style="width: 388px;" %)**Feature**
1216 +|(% style="width:124px" %)**SW1**|(% style="width:388px" %)(((
1217 +ISP position: Upgrade firmware via UART
1218 +
1624 1624  Flash position: Configure device, check running status.
1625 -|(% style="width:123px" %)**SW2**|(% style="width:277px" %)5V position: set to compatible with 5v I/O.
1220 +)))
1221 +|(% style="width:124px" %)**SW2**|(% style="width:388px" %)(((
1222 +5V position: set to compatible with 5v I/O.
1223 +
1626 1626  3.3v position: set to compatible with 3.3v I/O.,
1225 +)))
1627 1627  
1628 -(((
1629 1629  **+3.3V**: is always ON
1630 -)))
1631 1631  
1632 -(((
1633 1633  **+5V**: Only open before every sampling. The time is by default, it is AT+5VT=0.  Max open time. 5000 ms.
1634 -)))
1635 1635  
1636 1636  
1637 1637  = 4. Case Study =
... ... @@ -1643,23 +1643,17 @@
1643 1643  
1644 1644  == 5.1 Access AT Command ==
1645 1645  
1646 -(((
1647 1647  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.
1648 -)))
1649 1649  
1650 1650  [[image:1654135840598-282.png]]
1651 1651  
1652 1652  
1653 -(((
1654 1654  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:
1655 -)))
1656 1656  
1657 1657  [[image:1654136105500-922.png]]
1658 1658  
1659 1659  
1660 -(((
1661 1661  More detail AT Command manual can be found at [[AT Command Manual>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]]
1662 -)))
1663 1663  
1664 1664  
1665 1665  == 5.2 Common AT Command Sequence ==
... ... @@ -1684,9 +1684,7 @@
1684 1684  )))
1685 1685  
1686 1686  
1687 -(((
1688 1688  If device already joined network:
1689 -)))
1690 1690  
1691 1691  (% class="box infomessage" %)
1692 1692  (((
... ... @@ -1725,12 +1725,10 @@
1725 1725  
1726 1726  (% style="color:red" %)**Note:**
1727 1727  
1728 -(((
1729 1729  (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server.
1730 1730  2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
1731 1731  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.
1732 1732  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
1733 -)))
1734 1734  
1735 1735  [[image:1654136435598-589.png]]
1736 1736  
... ... @@ -1739,23 +1739,13 @@
1739 1739  
1740 1740  == 6.1 How to upgrade the image? ==
1741 1741  
1742 -(((
1743 1743  The RS485-BL LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-BL to:
1744 -)))
1745 1745  
1746 -* (((
1747 -Support new features
1748 -)))
1749 -* (((
1750 -For bug fix
1751 -)))
1752 -* (((
1753 -Change LoRaWAN bands.
1754 -)))
1329 +* Support new features
1330 +* For bug fix
1331 +* Change LoRaWAN bands.
1755 1755  
1756 -(((
1757 1757  Below shows the hardware connection for how to upload an image to RS485-BL:
1758 -)))
1759 1759  
1760 1760  [[image:1654136646995-976.png]]
1761 1761  
... ... @@ -1821,7 +1821,6 @@
1821 1821  * (% style="color:blue" %)**RU864**(%%): frequency bands RU864
1822 1822  * (% style="color:blue" %)**KZ865**(%%): frequency bands KZ865
1823 1823  
1824 -
1825 1825  = 9. Packing Info =
1826 1826  
1827 1827  (((
image-20220606105412-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -13.9 KB
Content