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.
...	...	@@ -100,12 +100,13 @@
100	100
101	101	== 1.4 ​Applications ==
102	102
	91	+
103	103	* Smart Agriculture
104	104
105	105
106		-
107	107	== 1.5 Pin mapping and power on ==
108	108
	97	+
109	109	[[image:1654592472094-134.png]]
110	110
111	111
...	...	@@ -112,8 +112,10 @@
112	112
113	113	= 2. Configure LSPH01 to connect to LoRaWAN network =
114	114
	104	+
115	115	== 2.1 How it works ==
116	116
	107	+
117	117	(((
118	118	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.
119	119	)))
...	...	@@ -123,8 +123,10 @@
123	123	)))
124	124
125	125
	117	+
126	126	== 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
127	127
	120	+
128	128	(((
129	129	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.
130	130	)))
...	...	@@ -190,6 +190,8 @@
190	190
191	191	(((
192	192	(% 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	+
193	193	)))
194	194
195	195	[[image:1654592697690-910.png]]
...	...	@@ -198,6 +198,7 @@
198	198
199	199	== 2.3 ​Uplink Payload ==
200	200
	196	+
201	201	(((
202	202	LSPH01 will uplink payload via LoRaWAN with below payload format:
203	203	)))
...	...	@@ -210,14 +210,11 @@
210	210	Normal uplink payload:
211	211	)))
212	212
213		-(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
214		-|=(% style="width: 62.5px;" %)(((
215		-**Size (bytes)**
216		-)))|=(% 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:470px" %)
	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**
217	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"]]
219		-
220		-[[(Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
	213	+[[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
221	221	)))|[[Soil pH>>||anchor="H2.3.3SoilpH"]]|[[Soil Temperature>>||anchor="H2.3.4SoilTemperature"]]|(((
222	222	[[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
223	223	)))|Reserve|(((
...	...	@@ -241,6 +241,7 @@
241	241
242	242	=== 2.3.2 DS18B20 Temperature sensor ===
243	243
	237	+
244	244	This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
245	245
246	246
...	...	@@ -254,6 +254,7 @@
254	254
255	255	=== 2.3.3 Soil pH ===
256	256
	251	+
257	257	Range: 0 ~~ 14 pH
258	258
259	259	**Example:**
...	...	@@ -264,6 +264,7 @@
264	264
265	265	=== 2.3.4 Soil Temperature ===
266	266
	262	+
267	267	Get Soil Temperature
268	268
269	269
...	...	@@ -277,6 +277,7 @@
277	277
278	278	=== 2.3.5 Interrupt Pin ===
279	279
	276	+
280	280	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.
281	281
282	282
...	...	@@ -290,6 +290,7 @@
290	290
291	291	=== 2.3.6 Message Type ===
292	292
	290	+
293	293	(((
294	294	For a normal uplink payload, the message type is always 0x01.
295	295	)))
...	...	@@ -299,7 +299,7 @@
299	299	)))
300	300
301	301
302		-(% border="1" cellspacing="10" style="background-color:#ffffcc; width:499px" %)
	300	+(% border="1" cellspacing="5" style="background-color:#ffffcc; width:496px" %)
303	303	|=(% style="width: 160px;" %)**Message Type Code**|=(% style="width: 163px;" %)**Description**|=(% style="width: 173px;" %)**Payload**
304	304	|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
305	305	|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
...	...	@@ -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	)))
...	...	@@ -515,15 +515,19 @@
515	515	* Reply to the confirmation package: 14 01
516	516	* Reply to non-confirmed packet: 14 00
517	517
	524	+
518	518	== 2.8 Frequency Plans ==
519	519
	527	+
520	520	(((
521	521	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.
522	522	)))
523	523
524	524
	533	+
525	525	=== 2.8.1 EU863-870 (EU868) ===
526	526
	536	+
527	527	(((
528	528	(% style="color:blue" %)**Uplink:**
529	529	)))
...	...	@@ -584,6 +584,7 @@
584	584
585	585	=== 2.8.2 US902-928(US915) ===
586	586
	597	+
587	587	(((
588	588	Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
589	589	)))
...	...	@@ -597,12 +597,13 @@
597	597	)))
598	598
599	599	* Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
600		-* 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)
601	601
602	602
603	603
604	604	=== 2.8.3 CN470-510 (CN470) ===
605	605
	617	+
606	606	(((
607	607	Used in China, Default use CHE=1
608	608	)))
...	...	@@ -691,6 +691,7 @@
691	691
692	692	=== 2.8.4 AU915-928(AU915) ===
693	693
	706	+
694	694	(((
695	695	Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
696	696	)))
...	...	@@ -708,12 +708,13 @@
708	708	)))
709	709
710	710	* Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
711		-* 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)
712	712
713	713
714	714
715	715	=== 2.8.5 AS920-923 & AS923-925 (AS923) ===
716	716
	730	+
717	717	(((
718	718	(% style="color:blue" %)**Default Uplink channel:**
719	719	)))
...	...	@@ -822,6 +822,7 @@
822	822
823	823	=== 2.8.6 KR920-923 (KR920) ===
824	824
	839	+
825	825	(((
826	826	(% style="color:blue" %)**Default channel:**
827	827	)))
...	...	@@ -894,6 +894,7 @@
894	894
895	895	=== 2.8.7 IN865-867 (IN865) ===
896	896
	912	+
