Wiki source code of LSPH01-LoRaWAN Soil pH Sensor User Manual

Version 98.1 by Xiaoling on 2022/06/25 17:19

version	line-number	content
2.2	1	(% style="text-align:center" %)
38.2	2	[[image:1654592399090-860.png\|\|height="521" width="483"]]
1.1	3
	4
	5
	6
92.1	7
	8
	9
	10
	11
98.1	12
	13
	14
	15
86.4	16	Table of Contents:
1.1	17
92.1	18	{{toc/}}
1.1	19
92.1	20
	21
	22
	23
	24
	25
	26
	27
	28
3.2	29	= 1. Introduction =
2.2	30
3.2	31	== 1.1 What is LoRaWAN Soil pH Sensor ==
2.2	32
73.13	33	(((
86.4	34
	35
3.2	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.
73.13	37	)))
2.2	38
73.13	39	(((
3.2	40	LSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's (% style="color:#4f81bd" %)pH (%%)with high accuracy and stable value. The LSPH01 probe can be buried into soil for long time use.
73.13	41	)))
2.2	42
73.13	43	(((
2.2	44	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.
73.13	45	)))
2.2	46
73.13	47	(((
3.2	48	LSPH01 is powered by (% style="color:#4f81bd" %)8500mAh Li-SOCI2 battery(%%), it is designed for long term use up to 5 years.
73.13	49	)))
2.2	50
73.13	51	(((
3.2	52	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.
73.13	53	)))
2.2	54
	55
38.2	56	[[image:1654592435432-887.png]]
2.2	57
	58
	59
85.5	60
3.2	61	== 1.2 Features ==
	62
2.2	63	* LoRaWAN 1.0.3 Class A
	64	* Ultra-low power consumption
	65	* Monitor soil pH with temperature compensation.
	66	* Monitor soil temperature
	67	* Monitor Battery Level
	68	* Support pH calibration by end user
	69	* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
	70	* AT Commands to change parameters
	71	* Uplink on periodically
	72	* Downlink to change configure
	73	* IP66 Waterproof Enclosure
	74	* IP68 rate for the Sensor Probe
	75	* 8500mAh Battery for long term use
	76
3.3	77	== 1.3 Probe Specification ==
2.2	78
	79
3.3	80	(% style="color:#4f81bd" %)Soil pH:
	81
	82	* Range: 3 ~~ 10 pH
	83	* Resolution: 0.01 pH
	84	* Accuracy: ±2% under (0~~50 ℃, Accuracy will poor under 0 due to frozen)
	85	* Temperature Compensation Range: 0 ~~ 50℃
2.2	86	* IP68 Protection
	87	* Length: 3.5 meters
	88
3.3	89	(% style="color:#4f81bd" %)Soil Temperature:
2.2	90
3.3	91	* Range -40℃～85℃
	92	* Resolution: 0.1℃
	93	* Accuracy: <±0.5℃(-10℃～40℃)，<±0.8℃ (others)
2.2	94	* IP68 Protection
	95	* Length: 3.5 meters
	96
3.3	97	== 1.4 Applications ==
	98
2.2	99	* Smart Agriculture
	100
3.3	101	== 1.5 Pin mapping and power on ==
	102
39.2	103	[[image:1654592472094-134.png]]
2.2	104
	105
	106
5.2	107	= 2. Configure LSPH01 to connect to LoRaWAN network =
2.2	108
5.5	109	== 2.1 How it works ==
2.2	110
5.3	111	(((
2.2	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.
5.3	113	)))
2.2	114
5.3	115	(((
85.3	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.
5.3	117	)))
2.2	118
	119
5.3	120	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
2.2	121
6.3	122	(((
2.2	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.
6.3	124	)))
2.2	125
6.3	126	(((
41.3	127	[[image:1654592492399-921.png]]
86.7	128
	129
6.3	130	)))
2.2	131
6.3	132	(((
2.2	133	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.
86.7	134
	135
6.3	136	)))
2.2	137
6.3	138	(((
23.5	139	(% style="color:blue" %)Step 1(%%): Create a device in TTN with the OTAA keys from LSPH01.
6.3	140	)))
2.2	141
6.3	142	(((
2.2	143	Each LSPH01 is shipped with a sticker with the default device EUI as below:
6.3	144	)))
2.2	145
41.3	146	[[image:image-20220607170145-1.jpeg]]
2.2	147
	148
	149
	150	You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
	151
	152
	153	Register the device
	154
	155
43.2	156	[[image:1654592600093-601.png]]
2.2	157
9.2	158
86.8	159
2.2	160	Add APP EUI and DEV EUI
	161
43.2	162	[[image:1654592619856-881.png]]
2.2	163
	164
86.8	165
2.2	166	Add APP EUI in the application
	167
44.2	168	[[image:1654592632656-512.png]]
2.2	169
	170
10.2	171
2.2	172	Add APP KEY
	173
45.2	174	[[image:1654592653453-934.png]]
2.2	175
	176
