Changes for page LSPH01 -- LoRaWAN Soil pH Sensor User Manual

Summary

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

Details

Page properties

Content

...	...	@@ -9,6 +9,10 @@
9	9
10	10
11	11
	12	+
	13	+
	14	+
	15	+
12	12	**Table of Contents:**
13	13
14	14	{{toc/}}
...	...	@@ -24,6 +24,7 @@
24	24
25	25	= 1. Introduction =
26	26
	31	+
27	27	== 1.1 ​What is LoRaWAN Soil pH Sensor ==
28	28
29	29	(((
...	...	@@ -56,6 +56,7 @@
56	56
57	57	== ​1.2 Features ==
58	58
	64	+
59	59	* LoRaWAN 1.0.3 Class A
60	60	* Ultra-low power consumption
61	61	* Monitor soil pH with temperature compensation.
...	...	@@ -70,6 +70,10 @@
70	70	* IP68 rate for the Sensor Probe
71	71	* 8500mAh Battery for long term use
72	72
	79	+
	80	+
	81	+
	82	+
73	73	== 1.3 Probe Specification ==
74	74
75	75
...	...	@@ -90,12 +90,21 @@
90	90	* IP68 Protection
91	91	* Length: 3.5 meters
92	92
	103	+
	104	+
	105	+
	106	+
93	93	== 1.4 ​Applications ==
94	94
	109	+
95	95	* Smart Agriculture
96	96
	112	+
	113	+
	114	+
97	97	== 1.5 Pin mapping and power on ==
98	98
	117	+
99	99	[[image:1654592472094-134.png]]
100	100
101	101
...	...	@@ -102,19 +102,23 @@
102	102
103	103	= 2. Configure LSPH01 to connect to LoRaWAN network =
104	104
	124	+
105	105	== 2.1 How it works ==
106	106
	127	+
107	107	(((
108	108	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.
109	109	)))
110	110
111	111	(((
112		-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.
	133	+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	113	)))
114	114
115	115
	137	+
116	116	== 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
117	117
	140	+
118	118	(((
119	119	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.
120	120	)))
...	...	@@ -180,6 +180,8 @@
180	180
181	181	(((
182	182	(% 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.
	206	+
	207	+
183	183	)))
184	184
185	185	[[image:1654592697690-910.png]]
...	...	@@ -188,6 +188,7 @@
188	188
189	189	== 2.3 ​Uplink Payload ==
190	190
	216	+
191	191	(((
192	192	LSPH01 will uplink payload via LoRaWAN with below payload format:
193	193	)))
...	...	@@ -231,6 +231,7 @@
231	231
232	232	=== 2.3.2 DS18B20 Temperature sensor ===
233	233
	260	+
234	234	This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
235	235
236	236
...	...	@@ -244,6 +244,7 @@
244	244
245	245	=== 2.3.3 Soil pH ===
246	246
	274	+
247	247	Range: 0 ~~ 14 pH
248	248
249	249	**Example:**
...	...	@@ -254,6 +254,7 @@
254	254
255	255	=== 2.3.4 Soil Temperature ===
256	256
	285	+
257	257	Get Soil Temperature
258	258
259	259
...	...	@@ -267,6 +267,7 @@
267	267
268	268	=== 2.3.5 Interrupt Pin ===
269	269
	299	+
270	270	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.
271	271
272	272
...	...	@@ -280,6 +280,7 @@
280	280
281	281	=== 2.3.6 Message Type ===
282	282
	313	+
283	283	(((
284	284	For a normal uplink payload, the message type is always 0x01.
285	285	)))
...	...	@@ -295,6 +295,10 @@
295	295	|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.4GetFirmwareVersionInfo"]]
296	296	|(% style="width:160px" %)0x03|(% style="width:163px" %)Reply Calibration Info|(% style="width:173px" %)[[Calibration Payload>>||anchor="H2.7Calibration"]]
297	297
	329	+
	330	+
	331	+
	332	+
298	298	=== 2.3.7 Decode payload in The Things Network ===
299	299
300	300	While using TTN network, you can add the payload format to decode the payload.
...	...	@@ -307,7 +307,7 @@
307	307	)))
308	308
309	309	(((
310		-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/]]
	345	+LSPH01 TTN Payload Decoder:  [[https:~~/~~/www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]]
311	311	)))
312	312
313	313
...	...	@@ -314,6 +314,7 @@
314	314
315	315	== 2.4 Uplink Interval ==
316	316
	352	+
317	317	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"]]
318	318
319	319
...	...	@@ -320,6 +320,7 @@
320	320
321	321	== 2.5 ​Show Data in DataCake IoT Server ==
322	322
	359	+
