Summary

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

Details

Page properties

Content

...	...	@@ -5,10 +5,6 @@
5	5
6	6
7	7
8		-
9		-
10		-
11		-
12	12	**Table of Contents:**
13	13
14	14	{{toc/}}
...	...	@@ -18,17 +18,13 @@
18	18
19	19
20	20
21		-
22		-
23		-
24		-
25	25	= 1. Introduction =
26	26
	19	+
27	27	== 1.1 ​What is LoRaWAN Soil pH Sensor ==
28	28
29		-(((
30		-
31	31
	23	+(((
32	32	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.
33	33	)))
34	34
...	...	@@ -53,9 +53,9 @@
53	53
54	54
55	55
56		-
57	57	== ​1.2 Features ==
58	58
	50	+
59	59	* LoRaWAN 1.0.3 Class A
60	60	* Ultra-low power consumption
61	61	* Monitor soil pH with temperature compensation.
...	...	@@ -72,7 +72,6 @@
72	72
73	73
74	74
75		-
76	76	== 1.3 Probe Specification ==
77	77
78	78
...	...	@@ -95,16 +95,15 @@
95	95
96	96
97	97
98		-
99	99	== 1.4 ​Applications ==
100	100
	91	+
101	101	* Smart Agriculture
102	102
103	103
104		-
105		-
106	106	== 1.5 Pin mapping and power on ==
107	107
	97	+
108	108	[[image:1654592472094-134.png]]
109	109
110	110
...	...	@@ -111,19 +111,23 @@
111	111
112	112	= 2. Configure LSPH01 to connect to LoRaWAN network =
113	113
	104	+
114	114	== 2.1 How it works ==
115	115
	107	+
116	116	(((
117	117	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.
118	118	)))
119	119
120	120	(((
121		-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.
122	122	)))
123	123
124	124
	117	+
125	125	== 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
126	126
	120	+
127	127	(((
128	128	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.
129	129	)))
...	...	@@ -189,6 +189,8 @@
189	189
190	190	(((
191	191	(% 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	+
192	192	)))
193	193
194	194	[[image:1654592697690-910.png]]
...	...	@@ -197,6 +197,7 @@
197	197
198	198	== 2.3 ​Uplink Payload ==
199	199
	196	+
200	200	(((
201	201	LSPH01 will uplink payload via LoRaWAN with below payload format:
202	202	)))
...	...	@@ -209,14 +209,11 @@
209	209	Normal uplink payload:
210	210	)))
211	211
212		-(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
213		-|=(% style="width: 62.5px;" %)(((
214		-**Size (bytes)**
215		-)))|=(% 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**
216	216	|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
217		-[[Temperature>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
218		-
219		-[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
	213	+[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
220	220	)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
221	221	[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
222	222	)))|Reserve|(((
...	...	@@ -240,6 +240,7 @@
240	240
241	241	=== 2.3.2 DS18B20 Temperature sensor ===
242	242
	237	+
243	243	This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
244	244
245	245
...	...	@@ -253,6 +253,7 @@
253	253
254	254	=== 2.3.3 Soil pH ===
255	255
	251	+
256	256	Range: 0 ~~ 14 pH
257	257
258	258	**Example:**
...	...	@@ -263,6 +263,7 @@
263	263
264	264	=== 2.3.4 Soil Temperature ===
265	265
	262	+
266	266	Get Soil Temperature
267	267
268	268
...	...	@@ -276,6 +276,7 @@
276	276
277	277	=== 2.3.5 Interrupt Pin ===
278	278
	276	+
279	279	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.
280	280
281	281
...	...	@@ -289,6 +289,7 @@
289	289
290	290	=== 2.3.6 Message Type ===
291	291
	290	+
292	292	(((
293	293	For a normal uplink payload, the message type is always 0x01.
294	294	)))
...	...	@@ -306,7 +306,6 @@
306	306
307	307
308	308
309		-
310	310	=== 2.3.7 Decode payload in The Things Network ===
311	311
312	312	While using TTN network, you can add the payload format to decode the payload.
...	...	@@ -319,7 +319,7 @@
319	319	)))
320	320
321	321	(((
322		-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]]
323	323	)))
324	324
325	325
...	...	@@ -326,6 +326,7 @@
326	326
327	327	== 2.4 Uplink Interval ==
328	328
	327	+
329	329	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"]]
330	330
331	331
...	...	@@ -332,6 +332,7 @@
332	332
333	333	== 2.5 ​Show Data in DataCake IoT Server ==
334	334
	334	+
335	335	(((
336	336	[[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:
337	337	)))
...	...	@@ -374,7 +374,7 @@
374	374	)))
375	375
376	376	(((
377		-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]]
378	378	)))
379	379
380	380
...	...	@@ -395,8 +395,10 @@
395	395
396	396	== 2.6 Installation and Maintain ==
397	397
	398	+
