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

Summary

Details

Page properties
Content
... ... @@ -62,26 +62,29 @@
62 62  * [[10. ​Support>>path:#H10.A0200BSupport]]
63 63  
64 64  
65 -
66 -
67 -
68 -
69 -
70 -
71 -
72 72  = 1. Introduction =
73 73  
74 74  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
75 75  
69 +(((
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.
71 +)))
77 77  
73 +(((
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.
75 +)))
79 79  
77 +(((
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.
79 +)))
81 81  
81 +(((
82 82  LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
83 +)))
83 83  
85 +(((
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.
87 +)))
85 85  
86 86  
87 87  [[image:1654592435432-887.png]]
... ... @@ -127,10 +127,16 @@
127 127  * IP68 Protection
128 128  * Length: 3.5 meters
129 129  
133 +
134 +
135 +
130 130  == 1.4 ​Applications ==
131 131  
132 132  * Smart Agriculture
133 133  
140 +
141 +
142 +
134 134  == 1.5 Pin mapping and power on ==
135 135  
136 136  [[image:1654592472094-134.png]]
... ... @@ -209,7 +209,9 @@
209 209  [[image:image-20220607170442-2.png]]
210 210  
211 211  
221 +(((
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.
223 +)))
213 213  
214 214  [[image:1654592697690-910.png]]
215 215  
... ... @@ -217,11 +217,17 @@
217 217  
218 218  == 2.3 ​Uplink Payload ==
219 219  
231 +(((
220 220  LSPH01 will uplink payload via LoRaWAN with below payload format: 
233 +)))
221 221  
235 +(((
222 222  Uplink payload includes in total 11 bytes.
237 +)))
223 223  
239 +(((
224 224  Normal uplink payload:
241 +)))
225 225  
226 226  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
227 227  |(((
... ... @@ -305,18 +305,24 @@
305 305  
306 306  === 2.3.6 Message Type ===
307 307  
325 +(((
308 308  For a normal uplink payload, the message type is always 0x01.
327 +)))
309 309  
329 +(((
310 310  Valid Message Type:
331 +)))
311 311  
312 312  
313 313  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
314 -|**Message Type Code**|**Description**|**Payload**
335 +|=**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 319  
341 +
342 +
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  
368 +(((
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:
370 +)))
346 346  
372 +(((
373 +
374 +)))
347 347  
376 +(((
348 348  (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
378 +)))
349 349  
380 +(((
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:**
382 +)))
351 351  
352 352  
353 353  [[image:1654592790040-760.png]]
... ... @@ -370,9 +370,13 @@
370 370  [[image:1654592856403-259.png]]
371 371  
372 372  
405 +(((
373 373  (% style="color:blue" %)**Step 5**(%%)**: add payload decode**
407 +)))
374 374  
409 +(((
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/]]
411 +)))
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  (((
434 +(((
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  )))
437 +)))
400 400  
401 401  
402 402  
... ... @@ -403,24 +403,45 @@
403 403  === 2.6.2 Measurement ===
404 404  
405 405  
444 +(((
406 406  (% style="color:#4f81bd" %)**Measurement the soil surface:**
446 +)))
407 407  
448 +(((
408 408  [[image:1654592946732-634.png]]
450 +)))
409 409  
452 +(((
410 410  Choose the proper measuring position. Split the surface soil according to the measured deep.
454 +)))
411 411  
456 +(((
412 412  Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
458 +)))
413 413  
460 +(((
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.
462 +)))
415 415  
464 +(((
416 416  Put soil over the probe after insert. And start to measure.
466 +)))
417 417  
468 +(((
469 +
470 +)))
418 418  
472 +(((
419 419  (% style="color:#4f81bd" %)**Measurement inside soil:**
474 +)))
420 420  
476 +(((
421 421  Dig a hole with diameter > 20CM.
478 +)))
422 422  
480 +(((
423 423  Insert the probe inside, method like measure the surface.
482 +)))
424 424  
425 425  
426 426  
... ... @@ -450,9 +450,13 @@
450 450  
451 451  == 2.7 Calibration ==
452 452  
512 +(((
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).
514 +)))
454 454  
516 +(((
455 455  After stable, user can use below command to calibrate.
518 +)))
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" %)
525 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
463 463  |(((
464 464  **Size**
465 465  
... ... @@ -488,6 +488,8 @@
488 488  * Reply to non-confirmed packet: 14 00
489 489  
490 490  
554 +
555 +
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  
565 +(((
500 500  (% style="color:blue" %)**Uplink:**
567 +)))
501 501  
569 +(((
502 502  868.1 - SF7BW125 to SF12BW125
571 +)))
503 503  
573 +(((
504 504  868.3 - SF7BW125 to SF12BW125 and SF7BW250
575 +)))
505 505  
577 +(((
506 506  868.5 - SF7BW125 to SF12BW125
579 +)))
507 507  
581 +(((
508 508  867.1 - SF7BW125 to SF12BW125
583 +)))
509 509  
585 +(((
510 510  867.3 - SF7BW125 to SF12BW125
587 +)))
511 511  
589 +(((
512 512  867.5 - SF7BW125 to SF12BW125
591 +)))
513 513  
593 +(((
514 514  867.7 - SF7BW125 to SF12BW125
595 +)))
515 515  
597 +(((
516 516  867.9 - SF7BW125 to SF12BW125
599 +)))
517 517  
601 +(((
518 518  868.8 - FSK
603 +)))
519 519  
605 +(((
606 +
607 +)))
520 520  
609 +(((
521 521  (% style="color:blue" %)**Downlink:**
611 +)))
522 522  
613 +(((
523 523  Uplink channels 1-9 (RX1)
615 +)))
524 524  
617 +(((
525 525  869.525 - SF9BW125 (RX2 downlink only)
619 +)))
526 526  
527 527  
528 528  
... ... @@ -545,48 +545,92 @@
545 545  
546 546  
547 547  
642 +
548 548  === 2.8.3 CN470-510 (CN470) ===
549 549  
645 +(((
550 550  Used in China, Default use CHE=1
647 +)))
551 551  
649 +(((
552 552  (% style="color:blue" %)**Uplink:**
651 +)))
553 553  
653 +(((
554 554  486.3 - SF7BW125 to SF12BW125
655 +)))
555 555  
657 +(((
556 556  486.5 - SF7BW125 to SF12BW125
659 +)))
557 557  
661 +(((
558 558  486.7 - SF7BW125 to SF12BW125
663 +)))
559 559  
665 +(((
560 560  486.9 - SF7BW125 to SF12BW125
667 +)))
561 561  
669 +(((
562 562  487.1 - SF7BW125 to SF12BW125
671 +)))
563 563  
673 +(((
564 564  487.3 - SF7BW125 to SF12BW125
675 +)))
565 565  
677 +(((
566 566  487.5 - SF7BW125 to SF12BW125
679 +)))
567 567  
681 +(((
568 568  487.7 - SF7BW125 to SF12BW125
683 +)))
569 569  
685 +(((
686 +
687 +)))
570 570  
689 +(((
571 571  (% style="color:blue" %)**Downlink:**
691 +)))
572 572  
693 +(((
573 573  506.7 - SF7BW125 to SF12BW125
695 +)))
574 574  
697 +(((
575 575  506.9 - SF7BW125 to SF12BW125
699 +)))
576 576  
701 +(((
577 577  507.1 - SF7BW125 to SF12BW125
703 +)))
578 578  
705 +(((
579 579  507.3 - SF7BW125 to SF12BW125
707 +)))
580 580  
709 +(((
581 581  507.5 - SF7BW125 to SF12BW125
711 +)))
582 582  
713 +(((
583 583  507.7 - SF7BW125 to SF12BW125
715 +)))
584 584  
717 +(((
585 585  507.9 - SF7BW125 to SF12BW125
719 +)))
586 586  
721 +(((
587 587  508.1 - SF7BW125 to SF12BW125
723 +)))
588 588  
725 +(((
589 589  505.3 - SF12BW125 (RX2 downlink only)
727 +)))
590 590  
591 591  
592 592  
... ... @@ -613,110 +613,220 @@
613 613  
614 614  
615 615  
754 +
616 616  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
617 617  
757 +(((
618 618  (% style="color:blue" %)**Default Uplink channel:**
759 +)))
619 619  
761 +(((
620 620  923.2 - SF7BW125 to SF10BW125
763 +)))
621 621  
765 +(((
622 622  923.4 - SF7BW125 to SF10BW125
767 +)))
623 623  
769 +(((
770 +
771 +)))
624 624  
773 +(((
625 625  (% style="color:blue" %)**Additional Uplink Channel**:
775 +)))
626 626  
777 +(((
627 627  (OTAA mode, channel added by JoinAccept message)
779 +)))
628 628  
781 +(((
782 +
783 +)))
629 629  
785 +(((
630 630  (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**:
787 +)))
631 631  
789 +(((
632 632  922.2 - SF7BW125 to SF10BW125
791 +)))
633 633  
793 +(((
634 634  922.4 - SF7BW125 to SF10BW125
795 +)))
635 635  
797 +(((
636 636  922.6 - SF7BW125 to SF10BW125
799 +)))
637 637  
801 +(((
638 638  922.8 - SF7BW125 to SF10BW125
803 +)))
639 639  
805 +(((
640 640  923.0 - SF7BW125 to SF10BW125
807 +)))
641 641  
809 +(((
642 642  922.0 - SF7BW125 to SF10BW125
811 +)))
643 643  
813 +(((
814 +
815 +)))
644 644  
817 +(((
645 645  (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
819 +)))
646 646  
821 +(((
647 647  923.6 - SF7BW125 to SF10BW125
823 +)))
648 648  
825 +(((
649 649  923.8 - SF7BW125 to SF10BW125
827 +)))
650 650  
829 +(((
651 651  924.0 - SF7BW125 to SF10BW125
831 +)))
652 652  
833 +(((
653 653  924.2 - SF7BW125 to SF10BW125
835 +)))
654 654  
837 +(((
655 655  924.4 - SF7BW125 to SF10BW125
839 +)))
656 656  
841 +(((
657 657  924.6 - SF7BW125 to SF10BW125
843 +)))
658 658  
845 +(((
846 +
847 +)))
659 659  
849 +(((
660 660  (% style="color:blue" %)**Downlink:**
851 +)))
661 661  
853 +(((
662 662  Uplink channels 1-8 (RX1)
855 +)))
663 663  
857 +(((
664 664  923.2 - SF10BW125 (RX2)
859 +)))
665 665  
666 666  
667 667  
668 668  === 2.8.6 KR920-923 (KR920) ===
669 669  
865 +(((
670 670  (% style="color:blue" %)**Default channel:**
867 +)))
671 671  
869 +(((
672 672  922.1 - SF7BW125 to SF12BW125
871 +)))
673 673  
873 +(((
674 674  922.3 - SF7BW125 to SF12BW125
875 +)))
675 675  
877 +(((
676 676  922.5 - SF7BW125 to SF12BW125
879 +)))
677 677  
881 +(((
882 +
883 +)))
678 678  
885 +(((
679 679  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
887 +)))
680 680  
889 +(((
681 681  922.1 - SF7BW125 to SF12BW125
891 +)))
682 682  
893 +(((
683 683  922.3 - SF7BW125 to SF12BW125
895 +)))
684 684  
897 +(((
685 685  922.5 - SF7BW125 to SF12BW125
899 +)))
686 686  
901 +(((
687 687  922.7 - SF7BW125 to SF12BW125
903 +)))
688 688  
905 +(((
689 689  922.9 - SF7BW125 to SF12BW125
907 +)))
690 690  
909 +(((
691 691  923.1 - SF7BW125 to SF12BW125
911 +)))
692 692  
913 +(((
693 693  923.3 - SF7BW125 to SF12BW125
915 +)))
694 694  
917 +(((
918 +
919 +)))
695 695  
921 +(((
696 696  (% style="color:blue" %)**Downlink:**
923 +)))
697 697  
925 +(((
698 698  Uplink channels 1-7(RX1)
927 +)))
699 699  
929 +(((
700 700  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
931 +)))
701 701  
702 702  
703 703  
704 704  === 2.8.7 IN865-867 (IN865) ===
705 705  
937 +(((
706 706  (% style="color:blue" %)**Uplink:**
939 +)))
707 707  
941 +(((
708 708  865.0625 - SF7BW125 to SF12BW125
943 +)))
709 709  
945 +(((
710 710  865.4025 - SF7BW125 to SF12BW125
947 +)))
711 711  
949 +(((
712 712  865.9850 - SF7BW125 to SF12BW125
951 +)))
713 713  
953 +(((
954 +
955 +)))
714 714  
957 +(((
715 715  (% style="color:blue" %)**Downlink:**
959 +)))
716 716  
961 +(((
717 717  Uplink channels 1-3 (RX1)
963 +)))
718 718  
965 +(((
719 719  866.550 - SF10BW125 (RX2)
967 +)))
720 720  
721 721  
722 722  
... ... @@ -743,26 +743,51 @@
743 743  
744 744  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
745 745  
994 +(((
746 746  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
996 +)))
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/]]
998 +* (((
999 +AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
1000 +)))
1001 +* (((
1002 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
1003 +)))
750 750  
1005 +(((
751 751  There are two kinds of commands to configure LSPH01, they are:
1007 +)))
752 752  
753 -* (% style="color:#4f81bd" %)** General Commands**.
1009 +* (((
1010 +(% style="color:#4f81bd" %)** General Commands**.
1011 +)))
754 754  
1013 +(((
755 755  These commands are to configure:
1015 +)))
756 756  
757 -* General system settings like: uplink interval.
758 -* LoRaWAN protocol & radio related command.
1017 +* (((
1018 +General system settings like: uplink interval.
1019 +)))
1020 +* (((
1021 +LoRaWAN protocol & radio related command.
1022 +)))
759 759  
1024 +(((
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/]]
1026 +)))
761 761  
1028 +(((
1029 +
1030 +)))
762 762  
763 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1032 +* (((
1033 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1034 +)))
764 764  
1036 +(((
765 765  These commands only valid for LSPH01, as below:
1038 +)))
766 766  
767 767  
768 768  
... ... @@ -776,16 +776,28 @@
776 776  
777 777  
778 778  
1052 +(((
779 779  (% style="color:#037691" %)**Downlink Command: 0x01**
1054 +)))
780 780  
1056 +(((
781 781  Format: Command Code (0x01) followed by 3 bytes time value.
1058 +)))
782 782  
1060 +(((
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.
1062 +)))
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
1064 +* (((
1065 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1066 +)))
1067 +* (((
1068 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
787 787  
788 788  
1071 +
1072 +)))
1073 +
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  
1083 +(((
798 798  (% style="color:#037691" %)**Downlink Command: 0x06**
1085 +)))
799 799  
1087 +(((
800 800  Format: Command Code (0x06) followed by 3 bytes.
1089 +)))
801 801  
1091 +(((
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.
1093 +)))
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
1095 +* (((
1096 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1097 +)))
1098 +* (((
1099 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1100 +)))
806 806  
1102 +(((
1103 +
1104 +)))
807 807  
808 808  
1107 +
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  
1282 +(((
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.
1284 +)))
984 984  
1286 +(((
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)
1288 +)))
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  
1309 +(((
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:
1311 +)))
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.

Applications

Navigation

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