23.5	177	(% style="color:blue" %)Step 2(%%): Power on LSPH01
2.2	178
	179
	180	Put a Jumper on JP2 to power on the device. ( The Switch must be in FLASH position).
	181
46.2	182	[[image:image-20220607170442-2.png]]
2.2	183
	184
73.14	185	(((
23.5	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.
73.14	187	)))
2.2	188
48.2	189	[[image:1654592697690-910.png]]
2.2	190
	191
	192
13.2	193	== 2.3 Uplink Payload ==
2.2	194
73.14	195	(((
3.2	196	LSPH01 will uplink payload via LoRaWAN with below payload format:
73.14	197	)))
2.2	198
73.14	199	(((
2.2	200	Uplink payload includes in total 11 bytes.
73.14	201	)))
2.2	202
73.14	203	(((
2.2	204	Normal uplink payload:
73.14	205	)))
2.2	206
13.2	207	(% border="1" cellspacing="10" style="background-color:#ffffcc; width:510px" %)
85.8	208	\|=(% style="width: 62.5px;" %)(((
	209	Size (bytes)
	210	)))\|=(% style="width: 62.5px;" %)2\|=(% style="width: 62.5px;" %)2\|=2\|=2\|=1\|=1\|=1
	211	\|(% style="width:62.5px" %)Value\|(% style="width:62.5px" %)[[BAT>>\|\|anchor="H2.3.1BatteryInfo"]]\|(% style="width:62.5px" %)(((
85.3	212	[[Temperature>>\|\|anchor="H2.3.2DS18B20Temperaturesensor"]]
2.2	213
85.3	214	[[(Optional)>>\|\|anchor="H2.3.2DS18B20Temperaturesensor"]]
	215	)))\|[[Soil pH>>\|\|anchor="H2.3.3SoilpH"]]\|[[Soil Temperature>>\|\|anchor="H2.3.4SoilTemperature"]]\|(((
	216	[[Digital Interrupt (Optional)>>\|\|anchor="H2.3.5InterruptPin"]]
2.2	217	)))\|Reserve\|(((
85.3	218	[[Message Type>>\|\|anchor="H2.3.6MessageType"]]
2.2	219	)))
	220
48.2	221	[[image:1654592721645-318.png]]
2.2	222
	223
	224
13.2	225	=== 2.3.1 Battery Info ===
2.2	226
13.2	227
2.2	228	Check the battery voltage for LSPH01.
	229
	230	Ex1: 0x0B45 = 2885mV
	231
	232	Ex2: 0x0B49 = 2889mV
	233
	234
	235
13.2	236	=== 2.3.2 DS18B20 Temperature sensor ===
2.2	237
13.2	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.
2.2	239
13.2	240
2.2	241	Example:
	242
	243	If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
	244
	245	If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
	246
	247
	248
13.3	249	=== 2.3.3 Soil pH ===
2.2	250
	251	Range: 0 ~~ 14 pH
	252
13.3	253	Example:
2.2	254
13.3	255	(% style="color:#037691" %) 0x02B7(H) = 695(D) = 6.95pH
2.2	256
	257
	258
13.3	259	=== 2.3.4 Soil Temperature ===
	260
2.2	261	Get Soil Temperature
	262
	263
	264	Example:
	265
13.3	266	If payload is: 0105H: (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
2.2	267
13.3	268	If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
2.2	269
	270
	271
13.3	272	=== 2.3.5 Interrupt Pin ===
2.2	273
85.3	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.
2.2	275
	276
13.3	277	Example:
2.2	278
	279	0x00: Normal uplink packet.
	280
	281	0x01: Interrupt Uplink Packet.
	282
	283
	284
13.3	285	=== 2.3.6 Message Type ===
	286
73.15	287	(((
2.2	288	For a normal uplink payload, the message type is always 0x01.
73.15	289	)))
2.2	290
73.15	291	(((
2.2	292	Valid Message Type:
73.15	293	)))
2.2	294
	295
85.8	296	(% border="1" cellspacing="10" style="background-color:#ffffcc; width:499px" %)
	297	\|=(% style="width: 160px;" %)Message Type Code\|=(% style="width: 163px;" %)Description\|=(% style="width: 173px;" %)Payload
	298	\|(% style="width:160px" %)0x01\|(% style="width:163px" %)Normal Uplink\|(% style="width:173px" %)[[Normal Uplink Payload>>\|\|anchor="H2.3200BUplinkPayload"]]
	299	\|(% style="width:160px" %)0x02\|(% style="width:163px" %)Reply configures info\|(% style="width:173px" %)[[Configure Info Payload>>\|\|anchor="H3.4GetFirmwareVersionInfo"]]
	300	\|(% style="width:160px" %)0x03\|(% style="width:163px" %)Reply Calibration Info\|(% style="width:173px" %)[[Calibration Payload>>\|\|anchor="H2.7Calibration"]]
2.2	301
13.6	302	=== 2.3.7 Decode payload in The Things Network ===
	303
2.2	304	While using TTN network, you can add the payload format to decode the payload.
	305
	306
49.2	307	[[image:1654592762713-715.png]]
2.2	308
14.2	309	(((
2.2	310	The payload decoder function for TTN is here:
14.2	311	)))
2.2	312
14.2	313	(((
2.2	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/]]
14.2	315	)))
2.2	316
	317
	318
