Changes for page LSPH01 -- LoRaWAN Soil pH Sensor User Manual
Last modified by Xiaoling on 2025/04/25 14:08
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 1 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -4,7 +4,7 @@ 4 4 5 5 6 6 7 -**Contents:** 7 +**Table of Contents:** 8 8 9 9 * [[1. Introduction>>path:#H1.Introduction]] 10 10 ** [[1.1 What is LoRaWAN Soil pH Sensor>>path:#H1.1200BWhatisLoRaWANSoilpHSensor]] ... ... @@ -64,14 +64,13 @@ 64 64 65 65 66 66 67 - 68 - 69 - 70 70 = 1. Introduction = 71 71 72 72 == 1.1 What is LoRaWAN Soil pH Sensor == 73 73 74 74 ((( 72 + 73 + 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. 76 76 ))) 77 77 ... ... @@ -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,8 @@ 113 113 * 8500mAh Battery for long term use 114 114 115 115 116 + 117 + 116 116 == 1.3 Probe Specification == 117 117 118 118 ... ... @@ -125,6 +125,7 @@ 125 125 * IP68 Protection 126 126 * Length: 3.5 meters 127 127 130 + 128 128 (% style="color:#4f81bd" %)**Soil Temperature:** 129 129 130 130 * Range -40℃~85℃ ... ... @@ -134,11 +134,15 @@ 134 134 * Length: 3.5 meters 135 135 136 136 140 + 141 + 137 137 == 1.4 Applications == 138 138 139 139 * Smart Agriculture 140 140 141 141 147 + 148 + 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.164 +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 ... ... @@ -166,10 +166,14 @@ 166 166 167 167 ((( 168 168 [[image:1654592492399-921.png]] 176 + 177 + 169 169 ))) 170 170 171 171 ((( 172 172 The LG308 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server. 182 + 183 + 173 173 ))) 174 174 175 175 ((( ... ... @@ -240,19 +240,17 @@ 240 240 ))) 241 241 242 242 (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 243 -|((( 244 -**Size** 254 +|=(% style="width: 62.5px;" %)((( 255 +**Size (bytes)** 256 +)))|=(% style="width: 62.5px;" %)**2**|=(% style="width: 62.5px;" %)**2**|=**2**|=**2**|=**1**|=**1**|=**1** 257 +|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)((( 258 +[[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]] 260 +[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 261 +)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|((( 262 +[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]] 254 254 )))|Reserve|((( 255 -[[Message Type>> path:#H2.3.6MessageType]]264 +[[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.320 +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,14 +330,12 @@ 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]]342 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:499px" %) 343 +|=(% style="width: 160px;" %)**Message Type Code**|=(% style="width: 163px;" %)**Description**|=(% style="width: 173px;" %)**Payload** 344 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]] 345 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]] 346 +|(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]] 338 338 339 - 340 - 341 341 === 2.3.7 Decode payload in The Things Network === 342 342 343 343 While using TTN network, you can add the payload format to decode the payload. ... ... @@ -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]]367 +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** 531 +|=(% style="width: 62.5px;" %)((( 532 +**Size (bytes)** 533 +)))|=(% 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]]543 +[[Message Type>>||anchor="H2.3.6MessageType"]] 539 539 540 540 Always 0x03 541 541 ))) ... ... @@ -549,7 +549,6 @@ 549 549 * Reply to non-confirmed packet: 14 00 550 550 551 551 552 - 553 553 == 2.8 Frequency Plans == 554 554 555 555 ((( ... ... @@ -635,50 +635,91 @@ 635 635 * 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) 636 636 637 637 638 - 639 - 640 640 === 2.8.3 CN470-510 (CN470) === 641 641 644 +((( 642 642 Used in China, Default use CHE=1 646 +))) 643 643 648 +((( 644 644 (% style="color:blue" %)**Uplink:** 650 +))) 645 645 652 +((( 646 646 486.3 - SF7BW125 to SF12BW125 654 +))) 647 647 656 +((( 648 648 486.5 - SF7BW125 to SF12BW125 658 +))) 649 649 660 +((( 650 650 486.7 - SF7BW125 to SF12BW125 662 +))) 651 651 664 +((( 652 652 486.9 - SF7BW125 to SF12BW125 666 +))) 653 653 668 +((( 654 654 487.1 - SF7BW125 to SF12BW125 670 +))) 655 655 672 +((( 656 656 487.3 - SF7BW125 to SF12BW125 674 +))) 657 657 676 +((( 658 658 487.5 - SF7BW125 to SF12BW125 678 +))) 659 659 680 +((( 660 660 487.7 - SF7BW125 to SF12BW125 682 +))) 661 661 684 +((( 685 + 686 +))) 662 662 688 +((( 663 663 (% style="color:blue" %)**Downlink:** 690 +))) 664 664 692 +((( 665 665 506.7 - SF7BW125 to SF12BW125 694 +))) 666 666 696 +((( 667 667 506.9 - SF7BW125 to SF12BW125 698 +))) 668 668 700 +((( 669 669 507.1 - SF7BW125 to SF12BW125 702 +))) 670 670 704 +((( 671 671 507.3 - SF7BW125 to SF12BW125 706 +))) 672 672 708 +((( 673 673 507.5 - SF7BW125 to SF12BW125 710 +))) 674 674 712 +((( 675 675 507.7 - SF7BW125 to SF12BW125 714 +))) 676 676 716 +((( 677 677 507.9 - SF7BW125 to SF12BW125 718 +))) 678 678 720 +((( 679 679 508.1 - SF7BW125 to SF12BW125 722 +))) 680 680 724 +((( 681 681 505.3 - SF12BW125 (RX2 downlink only) 726 +))) 682 682 683 683 684 684 ... ... @@ -703,7 +703,6 @@ 703 703 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 704 704 * 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) 705 705 706 - 707 707 === 2.8.5 AS920-923 & AS923-925 (AS923) === 708 708 709 709 ((( ... ... @@ -814,56 +814,109 @@ 814 814 815 815 === 2.8.6 KR920-923 (KR920) === 816 816 861 +((( 817 817 (% style="color:blue" %)**Default channel:** 863 +))) 818 818 865 +((( 819 819 922.1 - SF7BW125 to SF12BW125 867 +))) 820 820 869 +((( 821 821 922.3 - SF7BW125 to SF12BW125 871 +))) 822 822 873 +((( 823 823 922.5 - SF7BW125 to SF12BW125 875 +))) 824 824 877 +((( 878 + 879 +))) 825 825 881 +((( 826 826 (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)** 883 +))) 827 827 885 +((( 828 828 922.1 - SF7BW125 to SF12BW125 887 +))) 829 829 889 +((( 830 830 922.3 - SF7BW125 to SF12BW125 891 +))) 831 831 893 +((( 832 832 922.5 - SF7BW125 to SF12BW125 895 +))) 833 833 897 +((( 834 834 922.7 - SF7BW125 to SF12BW125 899 +))) 835 835 901 +((( 836 836 922.9 - SF7BW125 to SF12BW125 903 +))) 837 837 905 +((( 838 838 923.1 - SF7BW125 to SF12BW125 907 +))) 839 839 909 +((( 840 840 923.3 - SF7BW125 to SF12BW125 911 +))) 841 841 913 +((( 914 + 915 +))) 842 842 917 +((( 843 843 (% style="color:blue" %)**Downlink:** 919 +))) 844 844 921 +((( 845 845 Uplink channels 1-7(RX1) 923 +))) 846 846 925 +((( 847 847 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125) 927 +))) 848 848 849 849 850 850 851 851 === 2.8.7 IN865-867 (IN865) === 852 852 933 +((( 853 853 (% style="color:blue" %)**Uplink:** 935 +))) 854 854 937 +((( 855 855 865.0625 - SF7BW125 to SF12BW125 939 +))) 856 856 941 +((( 857 857 865.4025 - SF7BW125 to SF12BW125 943 +))) 858 858 945 +((( 859 859 865.9850 - SF7BW125 to SF12BW125 947 +))) 860 860 949 +((( 950 + 951 +))) 861 861 953 +((( 862 862 (% style="color:blue" %)**Downlink:** 955 +))) 863 863 957 +((( 864 864 Uplink channels 1-3 (RX1) 959 +))) 865 865 961 +((( 866 866 866.550 - SF10BW125 (RX2) 963 +))) 867 867 868 868 869 869 ... ... @@ -874,7 +874,6 @@ 874 874 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected. 875 875 * Blink once when device transmit a packet. 876 876 877 - 878 878 == 2.10 Firmware Change Log == 879 879 880 880 ... ... @@ -889,26 +889,51 @@ 889 889 890 890 = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink = 891 891 988 +((( 892 892 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 990 +))) 893 893 894 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]]. 895 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]] 992 +* ((( 993 +AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]]. 994 +))) 995 +* ((( 996 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]] 997 +))) 896 896 999 +((( 897 897 There are two kinds of commands to configure LSPH01, they are: 1001 +))) 898 898 899 -* (% style="color:#4f81bd" %)** General Commands**. 1003 +* ((( 1004 +(% style="color:#4f81bd" %)** General Commands**. 1005 +))) 900 900 1007 +((( 901 901 These commands are to configure: 1009 +))) 902 902 903 -* General system settings like: uplink interval. 904 -* LoRaWAN protocol & radio related command. 1011 +* ((( 1012 +General system settings like: uplink interval. 1013 +))) 1014 +* ((( 1015 +LoRaWAN protocol & radio related command. 1016 +))) 905 905 1018 +((( 906 906 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/]] 1020 +))) 907 907 1022 +((( 1023 + 1024 +))) 908 908 909 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01** 1026 +* ((( 1027 +(% style="color:#4f81bd" %)** Commands special design for LSPH01** 1028 +))) 910 910 1030 +((( 911 911 These commands only valid for LSPH01, as below: 1032 +))) 912 912 913 913 914 914 ... ... @@ -922,16 +922,27 @@ 922 922 923 923 924 924 1046 +((( 925 925 (% style="color:#037691" %)**Downlink Command: 0x01** 1048 +))) 926 926 1050 +((( 927 927 Format: Command Code (0x01) followed by 3 bytes time value. 1052 +))) 928 928 1054 +((( 929 929 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01. 1056 +))) 930 930 931 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 932 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 1058 +* ((( 1059 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds 1060 +))) 1061 +* ((( 1062 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 933 933 934 934 1065 + 1066 +))) 935 935 936 936 == 3.2 Set Interrupt Mode == 937 937 ... ... @@ -939,21 +939,37 @@ 939 939 940 940 (% style="color:#037691" %)**AT Command: AT+INTMOD** 941 941 942 -[[image:image-2022060 7171716-9.png]]1074 +[[image:image-20220610105907-1.png]] 943 943 944 944 1077 +((( 945 945 (% style="color:#037691" %)**Downlink Command: 0x06** 1079 +))) 946 946 1081 +((( 947 947 Format: Command Code (0x06) followed by 3 bytes. 1083 +))) 948 948 1085 +((( 949 949 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06. 1087 +))) 950 950 951 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 952 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1089 +* ((( 1090 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode 1091 +))) 1092 +* ((( 1093 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 1094 +))) 953 953 1096 +((( 1097 + 1098 +))) 1099 + 1100 + 1101 + 954 954 == 3.3 Calibrate Sensor == 955 955 956 -Detail See [[Calibration Guide>> path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands1104 +Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands 957 957 958 958 959 959 ... ... @@ -985,7 +985,7 @@ 985 985 986 986 Version 987 987 )))|Sensor Type|Reserve|((( 988 -[[Message Type>> path:#H2.3.6MessageType]]1136 +[[Message Type>>||anchor="H2.3.6MessageType"]] 989 989 Always 0x02 990 990 ))) 991 991 ... ... @@ -1125,9 +1125,13 @@ 1125 1125 1126 1126 === 4.3.2 Replace the battery === 1127 1127 1276 +((( 1128 1128 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. 1278 +))) 1129 1129 1280 +((( 1130 1130 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) 1282 +))) 1131 1131 1132 1132 1133 1133 ... ... @@ -1148,24 +1148,24 @@ 1148 1148 (% style="background-color:yellow" %)** USB TTL RXD <~-~-~-~-> UART_TXD** 1149 1149 1150 1150 1303 +((( 1151 1151 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: 1305 +))) 1152 1152 1153 1153 1154 1154 [[image:1654593712276-618.png]] 1155 1155 1156 -Valid AT Command please check [[Configure Device>> path:#H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink]].1310 +Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]]. 1157 1157 1158 1158 1159 - 1160 1160 = 6. FAQ = 1161 1161 1162 1162 == 6.1 How to change the LoRa Frequency Bands/Region == 1163 1163 1164 -You can follow the instructions for [[how to upgrade image>> path:#H2.10200BFirmwareChangeLog]].1317 +You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]]. 1165 1165 When downloading the images, choose the required image file for download. 1166 1166 1167 1167 1168 - 1169 1169 = 7. Trouble Shooting = 1170 1170 1171 1171 == 7.1 AT Commands input doesn’t work ==
- image-20220610105907-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +15.5 KB - Content