Changes for page LSN50v2-D20-D22-D23 LoRaWAN Temperature Sensor User Manual
Last modified by Xiaoling on 2024/01/17 16:19
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -66,21 +66,29 @@ 66 66 67 67 68 68 69 - 70 - 71 71 = 1. Introduction = 72 72 73 73 == 1.1 What is LoRaWAN Soil pH Sensor == 74 74 73 +((( 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. 75 +))) 76 76 77 +((( 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. 79 +))) 78 78 81 +((( 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. 83 +))) 80 80 85 +((( 81 81 LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 87 +))) 82 82 89 +((( 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. 91 +))) 84 84 85 85 86 86 [[image:1654592435432-887.png]] ... ... @@ -103,8 +103,6 @@ 103 103 * IP68 rate for the Sensor Probe 104 104 * 8500mAh Battery for long term use 105 105 106 - 107 - 108 108 == 1.3 Probe Specification == 109 109 110 110 ... ... @@ -125,14 +125,10 @@ 125 125 * IP68 Protection 126 126 * Length: 3.5 meters 127 127 128 - 129 - 130 130 == 1.4 Applications == 131 131 132 132 * Smart Agriculture 133 133 134 - 135 - 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 216 +((( 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. 218 +))) 215 215 216 216 [[image:1654592697690-910.png]] 217 217 ... ... @@ -219,11 +219,17 @@ 219 219 220 220 == 2.3 Uplink Payload == 221 221 226 +((( 222 222 LSPH01 will uplink payload via LoRaWAN with below payload format: 228 +))) 223 223 230 +((( 224 224 Uplink payload includes in total 11 bytes. 232 +))) 225 225 234 +((( 226 226 Normal uplink payload: 236 +))) 227 227 228 228 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 229 229 |((( ... ... @@ -307,20 +307,22 @@ 307 307 308 308 === 2.3.6 Message Type === 309 309 320 +((( 310 310 For a normal uplink payload, the message type is always 0x01. 322 +))) 311 311 324 +((( 312 312 Valid Message Type: 326 +))) 313 313 314 314 315 315 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 316 -|**Message Type Code**|**Description**|**Payload** 330 +|=**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 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 361 +((( 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: 363 +))) 350 350 365 +((( 366 + 367 +))) 351 351 369 +((( 352 352 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.** 371 +))) 353 353 373 +((( 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:** 375 +))) 355 355 356 356 357 357 [[image:1654592790040-760.png]] ... ... @@ -374,9 +374,13 @@ 374 374 [[image:1654592856403-259.png]] 375 375 376 376 398 +((( 377 377 (% style="color:blue" %)**Step 5**(%%)**: add payload decode** 400 +))) 378 378 402 +((( 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/]] 404 +))) 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 ((( 427 +((( 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 ))) 430 +))) 404 404 405 405 406 406 ... ... @@ -407,24 +407,45 @@ 407 407 === 2.6.2 Measurement === 408 408 409 409 437 +((( 410 410 (% style="color:#4f81bd" %)**Measurement the soil surface:** 439 +))) 411 411 441 +((( 412 412 [[image:1654592946732-634.png]] 443 +))) 413 413 445 +((( 414 414 Choose the proper measuring position. Split the surface soil according to the measured deep. 447 +))) 415 415 449 +((( 416 416 Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things. 451 +))) 417 417 453 +((( 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. 455 +))) 419 419 457 +((( 420 420 Put soil over the probe after insert. And start to measure. 459 +))) 421 421 461 +((( 462 + 463 +))) 422 422 465 +((( 423 423 (% style="color:#4f81bd" %)**Measurement inside soil:** 467 +))) 424 424 469 +((( 425 425 Dig a hole with diameter > 20CM. 471 +))) 426 426 473 +((( 427 427 Insert the probe inside, method like measure the surface. 475 +))) 428 428 429 429 430 430 ... ... @@ -454,9 +454,13 @@ 454 454 455 455 == 2.7 Calibration == 456 456 505 +((( 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). 507 +))) 458 458 509 +((( 459 459 After stable, user can use below command to calibrate. 511 +))) 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" %) 518 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 467 467 |((( 468 468 **Size** 469 469 ... ... @@ -492,8 +492,6 @@ 492 492 * Reply to non-confirmed packet: 14 00 493 493 494 494 495 - 496 - 497 497 == 2.8 Frequency Plans == 498 498 499 499 ((( ... ... @@ -503,32 +503,61 @@ 503 503 504 504 === 2.8.1 EU863-870 (EU868) === 505 505 556 +((( 506 506 (% style="color:blue" %)**Uplink:** 558 +))) 507 507 560 +((( 508 508 868.1 - SF7BW125 to SF12BW125 562 +))) 509 509 564 +((( 510 510 868.3 - SF7BW125 to SF12BW125 and SF7BW250 566 +))) 511 511 568 +((( 512 512 868.5 - SF7BW125 to SF12BW125 570 +))) 513 513 572 +((( 514 514 867.1 - SF7BW125 to SF12BW125 574 +))) 515 515 576 +((( 516 516 867.3 - SF7BW125 to SF12BW125 578 +))) 517 517 580 +((( 518 518 867.5 - SF7BW125 to SF12BW125 582 +))) 519 519 584 +((( 520 520 867.7 - SF7BW125 to SF12BW125 586 +))) 521 521 588 +((( 522 522 867.9 - SF7BW125 to SF12BW125 590 +))) 523 523 592 +((( 524 524 868.8 - FSK 594 +))) 525 525 596 +((( 597 + 598 +))) 526 526 600 +((( 527 527 (% style="color:blue" %)**Downlink:** 602 +))) 528 528 604 +((( 529 529 Uplink channels 1-9 (RX1) 606 +))) 530 530 608 +((( 531 531 869.525 - SF9BW125 (RX2 downlink only) 610 +))) 532 532 533 533 534 534 ... ... @@ -550,48 +550,92 @@ 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 632 + 553 553 === 2.8.3 CN470-510 (CN470) === 554 554 635 +((( 555 555 Used in China, Default use CHE=1 637 +))) 556 556 639 +((( 557 557 (% style="color:blue" %)**Uplink:** 641 +))) 558 558 643 +((( 559 559 486.3 - SF7BW125 to SF12BW125 645 +))) 560 560 647 +((( 561 561 486.5 - SF7BW125 to SF12BW125 649 +))) 562 562 651 +((( 563 563 486.7 - SF7BW125 to SF12BW125 653 +))) 564 564 655 +((( 565 565 486.9 - SF7BW125 to SF12BW125 657 +))) 566 566 659 +((( 567 567 487.1 - SF7BW125 to SF12BW125 661 +))) 568 568 663 +((( 569 569 487.3 - SF7BW125 to SF12BW125 665 +))) 570 570 667 +((( 571 571 487.5 - SF7BW125 to SF12BW125 669 +))) 572 572 671 +((( 573 573 487.7 - SF7BW125 to SF12BW125 673 +))) 574 574 675 +((( 676 + 677 +))) 575 575 679 +((( 576 576 (% style="color:blue" %)**Downlink:** 681 +))) 577 577 683 +((( 578 578 506.7 - SF7BW125 to SF12BW125 685 +))) 579 579 687 +((( 580 580 506.9 - SF7BW125 to SF12BW125 689 +))) 581 581 691 +((( 582 582 507.1 - SF7BW125 to SF12BW125 693 +))) 583 583 695 +((( 584 584 507.3 - SF7BW125 to SF12BW125 697 +))) 585 585 699 +((( 586 586 507.5 - SF7BW125 to SF12BW125 701 +))) 587 587 703 +((( 588 588 507.7 - SF7BW125 to SF12BW125 705 +))) 589 589 707 +((( 590 590 507.9 - SF7BW125 to SF12BW125 709 +))) 591 591 711 +((( 592 592 508.1 - SF7BW125 to SF12BW125 713 +))) 593 593 715 +((( 594 594 505.3 - SF12BW125 (RX2 downlink only) 717 +))) 595 595 596 596 597 597 ... ... @@ -616,112 +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 - 621 621 === 2.8.5 AS920-923 & AS923-925 (AS923) === 622 622 744 +((( 623 623 (% style="color:blue" %)**Default Uplink channel:** 746 +))) 624 624 748 +((( 625 625 923.2 - SF7BW125 to SF10BW125 750 +))) 626 626 752 +((( 627 627 923.4 - SF7BW125 to SF10BW125 754 +))) 628 628 756 +((( 757 + 758 +))) 629 629 760 +((( 630 630 (% style="color:blue" %)**Additional Uplink Channel**: 762 +))) 631 631 764 +((( 632 632 (OTAA mode, channel added by JoinAccept message) 766 +))) 633 633 768 +((( 769 + 770 +))) 634 634 772 +((( 635 635 (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**: 774 +))) 636 636 776 +((( 637 637 922.2 - SF7BW125 to SF10BW125 778 +))) 638 638 780 +((( 639 639 922.4 - SF7BW125 to SF10BW125 782 +))) 640 640 784 +((( 641 641 922.6 - SF7BW125 to SF10BW125 786 +))) 642 642 788 +((( 643 643 922.8 - SF7BW125 to SF10BW125 790 +))) 644 644 792 +((( 645 645 923.0 - SF7BW125 to SF10BW125 794 +))) 646 646 796 +((( 647 647 922.0 - SF7BW125 to SF10BW125 798 +))) 648 648 800 +((( 801 + 802 +))) 649 649 804 +((( 650 650 (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**: 806 +))) 651 651 808 +((( 652 652 923.6 - SF7BW125 to SF10BW125 810 +))) 653 653 812 +((( 654 654 923.8 - SF7BW125 to SF10BW125 814 +))) 655 655 816 +((( 656 656 924.0 - SF7BW125 to SF10BW125 818 +))) 657 657 820 +((( 658 658 924.2 - SF7BW125 to SF10BW125 822 +))) 659 659 824 +((( 660 660 924.4 - SF7BW125 to SF10BW125 826 +))) 661 661 828 +((( 662 662 924.6 - SF7BW125 to SF10BW125 830 +))) 663 663 832 +((( 833 + 834 +))) 664 664 836 +((( 665 665 (% style="color:blue" %)**Downlink:** 838 +))) 666 666 840 +((( 667 667 Uplink channels 1-8 (RX1) 842 +))) 668 668 844 +((( 669 669 923.2 - SF10BW125 (RX2) 846 +))) 670 670 671 671 672 672 673 673 === 2.8.6 KR920-923 (KR920) === 674 674 852 +((( 675 675 (% style="color:blue" %)**Default channel:** 854 +))) 676 676 856 +((( 677 677 922.1 - SF7BW125 to SF12BW125 858 +))) 678 678 860 +((( 679 679 922.3 - SF7BW125 to SF12BW125 862 +))) 680 680 864 +((( 681 681 922.5 - SF7BW125 to SF12BW125 866 +))) 682 682 868 +((( 869 + 870 +))) 683 683 872 +((( 684 684 (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)** 874 +))) 685 685 876 +((( 686 686 922.1 - SF7BW125 to SF12BW125 878 +))) 687 687 880 +((( 688 688 922.3 - SF7BW125 to SF12BW125 882 +))) 689 689 884 +((( 690 690 922.5 - SF7BW125 to SF12BW125 886 +))) 691 691 888 +((( 692 692 922.7 - SF7BW125 to SF12BW125 890 +))) 693 693 892 +((( 694 694 922.9 - SF7BW125 to SF12BW125 894 +))) 695 695 896 +((( 696 696 923.1 - SF7BW125 to SF12BW125 898 +))) 697 697 900 +((( 698 698 923.3 - SF7BW125 to SF12BW125 902 +))) 699 699 904 +((( 905 + 906 +))) 700 700 908 +((( 701 701 (% style="color:blue" %)**Downlink:** 910 +))) 702 702 912 +((( 703 703 Uplink channels 1-7(RX1) 914 +))) 704 704 916 +((( 705 705 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125) 918 +))) 706 706 707 707 708 708 709 709 === 2.8.7 IN865-867 (IN865) === 710 710 924 +((( 711 711 (% style="color:blue" %)**Uplink:** 926 +))) 712 712 928 +((( 713 713 865.0625 - SF7BW125 to SF12BW125 930 +))) 714 714 932 +((( 715 715 865.4025 - SF7BW125 to SF12BW125 934 +))) 716 716 936 +((( 717 717 865.9850 - SF7BW125 to SF12BW125 938 +))) 718 718 940 +((( 941 + 942 +))) 719 719 944 +((( 720 720 (% style="color:blue" %)**Downlink:** 946 +))) 721 721 948 +((( 722 722 Uplink channels 1-3 (RX1) 950 +))) 723 723 952 +((( 724 724 866.550 - SF10BW125 (RX2) 954 +))) 725 725 726 726 727 727 ... ... @@ -734,6 +734,7 @@ 734 734 735 735 736 736 967 + 737 737 == 2.10 Firmware Change Log == 738 738 739 739 ... ... @@ -748,26 +748,51 @@ 748 748 749 749 = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink = 750 750 982 +((( 751 751 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 984 +))) 752 752 753 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]]. 754 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]] 986 +* ((( 987 +AT Command Connection: See [[FAQ>>path:#H6.FAQ]]. 988 +))) 989 +* ((( 990 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]] 991 +))) 755 755 993 +((( 756 756 There are two kinds of commands to configure LSPH01, they are: 995 +))) 757 757 758 -* (% style="color:#4f81bd" %)** General Commands**. 997 +* ((( 998 +(% style="color:#4f81bd" %)** General Commands**. 999 +))) 759 759 1001 +((( 760 760 These commands are to configure: 1003 +))) 761 761 762 -* General system settings like: uplink interval. 763 -* LoRaWAN protocol & radio related command. 1005 +* ((( 1006 +General system settings like: uplink interval. 1007 +))) 1008 +* ((( 1009 +LoRaWAN protocol & radio related command. 1010 +))) 764 764 1012 +((( 765 765 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/]] 1014 +))) 766 766 1016 +((( 1017 + 1018 +))) 767 767 768 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01** 1020 +* ((( 1021 +(% style="color:#4f81bd" %)** Commands special design for LSPH01** 1022 +))) 769 769 1024 +((( 770 770 These commands only valid for LSPH01, as below: 1026 +))) 771 771 772 772 773 773 ... ... @@ -781,18 +781,26 @@ 781 781 782 782 783 783 1040 +((( 784 784 (% style="color:#037691" %)**Downlink Command: 0x01** 1042 +))) 785 785 1044 +((( 786 786 Format: Command Code (0x01) followed by 3 bytes time value. 1046 +))) 787 787 1048 +((( 788 788 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01. 1050 +))) 789 789 790 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 791 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 1052 +* ((( 1053 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 1054 +))) 1055 +* ((( 1056 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 1057 +))) 792 792 793 793 794 - 795 - 796 796 == 3.2 Set Interrupt Mode == 797 797 798 798 Feature, Set Interrupt mode for GPIO_EXIT. ... ... @@ -802,16 +802,31 @@ 802 802 [[image:image-20220607171716-9.png]] 803 803 804 804 1069 +((( 805 805 (% style="color:#037691" %)**Downlink Command: 0x06** 1071 +))) 806 806 1073 +((( 807 807 Format: Command Code (0x06) followed by 3 bytes. 1075 +))) 808 808 1077 +((( 809 809 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 1079 +))) 810 810 811 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 812 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1081 +* ((( 1082 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 1083 +))) 1084 +* ((( 1085 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1086 +))) 813 813 1088 +((( 1089 + 1090 +))) 814 814 1092 + 1093 + 815 815 == 3.3 Calibrate Sensor == 816 816 817 817 Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands ... ... @@ -829,7 +829,6 @@ 829 829 * Reply to the confirmation package: 26 01 830 830 * Reply to non-confirmed packet: 26 00 831 831 832 - 833 833 Device will send an uplink after got this downlink command. With below payload: 834 834 835 835 Configures info payload: ... ... @@ -987,9 +987,13 @@ 987 987 988 988 === 4.3.2 Replace the battery === 989 989 1268 +((( 990 990 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. 1270 +))) 991 991 1272 +((( 992 992 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) 1274 +))) 993 993 994 994 995 995 ... ... @@ -1010,7 +1010,9 @@ 1010 1010 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 1011 1011 1012 1012 1295 +((( 1013 1013 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: 1297 +))) 1014 1014 1015 1015 1016 1016 [[image:1654593712276-618.png]] ... ... @@ -1053,6 +1053,7 @@ 1053 1053 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1054 1054 1055 1055 1340 + 1056 1056 = 9. Packing Info = 1057 1057 1058 1058 ... ... @@ -1068,6 +1068,7 @@ 1068 1068 * Weight / pcs : g 1069 1069 1070 1070 1356 + 1071 1071 = 10. Support = 1072 1072 1073 1073 * 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.