Last modified by Bei Jinggeng on 2024/08/02 17:52
<
From version < 98.2 >
edited by Xiaoling
on 2022/06/30 11:33
To version < 98.13 >
edited by Xiaoling
on 2022/10/27 13:43
>
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.
... ... @@ -100,12 +100,13 @@
100 100  
101 101  == 1.4 ​Applications ==
102 102  
91 +
103 103  * Smart Agriculture
104 104  
105 105  
106 -
107 107  == 1.5 Pin mapping and power on ==
108 108  
97 +
109 109  [[image:1654592472094-134.png]]
110 110  
111 111  
... ... @@ -112,8 +112,10 @@
112 112  
113 113  = 2. Configure LSPH01 to connect to LoRaWAN network =
114 114  
104 +
115 115  == 2.1 How it works ==
116 116  
107 +
117 117  (((
118 118  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.
119 119  )))
... ... @@ -123,8 +123,10 @@
123 123  )))
124 124  
125 125  
117 +
126 126  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
127 127  
120 +
128 128  (((
129 129  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.
130 130  )))
... ... @@ -190,6 +190,8 @@
190 190  
191 191  (((
192 192  (% 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 +
193 193  )))
194 194  
195 195  [[image:1654592697690-910.png]]
... ... @@ -198,6 +198,7 @@
198 198  
199 199  == 2.3 ​Uplink Payload ==
200 200  
196 +
201 201  (((
202 202  LSPH01 will uplink payload via LoRaWAN with below payload format: 
203 203  )))
... ... @@ -210,14 +210,11 @@
210 210  Normal uplink payload:
211 211  )))
212 212  
213 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
214 -|=(% style="width: 62.5px;" %)(((
215 -**Size (bytes)**
216 -)))|=(% 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:510px" %)
210 +|=(% style="width: 60px;" %)(((
211 +**Size (bytes)**)))|=(% style="width: 30px;" %)**2**|=(% style="width: 70px;" %)**2**|=(% style="width: 70px;" %)**2**|=(% style="width: 60px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 50px;" %)**1**|=(% style="width: 80px;" %)**1**
217 217  |(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
218 -[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
219 -
220 -[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
213 +[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
221 221  )))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
222 222  [[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
223 223  )))|Reserve|(((
... ... @@ -241,6 +241,7 @@
241 241  
242 242  === 2.3.2 DS18B20 Temperature sensor ===
243 243  
237 +
244 244  This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
245 245  
246 246  
... ... @@ -254,6 +254,7 @@
254 254  
255 255  === 2.3.3 Soil pH ===
256 256  
251 +
257 257  Range: 0 ~~ 14 pH
258 258  
259 259  **Example:**
... ... @@ -264,6 +264,7 @@
264 264  
265 265  === 2.3.4 Soil Temperature ===
266 266  
262 +
267 267  Get Soil Temperature 
268 268  
269 269  
... ... @@ -277,6 +277,7 @@
277 277  
278 278  === 2.3.5 Interrupt Pin ===
279 279  
276 +
280 280  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.
281 281  
282 282  
... ... @@ -290,6 +290,7 @@
290 290  
291 291  === 2.3.6 Message Type ===
292 292  
290 +
293 293  (((
294 294  For a normal uplink payload, the message type is always 0x01.
295 295  )))
... ... @@ -305,6 +305,8 @@
305 305  |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
306 306  |(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
307 307  
306 +
307 +
308 308  === 2.3.7 Decode payload in The Things Network ===
309 309  
310 310  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -317,7 +317,7 @@
317 317  )))
318 318  
319 319  (((
320 -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]]
321 321  )))
322 322  
323 323  
... ... @@ -324,6 +324,7 @@
324 324  
325 325  == 2.4 Uplink Interval ==
326 326  
327 +
327 327  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"]]
328 328  
329 329  
... ... @@ -330,6 +330,7 @@
330 330  
331 331  == 2.5 ​Show Data in DataCake IoT Server ==
332 332  
334 +
333 333  (((
334 334  [[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:
335 335  )))
... ... @@ -372,7 +372,7 @@
372 372  )))
373 373  
374 374  (((
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/]]
377 +Download Datacake decoder from: [[https:~~/~~/www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>url:https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]]
376 376  )))
377 377  
378 378  
... ... @@ -393,8 +393,10 @@
393 393  
394 394  == 2.6 Installation and Maintain ==
395 395  
398 +
396 396  === 2.6.1 Before measurement ===
397 397  
401 +
398 398  (((
399 399  (((
400 400  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. 
... ... @@ -412,6 +412,8 @@
412 412  
413 413  (((
414 414  [[image:1654592946732-634.png]]
419 +
420 +
415 415  )))
416 416  
417 417  (((
... ... @@ -423,7 +423,7 @@
423 423  )))
424 424  
425 425  (((
426 -Slowly insert the probe to the measure point. Don’t 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.
427 427  )))
428 428  
429 429  (((
... ... @@ -450,6 +450,7 @@
450 450  
451 451  === 2.6.3 Maintain Probe ===
452 452  
459 +
453 453  1. (((
454 454  pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
455 455  )))
... ... @@ -474,6 +474,7 @@
474 474  
475 475  == 2.7 Calibration ==
476 476  
484 +
477 477  (((
478 478  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).
479 479  )))
... ... @@ -513,15 +513,19 @@
513 513  * Reply to the confirmation package: 14 01
514 514  * Reply to non-confirmed packet: 14 00
515 515  
524 +
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  )))
... ... @@ -595,12 +595,13 @@
595 595  )))
596 596  
597 597  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
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)
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)
599 599  
600 600  
601 601  
602 602  === 2.8.3 CN470-510 (CN470) ===
603 603  
617 +
604 604  (((
605 605  Used in China, Default use CHE=1
606 606  )))
... ... @@ -689,6 +689,7 @@
689 689  
690 690  === 2.8.4 AU915-928(AU915) ===
691 691  
706 +
692 692  (((
693 693  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
694 694  )))
... ... @@ -706,12 +706,13 @@
706 706  )))
707 707  
708 708  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
709 -* 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)
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)
710 710  
711 711  
712 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,6 +928,7 @@
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.
... ... @@ -938,11 +938,9 @@
938 938  == 2.10 ​Firmware Change Log ==
939 939  
940 940  
941 -**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]]
942 942  
943 -[[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/]]
944 944  
945 -
946 946  **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
947 947  
948 948  
... ... @@ -949,6 +949,7 @@
949 949  
950 950  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
951 951  
969 +
952 952  (((
953 953  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
954 954  )))
... ... @@ -980,7 +980,7 @@
980 980  )))
981 981  
982 982  (((
983 -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/]]
984 984  )))
985 985  
986 986  (((
... ... @@ -999,6 +999,7 @@
999 999  
1000 1000  == 3.1 Set Transmit Interval Time ==
1001 1001  
1020 +
1002 1002  Feature: Change LoRaWAN End Node Transmit Interval.
1003 1003  
1004 1004  (% style="color:#037691" %)**AT Command: AT+TDC**
... ... @@ -1025,11 +1025,13 @@
1025 1025  Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1026 1026  
1027 1027  
1047 +
1028 1028  
1029 1029  )))
1030 1030  
1031 1031  == 3.2 Set Interrupt Mode ==
1032 1032  
1053 +
1033 1033  Feature, Set Interrupt mode for GPIO_EXIT.
1034 1034  
1035 1035  (% style="color:#037691" %)**AT Command: AT+INTMOD**
... ... @@ -1064,6 +1064,7 @@
1064 1064  
1065 1065  == 3.3 Calibrate Sensor ==
1066 1066  
1088 +
1067 1067  Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1068 1068  
1069 1069  
... ... @@ -1070,6 +1070,7 @@
1070 1070  
1071 1071  == 3.4 Get Firmware Version Info ==
1072 1072  
1095 +
1073 1073  Feature: use downlink to get firmware version.
1074 1074  
1075 1075  (% style="color:#037691" %)**Downlink Command: 0x26**
... ... @@ -1152,8 +1152,10 @@
1152 1152  
1153 1153  = 4. Battery & How to replace =
1154 1154  
1178 +
1155 1155  == 4.1 Battery Type ==
1156 1156  
1181 +
1157 1157  (((
1158 1158  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.
1159 1159  )))
... ... @@ -1160,6 +1160,8 @@
1160 1160  
1161 1161  (((
1162 1162  The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
1188 +
1189 +
1163 1163  )))
1164 1164  
1165 1165  [[image:1654593587246-335.png]]
... ... @@ -1173,6 +1173,7 @@
1173 1173  
1174 1174  == 4.2 Replace Battery ==
1175 1175  
1203 +
1176 1176  (((
1177 1177  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1178 1178  )))
... ... @@ -1185,6 +1185,7 @@
1185 1185  
1186 1186  == 4.3 Power Consumption Analyze ==
1187 1187  
1216 +
1188 1188  (((
1189 1189  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.
1190 1190  )))
... ... @@ -1228,6 +1228,7 @@
1228 1228  
1229 1229  === 4.3.1 ​Battery Note ===
1230 1230  
1260 +
1231 1231  (((
1232 1232  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.
1233 1233  )))
... ... @@ -1236,12 +1236,13 @@
1236 1236  
1237 1237  === ​4.3.2 Replace the battery ===
1238 1238  
1269 +
1239 1239  (((
1240 1240  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.
1241 1241  )))
1242 1242  
1243 1243  (((
1244 -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)
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)
1245 1245  )))
1246 1246  
1247 1247  
... ... @@ -1248,12 +1248,16 @@
1248 1248  
1249 1249  = 5. Use AT Command =
1250 1250  
1282 +
1251 1251  == 5.1 Access AT Commands ==
1252 1252  
1285 +
1253 1253  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.
1254 1254  
1288 +
1255 1255  [[image:1654593668970-604.png]]
1256 1256  
1291 +
1257 1257  **Connection:**
1258 1258  
1259 1259  (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
... ... @@ -1275,16 +1275,21 @@
1275 1275  
1276 1276  = 6. FAQ =
1277 1277  
1313 +
1278 1278  == 6.1 How to change the LoRa Frequency Bands/Region ==
1279 1279  
1316 +
1280 1280  You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1281 1281  When downloading the images, choose the required image file for download. ​
1282 1282  
1283 1283  
1321 +
1284 1284  = 7. Trouble Shooting =
1285 1285  
1324 +
1286 1286  == 7.1 AT Commands input doesn't work ==
1287 1287  
1327 +
1288 1288  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.
1289 1289  
1290 1290  
... ... @@ -1291,6 +1291,7 @@
1291 1291  
1292 1292  = 8. Order Info =
1293 1293  
1334 +
1294 1294  Part Number: (% style="color:blue" %)**LSPH01-XX**
1295 1295  
1296 1296  
... ... @@ -1323,6 +1323,7 @@
1323 1323  
1324 1324  = 10. ​Support =
1325 1325  
1367 +
1326 1326  * 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.
1327 1327  * 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]].
1328 1328  

Applications

Navigation

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