323	323	(((
324	324	[[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:
325	325	)))
...	...	@@ -362,7 +362,7 @@
362	362	)))
363	363
364	364	(((
365		-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/]]
	402	+Download Datacake decoder from: [[https:~~/~~/www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0>>url:https://www.dropbox.com/sh/pj7cgmgqg3gx3ta/AABYFbg1DVOOR9Hmr1mLSBkga?dl=0]]
366	366	)))
367	367
368	368
...	...	@@ -383,8 +383,10 @@
383	383
384	384	== 2.6 Installation and Maintain ==
385	385
	423	+
386	386	=== 2.6.1 Before measurement ===
387	387
	426	+
388	388	(((
389	389	(((
390	390	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.
...	...	@@ -402,6 +402,8 @@
402	402
403	403	(((
404	404	[[image:1654592946732-634.png]]
	444	+
	445	+
405	405	)))
406	406
407	407	(((
...	...	@@ -413,7 +413,7 @@
413	413	)))
414	414
415	415	(((
416		-Slowly insert the probe to the measure point. Don’t use large force which will break the probe. Make sure not shake when inserting.
	457	+Slowly insert the probe to the measure point. Don't use large force which will break the probe. Make sure not shake when inserting.
417	417	)))
418	418
419	419	(((
...	...	@@ -440,6 +440,7 @@
440	440
441	441	=== 2.6.3 Maintain Probe ===
442	442
	484	+
443	443	1. (((
444	444	pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
445	445	)))
...	...	@@ -464,6 +464,7 @@
464	464
465	465	== 2.7 Calibration ==
466	466
	509	+
467	467	(((
468	468	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).
469	469	)))
...	...	@@ -495,6 +495,7 @@
495	495	Always 0x03
496	496	)))
497	497
	541	+
498	498	User can also send 0x14 downlink command to poll the current calibration payload.
499	499
500	500	[[image:image-20220607171416-7.jpeg]]
...	...	@@ -505,15 +505,19 @@
505	505
506	506
507	507
	552	+
508	508	== 2.8 Frequency Plans ==
509	509
	555	+
510	510	(((
511	511	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.
512	512	)))
513	513
514	514
	561	+
515	515	=== 2.8.1 EU863-870 (EU868) ===
516	516
	564	+
517	517	(((
518	518	(% style="color:blue" %)**Uplink:**
519	519	)))
...	...	@@ -574,6 +574,7 @@
574	574
575	575	=== 2.8.2 US902-928(US915) ===
576	576
	625	+
577	577	(((
578	578	Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
579	579	)))
...	...	@@ -587,16 +587,15 @@
587	587	)))
588	588
589	589	* Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
590		-* 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)
	639	+* 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)
591	591
592	592
593	593
594	594
595	595
596		-
597		-
598	598	=== 2.8.3 CN470-510 (CN470) ===
599	599
	647	+
600	600	(((
601	601	Used in China, Default use CHE=1
602	602	)))
...	...	@@ -685,6 +685,7 @@
685	685
686	686	=== 2.8.4 AU915-928(AU915) ===
687	687
	736	+
688	688	(((
689	689	Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
690	690	)))
...	...	@@ -702,16 +702,15 @@
702	702	)))
703	703
704	704	* Check what sub-band the LoRaWAN server ask from the OTAA Join Accept message and switch to that sub-band
705		-* 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)
	754	+* 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)
706	706
707	707
708	708
709	709
710	710
711		-
712		-
713	713	=== 2.8.5 AS920-923 & AS923-925 (AS923) ===
714	714
	762	+
715	715	(((
716	716	(% style="color:blue" %)**Default Uplink channel:**
717	717	)))
...	...	@@ -820,6 +820,7 @@
820	820
821	821	=== 2.8.6 KR920-923 (KR920) ===
822	822
	871	+
823	823	(((
824	824	(% style="color:blue" %)**Default channel:**
825	825	)))
...	...	@@ -892,6 +892,7 @@
892	892
893	893	=== 2.8.7 IN865-867 (IN865) ===
894	894
	944	+
895	895	(((
896	896	(% style="color:blue" %)**Uplink:**
897	897	)))
...	...	@@ -928,19 +928,22 @@
928	928
929	929	== 2.9 LED Indicator ==
930	930
	981	+
931	931	The LSPH01 has an internal LED which is to show the status of different state.
932	932
933	933	* The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
934	934	* Blink once when device transmit a packet.
935	935
936		-== 2.10 ​Firmware Change Log ==
937	937
938	938
939		-**Firmware download link:**
940	940
941		-[[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/]]
942	942
	991	+== 2.10 ​Firmware Change Log ==
943	943
	993	+
	994	+**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0>>https://www.dropbox.com/sh/xtm5tw37mewaw99/AAD0uy06odmreQQ7vMzZYVIGa?dl=0]]
	995	+
	996	+
944	944	**Firmware Upgrade Method: **[[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
945	945
946	946
...	...	@@ -947,6 +947,7 @@
947	947
948	948	= 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
949	949
	1003	+
950	950	(((
951	951	Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
952	952	)))
...	...	@@ -978,7 +978,7 @@
978	978	)))
979	979
980	980	(((
981		-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/]]
	1035	+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/]]
