Changes for page LSPH01 -- LoRaWAN Soil pH Sensor User Manual
Last modified by Bei Jinggeng on 2024/08/02 17:52
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -5,6 +5,14 @@ 5 5 6 6 7 7 8 + 9 + 10 + 11 + 12 + 13 + 14 + 15 + 8 8 **Table of Contents:** 9 9 10 10 {{toc/}} ... ... @@ -14,13 +14,17 @@ 14 14 15 15 16 16 17 -= 1. Introduction = 18 18 19 19 20 -== 1.1 What is LoRaWAN Soil pH Sensor == 21 21 22 22 29 += 1. Introduction = 30 + 31 +== 1.1 What is LoRaWAN Soil pH Sensor == 32 + 23 23 ((( 34 + 35 + 24 24 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. 25 25 ))) 26 26 ... ... @@ -45,9 +45,9 @@ 45 45 46 46 47 47 60 + 48 48 == 1.2 Features == 49 49 50 - 51 51 * LoRaWAN 1.0.3 Class A 52 52 * Ultra-low power consumption 53 53 * Monitor soil pH with temperature compensation. ... ... @@ -63,7 +63,6 @@ 63 63 * 8500mAh Battery for long term use 64 64 65 65 66 - 67 67 == 1.3 Probe Specification == 68 68 69 69 ... ... @@ -85,17 +85,13 @@ 85 85 * Length: 3.5 meters 86 86 87 87 88 - 89 89 == 1.4 Applications == 90 90 91 - 92 92 * Smart Agriculture 93 93 94 94 95 - 96 96 == 1.5 Pin mapping and power on == 97 97 98 - 99 99 [[image:1654592472094-134.png]] 100 100 101 101 ... ... @@ -102,10 +102,8 @@ 102 102 103 103 = 2. Configure LSPH01 to connect to LoRaWAN network = 104 104 105 - 106 106 == 2.1 How it works == 107 107 108 - 109 109 ((( 110 110 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. 111 111 ))) ... ... @@ -115,10 +115,8 @@ 115 115 ))) 116 116 117 117 118 - 119 119 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 120 120 121 - 122 122 ((( 123 123 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. 124 124 ))) ... ... @@ -184,8 +184,6 @@ 184 184 185 185 ((( 186 186 (% 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. 187 - 188 - 189 189 ))) 190 190 191 191 [[image:1654592697690-910.png]] ... ... @@ -194,7 +194,6 @@ 194 194 195 195 == 2.3 Uplink Payload == 196 196 197 - 198 198 ((( 199 199 LSPH01 will uplink payload via LoRaWAN with below payload format: 200 200 ))) ... ... @@ -207,12 +207,14 @@ 207 207 Normal uplink payload: 208 208 ))) 209 209 210 -(% border="1" cellspacing=" 5" style="background-color:#ffffcc; width:470px" %)211 -|=(% style="width: 6 0px;" %)(((212 -**Size(bytes)** 213 -)))|=(% 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**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** 214 214 |(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)((( 215 -[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 215 +[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 216 + 217 +[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 216 216 )))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|((( 217 217 [[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]] 218 218 )))|Reserve|((( ... ... @@ -236,7 +236,6 @@ 236 236 237 237 === 2.3.2 DS18B20 Temperature sensor === 238 238 239 - 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,7 +250,6 @@ 250 250 251 251 === 2.3.3 Soil pH === 252 252 253 - 254 254 Range: 0 ~~ 14 pH 255 255 256 256 **Example:** ... ... @@ -261,7 +261,6 @@ 261 261 262 262 === 2.3.4 Soil Temperature === 263 263 264 - 265 265 Get Soil Temperature 266 266 267 267 ... ... @@ -275,7 +275,6 @@ 275 275 276 276 === 2.3.5 Interrupt Pin === 277 277 278 - 279 279 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. 280 280 281 281 ... ... @@ -289,7 +289,6 @@ 289 289 290 290 === 2.3.6 Message Type === 291 291 292 - 293 293 ((( 294 294 For a normal uplink payload, the message type is always 0x01. 295 295 ))) ... ... @@ -299,7 +299,7 @@ 299 299 ))) 300 300 301 301 302 -(% border="1" cellspacing=" 5" style="background-color:#ffffcc; width:496px" %)299 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:499px" %) 303 303 |=(% style="width: 160px;" %)**Message Type Code**|=(% style="width: 163px;" %)**Description**|=(% style="width: 173px;" %)**Payload** 304 304 |(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]] 305 305 |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]] ... ... @@ -306,10 +306,8 @@ 306 306 |(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]] 307 307 308 308 309 - 310 310 === 2.3.7 Decode payload in The Things Network === 311 311 312 - 313 313 While using TTN network, you can add the payload format to decode the payload. 314 314 315 315 ... ... @@ -320,7 +320,7 @@ 320 320 ))) 321 321 322 322 ((( 323 -LSPH01 TTN Payload Decoder: github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]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/]] 324 324 ))) 325 325 326 326 ... ... @@ -327,7 +327,6 @@ 327 327 328 328 == 2.4 Uplink Interval == 329 329 330 - 331 331 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"]] 332 332 333 333 ... ... @@ -334,7 +334,6 @@ 334 334 335 335 == 2.5 Show Data in DataCake IoT Server == 336 336 337 - 338 338 ((( 339 339 [[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: 340 340 ))) ... ... @@ -377,7 +377,7 @@ 377 377 ))) 378 378 379 379 ((( 380 -Download Datacake decoder from: [[https:~~/~~/www.dro pbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>url:https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]]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/]] 381 381 ))) 382 382 383 383 ... ... @@ -398,10 +398,8 @@ 398 398 399 399 == 2.6 Installation and Maintain == 400 400 401 - 402 402 === 2.6.1 Before measurement === 403 403 404 - 405 405 ((( 406 406 ((( 407 407 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. ... ... @@ -419,8 +419,6 @@ 419 419 420 420 ((( 421 421 [[image:1654592946732-634.png]] 422 - 423 - 424 424 ))) 425 425 426 426 ((( ... ... @@ -432,7 +432,7 @@ 432 432 ))) 433 433 434 434 ((( 435 -Slowly insert the probe to the measure point. Don 't use large force which will break the probe. Make sure not shake when inserting.424 +Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting. 436 436 ))) 437 437 438 438 ((( ... ... @@ -459,7 +459,6 @@ 459 459 460 460 === 2.6.3 Maintain Probe === 461 461 462 - 463 463 1. ((( 464 464 pH probe electrode is fragile and no strong. User must avoid strong force or hitting it. 465 465 ))) ... ... @@ -484,7 +484,6 @@ 484 484 485 485 == 2.7 Calibration == 486 486 487 - 488 488 ((( 489 489 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). 490 490 ))) ... ... @@ -498,16 +498,21 @@ 498 498 499 499 (% style="color:#037691" %)**Calibration Payload** 500 500 501 -(% border="1" cellspacing=" 5" style="background-color:#ffffcc; color:green; width:500px" %)502 -|=(% style="width: 6 0px;" %)(((488 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %) 489 +|=(% style="width: 62.5px;" %)((( 503 503 **Size (bytes)** 504 -)))|=(% style="width: 100px;" %)**1**|=(% style="width:100px;" %)**1**|=(% style="width:100px;" %)**1**|=(% style="width:50px;" %)**7**|=(% style="width: 90px;" %)**1**491 +)))|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**7**|=(% style="width: 89px;" %)**1** 505 505 |**Value**|((( 506 -PH4 Calibrate value 493 +PH4 494 + 495 +Calibrate value 507 507 )))|PH6.86 Calibrate value|((( 508 -PH9.18 Calibrate value 497 +PH9.18 498 + 499 +Calibrate value 509 509 )))|Reserve|((( 510 510 [[Message Type>>||anchor="H2.3.6MessageType"]] 502 + 511 511 Always 0x03 512 512 ))) 513 513 ... ... @@ -523,16 +523,13 @@ 523 523 524 524 == 2.8 Frequency Plans == 525 525 526 - 527 527 ((( 528 528 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. 529 529 ))) 530 530 531 531 532 - 533 533 === 2.8.1 EU863-870 (EU868) === 534 534 535 - 536 536 ((( 537 537 (% style="color:blue" %)**Uplink:** 538 538 ))) ... ... @@ -593,7 +593,6 @@ 593 593 594 594 === 2.8.2 US902-928(US915) === 595 595 596 - 597 597 ((( 598 598 Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document. 599 599 ))) ... ... @@ -610,10 +610,8 @@ 610 610 * 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 611 612 612 613 - 614 614 === 2.8.3 CN470-510 (CN470) === 615 615 616 - 617 617 ((( 618 618 Used in China, Default use CHE=1 619 619 ))) ... ... @@ -702,7 +702,6 @@ 702 702 703 703 === 2.8.4 AU915-928(AU915) === 704 704 705 - 706 706 ((( 707 707 Frequency band as per definition in LoRaWAN 1.0.3 Regional document. 708 708 ))) ... ... @@ -723,10 +723,8 @@ 723 723 * 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 724 725 725 726 - 727 727 === 2.8.5 AS920-923 & AS923-925 (AS923) === 728 728 729 - 730 730 ((( 731 731 (% style="color:blue" %)**Default Uplink channel:** 732 732 ))) ... ... @@ -835,7 +835,6 @@ 835 835 836 836 === 2.8.6 KR920-923 (KR920) === 837 837 838 - 839 839 ((( 840 840 (% style="color:blue" %)**Default channel:** 841 841 ))) ... ... @@ -908,7 +908,6 @@ 908 908 909 909 === 2.8.7 IN865-867 (IN865) === 910 910 911 - 912 912 ((( 913 913 (% style="color:blue" %)**Uplink:** 914 914 ))) ... ... @@ -945,7 +945,6 @@ 945 945 946 946 == 2.9 LED Indicator == 947 947 948 - 949 949 The LSPH01 has an internal LED which is to show the status of different state. 950 950 951 951 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected. ... ... @@ -952,13 +952,14 @@ 952 952 * Blink once when device transmit a packet. 953 953 954 954 955 - 956 956 == 2.10 Firmware Change Log == 957 957 958 958 959 -**Firmware download link: [[https:~~/~~/www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0>>https://www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0]]938 +**Firmware download link:** 960 960 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/]] 961 961 942 + 962 962 **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]] 963 963 964 964 ... ... @@ -965,7 +965,6 @@ 965 965 966 966 = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink = 967 967 968 - 969 969 ((( 970 970 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 971 971 ))) ... ... @@ -1016,7 +1016,6 @@ 1016 1016 1017 1017 == 3.1 Set Transmit Interval Time == 1018 1018 1019 - 1020 1020 Feature: Change LoRaWAN End Node Transmit Interval. 1021 1021 1022 1022 (% style="color:#037691" %)**AT Command: AT+TDC** ... ... @@ -1043,13 +1043,11 @@ 1043 1043 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 1044 1044 1045 1045 1046 - 1047 1047 1048 1048 ))) 1049 1049 1050 1050 == 3.2 Set Interrupt Mode == 1051 1051 1052 - 1053 1053 Feature, Set Interrupt mode for GPIO_EXIT. 1054 1054 1055 1055 (% style="color:#037691" %)**AT Command: AT+INTMOD** ... ... @@ -1081,10 +1081,8 @@ 1081 1081 ))) 1082 1082 1083 1083 1084 - 1085 1085 == 3.3 Calibrate Sensor == 1086 1086 1087 - 1088 1088 Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands 1089 1089 1090 1090 ... ... @@ -1091,7 +1091,6 @@ 1091 1091 1092 1092 == 3.4 Get Firmware Version Info == 1093 1093 1094 - 1095 1095 Feature: use downlink to get firmware version. 1096 1096 1097 1097 (% style="color:#037691" %)**Downlink Command: 0x26** ... ... @@ -1111,9 +1111,11 @@ 1111 1111 )))|=**1**|=**1**|=**1**|=**1**|=**1**|=**5**|=**1** 1112 1112 |**Value**|Software Type|((( 1113 1113 Frequency 1088 + 1114 1114 Band 1115 1115 )))|Sub-band|((( 1116 1116 Firmware 1092 + 1117 1117 Version 1118 1118 )))|Sensor Type|Reserve|((( 1119 1119 [[Message Type>>||anchor="H2.3.6MessageType"]] ... ... @@ -1120,8 +1120,6 @@ 1120 1120 Always 0x02 1121 1121 ))) 1122 1122 1123 - 1124 - 1125 1125 (% style="color:#037691" %)**Software Type**(%%): Always 0x03 for LSPH01 1126 1126 1127 1127 ... ... @@ -1174,10 +1174,8 @@ 1174 1174 1175 1175 = 4. Battery & How to replace = 1176 1176 1177 - 1178 1178 == 4.1 Battery Type == 1179 1179 1180 - 1181 1181 ((( 1182 1182 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. 1183 1183 ))) ... ... @@ -1184,8 +1184,6 @@ 1184 1184 1185 1185 ((( 1186 1186 The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance. 1187 - 1188 - 1189 1189 ))) 1190 1190 1191 1191 [[image:1654593587246-335.png]] ... ... @@ -1199,7 +1199,6 @@ 1199 1199 1200 1200 == 4.2 Replace Battery == 1201 1201 1202 - 1203 1203 ((( 1204 1204 Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery. 1205 1205 ))) ... ... @@ -1212,7 +1212,6 @@ 1212 1212 1213 1213 == 4.3 Power Consumption Analyze == 1214 1214 1215 - 1216 1216 ((( 1217 1217 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. 1218 1218 ))) ... ... @@ -1256,7 +1256,6 @@ 1256 1256 1257 1257 === 4.3.1 Battery Note === 1258 1258 1259 - 1260 1260 ((( 1261 1261 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. 1262 1262 ))) ... ... @@ -1265,7 +1265,6 @@ 1265 1265 1266 1266 === 4.3.2 Replace the battery === 1267 1267 1268 - 1269 1269 ((( 1270 1270 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. 1271 1271 ))) ... ... @@ -1278,16 +1278,12 @@ 1278 1278 1279 1279 = 5. Use AT Command = 1280 1280 1281 - 1282 1282 == 5.1 Access AT Commands == 1283 1283 1284 - 1285 1285 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. 1286 1286 1287 - 1288 1288 [[image:1654593668970-604.png]] 1289 1289 1290 - 1291 1291 **Connection:** 1292 1292 1293 1293 (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND** ... ... @@ -1309,21 +1309,16 @@ 1309 1309 1310 1310 = 6. FAQ = 1311 1311 1312 - 1313 1313 == 6.1 How to change the LoRa Frequency Bands/Region == 1314 1314 1315 - 1316 1316 You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]]. 1317 1317 When downloading the images, choose the required image file for download. 1318 1318 1319 1319 1320 - 1321 1321 = 7. Trouble Shooting = 1322 1322 1323 - 1324 1324 == 7.1 AT Commands input doesn't work == 1325 1325 1326 - 1327 1327 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. 1328 1328 1329 1329 ... ... @@ -1330,7 +1330,6 @@ 1330 1330 1331 1331 = 8. Order Info = 1332 1332 1333 - 1334 1334 Part Number: (% style="color:blue" %)**LSPH01-XX** 1335 1335 1336 1336 ... ... @@ -1365,7 +1365,6 @@ 1365 1365 1366 1366 = 10. Support = 1367 1367 1368 - 1369 1369 * 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. 1370 1370 * 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]]. 1371 1371