<
From version < 98.5 >
edited by Xiaoling
on 2022/06/30 14:01
To version < 98.16 >
edited by Xiaoling
on 2022/10/27 13:46
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -5,14 +5,6 @@
5 5  
6 6  
7 7  
8 -
9 -
10 -
11 -
12 -
13 -
14 -
15 -
16 16  **Table of Contents:**
17 17  
18 18  {{toc/}}
... ... @@ -22,17 +22,13 @@
22 22  
23 23  
24 24  
25 -
26 -
27 -
28 -
29 29  = 1. Introduction =
30 30  
19 +
31 31  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
32 32  
33 -(((
34 -
35 35  
23 +(((
36 36  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.
37 37  )))
38 38  
... ... @@ -57,9 +57,9 @@
57 57  
58 58  
59 59  
60 -
61 61  == ​1.2 Features ==
62 62  
50 +
63 63  * LoRaWAN 1.0.3 Class A
64 64  * Ultra-low power consumption
65 65  * Monitor soil pH with temperature compensation.
... ... @@ -75,6 +75,7 @@
75 75  * 8500mAh Battery for long term use
76 76  
77 77  
66 +
78 78  == 1.3 Probe Specification ==
79 79  
80 80  
... ... @@ -96,13 +96,16 @@
96 96  * Length: 3.5 meters
97 97  
98 98  
88 +
99 99  == 1.4 ​Applications ==
100 100  
91 +
101 101  * Smart Agriculture
102 102  
103 103  
104 104  == 1.5 Pin mapping and power on ==
105 105  
97 +
106 106  [[image:1654592472094-134.png]]
107 107  
108 108  
... ... @@ -109,8 +109,10 @@
109 109  
110 110  = 2. Configure LSPH01 to connect to LoRaWAN network =
111 111  
104 +
112 112  == 2.1 How it works ==
113 113  
107 +
114 114  (((
115 115  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.
116 116  )))
... ... @@ -120,8 +120,10 @@
120 120  )))
121 121  
122 122  
117 +
123 123  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
124 124  
120 +
125 125  (((
126 126  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.
127 127  )))
... ... @@ -187,6 +187,8 @@
187 187  
188 188  (((
189 189  (% 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 +
190 190  )))
191 191  
192 192  [[image:1654592697690-910.png]]
... ... @@ -195,6 +195,7 @@
195 195  
196 196  == 2.3 ​Uplink Payload ==
197 197  
196 +
198 198  (((
199 199  LSPH01 will uplink payload via LoRaWAN with below payload format: 
200 200  )))
... ... @@ -207,14 +207,11 @@
207 207  Normal uplink payload:
208 208  )))
209 209  
210 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
211 -|=(% style="width: 62.5px;" %)(((
212 -**Size (bytes)**
213 -)))|=(% 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:470px" %)
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**
214 214  |(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
215 -[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
216 -
217 -[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
213 +[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
218 218  )))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
219 219  [[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
220 220  )))|Reserve|(((
... ... @@ -238,6 +238,7 @@
238 238  
239 239  === 2.3.2 DS18B20 Temperature sensor ===
240 240  
237 +
241 241  This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
242 242  
243 243  
... ... @@ -251,6 +251,7 @@
251 251  
252 252  === 2.3.3 Soil pH ===
253 253  
251 +
254 254  Range: 0 ~~ 14 pH
255 255  
256 256  **Example:**
... ... @@ -261,6 +261,7 @@
261 261  
262 262  === 2.3.4 Soil Temperature ===
263 263  
262 +
264 264  Get Soil Temperature 
265 265  
266 266  
... ... @@ -274,6 +274,7 @@
274 274  
275 275  === 2.3.5 Interrupt Pin ===
276 276  
276 +
277 277  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.
278 278  
279 279  
... ... @@ -287,6 +287,7 @@
287 287  
288 288  === 2.3.6 Message Type ===
289 289  
290 +
290 290  (((
291 291  For a normal uplink payload, the message type is always 0x01.
292 292  )))
... ... @@ -303,6 +303,7 @@
303 303  |(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
304 304  
305 305  
307 +
306 306  === 2.3.7 Decode payload in The Things Network ===
307 307  
308 308  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -315,7 +315,7 @@
315 315  )))
316 316  
317 317  (((
318 -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]]
319 319  )))
320 320  
321 321  
... ... @@ -322,6 +322,7 @@
322 322  
323 323  == 2.4 Uplink Interval ==
324 324  
327 +
325 325  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"]]
326 326  
327 327  
... ... @@ -328,6 +328,7 @@
328 328  
329 329  == 2.5 ​Show Data in DataCake IoT Server ==
330 330  
334 +
331 331  (((
332 332  [[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:
333 333  )))
... ... @@ -370,7 +370,7 @@
370 370  )))
371 371  
372 372  (((
373 -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]]
374 374  )))
375 375  
376 376  
... ... @@ -391,8 +391,10 @@
391 391  
392 392  == 2.6 Installation and Maintain ==
393 393  
398 +
394 394  === 2.6.1 Before measurement ===
395 395  
401 +
396 396  (((
397 397  (((
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. 
... ... @@ -410,6 +410,8 @@
410 410  
411 411  (((
412 412  [[image:1654592946732-634.png]]
419 +
420 +
413 413  )))
414 414  
415 415  (((
... ... @@ -421,7 +421,7 @@
421 421  )))
422 422  
423 423  (((
424 -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.
425 425  )))
426 426  
427 427  (((
... ... @@ -448,6 +448,7 @@
448 448  
449 449  === 2.6.3 Maintain Probe ===
450 450  
459 +
451 451  1. (((
452 452  pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
453 453  )))
... ... @@ -472,6 +472,7 @@
472 472  
473 473  == 2.7 Calibration ==
474 474  
484 +
475 475  (((
476 476  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).
477 477  )))
... ... @@ -512,16 +512,18 @@
512 512  * Reply to non-confirmed packet: 14 00
513 513  
514 514  
515 -
516 516  == 2.8 Frequency Plans ==
517 517  
527 +
518 518  (((
519 519  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.
520 520  )))
521 521  
522 522  
533 +
523 523  === 2.8.1 EU863-870 (EU868) ===
524 524  
536 +
525 525  (((
526 526  (% style="color:blue" %)**Uplink:**
527 527  )))
... ... @@ -582,6 +582,7 @@
582 582  
583 583  === 2.8.2 US902-928(US915) ===
584 584  
597 +
585 585  (((
586 586  Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
587 587  )))
... ... @@ -598,8 +598,10 @@
598 598  * 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)
599 599  
600 600  
614 +
601 601  === 2.8.3 CN470-510 (CN470) ===
602 602  
617 +
603 603  (((
604 604  Used in China, Default use CHE=1
605 605  )))
... ... @@ -688,6 +688,7 @@
688 688  
689 689  === 2.8.4 AU915-928(AU915) ===
690 690  
706 +
691 691  (((
692 692  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
693 693  )))
... ... @@ -708,8 +708,10 @@
708 708  * 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)
709 709  
710 710  
727 +
711 711  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
712 712  
730 +
713 713  (((
714 714  (% style="color:blue" %)**Default Uplink channel:**
715 715  )))
... ... @@ -818,6 +818,7 @@
818 818  
819 819  === 2.8.6 KR920-923 (KR920) ===
820 820  
839 +
821 821  (((
822 822  (% style="color:blue" %)**Default channel:**
823 823  )))
... ... @@ -890,6 +890,7 @@
890 890  
891 891  === 2.8.7 IN865-867 (IN865) ===
892 892  
912 +
893 893  (((
894 894  (% style="color:blue" %)**Uplink:**
895 895  )))
... ... @@ -926,6 +926,7 @@
926 926  
927 927  == 2.9 LED Indicator ==
928 928  
949 +
929 929  The LSPH01 has an internal LED which is to show the status of different state.
930 930  
931 931  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
... ... @@ -932,14 +932,13 @@
932 932  * Blink once when device transmit a packet.
933 933  
934 934  
956 +
935 935  == 2.10 ​Firmware Change Log ==
936 936  
937 937  
938 -**Firmware download link:**
960 +**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0>>https://www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0]]
939 939  
940 -[[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/]]
941 941  
942 -
943 943  **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
944 944  
945 945  
... ... @@ -946,6 +946,7 @@
946 946  
947 947  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
948 948  
969 +
949 949  (((
950 950  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
951 951  )))
... ... @@ -996,6 +996,7 @@
996 996  
997 997  == 3.1 Set Transmit Interval Time ==
998 998  
1020 +
999 999  Feature: Change LoRaWAN End Node Transmit Interval.
1000 1000  
1001 1001  (% style="color:#037691" %)**AT Command: AT+TDC**
... ... @@ -1022,11 +1022,13 @@
1022 1022  Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1023 1023  
1024 1024  
1047 +
1025 1025  
1026 1026  )))
1027 1027  
1028 1028  == 3.2 Set Interrupt Mode ==
1029 1029  
1053 +
1030 1030  Feature, Set Interrupt mode for GPIO_EXIT.
1031 1031  
1032 1032  (% style="color:#037691" %)**AT Command: AT+INTMOD**
... ... @@ -1058,8 +1058,10 @@
1058 1058  )))
1059 1059  
1060 1060  
1085 +
1061 1061  == 3.3 Calibrate Sensor ==
1062 1062  
1088 +
1063 1063  Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1064 1064  
1065 1065  
... ... @@ -1066,6 +1066,7 @@
1066 1066  
1067 1067  == 3.4 Get Firmware Version Info ==
1068 1068  
1095 +
1069 1069  Feature: use downlink to get firmware version.
1070 1070  
1071 1071  (% style="color:#037691" %)**Downlink Command: 0x26**
... ... @@ -1148,8 +1148,10 @@
1148 1148  
1149 1149  = 4. Battery & How to replace =
1150 1150  
1178 +
1151 1151  == 4.1 Battery Type ==
1152 1152  
1181 +
1153 1153  (((
1154 1154  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.
1155 1155  )))
... ... @@ -1156,6 +1156,8 @@
1156 1156  
1157 1157  (((
1158 1158  The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
1188 +
1189 +
1159 1159  )))
1160 1160  
1161 1161  [[image:1654593587246-335.png]]
... ... @@ -1169,6 +1169,7 @@
1169 1169  
1170 1170  == 4.2 Replace Battery ==
1171 1171  
1203 +
1172 1172  (((
1173 1173  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1174 1174  )))
... ... @@ -1181,6 +1181,7 @@
1181 1181  
1182 1182  == 4.3 Power Consumption Analyze ==
1183 1183  
1216 +
1184 1184  (((
1185 1185  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.
1186 1186  )))
... ... @@ -1224,6 +1224,7 @@
1224 1224  
1225 1225  === 4.3.1 ​Battery Note ===
1226 1226  
1260 +
1227 1227  (((
1228 1228  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.
1229 1229  )))
... ... @@ -1232,6 +1232,7 @@
1232 1232  
1233 1233  === ​4.3.2 Replace the battery ===
1234 1234  
1269 +
1235 1235  (((
1236 1236  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.
1237 1237  )))
... ... @@ -1244,12 +1244,16 @@
1244 1244  
1245 1245  = 5. Use AT Command =
1246 1246  
1282 +
1247 1247  == 5.1 Access AT Commands ==
1248 1248  
1285 +
1249 1249  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.
1250 1250  
1288 +
1251 1251  [[image:1654593668970-604.png]]
1252 1252  
1291 +
1253 1253  **Connection:**
1254 1254  
1255 1255  (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
... ... @@ -1271,16 +1271,21 @@
1271 1271  
1272 1272  = 6. FAQ =
1273 1273  
1313 +
1274 1274  == 6.1 How to change the LoRa Frequency Bands/Region ==
1275 1275  
1316 +
1276 1276  You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1277 1277  When downloading the images, choose the required image file for download. ​
1278 1278  
1279 1279  
1321 +
1280 1280  = 7. Trouble Shooting =
1281 1281  
1324 +
1282 1282  == 7.1 AT Commands input doesn't work ==
1283 1283  
1327 +
1284 1284  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.
1285 1285  
1286 1286  
... ... @@ -1287,6 +1287,7 @@
1287 1287  
1288 1288  = 8. Order Info =
1289 1289  
1334 +
1290 1290  Part Number: (% style="color:blue" %)**LSPH01-XX**
1291 1291  
1292 1292  
... ... @@ -1302,7 +1302,6 @@
1302 1302  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1303 1303  
1304 1304  
1305 -
1306 1306  = 9. ​Packing Info =
1307 1307  
1308 1308  
... ... @@ -1318,9 +1318,9 @@
1318 1318  * Weight / pcs : g
1319 1319  
1320 1320  
1321 -
1322 1322  = 10. ​Support =
1323 1323  
1367 +
1324 1324  * 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.
1325 1325  * 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]].
1326 1326  
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0