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

Version 74.2 by Xiaoling on 2022/06/07 17:47

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

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

Applications