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
-
... ... @@ -64,24 +64,29 @@ 64 64 65 65 66 66 67 - 68 - 69 - 70 - 71 - 72 72 = 1. Introduction = 73 73 74 74 == 1.1 What is LoRaWAN Soil pH Sensor == 75 75 71 +((( 76 76 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. 73 +))) 77 77 75 +((( 78 78 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. 77 +))) 79 79 79 +((( 80 80 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. 81 +))) 81 81 83 +((( 82 82 LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 85 +))) 83 83 87 +((( 84 84 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. 89 +))) 85 85 86 86 87 87 [[image:1654592435432-887.png]] ... ... @@ -104,9 +104,6 @@ 104 104 * IP68 rate for the Sensor Probe 105 105 * 8500mAh Battery for long term use 106 106 107 - 108 - 109 - 110 110 == 1.3 Probe Specification == 111 111 112 112 ... ... @@ -127,9 +127,6 @@ 127 127 * IP68 Protection 128 128 * Length: 3.5 meters 129 129 130 - 131 - 132 - 133 133 == 1.4 Applications == 134 134 135 135 * Smart Agriculture ... ... @@ -212,7 +212,9 @@ 212 212 [[image:image-20220607170442-2.png]] 213 213 214 214 214 +((( 215 215 (% 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. 216 +))) 216 216 217 217 [[image:1654592697690-910.png]] 218 218 ... ... @@ -220,11 +220,17 @@ 220 220 221 221 == 2.3 Uplink Payload == 222 222 224 +((( 223 223 LSPH01 will uplink payload via LoRaWAN with below payload format: 226 +))) 224 224 228 +((( 225 225 Uplink payload includes in total 11 bytes. 230 +))) 226 226 232 +((( 227 227 Normal uplink payload: 234 +))) 228 228 229 229 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 230 230 |((( ... ... @@ -308,18 +308,21 @@ 308 308 309 309 === 2.3.6 Message Type === 310 310 318 +((( 311 311 For a normal uplink payload, the message type is always 0x01. 320 +))) 312 312 322 +((( 313 313 Valid Message Type: 324 +))) 314 314 315 315 316 316 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 317 -|**Message Type Code**|**Description**|**Payload** 328 +|=**Message Type Code**|=**Description**|=**Payload** 318 318 |0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]] 319 319 |0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]] 320 320 |0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]] 321 321 322 - 323 323 === 2.3.7 Decode payload in The Things Network === 324 324 325 325 While using TTN network, you can add the payload format to decode the payload. ... ... @@ -345,12 +345,21 @@ 345 345 346 346 == 2.5 Show Data in DataCake IoT Server == 347 347 358 +((( 348 348 [[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: 360 +))) 349 349 362 +((( 363 + 364 +))) 350 350 366 +((( 351 351 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.** 368 +))) 352 352 370 +((( 353 353 (% 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:** 372 +))) 354 354 355 355 356 356 [[image:1654592790040-760.png]] ... ... @@ -373,9 +373,13 @@ 373 373 [[image:1654592856403-259.png]] 374 374 375 375 395 +((( 376 376 (% style="color:blue" %)**Step 5**(%%)**: add payload decode** 397 +))) 377 377 399 +((( 378 378 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/]] 401 +))) 379 379 380 380 381 381 [[image:1654592878525-845.png]] ... ... @@ -398,8 +398,10 @@ 398 398 === 2.6.1 Before measurement === 399 399 400 400 ((( 424 +((( 401 401 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. 402 402 ))) 427 +))) 403 403 404 404 405 405 ... ... @@ -406,24 +406,45 @@ 406 406 === 2.6.2 Measurement === 407 407 408 408 434 +((( 409 409 (% style="color:#4f81bd" %)**Measurement the soil surface:** 436 +))) 410 410 438 +((( 411 411 [[image:1654592946732-634.png]] 440 +))) 412 412 442 +((( 413 413 Choose the proper measuring position. Split the surface soil according to the measured deep. 444 +))) 414 414 446 +((( 415 415 Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things. 448 +))) 416 416 450 +((( 417 417 Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting. 452 +))) 418 418 454 +((( 419 419 Put soil over the probe after insert. And start to measure. 456 +))) 420 420 458 +((( 459 + 460 +))) 421 421 462 +((( 422 422 (% style="color:#4f81bd" %)**Measurement inside soil:** 464 +))) 423 423 466 +((( 424 424 Dig a hole with diameter > 20CM. 468 +))) 425 425 470 +((( 426 426 Insert the probe inside, method like measure the surface. 472 +))) 427 427 428 428 429 429 ... ... @@ -453,9 +453,13 @@ 453 453 454 454 == 2.7 Calibration == 455 455 502 +((( 456 456 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). 504 +))) 457 457 506 +((( 458 458 After stable, user can use below command to calibrate. 508 +))) 459 459 460 460 [[image:image-20220607171149-4.png]] 461 461 ... ... @@ -462,7 +462,7 @@ 462 462 463 463 (% style="color:#037691" %)**Calibration Payload** 464 464 465 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 515 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 466 466 |((( 467 467 **Size** 468 468 ... ... @@ -490,7 +490,6 @@ 490 490 * Reply to the confirmation package: 14 01 491 491 * Reply to non-confirmed packet: 14 00 492 492 493 - 494 494 == 2.8 Frequency Plans == 495 495 496 496 ((( ... ... @@ -500,32 +500,61 @@ 500 500 501 501 === 2.8.1 EU863-870 (EU868) === 502 502 552 +((( 503 503 (% style="color:blue" %)**Uplink:** 554 +))) 504 504 556 +((( 505 505 868.1 - SF7BW125 to SF12BW125 558 +))) 506 506 560 +((( 507 507 868.3 - SF7BW125 to SF12BW125 and SF7BW250 562 +))) 508 508 564 +((( 509 509 868.5 - SF7BW125 to SF12BW125 566 +))) 510 510 568 +((( 511 511 867.1 - SF7BW125 to SF12BW125 570 +))) 512 512 572 +((( 513 513 867.3 - SF7BW125 to SF12BW125 574 +))) 514 514 576 +((( 515 515 867.5 - SF7BW125 to SF12BW125 578 +))) 516 516 580 +((( 517 517 867.7 - SF7BW125 to SF12BW125 582 +))) 518 518 584 +((( 519 519 867.9 - SF7BW125 to SF12BW125 586 +))) 520 520 588 +((( 521 521 868.8 - FSK 590 +))) 522 522 592 +((( 593 + 594 +))) 523 523 596 +((( 524 524 (% style="color:blue" %)**Downlink:** 598 +))) 525 525 600 +((( 526 526 Uplink channels 1-9 (RX1) 602 +))) 527 527 604 +((( 528 528 869.525 - SF9BW125 (RX2 downlink only) 606 +))) 529 529 530 530 531 531 ... ... @@ -546,50 +546,91 @@ 546 546 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 547 547 * 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) 548 548 549 - 550 - 551 551 === 2.8.3 CN470-510 (CN470) === 552 552 629 +((( 553 553 Used in China, Default use CHE=1 631 +))) 554 554 633 +((( 555 555 (% style="color:blue" %)**Uplink:** 635 +))) 556 556 637 +((( 557 557 486.3 - SF7BW125 to SF12BW125 639 +))) 558 558 641 +((( 559 559 486.5 - SF7BW125 to SF12BW125 643 +))) 560 560 645 +((( 561 561 486.7 - SF7BW125 to SF12BW125 647 +))) 562 562 649 +((( 563 563 486.9 - SF7BW125 to SF12BW125 651 +))) 564 564 653 +((( 565 565 487.1 - SF7BW125 to SF12BW125 655 +))) 566 566 657 +((( 567 567 487.3 - SF7BW125 to SF12BW125 659 +))) 568 568 661 +((( 569 569 487.5 - SF7BW125 to SF12BW125 663 +))) 570 570 665 +((( 571 571 487.7 - SF7BW125 to SF12BW125 667 +))) 572 572 669 +((( 670 + 671 +))) 573 573 673 +((( 574 574 (% style="color:blue" %)**Downlink:** 675 +))) 575 575 677 +((( 576 576 506.7 - SF7BW125 to SF12BW125 679 +))) 577 577 681 +((( 578 578 506.9 - SF7BW125 to SF12BW125 683 +))) 579 579 685 +((( 580 580 507.1 - SF7BW125 to SF12BW125 687 +))) 581 581 689 +((( 582 582 507.3 - SF7BW125 to SF12BW125 691 +))) 583 583 693 +((( 584 584 507.5 - SF7BW125 to SF12BW125 695 +))) 585 585 697 +((( 586 586 507.7 - SF7BW125 to SF12BW125 699 +))) 587 587 701 +((( 588 588 507.9 - SF7BW125 to SF12BW125 703 +))) 589 589 705 +((( 590 590 508.1 - SF7BW125 to SF12BW125 707 +))) 591 591 709 +((( 592 592 505.3 - SF12BW125 (RX2 downlink only) 711 +))) 593 593 594 594 595 595 ... ... @@ -614,112 +614,219 @@ 614 614 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 615 615 * 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) 616 616 617 - 618 - 619 619 === 2.8.5 AS920-923 & AS923-925 (AS923) === 620 620 738 +((( 621 621 (% style="color:blue" %)**Default Uplink channel:** 740 +))) 622 622 742 +((( 623 623 923.2 - SF7BW125 to SF10BW125 744 +))) 624 624 746 +((( 625 625 923.4 - SF7BW125 to SF10BW125 748 +))) 626 626 750 +((( 751 + 752 +))) 627 627 754 +((( 628 628 (% style="color:blue" %)**Additional Uplink Channel**: 756 +))) 629 629 758 +((( 630 630 (OTAA mode, channel added by JoinAccept message) 760 +))) 631 631 762 +((( 763 + 764 +))) 632 632 766 +((( 633 633 (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**: 768 +))) 634 634 770 +((( 635 635 922.2 - SF7BW125 to SF10BW125 772 +))) 636 636 774 +((( 637 637 922.4 - SF7BW125 to SF10BW125 776 +))) 638 638 778 +((( 639 639 922.6 - SF7BW125 to SF10BW125 780 +))) 640 640 782 +((( 641 641 922.8 - SF7BW125 to SF10BW125 784 +))) 642 642 786 +((( 643 643 923.0 - SF7BW125 to SF10BW125 788 +))) 644 644 790 +((( 645 645 922.0 - SF7BW125 to SF10BW125 792 +))) 646 646 794 +((( 795 + 796 +))) 647 647 798 +((( 648 648 (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**: 800 +))) 649 649 802 +((( 650 650 923.6 - SF7BW125 to SF10BW125 804 +))) 651 651 806 +((( 652 652 923.8 - SF7BW125 to SF10BW125 808 +))) 653 653 810 +((( 654 654 924.0 - SF7BW125 to SF10BW125 812 +))) 655 655 814 +((( 656 656 924.2 - SF7BW125 to SF10BW125 816 +))) 657 657 818 +((( 658 658 924.4 - SF7BW125 to SF10BW125 820 +))) 659 659 822 +((( 660 660 924.6 - SF7BW125 to SF10BW125 824 +))) 661 661 826 +((( 827 + 828 +))) 662 662 830 +((( 663 663 (% style="color:blue" %)**Downlink:** 832 +))) 664 664 834 +((( 665 665 Uplink channels 1-8 (RX1) 836 +))) 666 666 838 +((( 667 667 923.2 - SF10BW125 (RX2) 840 +))) 668 668 669 669 670 670 671 671 === 2.8.6 KR920-923 (KR920) === 672 672 846 +((( 673 673 (% style="color:blue" %)**Default channel:** 848 +))) 674 674 850 +((( 675 675 922.1 - SF7BW125 to SF12BW125 852 +))) 676 676 854 +((( 677 677 922.3 - SF7BW125 to SF12BW125 856 +))) 678 678 858 +((( 679 679 922.5 - SF7BW125 to SF12BW125 860 +))) 680 680 862 +((( 863 + 864 +))) 681 681 866 +((( 682 682 (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)** 868 +))) 683 683 870 +((( 684 684 922.1 - SF7BW125 to SF12BW125 872 +))) 685 685 874 +((( 686 686 922.3 - SF7BW125 to SF12BW125 876 +))) 687 687 878 +((( 688 688 922.5 - SF7BW125 to SF12BW125 880 +))) 689 689 882 +((( 690 690 922.7 - SF7BW125 to SF12BW125 884 +))) 691 691 886 +((( 692 692 922.9 - SF7BW125 to SF12BW125 888 +))) 693 693 890 +((( 694 694 923.1 - SF7BW125 to SF12BW125 892 +))) 695 695 894 +((( 696 696 923.3 - SF7BW125 to SF12BW125 896 +))) 697 697 898 +((( 899 + 900 +))) 698 698 902 +((( 699 699 (% style="color:blue" %)**Downlink:** 904 +))) 700 700 906 +((( 701 701 Uplink channels 1-7(RX1) 908 +))) 702 702 910 +((( 703 703 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125) 912 +))) 704 704 705 705 706 706 707 707 === 2.8.7 IN865-867 (IN865) === 708 708 918 +((( 709 709 (% style="color:blue" %)**Uplink:** 920 +))) 710 710 922 +((( 711 711 865.0625 - SF7BW125 to SF12BW125 924 +))) 712 712 926 +((( 713 713 865.4025 - SF7BW125 to SF12BW125 928 +))) 714 714 930 +((( 715 715 865.9850 - SF7BW125 to SF12BW125 932 +))) 716 716 934 +((( 935 + 936 +))) 717 717 938 +((( 718 718 (% style="color:blue" %)**Downlink:** 940 +))) 719 719 942 +((( 720 720 Uplink channels 1-3 (RX1) 944 +))) 721 721 946 +((( 722 722 866.550 - SF10BW125 (RX2) 948 +))) 723 723 724 724 725 725 ... ... @@ -731,7 +731,6 @@ 731 731 * Blink once when device transmit a packet. 732 732 733 733 734 - 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 974 +((( 749 749 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 976 +))) 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/]] 978 +* ((( 979 +AT Command Connection: See [[FAQ>>path:#H6.FAQ]]. 980 +))) 981 +* ((( 982 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]] 983 +))) 753 753 985 +((( 754 754 There are two kinds of commands to configure LSPH01, they are: 987 +))) 755 755 756 -* (% style="color:#4f81bd" %)** General Commands**. 989 +* ((( 990 +(% style="color:#4f81bd" %)** General Commands**. 991 +))) 757 757 993 +((( 758 758 These commands are to configure: 995 +))) 759 759 760 -* General system settings like: uplink interval. 761 -* LoRaWAN protocol & radio related command. 997 +* ((( 998 +General system settings like: uplink interval. 999 +))) 1000 +* ((( 1001 +LoRaWAN protocol & radio related command. 1002 +))) 762 762 1004 +((( 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/]] 1006 +))) 764 764 1008 +((( 1009 + 1010 +))) 765 765 766 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01** 1012 +* ((( 1013 +(% style="color:#4f81bd" %)** Commands special design for LSPH01** 1014 +))) 767 767 1016 +((( 768 768 These commands only valid for LSPH01, as below: 1018 +))) 769 769 770 770 771 771 ... ... @@ -779,16 +779,28 @@ 779 779 780 780 781 781 1032 +((( 782 782 (% style="color:#037691" %)**Downlink Command: 0x01** 1034 +))) 783 783 1036 +((( 784 784 Format: Command Code (0x01) followed by 3 bytes time value. 1038 +))) 785 785 1040 +((( 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. 1042 +))) 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 1044 +* ((( 1045 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 1046 +))) 1047 +* ((( 1048 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 790 790 791 791 1051 + 1052 +))) 1053 + 792 792 == 3.2 Set Interrupt Mode == 793 793 794 794 Feature, Set Interrupt mode for GPIO_EXIT. ... ... @@ -798,17 +798,31 @@ 798 798 [[image:image-20220607171716-9.png]] 799 799 800 800 1063 +((( 801 801 (% style="color:#037691" %)**Downlink Command: 0x06** 1065 +))) 802 802 1067 +((( 803 803 Format: Command Code (0x06) followed by 3 bytes. 1069 +))) 804 804 1071 +((( 805 805 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 1073 +))) 806 806 807 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 808 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1075 +* ((( 1076 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 1077 +))) 1078 +* ((( 1079 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1080 +))) 809 809 1082 +((( 1083 + 1084 +))) 810 810 811 811 1087 + 812 812 == 3.3 Calibrate Sensor == 813 813 814 814 Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands ... ... @@ -983,9 +983,13 @@ 983 983 984 984 === 4.3.2 Replace the battery === 985 985 1262 +((( 986 986 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. 1264 +))) 987 987 1266 +((( 988 988 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) 1268 +))) 989 989 990 990 991 991 ... ... @@ -1006,7 +1006,9 @@ 1006 1006 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 1007 1007 1008 1008 1289 +((( 1009 1009 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: 1291 +))) 1010 1010 1011 1011 1012 1012 [[image:1654593712276-618.png]] ... ... @@ -1048,8 +1048,6 @@ 1048 1048 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 1049 1049 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1050 1050 1051 - 1052 - 1053 1053 = 9. Packing Info = 1054 1054 1055 1055 ... ... @@ -1064,8 +1064,6 @@ 1064 1064 * Package Size / pcs : cm 1065 1065 * Weight / pcs : g 1066 1066 1067 - 1068 - 1069 1069 = 10. Support = 1070 1070 1071 1071 * 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.