<
From version < 93.1 >
edited by Xiaoling
on 2022/06/25 17:05
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,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.
... ... @@ -96,12 +96,13 @@
96 96  
97 97  == 1.4 ​Applications ==
98 98  
91 +
99 99  * Smart Agriculture
100 100  
101 101  
102 -
103 103  == 1.5 Pin mapping and power on ==
104 104  
97 +
105 105  [[image:1654592472094-134.png]]
106 106  
107 107  
... ... @@ -108,19 +108,23 @@
108 108  
109 109  = 2. Configure LSPH01 to connect to LoRaWAN network =
110 110  
104 +
111 111  == 2.1 How it works ==
112 112  
107 +
113 113  (((
114 114  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.
115 115  )))
116 116  
117 117  (((
118 -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.
119 119  )))
120 120  
121 121  
117 +
122 122  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
123 123  
120 +
124 124  (((
125 125  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.
126 126  )))
... ... @@ -186,6 +186,8 @@
186 186  
187 187  (((
188 188  (% 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 +
189 189  )))
190 190  
191 191  [[image:1654592697690-910.png]]
... ... @@ -194,6 +194,7 @@
194 194  
195 195  == 2.3 ​Uplink Payload ==
196 196  
196 +
197 197  (((
198 198  LSPH01 will uplink payload via LoRaWAN with below payload format: 
199 199  )))
... ... @@ -206,14 +206,11 @@
206 206  Normal uplink payload:
207 207  )))
208 208  
209 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
210 -|=(% style="width: 62.5px;" %)(((
211 -**Size (bytes)**
212 -)))|=(% 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**
213 213  |(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
214 -[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
215 -
216 -[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
213 +[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
217 217  )))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
218 218  [[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
219 219  )))|Reserve|(((
... ... @@ -237,6 +237,7 @@
237 237  
238 238  === 2.3.2 DS18B20 Temperature sensor ===
239 239  
237 +
240 240  This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
241 241  
242 242  
... ... @@ -250,6 +250,7 @@
250 250  
251 251  === 2.3.3 Soil pH ===
252 252  
251 +
253 253  Range: 0 ~~ 14 pH
254 254  
255 255  **Example:**
... ... @@ -260,6 +260,7 @@
260 260  
261 261  === 2.3.4 Soil Temperature ===
262 262  
262 +
263 263  Get Soil Temperature 
264 264  
265 265  
... ... @@ -273,6 +273,7 @@
273 273  
274 274  === 2.3.5 Interrupt Pin ===
275 275  
276 +
276 276  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.
277 277  
278 278  
... ... @@ -286,6 +286,7 @@
286 286  
287 287  === 2.3.6 Message Type ===
288 288  
290 +
289 289  (((
290 290  For a normal uplink payload, the message type is always 0x01.
291 291  )))
... ... @@ -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,18 +512,18 @@
512 512  * Reply to non-confirmed packet: 14 00
513 513  
514 514  
515 -
516 -
517 -
518 518  == 2.8 Frequency Plans ==
519 519  
527 +
520 520  (((
521 521  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.
522 522  )))
523 523  
524 524  
533 +
525 525  === 2.8.1 EU863-870 (EU868) ===
526 526  
536 +
527 527  (((
528 528  (% style="color:blue" %)**Uplink:**
529 529  )))
... ... @@ -584,6 +584,7 @@
584 584  
585 585  === 2.8.2 US902-928(US915) ===
586 586  
597 +
587 587  (((
588 588  Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
589 589  )))
... ... @@ -597,12 +597,13 @@
597 597  )))
598 598  
599 599  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
600 -* 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)
601 601  
602 602  
603 603  
604 604  === 2.8.3 CN470-510 (CN470) ===
605 605  
617 +
606 606  (((
607 607  Used in China, Default use CHE=1
608 608  )))
... ... @@ -691,6 +691,7 @@
691 691  
692 692  === 2.8.4 AU915-928(AU915) ===
693 693  
706 +
694 694  (((
695 695  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
696 696  )))
... ... @@ -708,12 +708,13 @@
708 708  )))
709 709  
710 710  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
711 -* 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)
712 712  
713 713  
714 714  
715 715  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
716 716  
730 +
717 717  (((
718 718  (% style="color:blue" %)**Default Uplink channel:**
719 719  )))
... ... @@ -822,6 +822,7 @@
822 822  
823 823  === 2.8.6 KR920-923 (KR920) ===
824 824  
839 +
825 825  (((
826 826  (% style="color:blue" %)**Default channel:**
827 827  )))
... ... @@ -894,6 +894,7 @@
894 894  
895 895  === 2.8.7 IN865-867 (IN865) ===
896 896  
912 +
897 897  (((
898 898  (% style="color:blue" %)**Uplink:**
899 899  )))
... ... @@ -930,6 +930,7 @@
930 930  
931 931  == 2.9 LED Indicator ==
932 932  
949 +
933 933  The LSPH01 has an internal LED which is to show the status of different state.
934 934  
935 935  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
... ... @@ -940,11 +940,9 @@
940 940  == 2.10 ​Firmware Change Log ==
941 941  
942 942  
943 -**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]]
944 944  
945 -[[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/]]
946 946  
947 -
948 948  **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
949 949  
950 950  
... ... @@ -951,6 +951,7 @@
951 951  
952 952  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
953 953  
969 +
954 954  (((
955 955  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
956 956  )))
... ... @@ -982,7 +982,7 @@
982 982  )))
983 983  
984 984  (((
985 -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/]]
986 986  )))
987 987  
988 988  (((
... ... @@ -1001,6 +1001,7 @@
1001 1001  
1002 1002  == 3.1 Set Transmit Interval Time ==
1003 1003  
1020 +
1004 1004  Feature: Change LoRaWAN End Node Transmit Interval.
1005 1005  
1006 1006  (% style="color:#037691" %)**AT Command: AT+TDC**
... ... @@ -1027,11 +1027,13 @@
1027 1027  Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1028 1028  
1029 1029  
1047 +
1030 1030  
1031 1031  )))
1032 1032  
1033 1033  == 3.2 Set Interrupt Mode ==
1034 1034  
1053 +
1035 1035  Feature, Set Interrupt mode for GPIO_EXIT.
1036 1036  
1037 1037  (% style="color:#037691" %)**AT Command: AT+INTMOD**
... ... @@ -1066,6 +1066,7 @@
1066 1066  
1067 1067  == 3.3 Calibrate Sensor ==
1068 1068  
1088 +
1069 1069  Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1070 1070  
1071 1071  
... ... @@ -1072,6 +1072,7 @@
1072 1072  
1073 1073  == 3.4 Get Firmware Version Info ==
1074 1074  
1095 +
1075 1075  Feature: use downlink to get firmware version.
1076 1076  
1077 1077  (% style="color:#037691" %)**Downlink Command: 0x26**
... ... @@ -1154,8 +1154,10 @@
1154 1154  
1155 1155  = 4. Battery & How to replace =
1156 1156  
1178 +
1157 1157  == 4.1 Battery Type ==
1158 1158  
1181 +
1159 1159  (((
1160 1160  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.
1161 1161  )))
... ... @@ -1162,6 +1162,8 @@
1162 1162  
1163 1163  (((
1164 1164  The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
1188 +
1189 +
1165 1165  )))
1166 1166  
1167 1167  [[image:1654593587246-335.png]]
... ... @@ -1175,6 +1175,7 @@
1175 1175  
1176 1176  == 4.2 Replace Battery ==
1177 1177  
1203 +
1178 1178  (((
1179 1179  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1180 1180  )))
... ... @@ -1187,6 +1187,7 @@
1187 1187  
1188 1188  == 4.3 Power Consumption Analyze ==
1189 1189  
1216 +
1190 1190  (((
1191 1191  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.
1192 1192  )))
... ... @@ -1230,6 +1230,7 @@
1230 1230  
1231 1231  === 4.3.1 ​Battery Note ===
1232 1232  
1260 +
1233 1233  (((
1234 1234  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.
1235 1235  )))
... ... @@ -1238,12 +1238,13 @@
1238 1238  
1239 1239  === ​4.3.2 Replace the battery ===
1240 1240  
1269 +
1241 1241  (((
1242 1242  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.
1243 1243  )))
1244 1244  
1245 1245  (((
1246 -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)
1247 1247  )))
1248 1248  
1249 1249  
... ... @@ -1250,12 +1250,16 @@
1250 1250  
1251 1251  = 5. Use AT Command =
1252 1252  
1282 +
1253 1253  == 5.1 Access AT Commands ==
1254 1254  
1285 +
1255 1255  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.
1256 1256  
1288 +
1257 1257  [[image:1654593668970-604.png]]
1258 1258  
1291 +
1259 1259  **Connection:**
1260 1260  
1261 1261  (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
... ... @@ -1277,16 +1277,21 @@
1277 1277  
1278 1278  = 6. FAQ =
1279 1279  
1313 +
1280 1280  == 6.1 How to change the LoRa Frequency Bands/Region ==
1281 1281  
1316 +
1282 1282  You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1283 1283  When downloading the images, choose the required image file for download. ​
1284 1284  
1285 1285  
1321 +
1286 1286  = 7. Trouble Shooting =
1287 1287  
1324 +
1288 1288  == 7.1 AT Commands input doesn't work ==
1289 1289  
1327 +
1290 1290  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.
1291 1291  
1292 1292  
... ... @@ -1293,6 +1293,7 @@
1293 1293  
1294 1294  = 8. Order Info =
1295 1295  
1334 +
1296 1296  Part Number: (% style="color:blue" %)**LSPH01-XX**
1297 1297  
1298 1298  
... ... @@ -1307,6 +1307,7 @@
1307 1307  * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
1308 1308  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1309 1309  
1349 +
1310 1310  = 9. ​Packing Info =
1311 1311  
1312 1312  
... ... @@ -1321,8 +1321,10 @@
1321 1321  * Package Size / pcs : cm
1322 1322  * Weight / pcs : g
1323 1323  
1364 +
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  
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0