14.3	319	== 2.4 Uplink Interval ==
	320
85.19	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"]]
2.2	322
	323
	324
16.2	325	== 2.5 Show Data in DataCake IoT Server ==
2.2	326
74.2	327	(((
2.2	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:
74.2	329	)))
2.2	330
74.2	331	(((
	332
	333	)))
2.2	334
74.2	335	(((
23.5	336	(% style="color:blue" %)Step 1(%%): Be sure that your device is programmed and properly connected to the network at this time.
74.2	337	)))
2.2	338
74.2	339	(((
23.5	340	(% style="color:blue" %)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:
74.2	341	)))
2.2	342
	343
50.2	344	[[image:1654592790040-760.png]]
2.2	345
	346
51.3	347	[[image:1654592800389-571.png]]
2.2	348
	349
23.5	350	(% style="color:blue" %)Step 3(%%): Create an account or log in Datacake.
2.2	351
23.5	352	(% style="color:blue" %)Step 4(%%): Create LSPH01 product.
2.2	353
53.2	354	[[image:1654592819047-535.png]]
2.2	355
	356
	357
53.2	358	[[image:1654592833877-762.png]]
2.2	359
	360
54.2	361	[[image:1654592856403-259.png]]
2.2	362
	363
74.3	364	(((
23.5	365	(% style="color:blue" %)Step 5(%%): add payload decode
74.3	366	)))
2.2	367
74.3	368	(((
2.2	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/]]
74.3	370	)))
2.2	371
	372
55.2	373	[[image:1654592878525-845.png]]
2.2	374
56.2	375	[[image:1654592892967-474.png]]
2.2	376
	377
57.2	378	[[image:1654592905354-123.png]]
2.2	379
	380
	381	After added, the sensor data arrive TTN, it will also arrive and show in Mydevices.
	382
	383
59.2	384	[[image:1654592917530-261.png]]
2.2	385
	386
	387
24.2	388	== 2.6 Installation and Maintain ==
2.2	389
24.2	390	=== 2.6.1 Before measurement ===
	391
	392	(((
74.4	393	(((
3.2	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.
24.2	395	)))
74.4	396	)))
2.2	397
	398
	399
24.2	400	=== 2.6.2 Measurement ===
2.2	401
	402
74.4	403	(((
24.2	404	(% style="color:#4f81bd" %)Measurement the soil surface:
74.4	405	)))
2.2	406
74.4	407	(((
59.2	408	[[image:1654592946732-634.png]]
74.4	409	)))
2.2	410
74.4	411	(((
24.2	412	Choose the proper measuring position. Split the surface soil according to the measured deep.
74.4	413	)))
24.2	414
74.4	415	(((
2.2	416	Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
74.4	417	)))
2.2	418
74.4	419	(((
2.2	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.
74.4	421	)))
2.2	422
74.4	423	(((
2.2	424	Put soil over the probe after insert. And start to measure.
74.4	425	)))
2.2	426
74.4	427	(((
	428
	429	)))
2.2	430
74.4	431	(((
24.2	432	(% style="color:#4f81bd" %)Measurement inside soil:
74.4	433	)))
2.2	434
74.4	435	(((
24.2	436	Dig a hole with diameter > 20CM.
74.4	437	)))
2.2	438
74.4	439	(((
24.2	440	Insert the probe inside, method like measure the surface.
74.4	441	)))
2.2	442
	443
	444
24.2	445	=== 2.6.3 Maintain Probe ===
2.2	446
24.2	447	1. (((
	448	pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
	449	)))
	450	1. (((
	451	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.
	452	)))
	453	1. (((
	454	Probe reference electrode is also no strong, need to avoid strong force or hitting.
	455	)))
	456	1. (((
	457	User should keep reference electrode wet while not use.
	458	)))
	459	1. (((
	460	Avoid the probes to touch oily matter. Which will cause issue in accuracy.
	461	)))
	462	1. (((
	463	The probe is IP68 can be put in water.
2.2	464
	465
25.2	466
	467	)))
2.2	468
24.3	469	== 2.7 Calibration ==
24.2	470
74.5	471	(((
2.2	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).
74.5	473	)))
2.2	474
74.5	475	(((
26.2	476	After stable, user can use below command to calibrate.
74.5	477	)))
2.2	478
61.2	479	[[image:image-20220607171149-4.png]]
2.2	480
	481