982	982	)))
983	983
984	984	(((
...	...	@@ -997,6 +997,7 @@
997	997
998	998	== 3.1 Set Transmit Interval Time ==
999	999
	1054	+
1000	1000	Feature: Change LoRaWAN End Node Transmit Interval.
1001	1001
1002	1002	(% style="color:#037691" %)**AT Command: AT+TDC**
...	...	@@ -1023,11 +1023,13 @@
1023	1023	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
1024	1024
1025	1025
	1081	+
1026	1026
1027	1027	)))
1028	1028
1029	1029	== 3.2 Set Interrupt Mode ==
1030	1030
	1087	+
1031	1031	Feature, Set Interrupt mode for GPIO_EXIT.
1032	1032
1033	1033	(% style="color:#037691" %)**AT Command: AT+INTMOD**
...	...	@@ -1062,6 +1062,7 @@
1062	1062
1063	1063	== 3.3 Calibrate Sensor ==
1064	1064
	1122	+
1065	1065	Detail See [[Calibration Guide>>||anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
1066	1066
1067	1067
...	...	@@ -1068,6 +1068,7 @@
1068	1068
1069	1069	== 3.4 Get Firmware Version Info ==
1070	1070
	1129	+
1071	1071	Feature: use downlink to get firmware version.
1072	1072
1073	1073	(% style="color:#037691" %)**Downlink Command: 0x26**
...	...	@@ -1150,8 +1150,10 @@
1150	1150
1151	1151	= 4. Battery & How to replace =
1152	1152
	1212	+
1153	1153	== 4.1 Battery Type ==
1154	1154
	1215	+
1155	1155	(((
1156	1156	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.
1157	1157	)))
...	...	@@ -1158,6 +1158,8 @@
1158	1158
1159	1159	(((
1160	1160	The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
	1222	+
	1223	+
1161	1161	)))
1162	1162
1163	1163	[[image:1654593587246-335.png]]
...	...	@@ -1171,6 +1171,7 @@
1171	1171
1172	1172	== 4.2 Replace Battery ==
1173	1173
	1237	+
1174	1174	(((
1175	1175	Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
1176	1176	)))
...	...	@@ -1183,6 +1183,7 @@
1183	1183
1184	1184	== 4.3 Power Consumption Analyze ==
1185	1185
	1250	+
1186	1186	(((
1187	1187	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.
1188	1188	)))
...	...	@@ -1226,6 +1226,7 @@
1226	1226
1227	1227	=== 4.3.1 ​Battery Note ===
1228	1228
	1294	+
1229	1229	(((
1230	1230	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.
1231	1231	)))
...	...	@@ -1234,12 +1234,13 @@
1234	1234
1235	1235	=== ​4.3.2 Replace the battery ===
1236	1236
	1303	+
1237	1237	(((
1238	1238	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.
1239	1239	)))
1240	1240
1241	1241	(((
1242		-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)
	1309	+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)
1243	1243	)))
1244	1244
1245	1245
...	...	@@ -1246,12 +1246,16 @@
1246	1246
1247	1247	= 5. Use AT Command =
1248	1248
	1316	+
1249	1249	== 5.1 Access AT Commands ==
1250	1250
	1319	+
1251	1251	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.
1252	1252
	1322	+
1253	1253	[[image:1654593668970-604.png]]
1254	1254
	1325	+
1255	1255	**Connection:**
1256	1256
1257	1257	(% style="background-color:yellow" %)** USB TTL GND <~-~-~-~-> GND**
...	...	@@ -1273,16 +1273,21 @@
1273	1273
1274	1274	= 6. FAQ =
1275	1275
	1347	+
1276	1276	== 6.1 How to change the LoRa Frequency Bands/Region ==
1277	1277
	1350	+
1278	1278	You can follow the instructions for [[how to upgrade image>>||anchor="H2.10200BFirmwareChangeLog"]].
1279	1279	When downloading the images, choose the required image file for download. ​
1280	1280
1281	1281
	1355	+
1282	1282	= 7. Trouble Shooting =
1283	1283
	1358	+
1284	1284	== 7.1 AT Commands input doesn't work ==
1285	1285
	1361	+
1286	1286	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.
1287	1287
1288	1288
...	...	@@ -1289,6 +1289,7 @@
1289	1289
1290	1290	= 8. Order Info =
1291	1291
	1368	+
1292	1292	Part Number: (% style="color:blue" %)**LSPH01-XX**
1293	1293
1294	1294
...	...	@@ -1306,7 +1306,6 @@
1306	1306
1307	1307
1308	1308
1309		-
1310	1310	= 9. ​Packing Info =
1311	1311
1312	1312
...	...	@@ -1324,10 +1324,12 @@
1324	1324
1325	1325
1326	1326
1327		-
1328	1328	= 10. ​Support =
1329	1329
	1405	+
1330	1330	* 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.
1331	1331	* 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]].
1332	1332
	1409	+
	1410	+
1333	1333