Changes for page LMDS200 -- LoRaWAN Microwave Radar Distance Sensor User Manual
Last modified by Mengting Qiu on 2024/03/07 08:41
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -63,24 +63,29 @@ 63 63 64 64 65 65 66 - 67 - 68 - 69 - 70 - 71 71 = 1. Introduction = 72 72 73 73 == 1.1 What is LoRaWAN Soil pH Sensor == 74 74 70 +((( 75 75 The Dragino LSPH01 is a (% style="color:#4f81bd" %)**LoRaWAN Soil pH Sensor**(%%) for IoT of Agriculture. It is designed to measure the soil PH and soil temperature, so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof. 72 +))) 76 76 74 +((( 77 77 LSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** (% style="color:#4f81bd" %)pH (%%)**with high accuracy and stable value. The LSPH01 probe can be buried into soil for long time use. 76 +))) 78 78 78 +((( 79 79 The LoRa wireless technology used in LSPH01 allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption. 80 +))) 80 80 82 +((( 81 81 LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 84 +))) 82 82 86 +((( 83 83 Each LSPH01 is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on. 88 +))) 84 84 85 85 86 86 [[image:1654592435432-887.png]] ... ... @@ -105,6 +105,7 @@ 105 105 106 106 107 107 113 + 108 108 == 1.3 Probe Specification == 109 109 110 110 ... ... @@ -127,6 +127,7 @@ 127 127 128 128 129 129 136 + 130 130 == 1.4 Applications == 131 131 132 132 * Smart Agriculture ... ... @@ -133,6 +133,7 @@ 133 133 134 134 135 135 143 + 136 136 == 1.5 Pin mapping and power on == 137 137 138 138 [[image:1654592472094-134.png]] ... ... @@ -211,7 +211,9 @@ 211 211 [[image:image-20220607170442-2.png]] 212 212 213 213 222 +((( 214 214 (% style="color:blue" %)**Step 3**(%%)**:** The LSPH01 will auto join to the TTN network. After join success, it will start to upload messages to TTN and you can see the messages in the panel. 224 +))) 215 215 216 216 [[image:1654592697690-910.png]] 217 217 ... ... @@ -219,11 +219,17 @@ 219 219 220 220 == 2.3 Uplink Payload == 221 221 232 +((( 222 222 LSPH01 will uplink payload via LoRaWAN with below payload format: 234 +))) 223 223 236 +((( 224 224 Uplink payload includes in total 11 bytes. 238 +))) 225 225 240 +((( 226 226 Normal uplink payload: 242 +))) 227 227 228 228 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 229 229 |((( ... ... @@ -307,20 +307,21 @@ 307 307 308 308 === 2.3.6 Message Type === 309 309 326 +((( 310 310 For a normal uplink payload, the message type is always 0x01. 328 +))) 311 311 330 +((( 312 312 Valid Message Type: 332 +))) 313 313 314 314 315 315 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 316 -|**Message Type Code**|**Description**|**Payload** 336 +|=**Message Type Code**|=**Description**|=**Payload** 317 317 |0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]] 318 318 |0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]] 319 319 |0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]] 320 320 321 - 322 - 323 - 324 324 === 2.3.7 Decode payload in The Things Network === 325 325 326 326 While using TTN network, you can add the payload format to decode the payload. ... ... @@ -346,12 +346,21 @@ 346 346 347 347 == 2.5 Show Data in DataCake IoT Server == 348 348 366 +((( 349 349 [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps: 368 +))) 350 350 370 +((( 371 + 372 +))) 351 351 374 +((( 352 352 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.** 376 +))) 353 353 378 +((( 354 354 (% style="color:blue" %)**Step 2**(%%)**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:** 380 +))) 355 355 356 356 357 357 [[image:1654592790040-760.png]] ... ... @@ -374,9 +374,13 @@ 374 374 [[image:1654592856403-259.png]] 375 375 376 376 403 +((( 377 377 (% style="color:blue" %)**Step 5**(%%)**: add payload decode** 405 +))) 378 378 407 +((( 379 379 Download Datacake decoder from: [[https:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/LSPH01/Decoder/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSNPK01/Decoder/]] 409 +))) 380 380 381 381 382 382 [[image:1654592878525-845.png]] ... ... @@ -399,8 +399,10 @@ 399 399 === 2.6.1 Before measurement === 400 400 401 401 ((( 432 +((( 402 402 If the LSPH01 has more than 7 days not use or just clean the pH probe. User should put the probe inside pure water for more than 24 hours for activation. If no put in water, user need to put inside soil for more than 24 hours to ensure the measurement accuracy. 403 403 ))) 435 +))) 404 404 405 405 406 406 ... ... @@ -407,24 +407,45 @@ 407 407 === 2.6.2 Measurement === 408 408 409 409 442 +((( 410 410 (% style="color:#4f81bd" %)**Measurement the soil surface:** 444 +))) 411 411 446 +((( 412 412 [[image:1654592946732-634.png]] 448 +))) 413 413 450 +((( 414 414 Choose the proper measuring position. Split the surface soil according to the measured deep. 452 +))) 415 415 454 +((( 416 416 Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things. 456 +))) 417 417 458 +((( 418 418 Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting. 460 +))) 419 419 462 +((( 420 420 Put soil over the probe after insert. And start to measure. 464 +))) 421 421 466 +((( 467 + 468 +))) 422 422 470 +((( 423 423 (% style="color:#4f81bd" %)**Measurement inside soil:** 472 +))) 424 424 474 +((( 425 425 Dig a hole with diameter > 20CM. 476 +))) 426 426 478 +((( 427 427 Insert the probe inside, method like measure the surface. 480 +))) 428 428 429 429 430 430 ... ... @@ -454,9 +454,13 @@ 454 454 455 455 == 2.7 Calibration == 456 456 510 +((( 457 457 User can do calibration for the probe. It is limited to use below pH buffer solution to calibrate: 4.00, 6.86, 9.18. When calibration, user need to clean the electrode and put the probe in the pH buffer solution to wait the value stable ( a new clean electrode might need max 24 hours to be stable). 512 +))) 458 458 514 +((( 459 459 After stable, user can use below command to calibrate. 516 +))) 460 460 461 461 [[image:image-20220607171149-4.png]] 462 462 ... ... @@ -463,7 +463,7 @@ 463 463 464 464 (% style="color:#037691" %)**Calibration Payload** 465 465 466 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 523 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 467 467 |((( 468 468 **Size** 469 469 ... ... @@ -503,32 +503,61 @@ 503 503 504 504 === 2.8.1 EU863-870 (EU868) === 505 505 563 +((( 506 506 (% style="color:blue" %)**Uplink:** 565 +))) 507 507 567 +((( 508 508 868.1 - SF7BW125 to SF12BW125 569 +))) 509 509 571 +((( 510 510 868.3 - SF7BW125 to SF12BW125 and SF7BW250 573 +))) 511 511 575 +((( 512 512 868.5 - SF7BW125 to SF12BW125 577 +))) 513 513 579 +((( 514 514 867.1 - SF7BW125 to SF12BW125 581 +))) 515 515 583 +((( 516 516 867.3 - SF7BW125 to SF12BW125 585 +))) 517 517 587 +((( 518 518 867.5 - SF7BW125 to SF12BW125 589 +))) 519 519 591 +((( 520 520 867.7 - SF7BW125 to SF12BW125 593 +))) 521 521 595 +((( 522 522 867.9 - SF7BW125 to SF12BW125 597 +))) 523 523 599 +((( 524 524 868.8 - FSK 601 +))) 525 525 603 +((( 604 + 605 +))) 526 526 607 +((( 527 527 (% style="color:blue" %)**Downlink:** 609 +))) 528 528 611 +((( 529 529 Uplink channels 1-9 (RX1) 613 +))) 530 530 615 +((( 531 531 869.525 - SF9BW125 (RX2 downlink only) 617 +))) 532 532 533 533 534 534 ... ... @@ -550,48 +550,93 @@ 550 550 * Use the Join successful sub-band if the server doesn’t include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include) 551 551 552 552 639 + 640 + 553 553 === 2.8.3 CN470-510 (CN470) === 554 554 643 +((( 555 555 Used in China, Default use CHE=1 645 +))) 556 556 647 +((( 557 557 (% style="color:blue" %)**Uplink:** 649 +))) 558 558 651 +((( 559 559 486.3 - SF7BW125 to SF12BW125 653 +))) 560 560 655 +((( 561 561 486.5 - SF7BW125 to SF12BW125 657 +))) 562 562 659 +((( 563 563 486.7 - SF7BW125 to SF12BW125 661 +))) 564 564 663 +((( 565 565 486.9 - SF7BW125 to SF12BW125 665 +))) 566 566 667 +((( 567 567 487.1 - SF7BW125 to SF12BW125 669 +))) 568 568 671 +((( 569 569 487.3 - SF7BW125 to SF12BW125 673 +))) 570 570 675 +((( 571 571 487.5 - SF7BW125 to SF12BW125 677 +))) 572 572 679 +((( 573 573 487.7 - SF7BW125 to SF12BW125 681 +))) 574 574 683 +((( 684 + 685 +))) 575 575 687 +((( 576 576 (% style="color:blue" %)**Downlink:** 689 +))) 577 577 691 +((( 578 578 506.7 - SF7BW125 to SF12BW125 693 +))) 579 579 695 +((( 580 580 506.9 - SF7BW125 to SF12BW125 697 +))) 581 581 699 +((( 582 582 507.1 - SF7BW125 to SF12BW125 701 +))) 583 583 703 +((( 584 584 507.3 - SF7BW125 to SF12BW125 705 +))) 585 585 707 +((( 586 586 507.5 - SF7BW125 to SF12BW125 709 +))) 587 587 711 +((( 588 588 507.7 - SF7BW125 to SF12BW125 713 +))) 589 589 715 +((( 590 590 507.9 - SF7BW125 to SF12BW125 717 +))) 591 591 719 +((( 592 592 508.1 - SF7BW125 to SF12BW125 721 +))) 593 593 723 +((( 594 594 505.3 - SF12BW125 (RX2 downlink only) 725 +))) 595 595 596 596 597 597 ... ... @@ -616,111 +616,219 @@ 616 616 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 617 617 * Use the Join successful sub-band if the server doesn’t include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include) 618 618 619 - 620 620 === 2.8.5 AS920-923 & AS923-925 (AS923) === 621 621 752 +((( 622 622 (% style="color:blue" %)**Default Uplink channel:** 754 +))) 623 623 756 +((( 624 624 923.2 - SF7BW125 to SF10BW125 758 +))) 625 625 760 +((( 626 626 923.4 - SF7BW125 to SF10BW125 762 +))) 627 627 764 +((( 765 + 766 +))) 628 628 768 +((( 629 629 (% style="color:blue" %)**Additional Uplink Channel**: 770 +))) 630 630 772 +((( 631 631 (OTAA mode, channel added by JoinAccept message) 774 +))) 632 632 776 +((( 777 + 778 +))) 633 633 780 +((( 634 634 (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**: 782 +))) 635 635 784 +((( 636 636 922.2 - SF7BW125 to SF10BW125 786 +))) 637 637 788 +((( 638 638 922.4 - SF7BW125 to SF10BW125 790 +))) 639 639 792 +((( 640 640 922.6 - SF7BW125 to SF10BW125 794 +))) 641 641 796 +((( 642 642 922.8 - SF7BW125 to SF10BW125 798 +))) 643 643 800 +((( 644 644 923.0 - SF7BW125 to SF10BW125 802 +))) 645 645 804 +((( 646 646 922.0 - SF7BW125 to SF10BW125 806 +))) 647 647 808 +((( 809 + 810 +))) 648 648 812 +((( 649 649 (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**: 814 +))) 650 650 816 +((( 651 651 923.6 - SF7BW125 to SF10BW125 818 +))) 652 652 820 +((( 653 653 923.8 - SF7BW125 to SF10BW125 822 +))) 654 654 824 +((( 655 655 924.0 - SF7BW125 to SF10BW125 826 +))) 656 656 828 +((( 657 657 924.2 - SF7BW125 to SF10BW125 830 +))) 658 658 832 +((( 659 659 924.4 - SF7BW125 to SF10BW125 834 +))) 660 660 836 +((( 661 661 924.6 - SF7BW125 to SF10BW125 838 +))) 662 662 840 +((( 841 + 842 +))) 663 663 844 +((( 664 664 (% style="color:blue" %)**Downlink:** 846 +))) 665 665 848 +((( 666 666 Uplink channels 1-8 (RX1) 850 +))) 667 667 852 +((( 668 668 923.2 - SF10BW125 (RX2) 854 +))) 669 669 670 670 671 671 672 672 === 2.8.6 KR920-923 (KR920) === 673 673 860 +((( 674 674 (% style="color:blue" %)**Default channel:** 862 +))) 675 675 864 +((( 676 676 922.1 - SF7BW125 to SF12BW125 866 +))) 677 677 868 +((( 678 678 922.3 - SF7BW125 to SF12BW125 870 +))) 679 679 872 +((( 680 680 922.5 - SF7BW125 to SF12BW125 874 +))) 681 681 876 +((( 877 + 878 +))) 682 682 880 +((( 683 683 (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)** 882 +))) 684 684 884 +((( 685 685 922.1 - SF7BW125 to SF12BW125 886 +))) 686 686 888 +((( 687 687 922.3 - SF7BW125 to SF12BW125 890 +))) 688 688 892 +((( 689 689 922.5 - SF7BW125 to SF12BW125 894 +))) 690 690 896 +((( 691 691 922.7 - SF7BW125 to SF12BW125 898 +))) 692 692 900 +((( 693 693 922.9 - SF7BW125 to SF12BW125 902 +))) 694 694 904 +((( 695 695 923.1 - SF7BW125 to SF12BW125 906 +))) 696 696 908 +((( 697 697 923.3 - SF7BW125 to SF12BW125 910 +))) 698 698 912 +((( 913 + 914 +))) 699 699 916 +((( 700 700 (% style="color:blue" %)**Downlink:** 918 +))) 701 701 920 +((( 702 702 Uplink channels 1-7(RX1) 922 +))) 703 703 924 +((( 704 704 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125) 926 +))) 705 705 706 706 707 707 708 708 === 2.8.7 IN865-867 (IN865) === 709 709 932 +((( 710 710 (% style="color:blue" %)**Uplink:** 934 +))) 711 711 936 +((( 712 712 865.0625 - SF7BW125 to SF12BW125 938 +))) 713 713 940 +((( 714 714 865.4025 - SF7BW125 to SF12BW125 942 +))) 715 715 944 +((( 716 716 865.9850 - SF7BW125 to SF12BW125 946 +))) 717 717 948 +((( 949 + 950 +))) 718 718 952 +((( 719 719 (% style="color:blue" %)**Downlink:** 954 +))) 720 720 956 +((( 721 721 Uplink channels 1-3 (RX1) 958 +))) 722 722 960 +((( 723 723 866.550 - SF10BW125 (RX2) 962 +))) 724 724 725 725 726 726 ... ... @@ -732,6 +732,8 @@ 732 732 * Blink once when device transmit a packet. 733 733 734 734 974 + 975 + 735 735 == 2.10 Firmware Change Log == 736 736 737 737 ... ... @@ -746,26 +746,51 @@ 746 746 747 747 = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink = 748 748 990 +((( 749 749 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 992 +))) 750 750 751 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]]. 752 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]] 994 +* ((( 995 +AT Command Connection: See [[FAQ>>path:#H6.FAQ]]. 996 +))) 997 +* ((( 998 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]] 999 +))) 753 753 1001 +((( 754 754 There are two kinds of commands to configure LSPH01, they are: 1003 +))) 755 755 756 -* (% style="color:#4f81bd" %)** General Commands**. 1005 +* ((( 1006 +(% style="color:#4f81bd" %)** General Commands**. 1007 +))) 757 757 1009 +((( 758 758 These commands are to configure: 1011 +))) 759 759 760 -* General system settings like: uplink interval. 761 -* LoRaWAN protocol & radio related command. 1013 +* ((( 1014 +General system settings like: uplink interval. 1015 +))) 1016 +* ((( 1017 +LoRaWAN protocol & radio related command. 1018 +))) 762 762 1020 +((( 763 763 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:[[End Device AT Commands and Downlink Command>>path:/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]] 1022 +))) 764 764 1024 +((( 1025 + 1026 +))) 765 765 766 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01** 1028 +* ((( 1029 +(% style="color:#4f81bd" %)** Commands special design for LSPH01** 1030 +))) 767 767 1032 +((( 768 768 These commands only valid for LSPH01, as below: 1034 +))) 769 769 770 770 771 771 ... ... @@ -779,15 +779,28 @@ 779 779 780 780 781 781 1048 +((( 782 782 (% style="color:#037691" %)**Downlink Command: 0x01** 1050 +))) 783 783 1052 +((( 784 784 Format: Command Code (0x01) followed by 3 bytes time value. 1054 +))) 785 785 1056 +((( 786 786 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01. 1058 +))) 787 787 788 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 789 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 1060 +* ((( 1061 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 1062 +))) 1063 +* ((( 1064 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 790 790 1066 + 1067 + 1068 +))) 1069 + 791 791 == 3.2 Set Interrupt Mode == 792 792 793 793 Feature, Set Interrupt mode for GPIO_EXIT. ... ... @@ -797,16 +797,31 @@ 797 797 [[image:image-20220607171716-9.png]] 798 798 799 799 1079 +((( 800 800 (% style="color:#037691" %)**Downlink Command: 0x06** 1081 +))) 801 801 1083 +((( 802 802 Format: Command Code (0x06) followed by 3 bytes. 1085 +))) 803 803 1087 +((( 804 804 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 1089 +))) 805 805 806 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 807 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1091 +* ((( 1092 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 1093 +))) 1094 +* ((( 1095 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1096 +))) 808 808 1098 +((( 1099 + 1100 +))) 809 809 1102 + 1103 + 810 810 == 3.3 Calibrate Sensor == 811 811 812 812 Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands ... ... @@ -981,9 +981,13 @@ 981 981 982 982 === 4.3.2 Replace the battery === 983 983 1278 +((( 984 984 You can change the battery in the LSPH01.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won’t be voltage drop between battery and main board. 1280 +))) 985 985 1282 +((( 986 986 The default battery pack of LSPH01 includes a ER26500 plus super capacitor. If user can’t find this pack locally, they can find ER26500 or equivalence, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes) 1284 +))) 987 987 988 988 989 989 ... ... @@ -1004,7 +1004,9 @@ 1004 1004 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 1005 1005 1006 1006 1305 +((( 1007 1007 In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSPH01. LSPH01 will output system info once power on as below: 1307 +))) 1008 1008 1009 1009 1010 1010 [[image:1654593712276-618.png]] ... ... @@ -1012,7 +1012,6 @@ 1012 1012 Valid AT Command please check [[Configure Device>>path:#H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink]]. 1013 1013 1014 1014 1015 - 1016 1016 = 6. FAQ = 1017 1017 1018 1018 == 6.1 How to change the LoRa Frequency Bands/Region == ... ... @@ -1021,7 +1021,6 @@ 1021 1021 When downloading the images, choose the required image file for download. 1022 1022 1023 1023 1024 - 1025 1025 = 7. Trouble Shooting = 1026 1026 1027 1027 == 7.1 AT Commands input doesn’t work == ... ... @@ -1029,7 +1029,6 @@ 1029 1029 In the case if user can see the console output but can’t type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn’t send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string. 1030 1030 1031 1031 1032 - 1033 1033 = 8. Order Info = 1034 1034 1035 1035 Part Number: (% style="color:blue" %)**LSPH01-XX**