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

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

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

Applications