Last modified by Xiaoling on 2024/01/17 16:19
<
From version < 73.9 >
edited by Xiaoling
on 2022/06/07 17:31
To version < 77.1 >
edited by Xiaoling
on 2022/06/07 18:00
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -65,22 +65,29 @@
65 65  
66 66  
67 67  
68 -
69 -
70 -
71 71  = 1. Introduction =
72 72  
73 73  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
74 74  
72 +(((
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.
74 +)))
76 76  
76 +(((
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.
78 +)))
78 78  
80 +(((
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.
82 +)))
80 80  
84 +(((
81 81  LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
86 +)))
82 82  
88 +(((
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.
90 +)))
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  
215 +(((
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.
217 +)))
215 215  
216 216  [[image:1654592697690-910.png]]
217 217  
... ... @@ -219,11 +219,17 @@
219 219  
220 220  == 2.3 ​Uplink Payload ==
221 221  
225 +(((
222 222  LSPH01 will uplink payload via LoRaWAN with below payload format: 
227 +)))
223 223  
229 +(((
224 224  Uplink payload includes in total 11 bytes.
231 +)))
225 225  
233 +(((
226 226  Normal uplink payload:
235 +)))
227 227  
228 228  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
229 229  |(((
... ... @@ -307,20 +307,21 @@
307 307  
308 308  === 2.3.6 Message Type ===
309 309  
319 +(((
310 310  For a normal uplink payload, the message type is always 0x01.
321 +)))
311 311  
323 +(((
312 312  Valid Message Type:
325 +)))
313 313  
314 314  
315 315  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
316 -|**Message Type Code**|**Description**|**Payload**
329 +|=**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]]
320 320  
321 -
322 -
323 -
324 324  === 2.3.7 Decode payload in The Things Network ===
325 325  
326 326  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -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,9 +491,6 @@
491 491  * Reply to the confirmation package: 14 01
492 492  * Reply to non-confirmed packet: 14 00
493 493  
494 -
495 -
496 -
497 497  == 2.8 Frequency Plans ==
498 498  
499 499  (((
... ... @@ -503,32 +503,61 @@
503 503  
504 504  === 2.8.1 EU863-870 (EU868) ===
505 505  
553 +(((
506 506  (% style="color:blue" %)**Uplink:**
555 +)))
507 507  
557 +(((
508 508  868.1 - SF7BW125 to SF12BW125
559 +)))
509 509  
561 +(((
510 510  868.3 - SF7BW125 to SF12BW125 and SF7BW250
563 +)))
511 511  
565 +(((
512 512  868.5 - SF7BW125 to SF12BW125
567 +)))
513 513  
569 +(((
514 514  867.1 - SF7BW125 to SF12BW125
571 +)))
515 515  
573 +(((
516 516  867.3 - SF7BW125 to SF12BW125
575 +)))
517 517  
577 +(((
518 518  867.5 - SF7BW125 to SF12BW125
579 +)))
519 519  
581 +(((
520 520  867.7 - SF7BW125 to SF12BW125
583 +)))
521 521  
585 +(((
522 522  867.9 - SF7BW125 to SF12BW125
587 +)))
523 523  
589 +(((
524 524  868.8 - FSK
591 +)))
525 525  
593 +(((
594 +
595 +)))
526 526  
597 +(((
527 527  (% style="color:blue" %)**Downlink:**
599 +)))
528 528  
601 +(((
529 529  Uplink channels 1-9 (RX1)
603 +)))
530 530  
605 +(((
531 531  869.525 - SF9BW125 (RX2 downlink only)
607 +)))
532 532  
533 533  
534 534  
... ... @@ -552,46 +552,89 @@
552 552  
553 553  === 2.8.3 CN470-510 (CN470) ===
554 554  
631 +(((
555 555  Used in China, Default use CHE=1
633 +)))
556 556  
635 +(((
557 557  (% style="color:blue" %)**Uplink:**
637 +)))
558 558  
639 +(((
559 559  486.3 - SF7BW125 to SF12BW125
641 +)))
560 560  
643 +(((
561 561  486.5 - SF7BW125 to SF12BW125
645 +)))
562 562  
647 +(((
563 563  486.7 - SF7BW125 to SF12BW125
649 +)))
564 564  
651 +(((
565 565  486.9 - SF7BW125 to SF12BW125
653 +)))
566 566  
655 +(((
567 567  487.1 - SF7BW125 to SF12BW125
657 +)))
568 568  
659 +(((
569 569  487.3 - SF7BW125 to SF12BW125
661 +)))
570 570  
663 +(((
571 571  487.5 - SF7BW125 to SF12BW125
665 +)))
572 572  
667 +(((
573 573  487.7 - SF7BW125 to SF12BW125
669 +)))
574 574  
671 +(((
672 +
673 +)))
575 575  
675 +(((
576 576  (% style="color:blue" %)**Downlink:**
677 +)))
577 577  
679 +(((
578 578  506.7 - SF7BW125 to SF12BW125
681 +)))
579 579  
683 +(((
580 580  506.9 - SF7BW125 to SF12BW125
685 +)))
581 581  
687 +(((
582 582  507.1 - SF7BW125 to SF12BW125
689 +)))
583 583  
691 +(((
584 584  507.3 - SF7BW125 to SF12BW125
693 +)))
585 585  
695 +(((
586 586  507.5 - SF7BW125 to SF12BW125
697 +)))
587 587  
699 +(((
588 588  507.7 - SF7BW125 to SF12BW125
701 +)))
589 589  
703 +(((
590 590  507.9 - SF7BW125 to SF12BW125
705 +)))
591 591  
707 +(((
592 592  508.1 - SF7BW125 to SF12BW125
709 +)))
593 593  
711 +(((
594 594  505.3 - SF12BW125 (RX2 downlink only)
713 +)))
595 595  
596 596  
597 597  
... ... @@ -616,111 +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 620  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
621 621  
740 +(((
622 622  (% style="color:blue" %)**Default Uplink channel:**
742 +)))
623 623  
744 +(((
624 624  923.2 - SF7BW125 to SF10BW125
746 +)))
625 625  
748 +(((
626 626  923.4 - SF7BW125 to SF10BW125
750 +)))
627 627  
752 +(((
753 +
754 +)))
628 628  
756 +(((
629 629  (% style="color:blue" %)**Additional Uplink Channel**:
758 +)))
630 630  
760 +(((
631 631  (OTAA mode, channel added by JoinAccept message)
762 +)))
632 632  
764 +(((
765 +
766 +)))
633 633  
768 +(((
634 634  (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**:
770 +)))
635 635  
772 +(((
636 636  922.2 - SF7BW125 to SF10BW125
774 +)))
637 637  
776 +(((
638 638  922.4 - SF7BW125 to SF10BW125
778 +)))
639 639  
780 +(((
640 640  922.6 - SF7BW125 to SF10BW125
782 +)))
641 641  
784 +(((
642 642  922.8 - SF7BW125 to SF10BW125
786 +)))
643 643  
788 +(((
644 644  923.0 - SF7BW125 to SF10BW125
790 +)))
645 645  
792 +(((
646 646  922.0 - SF7BW125 to SF10BW125
794 +)))
647 647  
796 +(((
797 +
798 +)))
648 648  
800 +(((
649 649  (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
802 +)))
650 650  
804 +(((
651 651  923.6 - SF7BW125 to SF10BW125
806 +)))
652 652  
808 +(((
653 653  923.8 - SF7BW125 to SF10BW125
810 +)))
654 654  
812 +(((
655 655  924.0 - SF7BW125 to SF10BW125
814 +)))
656 656  
816 +(((
657 657  924.2 - SF7BW125 to SF10BW125
818 +)))
658 658  
820 +(((
659 659  924.4 - SF7BW125 to SF10BW125
822 +)))
660 660  
824 +(((
661 661  924.6 - SF7BW125 to SF10BW125
826 +)))
662 662  
828 +(((
829 +
830 +)))
663 663  
832 +(((
664 664  (% style="color:blue" %)**Downlink:**
834 +)))
665 665  
836 +(((
666 666  Uplink channels 1-8 (RX1)
838 +)))
667 667  
840 +(((
668 668  923.2 - SF10BW125 (RX2)
842 +)))
669 669  
670 670  
671 671  
672 672  === 2.8.6 KR920-923 (KR920) ===
673 673  
848 +(((
674 674  (% style="color:blue" %)**Default channel:**
850 +)))
675 675  
852 +(((
676 676  922.1 - SF7BW125 to SF12BW125
854 +)))
677 677  
856 +(((
678 678  922.3 - SF7BW125 to SF12BW125
858 +)))
679 679  
860 +(((
680 680  922.5 - SF7BW125 to SF12BW125
862 +)))
681 681  
864 +(((
865 +
866 +)))
682 682  
868 +(((
683 683  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
870 +)))
684 684  
872 +(((
685 685  922.1 - SF7BW125 to SF12BW125
874 +)))
686 686  
876 +(((
687 687  922.3 - SF7BW125 to SF12BW125
878 +)))
688 688  
880 +(((
689 689  922.5 - SF7BW125 to SF12BW125
882 +)))
690 690  
884 +(((
691 691  922.7 - SF7BW125 to SF12BW125
886 +)))
692 692  
888 +(((
693 693  922.9 - SF7BW125 to SF12BW125
890 +)))
694 694  
892 +(((
695 695  923.1 - SF7BW125 to SF12BW125
894 +)))
696 696  
896 +(((
697 697  923.3 - SF7BW125 to SF12BW125
898 +)))
698 698  
900 +(((
901 +
902 +)))
699 699  
904 +(((
700 700  (% style="color:blue" %)**Downlink:**
906 +)))
701 701  
908 +(((
702 702  Uplink channels 1-7(RX1)
910 +)))
703 703  
912 +(((
704 704  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
914 +)))
705 705  
706 706  
707 707  
708 708  === 2.8.7 IN865-867 (IN865) ===
709 709  
920 +(((
710 710  (% style="color:blue" %)**Uplink:**
922 +)))
711 711  
924 +(((
712 712  865.0625 - SF7BW125 to SF12BW125
926 +)))
713 713  
928 +(((
714 714  865.4025 - SF7BW125 to SF12BW125
930 +)))
715 715  
932 +(((
716 716  865.9850 - SF7BW125 to SF12BW125
934 +)))
717 717  
936 +(((
937 +
938 +)))
718 718  
940 +(((
719 719  (% style="color:blue" %)**Downlink:**
942 +)))
720 720  
944 +(((
721 721  Uplink channels 1-3 (RX1)
946 +)))
722 722  
948 +(((
723 723  866.550 - SF10BW125 (RX2)
950 +)))
724 724  
725 725  
726 726  
... ... @@ -732,6 +732,7 @@
732 732  * Blink once when device transmit a packet.
733 733  
734 734  
962 +
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  
977 +(((
749 749  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
979 +)))
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/]]
981 +* (((
982 +AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
983 +)))
984 +* (((
985 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
986 +)))
753 753  
988 +(((
754 754  There are two kinds of commands to configure LSPH01, they are:
990 +)))
755 755  
756 -* (% style="color:#4f81bd" %)** General Commands**.
992 +* (((
993 +(% style="color:#4f81bd" %)** General Commands**.
994 +)))
757 757  
996 +(((
758 758  These commands are to configure:
998 +)))
759 759  
760 -* General system settings like: uplink interval.
761 -* LoRaWAN protocol & radio related command.
1000 +* (((
1001 +General system settings like: uplink interval.
1002 +)))
1003 +* (((
1004 +LoRaWAN protocol & radio related command.
1005 +)))
762 762  
1007 +(((
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/]]
1009 +)))
764 764  
1011 +(((
1012 +
1013 +)))
765 765  
766 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1015 +* (((
1016 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1017 +)))
767 767  
1019 +(((
768 768  These commands only valid for LSPH01, as below:
1021 +)))
769 769  
770 770  
771 771  
... ... @@ -779,17 +779,28 @@
779 779  
780 780  
781 781  
1035 +(((
782 782  (% style="color:#037691" %)**Downlink Command: 0x01**
1037 +)))
783 783  
1039 +(((
784 784  Format: Command Code (0x01) followed by 3 bytes time value.
1041 +)))
785 785  
1043 +(((
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.
1045 +)))
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
1047 +* (((
1048 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1049 +)))
1050 +* (((
1051 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
790 790  
791 791  
792 792  
1055 +
1056 +)))
793 793  
794 794  == 3.2 Set Interrupt Mode ==
795 795  
... ... @@ -800,16 +800,31 @@
800 800  [[image:image-20220607171716-9.png]]
801 801  
802 802  
1067 +(((
803 803  (% style="color:#037691" %)**Downlink Command: 0x06**
1069 +)))
804 804  
1071 +(((
805 805  Format: Command Code (0x06) followed by 3 bytes.
1073 +)))
806 806  
1075 +(((
807 807  This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
1077 +)))
808 808  
809 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
810 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1079 +* (((
1080 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1081 +)))
1082 +* (((
1083 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1084 +)))
811 811  
1086 +(((
1087 +
1088 +)))
812 812  
1090 +
1091 +
813 813  == 3.3 Calibrate Sensor ==
814 814  
815 815  Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
... ... @@ -827,7 +827,6 @@
827 827  * Reply to the confirmation package: 26 01
828 828  * Reply to non-confirmed packet: 26 00
829 829  
830 -
831 831  Device will send an uplink after got this downlink command. With below payload:
832 832  
833 833  Configures info payload:
... ... @@ -985,9 +985,13 @@
985 985  
986 986  === ​4.3.2 Replace the battery ===
987 987  
1266 +(((
988 988  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.
1268 +)))
989 989  
1270 +(((
990 990  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)
1272 +)))
991 991  
992 992  
993 993  
... ... @@ -1008,7 +1008,9 @@
1008 1008  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1009 1009  
1010 1010  
1293 +(((
1011 1011  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:
1295 +)))
1012 1012  
1013 1013  
1014 1014   [[image:1654593712276-618.png]]

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0