Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -5,14 +5,6 @@
5	5
6	6
7	7
8		-
9		-
10		-
11		-
12		-
13		-
14		-
15		-
16	16	**Table of Contents:**
17	17
18	18	{{toc/}}
...	...	@@ -22,17 +22,13 @@
22	22
23	23
24	24
25		-
26		-
27		-
28		-
29	29	= 1. Introduction =
30	30
	19	+
31	31	== 1.1 ​What is LoRaWAN Soil pH Sensor ==
32	32
33		-(((
34		-
35	35
	23	+(((
36	36	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.
37	37	)))
38	38
...	...	@@ -57,9 +57,9 @@
57	57
58	58
59	59
60		-
61	61	== ​1.2 Features ==
62	62
	50	+
63	63	* LoRaWAN 1.0.3 Class A
64	64	* Ultra-low power consumption
65	65	* Monitor soil pH with temperature compensation.
...	...	@@ -74,6 +74,8 @@
74	74	* IP68 rate for the Sensor Probe
75	75	* 8500mAh Battery for long term use
76	76
	65	+
	66	+
77	77	== 1.3 Probe Specification ==
78	78
79	79
...	...	@@ -94,12 +94,17 @@
94	94	* IP68 Protection
95	95	* Length: 3.5 meters
96	96
	87	+
	88	+
97	97	== 1.4 ​Applications ==
98	98
	91	+
99	99	* Smart Agriculture
100	100
	94	+
101	101	== 1.5 Pin mapping and power on ==
102	102
	97	+
103	103	[[image:1654592472094-134.png]]
104	104
105	105
...	...	@@ -106,19 +106,23 @@
106	106
107	107	= 2. Configure LSPH01 to connect to LoRaWAN network =
108	108
	104	+
109	109	== 2.1 How it works ==
110	110
	107	+
111	111	(((
112	112	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.
113	113	)))
114	114
115	115	(((
116		-In case you can’t set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>||anchor="H5.UseATCommand"]]to set the keys in the LSPH01.
	113	+In case you can't set the OTAA keys in the LoRaWAN OTAA server, and you have to use the keys from the server, you can [[use AT Commands >>||anchor="H5.UseATCommand"]]to set the keys in the LSPH01.
117	117	)))
118	118
119	119
	117	+
120	120	== 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
121	121
	120	+
122	122	(((
123	123	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.
124	124	)))
...	...	@@ -184,6 +184,8 @@
184	184
185	185	(((
186	186	(% 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.
	186	+
	187	+
187	187	)))
188	188
189	189	[[image:1654592697690-910.png]]
...	...	@@ -192,6 +192,7 @@
192	192
193	193	== 2.3 ​Uplink Payload ==
194	194
	196	+
195	195	(((
196	196	LSPH01 will uplink payload via LoRaWAN with below payload format:
197	197	)))
...	...	@@ -204,14 +204,11 @@
204	204	Normal uplink payload:
205	205	)))
206	206
207		-(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
208		-|=(% style="width: 62.5px;" %)(((
209		-**Size (bytes)**
210		-)))|=(% style="width: 62.5px;" %)**2**|=(% style="width: 62.5px;" %)**2**|=**2**|=**2**|=**1**|=**1**|=**1**
	209	+(% border="1" cellspacing="5" style="background-color:#ffffcc; width:490px" %)
	210	+|=(% style="width: 60px;" %)(((
	211	+**Size (bytes)**)))|=(% style="width: 30px;" %)**2**|=(% style="width: 70px;" %)**2**|=(% style="width: 50px;" %)**2**|=(% style="width: 60px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 50px;" %)**1**|=(% style="width: 80px;" %)**1**
211	211	|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
212		-[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
213		-
214		-[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
	213	+[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
215	215	)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
216	216	[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
217	217	)))|Reserve|(((
...	...	@@ -235,6 +235,7 @@
235	235
236	236	=== 2.3.2 DS18B20 Temperature sensor ===
237	237
	237	+
238	238	This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
239	239
240	240
...	...	@@ -248,6 +248,7 @@
248	248
249	249	=== 2.3.3 Soil pH ===
250	250
	251	+
251	251	Range: 0 ~~ 14 pH
252	252
253	253	**Example:**
...	...	@@ -258,6 +258,7 @@
258	258
259	259	=== 2.3.4 Soil Temperature ===
260	260
	262	+
261	261	Get Soil Temperature
262	262
263	263
...	...	@@ -271,6 +271,7 @@
271	271
272	272	=== 2.3.5 Interrupt Pin ===
273	273
	276	+
274	274	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.
275	275
276	276
...	...	@@ -284,6 +284,7 @@
284	284
285	285	=== 2.3.6 Message Type ===
286	286
	290	+
287	287	(((
288	288	For a normal uplink payload, the message type is always 0x01.
289	289	)))
...	...	@@ -299,6 +299,8 @@
299	299	|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
300	300	|(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
301	301
	306	+
	307	+
302	302	=== 2.3.7 Decode payload in The Things Network ===
303	303
304	304	While using TTN network, you can add the payload format to decode the payload.
...	...	@@ -311,7 +311,7 @@
311	311	)))
312	312
313	313	(((
314		-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/]]
	320	+LSPH01 TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
315	315	)))
316	316
317	317
...	...	@@ -318,6 +318,7 @@
318	318
319	319	== 2.4 Uplink Interval ==
320	320
	327	+
