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
-
... ... @@ -62,25 +62,29 @@ 62 62 * [[10. Support>>path:#H10.A0200BSupport]] 63 63 64 64 65 - 66 - 67 - 68 - 69 - 70 - 71 71 = 1. Introduction = 72 72 73 73 == 1.1 What is LoRaWAN Soil pH Sensor == 74 74 69 +((( 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. 71 +))) 76 76 73 +((( 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. 75 +))) 78 78 77 +((( 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. 79 +))) 80 80 81 +((( 81 81 LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 83 +))) 82 82 85 +((( 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. 87 +))) 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 212 +((( 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. 214 +))) 215 215 216 216 [[image:1654592697690-910.png]] 217 217 ... ... @@ -219,11 +219,17 @@ 219 219 220 220 == 2.3 Uplink Payload == 221 221 222 +((( 222 222 LSPH01 will uplink payload via LoRaWAN with below payload format: 224 +))) 223 223 226 +((( 224 224 Uplink payload includes in total 11 bytes. 228 +))) 225 225 230 +((( 226 226 Normal uplink payload: 232 +))) 227 227 228 228 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 229 229 |((( ... ... @@ -307,13 +307,17 @@ 307 307 308 308 === 2.3.6 Message Type === 309 309 316 +((( 310 310 For a normal uplink payload, the message type is always 0x01. 318 +))) 311 311 320 +((( 312 312 Valid Message Type: 322 +))) 313 313 314 314 315 315 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 316 -|**Message Type Code**|**Description**|**Payload** 326 +|=**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]] ... ... @@ -346,12 +346,21 @@ 346 346 347 347 == 2.5 Show Data in DataCake IoT Server == 348 348 359 +((( 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: 361 +))) 350 350 363 +((( 364 + 365 +))) 351 351 367 +((( 352 352 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.** 369 +))) 353 353 371 +((( 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:** 373 +))) 355 355 356 356 357 357 [[image:1654592790040-760.png]] ... ... @@ -374,9 +374,13 @@ 374 374 [[image:1654592856403-259.png]] 375 375 376 376 396 +((( 377 377 (% style="color:blue" %)**Step 5**(%%)**: add payload decode** 398 +))) 378 378 400 +((( 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/]] 402 +))) 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 ((( 425 +((( 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 ))) 428 +))) 404 404 405 405 406 406 ... ... @@ -407,24 +407,45 @@ 407 407 === 2.6.2 Measurement === 408 408 409 409 435 +((( 410 410 (% style="color:#4f81bd" %)**Measurement the soil surface:** 437 +))) 411 411 439 +((( 412 412 [[image:1654592946732-634.png]] 441 +))) 413 413 443 +((( 414 414 Choose the proper measuring position. Split the surface soil according to the measured deep. 445 +))) 415 415 447 +((( 416 416 Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things. 449 +))) 417 417 451 +((( 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. 453 +))) 419 419 455 +((( 420 420 Put soil over the probe after insert. And start to measure. 457 +))) 421 421 459 +((( 460 + 461 +))) 422 422 463 +((( 423 423 (% style="color:#4f81bd" %)**Measurement inside soil:** 465 +))) 424 424 467 +((( 425 425 Dig a hole with diameter > 20CM. 469 +))) 426 426 471 +((( 427 427 Insert the probe inside, method like measure the surface. 473 +))) 428 428 429 429 430 430 ... ... @@ -454,9 +454,13 @@ 454 454 455 455 == 2.7 Calibration == 456 456 503 +((( 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). 505 +))) 458 458 507 +((( 459 459 After stable, user can use below command to calibrate. 509 +))) 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" %) 516 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 467 467 |((( 468 468 **Size** 469 469 ... ... @@ -491,6 +491,9 @@ 491 491 * Reply to the confirmation package: 14 01 492 492 * Reply to non-confirmed packet: 14 00 493 493 544 + 545 + 546 + 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 556 +((( 503 503 (% style="color:blue" %)**Uplink:** 558 +))) 504 504 560 +((( 505 505 868.1 - SF7BW125 to SF12BW125 562 +))) 506 506 564 +((( 507 507 868.3 - SF7BW125 to SF12BW125 and SF7BW250 566 +))) 508 508 568 +((( 509 509 868.5 - SF7BW125 to SF12BW125 570 +))) 510 510 572 +((( 511 511 867.1 - SF7BW125 to SF12BW125 574 +))) 512 512 576 +((( 513 513 867.3 - SF7BW125 to SF12BW125 578 +))) 514 514 580 +((( 515 515 867.5 - SF7BW125 to SF12BW125 582 +))) 516 516 584 +((( 517 517 867.7 - SF7BW125 to SF12BW125 586 +))) 518 518 588 +((( 519 519 867.9 - SF7BW125 to SF12BW125 590 +))) 520 520 592 +((( 521 521 868.8 - FSK 594 +))) 522 522 596 +((( 597 + 598 +))) 523 523 600 +((( 524 524 (% style="color:blue" %)**Downlink:** 602 +))) 525 525 604 +((( 526 526 Uplink channels 1-9 (RX1) 606 +))) 527 527 608 +((( 528 528 869.525 - SF9BW125 (RX2 downlink only) 610 +))) 529 529 530 530 531 531 ... ... @@ -547,48 +547,93 @@ 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 549 632 + 633 + 550 550 === 2.8.3 CN470-510 (CN470) === 551 551 636 +((( 552 552 Used in China, Default use CHE=1 638 +))) 553 553 640 +((( 554 554 (% style="color:blue" %)**Uplink:** 642 +))) 555 555 644 +((( 556 556 486.3 - SF7BW125 to SF12BW125 646 +))) 557 557 648 +((( 558 558 486.5 - SF7BW125 to SF12BW125 650 +))) 559 559 652 +((( 560 560 486.7 - SF7BW125 to SF12BW125 654 +))) 561 561 656 +((( 562 562 486.9 - SF7BW125 to SF12BW125 658 +))) 563 563 660 +((( 564 564 487.1 - SF7BW125 to SF12BW125 662 +))) 565 565 664 +((( 566 566 487.3 - SF7BW125 to SF12BW125 666 +))) 567 567 668 +((( 568 568 487.5 - SF7BW125 to SF12BW125 670 +))) 569 569 672 +((( 570 570 487.7 - SF7BW125 to SF12BW125 674 +))) 571 571 676 +((( 677 + 678 +))) 572 572 680 +((( 573 573 (% style="color:blue" %)**Downlink:** 682 +))) 574 574 684 +((( 575 575 506.7 - SF7BW125 to SF12BW125 686 +))) 576 576 688 +((( 577 577 506.9 - SF7BW125 to SF12BW125 690 +))) 578 578 692 +((( 579 579 507.1 - SF7BW125 to SF12BW125 694 +))) 580 580 696 +((( 581 581 507.3 - SF7BW125 to SF12BW125 698 +))) 582 582 700 +((( 583 583 507.5 - SF7BW125 to SF12BW125 702 +))) 584 584 704 +((( 585 585 507.7 - SF7BW125 to SF12BW125 706 +))) 586 586 708 +((( 587 587 507.9 - SF7BW125 to SF12BW125 710 +))) 588 588 712 +((( 589 589 508.1 - SF7BW125 to SF12BW125 714 +))) 590 590 716 +((( 591 591 505.3 - SF12BW125 (RX2 downlink only) 718 +))) 592 592 593 593 594 594 ... ... @@ -614,110 +614,221 @@ 614 614 * 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) 615 615 616 616 744 + 745 + 617 617 === 2.8.5 AS920-923 & AS923-925 (AS923) === 618 618 748 +((( 619 619 (% style="color:blue" %)**Default Uplink channel:** 750 +))) 620 620 752 +((( 621 621 923.2 - SF7BW125 to SF10BW125 754 +))) 622 622 756 +((( 623 623 923.4 - SF7BW125 to SF10BW125 758 +))) 624 624 760 +((( 761 + 762 +))) 625 625 764 +((( 626 626 (% style="color:blue" %)**Additional Uplink Channel**: 766 +))) 627 627 768 +((( 628 628 (OTAA mode, channel added by JoinAccept message) 770 +))) 629 629 772 +((( 773 + 774 +))) 630 630 776 +((( 631 631 (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**: 778 +))) 632 632 780 +((( 633 633 922.2 - SF7BW125 to SF10BW125 782 +))) 634 634 784 +((( 635 635 922.4 - SF7BW125 to SF10BW125 786 +))) 636 636 788 +((( 637 637 922.6 - SF7BW125 to SF10BW125 790 +))) 638 638 792 +((( 639 639 922.8 - SF7BW125 to SF10BW125 794 +))) 640 640 796 +((( 641 641 923.0 - SF7BW125 to SF10BW125 798 +))) 642 642 800 +((( 643 643 922.0 - SF7BW125 to SF10BW125 802 +))) 644 644 804 +((( 805 + 806 +))) 645 645 808 +((( 646 646 (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**: 810 +))) 647 647 812 +((( 648 648 923.6 - SF7BW125 to SF10BW125 814 +))) 649 649 816 +((( 650 650 923.8 - SF7BW125 to SF10BW125 818 +))) 651 651 820 +((( 652 652 924.0 - SF7BW125 to SF10BW125 822 +))) 653 653 824 +((( 654 654 924.2 - SF7BW125 to SF10BW125 826 +))) 655 655 828 +((( 656 656 924.4 - SF7BW125 to SF10BW125 830 +))) 657 657 832 +((( 658 658 924.6 - SF7BW125 to SF10BW125 834 +))) 659 659 836 +((( 837 + 838 +))) 660 660 840 +((( 661 661 (% style="color:blue" %)**Downlink:** 842 +))) 662 662 844 +((( 663 663 Uplink channels 1-8 (RX1) 846 +))) 664 664 848 +((( 665 665 923.2 - SF10BW125 (RX2) 850 +))) 666 666 667 667 668 668 669 669 === 2.8.6 KR920-923 (KR920) === 670 670 856 +((( 671 671 (% style="color:blue" %)**Default channel:** 858 +))) 672 672 860 +((( 673 673 922.1 - SF7BW125 to SF12BW125 862 +))) 674 674 864 +((( 675 675 922.3 - SF7BW125 to SF12BW125 866 +))) 676 676 868 +((( 677 677 922.5 - SF7BW125 to SF12BW125 870 +))) 678 678 872 +((( 873 + 874 +))) 679 679 876 +((( 680 680 (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)** 878 +))) 681 681 880 +((( 682 682 922.1 - SF7BW125 to SF12BW125 882 +))) 683 683 884 +((( 684 684 922.3 - SF7BW125 to SF12BW125 886 +))) 685 685 888 +((( 686 686 922.5 - SF7BW125 to SF12BW125 890 +))) 687 687 892 +((( 688 688 922.7 - SF7BW125 to SF12BW125 894 +))) 689 689 896 +((( 690 690 922.9 - SF7BW125 to SF12BW125 898 +))) 691 691 900 +((( 692 692 923.1 - SF7BW125 to SF12BW125 902 +))) 693 693 904 +((( 694 694 923.3 - SF7BW125 to SF12BW125 906 +))) 695 695 908 +((( 909 + 910 +))) 696 696 912 +((( 697 697 (% style="color:blue" %)**Downlink:** 914 +))) 698 698 916 +((( 699 699 Uplink channels 1-7(RX1) 918 +))) 700 700 920 +((( 701 701 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125) 922 +))) 702 702 703 703 704 704 705 705 === 2.8.7 IN865-867 (IN865) === 706 706 928 +((( 707 707 (% style="color:blue" %)**Uplink:** 930 +))) 708 708 932 +((( 709 709 865.0625 - SF7BW125 to SF12BW125 934 +))) 710 710 936 +((( 711 711 865.4025 - SF7BW125 to SF12BW125 938 +))) 712 712 940 +((( 713 713 865.9850 - SF7BW125 to SF12BW125 942 +))) 714 714 944 +((( 945 + 946 +))) 715 715 948 +((( 716 716 (% style="color:blue" %)**Downlink:** 950 +))) 717 717 952 +((( 718 718 Uplink channels 1-3 (RX1) 954 +))) 719 719 956 +((( 720 720 866.550 - SF10BW125 (RX2) 958 +))) 721 721 722 722 723 723 ... ... @@ -729,6 +729,7 @@ 729 729 * Blink once when device transmit a packet. 730 730 731 731 970 + 732 732 == 2.10 Firmware Change Log == 733 733 734 734 ... ... @@ -743,26 +743,51 @@ 743 743 744 744 = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink = 745 745 985 +((( 746 746 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 987 +))) 747 747 748 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]]. 749 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]] 989 +* ((( 990 +AT Command Connection: See [[FAQ>>path:#H6.FAQ]]. 991 +))) 992 +* ((( 993 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]] 994 +))) 750 750 996 +((( 751 751 There are two kinds of commands to configure LSPH01, they are: 998 +))) 752 752 753 -* (% style="color:#4f81bd" %)** General Commands**. 1000 +* ((( 1001 +(% style="color:#4f81bd" %)** General Commands**. 1002 +))) 754 754 1004 +((( 755 755 These commands are to configure: 1006 +))) 756 756 757 -* General system settings like: uplink interval. 758 -* LoRaWAN protocol & radio related command. 1008 +* ((( 1009 +General system settings like: uplink interval. 1010 +))) 1011 +* ((( 1012 +LoRaWAN protocol & radio related command. 1013 +))) 759 759 1015 +((( 760 760 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/]] 1017 +))) 761 761 1019 +((( 1020 + 1021 +))) 762 762 763 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01** 1023 +* ((( 1024 +(% style="color:#4f81bd" %)** Commands special design for LSPH01** 1025 +))) 764 764 1027 +((( 765 765 These commands only valid for LSPH01, as below: 1029 +))) 766 766 767 767 768 768 ... ... @@ -776,15 +776,28 @@ 776 776 777 777 778 778 1043 +((( 779 779 (% style="color:#037691" %)**Downlink Command: 0x01** 1045 +))) 780 780 1047 +((( 781 781 Format: Command Code (0x01) followed by 3 bytes time value. 1049 +))) 782 782 1051 +((( 783 783 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01. 1053 +))) 784 784 785 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 786 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 1055 +* ((( 1056 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 1057 +))) 1058 +* ((( 1059 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 787 787 1061 + 1062 + 1063 +))) 1064 + 788 788 == 3.2 Set Interrupt Mode == 789 789 790 790 Feature, Set Interrupt mode for GPIO_EXIT. ... ... @@ -794,16 +794,31 @@ 794 794 [[image:image-20220607171716-9.png]] 795 795 796 796 1074 +((( 797 797 (% style="color:#037691" %)**Downlink Command: 0x06** 1076 +))) 798 798 1078 +((( 799 799 Format: Command Code (0x06) followed by 3 bytes. 1080 +))) 800 800 1082 +((( 801 801 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 1084 +))) 802 802 803 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 804 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1086 +* ((( 1087 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 1088 +))) 1089 +* ((( 1090 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1091 +))) 805 805 1093 +((( 1094 + 1095 +))) 806 806 1097 + 1098 + 807 807 == 3.3 Calibrate Sensor == 808 808 809 809 Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands ... ... @@ -978,9 +978,13 @@ 978 978 979 979 === 4.3.2 Replace the battery === 980 980 1273 +((( 981 981 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. 1275 +))) 982 982 1277 +((( 983 983 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) 1279 +))) 984 984 985 985 986 986 ... ... @@ -1001,7 +1001,9 @@ 1001 1001 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 1002 1002 1003 1003 1300 +((( 1004 1004 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: 1302 +))) 1005 1005 1006 1006 1007 1007 [[image:1654593712276-618.png]] ... ... @@ -1043,7 +1043,6 @@ 1043 1043 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 1044 1044 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1045 1045 1046 - 1047 1047 = 9. Packing Info = 1048 1048 1049 1049 ... ... @@ -1058,7 +1058,6 @@ 1058 1058 * Package Size / pcs : cm 1059 1059 * Weight / pcs : g 1060 1060 1061 - 1062 1062 = 10. Support = 1063 1063 1064 1064 * 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.