398	398	=== 2.6.1 Before measurement ===
399	399
	401	+
400	400	(((
401	401	(((
402	402	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.
...	...	@@ -414,6 +414,8 @@
414	414
415	415	(((
416	416	[[image:1654592946732-634.png]]
	419	+
	420	+
417	417	)))
418	418
419	419	(((
...	...	@@ -425,7 +425,7 @@
425	425	)))
426	426
427	427	(((
428		-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.
429	429	)))
430	430
431	431	(((
...	...	@@ -452,6 +452,7 @@
452	452
453	453	=== 2.6.3 Maintain Probe ===
454	454
	459	+
455	455	1. (((
456	456	pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
457	457	)))
...	...	@@ -476,6 +476,7 @@
476	476
477	477	== 2.7 Calibration ==
478	478
	484	+
479	479	(((
480	480	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).
481	481	)))
...	...	@@ -516,19 +516,18 @@
516	516	* Reply to non-confirmed packet: 14 00
517	517
518	518
519		-
520		-
521		-
522		-
523	523	== 2.8 Frequency Plans ==
524	524
	527	+
525	525	(((
526	526	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.
527	527	)))
528	528
529	529
	533	+
530	530	=== 2.8.1 EU863-870 (EU868) ===
531	531
	536	+
532	532	(((
533	533	(% style="color:blue" %)**Uplink:**
534	534	)))
...	...	@@ -589,6 +589,7 @@
589	589
590	590	=== 2.8.2 US902-928(US915) ===
591	591
	597	+
592	592	(((
593	593	Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
594	594	)))
...	...	@@ -602,13 +602,13 @@
602	602	)))
603	603
604	604	* Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
605		-* 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)
606	606
607	607
608	608
609		-
610	610	=== 2.8.3 CN470-510 (CN470) ===
611	611
	617	+
612	612	(((
613	613	Used in China, Default use CHE=1
614	614	)))
...	...	@@ -697,6 +697,7 @@
697	697
698	698	=== 2.8.4 AU915-928(AU915) ===
699	699
	706	+
700	700	(((
701	701	Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
702	702	)))
...	...	@@ -714,13 +714,13 @@
714	714	)))
715	715
716	716	* Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
717		-* 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)
718	718
719	719
720	720
721		-
722	722	=== 2.8.5 AS920-923 & AS923-925 (AS923) ===
723	723
	730	+
724	724	(((
725	725	(% style="color:blue" %)**Default Uplink channel:**
726	726	)))
...	...	@@ -829,6 +829,7 @@
829	829
830	830	=== 2.8.6 KR920-923 (KR920) ===
831	831
	839	+
832	832	(((
833	833	(% style="color:blue" %)**Default channel:**
834	834	)))
...	...	@@ -901,6 +901,7 @@
901	901
902	902	=== 2.8.7 IN865-867 (IN865) ===
903	903
	912	+
904	904	(((
905	905	(% style="color:blue" %)**Uplink:**
906	906	)))
...	...	@@ -937,6 +937,7 @@
937	937
938	938	== 2.9 LED Indicator ==
939	939
	949	+
940	940	The LSPH01 has an internal LED which is to show the status of different state.
941	941
942	942	* The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
...	...	@@ -944,15 +944,12 @@
944	944
945	945
946	946
947		-
948	948	== 2.10 ​Firmware Change Log ==
949	949
950	950
951		-**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]]
952	952
953		-[[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/]]
954	954
955		-
956	956	**Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
957	957
958	958
...	...	@@ -959,6 +959,7 @@
959	959
960	960	= 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
961	961
	969	+
962	962	(((
963	963	Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
964	964	)))
...	...	@@ -990,7 +990,7 @@
990	990	)))
991	991
992	992	(((
993		-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/]]
994	994	)))
995	995
996	996	(((
...	...	@@ -1009,6 +1009,7 @@
1009	1009
1010	1010	== 3.1 Set Transmit Interval Time ==
1011	1011
	1020	+
1012	1012	Feature: Change LoRaWAN End Node Transmit Interval.
1013	1013
1014	1014	(% style="color:#037691" %)**AT Command: AT+TDC**
...	...	@@ -1035,11 +1035,13 @@
1035	1035	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1036	1036
1037	1037
	1047	+
1038	1038
1039	1039	)))
1040	1040
1041	1041	== 3.2 Set Interrupt Mode ==
1042	1042
	1053	+
