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,12 +18,9 @@ 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 29 ((( ... ... @@ -53,9 +53,9 @@ 53 53 54 54 55 55 56 - 57 57 == 1.2 Features == 58 58 51 + 59 59 * LoRaWAN 1.0.3 Class A 60 60 * Ultra-low power consumption 61 61 * Monitor soil pH with temperature compensation. ... ... @@ -70,6 +70,9 @@ 70 70 * IP68 rate for the Sensor Probe 71 71 * 8500mAh Battery for long term use 72 72 66 + 67 + 68 + 73 73 == 1.3 Probe Specification == 74 74 75 75 ... ... @@ -90,12 +90,19 @@ 90 90 * IP68 Protection 91 91 * Length: 3.5 meters 92 92 89 + 90 + 91 + 93 93 == 1.4 Applications == 94 94 94 + 95 95 * Smart Agriculture 96 96 97 + 98 + 97 97 == 1.5 Pin mapping and power on == 98 98 101 + 99 99 [[image:1654592472094-134.png]] 100 100 101 101 ... ... @@ -102,19 +102,23 @@ 102 102 103 103 = 2. Configure LSPH01 to connect to LoRaWAN network = 104 104 108 + 105 105 == 2.1 How it works == 106 106 111 + 107 107 ((( 108 108 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. 109 109 ))) 110 110 111 111 ((( 112 -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.117 +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 113 ))) 114 114 115 115 121 + 116 116 == 2.2 Quick guide to connect to LoRaWAN server (OTAA) == 117 117 124 + 118 118 ((( 119 119 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. 120 120 ))) ... ... @@ -180,6 +180,8 @@ 180 180 181 181 ((( 182 182 (% 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. 190 + 191 + 183 183 ))) 184 184 185 185 [[image:1654592697690-910.png]] ... ... @@ -188,6 +188,7 @@ 188 188 189 189 == 2.3 Uplink Payload == 190 190 200 + 191 191 ((( 192 192 LSPH01 will uplink payload via LoRaWAN with below payload format: 193 193 ))) ... ... @@ -231,6 +231,7 @@ 231 231 232 232 === 2.3.2 DS18B20 Temperature sensor === 233 233 244 + 234 234 This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. 235 235 236 236 ... ... @@ -244,6 +244,7 @@ 244 244 245 245 === 2.3.3 Soil pH === 246 246 258 + 247 247 Range: 0 ~~ 14 pH 248 248 249 249 **Example:** ... ... @@ -254,6 +254,7 @@ 254 254 255 255 === 2.3.4 Soil Temperature === 256 256 269 + 257 257 Get Soil Temperature 258 258 259 259 ... ... @@ -267,6 +267,7 @@ 267 267 268 268 === 2.3.5 Interrupt Pin === 269 269 283 + 270 270 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. 271 271 272 272 ... ... @@ -280,6 +280,7 @@ 280 280 281 281 === 2.3.6 Message Type === 282 282 297 + 283 283 ((( 284 284 For a normal uplink payload, the message type is always 0x01. 285 285 ))) ... ... @@ -295,6 +295,9 @@ 295 295 |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]] 296 296 |(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]] 297 297 313 + 314 + 315 + 298 298 === 2.3.7 Decode payload in The Things Network === 299 299 300 300 While using TTN network, you can add the payload format to decode the payload. ... ... @@ -307,7 +307,7 @@ 307 307 ))) 308 308 309 309 ((( 310 -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/]]328 +LSPH01 TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]] 311 311 ))) 312 312 313 313 ... ... @@ -314,6 +314,7 @@ 314 314 315 315 == 2.4 Uplink Interval == 316 316 335 + 317 317 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"]] 318 318 319 319 ... ... @@ -320,6 +320,7 @@ 320 320 321 321 == 2.5 Show Data in DataCake IoT Server == 322 322 342 + 323 323 ((( 324 324 [[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: 325 325 ))) ... ... @@ -362,7 +362,7 @@ 362 362 ))) 363 363 364 364 ((( 365 -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/]]385 +Download Datacake decoder from: [[https:~~/~~/www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>url:https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]] 366 366 ))) 367 367 368 368 ... ... @@ -383,8 +383,10 @@ 383 383 384 384 == 2.6 Installation and Maintain == 385 385 406 + 386 386 === 2.6.1 Before measurement === 387 387 409 + 388 388 ((( 389 389 ((( 390 390 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. ... ... @@ -402,6 +402,8 @@ 402 402 403 403 ((( 404 404 [[image:1654592946732-634.png]] 427 + 428 + 405 405 ))) 406 406 407 407 ((( ... ... @@ -413,7 +413,7 @@ 413 413 ))) 414 414 415 415 ((( 416 -Slowly insert the probe to the measure point. Don ’t use large force which will break the probe. Make sure not shake when inserting.440 +Slowly insert the probe to the measure point. Don't use large force which will break the probe. Make sure not shake when inserting. 417 417 ))) 418 418 419 419 ((( ... ... @@ -440,6 +440,7 @@ 440 440 441 441 === 2.6.3 Maintain Probe === 442 442 467 + 443 443 1. ((( 444 444 pH probe electrode is fragile and no strong. User must avoid strong force or hitting it. 445 445 ))) ... ... @@ -464,6 +464,7 @@ 464 464 465 465 == 2.7 Calibration == 466 466 492 + 467 467 ((( 468 468 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). 469 469 ))) ... ... @@ -504,15 +504,19 @@ 504 504 * Reply to non-confirmed packet: 14 00 505 505 506 506 533 + 507 507 == 2.8 Frequency Plans == 508 508 536 + 509 509 ((( 510 510 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. 511 511 ))) 512 512 513 513 542 + 514 514 === 2.8.1 EU863-870 (EU868) === 515 515 545 + 516 516 ((( 517 517 (% style="color:blue" %)**Uplink:** 518 518 ))) ... ... @@ -573,6 +573,7 @@ 573 573 574 574 === 2.8.2 US902-928(US915) === 575 575 606 + 576 576 ((( 577 577 Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document. 578 578 ))) ... ... @@ -586,15 +586,14 @@ 586 586 ))) 587 587 588 588 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 589 -* 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)620 +* 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) 590 590 591 591 592 592 593 593 594 - 595 - 596 596 === 2.8.3 CN470-510 (CN470) === 597 597 627 + 598 598 ((( 599 599 Used in China, Default use CHE=1 600 600 ))) ... ... @@ -683,6 +683,7 @@ 683 683 684 684 === 2.8.4 AU915-928(AU915) === 685 685 716 + 686 686 ((( 687 687 Frequency band as per definition in LoRaWAN 1.0.3 Regional document. 688 688 ))) ... ... @@ -700,15 +700,14 @@ 700 700 ))) 701 701 702 702 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band 703 -* 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)734 +* 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) 704 704 705 705 706 706 707 707 708 - 709 - 710 710 === 2.8.5 AS920-923 & AS923-925 (AS923) === 711 711 741 + 712 712 ((( 713 713 (% style="color:blue" %)**Default Uplink channel:** 714 714 ))) ... ... @@ -817,6 +817,7 @@ 817 817 818 818 === 2.8.6 KR920-923 (KR920) === 819 819 850 + 820 820 ((( 821 821 (% style="color:blue" %)**Default channel:** 822 822 ))) ... ... @@ -889,6 +889,7 @@ 889 889 890 890 === 2.8.7 IN865-867 (IN865) === 891 891 923 + 892 892 ((( 893 893 (% style="color:blue" %)**Uplink:** 894 894 ))) ... ... @@ -925,6 +925,7 @@ 925 925 926 926 == 2.9 LED Indicator == 927 927 960 + 928 928 The LSPH01 has an internal LED which is to show the status of different state. 929 929 930 930 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected. ... ... @@ -933,16 +933,12 @@ 933 933 934 934 935 935 936 - 937 - 938 938 == 2.10 Firmware Change Log == 939 939 940 940 941 -**Firmware download link:** 972 +**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 981 + 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/]] 1013 +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 1032 + 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 1059 + 1028 1028 1029 1029 ))) 1030 1030 1031 1031 == 3.2 Set Interrupt Mode == 1032 1032 1065 + 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 1100 + 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 1107 + 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 1190 + 1155 1155 == 4.1 Battery Type == 1156 1156 1193 + 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. 1200 + 1201 + 1163 1163 ))) 1164 1164 1165 1165 [[image:1654593587246-335.png]] ... ... @@ -1173,6 +1173,7 @@ 1173 1173 1174 1174 == 4.2 Replace Battery == 1175 1175 1215 + 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 1228 + 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 1272 + 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 1281 + 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)1287 +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 1294 + 1251 1251 == 5.1 Access AT Commands == 1252 1252 1297 + 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 1300 + 1255 1255 [[image:1654593668970-604.png]] 1256 1256 1303 + 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 1325 + 1278 1278 == 6.1 How to change the LoRa Frequency Bands/Region == 1279 1279 1328 + 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 1333 + 1284 1284 = 7. Trouble Shooting = 1285 1285 1336 + 1286 1286 == 7.1 AT Commands input doesn't work == 1287 1287 1339 + 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 1346 + 1294 1294 Part Number: (% style="color:blue" %)**LSPH01-XX** 1295 1295 1296 1296 ... ... @@ -1307,7 +1307,6 @@ 1307 1307 1308 1308 1309 1309 1310 - 1311 1311 = 9. Packing Info = 1312 1312 1313 1313 ... ... @@ -1324,10 +1324,11 @@ 1324 1324 1325 1325 1326 1326 1327 - 1328 1328 = 10. Support = 1329 1329 1381 + 1330 1330 * 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. 1331 1331 * 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]]. 1332 1332 1385 + 1333 1333