897	897	(((
898	898	(% style="color:blue" %)**Uplink:**
899	899	)))
...	...	@@ -930,6 +930,7 @@
930	930
931	931	== 2.9 LED Indicator ==
932	932
	949	+
933	933	The LSPH01 has an internal LED which is to show the status of different state.
934	934
935	935	* The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
...	...	@@ -940,11 +940,9 @@
940	940	== 2.10 ​Firmware Change Log ==
941	941
942	942
943		-**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]]
944	944
945		-[[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/]]
946	946
947		-
948	948	**Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
949	949
950	950
...	...	@@ -951,6 +951,7 @@
951	951
952	952	= 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
953	953
	969	+
954	954	(((
955	955	Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
956	956	)))
...	...	@@ -982,7 +982,7 @@
982	982	)))
983	983
984	984	(((
985		-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/]]
986	986	)))
987	987
988	988	(((
...	...	@@ -1001,6 +1001,7 @@
1001	1001
1002	1002	== 3.1 Set Transmit Interval Time ==
1003	1003
	1020	+
1004	1004	Feature: Change LoRaWAN End Node Transmit Interval.
1005	1005
1006	1006	(% style="color:#037691" %)**AT Command: AT+TDC**
...	...	@@ -1027,11 +1027,13 @@
1027	1027	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1028	1028
1029	1029
	1047	+
1030	1030
1031	1031	)))
1032	1032
1033	1033	== 3.2 Set Interrupt Mode ==
1034	1034
	1053	+
1035	1035	Feature, Set Interrupt mode for GPIO_EXIT.
1036	1036
1037	1037	(% style="color:#037691" %)**AT Command: AT+INTMOD**
...	...	@@ -1066,6 +1066,7 @@
1066	1066
1067	1067	== 3.3 Calibrate Sensor ==
1068	1068
	1088	+
1069	1069	Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1070	1070
1071	1071
...	...	@@ -1072,6 +1072,7 @@
1072	1072
1073	1073	== 3.4 Get Firmware Version Info ==
1074	1074
	1095	+
1075	1075	Feature: use downlink to get firmware version.
1076	1076
1077	1077	(% style="color:#037691" %)**Downlink Command: 0x26**
...	...	@@ -1154,8 +1154,10 @@
1154	1154
1155	1155	= 4. Battery & How to replace =
1156	1156
	1178	+
1157	1157	== 4.1 Battery Type ==
1158	1158
	1181	+
1159	1159	(((
1160	1160	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.
1161	1161	)))
...	...	@@ -1162,6 +1162,8 @@
1162	1162
1163	1163	(((
1164	1164	The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
	1188	+
	1189	+
1165	1165	)))
1166	1166
1167	1167	[[image:1654593587246-335.png]]
...	...	@@ -1175,6 +1175,7 @@
1175	1175
1176	1176	== 4.2 Replace Battery ==
1177	1177
	1203	+
1178	1178	(((
1179	1179	Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1180	1180	)))
...	...	@@ -1187,6 +1187,7 @@
1187	1187
1188	1188	== 4.3 Power Consumption Analyze ==
1189	1189
	1216	+
1190	1190	(((
1191	1191	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.
1192	1192	)))
...	...	@@ -1230,6 +1230,7 @@
1230	1230
1231	1231	=== 4.3.1 ​Battery Note ===
1232	1232
	1260	+
1233	1233	(((
1234	1234	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.
1235	1235	)))
...	...	@@ -1238,12 +1238,13 @@
1238	1238
1239	1239	=== ​4.3.2 Replace the battery ===
1240	1240
	1269	+
1241	1241	(((
1242	1242	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.
1243	1243	)))
1244	1244
1245	1245	(((
1246		-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)
1247	1247	)))
1248	1248
1249	1249
...	...	@@ -1250,12 +1250,16 @@
1250	1250
1251	1251	= 5. Use AT Command =
1252	1252
	1282	+
1253	1253	== 5.1 Access AT Commands ==
1254	1254
	1285	+
1255	1255	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.
1256	1256
	1288	+
1257	1257	[[image:1654593668970-604.png]]
1258	1258
	1291	+
1259	1259	**Connection:**
1260	1260
1261	1261	(% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
...	...	@@ -1277,16 +1277,21 @@
1277	1277
1278	1278	= 6. FAQ =
1279	1279
	1313	+
1280	1280	== 6.1 How to change the LoRa Frequency Bands/Region ==
1281	1281
	1316	+
1282	1282	You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1283	1283	When downloading the images, choose the required image file for download. ​
1284	1284
1285	1285
	1321	+
1286	1286	= 7. Trouble Shooting =
1287	1287
	1324	+
1288	1288	== 7.1 AT Commands input doesn't work ==
1289	1289
	1327	+
1290	1290	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.
1291	1291
1292	1292
...	...	@@ -1293,6 +1293,7 @@
1293	1293
1294	1294	= 8. Order Info =
1295	1295
	1334	+
1296	1296	Part Number: (% style="color:blue" %)**LSPH01-XX**
1297	1297
1298	1298
...	...	@@ -1325,6 +1325,7 @@
1325	1325
1326	1326	= 10. ​Support =
1327	1327
	1367	+
1328	1328	* 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.
1329	1329	* 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]].
1330	1330