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,23 +66,29 @@ 66 66 67 67 68 68 69 - 70 - 71 - 72 - 73 73 = 1. Introduction = 74 74 75 75 == 1.1 What is LoRaWAN Soil pH Sensor == 76 76 73 +((( 77 77 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 +))) 78 78 77 +((( 79 79 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 +))) 80 80 81 +((( 81 81 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 +))) 82 82 85 +((( 83 83 LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 87 +))) 84 84 89 +((( 85 85 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 +))) 86 86 87 87 88 88 [[image:1654592435432-887.png]] ... ... @@ -105,7 +105,6 @@ 105 105 * IP68 rate for the Sensor Probe 106 106 * 8500mAh Battery for long term use 107 107 108 - 109 109 == 1.3 Probe Specification == 110 110 111 111 ... ... @@ -126,12 +126,10 @@ 126 126 * IP68 Protection 127 127 * Length: 3.5 meters 128 128 129 - 130 130 == 1.4 Applications == 131 131 132 132 * Smart Agriculture 133 133 134 - 135 135 == 1.5 Pin mapping and power on == 136 136 137 137 [[image:1654592472094-134.png]] ... ... @@ -210,7 +210,9 @@ 210 210 [[image:image-20220607170442-2.png]] 211 211 212 212 216 +((( 213 213 (% 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 +))) 214 214 215 215 [[image:1654592697690-910.png]] 216 216 ... ... @@ -218,11 +218,17 @@ 218 218 219 219 == 2.3 Uplink Payload == 220 220 226 +((( 221 221 LSPH01 will uplink payload via LoRaWAN with below payload format: 228 +))) 222 222 230 +((( 223 223 Uplink payload includes in total 11 bytes. 232 +))) 224 224 234 +((( 225 225 Normal uplink payload: 236 +))) 226 226 227 227 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 228 228 |((( ... ... @@ -306,19 +306,22 @@ 306 306 307 307 === 2.3.6 Message Type === 308 308 320 +((( 309 309 For a normal uplink payload, the message type is always 0x01. 322 +))) 310 310 324 +((( 311 311 Valid Message Type: 326 +))) 312 312 313 313 314 314 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 315 -|**Message Type Code**|**Description**|**Payload** 330 +|=**Message Type Code**|=**Description**|=**Payload** 316 316 |0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]] 317 317 |0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]] 318 318 |0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]] 319 319 320 320 321 - 322 322 === 2.3.7 Decode payload in The Things Network === 323 323 324 324 While using TTN network, you can add the payload format to decode the payload. ... ... @@ -344,12 +344,21 @@ 344 344 345 345 == 2.5 Show Data in DataCake IoT Server == 346 346 361 +((( 347 347 [[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 +))) 348 348 365 +((( 366 + 367 +))) 349 349 369 +((( 350 350 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.** 371 +))) 351 351 373 +((( 352 352 (% 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 +))) 353 353 354 354 355 355 [[image:1654592790040-760.png]] ... ... @@ -372,9 +372,13 @@ 372 372 [[image:1654592856403-259.png]] 373 373 374 374 398 +((( 375 375 (% style="color:blue" %)**Step 5**(%%)**: add payload decode** 400 +))) 376 376 402 +((( 377 377 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 +))) 378 378 379 379 380 380 [[image:1654592878525-845.png]] ... ... @@ -397,8 +397,10 @@ 397 397 === 2.6.1 Before measurement === 398 398 399 399 ((( 427 +((( 400 400 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. 401 401 ))) 430 +))) 402 402 403 403 404 404 ... ... @@ -405,24 +405,45 @@ 405 405 === 2.6.2 Measurement === 406 406 407 407 437 +((( 408 408 (% style="color:#4f81bd" %)**Measurement the soil surface:** 439 +))) 409 409 441 +((( 410 410 [[image:1654592946732-634.png]] 443 +))) 411 411 445 +((( 412 412 Choose the proper measuring position. Split the surface soil according to the measured deep. 447 +))) 413 413 449 +((( 414 414 Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things. 451 +))) 415 415 453 +((( 416 416 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 +))) 417 417 457 +((( 418 418 Put soil over the probe after insert. And start to measure. 459 +))) 419 419 461 +((( 462 + 463 +))) 420 420 465 +((( 421 421 (% style="color:#4f81bd" %)**Measurement inside soil:** 467 +))) 422 422 469 +((( 423 423 Dig a hole with diameter > 20CM. 471 +))) 424 424 473 +((( 425 425 Insert the probe inside, method like measure the surface. 475 +))) 426 426 427 427 428 428 ... ... @@ -452,9 +452,13 @@ 452 452 453 453 == 2.7 Calibration == 454 454 505 +((( 455 455 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 +))) 456 456 509 +((( 457 457 After stable, user can use below command to calibrate. 511 +))) 458 458 459 459 [[image:image-20220607171149-4.png]] 460 460 ... ... @@ -461,7 +461,7 @@ 461 461 462 462 (% style="color:#037691" %)**Calibration Payload** 463 463 464 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 518 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 465 465 |((( 466 466 **Size** 467 467 ... ... @@ -481,7 +481,6 @@ 481 481 Always 0x03 482 482 ))) 483 483 484 - 485 485 User can also send 0x14 downlink command to poll the current calibration payload. 486 486 487 487 [[image:image-20220607171416-7.jpeg]] ... ... @@ -491,7 +491,6 @@ 491 491 * Reply to non-confirmed packet: 14 00 492 492 493 493 494 - 495 495 == 2.8 Frequency Plans == 496 496 497 497 ((( ... ... @@ -501,32 +501,61 @@ 501 501 502 502 === 2.8.1 EU863-870 (EU868) === 503 503 556 +((( 504 504 (% style="color:blue" %)**Uplink:** 558 +))) 505 505 560 +((( 506 506 868.1 - SF7BW125 to SF12BW125 562 +))) 507 507 564 +((( 508 508 868.3 - SF7BW125 to SF12BW125 and SF7BW250 566 +))) 509 509 568 +((( 510 510 868.5 - SF7BW125 to SF12BW125 570 +))) 511 511 572 +((( 512 512 867.1 - SF7BW125 to SF12BW125 574 +))) 513 513 576 +((( 514 514 867.3 - SF7BW125 to SF12BW125 578 +))) 515 515 580 +((( 516 516 867.5 - SF7BW125 to SF12BW125 582 +))) 517 517 584 +((( 518 518 867.7 - SF7BW125 to SF12BW125 586 +))) 519 519 588 +((( 520 520 867.9 - SF7BW125 to SF12BW125 590 +))) 521 521 592 +((( 522 522 868.8 - FSK 594 +))) 523 523 596 +((( 597 + 598 +))) 524 524 600 +((( 525 525 (% style="color:blue" %)**Downlink:** 602 +))) 526 526 604 +((( 527 527 Uplink channels 1-9 (RX1) 606 +))) 528 528 608 +((( 529 529 869.525 - SF9BW125 (RX2 downlink only) 610 +))) 530 530 531 531 532 532 ... ... @@ -549,49 +549,91 @@ 549 549 550 550 551 551 552 - 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,113 +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 - 622 622 === 2.8.5 AS920-923 & AS923-925 (AS923) === 623 623 744 +((( 624 624 (% style="color:blue" %)**Default Uplink channel:** 746 +))) 625 625 748 +((( 626 626 923.2 - SF7BW125 to SF10BW125 750 +))) 627 627 752 +((( 628 628 923.4 - SF7BW125 to SF10BW125 754 +))) 629 629 756 +((( 757 + 758 +))) 630 630 760 +((( 631 631 (% style="color:blue" %)**Additional Uplink Channel**: 762 +))) 632 632 764 +((( 633 633 (OTAA mode, channel added by JoinAccept message) 766 +))) 634 634 768 +((( 769 + 770 +))) 635 635 772 +((( 636 636 (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**: 774 +))) 637 637 776 +((( 638 638 922.2 - SF7BW125 to SF10BW125 778 +))) 639 639 780 +((( 640 640 922.4 - SF7BW125 to SF10BW125 782 +))) 641 641 784 +((( 642 642 922.6 - SF7BW125 to SF10BW125 786 +))) 643 643 788 +((( 644 644 922.8 - SF7BW125 to SF10BW125 790 +))) 645 645 792 +((( 646 646 923.0 - SF7BW125 to SF10BW125 794 +))) 647 647 796 +((( 648 648 922.0 - SF7BW125 to SF10BW125 798 +))) 649 649 800 +((( 801 + 802 +))) 650 650 804 +((( 651 651 (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**: 806 +))) 652 652 808 +((( 653 653 923.6 - SF7BW125 to SF10BW125 810 +))) 654 654 812 +((( 655 655 923.8 - SF7BW125 to SF10BW125 814 +))) 656 656 816 +((( 657 657 924.0 - SF7BW125 to SF10BW125 818 +))) 658 658 820 +((( 659 659 924.2 - SF7BW125 to SF10BW125 822 +))) 660 660 824 +((( 661 661 924.4 - SF7BW125 to SF10BW125 826 +))) 662 662 828 +((( 663 663 924.6 - SF7BW125 to SF10BW125 830 +))) 664 664 832 +((( 833 + 834 +))) 665 665 836 +((( 666 666 (% style="color:blue" %)**Downlink:** 838 +))) 667 667 840 +((( 668 668 Uplink channels 1-8 (RX1) 842 +))) 669 669 844 +((( 670 670 923.2 - SF10BW125 (RX2) 846 +))) 671 671 672 672 673 673 674 674 === 2.8.6 KR920-923 (KR920) === 675 675 852 +((( 676 676 (% style="color:blue" %)**Default channel:** 854 +))) 677 677 856 +((( 678 678 922.1 - SF7BW125 to SF12BW125 858 +))) 679 679 860 +((( 680 680 922.3 - SF7BW125 to SF12BW125 862 +))) 681 681 864 +((( 682 682 922.5 - SF7BW125 to SF12BW125 866 +))) 683 683 868 +((( 869 + 870 +))) 684 684 872 +((( 685 685 (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)** 874 +))) 686 686 876 +((( 687 687 922.1 - SF7BW125 to SF12BW125 878 +))) 688 688 880 +((( 689 689 922.3 - SF7BW125 to SF12BW125 882 +))) 690 690 884 +((( 691 691 922.5 - SF7BW125 to SF12BW125 886 +))) 692 692 888 +((( 693 693 922.7 - SF7BW125 to SF12BW125 890 +))) 694 694 892 +((( 695 695 922.9 - SF7BW125 to SF12BW125 894 +))) 696 696 896 +((( 697 697 923.1 - SF7BW125 to SF12BW125 898 +))) 698 698 900 +((( 699 699 923.3 - SF7BW125 to SF12BW125 902 +))) 700 700 904 +((( 905 + 906 +))) 701 701 908 +((( 702 702 (% style="color:blue" %)**Downlink:** 910 +))) 703 703 912 +((( 704 704 Uplink channels 1-7(RX1) 914 +))) 705 705 916 +((( 706 706 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125) 918 +))) 707 707 708 708 709 709 710 710 === 2.8.7 IN865-867 (IN865) === 711 711 924 +((( 712 712 (% style="color:blue" %)**Uplink:** 926 +))) 713 713 928 +((( 714 714 865.0625 - SF7BW125 to SF12BW125 930 +))) 715 715 932 +((( 716 716 865.4025 - SF7BW125 to SF12BW125 934 +))) 717 717 936 +((( 718 718 865.9850 - SF7BW125 to SF12BW125 938 +))) 719 719 940 +((( 941 + 942 +))) 720 720 944 +((( 721 721 (% style="color:blue" %)**Downlink:** 946 +))) 722 722 948 +((( 723 723 Uplink channels 1-3 (RX1) 950 +))) 724 724 952 +((( 725 725 866.550 - SF10BW125 (RX2) 954 +))) 726 726 727 727 728 728 ... ... @@ -750,26 +750,51 @@ 750 750 751 751 = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink = 752 752 982 +((( 753 753 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 984 +))) 754 754 755 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]]. 756 -* 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 +))) 757 757 993 +((( 758 758 There are two kinds of commands to configure LSPH01, they are: 995 +))) 759 759 760 -* (% style="color:#4f81bd" %)** General Commands**. 997 +* ((( 998 +(% style="color:#4f81bd" %)** General Commands**. 999 +))) 761 761 1001 +((( 762 762 These commands are to configure: 1003 +))) 763 763 764 -* General system settings like: uplink interval. 765 -* LoRaWAN protocol & radio related command. 1005 +* ((( 1006 +General system settings like: uplink interval. 1007 +))) 1008 +* ((( 1009 +LoRaWAN protocol & radio related command. 1010 +))) 766 766 1012 +((( 767 767 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 +))) 768 768 1016 +((( 1017 + 1018 +))) 769 769 770 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01** 1020 +* ((( 1021 +(% style="color:#4f81bd" %)** Commands special design for LSPH01** 1022 +))) 771 771 1024 +((( 772 772 These commands only valid for LSPH01, as below: 1026 +))) 773 773 774 774 775 775 ... ... @@ -783,17 +783,26 @@ 783 783 784 784 785 785 1040 +((( 786 786 (% style="color:#037691" %)**Downlink Command: 0x01** 1042 +))) 787 787 1044 +((( 788 788 Format: Command Code (0x01) followed by 3 bytes time value. 1046 +))) 789 789 1048 +((( 790 790 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01. 1050 +))) 791 791 792 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 793 -* 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 +))) 794 794 795 795 796 - 797 797 == 3.2 Set Interrupt Mode == 798 798 799 799 Feature, Set Interrupt mode for GPIO_EXIT. ... ... @@ -803,15 +803,28 @@ 803 803 [[image:image-20220607171716-9.png]] 804 804 805 805 1069 +((( 806 806 (% style="color:#037691" %)**Downlink Command: 0x06** 1071 +))) 807 807 1073 +((( 808 808 Format: Command Code (0x06) followed by 3 bytes. 1075 +))) 809 809 1077 +((( 810 810 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 +))) 811 811 812 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 813 -* 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 +))) 814 814 1088 +((( 1089 + 1090 +))) 815 815 816 816 817 817 ... ... @@ -832,7 +832,6 @@ 832 832 * Reply to the confirmation package: 26 01 833 833 * Reply to non-confirmed packet: 26 00 834 834 835 - 836 836 Device will send an uplink after got this downlink command. With below payload: 837 837 838 838 Configures info payload: ... ... @@ -990,9 +990,13 @@ 990 990 991 991 === 4.3.2 Replace the battery === 992 992 1268 +((( 993 993 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 +))) 994 994 1272 +((( 995 995 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 +))) 996 996 997 997 998 998 ... ... @@ -1013,7 +1013,9 @@ 1013 1013 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 1014 1014 1015 1015 1295 +((( 1016 1016 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 +))) 1017 1017 1018 1018 1019 1019 [[image:1654593712276-618.png]] ... ... @@ -1057,7 +1057,6 @@ 1057 1057 1058 1058 1059 1059 1060 - 1061 1061 = 9. Packing Info = 1062 1062 1063 1063 ... ... @@ -1072,6 +1072,8 @@ 1072 1072 * Package Size / pcs : cm 1073 1073 * Weight / pcs : g 1074 1074 1355 + 1356 + 1075 1075 = 10. Support = 1076 1076 1077 1077 * 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.