25.2	482	(% style="color:#037691" %)Calibration Payload
2.2	483
74.6	484	(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
85.12	485	\|=(% style="width: 62.5px;" %)(((
	486	Size (bytes)
	487	)))\|=(% style="width: 89px;" %)1\|=(% style="width: 89px;" %)1\|=(% style="width: 89px;" %)1\|=(% style="width: 89px;" %)7\|=(% style="width: 89px;" %)1
2.2	488	\|Value\|(((
	489	PH4
	490
	491	Calibrate value
	492	)))\|PH6.86 Calibrate value\|(((
	493	PH9.18
	494
	495	Calibrate value
	496	)))\|Reserve\|(((
85.3	497	[[Message Type>>\|\|anchor="H2.3.6MessageType"]]
25.3	498
	499	Always 0x03
2.2	500	)))
	501
	502	User can also send 0x14 downlink command to poll the current calibration payload.
	503
64.2	504	[[image:image-20220607171416-7.jpeg]]
2.2	505
64.2	506
2.2	507	* Reply to the confirmation package: 14 01
	508	* Reply to non-confirmed packet: 14 00
	509
26.5	510	== 2.8 Frequency Plans ==
26.2	511
26.6	512	(((
2.2	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.
26.6	514	)))
2.2	515
	516
26.5	517	=== 2.8.1 EU863-870 (EU868) ===
2.2	518
74.10	519	(((
26.5	520	(% style="color:blue" %)Uplink:
74.10	521	)))
26.5	522
74.10	523	(((
2.2	524	868.1 - SF7BW125 to SF12BW125
74.10	525	)))
2.2	526
74.10	527	(((
2.2	528	868.3 - SF7BW125 to SF12BW125 and SF7BW250
74.10	529	)))
2.2	530
74.10	531	(((
2.2	532	868.5 - SF7BW125 to SF12BW125
74.10	533	)))
2.2	534
74.10	535	(((
2.2	536	867.1 - SF7BW125 to SF12BW125
74.10	537	)))
2.2	538
74.10	539	(((
2.2	540	867.3 - SF7BW125 to SF12BW125
74.10	541	)))
2.2	542
74.10	543	(((
2.2	544	867.5 - SF7BW125 to SF12BW125
74.10	545	)))
2.2	546
74.10	547	(((
2.2	548	867.7 - SF7BW125 to SF12BW125
74.10	549	)))
2.2	550
74.10	551	(((
2.2	552	867.9 - SF7BW125 to SF12BW125
74.10	553	)))
2.2	554
74.10	555	(((
2.2	556	868.8 - FSK
74.10	557	)))
2.2	558
74.10	559	(((
	560
	561	)))
2.2	562
74.10	563	(((
26.5	564	(% style="color:blue" %)Downlink:
74.10	565	)))
2.2	566
74.10	567	(((
2.2	568	Uplink channels 1-9 (RX1)
74.10	569	)))
2.2	570
74.10	571	(((
2.2	572	869.525 - SF9BW125 (RX2 downlink only)
74.10	573	)))
2.2	574
	575
	576
26.5	577	=== 2.8.2 US902-928(US915) ===
	578
	579	(((
2.2	580	Used in USA, Canada and South America. Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
26.5	581	)))
2.2	582
26.5	583	(((
2.2	584	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.
26.5	585	)))
2.2	586
26.5	587	(((
2.2	588	After Join success, the end node will switch to the correct sub band by:
26.5	589	)))
2.2	590
	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)
	593
87.4	594
95.1	595
	596
26.5	597	=== 2.8.3 CN470-510 (CN470) ===
	598
74.11	599	(((
2.2	600	Used in China, Default use CHE=1
74.11	601	)))
2.2	602
74.11	603	(((
26.5	604	(% style="color:blue" %)Uplink:
74.11	605	)))
2.2	606
74.11	607	(((
2.2	608	486.3 - SF7BW125 to SF12BW125
74.11	609	)))
2.2	610
74.11	611	(((
2.2	612	486.5 - SF7BW125 to SF12BW125
74.11	613	)))
2.2	614
74.11	615	(((
2.2	616	486.7 - SF7BW125 to SF12BW125
74.11	617	)))
2.2	618
74.11	619	(((
2.2	620	486.9 - SF7BW125 to SF12BW125
74.11	621	)))
2.2	622
74.11	623	(((
2.2	624	487.1 - SF7BW125 to SF12BW125
74.11	625	)))
2.2	626
74.11	627	(((
2.2	628	487.3 - SF7BW125 to SF12BW125
74.11	629	)))
2.2	630
74.11	631	(((
2.2	632	487.5 - SF7BW125 to SF12BW125
74.11	633	)))
2.2	634
74.11	635	(((
2.2	636	487.7 - SF7BW125 to SF12BW125
74.11	637	)))
2.2	638
74.11	639	(((
	640
	641	)))
