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

From version 41.33
edited by Xiaoling
on 2022/06/06 11:18
Change comment: There is no comment for this version
To version 40.54
edited by Xiaoling
on 2022/06/06 10:51
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -501,186 +501,102 @@
501 501  )))
502 502  )))
503 503  
504 -(((
505 505  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.
506 -)))
507 507  
508 -(((
509 509  In the RS485-BL, we should use this command AT+COMMAND1=01 03 0B B8 00 02,1 for the same.
510 -)))
511 511  
512 -(((
513 -
514 -)))
515 -
516 -(((
517 517  **AT+SEARCHx**: This command defines how to handle the return from AT+COMMANDx.
518 -)))
519 519  
520 520  (% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:500px" %)
521 521  |(% style="width:577px" %)(((
522 -(((
523 523  **AT+SEARCHx=aa,xx xx xx xx xx**
524 -)))
525 525  
526 -* (((
527 -**aa: 1: prefix match mode; 2: prefix and suffix match mode**
514 +* **aa: 1: prefix match mode; 2: prefix and suffix match mode**
515 +* **xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix**
528 528  )))
529 -* (((
530 -**xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix**
531 -)))
532 -)))
533 533  
534 -(((
535 535  **Examples:**
536 -)))
537 537  
538 -(((
539 539  1)For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
540 -)))
541 541  
542 -(((
543 543  If we set AT+SEARCH1=1,1E 56 34.      (max 5 bytes for prefix)
544 -)))
545 545  
546 -(((
547 547  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**
548 -)))
549 549  
550 -(((
551 551  [[image:1653271044481-711.png]]
552 -)))
553 553  
554 -(((
555 555  2)For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
556 -)))
557 557  
558 -(((
559 559  If we set AT+SEARCH1=2, 1E 56 34+31 00 49
560 -)))
561 561  
562 -(((
563 563  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**
564 -)))
565 565  
566 -(((
567 567  [[image:1653271276735-972.png]]
568 -)))
569 569  
570 -(((
571 571  **AT+DATACUTx : **This command defines how to handle the return from AT+COMMANDx, max return length is 45 bytes.
572 -)))
573 573  
574 574  (% style="background-color:#4f81bd; color:white; width:510px" %)
575 575  |(% style="width:726px" %)(((
576 -(((
577 577  **AT+DATACUTx=a,b,c**
578 -)))
579 579  
580 -* (((
581 -**a: length for the return of AT+COMMAND**
542 +* **a: length for the return of AT+COMMAND**
543 +* **b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
544 +* **c: define the position for valid value.  **
582 582  )))
583 -* (((
584 -**b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.**
585 -)))
586 -* (((
587 -**c: define the position for valid value.  **
588 -)))
589 -)))
590 590  
591 -(((
592 592  **Examples:**
593 -)))
594 594  
595 -* (((
596 -Grab bytes:
597 -)))
549 +* Grab bytes:
598 598  
599 -(((
600 600  [[image:1653271581490-837.png||height="313" width="722"]]
601 -)))
602 602  
603 -(((
604 -
605 -)))
606 606  
607 -* (((
608 -Grab a section.
609 -)))
554 +* Grab a section.
610 610  
611 -(((
612 612  [[image:1653271648378-342.png||height="326" width="720"]]
613 -)))
614 614  
615 -(((
616 -
617 -)))
618 618  
619 -* (((
620 -Grab different sections.
621 -)))
559 +* Grab different sections.
622 622  
623 -(((
624 624  [[image:1653271657255-576.png||height="305" width="730"]]
625 -)))
626 626  
627 627  (((
628 -(((
629 629  (% style="color:red" %)**Note:**
630 630  )))
631 -)))
632 632  
633 633  (((
634 -(((
635 635  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.
636 636  )))
637 -)))
638 638  
639 639  (((
640 -(((
641 641  **Example:**
642 642  )))
643 -)))
644 644  
645 645  (((
646 -(((
647 647  (% style="color:red" %)AT+COMMAND1=11 01 1E D0,0
648 648  )))
649 -)))
650 650  
651 651  (((
652 -(((
653 653  (% style="color:red" %)AT+SEARCH1=1,1E 56 34
654 654  )))
655 -)))
656 656  
657 657  (((
658 -(((
659 659  (% style="color:red" %)AT+DATACUT1=0,2,1~~5
660 660  )))
661 -)))
662 662  
663 663  (((
664 -(((
665 665  (% style="color:red" %)Return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
666 666  )))
667 -)))
668 668  
669 669  (((
670 -(((
671 671  (% style="color:red" %)String after SEARCH command: 2e 30 58 5f 36 41 30 31 00 49
672 672  )))
673 -)))
674 674  
675 675  (((
676 -(((
677 677  (% style="color:red" %)Valid payload after DataCUT command: 2e 30 58 5f 36
678 678  )))
679 -)))
680 680  
681 -(((
682 682  [[image:1653271763403-806.png]]
683 -)))
684 684  
685 685  
686 686  === 3.3.4 Compose the uplink payload ===
... ... @@ -827,8 +827,26 @@
827 827  
828 828  == 3.4 Uplink Payload ==
829 829  
830 -[[image:image-20220606105412-1.png]]
746 +(% border="1" style="background-color:#4f81bd; color:white; width:850px" %)
747 +|**Size(bytes)**|(% style="width:130px" %)**2**|(% style="width:93px" %)**1**|(% style="width:509px" %)**Length depends on the return from the commands**
748 +|Value|(% style="width:130px" %)(((
749 +(((
750 +Battery(mV)
751 +)))
831 831  
753 +(((
754 +&
755 +)))
756 +
757 +(((
758 +Interrupt _Flag
759 +)))
760 +)))|(% style="width:93px" %)(((
761 +PAYLOAD_VER
762 +
763 +
764 +)))|(% 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.
765 +
832 832  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
833 833  
834 834  (((
... ... @@ -872,7 +872,7 @@
872 872  )))
873 873  
874 874  (((
875 -{{{}}}}
809 +**}**
876 876  
877 877  
878 878  )))
... ... @@ -886,24 +886,14 @@
886 886  
887 887  == 3.5 Configure RS485-BL via AT or Downlink ==
888 888  
889 -(((
890 890  User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands
891 -)))
892 892  
893 -(((
894 894  There are two kinds of Commands:
895 -)))
896 896  
897 -* (((
898 -(% 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]]
899 -)))
827 +* (% 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]]
900 900  
901 -* (((
902 -(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
903 -)))
829 +* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
904 904  
905 -
906 -
907 907  === 3.5.1 Common Commands: ===
908 908  
909 909  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]]
... ... @@ -912,7 +912,6 @@
912 912  === 3.5.2 Sensor related commands: ===
913 913  
914 914  
915 -
916 916  ==== **Choose Device Type (RS485 or TTL)** ====
917 917  
918 918  RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
... ... @@ -936,109 +936,57 @@
936 936  
937 937  
938 938  
939 -
940 940  ==== **RS485 Debug Command (AT+CFGDEV)** ====
941 941  
942 -(((
943 943  This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
944 -)))
945 945  
946 -* (((
947 -**AT Command**
948 -)))
866 +* **AT Command**
949 949  
950 950  (% class="box infomessage" %)
951 951  (((
952 -(((
953 953  **AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
954 954  )))
955 -)))
956 956  
957 -(((
958 958  m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command.
959 -)))
960 960  
961 -(((
962 -
963 -)))
964 964  
965 -* (((
966 -**Downlink Payload**
967 -)))
876 +* **Downlink Payload**
968 968  
969 -(((
970 970  Format: A8 MM NN XX XX XX XX YY
971 -)))
972 972  
973 -(((
974 974  Where:
975 -)))
976 976  
977 -* (((
978 -MM: 1: add CRC-16/MODBUS ; 0: no CRC
979 -)))
980 -* (((
981 -NN: The length of RS485 command
982 -)))
983 -* (((
984 -XX XX XX XX: RS485 command total NN bytes
985 -)))
986 -* (((
987 -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
988 -)))
882 +* MM: 1: add CRC-16/MODBUS ; 0: no CRC
883 +* NN: The length of RS485 command
884 +* XX XX XX XX: RS485 command total NN bytes
885 +* 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
989 989  
990 -(((
991 991  **Example 1:**
992 -)))
993 993  
994 -(((
995 995  To connect a Modbus Alarm with below commands.
996 -)))
997 997  
998 -* (((
999 -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.
1000 -)))
891 +* 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.
1001 1001  
1002 -* (((
1003 -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.
1004 -)))
893 +* 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.
1005 1005  
1006 -(((
1007 1007  So if user want to use downlink command to control to RS485 Alarm, he can use:
1008 -)))
1009 1009  
1010 -(((
1011 1011  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
1012 -)))
1013 1013  
1014 -(((
1015 1015  (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
1016 -)))
1017 1017  
1018 -(((
1019 1019  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.
1020 -)))
1021 1021  
1022 -(((
1023 -
1024 -)))
1025 1025  
1026 -(((
1027 1027  **Example 2:**
1028 -)))
1029 1029  
1030 -(((
1031 1031  Check TTL Sensor return:
1032 -)))
1033 1033  
1034 -(((
1035 1035  [[image:1654132684752-193.png]]
1036 -)))
1037 1037  
1038 1038  
1039 1039  
1040 1040  
1041 -
1042 1042  ==== **Set Payload version** ====
1043 1043  
1044 1044  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.
... ... @@ -1059,7 +1059,6 @@
1059 1059  
1060 1060  
1061 1061  
1062 -
1063 1063  ==== **Set RS485 Sampling Commands** ====
1064 1064  
1065 1065  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
... ... @@ -1121,7 +1121,6 @@
1121 1121  
1122 1122  
1123 1123  
1124 -
1125 1125  ==== **Fast command to handle MODBUS device** ====
1126 1126  
1127 1127  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]].
... ... @@ -1155,7 +1155,6 @@
1155 1155  
1156 1156  
1157 1157  
1158 -
1159 1159  ==== **RS485 command timeout** ====
1160 1160  
1161 1161  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.
... ... @@ -1187,7 +1187,6 @@
1187 1187  
1188 1188  
1189 1189  
1190 -
1191 1191  ==== **Uplink payload mode** ====
1192 1192  
1193 1193  Define to use one uplink or multiple uplinks for the sampling.
... ... @@ -1234,9 +1234,7 @@
1234 1234  
1235 1235  * **AT Command:**
1236 1236  
1237 -(((
1238 1238  (% 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
1239 -)))
1240 1240  
1241 1241  Example screen shot after clear all RS485 commands. 
1242 1242  
... ... @@ -1252,7 +1252,6 @@
1252 1252  
1253 1253  
1254 1254  
1255 -
1256 1256  ==== **Set Serial Communication Parameters** ====
1257 1257  
1258 1258  Set the Rs485 serial communication parameters:
... ... @@ -1296,7 +1296,6 @@
1296 1296  
1297 1297  
1298 1298  
1299 -
1300 1300  ==== **Control output power duration** ====
1301 1301  
1302 1302  User can set the output power duration before each sampling.
... ... @@ -1320,83 +1320,44 @@
1320 1320  
1321 1321  == 3.6 Buttons ==
1322 1322  
1323 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:233px" %)
1186 +(% border="1" style="background-color:#ffffcc; color:green; width:233px" %)
1324 1324  |=(% style="width: 89px;" %)**Button**|=(% style="width: 141px;" %)**Feature**
1325 1325  |(% style="width:89px" %)**RST**|(% style="width:141px" %)Reboot RS485-BL
1326 1326  
1327 -
1328 -
1329 1329  == 3.7 +3V3 Output ==
1330 1330  
1331 -(((
1332 1332  RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor.
1333 -)))
1334 1334  
1335 -(((
1336 1336  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. 
1337 -)))
1338 1338  
1339 -(((
1340 1340  The +3V3 output time can be controlled by AT Command.
1341 -)))
1342 1342  
1343 -(((
1344 -
1345 -)))
1346 1346  
1347 -(((
1348 1348  (% style="color:#037691" %)**AT+3V3T=1000**
1349 -)))
1350 1350  
1351 -(((
1352 -
1353 -)))
1354 1354  
1355 -(((
1356 1356  Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors.
1357 -)))
1358 1358  
1359 -(((
1360 1360  By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time
1361 -)))
1362 1362  
1363 1363  
1364 1364  == 3.8 +5V Output ==
1365 1365  
1366 -(((
1367 1367  RS485-BL has a Controllable +5V output, user can use this output to power external sensor.
1368 -)))
1369 1369  
1370 -(((
1371 1371  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. 
1372 -)))
1373 1373  
1374 -(((
1375 1375  The 5V output time can be controlled by AT Command.
1376 -)))
1377 1377  
1378 -(((
1379 -
1380 -)))
1381 1381  
1382 -(((
1383 1383  (% style="color:#037691" %)**AT+5VT=1000**
1384 -)))
1385 1385  
1386 -(((
1387 -
1388 -)))
1389 1389  
1390 -(((
1391 1391  Means set 5V valid time to have 1000ms. So, the real 5V output will actually have 1000ms + sampling time for other sensors.
1392 -)))
1393 1393  
1394 -(((
1395 1395  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.
1396 -)))
1397 1397  
1398 1398  
1399 -
1400 1400  == 3.9 LEDs ==
1401 1401  
1402 1402  (% border="1" style="background-color:#ffffcc; color:green; width:332px" %)
... ... @@ -1403,8 +1403,6 @@
1403 1403  |=**LEDs**|=(% style="width: 274px;" %)**Feature**
1404 1404  |**LED1**|(% style="width:274px" %)Blink when device transmit a packet.
1405 1405  
1406 -
1407 -
1408 1408  == 3.10 Switch Jumper ==
1409 1409  
1410 1410  (% border="1" style="background-color:#ffffcc; color:green; width:515px" %)
... ... @@ -1420,13 +1420,9 @@
1420 1420  3.3v position: set to compatible with 3.3v I/O.,
1421 1421  )))
1422 1422  
1423 -(((
1424 1424  **+3.3V**: is always ON
1425 -)))
1426 1426  
1427 -(((
1428 1428  **+5V**: Only open before every sampling. The time is by default, it is AT+5VT=0.  Max open time. 5000 ms.
1429 -)))
1430 1430  
1431 1431  
1432 1432  = 4. Case Study =
... ... @@ -1438,23 +1438,17 @@
1438 1438  
1439 1439  == 5.1 Access AT Command ==
1440 1440  
1441 -(((
1442 1442  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.
1443 -)))
1444 1444  
1445 1445  [[image:1654135840598-282.png]]
1446 1446  
1447 1447  
1448 -(((
1449 1449  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:
1450 -)))
1451 1451  
1452 1452  [[image:1654136105500-922.png]]
1453 1453  
1454 1454  
1455 -(((
1456 1456  More detail AT Command manual can be found at [[AT Command Manual>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]]
1457 -)))
1458 1458  
1459 1459  
1460 1460  == 5.2 Common AT Command Sequence ==
... ... @@ -1479,9 +1479,7 @@
1479 1479  )))
1480 1480  
1481 1481  
1482 -(((
1483 1483  If device already joined network:
1484 -)))
1485 1485  
1486 1486  (% class="box infomessage" %)
1487 1487  (((
... ... @@ -1520,12 +1520,10 @@
1520 1520  
1521 1521  (% style="color:red" %)**Note:**
1522 1522  
1523 -(((
1524 1524  (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server.
1525 1525  2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting.
1526 1526  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.
1527 1527  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
1528 -)))
1529 1529  
1530 1530  [[image:1654136435598-589.png]]
1531 1531  
... ... @@ -1534,23 +1534,13 @@
1534 1534  
1535 1535  == 6.1 How to upgrade the image? ==
1536 1536  
1537 -(((
1538 1538  The RS485-BL LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-BL to:
1539 -)))
1540 1540  
1541 -* (((
1542 -Support new features
1543 -)))
1544 -* (((
1545 -For bug fix
1546 -)))
1547 -* (((
1548 -Change LoRaWAN bands.
1549 -)))
1347 +* Support new features
1348 +* For bug fix
1349 +* Change LoRaWAN bands.
1550 1550  
1551 -(((
1552 1552  Below shows the hardware connection for how to upload an image to RS485-BL:
1553 -)))
1554 1554  
1555 1555  [[image:1654136646995-976.png]]
1556 1556  
... ... @@ -1616,8 +1616,6 @@
1616 1616  * (% style="color:blue" %)**RU864**(%%): frequency bands RU864
1617 1617  * (% style="color:blue" %)**KZ865**(%%): frequency bands KZ865
1618 1618  
1619 -
1620 -
1621 1621  = 9. Packing Info =
1622 1622  
1623 1623  (((
image-20220606105412-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -13.9 KB
Content