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

Version 98.5 by Xiaoling on 2022/06/30 14:01

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

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

Applications