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 ... ... @@ -209,7 +209,9 @@ 209 209 [[image:image-20220607170442-2.png]] 210 210 211 211 214 +((( 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. 216 +))) 213 213 214 214 [[image:1654592697690-910.png]] 215 215 ... ... @@ -217,11 +217,17 @@ 217 217 218 218 == 2.3 Uplink Payload == 219 219 224 +((( 220 220 LSPH01 will uplink payload via LoRaWAN with below payload format: 226 +))) 221 221 228 +((( 222 222 Uplink payload includes in total 11 bytes. 230 +))) 223 223 232 +((( 224 224 Normal uplink payload: 234 +))) 225 225 226 226 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 227 227 |((( ... ... @@ -305,18 +305,21 @@ 305 305 306 306 === 2.3.6 Message Type === 307 307 318 +((( 308 308 For a normal uplink payload, the message type is always 0x01. 320 +))) 309 309 322 +((( 310 310 Valid Message Type: 324 +))) 311 311 312 312 313 313 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 314 -|**Message Type Code**|**Description**|**Payload** 328 +|=**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]] 318 318 319 - 320 320 === 2.3.7 Decode payload in The Things Network === 321 321 322 322 While using TTN network, you can add the payload format to decode the payload. ... ... @@ -342,12 +342,21 @@ 342 342 343 343 == 2.5 Show Data in DataCake IoT Server == 344 344 358 +((( 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: 360 +))) 346 346 362 +((( 363 + 364 +))) 347 347 366 +((( 348 348 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.** 368 +))) 349 349 370 +((( 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:** 372 +))) 351 351 352 352 353 353 [[image:1654592790040-760.png]] ... ... @@ -370,9 +370,13 @@ 370 370 [[image:1654592856403-259.png]] 371 371 372 372 395 +((( 373 373 (% style="color:blue" %)**Step 5**(%%)**: add payload decode** 397 +))) 374 374 399 +((( 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/]] 401 +))) 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 ((( 424 +((( 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 ))) 427 +))) 400 400 401 401 402 402 ... ... @@ -403,24 +403,45 @@ 403 403 === 2.6.2 Measurement === 404 404 405 405 434 +((( 406 406 (% style="color:#4f81bd" %)**Measurement the soil surface:** 436 +))) 407 407 438 +((( 408 408 [[image:1654592946732-634.png]] 440 +))) 409 409 442 +((( 410 410 Choose the proper measuring position. Split the surface soil according to the measured deep. 444 +))) 411 411 446 +((( 412 412 Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things. 448 +))) 413 413 450 +((( 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. 452 +))) 415 415 454 +((( 416 416 Put soil over the probe after insert. And start to measure. 456 +))) 417 417 458 +((( 459 + 460 +))) 418 418 462 +((( 419 419 (% style="color:#4f81bd" %)**Measurement inside soil:** 464 +))) 420 420 466 +((( 421 421 Dig a hole with diameter > 20CM. 468 +))) 422 422 470 +((( 423 423 Insert the probe inside, method like measure the surface. 472 +))) 424 424 425 425 426 426 ... ... @@ -450,9 +450,13 @@ 450 450 451 451 == 2.7 Calibration == 452 452 502 +((( 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). 504 +))) 454 454 506 +((( 455 455 After stable, user can use below command to calibrate. 508 +))) 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" %) 515 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 463 463 |((( 464 464 **Size** 465 465 ... ... @@ -487,7 +487,6 @@ 487 487 * Reply to the confirmation package: 14 01 488 488 * Reply to non-confirmed packet: 14 00 489 489 490 - 491 491 == 2.8 Frequency Plans == 492 492 493 493 ((( ... ... @@ -497,32 +497,61 @@ 497 497 498 498 === 2.8.1 EU863-870 (EU868) === 499 499 552 +((( 500 500 (% style="color:blue" %)**Uplink:** 554 +))) 501 501 556 +((( 502 502 868.1 - SF7BW125 to SF12BW125 558 +))) 503 503 560 +((( 504 504 868.3 - SF7BW125 to SF12BW125 and SF7BW250 562 +))) 505 505 564 +((( 506 506 868.5 - SF7BW125 to SF12BW125 566 +))) 507 507 568 +((( 508 508 867.1 - SF7BW125 to SF12BW125 570 +))) 509 509 572 +((( 510 510 867.3 - SF7BW125 to SF12BW125 574 +))) 511 511 576 +((( 512 512 867.5 - SF7BW125 to SF12BW125 578 +))) 513 513 580 +((( 514 514 867.7 - SF7BW125 to SF12BW125 582 +))) 515 515 584 +((( 516 516 867.9 - SF7BW125 to SF12BW125 586 +))) 517 517 588 +((( 518 518 868.8 - FSK 590 +))) 519 519 592 +((( 593 + 594 +))) 520 520 596 +((( 521 521 (% style="color:blue" %)**Downlink:** 598 +))) 522 522 600 +((( 523 523 Uplink channels 1-9 (RX1) 602 +))) 524 524 604 +((( 525 525 869.525 - SF9BW125 (RX2 downlink only) 606 +))) 526 526 527 527 528 528 ... ... @@ -543,50 +543,91 @@ 543 543 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 544 544 * 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) 545 545 546 - 547 - 548 548 === 2.8.3 CN470-510 (CN470) === 549 549 629 +((( 550 550 Used in China, Default use CHE=1 631 +))) 551 551 633 +((( 552 552 (% style="color:blue" %)**Uplink:** 635 +))) 553 553 637 +((( 554 554 486.3 - SF7BW125 to SF12BW125 639 +))) 555 555 641 +((( 556 556 486.5 - SF7BW125 to SF12BW125 643 +))) 557 557 645 +((( 558 558 486.7 - SF7BW125 to SF12BW125 647 +))) 559 559 649 +((( 560 560 486.9 - SF7BW125 to SF12BW125 651 +))) 561 561 653 +((( 562 562 487.1 - SF7BW125 to SF12BW125 655 +))) 563 563 657 +((( 564 564 487.3 - SF7BW125 to SF12BW125 659 +))) 565 565 661 +((( 566 566 487.5 - SF7BW125 to SF12BW125 663 +))) 567 567 665 +((( 568 568 487.7 - SF7BW125 to SF12BW125 667 +))) 569 569 669 +((( 670 + 671 +))) 570 570 673 +((( 571 571 (% style="color:blue" %)**Downlink:** 675 +))) 572 572 677 +((( 573 573 506.7 - SF7BW125 to SF12BW125 679 +))) 574 574 681 +((( 575 575 506.9 - SF7BW125 to SF12BW125 683 +))) 576 576 685 +((( 577 577 507.1 - SF7BW125 to SF12BW125 687 +))) 578 578 689 +((( 579 579 507.3 - SF7BW125 to SF12BW125 691 +))) 580 580 693 +((( 581 581 507.5 - SF7BW125 to SF12BW125 695 +))) 582 582 697 +((( 583 583 507.7 - SF7BW125 to SF12BW125 699 +))) 584 584 701 +((( 585 585 507.9 - SF7BW125 to SF12BW125 703 +))) 586 586 705 +((( 587 587 508.1 - SF7BW125 to SF12BW125 707 +))) 588 588 709 +((( 589 589 505.3 - SF12BW125 (RX2 downlink only) 711 +))) 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 738 +((( 618 618 (% style="color:blue" %)**Default Uplink channel:** 740 +))) 619 619 742 +((( 620 620 923.2 - SF7BW125 to SF10BW125 744 +))) 621 621 746 +((( 622 622 923.4 - SF7BW125 to SF10BW125 748 +))) 623 623 750 +((( 751 + 752 +))) 624 624 754 +((( 625 625 (% style="color:blue" %)**Additional Uplink Channel**: 756 +))) 626 626 758 +((( 627 627 (OTAA mode, channel added by JoinAccept message) 760 +))) 628 628 762 +((( 763 + 764 +))) 629 629 766 +((( 630 630 (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**: 768 +))) 631 631 770 +((( 632 632 922.2 - SF7BW125 to SF10BW125 772 +))) 633 633 774 +((( 634 634 922.4 - SF7BW125 to SF10BW125 776 +))) 635 635 778 +((( 636 636 922.6 - SF7BW125 to SF10BW125 780 +))) 637 637 782 +((( 638 638 922.8 - SF7BW125 to SF10BW125 784 +))) 639 639 786 +((( 640 640 923.0 - SF7BW125 to SF10BW125 788 +))) 641 641 790 +((( 642 642 922.0 - SF7BW125 to SF10BW125 792 +))) 643 643 794 +((( 795 + 796 +))) 644 644 798 +((( 645 645 (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**: 800 +))) 646 646 802 +((( 647 647 923.6 - SF7BW125 to SF10BW125 804 +))) 648 648 806 +((( 649 649 923.8 - SF7BW125 to SF10BW125 808 +))) 650 650 810 +((( 651 651 924.0 - SF7BW125 to SF10BW125 812 +))) 652 652 814 +((( 653 653 924.2 - SF7BW125 to SF10BW125 816 +))) 654 654 818 +((( 655 655 924.4 - SF7BW125 to SF10BW125 820 +))) 656 656 822 +((( 657 657 924.6 - SF7BW125 to SF10BW125 824 +))) 658 658 826 +((( 827 + 828 +))) 659 659 830 +((( 660 660 (% style="color:blue" %)**Downlink:** 832 +))) 661 661 834 +((( 662 662 Uplink channels 1-8 (RX1) 836 +))) 663 663 838 +((( 664 664 923.2 - SF10BW125 (RX2) 840 +))) 665 665 666 666 667 667 668 668 === 2.8.6 KR920-923 (KR920) === 669 669 846 +((( 670 670 (% style="color:blue" %)**Default channel:** 848 +))) 671 671 850 +((( 672 672 922.1 - SF7BW125 to SF12BW125 852 +))) 673 673 854 +((( 674 674 922.3 - SF7BW125 to SF12BW125 856 +))) 675 675 858 +((( 676 676 922.5 - SF7BW125 to SF12BW125 860 +))) 677 677 862 +((( 863 + 864 +))) 678 678 866 +((( 679 679 (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)** 868 +))) 680 680 870 +((( 681 681 922.1 - SF7BW125 to SF12BW125 872 +))) 682 682 874 +((( 683 683 922.3 - SF7BW125 to SF12BW125 876 +))) 684 684 878 +((( 685 685 922.5 - SF7BW125 to SF12BW125 880 +))) 686 686 882 +((( 687 687 922.7 - SF7BW125 to SF12BW125 884 +))) 688 688 886 +((( 689 689 922.9 - SF7BW125 to SF12BW125 888 +))) 690 690 890 +((( 691 691 923.1 - SF7BW125 to SF12BW125 892 +))) 692 692 894 +((( 693 693 923.3 - SF7BW125 to SF12BW125 896 +))) 694 694 898 +((( 899 + 900 +))) 695 695 902 +((( 696 696 (% style="color:blue" %)**Downlink:** 904 +))) 697 697 906 +((( 698 698 Uplink channels 1-7(RX1) 908 +))) 699 699 910 +((( 700 700 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125) 912 +))) 701 701 702 702 703 703 704 704 === 2.8.7 IN865-867 (IN865) === 705 705 918 +((( 706 706 (% style="color:blue" %)**Uplink:** 920 +))) 707 707 922 +((( 708 708 865.0625 - SF7BW125 to SF12BW125 924 +))) 709 709 926 +((( 710 710 865.4025 - SF7BW125 to SF12BW125 928 +))) 711 711 930 +((( 712 712 865.9850 - SF7BW125 to SF12BW125 932 +))) 713 713 934 +((( 935 + 936 +))) 714 714 938 +((( 715 715 (% style="color:blue" %)**Downlink:** 940 +))) 716 716 942 +((( 717 717 Uplink channels 1-3 (RX1) 944 +))) 718 718 946 +((( 719 719 866.550 - SF10BW125 (RX2) 948 +))) 720 720 721 721 722 722 ... ... @@ -728,7 +728,6 @@ 728 728 * Blink once when device transmit a packet. 729 729 730 730 731 - 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 974 +((( 746 746 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 976 +))) 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/]] 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 +))) 750 750 985 +((( 751 751 There are two kinds of commands to configure LSPH01, they are: 987 +))) 752 752 753 -* (% style="color:#4f81bd" %)** General Commands**. 989 +* ((( 990 +(% style="color:#4f81bd" %)** General Commands**. 991 +))) 754 754 993 +((( 755 755 These commands are to configure: 995 +))) 756 756 757 -* General system settings like: uplink interval. 758 -* LoRaWAN protocol & radio related command. 997 +* ((( 998 +General system settings like: uplink interval. 999 +))) 1000 +* ((( 1001 +LoRaWAN protocol & radio related command. 1002 +))) 759 759 1004 +((( 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/]] 1006 +))) 761 761 1008 +((( 1009 + 1010 +))) 762 762 763 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01** 1012 +* ((( 1013 +(% style="color:#4f81bd" %)** Commands special design for LSPH01** 1014 +))) 764 764 1016 +((( 765 765 These commands only valid for LSPH01, as below: 1018 +))) 766 766 767 767 768 768 ... ... @@ -776,16 +776,28 @@ 776 776 777 777 778 778 1032 +((( 779 779 (% style="color:#037691" %)**Downlink Command: 0x01** 1034 +))) 780 780 1036 +((( 781 781 Format: Command Code (0x01) followed by 3 bytes time value. 1038 +))) 782 782 1040 +((( 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. 1042 +))) 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 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 787 787 788 788 1051 + 1052 +))) 1053 + 789 789 == 3.2 Set Interrupt Mode == 790 790 791 791 Feature, Set Interrupt mode for GPIO_EXIT. ... ... @@ -795,17 +795,31 @@ 795 795 [[image:image-20220607171716-9.png]] 796 796 797 797 1063 +((( 798 798 (% style="color:#037691" %)**Downlink Command: 0x06** 1065 +))) 799 799 1067 +((( 800 800 Format: Command Code (0x06) followed by 3 bytes. 1069 +))) 801 801 1071 +((( 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. 1073 +))) 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 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 +))) 806 806 1082 +((( 1083 + 1084 +))) 807 807 808 808 1087 + 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 1262 +((( 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. 1264 +))) 984 984 1266 +((( 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) 1268 +))) 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 1289 +((( 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: 1291 +))) 1007 1007 1008 1008 1009 1009 [[image:1654593712276-618.png]] ... ... @@ -1045,8 +1045,6 @@ 1045 1045 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band 1046 1046 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1047 1047 1048 - 1049 - 1050 1050 = 9. Packing Info = 1051 1051 1052 1052 ... ... @@ -1061,8 +1061,6 @@ 1061 1061 * Package Size / pcs : cm 1062 1062 * Weight / pcs : g 1063 1063 1064 - 1065 - 1066 1066 = 10. Support = 1067 1067 1068 1068 * 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.