1043	1043	Feature, Set Interrupt mode for GPIO_EXIT.
1044	1044
1045	1045	(% style="color:#037691" %)**AT Command: AT+INTMOD**
...	...	@@ -1074,6 +1074,7 @@
1074	1074
1075	1075	== 3.3 Calibrate Sensor ==
1076	1076
	1088	+
1077	1077	Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1078	1078
1079	1079
...	...	@@ -1080,6 +1080,7 @@
1080	1080
1081	1081	== 3.4 Get Firmware Version Info ==
1082	1082
	1095	+
1083	1083	Feature: use downlink to get firmware version.
1084	1084
1085	1085	(% style="color:#037691" %)**Downlink Command: 0x26**
...	...	@@ -1162,8 +1162,10 @@
1162	1162
1163	1163	= 4. Battery & How to replace =
1164	1164
	1178	+
1165	1165	== 4.1 Battery Type ==
1166	1166
	1181	+
1167	1167	(((
1168	1168	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.
1169	1169	)))
...	...	@@ -1170,6 +1170,8 @@
1170	1170
1171	1171	(((
1172	1172	The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
	1188	+
	1189	+
1173	1173	)))
1174	1174
1175	1175	[[image:1654593587246-335.png]]
...	...	@@ -1183,6 +1183,7 @@
1183	1183
1184	1184	== 4.2 Replace Battery ==
1185	1185
	1203	+
1186	1186	(((
1187	1187	Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1188	1188	)))
...	...	@@ -1195,6 +1195,7 @@
1195	1195
1196	1196	== 4.3 Power Consumption Analyze ==
1197	1197
	1216	+
1198	1198	(((
1199	1199	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.
1200	1200	)))
...	...	@@ -1204,7 +1204,7 @@
1204	1204	)))
1205	1205
1206	1206
1207		-(% style="color:red" %)**Step 1**(%%): Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
	1226	+(% style="color:#037691" %)**Step 1**(%%): Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
1208	1208
1209	1209	[[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/]]
1210	1210
...	...	@@ -1238,6 +1238,7 @@
1238	1238
1239	1239	=== 4.3.1 ​Battery Note ===
1240	1240
	1260	+
1241	1241	(((
1242	1242	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.
1243	1243	)))
...	...	@@ -1246,12 +1246,13 @@
1246	1246
1247	1247	=== ​4.3.2 Replace the battery ===
1248	1248
	1269	+
1249	1249	(((
1250	1250	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.
1251	1251	)))
1252	1252
1253	1253	(((
1254		-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)
1255	1255	)))
1256	1256
1257	1257
...	...	@@ -1258,12 +1258,16 @@
1258	1258
1259	1259	= 5. Use AT Command =
1260	1260
	1282	+
1261	1261	== 5.1 Access AT Commands ==
1262	1262
	1285	+
1263	1263	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.
1264	1264
	1288	+
1265	1265	[[image:1654593668970-604.png]]
1266	1266
	1291	+
1267	1267	**Connection:**
1268	1268
1269	1269	(% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
...	...	@@ -1285,16 +1285,21 @@
1285	1285
1286	1286	= 6. FAQ =
1287	1287
	1313	+
1288	1288	== 6.1 How to change the LoRa Frequency Bands/Region ==
1289	1289
	1316	+
1290	1290	You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1291	1291	When downloading the images, choose the required image file for download. ​
1292	1292
1293	1293
	1321	+
1294	1294	= 7. Trouble Shooting =
1295	1295
	1324	+
1296	1296	== 7.1 AT Commands input doesn't work ==
1297	1297
	1327	+
1298	1298	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.
1299	1299
1300	1300
...	...	@@ -1301,6 +1301,7 @@
1301	1301
1302	1302	= 8. Order Info =
1303	1303
	1334	+
1304	1304	Part Number: (% style="color:blue" %)**LSPH01-XX**
1305	1305
1306	1306
...	...	@@ -1333,6 +1333,7 @@
1333	1333
1334	1334	= 10. ​Support =
1335	1335
	1367	+
1336	1336	* 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.
1337	1337	* 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]].
1338	1338