Last modified by Xiaoling on 2025/04/25 14:08
<
From version < 98.12 >
edited by Xiaoling
on 2022/10/13 17:14
To version < 105.1 >
edited by Bei Jinggeng
on 2024/08/02 16:39
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -LSPH01-LoRaWAN Soil pH Sensor User Manual
1 +LSPH01 -- LoRaWAN Soil pH Sensor User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.Bei
Content
... ... @@ -5,6 +5,10 @@
5 5  
6 6  
7 7  
8 +
9 +
10 +
11 +
8 8  **Table of Contents:**
9 9  
10 10  {{toc/}}
... ... @@ -16,17 +16,15 @@
16 16  
17 17  = 1. Introduction =
18 18  
19 -
20 20  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
21 21  
22 -(((
23 -
24 24  
25 -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.
26 +(((
27 +The Dragino LSPH01 is a (% style="color:blue" %)**LoRaWAN Soil pH Sensor**(%%) for IoT of Agriculture. It is designed to measure the (% style="color:blue" %)**soil PH and soil temperature**(%%), so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof.
26 26  )))
27 27  
28 28  (((
29 -LSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** (% style="color:#4f81bd" %)pH (%%)**with high accuracy and stable value. The LSPH01 probe can be buried into soil for long time use.
31 +LSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect (% style="color:blue" %)**soil's pH **(%%)with high accuracy and stable value. The LSPH01 probe can be buried into soil for long time use.
30 30  )))
31 31  
32 32  (((
... ... @@ -34,7 +34,7 @@
34 34  )))
35 35  
36 36  (((
37 -LSPH01 is powered by (% style="color:#4f81bd" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
39 +LSPH01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
38 38  )))
39 39  
40 40  (((
... ... @@ -45,7 +45,6 @@
45 45  [[image:1654592435432-887.png]]
46 46  
47 47  
48 -
49 49  == ​1.2 Features ==
50 50  
51 51  
... ... @@ -63,9 +63,6 @@
63 63  * IP68 rate for the Sensor Probe
64 64  * 8500mAh Battery for long term use
65 65  
66 -
67 -
68 -
69 69  == 1.3 Probe Specification ==
70 70  
71 71  
... ... @@ -86,16 +86,11 @@
86 86  * IP68 Protection
87 87  * Length: 3.5 meters
88 88  
89 -
90 -
91 -
92 92  == 1.4 ​Applications ==
93 93  
94 94  
95 95  * Smart Agriculture
96 96  
97 -
98 -
99 99  == 1.5 Pin mapping and power on ==
100 100  
101 101  
... ... @@ -102,10 +102,8 @@
102 102  [[image:1654592472094-134.png]]
103 103  
104 104  
105 -
106 106  = 2. Configure LSPH01 to connect to LoRaWAN network =
107 107  
108 -
109 109  == 2.1 How it works ==
110 110  
111 111  
... ... @@ -118,7 +118,6 @@
118 118  )))
119 119  
120 120  
121 -
122 122  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
123 123  
124 124  
... ... @@ -146,10 +146,10 @@
146 146  Each LSPH01 is shipped with a sticker with the default device EUI as below:
147 147  )))
148 148  
149 -[[image:image-20220607170145-1.jpeg]]
139 +[[image:image-20230426084737-1.png||height="246" width="530"]](% style="display:none" %)
150 150  
141 +(% style="display:none" %) (%%)
151 151  
152 -
153 153  You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
154 154  
155 155  
... ... @@ -194,7 +194,6 @@
194 194  [[image:1654592697690-910.png]]
195 195  
196 196  
197 -
198 198  == 2.3 ​Uplink Payload ==
199 199  
200 200  
... ... @@ -210,14 +210,12 @@
210 210  Normal uplink payload:
211 211  )))
212 212  
213 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
214 -|=(% style="width: 62.5px;" %)(((
215 -**Size (bytes)**
216 -)))|=(% style="width: 62.5px;" %)**2**|=(% style="width: 62.5px;" %)**2**|=**2**|=**2**|=**1**|=**1**|=**1**
217 -|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
218 -[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
219 -
220 -[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
202 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:470px" %)
203 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
204 +**Size(bytes)**
205 +)))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**1**
206 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
207 +[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
221 221  )))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
222 222  [[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
223 223  )))|Reserve|(((
... ... @@ -227,7 +227,6 @@
227 227  [[image:1654592721645-318.png]]
228 228  
229 229  
230 -
231 231  === 2.3.1 Battery Info ===
232 232  
233 233  
... ... @@ -238,7 +238,6 @@
238 238  Ex2: 0x0B49 = 2889mV
239 239  
240 240  
241 -
242 242  === 2.3.2 DS18B20 Temperature sensor ===
243 243  
244 244  
... ... @@ -252,7 +252,6 @@
252 252  If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
253 253  
254 254  
255 -
256 256  === 2.3.3 Soil pH ===
257 257  
258 258  
... ... @@ -263,7 +263,6 @@
263 263  (% style="color:#037691" %)** 0x02B7(H) = 695(D) = 6.95pH**
264 264  
265 265  
266 -
267 267  === 2.3.4 Soil Temperature ===
268 268  
269 269  
... ... @@ -277,7 +277,6 @@
277 277  If payload is: **FF3FH** :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
278 278  
279 279  
280 -
281 281  === 2.3.5 Interrupt Pin ===
282 282  
283 283  
... ... @@ -291,7 +291,6 @@
291 291  0x01: Interrupt Uplink Packet.
292 292  
293 293  
294 -
295 295  === 2.3.6 Message Type ===
296 296  
297 297  
... ... @@ -304,17 +304,15 @@
304 304  )))
305 305  
306 306  
307 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:499px" %)
308 -|=(% style="width: 160px;" %)**Message Type Code**|=(% style="width: 163px;" %)**Description**|=(% style="width: 173px;" %)**Payload**
288 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:496px" %)
289 +|=(% style="width: 160px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 163px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 173px;background-color:#4F81BD;color:white" %)**Payload**
309 309  |(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
310 310  |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
311 311  |(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
312 312  
313 -
314 -
315 -
316 316  === 2.3.7 Decode payload in The Things Network ===
317 317  
296 +
318 318  While using TTN network, you can add the payload format to decode the payload.
319 319  
320 320  
... ... @@ -329,7 +329,6 @@
329 329  )))
330 330  
331 331  
332 -
333 333  == 2.4 Uplink Interval ==
334 334  
335 335  
... ... @@ -336,7 +336,6 @@
336 336  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"]]
337 337  
338 338  
339 -
340 340  == 2.5 ​Show Data in DataCake IoT Server ==
341 341  
342 342  
... ... @@ -370,7 +370,6 @@
370 370  [[image:1654592819047-535.png]]
371 371  
372 372  
373 -
374 374  [[image:1654592833877-762.png]]
375 375  
376 376  
... ... @@ -400,32 +400,25 @@
400 400  [[image:1654592917530-261.png]]
401 401  
402 402  
403 -
404 404  == 2.6 Installation and Maintain ==
405 405  
406 -
407 407  === 2.6.1 Before measurement ===
408 408  
409 409  
410 410  (((
411 -(((
412 412  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. 
413 413  )))
414 -)))
415 415  
416 416  
417 -
418 418  === 2.6.2 Measurement ===
419 419  
420 420  
421 421  (((
422 -(% style="color:#4f81bd" %)**Measurement the soil surface:**
393 +(% style="color:blue" %)**Measurement the soil surface:**
423 423  )))
424 424  
425 425  (((
426 426  [[image:1654592946732-634.png]]
427 -
428 -
429 429  )))
430 430  
431 431  (((
... ... @@ -449,7 +449,7 @@
449 449  )))
450 450  
451 451  (((
452 -(% style="color:#4f81bd" %)**Measurement inside soil:**
421 +(% style="color:blue" %)**Measurement inside soil:**
453 453  )))
454 454  
455 455  (((
... ... @@ -461,28 +461,31 @@
461 461  )))
462 462  
463 463  
464 -
465 465  === 2.6.3 Maintain Probe ===
466 466  
467 467  
468 -1. (((
469 -pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
436 +(((
437 +~1. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
470 470  )))
471 -1. (((
472 -After long time use (3~~ 6  months). The probe electrode needs to be clean; user can use high grade sandpaper to polish it or put in 5% hydrochloric acid for several minutes. After the metal probe looks like new, user can use pure water to wash it.
439 +
440 +(((
441 +2. After long time use (3~~ 6  months). The probe electrode needs to be clean; user can use high grade sandpaper to polish it or put in 5% hydrochloric acid for several minutes. After the metal probe looks like new, user can use pure water to wash it.
473 473  )))
474 -1. (((
475 -Probe reference electrode is also no strong, need to avoid strong force or hitting.
443 +
444 +(((
445 +3. Probe reference electrode is also no strong, need to avoid strong force or hitting.
476 476  )))
477 -1. (((
478 -User should keep reference electrode wet while not use.
447 +
448 +(((
449 +4. User should keep reference electrode wet while not use.
479 479  )))
480 -1. (((
481 -Avoid the probes to touch oily matter. Which will cause issue in accuracy.
451 +
452 +(((
453 +5. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
482 482  )))
483 -1. (((
484 -The probe is IP68 can be put in water.
485 485  
456 +(((
457 +6. The probe is IP68 can be put in water.
486 486  
487 487  
488 488  )))
... ... @@ -490,47 +490,95 @@
490 490  == 2.7 Calibration ==
491 491  
492 492  
465 +(% style="color:blue" %)**Step1 :**(%%)** Clean probe**
466 +
467 +user can use high grade sandpaper to polish it or put in 5% hydrochloric acid for several minutes. After the metal probe looks new, users can clean it to remove hydrochloric acid or other liquids from the surface.
468 +
469 +(% style="color:blue" %)**Step2 :**(%%)** Immerse the sensor in ph buffer solution to make the sensor values stable**
470 +
493 493  (((
494 494  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 +
474 +(% style="color:red" %)**Note: Only one ph buffer with one of the ph values needs to be calibrated during calibration. Wait for the sensor measurement value to be stable, it does not need to be the same as the ph marked by the ph buffer**
475 +
476 +
477 +(% style="color:blue" %)**Step3 :**(%%)** The numerically stable sensors were calibrated using commands**
495 495  )))
496 496  
497 497  (((
498 -After stable, user can use below command to calibrate.
481 + User can use below command to calibrate.
482 +
483 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
484 +|(% style="background-color:#4f81bd; color:white; width:120px" %)**pH buffer solution**|(% style="background-color:#4f81bd; color:white; width:150px" %)**AT Command to calibrate**|(% style="background-color:#4f81bd; color:white; width:145px" %)**Downlink Command**|(% style="background-color:#4f81bd; color:white; width:95px" %)**Read Cal Value**
485 +|(% style="width:149px" %)4.00|(% style="width:197px" %)AT+PHCAL=4|(% style="width:206px" %)(((
486 +0x13 04
487 +Reply with Calibrate payload
488 +)))|(% style="width:136px" %)(((
489 +AT+PHCAL=?
490 +Example 41,61,91
499 499  )))
492 +|(% style="width:149px" %)6.86|(% style="width:197px" %)AT+PHCAL=6|(% style="width:206px" %)(((
493 +0x13 06
494 +Reply with Calibrate payload
495 +)))|(% style="width:136px" %)AT+PHCAL=?
496 +|(% style="width:149px" %)9.18|(% style="width:197px" %)AT+PHCAL=9|(% style="width:206px" %)(((
497 +0x13 09
498 +Reply with Calibrate payload
499 +)))|(% style="width:136px" %)AT+PHCAL=?
500 +|(% style="width:149px" %)Factory Default|(% style="width:197px" %)AT+PHCAL=15|(% style="width:206px" %)(((
501 +0x13 15
502 +Reply with Calibrate payload
503 +)))|(% style="width:136px" %)(((
504 +AT+PHCAL=?
505 +Example 151
506 +)))
507 +)))
500 500  
501 -[[image:image-20220607171149-4.png]]
509 +To use the AT COMMAND, refer to this link:
502 502  
511 +* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
503 503  
504 -(% style="color:#037691" %)**Calibration Payload**
513 +* AT Command via UART Connection : See [[UART Connection>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
505 505  
506 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
507 -|=(% style="width: 62.5px;" %)(((
508 -**Size (bytes)**
509 -)))|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**1**|=(% style="width: 89px;" %)**7**|=(% style="width: 89px;" %)**1**
510 -|**Value**|(((
511 -PH4
515 +To use Downlink, take TTN as an example, please refer to this link:
512 512  
513 -Calibrate value
514 -)))|PH6.86 Calibrate value|(((
515 -PH9.18
517 +* LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>url:http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
516 516  
517 -Calibrate value
519 +When the command is successfully used, the node sends a uplink.
520 +This is the payload for uplink
521 +
522 +(% style="color:#037691" %)**Calibration Payload**
523 +
524 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:500px" %)
525 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
526 +**Size(bytes)**
527 +)))|=(% style="width: 100px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 100px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 100px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**7**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**1**
528 +|Value|(((
529 +PH4 Calibrate value
530 +)))|PH6.86 Calibrate value|(((
531 +PH9.18 Calibrate value
518 518  )))|Reserve|(((
519 519  [[Message Type>>||anchor="H2.3.6MessageType"]]
520 -
521 521  Always 0x03
522 522  )))
523 523  
524 524  User can also send 0x14 downlink command to poll the current calibration payload.
525 525  
526 -[[image:image-20220607171416-7.jpeg]]
539 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:480px" %)
540 +|=(% style="width: 183px; background-color:#4F81BD;color:white" %)**Downlink Control Type**|=(% style="width: 55px; background-color:#4F81BD;color:white" %)FPort|=(% style="width: 93px; background-color:#4F81BD;color:white" %)**Type Code**|=(% style="width: 149px; background-color:#4F81BD;color:white" %)**Downlink payload size(bytes)**
541 +|(% style="width:183px" %)Get Calibration Version Info|(% style="width:55px" %)Any|(% style="width:93px" %)14|(% style="width:146px" %)2
527 527  
528 -
529 529  * Reply to the confirmation package: 14 01
544 +
530 530  * Reply to non-confirmed packet: 14 00
531 531  
547 +(% style="color:blue" %)**Step4 : **(%%)**After the calibration is completed, its measurement results in this ph buffer solution should be consistent with the numerical value of the command used in the calibration.**
532 532  
549 +Examples:
550 +After using the command AT+PH=9 in 9.18ph buffer
551 +The readout returned by the sensor in 9.18ph buffer should be pH=9
533 533  
553 +
534 534  == 2.8 Frequency Plans ==
535 535  
536 536  
... ... @@ -539,7 +539,6 @@
539 539  )))
540 540  
541 541  
542 -
543 543  === 2.8.1 EU863-870 (EU868) ===
544 544  
545 545  
... ... @@ -600,7 +600,6 @@
600 600  )))
601 601  
602 602  
603 -
604 604  === 2.8.2 US902-928(US915) ===
605 605  
606 606  
... ... @@ -617,11 +617,9 @@
617 617  )))
618 618  
619 619  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
638 +
620 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)
621 621  
622 -
623 -
624 -
625 625  === 2.8.3 CN470-510 (CN470) ===
626 626  
627 627  
... ... @@ -710,7 +710,6 @@
710 710  )))
711 711  
712 712  
713 -
714 714  === 2.8.4 AU915-928(AU915) ===
715 715  
716 716  
... ... @@ -731,11 +731,9 @@
731 731  )))
732 732  
733 733  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
749 +
734 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)
735 735  
736 -
737 -
738 -
739 739  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
740 740  
741 741  
... ... @@ -844,7 +844,6 @@
844 844  )))
845 845  
846 846  
847 -
848 848  === 2.8.6 KR920-923 (KR920) ===
849 849  
850 850  
... ... @@ -864,9 +864,6 @@
864 864  922.5 - SF7BW125 to SF12BW125
865 865  )))
866 866  
867 -(((
868 -
869 -)))
870 870  
871 871  (((
872 872  (% style="color:blue" %)**Uplink: (OTAA mode, channel added by JoinAccept message)**
... ... @@ -900,9 +900,6 @@
900 900  923.3 - SF7BW125 to SF12BW125
901 901  )))
902 902  
903 -(((
904 -
905 -)))
906 906  
907 907  (((
908 908  (% style="color:blue" %)**Downlink:**
... ... @@ -917,7 +917,6 @@
917 917  )))
918 918  
919 919  
920 -
921 921  === 2.8.7 IN865-867 (IN865) ===
922 922  
923 923  
... ... @@ -937,9 +937,6 @@
937 937  865.9850 - SF7BW125 to SF12BW125
938 938  )))
939 939  
940 -(((
941 -
942 -)))
943 943  
944 944  (((
945 945  (% style="color:blue" %)**Downlink:**
... ... @@ -954,7 +954,6 @@
954 954  )))
955 955  
956 956  
957 -
958 958  == 2.9 LED Indicator ==
959 959  
960 960  
... ... @@ -961,21 +961,17 @@
961 961  The LSPH01 has an internal LED which is to show the status of different state.
962 962  
963 963  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
965 +
964 964  * Blink once when device transmit a packet.
965 965  
966 -
967 -
968 -
969 969  == 2.10 ​Firmware Change Log ==
970 970  
971 971  
972 972  **Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0>>https://www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0]]
973 973  
974 -
975 975  **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
976 976  
977 977  
978 -
979 979  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
980 980  
981 981  
... ... @@ -1013,9 +1013,6 @@
1013 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/]]
1014 1014  )))
1015 1015  
1016 -(((
1017 -
1018 -)))
1019 1019  
1020 1020  * (((
1021 1021  (% style="color:#4f81bd" %)** Commands special design for LSPH01**
... ... @@ -1026,7 +1026,6 @@
1026 1026  )))
1027 1027  
1028 1028  
1029 -
1030 1030  == 3.1 Set Transmit Interval Time ==
1031 1031  
1032 1032  
... ... @@ -1034,9 +1034,18 @@
1034 1034  
1035 1035  (% style="color:#037691" %)**AT Command: AT+TDC**
1036 1036  
1037 -[[image:image-20220607171554-8.png]]
1030 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1031 +|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
1032 +|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
1033 +30000
1034 +OK
1035 +the interval is 30000ms = 30s
1036 +)))
1037 +|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
1038 +OK
1039 +Set transmit interval to 60000ms = 60 seconds​
1040 +)))
1038 1038  
1039 -
1040 1040  (((
1041 1041  (% style="color:#037691" %)**Downlink Command: 0x01**
1042 1042  )))
... ... @@ -1046,17 +1046,16 @@
1046 1046  )))
1047 1047  
1048 1048  (((
1049 -If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
1051 +If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
1050 1050  )))
1051 1051  
1052 1052  * (((
1053 -Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1055 +Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
1054 1054  )))
1055 1055  * (((
1056 -Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1058 +Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
1057 1057  
1058 1058  
1059 -
1060 1060  
1061 1061  )))
1062 1062  
... ... @@ -1067,9 +1067,21 @@
1067 1067  
1068 1068  (% style="color:#037691" %)**AT Command: AT+INTMOD**
1069 1069  
1070 -[[image:image-20220610105907-1.png]]
1071 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1072 +|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response**
1073 +|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
1074 +0
1075 +OK
1076 +the mode is 0 =No interruption
1077 +)))
1078 +|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
1079 +Set Transmit Interval
1080 +0. (Disable Interrupt),
1081 +~1. (Trigger by rising and falling edge)
1082 +2. (Trigger by falling edge)
1083 +3. (Trigger by rising edge)
1084 +)))|(% style="width:157px" %)OK
1071 1071  
1072 -
1073 1073  (((
1074 1074  (% style="color:#037691" %)**Downlink Command: 0x06**
1075 1075  )))
... ... @@ -1083,18 +1083,15 @@
1083 1083  )))
1084 1084  
1085 1085  * (((
1086 -Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1099 +Example 1: Downlink Payload: 06000000  ~/~/ Turn off interrupt mode
1087 1087  )))
1088 1088  * (((
1089 -Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1090 -)))
1102 +Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
1091 1091  
1092 -(((
1104 +
1093 1093  
1094 1094  )))
1095 1095  
1096 -
1097 -
1098 1098  == 3.3 Calibrate Sensor ==
1099 1099  
1100 1100  
... ... @@ -1101,7 +1101,6 @@
1101 1101  Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1102 1102  
1103 1103  
1104 -
1105 1105  == 3.4 Get Firmware Version Info ==
1106 1106  
1107 1107  
... ... @@ -1109,9 +1109,12 @@
1109 1109  
1110 1110  (% style="color:#037691" %)**Downlink Command: 0x26**
1111 1111  
1112 -[[image:image-20220607171917-10.png]]
1121 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:500px" %)
1122 +|(% style="background-color:#4f81bd; color:white; width:193px" %)**Downlink Control Type**|(% style="background-color:#4f81bd; color:white; width:57px" %)**FPort**|(% style="background-color:#4f81bd; color:white; width:91px" %)**Type Code**|(% style="background-color:#4f81bd; color:white; width:159px" %)**Downlink payload size(bytes)**
1123 +|(% style="width:193px" %)Get Firmware Version Info|(% style="width:57px" %)Any|(% style="width:91px" %)26|(% style="width:149px" %)2
1113 1113  
1114 1114  * Reply to the confirmation package: 26 01
1126 +
1115 1115  * Reply to non-confirmed packet: 26 00
1116 1116  
1117 1117  Device will send an uplink after got this downlink command. With below payload:
... ... @@ -1118,17 +1118,13 @@
1118 1118  
1119 1119  Configures info payload:
1120 1120  
1121 -(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
1122 -|=(((
1123 -**Size(bytes)**
1124 -)))|=**1**|=**1**|=**1**|=**1**|=**1**|=**5**|=**1**
1125 -|**Value**|Software Type|(((
1133 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
1134 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:70px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**1**|(% style="background-color:#4f81bd; color:white; width:50px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**1**|(% style="background-color:#4f81bd; color:white; width:60px" %)**1**|(% style="background-color:#4f81bd; color:white; width:50px" %)**5**|(% style="background-color:#4f81bd; color:white; width:90px" %)**1**
1135 +|Value|Software Type|(((
1126 1126  Frequency
1127 -
1128 1128  Band
1129 1129  )))|Sub-band|(((
1130 1130  Firmware
1131 -
1132 1132  Version
1133 1133  )))|Sensor Type|Reserve|(((
1134 1134  [[Message Type>>||anchor="H2.3.6MessageType"]]
... ... @@ -1137,7 +1137,6 @@
1137 1137  
1138 1138  (% style="color:#037691" %)**Software Type**(%%): Always 0x03 for LSPH01
1139 1139  
1140 -
1141 1141  (% style="color:#037691" %)**Frequency Band**:
1142 1142  
1143 1143  *0x01: EU868
... ... @@ -1163,10 +1163,8 @@
1163 1163  
1164 1164  (% style="color:#037691" %)**Sub-Band**(%%): value 0x00 ~~ 0x08
1165 1165  
1166 -
1167 1167  (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
1168 1168  
1169 -
1170 1170  (% style="color:#037691" %)**Sensor Type**:
1171 1171  
1172 1172  0x01: LSE01
... ... @@ -1184,163 +1184,113 @@
1184 1184  0x07: LDDS12
1185 1185  
1186 1186  
1192 += 4. Battery & Power Consumption =
1187 1187  
1188 -= 4. Battery & How to replace =
1189 1189  
1195 +LSPH01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1190 1190  
1191 -== 4.1 Battery Type ==
1197 +[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
1192 1192  
1193 1193  
1194 -(((
1195 -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.
1196 -)))
1200 += 5. Use AT Command =
1197 1197  
1198 -(((
1199 -The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
1202 +== 5.1 Access AT Commands ==
1200 1200  
1201 -
1202 -)))
1203 1203  
1204 -[[image:1654593587246-335.png]]
1205 +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.
1205 1205  
1206 1206  
1207 -Minimum Working Voltage for the LSPH01:
1208 +[[image:1654593668970-604.png]]
1208 1208  
1209 -LSPH01:  2.45v ~~ 3.6v
1210 1210  
1211 +**Connection:**
1211 1211  
1213 +(% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
1212 1212  
1213 -== 4.2 Replace Battery ==
1215 +(% style="background-color:yellow" %)** USB TTL TXD  <~-~-~-~-> UART_RXD**
1214 1214  
1217 +(% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1215 1215  
1216 -(((
1217 -Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1218 -)))
1219 1219  
1220 1220  (((
1221 -And make sure the positive and negative pins match.
1221 +In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSPH01. LSPH01 will output system info once power on as below:
1222 1222  )))
1223 1223  
1224 1224  
1225 + [[image:1654593712276-618.png]]
1225 1225  
1226 -== 4.3 Power Consumption Analyze ==
1227 +Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
1227 1227  
1228 1228  
1229 -(((
1230 -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.
1231 -)))
1230 += 6. FAQ =
1232 1232  
1233 -(((
1234 -Instruction to use as below:
1235 -)))
1232 +== 6.1 How to change the LoRa Frequency Bands/Region ==
1236 1236  
1237 1237  
1238 -(% style="color:#037691" %)**Step 1**(%%): Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
1235 +You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1236 +When downloading the images, choose the required image file for download. ​
1239 1239  
1240 -[[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/]]
1241 1241  
1239 += 7. Trouble Shooting =
1242 1242  
1243 -(% style="color:#037691" %)**Step 2**(%%): Open it and choose
1241 +== 7.1 AT Commands input doesn't work ==
1244 1244  
1245 -* Product Model
1246 -* Uplink Interval
1247 -* Working Mode
1248 1248  
1249 -And the Life expectation in difference case will be shown on the right.
1244 +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.
1250 1250  
1251 -[[image:1654593605679-189.png]]
1252 1252  
1247 +== 7.2 Possible reasons why the device is unresponsive： ==
1253 1253  
1254 -The battery related documents as below:
1255 1255  
1256 -* (((
1257 -[[Battery Dimension>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]],
1258 -)))
1259 -* (((
1260 -[[Lithium-Thionyl Chloride Battery  datasheet>>url:https://www.dragino.com/downloads/downloads/datasheet/Battery/ER26500/ER26500_Datasheet-EN.pdf]],
1261 -)))
1262 -* (((
1263 -[[Lithium-ion Battery-Capacitor datasheet>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]], [[Tech Spec>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]]
1264 -)))
1250 +​1. Check whether the battery voltage is lower than 2.8V
1251 +2. Check whether the jumper of the device is correctly connected
1265 1265  
1266 -[[image:image-20220607172042-11.png]]
1253 +[[image:image-20240330174400-2.png]]
1254 +3. Check whether the switch here of the device is at the ISP（The switch can operate normally only when it is in RUN）
1267 1267  
1256 +[[image:image-20240330174406-3.png]]
1257 +​
1268 1268  
1259 +== 7.3 The node cannot read the sensor data ==
1269 1269  
1270 -=== 4.3.1 ​Battery Note ===
1261 +This may be caused by a software firmware(≤1.1.6 version) bug, which we fixed in the latest firmware (>1.1.6 version)
1271 1271  
1263 +The user can fix this problem via upgrade firmware.
1272 1272  
1273 -(((
1274 -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.
1275 -)))
1276 1276  
1266 +By default, The latest firmware value of POWERIC is 1, while the 3322 version requires POWERIC to be set to 0 in order to function properly
1277 1277  
1278 1278  
1279 -=== ​4.3.2 Replace the battery ===
1269 +* **//1. Check if the hardware version is 3322//**
1280 1280  
1271 +If the sensor hardware version is 3322 or earlier, the user can change the POWERIC value to 0 after a firmware upgrade using one of the following methods
1281 1281  
1282 -(((
1283 -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.
1284 -)))
1273 +**a. Using AT command**
1285 1285  
1275 +(% class="box infomessage" %)
1286 1286  (((
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)
1277 +AT+POWERIC=0.
1288 1288  )))
1289 1289  
1290 1290  
1281 +**b. Using Downlink**
1291 1291  
1292 -= 5. Use AT Command =
1293 -
1294 -
1295 -== 5.1 Access AT Commands ==
1296 -
1297 -
1298 -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.
1299 -
1300 -
1301 -[[image:1654593668970-604.png]]
1302 -
1303 -
1304 -**Connection:**
1305 -
1306 -(% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
1307 -
1308 -(% style="background-color:yellow" %)** USB TTL TXD  <~-~-~-~-> UART_RXD**
1309 -
1310 -(% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1311 -
1312 -
1283 +(% class="box infomessage" %)
1313 1313  (((
1314 -In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LSPH01. LSPH01 will output system info once power on as below:
1285 +FF 00(AT+POWERIC=0).
1315 1315  )))
1316 1316  
1317 1317  
1318 - [[image:1654593712276-618.png]]
1289 +[[image:image-20240531090837-1.png]]
1319 1319  
1320 -Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
1321 1321  
1292 +Please check your hardware production date
1322 1322  
1323 -= 6. FAQ =
1294 +The first two digits are the week of the year, and the last two digits are the year.
1324 1324  
1296 +The number 3322 is the first batch we changed the power IC.
1325 1325  
1326 -== 6.1 How to change the LoRa Frequency Bands/Region ==
1327 1327  
1328 -
1329 -You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1330 -When downloading the images, choose the required image file for download. ​
1331 -
1332 -
1333 -
1334 -= 7. Trouble Shooting =
1335 -
1336 -
1337 -== 7.1 AT Commands input doesn't work ==
1338 -
1339 -
1340 -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.
1341 -
1342 -
1343 -
1344 1344  = 8. Order Info =
1345 1345  
1346 1346  
... ... @@ -1358,8 +1358,6 @@
1358 1358  * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
1359 1359  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1360 1360  
1361 -
1362 -
1363 1363  = 9. ​Packing Info =
1364 1364  
1365 1365  
... ... @@ -1374,13 +1374,8 @@
1374 1374  * Package Size / pcs : cm
1375 1375  * Weight / pcs : g
1376 1376  
1377 -
1378 -
1379 1379  = 10. ​Support =
1380 1380  
1381 1381  
1382 1382  * 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.
1383 1383  * 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]].
1384 -
1385 -
1386 -
image-20230426084737-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +190.0 KB
Content
image-20240330174324-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +445.4 KB
Content
image-20240330174400-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +445.4 KB
Content
image-20240330174406-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Bei
Size
... ... @@ -1,0 +1,1 @@
1 +445.4 KB
Content

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0