Show last authors
1 (% style="text-align:center" %)
2 [[image:1654574317295-380.png||height="621" width="576"]]
3
4
5
6 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image001.png]]
7
8
9
10
11
12
13
14
15
16
17
18
19 1. Introduction
20 11. ​What is LoRaWAN Soil pH Sensor
21
22 The Dragino LSPH01 is a **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.
23
24
25 LSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil’s** pH **with high accuracy and stable value. The LSPH01 probe can be buried into soil for long time use.
26
27
28 The LoRa wireless technology used in LSPH01 allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
29
30
31 LSPH01 is powered by **8500mAh Li-SOCI2 battery**, it is designed for long term use up to 5 years.
32
33
34 Each LSPH01 is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
35
36
37 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]]
38
39 *
40 *1. ​Features
41 * LoRaWAN 1.0.3 Class A
42 * Ultra-low power consumption
43 * Monitor soil pH with temperature compensation.
44 * Monitor soil temperature
45 * Monitor Battery Level
46 * Support pH calibration by end user
47 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
48 * AT Commands to change parameters
49 * Uplink on periodically
50 * Downlink to change configure
51 * IP66 Waterproof Enclosure
52 * IP68 rate for the Sensor Probe
53 * 8500mAh Battery for long term use
54
55
56 1.
57 11. Probe Specification
58
59 Soil pH:
60
61 * **Range: 3 ~~ 10 pH **
62 * **Resolution: 0.01 pH**
63 * **Accuracy: ±2% under (0~~50 ℃, Accuracy will poor under 0 due to frozen)**
64 * **Temperature Compensation Range: 0 ~~ 50℃**
65 * IP68 Protection
66 * Length: 3.5 meters
67
68
69 Soil Temperature:
70
71 * **Range** -40℃~8**5**℃
72 * **Resolution: 0.1℃**
73 * **Accuracy:** <±0.5℃(-10℃~40℃),<±0.8℃ (others)
74 * IP68 Protection
75 * Length: 3.5 meters
76
77
78 *
79 *1. ​Applications
80 * Smart Agriculture
81
82
83
84 1.
85 11. Pin mapping and power on
86
87 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image003.png]]
88
89
90
91
92
93 1. Configure LSPH01 to connect to LoRaWAN network
94 11. How it works
95
96 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.
97
98
99 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 >>path:#_​Using_the_AT]]to set the keys in the LSPH01.
100
101
102 1.
103 11. ​Quick guide to connect to LoRaWAN server (OTAA)
104
105 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.
106
107
108 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.png]]
109
110
111 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.
112
113
114 **Step 1**: Create a device in TTN with the OTAA keys from LSPH01.
115
116 Each LSPH01 is shipped with a sticker with the default device EUI as below:
117
118
119 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.png]]
120
121
122
123
124
125 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
126
127
128 **Register the device**
129
130 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image005.png]]
131
132
133 **Add APP EUI and DEV EUI**
134
135
136 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image006.png]]
137
138
139 **Add APP EUI in the application**
140
141
142 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image007.png]]
143
144
145 **Add APP KEY**
146
147 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.png]]
148
149
150 **Step 2**: Power on LSPH01
151
152
153 Put a Jumper on JP2 to power on the device. ( The Switch must be in FLASH position).
154
155
156
157 |(((
158
159 )))
160
161 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.png]]
162
163
164
165
166 **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.
167
168
169
170
171 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
172
173
174
175 1.
176 11. ​Uplink Payload
177
178 LSPH01 will uplink payload via LoRaWAN with below payload format:
179
180
181 Uplink payload includes in total 11 bytes.
182
183
184 Normal uplink payload:
185
186 |(((
187 **Size**
188
189 **(bytes)**
190 )))|**2**|**2**|**2**|**2**|**1**|**1**|**1**
191 |**Value**|[[BAT>>path:#bat]]|(((
192 [[Temperature>>path:#DS18B20]]
193
194 [[( Optional )>>path:#DS18B20]]
195 )))|[[Soil pH>>path:#Soil_Nitrogen]]|[[Soil Temperature>>path:#Soil_Phosphorus]]|(((
196 [[Digital Interrupt>>path:#Int_pin]]
197
198 [[(Optional)>>path:#Int_pin]]
199 )))|Reserve|(((
200 [[Message>>path:#Message_Type]]
201
202 [[Type>>path:#Message_Type]]
203 )))
204
205
206
207
208 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.png]]
209
210
211
212 1.
213 11.
214 111. Battery Info
215
216 Check the battery voltage for LSPH01.
217
218 Ex1: 0x0B45 = 2885mV
219
220 Ex2: 0x0B49 = 2889mV
221
222
223 1.
224 11.
225 111. DS18B20 Temperature sensor
226
227 This is optional, user can connect external DS18B20 sensor to the [[+3.3v, 1-wire and GND pin>>path:#DS18B20]] . and this field will report temperature.
228
229
230 **Example**:
231
232 If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
233
234 If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
235
236
237
238 1.
239 11.
240 111. Soil pH
241
242 Range: 0 ~~ 14 pH
243
244 Example:
245
246 **0x02B7(H) = 695(D) = 6.95pH**
247
248
249 1.
250 11.
251 111. Soil Temperature
252
253 Get Soil Temperature 
254
255
256 **Example**:
257
258 If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
259
260 If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
261
262
263
264 1.
265 11.
266 111. Interrupt Pin
267
268 This data field shows if this packet is generated by interrupt or not. [[Click here>>path:#Int_mod]] for the hardware and software set up.
269
270
271 Example:
272
273 0x00: Normal uplink packet.
274
275 0x01: Interrupt Uplink Packet.
276
277
278 1.
279 11.
280 111. Message Type
281
282 For a normal uplink payload, the message type is always 0x01.
283
284 Valid Message Type:
285
286
287 |Message Type Code|Description|Payload
288 |0x01|Normal Uplink|[[Normal Uplink Payload>>path:#Normal_Uplink]]
289 |0x02|Reply configures info|[[Configure Info Payload>>path:#Configure_Info_Payload]]
290 |0x03|Reply Calibration Info|[[Calibration Payload>>path:#Calibration_Payload]]
291
292
293
294 1.
295 11.
296 111. ​Decode payload in The Things Network
297
298 While using TTN network, you can add the payload format to decode the payload.
299
300
301 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.png]]
302
303 The payload decoder function for TTN is here:
304
305 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/]]
306
307
308 1.
309 11. Uplink Interval
310
311 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:
312
313 [[http:~~/~~/wiki.dragino.com/index.pHp?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval>>url:http://wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands#Change_Uplink_Interval]]
314
315
316
317 1.
318 11. ​Show Data in DataCake IoT Server
319
320 [[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:
321
322
323 **Step 1**: Be sure that your device is programmed and properly connected to the network at this time.
324
325 **Step 2**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:
326
327
328 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.png]]
329
330
331 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.png]]
332
333
334 Step 3: Create an account or log in Datacake.
335
336 Step 4: Create LSPH01 product.
337
338 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image014.png]]
339
340
341
342 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.png]]
343
344
345 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image016.png]]
346
347
348 Step 5: add payload decode
349
350 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/]]
351
352
353 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.png]]
354
355 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image018.png]]
356
357
358 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.png]]
359
360
361 After added, the sensor data arrive TTN, it will also arrive and show in Mydevices.
362
363
364 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image020.png]]
365
366
367
368
369
370 1.
371 11. Installation and Maintain
372 111. Before measurement
373
374
375 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.
376
377
378 1.
379 11.
380 111. Measurement
381
382
383 **Measurement the soil surface**
384
385
386 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.png]] Choose the proper measuring position. Split the surface soil according to the measured deep.
387
388
389 Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
390
391
392 Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting.
393
394
395 Put soil over the probe after insert. And start to measure.
396
397
398 **Measurement inside soil**
399
400
401
402 Dig a hole with diameter > 20CM.
403
404
405 Insert the probe inside, method like measure the surface.
406
407
408 1.
409 11.
410 111. Maintain Probe
411 1111. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
412 1111. 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.
413 1111. Probe reference electrode is also no strong, need to avoid strong force or hitting.
414 1111. User should keep reference electrode wet while not use.
415 1111. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
416 1111. The probe is IP68 can be put in water.
417
418
419
420
421
422 1.
423 11. Calibration
424
425
426 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).
427
428
429 **After stable, user can use below command to calibrate.**
430
431
432 |**pH buffer solution**|**AT Command to calibrate**|**Downlink Command**|**Read Cal Value**
433 |**4.00**|**AT+PHCAL=4**|(((
434 **0x13 04**
435
436 **Reply with Calibrate payload**
437 )))|(((
438 **AT+PHCAL=?**
439
440 **Example 41,61,91**
441 )))
442 |**6.86**|**AT+PHCAL=6**|(((
443 **0x13 06**
444
445 **Reply with Calibrate payload**
446 )))|**AT+PHCAL=?**
447 |**9.18**|**AT+PHCAL=9**|(((
448 **0x13 09**
449
450 **Reply with Calibrate payload**
451 )))|**AT+PHCAL=?**
452 |**Factory Default**|**AT+PHCAL=15**|(((
453 **0x13 15**
454
455 **Reply with Calibrate payload**
456 )))|(((
457 **AT+PHCAL=?**
458
459 **Example 151**
460 )))
461
462
463 Calibration Payload
464
465 |(((
466 **Size**
467
468 **(bytes)**
469 )))|**1**|**1**|**1**|**7**|**1**
470 |**Value**|(((
471 PH4
472
473 Calibrate value
474 )))|PH6.86 Calibrate value|(((
475 PH9.18
476
477 Calibrate value
478 )))|Reserve|(((
479 [[Message>>path:#Message_Type]]
480
481 [[Type>>path:#Message_Type]]
482
483 Always 0x03
484 )))
485
486
487 User can also send 0x14 downlink command to poll the current calibration payload.
488
489
490 |**Downlink Control Type**|**FPort**|**Type Code**|**Downlink payload size(bytes)**
491 |Get Calibration Version Info|Any|14|2
492
493 * Reply to the confirmation package: 14 01
494 * Reply to non-confirmed packet: 14 00
495
496
497
498
499 1.
500 11. Frequency Plans
501
502 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.
503
504 1.
505 11.
506 111. EU863-870 (EU868)
507
508 Uplink:
509
510 868.1 - SF7BW125 to SF12BW125
511
512 868.3 - SF7BW125 to SF12BW125 and SF7BW250
513
514 868.5 - SF7BW125 to SF12BW125
515
516 867.1 - SF7BW125 to SF12BW125
517
518 867.3 - SF7BW125 to SF12BW125
519
520 867.5 - SF7BW125 to SF12BW125
521
522 867.7 - SF7BW125 to SF12BW125
523
524 867.9 - SF7BW125 to SF12BW125
525
526 868.8 - FSK
527
528
529 Downlink:
530
531 Uplink channels 1-9 (RX1)
532
533 869.525 - SF9BW125 (RX2 downlink only)
534
535
536 1.
537 11.
538 111. US902-928(US915)
539
540 Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
541
542
543 To make sure the end node supports all sub band by default. In the OTAA Join process, the end node will use frequency 1 from sub-band1, then frequency 1 from sub-band2, then frequency 1 from sub-band3, etc to process the OTAA join.
544
545
546 After Join success, the end node will switch to the correct sub band by:
547
548 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
549 * 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)
550
551
552 1.
553 11.
554 111. CN470-510 (CN470)
555
556 Used in China, Default use CHE=1
557
558 Uplink:
559
560 486.3 - SF7BW125 to SF12BW125
561
562 486.5 - SF7BW125 to SF12BW125
563
564 486.7 - SF7BW125 to SF12BW125
565
566 486.9 - SF7BW125 to SF12BW125
567
568 487.1 - SF7BW125 to SF12BW125
569
570 487.3 - SF7BW125 to SF12BW125
571
572 487.5 - SF7BW125 to SF12BW125
573
574 487.7 - SF7BW125 to SF12BW125
575
576
577 Downlink:
578
579 506.7 - SF7BW125 to SF12BW125
580
581 506.9 - SF7BW125 to SF12BW125
582
583 507.1 - SF7BW125 to SF12BW125
584
585 507.3 - SF7BW125 to SF12BW125
586
587 507.5 - SF7BW125 to SF12BW125
588
589 507.7 - SF7BW125 to SF12BW125
590
591 507.9 - SF7BW125 to SF12BW125
592
593 508.1 - SF7BW125 to SF12BW125
594
595 505.3 - SF12BW125 (RX2 downlink only)
596
597
598 1.
599 11.
600 111. AU915-928(AU915)
601
602
603 Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
604
605
606 To make sure the end node supports all sub band by default. In the OTAA Join process, the end node will use frequency 1 from sub-band1, then frequency 1 from sub-band2, then frequency 1 from sub-band3, etc to process the OTAA join.
607
608
609 After Join success, the end node will switch to the correct sub band by:
610
611 * Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
612 * 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)
613
614
615
616 1.
617 11.
618 111. AS920-923 & AS923-925 (AS923)
619
620
621 **Default Uplink channel:**
622
623 923.2 - SF7BW125 to SF10BW125
624
625 923.4 - SF7BW125 to SF10BW125
626
627
628 **Additional Uplink Channel**:
629
630 (OTAA mode, channel added by JoinAccept message)
631
632 **AS920~~AS923 for Japan, Malaysia, Singapore**:
633
634 922.2 - SF7BW125 to SF10BW125
635
636 922.4 - SF7BW125 to SF10BW125
637
638 922.6 - SF7BW125 to SF10BW125
639
640 922.8 - SF7BW125 to SF10BW125
641
642 923.0 - SF7BW125 to SF10BW125
643
644 922.0 - SF7BW125 to SF10BW125
645
646
647 **AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam**:
648
649 923.6 - SF7BW125 to SF10BW125
650
651 923.8 - SF7BW125 to SF10BW125
652
653 924.0 - SF7BW125 to SF10BW125
654
655 924.2 - SF7BW125 to SF10BW125
656
657 924.4 - SF7BW125 to SF10BW125
658
659 924.6 - SF7BW125 to SF10BW125
660
661
662
663 **Downlink:**
664
665 Uplink channels 1-8 (RX1)
666
667 923.2 - SF10BW125 (RX2)
668
669
670 1.
671 11.
672 111. KR920-923 (KR920)
673
674 Default channel:
675
676 922.1 - SF7BW125 to SF12BW125
677
678 922.3 - SF7BW125 to SF12BW125
679
680 922.5 - SF7BW125 to SF12BW125
681
682
683 Uplink: (OTAA mode, channel added by JoinAccept message)
684
685 922.1 - SF7BW125 to SF12BW125
686
687 922.3 - SF7BW125 to SF12BW125
688
689 922.5 - SF7BW125 to SF12BW125
690
691 922.7 - SF7BW125 to SF12BW125
692
693 922.9 - SF7BW125 to SF12BW125
694
695 923.1 - SF7BW125 to SF12BW125
696
697 923.3 - SF7BW125 to SF12BW125
698
699
700 Downlink:
701
702 Uplink channels 1-7(RX1)
703
704 921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
705
706
707 1.
708 11.
709 111. IN865-867 (IN865)
710
711
712 Uplink:
713
714 865.0625 - SF7BW125 to SF12BW125
715
716 865.4025 - SF7BW125 to SF12BW125
717
718 865.9850 - SF7BW125 to SF12BW125
719
720
721 Downlink:
722
723 Uplink channels 1-3 (RX1)
724
725 866.550 - SF10BW125 (RX2)
726
727
728 1.
729 11. LED Indicator
730
731 The LSPH01 has an internal LED which is to show the status of different state.
732
733
734 * The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
735 * Blink once when device transmit a packet.
736
737
738
739
740 1.
741 11. ​Firmware Change Log
742
743 **Firmware download link:**
744
745 [[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/]]
746
747
748 **Firmware Upgrade Method:**
749
750 [[http:~~/~~/wiki.dragino.com/index.pHp?title=Firmware_Upgrade_Instruction_for_STM32_base_products#Introduction>>url:http://wiki.dragino.com/index.php?title=Firmware_Upgrade_Instruction_for_STM32_base_products#Introduction]]
751
752
753
754
755
756
757 1. Configure LSPH01 via AT Command or LoRaWAN Downlink
758
759 Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
760
761 * AT Command Connection: See [[FAQ>>path:#AT_COMMAND]].
762 * LoRaWAN Downlink instruction for different platforms:
763
764 [[http:~~/~~/wiki.dragino.com/index.pHp?title=Main_Page#Use_Note_for_Server>>url:http://wiki.dragino.com/index.php?title=Main_Page#Use_Note_for_Server]]
765
766
767 There are two kinds of commands to configure LSPH01, they are:
768
769 * **General Commands**.
770
771 These commands are to configure:
772
773 * General system settings like: uplink interval.
774 * LoRaWAN protocol & radio related command.
775
776 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
777
778 [[http:~~/~~/wiki.dragino.com/index.pHp?title=End_Device_Downlink_Command>>url:http://wiki.dragino.com/index.php?title=End_Device_Downlink_Command]]
779
780
781 * **Commands special design for LSPH01**
782
783 These commands only valid for LSPH01, as below:
784
785
786 1.
787 11. Set Transmit Interval Time
788
789 Feature: Change LoRaWAN End Node Transmit Interval.
790
791 **AT Command: AT+TDC**
792
793 |**Command Example**|**Function**|**Response**
794 |AT+TDC=?|Show current transmit Interval|(((
795 30000
796
797 OK
798
799 the interval is 30000ms = 30s
800 )))
801 |AT+TDC=60000|Set Transmit Interval|(((
802 OK
803
804 Set transmit interval to 60000ms = 60 seconds
805 )))
806
807
808 **Downlink Command: 0x01**
809
810 Format: Command Code (0x01) followed by 3 bytes time value.
811
812 If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
813
814 * Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
815 * Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
816
817
818
819
820 1.
821 11. Set Interrupt Mode
822
823 Feature, Set Interrupt mode for GPIO_EXIT.
824
825 **AT Command: AT+INTMOD**
826
827 |**Command Example**|**Function**|**Response**
828 |AT+INTMOD=?|Show current interrupt mode|(((
829 0
830
831 OK
832
833 the mode is 0 = No interruption
834 )))
835 |AT+INTMOD=2|(((
836 Set Transmit Interval
837
838 1. (Disable Interrupt),
839 1. (Trigger by rising and falling edge),
840 1. (Trigger by falling edge)
841 1. (Trigger by rising edge)
842 )))|OK
843
844
845 **Downlink Command: 0x06**
846
847 Format: Command Code (0x06) followed by 3 bytes.
848
849 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
850
851 * Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
852 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
853
854
855
856 1.
857 11. Calibrate Sensor
858
859 Detail See [[Calibration Guide>>path:#Calibration]] for the user of 0x13 and 0x14 downlink commands
860
861
862
863 1.
864 11. Get Firmware Version Info
865
866 Feature: use downlink to get firmware version.
867
868
869 **Downlink Command: 0x26**
870
871
872 |**Downlink Control Type**|**FPort**|**Type Code**|**Downlink payload size(bytes)**
873 |Get Firmware Version Info|Any|26|2
874
875
876 * Reply to the confirmation package: 26 01
877 * Reply to non-confirmed packet: 26 00
878
879
880 Device will send an uplink after got this downlink command. With below payload:
881
882 Configures info payload:
883
884 |(((
885 **Size**
886
887 **(bytes)**
888 )))|**1**|**1**|**1**|**1**|**1**|**5**|**1**
889 |**Value**|Software Type|(((
890 Frequency
891
892 Band
893 )))|Sub-band|(((
894 Firmware
895
896 Version
897 )))|Sensor Type|Reserve|(((
898 [[Message>>path:#Message_Type]]
899
900 [[Type>>path:#Message_Type]]
901
902 Always 0x02
903 )))
904
905
906 **Software Type**: Always 0x03 for LSPH01
907
908
909 **Frequency Band**:
910
911 *0x01: EU868
912
913 *0x02: US915
914
915 *0x03: IN865
916
917 *0x04: AU915
918
919 *0x05: KZ865
920
921 *0x06: RU864
922
923 *0x07: AS923
924
925 *0x08: AS923-1
926
927 *0x09: AS923-2
928
929 *0xa0: AS923-3
930
931
932 **Sub-Band**: value 0x00 ~~ 0x08
933
934
935 **Firmware Version**: 0x0100, Means: v1.0.0 version
936
937
938 **Sensor Type**:
939
940 0x01: LSE01
941
942 0x02: LDDS75
943
944 0x03: LDDS20
945
946 0x04: LLMS01
947
948 0x05: LSPH01
949
950 0x06: LSNPK01
951
952 0x07: LDDS12
953
954
955
956
957
958
959 1. Battery & How to replace
960 11. Battery Type
961
962 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.
963
964
965 The discharge curve is not linear so can’t simply use percentage to show the battery level. Below is the battery performance.
966
967 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image022.png]]
968
969
970 Minimum Working Voltage for the LSPH01:
971
972 LSPH01:  2.45v ~~ 3.6v
973
974
975 1.
976 11. Replace Battery
977
978 Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
979
980 And make sure the positive and negative pins match.
981
982
983
984 1.
985 11. Power Consumption Analyze
986
987
988 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.
989
990
991 Instruction to use as below:
992
993
994 Step 1: Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
995
996 [[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/]]
997
998
999 Step 2: Open it and choose
1000
1001 * Product Model
1002 * Uplink Interval
1003 * Working Mode
1004
1005 And the Life expectation in difference case will be shown on the right.
1006
1007 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.png]]
1008
1009
1010 The battery related documents as below:
1011
1012 * [[Battery Dimension>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]],
1013 * [[Lithium-Thionyl Chloride Battery>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] datasheet
1014 * [[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]]
1015
1016
1017
1018 |(((
1019 JST-XH-2P connector
1020 )))
1021
1022 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]]
1023
1024
1025
1026 1.
1027 11.
1028 111. ​Battery Note
1029
1030 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.
1031
1032
1033 1.
1034 11.
1035 111. ​Replace the battery
1036
1037 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.
1038
1039
1040 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)
1041
1042
1043
1044
1045
1046
1047 1. Use AT Command
1048 11. Access AT Commands
1049
1050
1051 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.
1052
1053 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
1054
1055 Connection:
1056
1057 USB TTL GND <~-~-~-~-> GND
1058
1059 USB TTL TXD <~-~-~-~-> UART_RXD
1060
1061 USB TTL RXD <~-~-~-~-> UART_TXD
1062
1063
1064 In the PC, you need to set the serial baud rate to **9600** to access the serial console for LSPH01. LSPH01 will output system info once power on as below:
1065
1066
1067 [[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
1068
1069 Valid AT Command please check [[Configure Device>>path:#Configure_Device]].
1070
1071
1072
1073
1074 1. FAQ
1075 11. How to change the LoRa Frequency Bands/Region
1076
1077 You can follow the instructions for [[how to upgrade image>>path:#3ygebqi]].
1078 When downloading the images, choose the required image file for download. ​
1079
1080
1081
1082 1. Trouble Shooting
1083 11. AT Commands input doesn’t work
1084
1085
1086 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 **ENTER** while sending out the command. Some serial tool doesn’t send **ENTER** while press the send key, user need to add ENTER in their string.
1087
1088
1089 1. Order Info
1090
1091
1092 Part Number: **LSPH01-XX**
1093
1094
1095 **XX**: The default frequency band
1096
1097 * **AS923**: LoRaWAN AS923 band
1098 * **AU915**: LoRaWAN AU915 band
1099 * **EU433**: LoRaWAN EU433 band
1100 * **EU868**: LoRaWAN EU868 band
1101 * **KR920**: LoRaWAN KR920 band
1102 * **US915**: LoRaWAN US915 band
1103 * **IN865**: LoRaWAN IN865 band
1104 * **CN470**: LoRaWAN CN470 band
1105
1106
1107
1108 1. ​Packing Info
1109
1110 **Package Includes**:
1111
1112 * LSPH01 LoRaWAN Soil Ph Sensor x 1
1113
1114
1115 **Dimension and weight**:
1116
1117 * Device Size: cm
1118 * Device Weight: g
1119 * Package Size / pcs : cm
1120 * Weight / pcs : g
1121
1122
1123
1124 = 10. ​Support =
1125
1126 * 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.
1127 * 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
1128
1129 [[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]]
1130
1131
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0