Last modified by Xiaoling on 2025/04/25 14:08

From version 74.13
edited by Xiaoling
on 2022/06/07 17:52
Change comment: There is no comment for this version
To version 98.12
edited by Xiaoling
on 2022/10/13 17:14
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,63 +4,10 @@
4 4  
5 5  
6 6  
7 -**Contents:**
8 8  
9 -* [[1. Introduction>>path:#H1.Introduction]]
10 -** [[1.1 ​What is LoRaWAN Soil pH Sensor>>path:#H1.1200BWhatisLoRaWANSoilpHSensor]]
11 -** [[​1.2 Features>>path:#H200B1.2Features]]
12 -** [[1.3 Probe Specification>>path:#H1.3ProbeSpecification]]
13 -** [[1.4 ​Applications>>path:#H1.4200BApplications]]
14 -** [[1.5 Pin mapping and power on>>path:#H1.5Pinmappingandpoweron]]
15 -* [[2. Configure LSPH01 to connect to LoRaWAN network>>path:#H2.ConfigureLSPH01toconnecttoLoRaWANnetwork]]
16 -** [[2.1 How it works>>path:#H2.1Howitworks]]
17 -** [[2.2 ​Quick guide to connect to LoRaWAN server (OTAA)>>path:#H2.2200BQuickguidetoconnecttoLoRaWANserver28OTAA29]]
18 -** [[2.3 ​Uplink Payload>>path:#H2.3200BUplinkPayload]]
19 -*** [[2.3.1 Battery Info>>path:#H2.3.1BatteryInfo]]
20 -*** [[2.3.2 DS18B20 Temperature sensor>>path:#H2.3.2DS18B20Temperaturesensor]]
21 -*** [[2.3.3 Soil pH>>path:#H2.3.3SoilpH]]
22 -*** [[2.3.4 Soil Temperature>>path:#H2.3.4SoilTemperature]]
23 -*** [[2.3.5 Interrupt Pin>>path:#H2.3.5InterruptPin]]
24 -*** [[2.3.6 Message Type>>path:#H2.3.6MessageType]]
25 -*** [[2.3.7 Decode payload in The Things Network>>path:#H2.3.7DecodepayloadinTheThingsNetwork]]
26 -** [[2.4 Uplink Interval>>path:#H2.4UplinkInterval]]
27 -** [[2.5 ​Show Data in DataCake IoT Server>>path:#H2.5200BShowDatainDataCakeIoTServer]]
28 -** [[2.6 Installation and Maintain>>path:#H2.6InstallationandMaintain]]
29 -*** [[2.6.1 Before measurement>>path:#H2.6.1Beforemeasurement]]
30 -*** [[2.6.2 Measurement>>path:#H2.6.2Measurement]]
31 -*** [[2.6.3 Maintain Probe>>path:#H2.6.3MaintainProbe]]
32 -** [[2.7 Calibration>>path:#H2.7Calibration]]
33 -** [[2.8 Frequency Plans>>path:#H2.8FrequencyPlans]]
34 -*** [[2.8.1 EU863-870 (EU868)>>path:#H2.8.1EU863-87028EU86829]]
35 -*** [[2.8.2 US902-928(US915)>>path:#H2.8.2US902-92828US91529]]
36 -*** [[2.8.3 CN470-510 (CN470)>>path:#H2.8.3CN470-51028CN47029]]
37 -*** [[2.8.4 AU915-928(AU915)>>path:#H2.8.4AU915-92828AU91529]]
38 -*** [[2.8.5 AS920-923 & AS923-925 (AS923)>>path:#H2.8.5AS920-92326AS923-92528AS92329]]
39 -*** [[2.8.6 KR920-923 (KR920)>>path:#H2.8.6KR920-92328KR92029]]
40 -*** [[2.8.7 IN865-867 (IN865)>>path:#H2.8.7IN865-86728IN86529]]
41 -** [[2.9 LED Indicator>>path:#H2.9LEDIndicator]]
42 -** [[2.10 ​Firmware Change Log>>path:#H2.10200BFirmwareChangeLog]]
43 -* [[3. Configure LSPH01 via AT Command or LoRaWAN Downlink>>path:#H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink]]
44 -** [[3.1 Set Transmit Interval Time>>path:#H3.1SetTransmitIntervalTime]]
45 -** [[3.2 Set Interrupt Mode>>path:#H3.2SetInterruptMode]]
46 -** [[3.3 Calibrate Sensor>>path:#H3.3CalibrateSensor]]
47 -** [[3.4 Get Firmware Version Info>>path:#H3.4GetFirmwareVersionInfo]]
48 -* [[4. Battery & How to replace>>path:#H4.Battery26Howtoreplace]]
49 -** [[4.1 Battery Type>>path:#H4.1BatteryType]]
50 -** [[4.2 Replace Battery>>path:#H4.2ReplaceBattery]]
51 -** [[4.3 Power Consumption Analyze>>path:#H4.3PowerConsumptionAnalyze]]
52 -*** [[4.3.1 ​Battery Note>>path:#H4.3.1200BBatteryNote]]
53 -*** [[​4.3.2 Replace the battery>>path:#H200B4.3.2Replacethebattery]]
54 -* [[5. Use AT Command>>path:#H5.UseATCommand]]
55 -** [[5.1 Access AT Commands>>path:#H5.1AccessATCommands]]
56 -* [[6. FAQ>>path:#H6.FAQ]]
57 -** [[6.1 How to change the LoRa Frequency Bands/Region>>path:#H6.1HowtochangetheLoRaFrequencyBands2FRegion]]
58 -* [[7. Trouble Shooting>>path:#H7.TroubleShooting]]
59 -** [[7.1 AT Commands input doesn’t work>>path:#H7.1ATCommandsinputdoesn2019twork]]
60 -* [[8. Order Info>>path:#H8.OrderInfo]]
61 -* [[9. ​Packing Info>>path:#H9.200BPackingInfo]]
62 -* [[10. ​Support>>path:#H10.A0200BSupport]]
8 +**Table of Contents:**
63 63  
10 +{{toc/}}
64 64  
65 65  
66 66  
... ... @@ -69,9 +69,12 @@
69 69  
70 70  = 1. Introduction =
71 71  
19 +
72 72  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
73 73  
74 74  (((
23 +
24 +
75 75  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.
76 76  )))
77 77  
... ... @@ -98,6 +98,7 @@
98 98  
99 99  == ​1.2 Features ==
100 100  
51 +
101 101  * LoRaWAN 1.0.3 Class A
102 102  * Ultra-low power consumption
103 103  * Monitor soil pH with temperature compensation.
... ... @@ -113,6 +113,8 @@
113 113  * 8500mAh Battery for long term use
114 114  
115 115  
67 +
68 +
116 116  == 1.3 Probe Specification ==
117 117  
118 118  
... ... @@ -134,13 +134,18 @@
134 134  * Length: 3.5 meters
135 135  
136 136  
90 +
91 +
137 137  == 1.4 ​Applications ==
138 138  
94 +
139 139  * Smart Agriculture
140 140  
141 141  
98 +
142 142  == 1.5 Pin mapping and power on ==
143 143  
101 +
144 144  [[image:1654592472094-134.png]]
145 145  
146 146  
... ... @@ -147,19 +147,23 @@
147 147  
148 148  = 2. Configure LSPH01 to connect to LoRaWAN network =
149 149  
108 +
150 150  == 2.1 How it works ==
151 151  
111 +
152 152  (((
153 153  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.
154 154  )))
155 155  
156 156  (((
157 -In case you cant set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>path:#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.
158 158  )))
159 159  
160 160  
121 +
161 161  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
162 162  
124 +
163 163  (((
164 164  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.
165 165  )))
... ... @@ -166,10 +166,14 @@
166 166  
167 167  (((
168 168  [[image:1654592492399-921.png]]
131 +
132 +
169 169  )))
170 170  
171 171  (((
172 172  The LG308 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
137 +
138 +
173 173  )))
174 174  
175 175  (((
... ... @@ -193,11 +193,13 @@
193 193  [[image:1654592600093-601.png]]
194 194  
195 195  
162 +
196 196  **Add APP EUI and DEV EUI**
197 197  
198 198  [[image:1654592619856-881.png]]
199 199  
200 200  
168 +
201 201  **Add APP EUI in the application**
202 202  
203 203  [[image:1654592632656-512.png]]
... ... @@ -219,6 +219,8 @@
219 219  
220 220  (((
221 221  (% 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 +
222 222  )))
223 223  
224 224  [[image:1654592697690-910.png]]
... ... @@ -227,6 +227,7 @@
227 227  
228 228  == 2.3 ​Uplink Payload ==
229 229  
200 +
230 230  (((
231 231  LSPH01 will uplink payload via LoRaWAN with below payload format: 
232 232  )))
... ... @@ -240,19 +240,17 @@
240 240  )))
241 241  
242 242  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
243 -|(((
244 -**Size**
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"]]
245 245  
246 -**(bytes)**
247 -)))|**2**|**2**|**2**|**2**|**1**|**1**|**1**
248 -|**Value**|[[BAT>>path:#H2.3.1BatteryInfo]]|(((
249 -[[Temperature>>path:#H2.3.2DS18B20Temperaturesensor]]
250 -
251 -[[(Optional)>>path:#H2.3.2DS18B20Temperaturesensor]]
252 -)))|[[Soil pH>>path:#H2.3.3SoilpH]]|[[Soil Temperature>>path:#H2.3.4SoilTemperature]]|(((
253 -[[Digital Interrupt (Optional)>>path:#H2.3.5InterruptPin]]
220 +[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
221 +)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
222 +[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
254 254  )))|Reserve|(((
255 -[[Message Type>>path:#H2.3.6MessageType]]
224 +[[Message Type>>||anchor="H2.3.6MessageType"]]
256 256  )))
257 257  
258 258  [[image:1654592721645-318.png]]
... ... @@ -272,6 +272,7 @@
272 272  
273 273  === 2.3.2 DS18B20 Temperature sensor ===
274 274  
244 +
275 275  This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
276 276  
277 277  
... ... @@ -285,6 +285,7 @@
285 285  
286 286  === 2.3.3 Soil pH ===
287 287  
258 +
288 288  Range: 0 ~~ 14 pH
289 289  
290 290  **Example:**
... ... @@ -295,6 +295,7 @@
295 295  
296 296  === 2.3.4 Soil Temperature ===
297 297  
269 +
298 298  Get Soil Temperature 
299 299  
300 300  
... ... @@ -308,9 +308,10 @@
308 308  
309 309  === 2.3.5 Interrupt Pin ===
310 310  
311 -This data field shows if this packet is generated by interrupt or not. [[Click here>>path:#H3.2SetInterruptMode]] for the hardware and software set up.
312 312  
284 +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.
313 313  
286 +
314 314  **Example:**
315 315  
316 316  0x00: Normal uplink packet.
... ... @@ -321,6 +321,7 @@
321 321  
322 322  === 2.3.6 Message Type ===
323 323  
297 +
324 324  (((
325 325  For a normal uplink payload, the message type is always 0x01.
326 326  )))
... ... @@ -330,14 +330,15 @@
330 330  )))
331 331  
332 332  
333 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
334 -|=**Message Type Code**|=**Description**|=**Payload**
335 -|0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]]
336 -|0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]]
337 -|0x03|Reply Calibration Info|[[Calibration Payload>>path:#H2.7Calibration]]
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**
309 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
310 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
311 +|(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
338 338  
339 339  
340 340  
315 +
341 341  === 2.3.7 Decode payload in The Things Network ===
342 342  
343 343  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -350,7 +350,7 @@
350 350  )))
351 351  
352 352  (((
353 -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/]]
328 +LSPH01 TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
354 354  )))
355 355  
356 356  
... ... @@ -357,12 +357,14 @@
357 357  
358 358  == 2.4 Uplink Interval ==
359 359  
360 -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>>path:/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/#H4.1ChangeUplinkInterval]]
361 361  
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"]]
362 362  
363 363  
339 +
364 364  == 2.5 ​Show Data in DataCake IoT Server ==
365 365  
342 +
366 366  (((
367 367  [[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:
368 368  )))
... ... @@ -405,7 +405,7 @@
405 405  )))
406 406  
407 407  (((
408 -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/]]
385 +Download Datacake decoder from: [[https:~~/~~/www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>url:https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]]
409 409  )))
410 410  
411 411  
... ... @@ -426,8 +426,10 @@
426 426  
427 427  == 2.6 Installation and Maintain ==
428 428  
406 +
429 429  === 2.6.1 Before measurement ===
430 430  
409 +
431 431  (((
432 432  (((
433 433  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. 
... ... @@ -445,6 +445,8 @@
445 445  
446 446  (((
447 447  [[image:1654592946732-634.png]]
427 +
428 +
448 448  )))
449 449  
450 450  (((
... ... @@ -456,7 +456,7 @@
456 456  )))
457 457  
458 458  (((
459 -Slowly insert the probe to the measure point. Dont 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.
460 460  )))
461 461  
462 462  (((
... ... @@ -483,6 +483,7 @@
483 483  
484 484  === 2.6.3 Maintain Probe ===
485 485  
467 +
486 486  1. (((
487 487  pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
488 488  )))
... ... @@ -507,6 +507,7 @@
507 507  
508 508  == 2.7 Calibration ==
509 509  
492 +
510 510  (((
511 511  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).
512 512  )))
... ... @@ -521,11 +521,9 @@
521 521  (% style="color:#037691" %)**Calibration Payload**
522 522  
523 523  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
524 -|(((
525 -**Size**
526 -
527 -**(bytes)**
528 -)))|**1**|**1**|**1**|**7**|**1**
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**
529 529  |**Value**|(((
530 530  PH4
531 531  
... ... @@ -535,7 +535,7 @@
535 535  
536 536  Calibrate value
537 537  )))|Reserve|(((
538 -[[Message Type>>path:#H2.3.6MessageType]]
519 +[[Message Type>>||anchor="H2.3.6MessageType"]]
539 539  
540 540  Always 0x03
541 541  )))
... ... @@ -552,13 +552,16 @@
552 552  
553 553  == 2.8 Frequency Plans ==
554 554  
536 +
555 555  (((
556 556  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.
557 557  )))
558 558  
559 559  
542 +
560 560  === 2.8.1 EU863-870 (EU868) ===
561 561  
545 +
562 562  (((
563 563  (% style="color:blue" %)**Uplink:**
564 564  )))
... ... @@ -619,6 +619,7 @@
619 619  
620 620  === 2.8.2 US902-928(US915) ===
621 621  
606 +
622 622  (((
623 623  Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
624 624  )))
... ... @@ -632,7 +632,7 @@
632 632  )))
633 633  
634 634  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
635 -* Use the Join successful sub-band if the server doesnt include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
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)
636 636  
637 637  
638 638  
... ... @@ -639,6 +639,7 @@
639 639  
640 640  === 2.8.3 CN470-510 (CN470) ===
641 641  
627 +
642 642  (((
643 643  Used in China, Default use CHE=1
644 644  )))
... ... @@ -727,6 +727,7 @@
727 727  
728 728  === 2.8.4 AU915-928(AU915) ===
729 729  
716 +
730 730  (((
731 731  Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
732 732  )))
... ... @@ -744,11 +744,14 @@
744 744  )))
745 745  
746 746  * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
747 -* Use the Join successful sub-band if the server doesnt include sub-band info in the OTAA Join Accept message ( TTN v2 doesn't include)
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)
748 748  
749 749  
737 +
738 +
750 750  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
751 751  
741 +
752 752  (((
753 753  (% style="color:blue" %)**Default Uplink channel:**
754 754  )))
... ... @@ -857,6 +857,7 @@
857 857  
858 858  === 2.8.6 KR920-923 (KR920) ===
859 859  
850 +
860 860  (((
861 861  (% style="color:blue" %)**Default channel:**
862 862  )))
... ... @@ -929,6 +929,7 @@
929 929  
930 930  === 2.8.7 IN865-867 (IN865) ===
931 931  
923 +
932 932  (((
933 933  (% style="color:blue" %)**Uplink:**
934 934  )))
... ... @@ -965,6 +965,7 @@
965 965  
966 966  == 2.9 LED Indicator ==
967 967  
960 +
968 968  The LSPH01 has an internal LED which is to show the status of different state.
969 969  
970 970  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
... ... @@ -971,14 +971,14 @@
971 971  * Blink once when device transmit a packet.
972 972  
973 973  
974 -== 2.10 ​Firmware Change Log ==
975 975  
976 976  
977 -**Firmware download link:**
969 +== 2.10 ​Firmware Change Log ==
978 978  
979 -[[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/]]
980 980  
972 +**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0>>https://www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0]]
981 981  
974 +
982 982  **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
983 983  
984 984  
... ... @@ -985,31 +985,58 @@
985 985  
986 986  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
987 987  
981 +
982 +(((
988 988  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
984 +)))
989 989  
990 -* AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
991 -* LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
986 +* (((
987 +AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].
988 +)))
989 +* (((
990 +LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
991 +)))
992 992  
993 +(((
993 993  There are two kinds of commands to configure LSPH01, they are:
995 +)))
994 994  
995 -* (% style="color:#4f81bd" %)** General Commands**.
997 +* (((
998 +(% style="color:#4f81bd" %)** General Commands**.
999 +)))
996 996  
1001 +(((
997 997  These commands are to configure:
1003 +)))
998 998  
999 -* General system settings like: uplink interval.
1000 -* LoRaWAN protocol & radio related command.
1005 +* (((
1006 +General system settings like: uplink interval.
1007 +)))
1008 +* (((
1009 +LoRaWAN protocol & radio related command.
1010 +)))
1001 1001  
1002 -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/]]
1012 +(((
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 +)))
1003 1003  
1016 +(((
1017 +
1018 +)))
1004 1004  
1005 -* (% style="color:#4f81bd" %)** Commands special design for LSPH01**
1020 +* (((
1021 +(% style="color:#4f81bd" %)** Commands special design for LSPH01**
1022 +)))
1006 1006  
1024 +(((
1007 1007  These commands only valid for LSPH01, as below:
1026 +)))
1008 1008  
1009 1009  
1010 1010  
1011 1011  == 3.1 Set Transmit Interval Time ==
1012 1012  
1032 +
1013 1013  Feature: Change LoRaWAN End Node Transmit Interval.
1014 1014  
1015 1015  (% style="color:#037691" %)**AT Command: AT+TDC**
... ... @@ -1017,44 +1017,74 @@
1017 1017  [[image:image-20220607171554-8.png]]
1018 1018  
1019 1019  
1020 -
1040 +(((
1021 1021  (% style="color:#037691" %)**Downlink Command: 0x01**
1042 +)))
1022 1022  
1044 +(((
1023 1023  Format: Command Code (0x01) followed by 3 bytes time value.
1046 +)))
1024 1024  
1048 +(((
1025 1025  If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
1050 +)))
1026 1026  
1027 -* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1028 -* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1052 +* (((
1053 +Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
1054 +)))
1055 +* (((
1056 +Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1029 1029  
1030 1030  
1031 1031  
1060 +
1061 +)))
1062 +
1032 1032  == 3.2 Set Interrupt Mode ==
1033 1033  
1065 +
1034 1034  Feature, Set Interrupt mode for GPIO_EXIT.
1035 1035  
1036 1036  (% style="color:#037691" %)**AT Command: AT+INTMOD**
1037 1037  
1038 -[[image:image-20220607171716-9.png]]
1070 +[[image:image-20220610105907-1.png]]
1039 1039  
1040 1040  
1073 +(((
1041 1041  (% style="color:#037691" %)**Downlink Command: 0x06**
1075 +)))
1042 1042  
1077 +(((
1043 1043  Format: Command Code (0x06) followed by 3 bytes.
1079 +)))
1044 1044  
1081 +(((
1045 1045  This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
1083 +)))
1046 1046  
1047 -* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1048 -* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1085 +* (((
1086 +Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
1087 +)))
1088 +* (((
1089 +Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
1090 +)))
1049 1049  
1092 +(((
1093 +
1094 +)))
1095 +
1096 +
1097 +
1050 1050  == 3.3 Calibrate Sensor ==
1051 1051  
1052 -Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
1053 1053  
1101 +Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1054 1054  
1055 1055  
1104 +
1056 1056  == 3.4 Get Firmware Version Info ==
1057 1057  
1107 +
1058 1058  Feature: use downlink to get firmware version.
1059 1059  
1060 1060  (% style="color:#037691" %)**Downlink Command: 0x26**
... ... @@ -1081,14 +1081,14 @@
1081 1081  
1082 1082  Version
1083 1083  )))|Sensor Type|Reserve|(((
1084 -[[Message Type>>path:#H2.3.6MessageType]]
1134 +[[Message Type>>||anchor="H2.3.6MessageType"]]
1085 1085  Always 0x02
1086 1086  )))
1087 1087  
1088 -**Software Type**: Always 0x03 for LSPH01
1138 +(% style="color:#037691" %)**Software Type**(%%): Always 0x03 for LSPH01
1089 1089  
1090 1090  
1091 -**Frequency Band**:
1141 +(% style="color:#037691" %)**Frequency Band**:
1092 1092  
1093 1093  *0x01: EU868
1094 1094  
... ... @@ -1111,13 +1111,13 @@
1111 1111  *0xa0: AS923-3
1112 1112  
1113 1113  
1114 -**Sub-Band**: value 0x00 ~~ 0x08
1164 +(% style="color:#037691" %)**Sub-Band**(%%): value 0x00 ~~ 0x08
1115 1115  
1116 1116  
1117 -**Firmware Version**: 0x0100, Means: v1.0.0 version
1167 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
1118 1118  
1119 1119  
1120 -**Sensor Type**:
1170 +(% style="color:#037691" %)**Sensor Type**:
1121 1121  
1122 1122  0x01: LSE01
1123 1123  
... ... @@ -1137,14 +1137,18 @@
1137 1137  
1138 1138  = 4. Battery & How to replace =
1139 1139  
1190 +
1140 1140  == 4.1 Battery Type ==
1141 1141  
1193 +
1142 1142  (((
1143 1143  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.
1144 1144  )))
1145 1145  
1146 1146  (((
1147 -The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
1199 +The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
1200 +
1201 +
1148 1148  )))
1149 1149  
1150 1150  [[image:1654593587246-335.png]]
... ... @@ -1158,6 +1158,7 @@
1158 1158  
1159 1159  == 4.2 Replace Battery ==
1160 1160  
1215 +
1161 1161  (((
1162 1162  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1163 1163  )))
... ... @@ -1170,6 +1170,7 @@
1170 1170  
1171 1171  == 4.3 Power Consumption Analyze ==
1172 1172  
1228 +
1173 1173  (((
1174 1174  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.
1175 1175  )))
... ... @@ -1179,12 +1179,12 @@
1179 1179  )))
1180 1180  
1181 1181  
1182 -**Step 1**: Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
1238 +(% style="color:#037691" %)**Step 1**(%%): Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
1183 1183  
1184 1184  [[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/]]
1185 1185  
1186 1186  
1187 -**Step 2**: Open it and choose
1243 +(% style="color:#037691" %)**Step 2**(%%): Open it and choose
1188 1188  
1189 1189  * Product Model
1190 1190  * Uplink Interval
... ... @@ -1198,13 +1198,13 @@
1198 1198  The battery related documents as below:
1199 1199  
1200 1200  * (((
1201 -[[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/&file=LSN50-Battery-Dimension.pdf]],
1257 +[[Battery Dimension>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]],
1202 1202  )))
1203 1203  * (((
1204 1204  [[Lithium-Thionyl Chloride Battery  datasheet>>url:https://www.dragino.com/downloads/downloads/datasheet/Battery/ER26500/ER26500_Datasheet-EN.pdf]],
1205 1205  )))
1206 1206  * (((
1207 -[[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC_1520_datasheet.jpg]], [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC1520%20Technical%20Specification20171123.pdf]]
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/]]
1208 1208  )))
1209 1209  
1210 1210  [[image:image-20220607172042-11.png]]
... ... @@ -1213,6 +1213,7 @@
1213 1213  
1214 1214  === 4.3.1 ​Battery Note ===
1215 1215  
1272 +
1216 1216  (((
1217 1217  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.
1218 1218  )))
... ... @@ -1221,20 +1221,29 @@
1221 1221  
1222 1222  === ​4.3.2 Replace the battery ===
1223 1223  
1224 -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.
1225 1225  
1226 -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)
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 +)))
1227 1227  
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)
1288 +)))
1228 1228  
1229 1229  
1291 +
1230 1230  = 5. Use AT Command =
1231 1231  
1294 +
1232 1232  == 5.1 Access AT Commands ==
1233 1233  
1297 +
1234 1234  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.
1235 1235  
1300 +
1236 1236  [[image:1654593668970-604.png]]
1237 1237  
1303 +
1238 1238  **Connection:**
1239 1239  
1240 1240  (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
... ... @@ -1244,20 +1244,23 @@
1244 1244  (% style="background-color:yellow" %)** USB TTL RXD  <~-~-~-~-> UART_TXD**
1245 1245  
1246 1246  
1313 +(((
1247 1247  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:
1315 +)))
1248 1248  
1249 1249  
1250 1250   [[image:1654593712276-618.png]]
1251 1251  
1252 -Valid AT Command please check [[Configure Device>>path:#H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink]].
1320 +Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
1253 1253  
1254 1254  
1255 -
1256 1256  = 6. FAQ =
1257 1257  
1325 +
1258 1258  == 6.1 How to change the LoRa Frequency Bands/Region ==
1259 1259  
1260 -You can follow the instructions for [[how to upgrade image>>path:#H2.10200BFirmwareChangeLog]].
1328 +
1329 +You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1261 1261  When downloading the images, choose the required image file for download. ​
1262 1262  
1263 1263  
... ... @@ -1264,14 +1264,17 @@
1264 1264  
1265 1265  = 7. Trouble Shooting =
1266 1266  
1267 -== 7.1 AT Commands input doesn’t work ==
1268 1268  
1269 -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 doesnt send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
1337 +== 7.1 AT Commands input doesn't work ==
1270 1270  
1271 1271  
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.
1272 1272  
1342 +
1343 +
1273 1273  = 8. Order Info =
1274 1274  
1346 +
1275 1275  Part Number: (% style="color:blue" %)**LSPH01-XX**
1276 1276  
1277 1277  
... ... @@ -1286,6 +1286,8 @@
1286 1286  * (% style="color:red" %)**IN865**(%%):  LoRaWAN IN865 band
1287 1287  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1288 1288  
1361 +
1362 +
1289 1289  = 9. ​Packing Info =
1290 1290  
1291 1291  
... ... @@ -1300,9 +1300,13 @@
1300 1300  * Package Size / pcs : cm
1301 1301  * Weight / pcs : g
1302 1302  
1377 +
1378 +
1303 1303  = 10. ​Support =
1304 1304  
1381 +
1305 1305  * 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.
1306 1306  * 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]].
1307 1307  
1385 +
1308 1308  
image-20220610105907-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +15.5 KB
Content