2.2	642
74.11	643	(((
26.5	644	(% style="color:blue" %)Downlink:
74.11	645	)))
2.2	646
74.11	647	(((
2.2	648	506.7 - SF7BW125 to SF12BW125
74.11	649	)))
2.2	650
74.11	651	(((
2.2	652	506.9 - SF7BW125 to SF12BW125
74.11	653	)))
2.2	654
74.11	655	(((
2.2	656	507.1 - SF7BW125 to SF12BW125
74.11	657	)))
2.2	658
74.11	659	(((
2.2	660	507.3 - SF7BW125 to SF12BW125
74.11	661	)))
2.2	662
74.11	663	(((
2.2	664	507.5 - SF7BW125 to SF12BW125
74.11	665	)))
2.2	666
74.11	667	(((
2.2	668	507.7 - SF7BW125 to SF12BW125
74.11	669	)))
2.2	670
74.11	671	(((
2.2	672	507.9 - SF7BW125 to SF12BW125
74.11	673	)))
2.2	674
74.11	675	(((
2.2	676	508.1 - SF7BW125 to SF12BW125
74.11	677	)))
2.2	678
74.11	679	(((
2.2	680	505.3 - SF12BW125 (RX2 downlink only)
74.11	681	)))
2.2	682
	683
	684
26.5	685	=== 2.8.4 AU915-928(AU915) ===
	686
	687	(((
2.2	688	Frequency band as per definition in LoRaWAN 1.0.3 Regional document.
26.5	689	)))
2.2	690
26.5	691	(((
2.2	692	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.
26.5	693	)))
2.2	694
26.5	695	(((
	696
	697	)))
2.2	698
26.5	699	(((
2.2	700	After Join success, the end node will switch to the correct sub band by:
26.5	701	)))
2.2	702
	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)
	705
90.6	706
95.1	707
	708
26.5	709	=== 2.8.5 AS920-923 & AS923-925 (AS923) ===
	710
74.9	711	(((
26.7	712	(% style="color:blue" %)Default Uplink channel:
74.9	713	)))
2.2	714
74.9	715	(((
2.2	716	923.2 - SF7BW125 to SF10BW125
74.9	717	)))
2.2	718
74.9	719	(((
2.2	720	923.4 - SF7BW125 to SF10BW125
74.9	721	)))
2.2	722
74.9	723	(((
	724
	725	)))
2.2	726
74.9	727	(((
26.7	728	(% style="color:blue" %)Additional Uplink Channel:
74.9	729	)))
2.2	730
74.9	731	(((
2.2	732	(OTAA mode, channel added by JoinAccept message)
74.9	733	)))
2.2	734
74.9	735	(((
	736
	737	)))
2.2	738
74.9	739	(((
26.7	740	(% style="color:blue" %)AS920~~AS923 for Japan, Malaysia, Singapore:
74.9	741	)))
26.7	742
74.9	743	(((
2.2	744	922.2 - SF7BW125 to SF10BW125
74.9	745	)))
2.2	746
74.9	747	(((
2.2	748	922.4 - SF7BW125 to SF10BW125
74.9	749	)))
2.2	750
74.9	751	(((
2.2	752	922.6 - SF7BW125 to SF10BW125
74.9	753	)))
2.2	754
74.9	755	(((
2.2	756	922.8 - SF7BW125 to SF10BW125
74.9	757	)))
2.2	758
74.9	759	(((
2.2	760	923.0 - SF7BW125 to SF10BW125
74.9	761	)))
2.2	762
74.9	763	(((
2.2	764	922.0 - SF7BW125 to SF10BW125
74.9	765	)))
2.2	766
74.9	767	(((
	768
	769	)))
2.2	770
74.9	771	(((
26.7	772	(% style="color:blue" %)AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam:
74.9	773	)))
2.2	774
74.9	775	(((
2.2	776	923.6 - SF7BW125 to SF10BW125
74.9	777	)))
2.2	778
74.9	779	(((
2.2	780	923.8 - SF7BW125 to SF10BW125
74.9	781	)))
2.2	782
74.9	783	(((
2.2	784	924.0 - SF7BW125 to SF10BW125
74.9	785	)))
2.2	786
74.9	787	(((
2.2	788	924.2 - SF7BW125 to SF10BW125
74.9	789	)))
2.2	790
74.9	791	(((
2.2	792	924.4 - SF7BW125 to SF10BW125
74.9	793	)))
2.2	794
74.9	795	(((
2.2	796	924.6 - SF7BW125 to SF10BW125
74.9	797	)))
2.2	798
74.9	799	(((
	800
	801	)))
2.2	802
74.9	803	(((
26.7	804	(% style="color:blue" %)Downlink:
74.9	805	)))
2.2	806
74.9	807	(((
2.2	808	Uplink channels 1-8 (RX1)
74.9	809	)))
2.2	810
74.9	811	(((
2.2	812	923.2 - SF10BW125 (RX2)
74.9	813	)))
2.2	814
	815
	816
26.7	817	=== 2.8.6 KR920-923 (KR920) ===
2.2	818
74.12	819	(((
26.7	820	(% style="color:blue" %)Default channel:
74.12	821	)))
26.7	822
74.12	823	(((
2.2	824	922.1 - SF7BW125 to SF12BW125
74.12	825	)))
2.2	826
74.12	827	(((
2.2	828	922.3 - SF7BW125 to SF12BW125
74.12	829	)))
2.2	830
74.12	831	(((
2.2	832	922.5 - SF7BW125 to SF12BW125
74.12	833	)))
2.2	834
74.12	835	(((
	836
	837	)))
