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,22 +66,29 @@ 66 66 67 67 68 68 69 - 70 - 71 - 72 72 = 1. Introduction = 73 73 74 74 == 1.1 What is LoRaWAN Soil pH Sensor == 75 75 73 +((( 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. 75 +))) 77 77 77 +((( 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. 79 +))) 79 79 81 +((( 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. 83 +))) 81 81 85 +((( 82 82 LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years. 87 +))) 83 83 89 +((( 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. 91 +))) 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 ... ... @@ -209,7 +209,9 @@ 209 209 [[image:image-20220607170442-2.png]] 210 210 211 211 216 +((( 212 212 (% 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 +))) 213 213 214 214 [[image:1654592697690-910.png]] 215 215 ... ... @@ -217,11 +217,17 @@ 217 217 218 218 == 2.3 Uplink Payload == 219 219 226 +((( 220 220 LSPH01 will uplink payload via LoRaWAN with below payload format: 228 +))) 221 221 230 +((( 222 222 Uplink payload includes in total 11 bytes. 232 +))) 223 223 234 +((( 224 224 Normal uplink payload: 236 +))) 225 225 226 226 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 227 227 |((( ... ... @@ -305,13 +305,17 @@ 305 305 306 306 === 2.3.6 Message Type === 307 307 320 +((( 308 308 For a normal uplink payload, the message type is always 0x01. 322 +))) 309 309 324 +((( 310 310 Valid Message Type: 326 +))) 311 311 312 312 313 313 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 314 -|**Message Type Code**|**Description**|**Payload** 330 +|=**Message Type Code**|=**Description**|=**Payload** 315 315 |0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]] 316 316 |0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]] 317 317 |0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]] ... ... @@ -342,12 +342,21 @@ 342 342 343 343 == 2.5 Show Data in DataCake IoT Server == 344 344 361 +((( 345 345 [[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 +))) 346 346 365 +((( 366 + 367 +))) 347 347 369 +((( 348 348 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.** 371 +))) 349 349 373 +((( 350 350 (% 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 +))) 351 351 352 352 353 353 [[image:1654592790040-760.png]] ... ... @@ -370,9 +370,13 @@ 370 370 [[image:1654592856403-259.png]] 371 371 372 372 398 +((( 373 373 (% style="color:blue" %)**Step 5**(%%)**: add payload decode** 400 +))) 374 374 402 +((( 375 375 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 +))) 376 376 377 377 378 378 [[image:1654592878525-845.png]] ... ... @@ -395,8 +395,10 @@ 395 395 === 2.6.1 Before measurement === 396 396 397 397 ((( 427 +((( 398 398 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. 399 399 ))) 430 +))) 400 400 401 401 402 402 ... ... @@ -403,24 +403,45 @@ 403 403 === 2.6.2 Measurement === 404 404 405 405 437 +((( 406 406 (% style="color:#4f81bd" %)**Measurement the soil surface:** 439 +))) 407 407 441 +((( 408 408 [[image:1654592946732-634.png]] 443 +))) 409 409 445 +((( 410 410 Choose the proper measuring position. Split the surface soil according to the measured deep. 447 +))) 411 411 449 +((( 412 412 Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things. 451 +))) 413 413 453 +((( 414 414 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 +))) 415 415 457 +((( 416 416 Put soil over the probe after insert. And start to measure. 459 +))) 417 417 461 +((( 462 + 463 +))) 418 418 465 +((( 419 419 (% style="color:#4f81bd" %)**Measurement inside soil:** 467 +))) 420 420 469 +((( 421 421 Dig a hole with diameter > 20CM. 471 +))) 422 422 473 +((( 423 423 Insert the probe inside, method like measure the surface. 475 +))) 424 424 425 425 426 426 ... ... @@ -450,9 +450,13 @@ 450 450 451 451 == 2.7 Calibration == 452 452 505 +((( 453 453 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 +))) 454 454 509 +((( 455 455 After stable, user can use below command to calibrate. 511 +))) 456 456 457 457 [[image:image-20220607171149-4.png]] 458 458 ... ... @@ -459,7 +459,7 @@ 459 459 460 460 (% style="color:#037691" %)**Calibration Payload** 461 461 462 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 518 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 463 463 |((( 464 464 **Size** 465 465 ... ... @@ -497,32 +497,61 @@ 497 497 498 498 === 2.8.1 EU863-870 (EU868) === 499 499 556 +((( 500 500 (% style="color:blue" %)**Uplink:** 558 +))) 501 501 560 +((( 502 502 868.1 - SF7BW125 to SF12BW125 562 +))) 503 503 564 +((( 504 504 868.3 - SF7BW125 to SF12BW125 and SF7BW250 566 +))) 505 505 568 +((( 506 506 868.5 - SF7BW125 to SF12BW125 570 +))) 507 507 572 +((( 508 508 867.1 - SF7BW125 to SF12BW125 574 +))) 509 509 576 +((( 510 510 867.3 - SF7BW125 to SF12BW125 578 +))) 511 511 580 +((( 512 512 867.5 - SF7BW125 to SF12BW125 582 +))) 513 513 584 +((( 514 514 867.7 - SF7BW125 to SF12BW125 586 +))) 515 515 588 +((( 516 516 867.9 - SF7BW125 to SF12BW125 590 +))) 517 517 592 +((( 518 518 868.8 - FSK 594 +))) 519 519 596 +((( 597 + 598 +))) 520 520 600 +((( 521 521 (% style="color:blue" %)**Downlink:** 602 +))) 522 522 604 +((( 523 523 Uplink channels 1-9 (RX1) 606 +))) 524 524 608 +((( 525 525 869.525 - SF9BW125 (RX2 downlink only) 610 +))) 526 526 527 527 528 528 ... ... @@ -547,46 +547,89 @@ 547 547 548 548 === 2.8.3 CN470-510 (CN470) === 549 549 635 +((( 550 550 Used in China, Default use CHE=1 637 +))) 551 551 639 +((( 552 552 (% style="color:blue" %)**Uplink:** 641 +))) 553 553 643 +((( 554 554 486.3 - SF7BW125 to SF12BW125 645 +))) 555 555 647 +((( 556 556 486.5 - SF7BW125 to SF12BW125 649 +))) 557 557 651 +((( 558 558 486.7 - SF7BW125 to SF12BW125 653 +))) 559 559 655 +((( 560 560 486.9 - SF7BW125 to SF12BW125 657 +))) 561 561 659 +((( 562 562 487.1 - SF7BW125 to SF12BW125 661 +))) 563 563 663 +((( 564 564 487.3 - SF7BW125 to SF12BW125 665 +))) 565 565 667 +((( 566 566 487.5 - SF7BW125 to SF12BW125 669 +))) 567 567 671 +((( 568 568 487.7 - SF7BW125 to SF12BW125 673 +))) 569 569 675 +((( 676 + 677 +))) 570 570 679 +((( 571 571 (% style="color:blue" %)**Downlink:** 681 +))) 572 572 683 +((( 573 573 506.7 - SF7BW125 to SF12BW125 685 +))) 574 574 687 +((( 575 575 506.9 - SF7BW125 to SF12BW125 689 +))) 576 576 691 +((( 577 577 507.1 - SF7BW125 to SF12BW125 693 +))) 578 578 695 +((( 579 579 507.3 - SF7BW125 to SF12BW125 697 +))) 580 580 699 +((( 581 581 507.5 - SF7BW125 to SF12BW125 701 +))) 582 582 703 +((( 583 583 507.7 - SF7BW125 to SF12BW125 705 +))) 584 584 707 +((( 585 585 507.9 - SF7BW125 to SF12BW125 709 +))) 586 586 711 +((( 587 587 508.1 - SF7BW125 to SF12BW125 713 +))) 588 588 715 +((( 589 589 505.3 - SF12BW125 (RX2 downlink only) 717 +))) 590 590 591 591 592 592 ... ... @@ -611,112 +611,219 @@ 611 611 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 612 612 * 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) 613 613 614 - 615 - 616 616 === 2.8.5 AS920-923 & AS923-925 (AS923) === 617 617 744 +((( 618 618 (% style="color:blue" %)**Default Uplink channel:** 746 +))) 619 619 748 +((( 620 620 923.2 - SF7BW125 to SF10BW125 750 +))) 621 621 752 +((( 622 622 923.4 - SF7BW125 to SF10BW125 754 +))) 623 623 756 +((( 757 + 758 +))) 624 624 760 +((( 625 625 (% style="color:blue" %)**Additional Uplink Channel**: 762 +))) 626 626 764 +((( 627 627 (OTAA mode, channel added by JoinAccept message) 766 +))) 628 628 768 +((( 769 + 770 +))) 629 629 772 +((( 630 630 (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**: 774 +))) 631 631 776 +((( 632 632 922.2 - SF7BW125 to SF10BW125 778 +))) 633 633 780 +((( 634 634 922.4 - SF7BW125 to SF10BW125 782 +))) 635 635 784 +((( 636 636 922.6 - SF7BW125 to SF10BW125 786 +))) 637 637 788 +((( 638 638 922.8 - SF7BW125 to SF10BW125 790 +))) 639 639 792 +((( 640 640 923.0 - SF7BW125 to SF10BW125 794 +))) 641 641 796 +((( 642 642 922.0 - SF7BW125 to SF10BW125 798 +))) 643 643 800 +((( 801 + 802 +))) 644 644 804 +((( 645 645 (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**: 806 +))) 646 646 808 +((( 647 647 923.6 - SF7BW125 to SF10BW125 810 +))) 648 648 812 +((( 649 649 923.8 - SF7BW125 to SF10BW125 814 +))) 650 650 816 +((( 651 651 924.0 - SF7BW125 to SF10BW125 818 +))) 652 652 820 +((( 653 653 924.2 - SF7BW125 to SF10BW125 822 +))) 654 654 824 +((( 655 655 924.4 - SF7BW125 to SF10BW125 826 +))) 656 656 828 +((( 657 657 924.6 - SF7BW125 to SF10BW125 830 +))) 658 658 832 +((( 833 + 834 +))) 659 659 836 +((( 660 660 (% style="color:blue" %)**Downlink:** 838 +))) 661 661 840 +((( 662 662 Uplink channels 1-8 (RX1) 842 +))) 663 663 844 +((( 664 664 923.2 - SF10BW125 (RX2) 846 +))) 665 665 666 666 667 667 668 668 === 2.8.6 KR920-923 (KR920) === 669 669 852 +((( 670 670 (% style="color:blue" %)**Default channel:** 854 +))) 671 671 856 +((( 672 672 922.1 - SF7BW125 to SF12BW125 858 +))) 673 673 860 +((( 674 674 922.3 - SF7BW125 to SF12BW125 862 +))) 675 675 864 +((( 676 676 922.5 - SF7BW125 to SF12BW125 866 +))) 677 677 868 +((( 869 + 870 +))) 678 678 872 +((( 679 679 (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)** 874 +))) 680 680 876 +((( 681 681 922.1 - SF7BW125 to SF12BW125 878 +))) 682 682 880 +((( 683 683 922.3 - SF7BW125 to SF12BW125 882 +))) 684 684 884 +((( 685 685 922.5 - SF7BW125 to SF12BW125 886 +))) 686 686 888 +((( 687 687 922.7 - SF7BW125 to SF12BW125 890 +))) 688 688 892 +((( 689 689 922.9 - SF7BW125 to SF12BW125 894 +))) 690 690 896 +((( 691 691 923.1 - SF7BW125 to SF12BW125 898 +))) 692 692 900 +((( 693 693 923.3 - SF7BW125 to SF12BW125 902 +))) 694 694 904 +((( 905 + 906 +))) 695 695 908 +((( 696 696 (% style="color:blue" %)**Downlink:** 910 +))) 697 697 912 +((( 698 698 Uplink channels 1-7(RX1) 914 +))) 699 699 916 +((( 700 700 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125) 918 +))) 701 701 702 702 703 703 704 704 === 2.8.7 IN865-867 (IN865) === 705 705 924 +((( 706 706 (% style="color:blue" %)**Uplink:** 926 +))) 707 707 928 +((( 708 708 865.0625 - SF7BW125 to SF12BW125 930 +))) 709 709 932 +((( 710 710 865.4025 - SF7BW125 to SF12BW125 934 +))) 711 711 936 +((( 712 712 865.9850 - SF7BW125 to SF12BW125 938 +))) 713 713 940 +((( 941 + 942 +))) 714 714 944 +((( 715 715 (% style="color:blue" %)**Downlink:** 946 +))) 716 716 948 +((( 717 717 Uplink channels 1-3 (RX1) 950 +))) 718 718 952 +((( 719 719 866.550 - SF10BW125 (RX2) 954 +))) 720 720 721 721 722 722 ... ... @@ -729,6 +729,7 @@ 729 729 730 730 731 731 967 + 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 982 +((( 746 746 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 984 +))) 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/]] 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 +))) 750 750 993 +((( 751 751 There are two kinds of commands to configure LSPH01, they are: 995 +))) 752 752 753 -* (% style="color:#4f81bd" %)** General Commands**. 997 +* ((( 998 +(% style="color:#4f81bd" %)** General Commands**. 999 +))) 754 754 1001 +((( 755 755 These commands are to configure: 1003 +))) 756 756 757 -* General system settings like: uplink interval. 758 -* LoRaWAN protocol & radio related command. 1005 +* ((( 1006 +General system settings like: uplink interval. 1007 +))) 1008 +* ((( 1009 +LoRaWAN protocol & radio related command. 1010 +))) 759 759 1012 +((( 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/]] 1014 +))) 761 761 1016 +((( 1017 + 1018 +))) 762 762 763 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01** 1020 +* ((( 1021 +(% style="color:#4f81bd" %)** Commands special design for LSPH01** 1022 +))) 764 764 1024 +((( 765 765 These commands only valid for LSPH01, as below: 1026 +))) 766 766 767 767 768 768 ... ... @@ -776,14 +776,24 @@ 776 776 777 777 778 778 1040 +((( 779 779 (% style="color:#037691" %)**Downlink Command: 0x01** 1042 +))) 780 780 1044 +((( 781 781 Format: Command Code (0x01) followed by 3 bytes time value. 1046 +))) 782 782 1048 +((( 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. 1050 +))) 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 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 +))) 787 787 788 788 789 789 == 3.2 Set Interrupt Mode == ... ... @@ -795,17 +795,31 @@ 795 795 [[image:image-20220607171716-9.png]] 796 796 797 797 1069 +((( 798 798 (% style="color:#037691" %)**Downlink Command: 0x06** 1071 +))) 799 799 1073 +((( 800 800 Format: Command Code (0x06) followed by 3 bytes. 1075 +))) 801 801 1077 +((( 802 802 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 +))) 803 803 804 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 805 -* 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 +))) 806 806 1088 +((( 1089 + 1090 +))) 807 807 808 808 1093 + 809 809 == 3.3 Calibrate Sensor == 810 810 811 811 Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands ... ... @@ -980,9 +980,13 @@ 980 980 981 981 === 4.3.2 Replace the battery === 982 982 1268 +((( 983 983 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 +))) 984 984 1272 +((( 985 985 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 +))) 986 986 987 987 988 988 ... ... @@ -1003,7 +1003,9 @@ 1003 1003 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 1004 1004 1005 1005 1295 +((( 1006 1006 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 +))) 1007 1007 1008 1008 1009 1009 [[image:1654593712276-618.png]]