Changes for page RS485-BL – Waterproof RS485 to LoRaWAN Converter
Last modified by Xiaoling on 2025/04/23 15:57
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 1 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -130,29 +130,47 @@ 130 130 ((( 131 131 132 132 133 +((( 133 133 v1.4 134 134 ))) 136 +))) 135 135 136 136 ((( 139 +((( 137 137 ~1. Change Power IC to TPS22916 138 138 ))) 142 +))) 139 139 144 +((( 145 + 146 +))) 140 140 141 141 ((( 149 +((( 142 142 v1.3 143 143 ))) 152 +))) 144 144 145 145 ((( 155 +((( 146 146 ~1. Change JP3 from KF350-8P to KF350-11P, Add one extra interface for I2C and one extra interface for one-wire 147 147 ))) 158 +))) 148 148 160 +((( 161 + 162 +))) 149 149 150 150 ((( 165 +((( 151 151 v1.2 152 152 ))) 168 +))) 153 153 154 154 ((( 171 +((( 155 155 Release version 173 +))) 156 156 157 157 158 158 ))) ... ... @@ -246,82 +246,132 @@ 246 246 247 247 === 3.3.1 onfigure UART settings for RS485 or TTL communication === 248 248 267 +((( 249 249 RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect. 269 +))) 250 250 271 +((( 251 251 **~1. RS485-MODBUS mode:** 273 +))) 252 252 275 +((( 253 253 AT+MOD=1 ~/~/ Support RS485-MODBUS type sensors. User can connect multiply RS485 , Modbus sensors to the A / B pins. 277 +))) 254 254 279 +((( 255 255 **2. TTL mode:** 281 +))) 256 256 283 +((( 257 257 AT+MOD=2 ~/~/ Support TTL Level sensors, User can connect one TTL Sensor to the TXD/RXD/GND pins. 285 +))) 258 258 287 +((( 259 259 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. 289 +))) 260 260 261 -(% border="1" style="background-color:#ffffcc; color:green; width:795px" %) 262 -|((( 291 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 292 +|=(% style="width: 80px;" %)((( 293 +((( 263 263 **AT Commands** 264 -)))|(% style="width:285px" %)((( 295 +))) 296 +)))|=(% style="width: 210px;" %)((( 297 +((( 265 265 **Description** 266 -)))|(% style="width:347px" %)((( 299 +))) 300 +)))|=(% style="width: 210px;" %)((( 301 +((( 267 267 **Example** 268 268 ))) 269 -|((( 304 +))) 305 +|(% style="width:80px" %)((( 306 +((( 270 270 AT+BAUDR 271 -)))|(% style="width:285px" %)((( 308 +))) 309 +)))|(% style="width:210px" %)((( 310 +((( 272 272 Set the baud rate (for RS485 connection). Default Value is: 9600. 273 -)))|(% style="width:347px" %)((( 312 +))) 313 +)))|(% style="width:210px" %)((( 274 274 ((( 315 +((( 275 275 AT+BAUDR=9600 276 276 ))) 318 +))) 277 277 278 278 ((( 321 +((( 279 279 Options: (1200,2400,4800,14400,19200,115200) 280 280 ))) 281 281 ))) 282 -|((( 325 +))) 326 +|(% style="width:80px" %)((( 327 +((( 283 283 AT+PARITY 284 -)))|(% style="width:285px" %)((( 329 +))) 330 +)))|(% style="width:210px" %)((( 285 285 ((( 332 +((( 286 286 Set UART parity (for RS485 connection) 287 287 ))) 335 +))) 288 288 289 289 ((( 338 +((( 290 290 Default Value is: no parity. 291 291 ))) 292 -)))|(% style="width:347px" %)((( 341 +))) 342 +)))|(% style="width:210px" %)((( 293 293 ((( 344 +((( 294 294 AT+PARITY=0 295 295 ))) 347 +))) 296 296 297 297 ((( 350 +((( 298 298 Option: 0: no parity, 1: odd parity, 2: even parity 299 299 ))) 300 300 ))) 301 -|((( 354 +))) 355 +|(% style="width:80px" %)((( 356 +((( 302 302 AT+STOPBIT 303 -)))|(% style="width:285px" %)((( 358 +))) 359 +)))|(% style="width:210px" %)((( 304 304 ((( 361 +((( 305 305 Set serial stopbit (for RS485 connection) 306 306 ))) 364 +))) 307 307 308 308 ((( 367 +((( 309 309 Default Value is: 1bit. 310 310 ))) 311 -)))|(% style="width:347px" %)((( 370 +))) 371 +)))|(% style="width:210px" %)((( 312 312 ((( 373 +((( 313 313 AT+STOPBIT=0 for 1bit 314 314 ))) 376 +))) 315 315 316 316 ((( 379 +((( 317 317 AT+STOPBIT=1 for 1.5 bit 318 318 ))) 382 +))) 319 319 320 320 ((( 385 +((( 321 321 AT+STOPBIT=2 for 2 bits 322 322 ))) 323 323 ))) 389 +))) 324 324 391 + 392 + 325 325 === 3.3.2 Configure sensors === 326 326 327 327 ((( ... ... @@ -332,19 +332,20 @@ 332 332 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. 333 333 ))) 334 334 335 -(% border="1" style="background-color:#ffffcc; color:green; width: 806px" %)336 -|**AT Commands**|(% style="width: 418px" %)**Description**|(% style="width:256px" %)**Example**337 -|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" %)((( 338 338 This command is used to configure the RS485/TTL devices; they won’t be used during sampling. 339 339 340 340 AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx, 341 341 342 342 mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command 343 -)))|(% style="width:2 56px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m411 +)))|(% style="width:210px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m 344 344 345 345 Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>||anchor="HRS485DebugCommand28AT2BCFGDEV29"]]. 346 346 347 347 416 + 348 348 === 3.3.3 Configure read commands for each sampling === 349 349 350 350 ((( ... ... @@ -411,117 +411,213 @@ 411 411 After we got the valid value from each RS485 commands, we need to combine them together with the command **AT+DATAUP**. 412 412 ))) 413 413 483 +((( 414 414 **Examples:** 485 +))) 415 415 487 +((( 416 416 Below are examples for the how above AT Commands works. 489 +))) 417 417 491 +((( 418 418 **AT+COMMANDx : **This command will be sent to RS485/TTL devices during each sampling, Max command length is 14 bytes. The grammar is: 493 +))) 419 419 420 -(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:50 1px" %)495 +(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:500px" %) 421 421 |(% style="width:498px" %)((( 497 +((( 422 422 **AT+COMMANDx=xx xx xx xx xx xx xx xx xx xx xx xx,m** 499 +))) 423 423 501 +((( 424 424 **xx xx xx xx xx xx xx xx xx xx xx xx: The RS485 command to be sent** 503 +))) 425 425 505 +((( 426 426 **m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command** 427 427 ))) 508 +))) 428 428 510 +((( 429 429 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 +))) 430 430 514 +((( 431 431 In the RS485-BL, we should use this command AT+COMMAND1=01 03 0B B8 00 02,1 for the same. 516 +))) 432 432 518 +((( 519 + 520 +))) 521 + 522 +((( 433 433 **AT+SEARCHx**: This command defines how to handle the return from AT+COMMANDx. 524 +))) 434 434 435 -(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:5 80px" %)526 +(% border="1" class="table-bordered" style="background-color:#4f81bd; color:white; width:500px" %) 436 436 |(% style="width:577px" %)((( 528 +((( 437 437 **AT+SEARCHx=aa,xx xx xx xx xx** 530 +))) 438 438 439 -* **aa: 1: prefix match mode; 2: prefix and suffix match mode**440 -* *xxxxxxxx xx:matchstring. Max 5 bytesforprefix and5 bytesfor suffix**532 +* ((( 533 +**aa: 1: prefix match mode; 2: prefix and suffix match mode** 441 441 ))) 535 +* ((( 536 +**xx xx xx xx xx: match string. Max 5 bytes for prefix and 5 bytes for suffix** 537 +))) 538 +))) 442 442 540 +((( 443 443 **Examples:** 542 +))) 444 444 544 +((( 445 445 1)For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49 546 +))) 446 446 548 +((( 447 447 If we set AT+SEARCH1=1,1E 56 34. (max 5 bytes for prefix) 550 +))) 448 448 552 +((( 449 449 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 +))) 450 450 556 +((( 451 451 [[image:1653271044481-711.png]] 558 +))) 452 452 560 +((( 453 453 2)For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49 562 +))) 454 454 564 +((( 455 455 If we set AT+SEARCH1=2, 1E 56 34+31 00 49 566 +))) 456 456 568 +((( 457 457 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 +))) 458 458 572 +((( 459 459 [[image:1653271276735-972.png]] 574 +))) 460 460 576 +((( 461 461 **AT+DATACUTx : **This command defines how to handle the return from AT+COMMANDx, max return length is 45 bytes. 578 +))) 462 462 463 -(% style="background-color:#4f81bd; color:white; width: 729px" %)580 +(% style="background-color:#4f81bd; color:white; width:510px" %) 464 464 |(% style="width:726px" %)((( 582 +((( 465 465 **AT+DATACUTx=a,b,c** 584 +))) 466 466 467 -* **a: length for the return of AT+COMMAND** 468 -* **b:1: grab valid value by byte, max 6 bytes. 2: grab valid value by bytes section, max 3 sections.** 469 -* **c: define the position for valid value. ** 586 +* ((( 587 +**a: length for the return of AT+COMMAND** 470 470 ))) 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 +))) 471 471 597 +((( 472 472 **Examples:** 599 +))) 473 473 474 -* Grab bytes: 601 +* ((( 602 +Grab bytes: 603 +))) 475 475 605 +((( 476 476 [[image:1653271581490-837.png||height="313" width="722"]] 607 +))) 477 477 609 +((( 610 + 611 +))) 478 478 479 -* Grab a section. 613 +* ((( 614 +Grab a section. 615 +))) 480 480 617 +((( 481 481 [[image:1653271648378-342.png||height="326" width="720"]] 619 +))) 482 482 621 +((( 622 + 623 +))) 483 483 484 -* Grab different sections. 625 +* ((( 626 +Grab different sections. 627 +))) 485 485 629 +((( 486 486 [[image:1653271657255-576.png||height="305" width="730"]] 631 +))) 487 487 488 488 ((( 634 +((( 489 489 (% style="color:red" %)**Note:** 490 490 ))) 637 +))) 491 491 492 492 ((( 640 +((( 493 493 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. 494 494 ))) 643 +))) 495 495 496 496 ((( 646 +((( 497 497 **Example:** 498 498 ))) 649 +))) 499 499 500 500 ((( 652 +((( 501 501 (% style="color:red" %)AT+COMMAND1=11 01 1E D0,0 502 502 ))) 655 +))) 503 503 504 504 ((( 658 +((( 505 505 (% style="color:red" %)AT+SEARCH1=1,1E 56 34 506 506 ))) 661 +))) 507 507 508 508 ((( 664 +((( 509 509 (% style="color:red" %)AT+DATACUT1=0,2,1~~5 510 510 ))) 667 +))) 511 511 512 512 ((( 670 +((( 513 513 (% style="color:red" %)Return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49 514 514 ))) 673 +))) 515 515 516 516 ((( 676 +((( 517 517 (% style="color:red" %)String after SEARCH command: 2e 30 58 5f 36 41 30 31 00 49 518 518 ))) 679 +))) 519 519 520 520 ((( 682 +((( 521 521 (% style="color:red" %)Valid payload after DataCUT command: 2e 30 58 5f 36 522 522 ))) 685 +))) 523 523 687 +((( 524 524 [[image:1653271763403-806.png]] 689 +))) 525 525 526 526 527 527 === 3.3.4 Compose the uplink payload === ... ... @@ -528,10 +528,14 @@ 528 528 529 529 ((( 530 530 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 + 531 531 ))) 532 532 533 533 ((( 534 534 (% style="color:#037691" %)**Examples: AT+DATAUP=0** 702 + 703 + 535 535 ))) 536 536 537 537 ((( ... ... @@ -664,26 +664,8 @@ 664 664 665 665 == 3.4 Uplink Payload == 666 666 667 -(% border="1" style="background-color:#4f81bd; color:white; width:850px" %) 668 -|**Size(bytes)**|(% style="width:130px" %)**2**|(% style="width:93px" %)**1**|(% style="width:509px" %)**Length depends on the return from the commands** 669 -|Value|(% style="width:130px" %)((( 670 -((( 671 -Battery(mV) 672 -))) 836 +[[image:image-20220606105412-1.png]] 673 673 674 -((( 675 -& 676 -))) 677 - 678 -((( 679 -Interrupt _Flag 680 -))) 681 -)))|(% style="width:93px" %)((( 682 -PAYLOAD_VER 683 - 684 - 685 -)))|(% 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. 686 - 687 687 Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors. 688 688 689 689 ((( ... ... @@ -741,16 +741,23 @@ 741 741 742 742 == 3.5 Configure RS485-BL via AT or Downlink == 743 743 895 +((( 744 744 User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands 897 +))) 745 745 899 +((( 746 746 There are two kinds of Commands: 901 +))) 747 747 748 -* (% 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]] 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 +))) 749 749 750 -* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL. User can see these commands below: 907 +* ((( 908 +(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL. User can see these commands below: 909 +))) 751 751 752 752 753 - 754 754 === 3.5.1 Common Commands: === 755 755 756 756 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]] ... ... @@ -759,6 +759,7 @@ 759 759 === 3.5.2 Sensor related commands: === 760 760 761 761 920 + 762 762 ==== **Choose Device Type (RS485 or TTL)** ==== 763 763 764 764 RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect. ... ... @@ -782,57 +782,109 @@ 782 782 783 783 784 784 944 + 785 785 ==== **RS485 Debug Command (AT+CFGDEV)** ==== 786 786 947 +((( 787 787 This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling. 949 +))) 788 788 789 -* **AT Command** 951 +* ((( 952 +**AT Command** 953 +))) 790 790 791 791 (% class="box infomessage" %) 792 792 ((( 957 +((( 793 793 **AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m** 794 794 ))) 960 +))) 795 795 962 +((( 796 796 m: 0: no CRC; 1: add CRC-16/MODBUS in the end of this command. 964 +))) 797 797 966 +((( 967 + 968 +))) 798 798 799 -* **Downlink Payload** 970 +* ((( 971 +**Downlink Payload** 972 +))) 800 800 974 +((( 801 801 Format: A8 MM NN XX XX XX XX YY 976 +))) 802 802 978 +((( 803 803 Where: 980 +))) 804 804 805 -* MM: 1: add CRC-16/MODBUS ; 0: no CRC 806 -* NN: The length of RS485 command 807 -* XX XX XX XX: RS485 command total NN bytes 808 -* 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 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 +))) 809 809 995 +((( 810 810 **Example 1:** 997 +))) 811 811 999 +((( 812 812 To connect a Modbus Alarm with below commands. 1001 +))) 813 813 814 -* 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. 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 +))) 815 815 816 -* 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. 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 +))) 817 817 1011 +((( 818 818 So if user want to use downlink command to control to RS485 Alarm, he can use: 1013 +))) 819 819 1015 +((( 820 820 (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm 1017 +))) 821 821 1019 +((( 822 822 (% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm 1021 +))) 823 823 1023 +((( 824 824 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 +))) 825 825 1027 +((( 1028 + 1029 +))) 826 826 1031 +((( 827 827 **Example 2:** 1033 +))) 828 828 1035 +((( 829 829 Check TTL Sensor return: 1037 +))) 830 830 1039 +((( 831 831 [[image:1654132684752-193.png]] 1041 +))) 832 832 833 833 834 834 835 835 1046 + 836 836 ==== **Set Payload version** ==== 837 837 838 838 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. ... ... @@ -853,87 +853,171 @@ 853 853 854 854 855 855 1067 + 856 856 ==== **Set RS485 Sampling Commands** ==== 857 857 1070 +((( 858 858 AT+COMMANDx, AT+DATACUTx and AT+SEARCHx 1072 +))) 859 859 1074 +((( 860 860 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 +))) 861 861 1078 +((( 1079 + 1080 +))) 862 862 863 -* **AT Command:** 1082 +* ((( 1083 +**AT Command:** 1084 +))) 864 864 865 865 (% class="box infomessage" %) 866 866 ((( 1088 +((( 867 867 **AT+COMMANDx: Configure RS485 read command to sensor.** 868 868 ))) 1091 +))) 869 869 870 870 (% class="box infomessage" %) 871 871 ((( 1095 +((( 872 872 **AT+DATACUTx: Configure how to handle return from RS485 devices.** 873 873 ))) 1098 +))) 874 874 875 875 (% class="box infomessage" %) 876 876 ((( 1102 +((( 877 877 **AT+SEARCHx: Configure search command** 878 878 ))) 1105 +))) 879 879 1107 +((( 1108 + 1109 +))) 880 880 881 -* **Downlink Payload:** 1111 +* ((( 1112 +**Downlink Payload:** 1113 +))) 882 882 1115 +((( 883 883 **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx. 1117 +))) 884 884 1119 +((( 885 885 (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink. 1121 +))) 886 886 1123 +((( 887 887 Format: AF MM NN LL XX XX XX XX YY 1125 +))) 888 888 1127 +((( 889 889 Where: 1129 +))) 890 890 891 -* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F, 892 -* NN: 0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value. 893 -* LL: The length of AT+COMMAND or AT+DATACUT command 894 -* XX XX XX XX: AT+COMMAND or AT+DATACUT command 895 -* 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. 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 +))) 896 896 1147 +((( 897 897 **Example:** 1149 +))) 898 898 1151 +((( 899 899 (% 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 +))) 900 900 1155 +((( 901 901 (% 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 +))) 902 902 1159 +((( 903 903 (% 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 +))) 904 904 1163 +((( 1164 + 1165 +))) 905 905 1167 +((( 906 906 **0xAB** downlink command can be used for set AT+SEARCHx 1169 +))) 907 907 1171 +((( 908 908 **Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So 1173 +))) 909 909 910 -* AB aa 01 03 xx xx xx same as AT+SEARCHaa=1,xx xx xx 911 -* 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 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 +))) 912 912 1182 +((( 913 913 **AB aa 02 03 xx xx xx 02 yy yy** same as **AT+SEARCHaa=2,xx xx xx+yy yy** 1184 +))) 914 914 915 915 916 916 1188 + 917 917 ==== **Fast command to handle MODBUS device** ==== 918 918 1191 +((( 919 919 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 +))) 920 920 1195 +((( 921 921 This command is valid since v1.3 firmware version 1197 +))) 922 922 1199 +((( 1200 + 1201 +))) 923 923 1203 +((( 924 924 **AT+MBFUN has only two value:** 1205 +))) 925 925 926 -* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return 1207 +* ((( 1208 +**AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return 1209 +))) 927 927 1211 +((( 928 928 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 +))) 929 929 930 -* **AT+MBFUN=0**: Disable Modbus fast reading. 1215 +* ((( 1216 +**AT+MBFUN=0**: Disable Modbus fast reading. 1217 +))) 931 931 1219 +((( 932 932 **Example:** 1221 +))) 933 933 934 -* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). 935 -* 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. 936 -* 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. 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 +))) 937 937 938 938 [[image:1654133913295-597.png]] 939 939 ... ... @@ -941,70 +941,124 @@ 941 941 [[image:1654133954153-643.png]] 942 942 943 943 944 -* **Downlink Commands:** 1239 +* ((( 1240 +**Downlink Commands:** 1241 +))) 945 945 1243 +((( 946 946 **A9 aa** ~-~-> Same as AT+MBFUN=aa 1245 +))) 947 947 948 948 949 949 1249 + 950 950 ==== **RS485 command timeout** ==== 951 951 1252 +((( 952 952 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 +))) 953 953 1256 +((( 954 954 Default value: 0, range: 0 ~~ 5 seconds 1258 +))) 955 955 1260 +((( 1261 + 1262 +))) 956 956 957 -* **AT Command:** 1264 +* ((( 1265 +**AT Command:** 1266 +))) 958 958 959 959 (% class="box infomessage" %) 960 960 ((( 1270 +((( 961 961 **AT+CMDDLaa=hex(bb cc)** 962 962 ))) 1273 +))) 963 963 1275 +((( 964 964 **Example:** 1277 +))) 965 965 1279 +((( 966 966 **AT+CMDDL1=1000** to send the open time to 1000ms 1281 +))) 967 967 1283 +((( 1284 + 1285 +))) 968 968 969 -* **Downlink Payload:** 1287 +* ((( 1288 +**Downlink Payload:** 1289 +))) 970 970 1291 +((( 971 971 0x AA aa bb cc 1293 +))) 972 972 1295 +((( 973 973 Same as: AT+CMDDLaa=hex(bb cc) 1297 +))) 974 974 1299 +((( 975 975 **Example:** 1301 +))) 976 976 1303 +((( 977 977 **0xAA 01 03 E8** ~-~-> Same as **AT+CMDDL1=1000 ms** 1305 +))) 978 978 979 979 980 980 1309 + 981 981 ==== **Uplink payload mode** ==== 982 982 1312 +((( 983 983 Define to use one uplink or multiple uplinks for the sampling. 1314 +))) 984 984 1316 +((( 985 985 The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]] 1318 +))) 986 986 987 -* **AT Command:** 1320 +* ((( 1321 +**AT Command:** 1322 +))) 988 988 989 989 (% class="box infomessage" %) 990 990 ((( 1326 +((( 991 991 **AT+DATAUP=0** 992 992 ))) 1329 +))) 993 993 994 994 (% class="box infomessage" %) 995 995 ((( 1333 +((( 996 996 **AT+DATAUP=1** 997 997 ))) 1336 +))) 998 998 1338 +((( 1339 + 1340 +))) 999 999 1000 -* **Downlink Payload:** 1342 +* ((( 1343 +**Downlink Payload:** 1344 +))) 1001 1001 1346 +((( 1002 1002 **0xAD 00** **~-~->** Same as AT+DATAUP=0 1348 +))) 1003 1003 1350 +((( 1004 1004 **0xAD 01** **~-~->** Same as AT+DATAUP=1 1352 +))) 1005 1005 1006 1006 1007 1007 1356 + 1008 1008 ==== **Manually trigger an Uplink** ==== 1009 1009 1010 1010 Ask device to send an uplink immediately. ... ... @@ -1015,134 +1015,251 @@ 1015 1015 1016 1016 1017 1017 1367 + 1018 1018 ==== **Clear RS485 Command** ==== 1019 1019 1370 +((( 1020 1020 The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them. 1372 +))) 1021 1021 1374 +((( 1375 + 1376 +))) 1022 1022 1023 -* **AT Command:** 1378 +* ((( 1379 +**AT Command:** 1380 +))) 1024 1024 1382 +((( 1025 1025 (% 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 +))) 1026 1026 1386 +((( 1027 1027 Example screen shot after clear all RS485 commands. 1388 +))) 1028 1028 1390 +((( 1391 + 1392 +))) 1029 1029 1394 +((( 1030 1030 The uplink screen shot is: 1396 +))) 1031 1031 1398 +((( 1032 1032 [[image:1654134704555-320.png]] 1400 +))) 1033 1033 1402 +((( 1403 + 1404 +))) 1034 1034 1035 -* **Downlink Payload:** 1406 +* ((( 1407 +**Downlink Payload:** 1408 +))) 1036 1036 1410 +((( 1037 1037 **0x09 aa bb** same as AT+CMDEAR=aa,bb 1412 +))) 1038 1038 1039 1039 1040 1040 1416 + 1041 1041 ==== **Set Serial Communication Parameters** ==== 1042 1042 1419 +((( 1043 1043 Set the Rs485 serial communication parameters: 1421 +))) 1044 1044 1045 -* **AT Command:** 1423 +* ((( 1424 +**AT Command:** 1425 +))) 1046 1046 1427 +((( 1047 1047 Set Baud Rate: 1429 +))) 1048 1048 1049 1049 (% class="box infomessage" %) 1050 1050 ((( 1433 +((( 1051 1051 **AT+BAUDR=9600** ~/~/ Options: (1200,2400,4800,14400,19200,115200) 1052 1052 ))) 1436 +))) 1053 1053 1438 +((( 1054 1054 Set UART Parity 1440 +))) 1055 1055 1056 1056 (% class="box infomessage" %) 1057 1057 ((( 1444 +((( 1058 1058 **AT+PARITY=0** ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity 1059 1059 ))) 1447 +))) 1060 1060 1449 +((( 1061 1061 Set STOPBIT 1451 +))) 1062 1062 1063 1063 (% class="box infomessage" %) 1064 1064 ((( 1455 +((( 1065 1065 **AT+STOPBIT=0** ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits 1066 1066 ))) 1458 +))) 1067 1067 1460 +((( 1461 + 1462 +))) 1068 1068 1069 -* **Downlink Payload:** 1464 +* ((( 1465 +**Downlink Payload:** 1466 +))) 1070 1070 1468 +((( 1071 1071 **A7 01 aa bb**: Same AT+BAUDR=hex(aa bb)*100 1470 +))) 1072 1072 1472 +((( 1073 1073 **Example:** 1474 +))) 1074 1074 1075 -* A7 01 00 60 same as AT+BAUDR=9600 1076 -* A7 01 04 80 same as AT+BAUDR=115200 1476 +* ((( 1477 +A7 01 00 60 same as AT+BAUDR=9600 1478 +))) 1479 +* ((( 1480 +A7 01 04 80 same as AT+BAUDR=115200 1481 +))) 1077 1077 1483 +((( 1078 1078 A7 02 aa: Same as AT+PARITY=aa (aa value: 00 , 01 or 02) 1485 +))) 1079 1079 1487 +((( 1080 1080 A7 03 aa: Same as AT+STOPBIT=aa (aa value: 00 , 01 or 02) 1489 +))) 1081 1081 1082 1082 1083 1083 1493 + 1084 1084 ==== **Control output power duration** ==== 1085 1085 1496 +((( 1086 1086 User can set the output power duration before each sampling. 1498 +))) 1087 1087 1088 -* **AT Command:** 1500 +* ((( 1501 +**AT Command:** 1502 +))) 1089 1089 1504 +((( 1090 1090 **Example:** 1506 +))) 1091 1091 1508 +((( 1092 1092 **AT+3V3T=1000** ~/~/ 3V3 output power will open 1s before each sampling. 1510 +))) 1093 1093 1512 +((( 1094 1094 **AT+5VT=1000** ~/~/ +5V output power will open 1s before each sampling. 1514 +))) 1095 1095 1516 +((( 1517 + 1518 +))) 1096 1096 1097 -* **LoRaWAN Downlink Command:** 1520 +* ((( 1521 +**LoRaWAN Downlink Command:** 1522 +))) 1098 1098 1524 +((( 1099 1099 **07 01 aa bb** Same as AT+5VT=(aa bb) 1526 +))) 1100 1100 1528 +((( 1101 1101 **07 02 aa bb** Same as AT+3V3T=(aa bb) 1530 +))) 1102 1102 1103 1103 1533 + 1104 1104 == 3.6 Buttons == 1105 1105 1106 -(% border="1" style="background-color:#ffffcc; color:green; width:233px" %) 1536 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:233px" %) 1107 1107 |=(% style="width: 89px;" %)**Button**|=(% style="width: 141px;" %)**Feature** 1108 1108 |(% style="width:89px" %)**RST**|(% style="width:141px" %)Reboot RS485-BL 1109 1109 1110 1110 1111 - 1112 1112 == 3.7 +3V3 Output == 1113 1113 1543 +((( 1114 1114 RS485-BL has a Controllable +3V3 output, user can use this output to power external sensor. 1545 +))) 1115 1115 1547 +((( 1116 1116 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 +))) 1117 1117 1551 +((( 1118 1118 The +3V3 output time can be controlled by AT Command. 1553 +))) 1119 1119 1555 +((( 1556 + 1557 +))) 1120 1120 1559 +((( 1121 1121 (% style="color:#037691" %)**AT+3V3T=1000** 1561 +))) 1122 1122 1563 +((( 1564 + 1565 +))) 1123 1123 1567 +((( 1124 1124 Means set +3v3 valid time to have 1000ms. So, the real +3v3 output will actually have 1000ms + sampling time for other sensors. 1569 +))) 1125 1125 1571 +((( 1126 1126 By default, the AT+3V3T=0. This is a special case, means the +3V3 output is always on at any time 1573 +))) 1127 1127 1128 1128 1129 1129 == 3.8 +5V Output == 1130 1130 1578 +((( 1131 1131 RS485-BL has a Controllable +5V output, user can use this output to power external sensor. 1580 +))) 1132 1132 1582 +((( 1133 1133 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 +))) 1134 1134 1586 +((( 1135 1135 The 5V output time can be controlled by AT Command. 1588 +))) 1136 1136 1590 +((( 1591 + 1592 +))) 1137 1137 1594 +((( 1138 1138 (% style="color:#037691" %)**AT+5VT=1000** 1596 +))) 1139 1139 1598 +((( 1599 + 1600 +))) 1140 1140 1602 +((( 1141 1141 Means set 5V valid time to have 1000ms. So, the real 5V output will actually have 1000ms + sampling time for other sensors. 1604 +))) 1142 1142 1606 +((( 1143 1143 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 +))) 1144 1144 1145 1145 1611 + 1146 1146 == 3.9 LEDs == 1147 1147 1148 1148 (% border="1" style="background-color:#ffffcc; color:green; width:332px" %) ... ... @@ -1150,25 +1150,22 @@ 1150 1150 |**LED1**|(% style="width:274px" %)Blink when device transmit a packet. 1151 1151 1152 1152 1153 - 1154 1154 == 3.10 Switch Jumper == 1155 1155 1156 -(% border="1" style="background-color:#ffffcc; color:green; width:515px" %) 1157 -|=(% style="width: 124px;" %)**Switch Jumper**|=(% style="width: 388px;" %)**Feature** 1158 -|(% style="width:124px" %)**SW1**|(% style="width:388px" %)((( 1159 -ISP position: Upgrade firmware via UART 1160 - 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 1161 1161 Flash position: Configure device, check running status. 1162 -))) 1163 -|(% style="width:124px" %)**SW2**|(% style="width:388px" %)((( 1164 -5V position: set to compatible with 5v I/O. 1165 - 1625 +|(% style="width:123px" %)**SW2**|(% style="width:277px" %)5V position: set to compatible with 5v I/O. 1166 1166 3.3v position: set to compatible with 3.3v I/O., 1167 -))) 1168 1168 1628 +((( 1169 1169 **+3.3V**: is always ON 1630 +))) 1170 1170 1632 +((( 1171 1171 **+5V**: Only open before every sampling. The time is by default, it is AT+5VT=0. Max open time. 5000 ms. 1634 +))) 1172 1172 1173 1173 1174 1174 = 4. Case Study = ... ... @@ -1180,17 +1180,23 @@ 1180 1180 1181 1181 == 5.1 Access AT Command == 1182 1182 1646 +((( 1183 1183 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 +))) 1184 1184 1185 1185 [[image:1654135840598-282.png]] 1186 1186 1187 1187 1653 +((( 1188 1188 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 +))) 1189 1189 1190 1190 [[image:1654136105500-922.png]] 1191 1191 1192 1192 1193 -More detail AT Command manual can be found at [[AT Command Manual>>||anchor="3.5ConfigureRS485-BLviaATorDownlink"]] 1660 +((( 1661 +More detail AT Command manual can be found at [[AT Command Manual>>||anchor="H3.5ConfigureRS485-BLviaATorDownlink"]] 1662 +))) 1194 1194 1195 1195 1196 1196 == 5.2 Common AT Command Sequence == ... ... @@ -1215,7 +1215,9 @@ 1215 1215 ))) 1216 1216 1217 1217 1687 +((( 1218 1218 If device already joined network: 1689 +))) 1219 1219 1220 1220 (% class="box infomessage" %) 1221 1221 ((( ... ... @@ -1254,10 +1254,12 @@ 1254 1254 1255 1255 (% style="color:red" %)**Note:** 1256 1256 1728 +((( 1257 1257 (% style="color:red" %)1. Make sure the device is set to ABP mode in the IoT Server. 1258 1258 2. Make sure the LG01/02 gateway RX frequency is exactly the same as AT+CHS setting. 1259 1259 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. 1260 1260 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 +))) 1261 1261 1262 1262 [[image:1654136435598-589.png]] 1263 1263 ... ... @@ -1266,13 +1266,23 @@ 1266 1266 1267 1267 == 6.1 How to upgrade the image? == 1268 1268 1742 +((( 1269 1269 The RS485-BL LoRaWAN Controller is shipped with a 3.5mm cable, the cable is used to upload image to RS485-BL to: 1744 +))) 1270 1270 1271 -* Support new features 1272 -* For bug fix 1273 -* Change LoRaWAN bands. 1746 +* ((( 1747 +Support new features 1748 +))) 1749 +* ((( 1750 +For bug fix 1751 +))) 1752 +* ((( 1753 +Change LoRaWAN bands. 1754 +))) 1274 1274 1756 +((( 1275 1275 Below shows the hardware connection for how to upload an image to RS485-BL: 1758 +))) 1276 1276 1277 1277 [[image:1654136646995-976.png]] 1278 1278 ... ... @@ -1294,13 +1294,17 @@ 1294 1294 1295 1295 == 6.2 How to change the LoRa Frequency Bands/Region? == 1296 1296 1780 +((( 1297 1297 User can follow the introduction for [[how to upgrade image>>||anchor="H6.1Howtoupgradetheimage3F"]]. When download the images, choose the required image file for download. 1782 +))) 1298 1298 1299 1299 1300 1300 1301 1301 == 6.3 How many RS485-Slave can RS485-BL connects? == 1302 1302 1788 +((( 1303 1303 The RS485-BL can support max 32 RS485 devices. Each uplink command of RS485-BL can support max 16 different RS485 command. So RS485-BL can support max 16 RS485 devices pre-program in the device for uplink. For other devices no pre-program, user can use the [[downlink message (type code 0xA8) to poll their info>>||anchor="H3.3.3Configurereadcommandsforeachsampling"]]. 1790 +))) 1304 1304 1305 1305 1306 1306 ... ... @@ -1372,5 +1372,9 @@ 1372 1372 1373 1373 = 10. Support = 1374 1374 1375 -* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 1376 -* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]] 1862 +* ((( 1863 +Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 1864 +))) 1865 +* ((( 1866 +Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]] 1867 +)))
- image-20220606105412-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +13.9 KB - Content