2.2	838
74.12	839	(((
26.7	840	(% style="color:blue" %)Uplink: (OTAA mode, channel added by JoinAccept message)
74.12	841	)))
2.2	842
74.12	843	(((
2.2	844	922.1 - SF7BW125 to SF12BW125
74.12	845	)))
2.2	846
74.12	847	(((
2.2	848	922.3 - SF7BW125 to SF12BW125
74.12	849	)))
2.2	850
74.12	851	(((
2.2	852	922.5 - SF7BW125 to SF12BW125
74.12	853	)))
2.2	854
74.12	855	(((
2.2	856	922.7 - SF7BW125 to SF12BW125
74.12	857	)))
2.2	858
74.12	859	(((
2.2	860	922.9 - SF7BW125 to SF12BW125
74.12	861	)))
2.2	862
74.12	863	(((
2.2	864	923.1 - SF7BW125 to SF12BW125
74.12	865	)))
2.2	866
74.12	867	(((
2.2	868	923.3 - SF7BW125 to SF12BW125
74.12	869	)))
2.2	870
74.12	871	(((
	872
	873	)))
2.2	874
74.12	875	(((
26.7	876	(% style="color:blue" %)Downlink:
74.12	877	)))
2.2	878
74.12	879	(((
2.2	880	Uplink channels 1-7(RX1)
74.12	881	)))
2.2	882
74.12	883	(((
2.2	884	921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
74.12	885	)))
2.2	886
	887
35.6	888
26.7	889	=== 2.8.7 IN865-867 (IN865) ===
2.2	890
74.13	891	(((
26.7	892	(% style="color:blue" %)Uplink:
74.13	893	)))
2.2	894
74.13	895	(((
2.2	896	865.0625 - SF7BW125 to SF12BW125
74.13	897	)))
2.2	898
74.13	899	(((
2.2	900	865.4025 - SF7BW125 to SF12BW125
74.13	901	)))
2.2	902
74.13	903	(((
2.2	904	865.9850 - SF7BW125 to SF12BW125
74.13	905	)))
2.2	906
74.13	907	(((
	908
	909	)))
2.2	910
74.13	911	(((
26.7	912	(% style="color:blue" %)Downlink:
74.13	913	)))
2.2	914
74.13	915	(((
2.2	916	Uplink channels 1-3 (RX1)
74.13	917	)))
2.2	918
74.13	919	(((
2.2	920	866.550 - SF10BW125 (RX2)
74.13	921	)))
2.2	922
	923
	924
26.7	925	== 2.9 LED Indicator ==
	926
2.2	927	The LSPH01 has an internal LED which is to show the status of different state.
	928
	929	* The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
	930	* Blink once when device transmit a packet.
	931
95.2	932
	933
	934
26.9	935	== 2.10 Firmware Change Log ==
2.2	936
26.15	937
2.2	938	Firmware download link:
	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
	942
36.1	943	Firmware Upgrade Method: [[Firmware Upgrade Instruction>>path:/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/]]
2.2	944
	945
	946
26.16	947	= 3. Configure LSPH01 via AT Command or LoRaWAN Downlink =
2.2	948
74.14	949	(((
2.2	950	Use can configure LSPH01 via AT Command or LoRaWAN Downlink.
74.14	951	)))
2.2	952
74.14	953	* (((
85.3	954	AT Command Connection: See [[FAQ>>\|\|anchor="H6.FAQ"]].
74.14	955	)))
	956	* (((
	957	LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>path:/xwiki/bin/view/Main/]]
	958	)))
2.2	959
74.14	960	(((
2.2	961	There are two kinds of commands to configure LSPH01, they are:
74.14	962	)))
2.2	963
74.14	964	* (((
	965	(% style="color:#4f81bd" %) General Commands.
	966	)))
2.2	967
74.14	968	(((
2.2	969	These commands are to configure:
74.14	970	)))
2.2	971
74.14	972	* (((
	973	General system settings like: uplink interval.
	974	)))
	975	* (((
	976	LoRaWAN protocol & radio related command.
	977	)))
2.2	978
74.14	979	(((
36.1	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/]]
74.14	981	)))
2.2	982
74.14	983	(((
	984
	985	)))
2.2	986
74.14	987	* (((
	988	(% style="color:#4f81bd" %) Commands special design for LSPH01
	989	)))
2.2	990
74.14	991	(((
2.2	992	These commands only valid for LSPH01, as below:
74.14	993	)))
2.2	994
	995
	996
27.2	997	== 3.1 Set Transmit Interval Time ==
	998
2.2	999	Feature: Change LoRaWAN End Node Transmit Interval.
	1000
