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

From version 84.7
edited by Xiaoling
on 2022/06/07 18:09
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,70 +4,24 @@
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  
13 +
14 +
15 +
16 +
66 66  = 1. Introduction =
67 67  
19 +
68 68  == 1.1 ​What is LoRaWAN Soil pH Sensor ==
69 69  
70 70  (((
23 +
24 +
71 71  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.
72 72  )))
73 73  
... ... @@ -94,6 +94,7 @@
94 94  
95 95  == ​1.2 Features ==
96 96  
51 +
97 97  * LoRaWAN 1.0.3 Class A
98 98  * Ultra-low power consumption
99 99  * Monitor soil pH with temperature compensation.
... ... @@ -133,15 +133,17 @@
133 133  
134 134  
135 135  
91 +
136 136  == 1.4 ​Applications ==
137 137  
94 +
138 138  * Smart Agriculture
139 139  
140 140  
141 141  
142 -
143 143  == 1.5 Pin mapping and power on ==
144 144  
101 +
145 145  [[image:1654592472094-134.png]]
146 146  
147 147  
... ... @@ -148,19 +148,23 @@
148 148  
149 149  = 2. Configure LSPH01 to connect to LoRaWAN network =
150 150  
108 +
151 151  == 2.1 How it works ==
152 152  
111 +
153 153  (((
154 154  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.
155 155  )))
156 156  
157 157  (((
158 -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.
159 159  )))
160 160  
161 161  
121 +
162 162  == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
163 163  
124 +
164 164  (((
165 165  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.
166 166  )))
... ... @@ -167,10 +167,14 @@
167 167  
168 168  (((
169 169  [[image:1654592492399-921.png]]
131 +
132 +
170 170  )))
171 171  
172 172  (((
173 173  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 +
174 174  )))
175 175  
176 176  (((
... ... @@ -194,11 +194,13 @@
194 194  [[image:1654592600093-601.png]]
195 195  
196 196  
162 +
197 197  **Add APP EUI and DEV EUI**
198 198  
199 199  [[image:1654592619856-881.png]]
200 200  
201 201  
168 +
202 202  **Add APP EUI in the application**
203 203  
204 204  [[image:1654592632656-512.png]]
... ... @@ -220,6 +220,8 @@
220 220  
221 221  (((
222 222  (% 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 +
223 223  )))
224 224  
225 225  [[image:1654592697690-910.png]]
... ... @@ -228,6 +228,7 @@
228 228  
229 229  == 2.3 ​Uplink Payload ==
230 230  
200 +
231 231  (((
232 232  LSPH01 will uplink payload via LoRaWAN with below payload format: 
233 233  )))
... ... @@ -241,19 +241,17 @@
241 241  )))
242 242  
243 243  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
244 -|(((
245 -**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"]]
246 246  
247 -**(bytes)**
248 -)))|**2**|**2**|**2**|**2**|**1**|**1**|**1**
249 -|**Value**|[[BAT>>path:#H2.3.1BatteryInfo]]|(((
250 -[[Temperature>>path:#H2.3.2DS18B20Temperaturesensor]]
251 -
252 -[[(Optional)>>path:#H2.3.2DS18B20Temperaturesensor]]
253 -)))|[[Soil pH>>path:#H2.3.3SoilpH]]|[[Soil Temperature>>path:#H2.3.4SoilTemperature]]|(((
254 -[[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"]]
255 255  )))|Reserve|(((
256 -[[Message Type>>path:#H2.3.6MessageType]]
224 +[[Message Type>>||anchor="H2.3.6MessageType"]]
257 257  )))
258 258  
259 259  [[image:1654592721645-318.png]]
... ... @@ -273,6 +273,7 @@
273 273  
274 274  === 2.3.2 DS18B20 Temperature sensor ===
275 275  
244 +
276 276  This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
277 277  
278 278  
... ... @@ -286,6 +286,7 @@
286 286  
287 287  === 2.3.3 Soil pH ===
288 288  
258 +
289 289  Range: 0 ~~ 14 pH
290 290  
291 291  **Example:**
... ... @@ -296,6 +296,7 @@
296 296  
297 297  === 2.3.4 Soil Temperature ===
298 298  
269 +
299 299  Get Soil Temperature 
300 300  
301 301  
... ... @@ -309,9 +309,10 @@
309 309  
310 310  === 2.3.5 Interrupt Pin ===
311 311  
312 -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.
313 313  
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.
314 314  
286 +
315 315  **Example:**
316 316  
317 317  0x00: Normal uplink packet.
... ... @@ -322,6 +322,7 @@
322 322  
323 323  === 2.3.6 Message Type ===
324 324  
297 +
325 325  (((
326 326  For a normal uplink payload, the message type is always 0x01.
327 327  )))
... ... @@ -331,12 +331,15 @@
331 331  )))
332 332  
333 333  
334 -(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
335 -|=**Message Type Code**|=**Description**|=**Payload**
336 -|0x01|Normal Uplink|[[Normal Uplink Payload>>path:#H2.3200BUplinkPayload]]
337 -|0x02|Reply configures info|[[Configure Info Payload>>path:#H3.4GetFirmwareVersionInfo]]
338 -|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"]]
339 339  
313 +
314 +
315 +
340 340  === 2.3.7 Decode payload in The Things Network ===
341 341  
342 342  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -349,7 +349,7 @@
349 349  )))
350 350  
351 351  (((
352 -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]]
353 353  )))
354 354  
355 355  
... ... @@ -356,12 +356,14 @@
356 356  
357 357  == 2.4 Uplink Interval ==
358 358  
359 -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]]
360 360  
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"]]
361 361  
362 362  
339 +
363 363  == 2.5 ​Show Data in DataCake IoT Server ==
364 364  
342 +
365 365  (((
366 366  [[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:
367 367  )))
... ... @@ -404,7 +404,7 @@
404 404  )))
405 405  
406 406  (((
407 -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]]
408 408  )))
409 409  
410 410  
... ... @@ -425,8 +425,10 @@
425 425  
426 426  == 2.6 Installation and Maintain ==
427 427  
406 +
428 428  === 2.6.1 Before measurement ===
429 429  
409 +
430 430  (((
431 431  (((
432 432  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. 
... ... @@ -444,6 +444,8 @@
444 444  
445 445  (((
446 446  [[image:1654592946732-634.png]]
427 +
428 +
447 447  )))
448 448  
449 449  (((
... ... @@ -455,7 +455,7 @@
455 455  )))
456 456  
457 457  (((
458 -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.
459 459  )))
460 460  
461 461  (((
... ... @@ -482,6 +482,7 @@
482 482  
483 483  === 2.6.3 Maintain Probe ===
484 484  
467 +
485 485  1. (((
486 486  pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
487 487  )))
... ... @@ -506,6 +506,7 @@
506 506  
507 507  == 2.7 Calibration ==
508 508  
492 +
509 509  (((
510 510  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).
511 511  )))
... ... @@ -520,11 +520,9 @@
520 520  (% style="color:#037691" %)**Calibration Payload**
521 521  
522 522  (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
523 -|(((
524 -**Size**
525 -
526 -**(bytes)**
527 -)))|**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**
528 528  |**Value**|(((
529 529  PH4
530 530  
... ... @@ -534,7 +534,7 @@
534 534  
535 535  Calibrate value
536 536  )))|Reserve|(((
537 -[[Message Type>>path:#H2.3.6MessageType]]
519 +[[Message Type>>||anchor="H2.3.6MessageType"]]
538 538  
539 539  Always 0x03
540 540  )))
... ... @@ -549,16 +549,18 @@
549 549  
550 550  
551 551  
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,10 +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  
736 +
737 +
738 +
749 749  === 2.8.5 AS920-923 & AS923-925 (AS923) ===
750 750  
741 +
751 751  (((
752 752  (% style="color:blue" %)**Default Uplink channel:**
753 753  )))
... ... @@ -856,6 +856,7 @@
856 856  
857 857  === 2.8.6 KR920-923 (KR920) ===
858 858  
850 +
859 859  (((
860 860  (% style="color:blue" %)**Default channel:**
861 861  )))
... ... @@ -928,6 +928,7 @@
928 928  
929 929  === 2.8.7 IN865-867 (IN865) ===
930 930  
923 +
931 931  (((
932 932  (% style="color:blue" %)**Uplink:**
933 933  )))
... ... @@ -964,6 +964,7 @@
964 964  
965 965  == 2.9 LED Indicator ==
966 966  
960 +
967 967  The LSPH01 has an internal LED which is to show the status of different state.
968 968  
969 969  * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
... ... @@ -975,11 +975,9 @@
975 975  == 2.10 ​Firmware Change Log ==
976 976  
977 977  
978 -**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]]
979 979  
980 -[[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/]]
981 981  
982 -
983 983  **Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
984 984  
985 985  
... ... @@ -986,12 +986,13 @@
986 986  
987 987  = 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
988 988  
981 +
989 989  (((
990 990  Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
991 991  )))
992 992  
993 993  * (((
994 -AT Command Connection: See [[FAQ>>path:#H6.FAQ]].
987 +AT Command Connection: See [[FAQ>>||anchor="H6.FAQ"]].
995 995  )))
996 996  * (((
997 997  LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
... ... @@ -1017,7 +1017,7 @@
1017 1017  )))
1018 1018  
1019 1019  (((
1020 -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/]]
1021 1021  )))
1022 1022  
1023 1023  (((
... ... @@ -1036,6 +1036,7 @@
1036 1036  
1037 1037  == 3.1 Set Transmit Interval Time ==
1038 1038  
1032 +
1039 1039  Feature: Change LoRaWAN End Node Transmit Interval.
1040 1040  
1041 1041  (% style="color:#037691" %)**AT Command: AT+TDC**
... ... @@ -1043,7 +1043,6 @@
1043 1043  [[image:image-20220607171554-8.png]]
1044 1044  
1045 1045  
1046 -
1047 1047  (((
1048 1048  (% style="color:#037691" %)**Downlink Command: 0x01**
1049 1049  )))
... ... @@ -1063,16 +1063,18 @@
1063 1063  Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1064 1064  
1065 1065  
1059 +
1066 1066  
1067 1067  )))
1068 1068  
1069 1069  == 3.2 Set Interrupt Mode ==
1070 1070  
1065 +
1071 1071  Feature, Set Interrupt mode for GPIO_EXIT.
1072 1072  
1073 1073  (% style="color:#037691" %)**AT Command: AT+INTMOD**
1074 1074  
1075 -[[image:image-20220607171716-9.png]]
1070 +[[image:image-20220610105907-1.png]]
1076 1076  
1077 1077  
1078 1078  (((
... ... @@ -1102,12 +1102,14 @@
1102 1102  
1103 1103  == 3.3 Calibrate Sensor ==
1104 1104  
1105 -Detail See [[Calibration Guide>>path:#H2.7Calibration]] for the user of 0x13 and 0x14 downlink commands
1106 1106  
1101 +Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1107 1107  
1108 1108  
1104 +
1109 1109  == 3.4 Get Firmware Version Info ==
1110 1110  
1107 +
1111 1111  Feature: use downlink to get firmware version.
1112 1112  
1113 1113  (% style="color:#037691" %)**Downlink Command: 0x26**
... ... @@ -1134,14 +1134,14 @@
1134 1134  
1135 1135  Version
1136 1136  )))|Sensor Type|Reserve|(((
1137 -[[Message Type>>path:#H2.3.6MessageType]]
1134 +[[Message Type>>||anchor="H2.3.6MessageType"]]
1138 1138  Always 0x02
1139 1139  )))
1140 1140  
1141 -**Software Type**: Always 0x03 for LSPH01
1138 +(% style="color:#037691" %)**Software Type**(%%): Always 0x03 for LSPH01
1142 1142  
1143 1143  
1144 -**Frequency Band**:
1141 +(% style="color:#037691" %)**Frequency Band**:
1145 1145  
1146 1146  *0x01: EU868
1147 1147  
... ... @@ -1164,13 +1164,13 @@
1164 1164  *0xa0: AS923-3
1165 1165  
1166 1166  
1167 -**Sub-Band**: value 0x00 ~~ 0x08
1164 +(% style="color:#037691" %)**Sub-Band**(%%): value 0x00 ~~ 0x08
1168 1168  
1169 1169  
1170 -**Firmware Version**: 0x0100, Means: v1.0.0 version
1167 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
1171 1171  
1172 1172  
1173 -**Sensor Type**:
1170 +(% style="color:#037691" %)**Sensor Type**:
1174 1174  
1175 1175  0x01: LSE01
1176 1176  
... ... @@ -1190,14 +1190,18 @@
1190 1190  
1191 1191  = 4. Battery & How to replace =
1192 1192  
1190 +
1193 1193  == 4.1 Battery Type ==
1194 1194  
1193 +
1195 1195  (((
1196 1196  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.
1197 1197  )))
1198 1198  
1199 1199  (((
1200 -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 +
1201 1201  )))
1202 1202  
1203 1203  [[image:1654593587246-335.png]]
... ... @@ -1211,6 +1211,7 @@
1211 1211  
1212 1212  == 4.2 Replace Battery ==
1213 1213  
1215 +
1214 1214  (((
1215 1215  Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1216 1216  )))
... ... @@ -1223,6 +1223,7 @@
1223 1223  
1224 1224  == 4.3 Power Consumption Analyze ==
1225 1225  
1228 +
1226 1226  (((
1227 1227  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.
1228 1228  )))
... ... @@ -1232,12 +1232,12 @@
1232 1232  )))
1233 1233  
1234 1234  
1235 -**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:
1236 1236  
1237 1237  [[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/]]
1238 1238  
1239 1239  
1240 -**Step 2**: Open it and choose
1243 +(% style="color:#037691" %)**Step 2**(%%): Open it and choose
1241 1241  
1242 1242  * Product Model
1243 1243  * Uplink Interval
... ... @@ -1251,13 +1251,13 @@
1251 1251  The battery related documents as below:
1252 1252  
1253 1253  * (((
1254 -[[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/]],
1255 1255  )))
1256 1256  * (((
1257 1257  [[Lithium-Thionyl Chloride Battery  datasheet>>url:https://www.dragino.com/downloads/downloads/datasheet/Battery/ER26500/ER26500_Datasheet-EN.pdf]],
1258 1258  )))
1259 1259  * (((
1260 -[[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/]]
1261 1261  )))
1262 1262  
1263 1263  [[image:image-20220607172042-11.png]]
... ... @@ -1266,6 +1266,7 @@
1266 1266  
1267 1267  === 4.3.1 ​Battery Note ===
1268 1268  
1272 +
1269 1269  (((
1270 1270  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.
1271 1271  )))
... ... @@ -1274,12 +1274,13 @@
1274 1274  
1275 1275  === ​4.3.2 Replace the battery ===
1276 1276  
1281 +
1277 1277  (((
1278 -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 wont be voltage drop between battery and main board.
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.
1279 1279  )))
1280 1280  
1281 1281  (((
1282 -The default battery pack of LSPH01 includes a ER26500 plus super capacitor. If user cant 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)
1283 1283  )))
1284 1284  
1285 1285  
... ... @@ -1286,12 +1286,16 @@
1286 1286  
1287 1287  = 5. Use AT Command =
1288 1288  
1294 +
1289 1289  == 5.1 Access AT Commands ==
1290 1290  
1297 +
1291 1291  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.
1292 1292  
1300 +
1293 1293  [[image:1654593668970-604.png]]
1294 1294  
1303 +
1295 1295  **Connection:**
1296 1296  
1297 1297  (% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
... ... @@ -1308,26 +1308,33 @@
1308 1308  
1309 1309   [[image:1654593712276-618.png]]
1310 1310  
1311 -Valid AT Command please check [[Configure Device>>path:#H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink]].
1320 +Valid AT Command please check [[Configure Device>>||anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
1312 1312  
1313 1313  
1314 1314  = 6. FAQ =
1315 1315  
1325 +
1316 1316  == 6.1 How to change the LoRa Frequency Bands/Region ==
1317 1317  
1318 -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"]].
1319 1319  When downloading the images, choose the required image file for download. ​
1320 1320  
1321 1321  
1333 +
1322 1322  = 7. Trouble Shooting =
1323 1323  
1324 -== 7.1 AT Commands input doesn’t work ==
1325 1325  
1326 -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 ==
1327 1327  
1328 1328  
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 +
1329 1329  = 8. Order Info =
1330 1330  
1346 +
1331 1331  Part Number: (% style="color:blue" %)**LSPH01-XX**
1332 1332  
1333 1333  
... ... @@ -1343,6 +1343,7 @@
1343 1343  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1344 1344  
1345 1345  
1362 +
1346 1346  = 9. ​Packing Info =
1347 1347  
1348 1348  
... ... @@ -1358,9 +1358,12 @@
1358 1358  * Weight / pcs : g
1359 1359  
1360 1360  
1378 +
1361 1361  = 10. ​Support =
1362 1362  
1381 +
1363 1363  * 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.
1364 1364  * 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]].
1365 1365  
1385 +
1366 1366  
image-20220610105907-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +15.5 KB
Content