Skip to Content
Last modified by Xiaoling on 2025/04/24 17:18
From version 74.8
edited by Xiaoling
on 2022/06/07 17:50
Change comment: There is no comment for this version
To version 85.33
edited by Xiaoling
on 2022/06/08 13:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -66,7 +66,6 @@
66 66  
67 67  
68 68  
69 -
70 70  = 1. Introduction =
71 71  
72 72  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
... ... @@ -96,6 +96,7 @@
96 96  
97 97  
98 98  
98 +
99 99  == ​1.2 Features ==
100 100  
101 101  * LoRaWAN 1.0.3 Class A
... ... @@ -113,6 +113,7 @@
113 113  * 8500mAh Battery for long term use
114 114  
115 115  
116 +
116 116  == 1.3 Probe Specification ==
117 117  
118 118  
... ... @@ -134,11 +134,11 @@
134 134  * Length: 3.5 meters
135 135  
136 136  
138 +
137 137  == 1.4 ​Applications ==
138 138  
139 139  * Smart Agriculture
140 140  
141 -
142 142  == 1.5 Pin mapping and power on ==
143 143  
144 144  [[image:1654592472094-134.png]]
... ... @@ -154,7 +154,7 @@
154 154  )))
155 155  
156 156  (((
157 -In case you can’t set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>path:#H5.UseATCommand]]to set the keys in the LSPH01.
158 +In case you can’t set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>||anchor="H5.UseATCommand"]]to set the keys in the LSPH01.
158 158  )))
159 159  
160 160  
... ... @@ -240,19 +240,17 @@
240 240  )))
241 241  
242 242  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
243 -|(((
244 -**Size**
244 +|=(% style="width: 62.5px;" %)(((
245 +**Size (bytes)**
246 +)))|=(% style="width: 62.5px;" %)**2**|=(% style="width: 62.5px;" %)**2**|=**2**|=**2**|=**1**|=**1**|=**1**
247 +|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
248 +[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
245 245  
246 -**(bytes)**
247 -)))|**2**|**2**|**2**|**2**|**1**|**1**|**1**
248 -|**Value**|[[BAT>>path:#H2.3.1BatteryInfo]]|(((
249 -[[Temperature>>path:#H2.3.2DS18B20Temperaturesensor]]
250 -
251 -[[(Optional)>>path:#H2.3.2DS18B20Temperaturesensor]]
252 -)))|[[Soil pH>>path:#H2.3.3SoilpH]]|[[Soil Temperature>>path:#H2.3.4SoilTemperature]]|(((
253 -[[Digital Interrupt (Optional)>>path:#H2.3.5InterruptPin]]
250 +[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
251 +)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
252 +[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
254 254  )))|Reserve|(((
255 -[[Message Type>>path:#H2.3.6MessageType]]
254 +[[Message Type>>||anchor="H2.3.6MessageType"]]
256 256  )))
257 257  
258 258  [[image:1654592721645-318.png]]
... ... @@ -308,7 +308,7 @@
308 308  
309 309  === 2.3.5 Interrupt Pin ===
310 310  
311 -This data field shows if this packet is generated by interrupt or not. [[Click here>>path:#H3.2SetInterruptMode]] for the hardware and software set up.
310 +This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.2SetInterruptMode"]] for the hardware and software set up.
312 312  
313 313  
314 314  **Example:**
... ... @@ -330,11 +330,11 @@
330 330  )))
331 331  
332 332  
333 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
334 -|=**Message Type Code**|=**Description**|=**Payload**
335 -|0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]]
336 -|0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]]
337 -|0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]]
332 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:499px" %)
333 +|=(% style="width: 160px;" %)**Message Type Code**|=(% style="width: 163px;" %)**Description**|=(% style="width: 173px;" %)**Payload**
334 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
335 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
336 +|(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
338 338  
339 339  
340 340  
... ... @@ -357,7 +357,7 @@
357 357  
358 358  == 2.4 Uplink Interval ==
359 359  
360 -The LSPH01 by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>path:/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval]]
359 +The LSPH01 by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H4.1ChangeUplinkInterval"]]
361 361  
362 362  
363 363  
... ... @@ -521,11 +521,9 @@
521 521  (% style="color:#037691" %)**Calibration Payload**
522 522  
523 523  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
524 -|(((
525 -**Size**
526 -
527 -**(bytes)**
528 -)))|**1**|**1**|**1**|**7**|**1**
523 +|=(% style="width: 62.5px;" %)(((
524 +**Size (bytes)**
525 +)))|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**7**|=(% style="width: 89px;" %)**1**
529 529  |**Value**|(((
530 530  PH4
531 531  
... ... @@ -535,7 +535,7 @@
535 535  
536 536  Calibrate value
537 537  )))|Reserve|(((
538 -[[Message Type>>path:#H2.3.6MessageType]]
535 +[[Message Type>>||anchor="H2.3.6MessageType"]]
539 539  
540 540  Always 0x03
541 541  )))
... ... @@ -548,8 +548,6 @@
548 548  * Reply to the confirmation package: 14 01
549 549  * Reply to non-confirmed packet: 14 00
550 550  
551 -
552 -
553 553  == 2.8 Frequency Plans ==
554 554  
555 555  (((
... ... @@ -559,32 +559,61 @@
559 559  
560 560  === 2.8.1 EU863-870 (EU868) ===
561 561  
557 +(((
562 562  (% style="color:blue" %)**Uplink:**
559 +)))
563 563  
561 +(((
564 564  868.1 - SF7BW125 to SF12BW125
563 +)))
565 565  
565 +(((
566 566  868.3 - SF7BW125 to SF12BW125 and SF7BW250
567 +)))
567 567  
569 +(((
568 568  868.5 - SF7BW125 to SF12BW125
571 +)))
569 569  
573 +(((
570 570  867.1 - SF7BW125 to SF12BW125
575 +)))
571 571  
577 +(((
572 572  867.3 - SF7BW125 to SF12BW125
579 +)))
573 573  
581 +(((
574 574  867.5 - SF7BW125 to SF12BW125
583 +)))
575 575  
585 +(((
576 576  867.7 - SF7BW125 to SF12BW125
587 +)))
577 577  
589 +(((
578 578  867.9 - SF7BW125 to SF12BW125
591 +)))
579 579  
593 +(((
580 580  868.8 - FSK
595 +)))
581 581  
597 +(((
598 +
599 +)))
582 582  
601 +(((
583 583  (% style="color:blue" %)**Downlink:**
603 +)))
584 584  
605 +(((
585 585  Uplink channels 1-9 (RX1)
607 +)))
586 586  
609 +(((
587 587  869.525 - SF9BW125 (RX2 downlink only)
611 +)))
588 588  
589 589  
590 590  
... ... @@ -610,46 +610,89 @@
610 610  
611 611  === 2.8.3 CN470-510 (CN470) ===
612 612  
637 +(((
613 613  Used in China, Default use CHE=1
639 +)))
614 614  
641 +(((
615 615  (% style="color:blue" %)**Uplink:**
643 +)))
616 616  
645 +(((
617 617  486.3 - SF7BW125 to SF12BW125
647 +)))
618 618  
649 +(((
619 619  486.5 - SF7BW125 to SF12BW125
651 +)))
620 620  
653 +(((
621 621  486.7 - SF7BW125 to SF12BW125
655 +)))
622 622  
657 +(((
623 623  486.9 - SF7BW125 to SF12BW125
659 +)))
624 624  
661 +(((
625 625  487.1 - SF7BW125 to SF12BW125
663 +)))
626 626  
665 +(((
627 627  487.3 - SF7BW125 to SF12BW125
667 +)))
628 628  
669 +(((
629 629  487.5 - SF7BW125 to SF12BW125
671 +)))
630 630  
673 +(((
631 631  487.7 - SF7BW125 to SF12BW125
675 +)))
632 632  
677 +(((
678 +
679 +)))
633 633  
681 +(((
634 634  (% style="color:blue" %)**Downlink:**
683 +)))
635 635  
685 +(((
636 636  506.7 - SF7BW125 to SF12BW125
687 +)))
637 637  
689 +(((
638 638  506.9 - SF7BW125 to SF12BW125
691 +)))
639 639  
693 +(((
640 640  507.1 - SF7BW125 to SF12BW125
695 +)))
641 641  
697 +(((
642 642  507.3 - SF7BW125 to SF12BW125
699 +)))
643 643  
701 +(((
644 644  507.5 - SF7BW125 to SF12BW125
703 +)))
645 645  
705 +(((
646 646  507.7 - SF7BW125 to SF12BW125
707 +)))
647 647  
709 +(((
648 648  507.9 - SF7BW125 to SF12BW125
711 +)))
649 649  
713 +(((
650 650  508.1 - SF7BW125 to SF12BW125
715 +)))
651 651  
717 +(((
652 652  505.3 - SF12BW125 (RX2 downlink only)
719 +)))
653 653  
654 654  
655 655  
... ... @@ -675,110 +675,220 @@
675 675  * 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)
676 676  
677 677  
745 +
678 678  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
679 679  
748 +(((
680 680  (% style="color:blue" %)**Default Uplink channel:**
750 +)))
681 681  
752 +(((
682 682  923.2 - SF7BW125 to SF10BW125
754 +)))
683 683  
756 +(((
684 684  923.4 - SF7BW125 to SF10BW125
758 +)))
685 685  
760 +(((
761 +
762 +)))
686 686  
764 +(((
687 687  (% style="color:blue" %)**Additional Uplink Channel**:
766 +)))
688 688  
768 +(((
689 689  (OTAA mode, channel added by JoinAccept message)
770 +)))
690 690  
772 +(((
773 +
774 +)))
691 691  
776 +(((
692 692  (% style="color:blue" %)**AS920~~AS923 for Japan, Malaysia, Singapore**:
778 +)))
693 693  
780 +(((
694 694  922.2 - SF7BW125 to SF10BW125
782 +)))
695 695  
784 +(((
696 696  922.4 - SF7BW125 to SF10BW125
786 +)))
697 697  
788 +(((
698 698  922.6 - SF7BW125 to SF10BW125
790 +)))
699 699  
792 +(((
700 700  922.8 - SF7BW125 to SF10BW125
794 +)))
701 701  
796 +(((
702 702  923.0 - SF7BW125 to SF10BW125
798 +)))
703 703  
800 +(((
704 704  922.0 - SF7BW125 to SF10BW125
802 +)))
705 705  
804 +(((
805 +
806 +)))
706 706  
808 +(((
707 707  (% style="color:blue" %)**AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
810 +)))
708 708  
812 +(((
709 709  923.6 - SF7BW125 to SF10BW125
814 +)))
710 710  
816 +(((
711 711  923.8 - SF7BW125 to SF10BW125
818 +)))
712 712  
820 +(((
713 713  924.0 - SF7BW125 to SF10BW125
822 +)))
714 714  
824 +(((
715 715  924.2 - SF7BW125 to SF10BW125
826 +)))
716 716  
828 +(((
717 717  924.4 - SF7BW125 to SF10BW125
830 +)))
718 718  
832 +(((
719 719  924.6 - SF7BW125 to SF10BW125
834 +)))
720 720  
836 +(((
837 +
838 +)))
721 721  
840 +(((
722 722  (% style="color:blue" %)**Downlink:**
842 +)))
723 723  
844 +(((
724 724  Uplink channels 1-8 (RX1)
846 +)))
725 725  
848 +(((
726 726  923.2 - SF10BW125 (RX2)
850 +)))
727 727  
728 728  
729 729  
730 730  === 2.8.6 KR920-923 (KR920) ===
731 731  
856 +(((
732 732  (% style="color:blue" %)**Default channel:**
858 +)))
733 733  
860 +(((
734 734  922.1 - SF7BW125 to SF12BW125
862 +)))
735 735  
864 +(((
736 736  922.3 - SF7BW125 to SF12BW125
866 +)))
737 737  
868 +(((
738 738  922.5 - SF7BW125 to SF12BW125
870 +)))
739 739  
872 +(((
873 +
874 +)))
740 740  
876 +(((
741 741  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
878 +)))
742 742  
880 +(((
743 743  922.1 - SF7BW125 to SF12BW125
882 +)))
744 744  
884 +(((
745 745  922.3 - SF7BW125 to SF12BW125
886 +)))
746 746  
888 +(((
747 747  922.5 - SF7BW125 to SF12BW125
890 +)))
748 748  
892 +(((
749 749  922.7 - SF7BW125 to SF12BW125
894 +)))
750 750  
896 +(((
751 751  922.9 - SF7BW125 to SF12BW125
898 +)))
752 752  
900 +(((
753 753  923.1 - SF7BW125 to SF12BW125
902 +)))
754 754  
904 +(((
755 755  923.3 - SF7BW125 to SF12BW125
906 +)))
756 756  
908 +(((
909 +
910 +)))
757 757  
912 +(((
758 758  (% style="color:blue" %)**Downlink:**
914 +)))
759 759  
916 +(((
760 760  Uplink channels 1-7(RX1)
918 +)))
761 761  
920 +(((
762 762  921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
922 +)))
763 763  
764 764  
765 765  
766 766  === 2.8.7 IN865-867 (IN865) ===
767 767  
928 +(((
768 768  (% style="color:blue" %)**Uplink:**
930 +)))
769 769  
932 +(((
770 770  865.0625 - SF7BW125 to SF12BW125
934 +)))
771 771  
936 +(((
772 772  865.4025 - SF7BW125 to SF12BW125
938 +)))
773 773  
940 +(((
774 774  865.9850 - SF7BW125 to SF12BW125
942 +)))
775 775  
944 +(((
945 +
946 +)))
776 776  
948 +(((
777 777  (% style="color:blue" %)**Downlink:**
950 +)))
778 778  
952 +(((
779 779  Uplink channels 1-3 (RX1)
954 +)))
780 780  
956 +(((
781 781  866.550 - SF10BW125 (RX2)
958 +)))
782 782  
783 783  
784 784  
... ... @@ -790,6 +790,7 @@
790 790  * Blink once when device transmit a packet.
791 791  
792 792  
970 +
793 793  == 2.10 ​Firmware Change Log ==
794 794  
795 795  
... ... @@ -804,26 +804,51 @@
804 804  
805 805  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
806 806  
985 +(((
807 807  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
987 +)))
808 808  
809 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
810 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
989 +* (((
990 +AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].
991 +)))
992 +* (((
993 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
994 +)))
811 811  
996 +(((
812 812  There are two kinds of commands to configure LSPH01, they are:
998 +)))
813 813  
814 -* (% style="color:#4f81bd" %)** General Commands**.
1000 +* (((
1001 +(% style="color:#4f81bd" %)** General Commands**.
1002 +)))
815 815  
1004 +(((
816 816  These commands are to configure:
1006 +)))
817 817  
818 -* General system settings like: uplink interval.
819 -* LoRaWAN protocol & radio related command.
1008 +* (((
1009 +General system settings like: uplink interval.
1010 +)))
1011 +* (((
1012 +LoRaWAN protocol & radio related command.
1013 +)))
820 820  
1015 +(((
821 821  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 +)))
822 822  
1019 +(((
1020 +
1021 +)))
823 823  
824 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1023 +* (((
1024 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1025 +)))
825 825  
1027 +(((
826 826  These commands only valid for LSPH01, as below:
1029 +)))
827 827  
828 828  
829 829  
... ... @@ -837,16 +837,27 @@
837 837  
838 838  
839 839  
1043 +(((
840 840  (% style="color:#037691" %)**Downlink Command: 0x01**
1045 +)))
841 841  
1047 +(((
842 842  Format: Command Code (0x01) followed by 3 bytes time value.
1049 +)))
843 843  
1051 +(((
844 844  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
1053 +)))
845 845  
846 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
847 -* 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
848 848  
849 849  
1062 +
1063 +)))
850 850  
851 851  == 3.2 Set Interrupt Mode ==
852 852  
... ... @@ -857,18 +857,34 @@
857 857  [[image:image-20220607171716-9.png]]
858 858  
859 859  
1074 +(((
860 860  (% style="color:#037691" %)**Downlink Command: 0x06**
1076 +)))
861 861  
1078 +(((
862 862  Format: Command Code (0x06) followed by 3 bytes.
1080 +)))
863 863  
1082 +(((
864 864  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 +)))
865 865  
866 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
867 -* 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 +)))
868 868  
1093 +(((
1094 +
1095 +)))
1096 +
1097 +
1098 +
869 869  == 3.3 Calibrate Sensor ==
870 870  
871 -Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
1101 +Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
872 872  
873 873  
874 874  
... ... @@ -900,7 +900,7 @@
900 900  
901 901  Version
902 902  )))|Sensor Type|Reserve|(((
903 -[[Message Type>>path:#H2.3.6MessageType]]
1133 +[[Message Type>>||anchor="H2.3.6MessageType"]]
904 904  Always 0x02
905 905  )))
906 906  
... ... @@ -1040,9 +1040,13 @@
1040 1040  
1041 1041  === ​4.3.2 Replace the battery ===
1042 1042  
1273 +(((
1043 1043  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 +)))
1044 1044  
1277 +(((
1045 1045  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 +)))
1046 1046  
1047 1047  
1048 1048  
... ... @@ -1063,24 +1063,24 @@
1063 1063  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1064 1064  
1065 1065  
1300 +(((
1066 1066  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 +)))
1067 1067  
1068 1068  
1069 1069   [[image:1654593712276-618.png]]
1070 1070  
1071 -Valid AT Command please check [[Configure Device>>path:#H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink]].
1307 +Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
1072 1072  
1073 1073  
1074 -
1075 1075  = 6. FAQ =
1076 1076  
1077 1077  == 6.1 How to change the LoRa Frequency Bands/Region ==
1078 1078  
1079 -You can follow the instructions for [[how to upgrade image>>path:#H2.10200BFirmwareChangeLog]].
1314 +You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1080 1080  When downloading the images, choose the required image file for download. ​
1081 1081  
1082 1082  
1083 -
1084 1084  = 7. Trouble Shooting =
1085 1085  
1086 1086  == 7.1 AT Commands input doesn’t work ==