27.2	1001	(% style="color:#037691" %)AT Command: AT+TDC
2.2	1002
65.2	1003	[[image:image-20220607171554-8.png]]
27.2	1004
2.2	1005
74.16	1006	(((
27.2	1007	(% style="color:#037691" %)Downlink Command: 0x01
74.16	1008	)))
2.2	1009
74.16	1010	(((
2.2	1011	Format: Command Code (0x01) followed by 3 bytes time value.
74.16	1012	)))
2.2	1013
74.15	1014	(((
2.2	1015	If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
74.15	1016	)))
2.2	1017
74.16	1018	* (((
	1019	Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	1020	)))
	1021	* (((
	1022	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
76.2	1023
	1024
	1025
74.16	1026	)))
2.2	1027
27.3	1028	== 3.2 Set Interrupt Mode ==
	1029
2.2	1030	Feature, Set Interrupt mode for GPIO_EXIT.
	1031
27.3	1032	(% style="color:#037691" %)AT Command: AT+INTMOD
2.2	1033
86.2	1034	[[image:image-20220610105907-1.png]]
2.2	1035
	1036
74.16	1037	(((
27.3	1038	(% style="color:#037691" %)Downlink Command: 0x06
74.16	1039	)))
2.2	1040
74.16	1041	(((
2.2	1042	Format: Command Code (0x06) followed by 3 bytes.
74.16	1043	)))
2.2	1044
74.16	1045	(((
2.2	1046	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
74.16	1047	)))
2.2	1048
74.16	1049	* (((
	1050	Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
	1051	)))
	1052	* (((
	1053	Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
	1054	)))
2.2	1055
74.17	1056	(((
	1057
	1058	)))
	1059
	1060
	1061
27.3	1062	== 3.3 Calibrate Sensor ==
	1063
85.3	1064	Detail See [[Calibration Guide>>\|\|anchor="H2.7Calibration"]] for the user of 0x13 and 0x14 downlink commands
2.2	1065
	1066
	1067
28.3	1068	== 3.4 Get Firmware Version Info ==
	1069
2.2	1070	Feature: use downlink to get firmware version.
	1071
27.3	1072	(% style="color:#037691" %)Downlink Command: 0x26
2.2	1073
67.2	1074	[[image:image-20220607171917-10.png]]
2.2	1075
	1076	* Reply to the confirmation package: 26 01
	1077	* Reply to non-confirmed packet: 26 00
	1078
	1079	Device will send an uplink after got this downlink command. With below payload:
	1080
	1081	Configures info payload:
	1082
