Last modified by Xiaoling on 2025/04/24 17:18
<
From version < 73.4 >
edited by Xiaoling
on 2022/06/07 17:24
To version < 81.3 >
edited by Xiaoling
on 2022/06/07 18:06
>
Change comment: There is no comment for this version

Summary

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]]
... ... @@ -105,8 +105,6 @@
105 105  * 8500mAh Battery for long term use
106 106  
107 107  
108 -
109 -
110 110  == 1.3 Probe Specification ==
111 111  
112 112  
... ... @@ -128,15 +128,11 @@
128 128  * Length: 3.5 meters
129 129  
130 130  
131 -
132 -
133 133  == 1.4 ​Applications ==
134 134  
135 135  * Smart Agriculture
136 136  
137 137  
138 -
139 -
140 140  == 1.5 Pin mapping and power on ==
141 141  
142 142  [[image:1654592472094-134.png]]
... ... @@ -215,7 +215,9 @@
215 215  [[image:image-20220607170442-2.png]]
216 216  
217 217  
219 +(((
218 218  (% 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.
221 +)))
219 219  
220 220  [[image:1654592697690-910.png]]
221 221  
... ... @@ -223,11 +223,17 @@
223 223  
224 224  == 2.3 ​Uplink Payload ==
225 225  
229 +(((
226 226  LSPH01 will uplink payload via LoRaWAN with below payload format: 
231 +)))
227 227  
233 +(((
228 228  Uplink payload includes in total 11 bytes.
235 +)))
229 229  
237 +(((
230 230  Normal uplink payload:
239 +)))
231 231  
232 232  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
233 233  |(((
... ... @@ -311,13 +311,17 @@
311 311  
312 312  === 2.3.6 Message Type ===
313 313  
323 +(((
314 314  For a normal uplink payload, the message type is always 0x01.
325 +)))
315 315  
327 +(((
316 316  Valid Message Type:
329 +)))
317 317  
318 318  
319 319  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
320 -|**Message Type Code**|**Description**|**Payload**
333 +|=**Message Type Code**|=**Description**|=**Payload**
321 321  |0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]]
322 322  |0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]]
323 323  |0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]]
... ... @@ -348,12 +348,21 @@
348 348  
349 349  == 2.5 ​Show Data in DataCake IoT Server ==
350 350  
364 +(((
351 351  [[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:
366 +)))
352 352  
368 +(((
369 +
370 +)))
353 353  
372 +(((
354 354  (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
374 +)))
355 355  
376 +(((
356 356  (% 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:**
378 +)))
357 357  
358 358  
359 359  [[image:1654592790040-760.png]]
... ... @@ -376,9 +376,13 @@
376 376  [[image:1654592856403-259.png]]
377 377  
378 378  
401 +(((
379 379  (% style="color:blue" %)**Step 5**(%%)**: add payload decode**
403 +)))
380 380  
405 +(((
381 381  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/]]
407 +)))
382 382  
383 383  
384 384  [[image:1654592878525-845.png]]
... ... @@ -401,8 +401,10 @@
401 401  === 2.6.1 Before measurement ===
402 402  
403 403  (((
430 +(((
404 404  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. 
405 405  )))
433 +)))
406 406  
407 407  
408 408  
... ... @@ -409,24 +409,45 @@
409 409  === 2.6.2 Measurement ===
410 410  
411 411  
440 +(((
412 412  (% style="color:#4f81bd" %)**Measurement the soil surface:**
442 +)))
413 413  
444 +(((
414 414  [[image:1654592946732-634.png]]
446 +)))
415 415  
448 +(((
416 416  Choose the proper measuring position. Split the surface soil according to the measured deep.
450 +)))
417 417  
452 +(((
418 418  Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
454 +)))
419 419  
456 +(((
420 420  Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting.
458 +)))
421 421  
460 +(((
422 422  Put soil over the probe after insert. And start to measure.
462 +)))
423 423  
464 +(((
465 +
466 +)))
424 424  
468 +(((
425 425  (% style="color:#4f81bd" %)**Measurement inside soil:**
470 +)))
426 426  
472 +(((
427 427  Dig a hole with diameter > 20CM.
474 +)))
428 428  
476 +(((
429 429  Insert the probe inside, method like measure the surface.
478 +)))
430 430  
431 431  
432 432  
... ... @@ -456,9 +456,13 @@
456 456  
457 457  == 2.7 Calibration ==
458 458  
508 +(((
459 459  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).
510 +)))
460 460  
512 +(((
461 461  After stable, user can use below command to calibrate.
514 +)))
462 462  
463 463  [[image:image-20220607171149-4.png]]
464 464  
... ... @@ -465,7 +465,7 @@
465 465  
466 466  (% style="color:#037691" %)**Calibration Payload**
467 467  
468 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
521 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
469 469  |(((
470 470  **Size**
471 471  
... ... @@ -503,32 +503,61 @@
503 503  
504 504  === 2.8.1 EU863-870 (EU868) ===
505 505  
559 +(((
506 506  (% style="color:blue" %)**Uplink:**
561 +)))
507 507  
563 +(((
508 508  868.1 - SF7BW125 to SF12BW125
565 +)))
509 509  
567 +(((
510 510  868.3 - SF7BW125 to SF12BW125 and SF7BW250
569 +)))
511 511  
571 +(((
512 512  868.5 - SF7BW125 to SF12BW125
573 +)))
513 513  
575 +(((
514 514  867.1 - SF7BW125 to SF12BW125
577 +)))
515 515  
579 +(((
516 516  867.3 - SF7BW125 to SF12BW125
581 +)))
517 517  
583 +(((
518 518  867.5 - SF7BW125 to SF12BW125
585 +)))
519 519  
587 +(((
520 520  867.7 - SF7BW125 to SF12BW125
589 +)))
521 521  
591 +(((
522 522  867.9 - SF7BW125 to SF12BW125
593 +)))
523 523  
595 +(((
524 524  868.8 - FSK
597 +)))
525 525  
599 +(((
600 +
601 +)))
526 526  
603 +(((
527 527  (% style="color:blue" %)**Downlink:**
605 +)))
528 528  
607 +(((
529 529  Uplink channels 1-9 (RX1)
609 +)))
530 530  
611 +(((
531 531  869.525 - SF9BW125 (RX2 downlink only)
613 +)))
532 532  
533 533  
534 534  
... ... @@ -550,49 +550,91 @@
550 550  * 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)
551 551  
552 552  
553 -
554 554  === 2.8.3 CN470-510 (CN470) ===
555 555  
637 +(((
556 556  Used in China, Default use CHE=1
639 +)))
557 557  
641 +(((
558 558  (% style="color:blue" %)**Uplink:**
643 +)))
559 559  
645 +(((
560 560  486.3 - SF7BW125 to SF12BW125
647 +)))
561 561  
649 +(((
562 562  486.5 - SF7BW125 to SF12BW125
651 +)))
563 563  
653 +(((
564 564  486.7 - SF7BW125 to SF12BW125
655 +)))
565 565  
657 +(((
566 566  486.9 - SF7BW125 to SF12BW125
659 +)))
567 567  
661 +(((
568 568  487.1 - SF7BW125 to SF12BW125
663 +)))
569 569  
665 +(((
570 570  487.3 - SF7BW125 to SF12BW125
667 +)))
571 571  
669 +(((
572 572  487.5 - SF7BW125 to SF12BW125
671 +)))
573 573  
673 +(((
574 574  487.7 - SF7BW125 to SF12BW125
675 +)))
575 575  
677 +(((
678 +
679 +)))
576 576  
681 +(((
577 577  (% style="color:blue" %)**Downlink:**
683 +)))
578 578  
685 +(((
579 579  506.7 - SF7BW125 to SF12BW125
687 +)))
580 580  
689 +(((
581 581  506.9 - SF7BW125 to SF12BW125
691 +)))
582 582  
693 +(((
583 583  507.1 - SF7BW125 to SF12BW125
695 +)))
584 584  
697 +(((
585 585  507.3 - SF7BW125 to SF12BW125
699 +)))
586 586  
701 +(((
587 587  507.5 - SF7BW125 to SF12BW125
703 +)))
588 588  
705 +(((
589 589  507.7 - SF7BW125 to SF12BW125
707 +)))
590 590  
709 +(((
591 591  507.9 - SF7BW125 to SF12BW125
711 +)))
592 592  
713 +(((
593 593  508.1 - SF7BW125 to SF12BW125
715 +)))
594 594  
717 +(((
595 595  505.3 - SF12BW125 (RX2 downlink only)
719 +)))
596 596  
597 597  
598 598  
... ... @@ -618,111 +618,219 @@
618 618  * 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)
619 619  
620 620  
621 -
622 622  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
623 623  
747 +(((
624 624  (% style="color:blue" %)**Default Uplink channel:**
749 +)))
625 625  
751 +(((
626 626  923.2 - SF7BW125 to SF10BW125
753 +)))
627 627  
755 +(((
628 628  923.4 - SF7BW125 to SF10BW125
757 +)))
629 629  
759 +(((
760 +
761 +)))
630 630  
763 +(((
631 631  (% style="color:blue" %)**Additional Uplink Channel**:
765 +)))
632 632  
767 +(((
633 633  (OTAA mode, channel added by JoinAccept message)
769 +)))
634 634  
771 +(((
772 +
773 +)))
635 635  
775 +(((
636 636  (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**:
777 +)))
637 637  
779 +(((
638 638  922.2 - SF7BW125 to SF10BW125
781 +)))
639 639  
783 +(((
640 640  922.4 - SF7BW125 to SF10BW125
785 +)))
641 641  
787 +(((
642 642  922.6 - SF7BW125 to SF10BW125
789 +)))
643 643  
791 +(((
644 644  922.8 - SF7BW125 to SF10BW125
793 +)))
645 645  
795 +(((
646 646  923.0 - SF7BW125 to SF10BW125
797 +)))
647 647  
799 +(((
648 648  922.0 - SF7BW125 to SF10BW125
801 +)))
649 649  
803 +(((
804 +
805 +)))
650 650  
807 +(((
651 651  (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
809 +)))
652 652  
811 +(((
653 653  923.6 - SF7BW125 to SF10BW125
813 +)))
654 654  
815 +(((
655 655  923.8 - SF7BW125 to SF10BW125
817 +)))
656 656  
819 +(((
657 657  924.0 - SF7BW125 to SF10BW125
821 +)))
658 658  
823 +(((
659 659  924.2 - SF7BW125 to SF10BW125
825 +)))
660 660  
827 +(((
661 661  924.4 - SF7BW125 to SF10BW125
829 +)))
662 662  
831 +(((
663 663  924.6 - SF7BW125 to SF10BW125
833 +)))
664 664  
835 +(((
836 +
837 +)))
665 665  
839 +(((
666 666  (% style="color:blue" %)**Downlink:**
841 +)))
667 667  
843 +(((
668 668  Uplink channels 1-8 (RX1)
845 +)))
669 669  
847 +(((
670 670  923.2 - SF10BW125 (RX2)
849 +)))
671 671  
672 672  
673 673  
674 674  === 2.8.6 KR920-923 (KR920) ===
675 675  
855 +(((
676 676  (% style="color:blue" %)**Default channel:**
857 +)))
677 677  
859 +(((
678 678  922.1 - SF7BW125 to SF12BW125
861 +)))
679 679  
863 +(((
680 680  922.3 - SF7BW125 to SF12BW125
865 +)))
681 681  
867 +(((
682 682  922.5 - SF7BW125 to SF12BW125
869 +)))
683 683  
871 +(((
872 +
873 +)))
684 684  
875 +(((
685 685  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
877 +)))
686 686  
879 +(((
687 687  922.1 - SF7BW125 to SF12BW125
881 +)))
688 688  
883 +(((
689 689  922.3 - SF7BW125 to SF12BW125
885 +)))
690 690  
887 +(((
691 691  922.5 - SF7BW125 to SF12BW125
889 +)))
692 692  
891 +(((
693 693  922.7 - SF7BW125 to SF12BW125
893 +)))
694 694  
895 +(((
695 695  922.9 - SF7BW125 to SF12BW125
897 +)))
696 696  
899 +(((
697 697  923.1 - SF7BW125 to SF12BW125
901 +)))
698 698  
903 +(((
699 699  923.3 - SF7BW125 to SF12BW125
905 +)))
700 700  
907 +(((
908 +
909 +)))
701 701  
911 +(((
702 702  (% style="color:blue" %)**Downlink:**
913 +)))
703 703  
915 +(((
704 704  Uplink channels 1-7(RX1)
917 +)))
705 705  
919 +(((
706 706  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
921 +)))
707 707  
708 708  
709 709  
710 710  === 2.8.7 IN865-867 (IN865) ===
711 711  
927 +(((
712 712  (% style="color:blue" %)**Uplink:**
929 +)))
713 713  
931 +(((
714 714  865.0625 - SF7BW125 to SF12BW125
933 +)))
715 715  
935 +(((
716 716  865.4025 - SF7BW125 to SF12BW125
937 +)))
717 717  
939 +(((
718 718  865.9850 - SF7BW125 to SF12BW125
941 +)))
719 719  
943 +(((
944 +
945 +)))
720 720  
947 +(((
721 721  (% style="color:blue" %)**Downlink:**
949 +)))
722 722  
951 +(((
723 723  Uplink channels 1-3 (RX1)
953 +)))
724 724  
955 +(((
725 725  866.550 - SF10BW125 (RX2)
957 +)))
726 726  
727 727  
728 728  
... ... @@ -735,6 +735,7 @@
735 735  
736 736  
737 737  
970 +
738 738  == 2.10 ​Firmware Change Log ==
739 739  
740 740  
... ... @@ -749,26 +749,51 @@
749 749  
750 750  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
751 751  
985 +(((
752 752  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
987 +)))
753 753  
754 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
755 -* 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 +)))
756 756  
996 +(((
757 757  There are two kinds of commands to configure LSPH01, they are:
998 +)))
758 758  
759 -* (% style="color:#4f81bd" %)** General Commands**.
1000 +* (((
1001 +(% style="color:#4f81bd" %)** General Commands**.
1002 +)))
760 760  
1004 +(((
761 761  These commands are to configure:
1006 +)))
762 762  
763 -* General system settings like: uplink interval.
764 -* LoRaWAN protocol & radio related command.
1008 +* (((
1009 +General system settings like: uplink interval.
1010 +)))
1011 +* (((
1012 +LoRaWAN protocol & radio related command.
1013 +)))
765 765  
1015 +(((
766 766  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 +)))
767 767  
1019 +(((
1020 +
1021 +)))
768 768  
769 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1023 +* (((
1024 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1025 +)))
770 770  
1027 +(((
771 771  These commands only valid for LSPH01, as below:
1029 +)))
772 772  
773 773  
774 774  
... ... @@ -782,16 +782,28 @@
782 782  
783 783  
784 784  
1043 +(((
785 785  (% style="color:#037691" %)**Downlink Command: 0x01**
1045 +)))
786 786  
1047 +(((
787 787  Format: Command Code (0x01) followed by 3 bytes time value.
1049 +)))
788 788  
1051 +(((
789 789  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
1053 +)))
790 790  
791 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
792 -* 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
793 793  
794 794  
1062 +
1063 +)))
1064 +
795 795  == 3.2 Set Interrupt Mode ==
796 796  
797 797  Feature, Set Interrupt mode for GPIO_EXIT.
... ... @@ -801,17 +801,31 @@
801 801  [[image:image-20220607171716-9.png]]
802 802  
803 803  
1074 +(((
804 804  (% style="color:#037691" %)**Downlink Command: 0x06**
1076 +)))
805 805  
1078 +(((
806 806  Format: Command Code (0x06) followed by 3 bytes.
1080 +)))
807 807  
1082 +(((
808 808  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 +)))
809 809  
810 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
811 -* 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 +)))
812 812  
1093 +(((
1094 +
1095 +)))
813 813  
814 814  
1098 +
815 815  == 3.3 Calibrate Sensor ==
816 816  
817 817  Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
... ... @@ -986,9 +986,13 @@
986 986  
987 987  === ​4.3.2 Replace the battery ===
988 988  
1273 +(((
989 989  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 +)))
990 990  
1277 +(((
991 991  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 +)))
992 992  
993 993  
994 994  
... ... @@ -1009,7 +1009,9 @@
1009 1009  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1010 1010  
1011 1011  
1300 +(((
1012 1012  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 +)))
1013 1013  
1014 1014  
1015 1015   [[image:1654593712276-618.png]]
... ... @@ -1067,8 +1067,6 @@
1067 1067  * Package Size / pcs : cm
1068 1068  * Weight / pcs : g
1069 1069  
1070 -
1071 -
1072 1072  = 10. ​Support =
1073 1073  
1074 1074  * 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.

Applications

Navigation

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