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,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. ... ... @@ -72,8 +72,6 @@ 72 72 73 73 74 74 75 - 76 - 77 77 == 1.3 Probe Specification == 78 78 79 79 ... ... @@ -96,18 +96,15 @@ 96 96 97 97 98 98 99 - 100 - 101 101 == 1.4 Applications == 102 102 91 + 103 103 * Smart Agriculture 104 104 105 105 106 - 107 - 108 - 109 109 == 1.5 Pin mapping and power on == 110 110 97 + 111 111 [[image:1654592472094-134.png]] 112 112 113 113 ... ... @@ -114,19 +114,23 @@ 114 114 115 115 = 2. Configure LSPH01 to connect to LoRaWAN network = 116 116 104 + 117 117 == 2.1 How it works == 118 118 107 + 119 119 ((( 120 120 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. 121 121 ))) 122 122 123 123 ((( 124 -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.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. 125 125 ))) 126 126 127 127 117 + 128 128 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 129 129 120 + 130 130 ((( 131 131 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. 132 132 ))) ... ... @@ -192,6 +192,8 @@ 192 192 193 193 ((( 194 194 (% 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 + 195 195 ))) 196 196 197 197 [[image:1654592697690-910.png]] ... ... @@ -200,6 +200,7 @@ 200 200 201 201 == 2.3 Uplink Payload == 202 202 196 + 203 203 ((( 204 204 LSPH01 will uplink payload via LoRaWAN with below payload format: 205 205 ))) ... ... @@ -212,14 +212,11 @@ 212 212 Normal uplink payload: 213 213 ))) 214 214 215 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %) 216 -|=(% style="width: 62.5px;" %)((( 217 -**Size (bytes)** 218 -)))|=(% 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** 219 219 |(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)((( 220 -[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 221 - 222 -[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 213 +[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 223 223 )))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|((( 224 224 [[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]] 225 225 )))|Reserve|((( ... ... @@ -243,6 +243,7 @@ 243 243 244 244 === 2.3.2 DS18B20 Temperature sensor === 245 245 237 + 246 246 This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. 247 247 248 248 ... ... @@ -256,6 +256,7 @@ 256 256 257 257 === 2.3.3 Soil pH === 258 258 251 + 259 259 Range: 0 ~~ 14 pH 260 260 261 261 **Example:** ... ... @@ -266,6 +266,7 @@ 266 266 267 267 === 2.3.4 Soil Temperature === 268 268 262 + 269 269 Get Soil Temperature 270 270 271 271 ... ... @@ -279,6 +279,7 @@ 279 279 280 280 === 2.3.5 Interrupt Pin === 281 281 276 + 282 282 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. 283 283 284 284 ... ... @@ -292,6 +292,7 @@ 292 292 293 293 === 2.3.6 Message Type === 294 294 290 + 295 295 ((( 296 296 For a normal uplink payload, the message type is always 0x01. 297 297 ))) ... ... @@ -309,8 +309,6 @@ 309 309 310 310 311 311 312 - 313 - 314 314 === 2.3.7 Decode payload in The Things Network === 315 315 316 316 While using TTN network, you can add the payload format to decode the payload. ... ... @@ -323,7 +323,7 @@ 323 323 ))) 324 324 325 325 ((( 326 -LSPH01 TTN Payload Decoder: 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]] 327 327 ))) 328 328 329 329 ... ... @@ -330,6 +330,7 @@ 330 330 331 331 == 2.4 Uplink Interval == 332 332 327 + 333 333 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"]] 334 334 335 335 ... ... @@ -336,6 +336,7 @@ 336 336 337 337 == 2.5 Show Data in DataCake IoT Server == 338 338 334 + 339 339 ((( 340 340 [[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: 341 341 ))) ... ... @@ -378,7 +378,7 @@ 378 378 ))) 379 379 380 380 ((( 381 -Download Datacake decoder from: [[https:~~/~~/www.dr agino.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]] 382 382 ))) 383 383 384 384 ... ... @@ -399,8 +399,10 @@ 399 399 400 400 == 2.6 Installation and Maintain == 401 401 398 + 402 402 === 2.6.1 Before measurement === 403 403 401 + 404 404 ((( 405 405 ((( 406 406 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. ... ... @@ -418,6 +418,8 @@ 418 418 419 419 ((( 420 420 [[image:1654592946732-634.png]] 419 + 420 + 421 421 ))) 422 422 423 423 ((( ... ... @@ -429,7 +429,7 @@ 429 429 ))) 430 430 431 431 ((( 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.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. 433 433 ))) 434 434 435 435 ((( ... ... @@ -456,6 +456,7 @@ 456 456 457 457 === 2.6.3 Maintain Probe === 458 458 459 + 459 459 1. ((( 460 460 pH probe electrode is fragile and no strong. User must avoid strong force or hitting it. 461 461 ))) ... ... @@ -480,6 +480,7 @@ 480 480 481 481 == 2.7 Calibration == 482 482 484 + 483 483 ((( 484 484 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). 485 485 ))) ... ... @@ -519,15 +519,19 @@ 519 519 * Reply to the confirmation package: 14 01 520 520 * Reply to non-confirmed packet: 14 00 521 521 524 + 522 522 == 2.8 Frequency Plans == 523 523 527 + 524 524 ((( 525 525 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. 526 526 ))) 527 527 528 528 533 + 529 529 === 2.8.1 EU863-870 (EU868) === 530 530 536 + 531 531 ((( 532 532 (% style="color:blue" %)**Uplink:** 533 533 ))) ... ... @@ -588,6 +588,7 @@ 588 588 589 589 === 2.8.2 US902-928(US915) === 590 590 597 + 591 591 ((( 592 592 Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document. 593 593 ))) ... ... @@ -601,14 +601,13 @@ 601 601 ))) 602 602 603 603 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 604 -* 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) 605 605 606 606 607 607 608 - 609 - 610 610 === 2.8.3 CN470-510 (CN470) === 611 611 617 + 612 612 ((( 613 613 Used in China, Default use CHE=1 614 614 ))) ... ... @@ -697,6 +697,7 @@ 697 697 698 698 === 2.8.4 AU915-928(AU915) === 699 699 706 + 700 700 ((( 701 701 Frequency band as per definition in LoRaWAN 1.0.3 Regional document. 702 702 ))) ... ... @@ -714,14 +714,13 @@ 714 714 ))) 715 715 716 716 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 717 -* 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) 718 718 719 719 720 720 721 - 722 - 723 723 === 2.8.5 AS920-923 & AS923-925 (AS923) === 724 724 730 + 725 725 ((( 726 726 (% style="color:blue" %)**Default Uplink channel:** 727 727 ))) ... ... @@ -830,6 +830,7 @@ 830 830 831 831 === 2.8.6 KR920-923 (KR920) === 832 832 839 + 833 833 ((( 834 834 (% style="color:blue" %)**Default channel:** 835 835 ))) ... ... @@ -902,6 +902,7 @@ 902 902 903 903 === 2.8.7 IN865-867 (IN865) === 904 904 912 + 905 905 ((( 906 906 (% style="color:blue" %)**Uplink:** 907 907 ))) ... ... @@ -938,6 +938,7 @@ 938 938 939 939 == 2.9 LED Indicator == 940 940 949 + 941 941 The LSPH01 has an internal LED which is to show the status of different state. 942 942 943 943 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected. ... ... @@ -945,16 +945,12 @@ 945 945 946 946 947 947 948 - 949 - 950 950 == 2.10 Firmware Change Log == 951 951 952 952 953 -**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]] 954 954 955 -[[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/]] 956 956 957 - 958 958 **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]] 959 959 960 960 ... ... @@ -961,6 +961,7 @@ 961 961 962 962 = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink = 963 963 969 + 964 964 ((( 965 965 Use can configure LSPH01 via AT Command or LoRaWAN Downlink. 966 966 ))) ... ... @@ -992,7 +992,7 @@ 992 992 ))) 993 993 994 994 ((( 995 -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/]] 996 996 ))) 997 997 998 998 ((( ... ... @@ -1011,6 +1011,7 @@ 1011 1011 1012 1012 == 3.1 Set Transmit Interval Time == 1013 1013 1020 + 1014 1014 Feature: Change LoRaWAN End Node Transmit Interval. 1015 1015 1016 1016 (% style="color:#037691" %)**AT Command: AT+TDC** ... ... @@ -1037,11 +1037,13 @@ 1037 1037 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 1038 1038 1039 1039 1047 + 1040 1040 1041 1041 ))) 1042 1042 1043 1043 == 3.2 Set Interrupt Mode == 1044 1044 1053 + 1045 1045 Feature, Set Interrupt mode for GPIO_EXIT. 1046 1046 1047 1047 (% style="color:#037691" %)**AT Command: AT+INTMOD** ... ... @@ -1076,6 +1076,7 @@ 1076 1076 1077 1077 == 3.3 Calibrate Sensor == 1078 1078 1088 + 1079 1079 Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands 1080 1080 1081 1081 ... ... @@ -1082,6 +1082,7 @@ 1082 1082 1083 1083 == 3.4 Get Firmware Version Info == 1084 1084 1095 + 1085 1085 Feature: use downlink to get firmware version. 1086 1086 1087 1087 (% style="color:#037691" %)**Downlink Command: 0x26** ... ... @@ -1164,8 +1164,10 @@ 1164 1164 1165 1165 = 4. Battery & How to replace = 1166 1166 1178 + 1167 1167 == 4.1 Battery Type == 1168 1168 1181 + 1169 1169 ((( 1170 1170 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. 1171 1171 ))) ... ... @@ -1172,6 +1172,8 @@ 1172 1172 1173 1173 ((( 1174 1174 The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance. 1188 + 1189 + 1175 1175 ))) 1176 1176 1177 1177 [[image:1654593587246-335.png]] ... ... @@ -1185,6 +1185,7 @@ 1185 1185 1186 1186 == 4.2 Replace Battery == 1187 1187 1203 + 1188 1188 ((( 1189 1189 Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery. 1190 1190 ))) ... ... @@ -1197,6 +1197,7 @@ 1197 1197 1198 1198 == 4.3 Power Consumption Analyze == 1199 1199 1216 + 1200 1200 ((( 1201 1201 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. 1202 1202 ))) ... ... @@ -1206,7 +1206,7 @@ 1206 1206 ))) 1207 1207 1208 1208 1209 -(% style="color: red" %)**Step 1**(%%): Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:1226 +(% style="color:#037691" %)**Step 1**(%%): Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: 1210 1210 1211 1211 [[https:~~/~~/www.dragino.com/downloads/index.pHp?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]] 1212 1212 ... ... @@ -1240,6 +1240,7 @@ 1240 1240 1241 1241 === 4.3.1 Battery Note === 1242 1242 1260 + 1243 1243 ((( 1244 1244 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. 1245 1245 ))) ... ... @@ -1248,12 +1248,13 @@ 1248 1248 1249 1249 === 4.3.2 Replace the battery === 1250 1250 1269 + 1251 1251 ((( 1252 1252 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. 1253 1253 ))) 1254 1254 1255 1255 ((( 1256 -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) 1257 1257 ))) 1258 1258 1259 1259 ... ... @@ -1260,12 +1260,16 @@ 1260 1260 1261 1261 = 5. Use AT Command = 1262 1262 1282 + 1263 1263 == 5.1 Access AT Commands == 1264 1264 1285 + 1265 1265 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. 1266 1266 1288 + 1267 1267 [[image:1654593668970-604.png]] 1268 1268 1291 + 1269 1269 **Connection:** 1270 1270 1271 1271 (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND** ... ... @@ -1287,16 +1287,21 @@ 1287 1287 1288 1288 = 6. FAQ = 1289 1289 1313 + 1290 1290 == 6.1 How to change the LoRa Frequency Bands/Region == 1291 1291 1316 + 1292 1292 You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]]. 1293 1293 When downloading the images, choose the required image file for download. 1294 1294 1295 1295 1321 + 1296 1296 = 7. Trouble Shooting = 1297 1297 1324 + 1298 1298 == 7.1 AT Commands input doesn't work == 1299 1299 1327 + 1300 1300 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. 1301 1301 1302 1302 ... ... @@ -1303,6 +1303,7 @@ 1303 1303 1304 1304 = 8. Order Info = 1305 1305 1334 + 1306 1306 Part Number: (% style="color:blue" %)**LSPH01-XX** 1307 1307 1308 1308 ... ... @@ -1318,7 +1318,6 @@ 1318 1318 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 1319 1319 1320 1320 1321 - 1322 1322 = 9. Packing Info = 1323 1323 1324 1324 ... ... @@ -1334,9 +1334,9 @@ 1334 1334 * Weight / pcs : g 1335 1335 1336 1336 1337 - 1338 1338 = 10. Support = 1339 1339 1367 + 1340 1340 * 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. 1341 1341 * 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]]. 1342 1342