29.4	1083	(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
	1084	\|=(((
	1085	Size(bytes)
	1086	)))\|=1\|=1\|=1\|=1\|=1\|=5\|=1
2.2	1087	\|Value\|Software Type\|(((
	1088	Frequency
	1089
	1090	Band
	1091	)))\|Sub-band\|(((
	1092	Firmware
	1093
	1094	Version
	1095	)))\|Sensor Type\|Reserve\|(((
85.3	1096	[[Message Type>>\|\|anchor="H2.3.6MessageType"]]
2.2	1097	Always 0x02
	1098	)))
	1099
90.5	1100	(% style="color:#037691" %)Software Type(%%): Always 0x03 for LSPH01
2.2	1101
	1102
90.5	1103	(% style="color:#037691" %)Frequency Band:
2.2	1104
	1105	*0x01: EU868
	1106
	1107	*0x02: US915
	1108
	1109	*0x03: IN865
	1110
	1111	*0x04: AU915
	1112
	1113	*0x05: KZ865
	1114
	1115	*0x06: RU864
	1116
	1117	*0x07: AS923
	1118
	1119	*0x08: AS923-1
	1120
	1121	*0x09: AS923-2
	1122
	1123	*0xa0: AS923-3
	1124
	1125
90.5	1126	(% style="color:#037691" %)Sub-Band(%%): value 0x00 ~~ 0x08
2.2	1127
	1128
90.5	1129	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
2.2	1130
	1131
90.5	1132	(% style="color:#037691" %)Sensor Type:
2.2	1133
	1134	0x01: LSE01
	1135
	1136	0x02: LDDS75
	1137
	1138	0x03: LDDS20
	1139
	1140	0x04: LLMS01
	1141
	1142	0x05: LSPH01
	1143
	1144	0x06: LSNPK01
	1145
	1146	0x07: LDDS12
	1147
	1148
	1149
29.9	1150	= 4. Battery & How to replace =
2.2	1151
29.9	1152	== 4.1 Battery Type ==
2.2	1153
30.2	1154	(((
2.2	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.
30.2	1156	)))
2.2	1157
30.2	1158	(((
89.1	1159	The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
30.2	1160	)))
2.2	1161
68.2	1162	[[image:1654593587246-335.png]]
2.2	1163
	1164
	1165	Minimum Working Voltage for the LSPH01:
	1166
	1167	LSPH01: 2.45v ~~ 3.6v
	1168
	1169
	1170
30.3	1171	== 4.2 Replace Battery ==
	1172
30.5	1173	(((
2.2	1174	Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
30.5	1175	)))
2.2	1176
30.5	1177	(((
2.2	1178	And make sure the positive and negative pins match.
30.5	1179	)))
2.2	1180
	1181
	1182
30.4	1183	== 4.3 Power Consumption Analyze ==
2.2	1184
30.5	1185	(((
2.2	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.
30.5	1187	)))
2.2	1188
30.5	1189	(((
2.2	1190	Instruction to use as below:
30.5	1191	)))
2.2	1192
	1193
92.3	1194	(% style="color:#037691" %)Step 1(%%): Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from:
2.2	1195
	1196	[[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/]]
	1197
	1198
90.5	1199	(% style="color:#037691" %)Step 2(%%): Open it and choose
2.2	1200
	1201	* Product Model
	1202	* Uplink Interval
	1203	* Working Mode
	1204
	1205	And the Life expectation in difference case will be shown on the right.
	1206
69.2	1207	[[image:1654593605679-189.png]]
2.2	1208
	1209
	1210	The battery related documents as below:
	1211
32.2	1212	* (((
89.1	1213	[[Battery Dimension>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]],
2.2	1214	)))
32.2	1215	* (((
	1216	[[Lithium-Thionyl Chloride Battery datasheet>>url:https://www.dragino.com/downloads/downloads/datasheet/Battery/ER26500/ER26500_Datasheet-EN.pdf]],
	1217	)))
	1218	* (((
89.1	1219	[[Lithium-ion Battery-Capacitor datasheet>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]], [[Tech Spec>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]]
32.2	1220	)))
2.2	1221
70.2	1222	[[image:image-20220607172042-11.png]]
2.2	1223
	1224
	1225
32.4	1226	=== 4.3.1 Battery Note ===
2.2	1227
32.4	1228	(((
2.2	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.
32.4	1230	)))
2.2	1231
	1232
	1233
32.4	1234	=== 4.3.2 Replace the battery ===
	1235
74.20	1236	(((
90.4	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.
74.20	1238	)))
2.2	1239
74.20	1240	(((
2.2	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)
74.20	1242	)))
2.2	1243
	1244
	1245
33.2	1246	= 5. Use AT Command =
2.2	1247
33.2	1248	== 5.1 Access AT Commands ==
2.2	1249
	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
72.2	1252	[[image:1654593668970-604.png]]
2.2	1253
34.6	1254	Connection:
2.2	1255
34.2	1256	(% style="background-color:yellow" %) USB TTL GND <~-~-~-~-> GND
2.2	1257
34.2	1258	(% style="background-color:yellow" %) USB TTL TXD <~-~-~-~-> UART_RXD
2.2	1259
34.2	1260	(% style="background-color:yellow" %) USB TTL RXD <~-~-~-~-> UART_TXD
2.2	1261
	1262
74.21	1263	(((
34.6	1264	In the PC, you need to set the serial baud rate to (% style="color:green" %)9600(%%) to access the serial console for LSPH01. LSPH01 will output system info once power on as below:
74.21	1265	)))
2.2	1266
	1267
72.2	1268	[[image:1654593712276-618.png]]
2.2	1269
85.3	1270	Valid AT Command please check [[Configure Device>>\|\|anchor="H3.ConfigureLSPH01viaATCommandorLoRaWANDownlink"]].
2.2	1271
	1272
34.7	1273	= 6. FAQ =
2.2	1274
34.7	1275	== 6.1 How to change the LoRa Frequency Bands/Region ==
	1276
85.3	1277	You can follow the instructions for [[how to upgrade image>>\|\|anchor="H2.10200BFirmwareChangeLog"]].
2.2	1278	When downloading the images, choose the required image file for download.
	1279
	1280
34.7	1281	= 7. Trouble Shooting =
2.2	1282
90.2	1283	== 7.1 AT Commands input doesn't work ==
34.7	1284
90.3	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.
2.2	1286
	1287
85.21	1288
34.9	1289	= 8. Order Info =
2.2	1290
34.9	1291	Part Number: (% style="color:blue" %)LSPH01-XX
2.2	1292
	1293
34.9	1294	(% style="color:blue" %)XX(%%): The default frequency band
2.2	1295
34.13	1296	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
34.9	1297	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	1298	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	1299	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	1300	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	1301	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
34.13	1302	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
34.9	1303	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
2.2	1304
94.1	1305
	1306
34.9	1307	= 9. Packing Info =
	1308
	1309
2.2	1310	Package Includes:
	1311
	1312	* LSPH01 LoRaWAN Soil Ph Sensor x 1
	1313
	1314	Dimension and weight:
	1315
	1316	* Device Size: cm
	1317	* Device Weight: g
	1318	* Package Size / pcs : cm
	1319	* Weight / pcs : g
	1320
94.1	1321
	1322
2.4	1323	= 10. Support =
2.2	1324
	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.
34.12	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]].
2.2	1327
72.3	1328

Wiki source code of LSPH01-LoRaWAN Soil pH Sensor User Manual

Applications