321	321	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"]]
322	322
323	323
...	...	@@ -324,6 +324,7 @@
324	324
325	325	== 2.5 ​Show Data in DataCake IoT Server ==
326	326
	334	+
327	327	(((
328	328	[[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:
329	329	)))
...	...	@@ -366,7 +366,7 @@
366	366	)))
367	367
368	368	(((
369		-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/]]
	377	+Download Datacake decoder from: [[https:~~/~~/www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>url:https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]]
370	370	)))
371	371
372	372
...	...	@@ -387,8 +387,10 @@
387	387
388	388	== 2.6 Installation and Maintain ==
389	389
	398	+
390	390	=== 2.6.1 Before measurement ===
391	391
	401	+
392	392	(((
393	393	(((
394	394	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.
...	...	@@ -406,6 +406,8 @@
406	406
407	407	(((
408	408	[[image:1654592946732-634.png]]
	419	+
	420	+
409	409	)))
410	410
411	411	(((
...	...	@@ -417,7 +417,7 @@
417	417	)))
418	418
419	419	(((
420		-Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting.
	432	+Slowly insert the probe to the measure point. Don't use large force which will break the probe. Make sure not shake when inserting.
421	421	)))
422	422
423	423	(((
...	...	@@ -444,6 +444,7 @@
444	444
445	445	=== 2.6.3 Maintain Probe ===
446	446
	459	+
447	447	1. (((
448	448	pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
449	449	)))
...	...	@@ -468,6 +468,7 @@
468	468
469	469	== 2.7 Calibration ==
470	470
	484	+
471	471	(((
472	472	User can do calibration for the probe. It is limited to use below pH buffer solution to calibrate: 4.00, 6.86, 9.18. When calibration, user need to clean the electrode and put the probe in the pH buffer solution to wait the value stable ( a new clean electrode might need max 24 hours to be stable).
473	473	)))
...	...	@@ -507,15 +507,19 @@
507	507	* Reply to the confirmation package: 14 01
508	508	* Reply to non-confirmed packet: 14 00
509	509
	524	+
510	510	== 2.8 Frequency Plans ==
511	511
	527	+
512	512	(((
513	513	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.
514	514	)))
515	515
516	516
	533	+
517	517	=== 2.8.1 EU863-870 (EU868) ===
518	518
	536	+
519	519	(((
520	520	(% style="color:blue" %)**Uplink:**
521	521	)))
...	...	@@ -576,6 +576,7 @@
576	576
577	577	=== 2.8.2 US902-928(US915) ===
578	578
	597	+
579	579	(((
580	580	Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
581	581	)))
...	...	@@ -589,13 +589,13 @@
589	589	)))
590	590
591	591	* Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
592		-* 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)
	611	+* 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)
593	593
594	594
595	595
596		-
597	597	=== 2.8.3 CN470-510 (CN470) ===
598	598
	617	+
599	599	(((
600	600	Used in China, Default use CHE=1
601	601	)))
...	...	@@ -684,6 +684,7 @@
684	684
685	685	=== 2.8.4 AU915-928(AU915) ===
686	686
	706	+
687	687	(((
688	688	Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
689	689	)))
...	...	@@ -701,13 +701,13 @@
701	701	)))
702	702
703	703	* Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
704		-* 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)
	724	+* 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)
705	705
706	706
707	707
708		-
709	709	=== 2.8.5 AS920-923 & AS923-925 (AS923) ===
710	710
	730	+
711	711	(((
712	712	(% style="color:blue" %)**Default Uplink channel:**
713	713	)))
...	...	@@ -816,6 +816,7 @@
816	816
817	817	=== 2.8.6 KR920-923 (KR920) ===
818	818
	839	+
819	819	(((
820	820	(% style="color:blue" %)**Default channel:**
821	821	)))
...	...	@@ -888,6 +888,7 @@
888	888
889	889	=== 2.8.7 IN865-867 (IN865) ===
890	890
	912	+
891	891	(((
892	892	(% style="color:blue" %)**Uplink:**
893	893	)))
...	...	@@ -924,6 +924,7 @@
924	924
925	925	== 2.9 LED Indicator ==
926	926
	949	+
927	927	The LSPH01 has an internal LED which is to show the status of different state.
928	928
929	929	* The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
...	...	@@ -931,15 +931,12 @@
931	931
932	932
933	933
934		-
935	935	== 2.10 ​Firmware Change Log ==
936	936
937	937
938		-**Firmware download link:**
	960	+**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0>>https://www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0]]
