<
From version < 95.1 >
edited by Xiaoling
on 2022/06/25 17:10
To version < 98.14 >
edited by Xiaoling
on 2022/10/27 13:44
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -5,10 +5,6 @@
5 5  
6 6  
7 7  
8 -
9 -
10 -
11 -
12 12  **Table of Contents:**
13 13  
14 14  {{toc/}}
... ... @@ -18,17 +18,13 @@
18 18  
19 19  
20 20  
21 -
22 -
23 -
24 -
25 25  = 1. Introduction =
26 26  
19 +
27 27  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
28 28  
29 -(((
30 -
31 31  
23 +(((
32 32  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.
33 33  )))
34 34  
... ... @@ -53,9 +53,9 @@
53 53  
54 54  
55 55  
56 -
57 57  == ​1.2 Features ==
58 58  
50 +
59 59  * LoRaWAN 1.0.3 Class A
60 60  * Ultra-low power consumption
61 61  * Monitor soil pH with temperature compensation.
... ... @@ -70,6 +70,8 @@
70 70  * IP68 rate for the Sensor Probe
71 71  * 8500mAh Battery for long term use
72 72  
65 +
66 +
73 73  == 1.3 Probe Specification ==
74 74  
75 75  
... ... @@ -90,12 +90,17 @@
90 90  * IP68 Protection
91 91  * Length: 3.5 meters
92 92  
87 +
88 +
93 93  == 1.4 ​Applications ==
94 94  
91 +
95 95  * Smart Agriculture
96 96  
94 +
97 97  == 1.5 Pin mapping and power on ==
98 98  
97 +
99 99  [[image:1654592472094-134.png]]
100 100  
101 101  
... ... @@ -102,19 +102,23 @@
102 102  
103 103  = 2. Configure LSPH01 to connect to LoRaWAN network =
104 104  
104 +
105 105  == 2.1 How it works ==
106 106  
107 +
107 107  (((
108 108  The LSPH01 is configured as LoRaWAN OTAA Class A mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and power on the LSPH01. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
109 109  )))
110 110  
111 111  (((
112 -In case you cant 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.
113 +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.
113 113  )))
114 114  
115 115  
117 +
116 116  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
117 117  
120 +
118 118  (((
119 119  Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LG308>>url:http://www.dragino.com/products/lora/item/140-lg308.html]] as a LoRaWAN gateway in this example.
120 120  )))
... ... @@ -180,6 +180,8 @@
180 180  
181 181  (((
182 182  (% 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.
186 +
187 +
183 183  )))
184 184  
185 185  [[image:1654592697690-910.png]]
... ... @@ -188,6 +188,7 @@
188 188  
189 189  == 2.3 ​Uplink Payload ==
190 190  
196 +
191 191  (((
192 192  LSPH01 will uplink payload via LoRaWAN with below payload format: 
193 193  )))
... ... @@ -200,14 +200,11 @@
200 200  Normal uplink payload:
201 201  )))
202 202  
203 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
204 -|=(% style="width: 62.5px;" %)(((
205 -**Size (bytes)**
206 -)))|=(% style="width: 62.5px;" %)**2**|=(% style="width: 62.5px;" %)**2**|=**2**|=**2**|=**1**|=**1**|=**1**
209 +(% border="1" cellspacing="5" style="background-color:#ffffcc; width:490px" %)
210 +|=(% style="width: 60px;" %)(((
211 +**Size (bytes)**)))|=(% style="width: 30px;" %)**2**|=(% style="width: 70px;" %)**2**|=(% style="width: 50px;" %)**2**|=(% style="width: 60px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 50px;" %)**1**|=(% style="width: 80px;" %)**1**
207 207  |(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
208 -[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
209 -
210 -[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
213 +[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
211 211  )))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
212 212  [[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
213 213  )))|Reserve|(((
... ... @@ -231,6 +231,7 @@
231 231  
232 232  === 2.3.2 DS18B20 Temperature sensor ===
233 233  
237 +
234 234  This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
235 235  
236 236  
... ... @@ -244,6 +244,7 @@
244 244  
245 245  === 2.3.3 Soil pH ===
246 246  
251 +
247 247  Range: 0 ~~ 14 pH
248 248  
249 249  **Example:**
... ... @@ -254,6 +254,7 @@
254 254  
255 255  === 2.3.4 Soil Temperature ===
256 256  
262 +
257 257  Get Soil Temperature 
258 258  
259 259  
... ... @@ -267,6 +267,7 @@
267 267  
268 268  === 2.3.5 Interrupt Pin ===
269 269  
276 +
270 270  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.
271 271  
272 272  
... ... @@ -280,6 +280,7 @@
280 280  
281 281  === 2.3.6 Message Type ===
282 282  
290 +
283 283  (((
284 284  For a normal uplink payload, the message type is always 0x01.
285 285  )))
... ... @@ -295,6 +295,8 @@
295 295  |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
296 296  |(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
297 297  
306 +
307 +
298 298  === 2.3.7 Decode payload in The Things Network ===
299 299  
300 300  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -307,7 +307,7 @@
307 307  )))
308 308  
309 309  (((
310 -LSPH01 TTN Payload Decoder: [[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/]]
320 +LSPH01 TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
311 311  )))
312 312  
313 313  
... ... @@ -314,6 +314,7 @@
314 314  
315 315  == 2.4 Uplink Interval ==
316 316  
327 +
317 317  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"]]
318 318  
319 319  
... ... @@ -320,6 +320,7 @@
320 320  
321 321  == 2.5 ​Show Data in DataCake IoT Server ==
322 322  
334 +
323 323  (((
324 324  [[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:
325 325  )))
... ... @@ -362,7 +362,7 @@
362 362  )))
363 363  
364 364  (((
365 -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/]]
377 +Download Datacake decoder from: [[https:~~/~~/www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>url:https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]]
366 366  )))
367 367  
368 368  
... ... @@ -383,8 +383,10 @@
383 383  
384 384  == 2.6 Installation and Maintain ==
385 385  
398 +
386 386  === 2.6.1 Before measurement ===
387 387  
401 +
388 388  (((
389 389  (((
390 390  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. 
... ... @@ -402,6 +402,8 @@
402 402  
403 403  (((
404 404  [[image:1654592946732-634.png]]
419 +
420 +
405 405  )))
406 406  
407 407  (((
... ... @@ -413,7 +413,7 @@
413 413  )))
414 414  
415 415  (((
416 -Slowly insert the probe to the measure point. Dont use large force which will break the probe. Make sure not shake when inserting.
432 +Slowly insert the probe to the measure point. Don't use large force which will break the probe. Make sure not shake when inserting.
417 417  )))
418 418  
419 419  (((
... ... @@ -440,6 +440,7 @@
440 440  
441 441  === 2.6.3 Maintain Probe ===
442 442  
459 +
443 443  1. (((
444 444  pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
445 445  )))
... ... @@ -464,6 +464,7 @@
464 464  
465 465  == 2.7 Calibration ==
466 466  
484 +
467 467  (((
468 468  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).
469 469  )))
... ... @@ -504,16 +504,18 @@
504 504  * Reply to non-confirmed packet: 14 00
505 505  
506 506  
507 -
508 508  == 2.8 Frequency Plans ==
509 509  
527 +
510 510  (((
511 511  The LSPH01 uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
512 512  )))
513 513  
514 514  
533 +
515 515  === 2.8.1 EU863-870 (EU868) ===
516 516  
536 +
517 517  (((
518 518  (% style="color:blue" %)**Uplink:**
519 519  )))
... ... @@ -574,6 +574,7 @@
574 574  
575 575  === 2.8.2 US902-928(US915) ===
576 576  
597 +
577 577  (((
578 578  Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
579 579  )))
... ... @@ -587,16 +587,13 @@
587 587  )))
588 588  
589 589  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
590 -* Use the Join successful sub-band if the server doesnt include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
611 +* 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)
591 591  
592 592  
593 593  
594 -
595 -
596 -
597 -
598 598  === 2.8.3 CN470-510 (CN470) ===
599 599  
617 +
600 600  (((
601 601  Used in China, Default use CHE=1
602 602  )))
... ... @@ -685,6 +685,7 @@
685 685  
686 686  === 2.8.4 AU915-928(AU915) ===
687 687  
706 +
688 688  (((
689 689  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
690 690  )))
... ... @@ -702,16 +702,13 @@
702 702  )))
703 703  
704 704  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
705 -* Use the Join successful sub-band if the server doesnt include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
724 +* 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)
706 706  
707 707  
708 708  
709 -
710 -
711 -
712 -
713 713  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
714 714  
730 +
715 715  (((
716 716  (% style="color:blue" %)**Default Uplink channel:**
717 717  )))
... ... @@ -820,6 +820,7 @@
820 820  
821 821  === 2.8.6 KR920-923 (KR920) ===
822 822  
839 +
823 823  (((
824 824  (% style="color:blue" %)**Default channel:**
825 825  )))
... ... @@ -892,6 +892,7 @@
892 892  
893 893  === 2.8.7 IN865-867 (IN865) ===
894 894  
912 +
895 895  (((
896 896  (% style="color:blue" %)**Uplink:**
897 897  )))
... ... @@ -928,19 +928,20 @@
928 928  
929 929  == 2.9 LED Indicator ==
930 930  
949 +
931 931  The LSPH01 has an internal LED which is to show the status of different state.
932 932  
933 933  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
934 934  * Blink once when device transmit a packet.
935 935  
936 -== 2.10 ​Firmware Change Log ==
937 937  
938 938  
939 -**Firmware download link:**
957 +== 2.10 ​Firmware Change Log ==
940 940  
941 -[[http:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/LSPH01/Firmware/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/Firmware/]]
942 942  
960 +**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0>>https://www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0]]
943 943  
962 +
944 944  **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
945 945  
946 946  
... ... @@ -947,6 +947,7 @@
947 947  
948 948  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
949 949  
969 +
950 950  (((
951 951  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
952 952  )))
... ... @@ -978,7 +978,7 @@
978 978  )))
979 979  
980 980  (((
981 -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/]]
1001 +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/]]
982 982  )))
983 983  
984 984  (((
... ... @@ -997,6 +997,7 @@
997 997  
998 998  == 3.1 Set Transmit Interval Time ==
999 999  
1020 +
1000 1000  Feature: Change LoRaWAN End Node Transmit Interval.
1001 1001  
1002 1002  (% style="color:#037691" %)**AT Command: AT+TDC**
... ... @@ -1023,11 +1023,13 @@
1023 1023  Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1024 1024  
1025 1025  
1047 +
1026 1026  
1027 1027  )))
1028 1028  
1029 1029  == 3.2 Set Interrupt Mode ==
1030 1030  
1053 +
1031 1031  Feature, Set Interrupt mode for GPIO_EXIT.
1032 1032  
1033 1033  (% style="color:#037691" %)**AT Command: AT+INTMOD**
... ... @@ -1062,6 +1062,7 @@
1062 1062  
1063 1063  == 3.3 Calibrate Sensor ==
1064 1064  
1088 +
1065 1065  Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1066 1066  
1067 1067  
... ... @@ -1068,6 +1068,7 @@
1068 1068  
1069 1069  == 3.4 Get Firmware Version Info ==
1070 1070  
1095 +
1071 1071  Feature: use downlink to get firmware version.
1072 1072  
1073 1073  (% style="color:#037691" %)**Downlink Command: 0x26**
... ... @@ -1150,8 +1150,10 @@
1150 1150  
1151 1151  = 4. Battery & How to replace =
1152 1152  
1178 +
1153 1153  == 4.1 Battery Type ==
1154 1154  
1181 +
1155 1155  (((
1156 1156  LSPH01 is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]. The battery is un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This type of battery is commonly used in IoT target for long-term running, such as water meter.
1157 1157  )))
... ... @@ -1158,6 +1158,8 @@
1158 1158  
1159 1159  (((
1160 1160  The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
1188 +
1189 +
1161 1161  )))
1162 1162  
1163 1163  [[image:1654593587246-335.png]]
... ... @@ -1171,6 +1171,7 @@
1171 1171  
1172 1172  == 4.2 Replace Battery ==
1173 1173  
1203 +
1174 1174  (((
1175 1175  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1176 1176  )))
... ... @@ -1183,6 +1183,7 @@
1183 1183  
1184 1184  == 4.3 Power Consumption Analyze ==
1185 1185  
1216 +
1186 1186  (((
1187 1187  Dragino Battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
1188 1188  )))
... ... @@ -1226,6 +1226,7 @@
1226 1226  
1227 1227  === 4.3.1 ​Battery Note ===
1228 1228  
1260 +
1229 1229  (((
1230 1230  The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
1231 1231  )))
... ... @@ -1234,12 +1234,13 @@
1234 1234  
1235 1235  === ​4.3.2 Replace the battery ===
1236 1236  
1269 +
1237 1237  (((
1238 1238  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.
1239 1239  )))
1240 1240  
1241 1241  (((
1242 -The default battery pack of LSPH01 includes a ER26500 plus super capacitor. If user cant 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)
1275 +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)
1243 1243  )))
1244 1244  
1245 1245  
... ... @@ -1246,12 +1246,16 @@
1246 1246  
1247 1247  = 5. Use AT Command =
1248 1248  
1282 +
1249 1249  == 5.1 Access AT Commands ==
1250 1250  
1285 +
1251 1251  LSPH01 supports AT Command set in the stock firmware. You can use a USB to TTL adapter to connect to LSPH01 for using AT command, as below.
1252 1252  
1288 +
1253 1253  [[image:1654593668970-604.png]]
1254 1254  
1291 +
1255 1255  **Connection:**
1256 1256  
1257 1257  (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
... ... @@ -1273,16 +1273,21 @@
1273 1273  
1274 1274  = 6. FAQ =
1275 1275  
1313 +
1276 1276  == 6.1 How to change the LoRa Frequency Bands/Region ==
1277 1277  
1316 +
1278 1278  You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1279 1279  When downloading the images, choose the required image file for download. ​
1280 1280  
1281 1281  
1321 +
1282 1282  = 7. Trouble Shooting =
1283 1283  
1324 +
1284 1284  == 7.1 AT Commands input doesn't work ==
1285 1285  
1327 +
1286 1286  In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
1287 1287  
1288 1288  
... ... @@ -1289,6 +1289,7 @@
1289 1289  
1290 1290  = 8. Order Info =
1291 1291  
1334 +
1292 1292  Part Number: (% style="color:blue" %)**LSPH01-XX**
1293 1293  
1294 1294  
... ... @@ -1304,9 +1304,6 @@
1304 1304  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1305 1305  
1306 1306  
1307 -
1308 -
1309 -
1310 1310  = 9. ​Packing Info =
1311 1311  
1312 1312  
... ... @@ -1322,11 +1322,9 @@
1322 1322  * Weight / pcs : g
1323 1323  
1324 1324  
1325 -
1326 -
1327 -
1328 1328  = 10. ​Support =
1329 1329  
1367 +
1330 1330  * 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.
1331 1331  * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]].
1332 1332  
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0