<
From version < 94.1 >
edited by Xiaoling
on 2022/06/25 17:10
To version < 98.11 >
edited by Xiaoling
on 2022/08/18 16:39
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -9,6 +9,10 @@
9 9  
10 10  
11 11  
12 +
13 +
14 +
15 +
12 12  **Table of Contents:**
13 13  
14 14  {{toc/}}
... ... @@ -24,6 +24,7 @@
24 24  
25 25  = 1. Introduction =
26 26  
31 +
27 27  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
28 28  
29 29  (((
... ... @@ -56,6 +56,7 @@
56 56  
57 57  == ​1.2 Features ==
58 58  
64 +
59 59  * LoRaWAN 1.0.3 Class A
60 60  * Ultra-low power consumption
61 61  * Monitor soil pH with temperature compensation.
... ... @@ -71,6 +71,9 @@
71 71  * 8500mAh Battery for long term use
72 72  
73 73  
80 +
81 +
82 +
74 74  == 1.3 Probe Specification ==
75 75  
76 76  
... ... @@ -92,13 +92,20 @@
92 92  * Length: 3.5 meters
93 93  
94 94  
104 +
105 +
106 +
95 95  == 1.4 ​Applications ==
96 96  
109 +
97 97  * Smart Agriculture
98 98  
99 99  
113 +
114 +
100 100  == 1.5 Pin mapping and power on ==
101 101  
117 +
102 102  [[image:1654592472094-134.png]]
103 103  
104 104  
... ... @@ -105,19 +105,23 @@
105 105  
106 106  = 2. Configure LSPH01 to connect to LoRaWAN network =
107 107  
124 +
108 108  == 2.1 How it works ==
109 109  
127 +
110 110  (((
111 111  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.
112 112  )))
113 113  
114 114  (((
115 -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.
133 +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.
116 116  )))
117 117  
118 118  
137 +
119 119  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
120 120  
140 +
121 121  (((
122 122  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.
123 123  )))
... ... @@ -183,6 +183,8 @@
183 183  
184 184  (((
185 185  (% 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.
206 +
207 +
186 186  )))
187 187  
188 188  [[image:1654592697690-910.png]]
... ... @@ -191,6 +191,7 @@
191 191  
192 192  == 2.3 ​Uplink Payload ==
193 193  
216 +
194 194  (((
195 195  LSPH01 will uplink payload via LoRaWAN with below payload format: 
196 196  )))
... ... @@ -234,6 +234,7 @@
234 234  
235 235  === 2.3.2 DS18B20 Temperature sensor ===
236 236  
260 +
237 237  This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
238 238  
239 239  
... ... @@ -247,6 +247,7 @@
247 247  
248 248  === 2.3.3 Soil pH ===
249 249  
274 +
250 250  Range: 0 ~~ 14 pH
251 251  
252 252  **Example:**
... ... @@ -257,6 +257,7 @@
257 257  
258 258  === 2.3.4 Soil Temperature ===
259 259  
285 +
260 260  Get Soil Temperature 
261 261  
262 262  
... ... @@ -270,6 +270,7 @@
270 270  
271 271  === 2.3.5 Interrupt Pin ===
272 272  
299 +
273 273  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.
274 274  
275 275  
... ... @@ -283,6 +283,7 @@
283 283  
284 284  === 2.3.6 Message Type ===
285 285  
313 +
286 286  (((
287 287  For a normal uplink payload, the message type is always 0x01.
288 288  )))
... ... @@ -299,6 +299,9 @@
299 299  |(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
300 300  
301 301  
330 +
331 +
332 +
302 302  === 2.3.7 Decode payload in The Things Network ===
303 303  
304 304  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -311,7 +311,7 @@
311 311  )))
312 312  
313 313  (((
314 -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/]]
345 +LSPH01 TTN Payload Decoder:  [[https:~~/~~/www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]]
315 315  )))
316 316  
317 317  
... ... @@ -318,6 +318,7 @@
318 318  
319 319  == 2.4 Uplink Interval ==
320 320  
352 +
321 321  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"]]
322 322  
323 323  
... ... @@ -324,6 +324,7 @@
324 324  
325 325  == 2.5 ​Show Data in DataCake IoT Server ==
326 326  
359 +
327 327  (((
328 328  [[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:
329 329  )))
... ... @@ -366,7 +366,7 @@
366 366  )))
367 367  
368 368  (((
369 -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/]]
402 +Download Datacake decoder from: [[https:~~/~~/www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>url:https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]]
370 370  )))
371 371  
372 372  
... ... @@ -387,8 +387,10 @@
387 387  
388 388  == 2.6 Installation and Maintain ==
389 389  
423 +
390 390  === 2.6.1 Before measurement ===
391 391  
426 +
392 392  (((
393 393  (((
394 394  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. 
... ... @@ -406,6 +406,8 @@
406 406  
407 407  (((
408 408  [[image:1654592946732-634.png]]
444 +
445 +
409 409  )))
410 410  
411 411  (((
... ... @@ -417,7 +417,7 @@
417 417  )))
418 418  
419 419  (((
420 -Slowly insert the probe to the measure point. Dont use large force which will break the probe. Make sure not shake when inserting.
457 +Slowly insert the probe to the measure point. Don't use large force which will break the probe. Make sure not shake when inserting.
421 421  )))
422 422  
423 423  (((
... ... @@ -444,6 +444,7 @@
444 444  
445 445  === 2.6.3 Maintain Probe ===
446 446  
484 +
447 447  1. (((
448 448  pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
449 449  )))
... ... @@ -468,6 +468,7 @@
468 468  
469 469  == 2.7 Calibration ==
470 470  
509 +
471 471  (((
472 472  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).
473 473  )))
... ... @@ -499,6 +499,7 @@
499 499  Always 0x03
500 500  )))
501 501  
541 +
502 502  User can also send 0x14 downlink command to poll the current calibration payload.
503 503  
504 504  [[image:image-20220607171416-7.jpeg]]
... ... @@ -512,13 +512,16 @@
512 512  
513 513  == 2.8 Frequency Plans ==
514 514  
555 +
515 515  (((
516 516  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.
517 517  )))
518 518  
519 519  
561 +
520 520  === 2.8.1 EU863-870 (EU868) ===
521 521  
564 +
522 522  (((
523 523  (% style="color:blue" %)**Uplink:**
524 524  )))
... ... @@ -579,6 +579,7 @@
579 579  
580 580  === 2.8.2 US902-928(US915) ===
581 581  
625 +
582 582  (((
583 583  Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
584 584  )))
... ... @@ -592,11 +592,15 @@
592 592  )))
593 593  
594 594  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
595 -* 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)
639 +* 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)
596 596  
597 597  
642 +
643 +
644 +
598 598  === 2.8.3 CN470-510 (CN470) ===
599 599  
647 +
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  
736 +
688 688  (((
689 689  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
690 690  )))
... ... @@ -702,11 +702,15 @@
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)
754 +* 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  
757 +
758 +
759 +
708 708  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
709 709  
762 +
710 710  (((
711 711  (% style="color:blue" %)**Default Uplink channel:**
712 712  )))
... ... @@ -815,6 +815,7 @@
815 815  
816 816  === 2.8.6 KR920-923 (KR920) ===
817 817  
871 +
818 818  (((
819 819  (% style="color:blue" %)**Default channel:**
820 820  )))
... ... @@ -887,6 +887,7 @@
887 887  
888 888  === 2.8.7 IN865-867 (IN865) ===
889 889  
944 +
890 890  (((
891 891  (% style="color:blue" %)**Uplink:**
892 892  )))
... ... @@ -923,6 +923,7 @@
923 923  
924 924  == 2.9 LED Indicator ==
925 925  
981 +
926 926  The LSPH01 has an internal LED which is to show the status of different state.
927 927  
928 928  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
... ... @@ -929,14 +929,15 @@
929 929  * Blink once when device transmit a packet.
930 930  
931 931  
932 -== 2.10 ​Firmware Change Log ==
933 933  
934 934  
935 -**Firmware download link:**
936 936  
937 -[[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/]]
991 +== 2.10 ​Firmware Change Log ==
938 938  
939 939  
994 +**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0>>https://www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0]]
995 +
996 +
940 940  **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
941 941  
942 942  
... ... @@ -943,6 +943,7 @@
943 943  
944 944  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
945 945  
1003 +
946 946  (((
947 947  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
948 948  )))
... ... @@ -974,7 +974,7 @@
974 974  )))
975 975  
976 976  (((
977 -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/]]
1035 +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/]]
978 978  )))
979 979  
980 980  (((
... ... @@ -993,6 +993,7 @@
993 993  
994 994  == 3.1 Set Transmit Interval Time ==
995 995  
1054 +
996 996  Feature: Change LoRaWAN End Node Transmit Interval.
997 997  
998 998  (% style="color:#037691" %)**AT Command: AT+TDC**
... ... @@ -1019,11 +1019,13 @@
1019 1019  Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1020 1020  
1021 1021  
1081 +
1022 1022  
1023 1023  )))
1024 1024  
1025 1025  == 3.2 Set Interrupt Mode ==
1026 1026  
1087 +
1027 1027  Feature, Set Interrupt mode for GPIO_EXIT.
1028 1028  
1029 1029  (% style="color:#037691" %)**AT Command: AT+INTMOD**
... ... @@ -1058,6 +1058,7 @@
1058 1058  
1059 1059  == 3.3 Calibrate Sensor ==
1060 1060  
1122 +
1061 1061  Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1062 1062  
1063 1063  
... ... @@ -1064,6 +1064,7 @@
1064 1064  
1065 1065  == 3.4 Get Firmware Version Info ==
1066 1066  
1129 +
1067 1067  Feature: use downlink to get firmware version.
1068 1068  
1069 1069  (% style="color:#037691" %)**Downlink Command: 0x26**
... ... @@ -1146,8 +1146,10 @@
1146 1146  
1147 1147  = 4. Battery & How to replace =
1148 1148  
1212 +
1149 1149  == 4.1 Battery Type ==
1150 1150  
1215 +
1151 1151  (((
1152 1152  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.
1153 1153  )))
... ... @@ -1154,6 +1154,8 @@
1154 1154  
1155 1155  (((
1156 1156  The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
1222 +
1223 +
1157 1157  )))
1158 1158  
1159 1159  [[image:1654593587246-335.png]]
... ... @@ -1167,6 +1167,7 @@
1167 1167  
1168 1168  == 4.2 Replace Battery ==
1169 1169  
1237 +
1170 1170  (((
1171 1171  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1172 1172  )))
... ... @@ -1179,6 +1179,7 @@
1179 1179  
1180 1180  == 4.3 Power Consumption Analyze ==
1181 1181  
1250 +
1182 1182  (((
1183 1183  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.
1184 1184  )))
... ... @@ -1222,6 +1222,7 @@
1222 1222  
1223 1223  === 4.3.1 ​Battery Note ===
1224 1224  
1294 +
1225 1225  (((
1226 1226  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.
1227 1227  )))
... ... @@ -1230,12 +1230,13 @@
1230 1230  
1231 1231  === ​4.3.2 Replace the battery ===
1232 1232  
1303 +
1233 1233  (((
1234 1234  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.
1235 1235  )))
1236 1236  
1237 1237  (((
1238 -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)
1309 +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)
1239 1239  )))
1240 1240  
1241 1241  
... ... @@ -1242,12 +1242,16 @@
1242 1242  
1243 1243  = 5. Use AT Command =
1244 1244  
1316 +
1245 1245  == 5.1 Access AT Commands ==
1246 1246  
1319 +
1247 1247  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.
1248 1248  
1322 +
1249 1249  [[image:1654593668970-604.png]]
1250 1250  
1325 +
1251 1251  **Connection:**
1252 1252  
1253 1253  (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
... ... @@ -1269,16 +1269,21 @@
1269 1269  
1270 1270  = 6. FAQ =
1271 1271  
1347 +
1272 1272  == 6.1 How to change the LoRa Frequency Bands/Region ==
1273 1273  
1350 +
1274 1274  You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1275 1275  When downloading the images, choose the required image file for download. ​
1276 1276  
1277 1277  
1355 +
1278 1278  = 7. Trouble Shooting =
1279 1279  
1358 +
1280 1280  == 7.1 AT Commands input doesn't work ==
1281 1281  
1361 +
1282 1282  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.
1283 1283  
1284 1284  
... ... @@ -1285,6 +1285,7 @@
1285 1285  
1286 1286  = 8. Order Info =
1287 1287  
1368 +
1288 1288  Part Number: (% style="color:blue" %)**LSPH01-XX**
1289 1289  
1290 1290  
... ... @@ -1302,8 +1302,6 @@
1302 1302  
1303 1303  
1304 1304  
1305 -
1306 -
1307 1307  = 9. ​Packing Info =
1308 1308  
1309 1309  
... ... @@ -1321,11 +1321,12 @@
1321 1321  
1322 1322  
1323 1323  
1324 -
1325 -
1326 1326  = 10. ​Support =
1327 1327  
1405 +
1328 1328  * 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.
1329 1329  * 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]].
1330 1330  
1409 +
1410 +
1331 1331  
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0