939	939
940		-[[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/]]
941	941
942		-
943	943	**Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
944	944
945	945
...	...	@@ -946,6 +946,7 @@
946	946
947	947	= 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
948	948
	969	+
949	949	(((
950	950	Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
951	951	)))
...	...	@@ -977,7 +977,7 @@
977	977	)))
978	978
979	979	(((
980		-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/]]
	1001	+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/]]
981	981	)))
982	982
983	983	(((
...	...	@@ -996,6 +996,7 @@
996	996
997	997	== 3.1 Set Transmit Interval Time ==
998	998
	1020	+
999	999	Feature: Change LoRaWAN End Node Transmit Interval.
1000	1000
1001	1001	(% style="color:#037691" %)**AT Command: AT+TDC**
...	...	@@ -1022,11 +1022,13 @@
1022	1022	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1023	1023
1024	1024
	1047	+
1025	1025
1026	1026	)))
1027	1027
1028	1028	== 3.2 Set Interrupt Mode ==
1029	1029
	1053	+
1030	1030	Feature, Set Interrupt mode for GPIO_EXIT.
1031	1031
1032	1032	(% style="color:#037691" %)**AT Command: AT+INTMOD**
...	...	@@ -1061,6 +1061,7 @@
1061	1061
1062	1062	== 3.3 Calibrate Sensor ==
1063	1063
	1088	+
1064	1064	Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1065	1065
1066	1066
...	...	@@ -1067,6 +1067,7 @@
1067	1067
1068	1068	== 3.4 Get Firmware Version Info ==
1069	1069
	1095	+
1070	1070	Feature: use downlink to get firmware version.
1071	1071
1072	1072	(% style="color:#037691" %)**Downlink Command: 0x26**
...	...	@@ -1149,8 +1149,10 @@
1149	1149
1150	1150	= 4. Battery & How to replace =
1151	1151
	1178	+
1152	1152	== 4.1 Battery Type ==
1153	1153
	1181	+
1154	1154	(((
1155	1155	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.
1156	1156	)))
...	...	@@ -1157,6 +1157,8 @@
1157	1157
1158	1158	(((
1159	1159	The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
	1188	+
	1189	+
1160	1160	)))
1161	1161
1162	1162	[[image:1654593587246-335.png]]
...	...	@@ -1170,6 +1170,7 @@
1170	1170
1171	1171	== 4.2 Replace Battery ==
1172	1172
	1203	+
1173	1173	(((
1174	1174	Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1175	1175	)))
...	...	@@ -1182,6 +1182,7 @@
1182	1182
1183	1183	== 4.3 Power Consumption Analyze ==
1184	1184
	1216	+
1185	1185	(((
1186	1186	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.
1187	1187	)))
...	...	@@ -1225,6 +1225,7 @@
1225	1225
1226	1226	=== 4.3.1 ​Battery Note ===
1227	1227
	1260	+
1228	1228	(((
1229	1229	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.
1230	1230	)))
...	...	@@ -1233,12 +1233,13 @@
1233	1233
1234	1234	=== ​4.3.2 Replace the battery ===
1235	1235
	1269	+
1236	1236	(((
1237	1237	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.
1238	1238	)))
1239	1239
1240	1240	(((
1241		-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)
	1275	+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)
1242	1242	)))
1243	1243
1244	1244
...	...	@@ -1245,12 +1245,16 @@
1245	1245
1246	1246	= 5. Use AT Command =
1247	1247
	1282	+
1248	1248	== 5.1 Access AT Commands ==
1249	1249
	1285	+
1250	1250	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.
1251	1251
	1288	+
1252	1252	[[image:1654593668970-604.png]]
1253	1253
	1291	+
1254	1254	**Connection:**
1255	1255
1256	1256	(% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
...	...	@@ -1272,16 +1272,21 @@
1272	1272
1273	1273	= 6. FAQ =
1274	1274
	1313	+
1275	1275	== 6.1 How to change the LoRa Frequency Bands/Region ==
1276	1276
	1316	+
1277	1277	You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1278	1278	When downloading the images, choose the required image file for download. ​
1279	1279
1280	1280
	1321	+
1281	1281	= 7. Trouble Shooting =
1282	1282
	1324	+
1283	1283	== 7.1 AT Commands input doesn't work ==
1284	1284
	1327	+
1285	1285	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.
1286	1286
1287	1287
...	...	@@ -1288,6 +1288,7 @@
1288	1288
1289	1289	= 8. Order Info =
1290	1290
	1334	+
1291	1291	Part Number: (% style="color:blue" %)**LSPH01-XX**
1292	1292
1293	1293
...	...	@@ -1303,7 +1303,6 @@
1303	1303	* (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
1304	1304
1305	1305
1306		-
1307	1307	= 9. ​Packing Info =
1308	1308
1309	1309
...	...	@@ -1319,9 +1319,9 @@
1319	1319	* Weight / pcs : g
1320	1320
1321	1321
1322		-
1323	1323	= 10. ​Support =
1324	1324
	1367	+
1325	1325	* 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.
1326	1326	* 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]].
1327	1327