Wiki source code of LSE01-LoRaWAN Soil Moisture & EC Sensor User Manual

Version 47.8 by Xiaoling on 2023/05/23 14:06

version	line-number	content
4.2	1	(% style="text-align:center" %)
31.14	2	[[image:image-20220606151504-2.jpeg\|\|height="554" width="554"]]
1.1	3
	4
	5
35.25	6
	7
	8
	9
	10
	11
	12
	13
35.4	14	Table of Contents:
1.1	15
31.17	16	{{toc/}}
1.1	17
	18
	19
	20
31.17	21
	22
12.2	23	= 1. Introduction =
1.1	24
12.2	25	== 1.1 What is LoRaWAN Soil Moisture & EC Sensor ==
1.1	26
45.3	27
12.2	28	(((
	29	The Dragino LSE01 is a (% style="color:#4f81bd" %)LoRaWAN Soil Moisture & EC Sensor(%%) for IoT of Agriculture. It is designed to measure the soil moisture of saline-alkali soil and loamy soil. The soil sensor uses FDR method to calculate the soil moisture with the compensation from soil temperature and conductivity. It also has been calibrated in factory for Mineral soil type.
	30	)))
1.1	31
12.2	32	(((
	33	It detects (% style="color:#4f81bd" %)Soil Moisture(%%), (% style="color:#4f81bd" %)Soil Temperature(%%) and (% style="color:#4f81bd" %)Soil Conductivity(%%), and uploads the value via wireless to LoRaWAN IoT Server.
	34	)))
1.1	35
12.2	36	(((
4.2	37	The LoRa wireless technology used in LES01 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.
12.2	38	)))
4.2	39
12.2	40	(((
	41	LES01 is powered by (% style="color:#4f81bd" %)4000mA or 8500mAh Li-SOCI2 battery(%%), It is designed for long term use up to 10 years.
	42	)))
4.2	43
12.2	44	(((
4.2	45	Each LES01 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.
12.2	46	)))
4.2	47
	48
12.2	49	[[image:1654503236291-817.png]]
4.2	50
	51
13.2	52	[[image:1654503265560-120.png]]
4.2	53
	54
13.3	55	== 1.2 Features ==
	56
42.4	57
4.2	58	* LoRaWAN 1.0.3 Class A
	59	* Ultra low power consumption
	60	* Monitor Soil Moisture
	61	* Monitor Soil Temperature
	62	* Monitor Soil Conductivity
	63	* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
	64	* AT Commands to change parameters
	65	* Uplink on periodically
	66	* Downlink to change configure
	67	* IP66 Waterproof Enclosure
	68	* 4000mAh or 8500mAh Battery for long term use
	69
13.3	70	== 1.3 Specification ==
	71
42.4	72
4.2	73	Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height.
	74
47.3	75	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)
47.5	76	\|(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)Parameter\|(% style="background-color:#d9e2f3; color:#0070c0; width:147px" %)Soil Moisture\|(% style="background-color:#d9e2f3; color:#0070c0; width:138px" %)Soil Conductivity\|(% style="background-color:#d9e2f3; color:#0070c0; width:140px" %)Soil Temperature
47.3	77	\|(% style="width:95px" %)Range\|(% style="width:146px" %)0-100.00%\|(% style="width:137px" %)(((
47.5	78	0-20000uS/cm
	79	(25℃)(0-20.0EC)
47.3	80	)))\|(% style="width:140px" %)-40.00℃～85.00℃
47.5	81	\|(% style="width:95px" %)Unit\|(% style="width:146px" %)V/V %\|(% style="width:137px" %)uS/cm\|(% style="width:140px" %)℃
47.3	82	\|(% style="width:95px" %)Resolution\|(% style="width:146px" %)0.01%\|(% style="width:137px" %)1 uS/cm\|(% style="width:140px" %)0.01℃
	83	\|(% style="width:95px" %)Accuracy\|(% style="width:146px" %)(((
	84	±3% (0-53%)
	85	±5% (>53%)
47.5	86	)))\|(% style="width:137px" %)2%FS\|(% style="width:140px" %)(((
47.3	87	-10℃～50℃:<0.3℃
	88	All other: <0.6℃
	89	)))
	90	\|(% style="width:95px" %)(((
	91	Measure
	92	Method
	93	)))\|(% style="width:146px" %)FDR , with temperature &EC compensate\|(% style="width:137px" %)Conductivity , with temperature compensate\|(% style="width:140px" %)RTD, and calibrate
	94
14.2	95
45.1	96	== 1.4 Dimension ==
4.2	97
45.2	98
47.6	99	(% style="color:blue" %)Main Device Dimension:
4.2	100
45.1	101	See LSN50v2 from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/Mechanical_Drawing/ >>https://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/Mechanical_Drawing/]]
42.4	102
45.1	103	[[image:image-20221008140228-2.png\|\|height="358" width="571"]]
	104
	105
47.6	106	(% style="color:blue" %)Probe Dimension
45.4	107
45.1	108	[[image:image-20221008135912-1.png]]
	109
	110
	111	== 1.5 Applications ==
	112
	113
42.8	114	* Smart Agriculture
4.2	115
45.1	116	== 1.6 Firmware Change log ==
42.4	117
15.6	118
14.3	119	LSE01 v1.0 : Release
4.2	120
14.3	121
	122	= 2. Configure LSE01 to connect to LoRaWAN network =
	123
	124	== 2.1 How it works ==
	125
42.4	126
15.3	127	(((
4.2	128	The LSE01 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 LSE0150. It will automatically join the network via OTAA and start to send the sensor value
15.3	129	)))
4.2	130
15.3	131	(((
42.4	132	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="H3.200BUsingtheATCommands"]].
15.3	133	)))
4.2	134
	135
14.4	136	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
4.2	137
42.4	138
4.2	139	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.
	140
	141
15.2	142	[[image:1654503992078-669.png]]
4.2	143
	144
	145	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.
	146
	147
35.8	148	(% style="color:blue" %)Step 1(%%): Create a device in TTN with the OTAA keys from LSE01.
4.2	149
	150	Each LSE01 is shipped with a sticker with the default device EUI as below:
	151
47.7	152	[[image:image-20230426084640-1.png\|\|height="241" width="519"]]
4.2	153
42.4	154
4.2	155	You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
	156
	157	Add APP EUI in the application
	158
	159
17.2	160	[[image:1654504596150-405.png]]
4.2	161
	162
	163
	164	Add APP KEY and DEV EUI
	165
18.2	166	[[image:1654504683289-357.png]]
4.2	167
	168
19.2	169
35.8	170	(% style="color:blue" %)Step 2(%%): Power on LSE01
4.2	171
	172
	173	Put a Jumper on JP2 to power on the device. ( The Jumper must be in FLASH position).
	174
19.2	175	[[image:image-20220606163915-7.png]]
4.2	176
	177
35.8	178	(% style="color:blue" %)Step 3(%%): The LSE01 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.
4.2	179
20.2	180	[[image:1654504778294-788.png]]
4.2	181
	182
20.3	183	== 2.3 Uplink Payload ==
4.2	184
47.7	185	=== 2.3.1 MOD~=0(Default Mode)(% style="display:none" %) (%%) ===
4.2	186
42.4	187
4.4	188	LSE01 will uplink payload via LoRaWAN with below payload format:
4.2	189
32.9	190	(((
4.2	191	Uplink payload includes in total 11 bytes.
32.9	192	)))
4.2	193
47.7	194	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
47.8	195	\|=Size(bytes)\|2\|2\|2\|2\|2\|1
45.4	196	\|=Value\|[[BAT>>\|\|anchor="H2.3.3BatteryInfo"]]\|(((
45.5	197	Temperature
	198	(Reserve, Ignore now)
32.4	199	)))\|[[Soil Moisture>>\|\|anchor="H2.3.4SoilMoisture"]]\|[[Soil Temperature>>\|\|anchor="H2.3.5SoilTemperature"]]\|[[Soil Conductivity (EC)>>\|\|anchor="H2.3.6SoilConductivity28EC29"]]\|(((
45.4	200	MOD & Digital Interrupt(Optional)
4.2	201	)))
	202
22.2	203	=== 2.3.2 MOD~=1(Original value) ===
	204
42.4	205
4.2	206	This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation).
	207
47.8	208	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
	209	\|=Size(bytes)\|2\|2\|2\|2\|2\|1
45.4	210	\|=Value\|[[BAT>>\|\|anchor="H2.3.3BatteryInfo"]]\|(((
45.5	211	Temperature
	212	(Reserve, Ignore now)
46.1	213	)))\|[[Soil Conductivity (EC)>>\|\|anchor="H2.3.6SoilConductivity28EC29"]](raw)\|[[Soil Moisture>>\|\|anchor="H2.3.4SoilMoisture"]](raw)\|[[Dielectric constant>>\|\|anchor="H2.3.6SoilConductivity28EC29"]](raw)\|(((
45.4	214	MOD & Digital Interrupt(Optional)
4.2	215	)))
	216
22.2	217	=== 2.3.3 Battery Info ===
	218
42.4	219
32.10	220	(((
4.2	221	Check the battery voltage for LSE01.
32.10	222	)))
4.2	223
32.10	224	(((
4.2	225	Ex1: 0x0B45 = 2885mV
32.10	226	)))
4.2	227
32.10	228	(((
4.2	229	Ex2: 0x0B49 = 2889mV
32.10	230	)))
4.2	231
	232
22.3	233	=== 2.3.4 Soil Moisture ===
4.2	234
42.4	235
32.10	236	(((
4.2	237	Get the moisture content of the soil. The value range of the register is 0-10000(Decimal), divide this value by 100 to get the percentage of moisture in the soil.
32.10	238	)))
4.2	239
32.10	240	(((
22.4	241	For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is
32.10	242	)))
4.2	243
32.10	244	(((
	245
	246	)))
4.2	247
32.10	248	(((
22.4	249	(% style="color:#4f81bd" %)05DC(H) = 1500(D) /100 = 15%.
32.10	250	)))
4.2	251
22.4	252
22.5	253	=== 2.3.5 Soil Temperature ===
	254
42.4	255
32.11	256	(((
46.2	257	Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is 0x09 0xEC, the temperature content in the soil is
32.11	258	)))
4.2	259
32.11	260	(((
4.2	261	Example:
32.11	262	)))
4.2	263
32.11	264	(((
4.2	265	If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
32.11	266	)))
4.2	267
32.11	268	(((
4.2	269	If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
32.11	270	)))
4.2	271
	272
22.6	273	=== 2.3.6 Soil Conductivity (EC) ===
	274
42.4	275
23.2	276	(((
	277	Obtain (% style="color:#4f81bd" %)__soluble salt concentration__(%%) in soil or (% style="color:#4f81bd" %)__soluble ion concentration in liquid fertilizer__(%%) or (% style="color:#4f81bd" %)__planting medium__(%%). The value range of the register is 0 - 20000(Decimal)( Can be greater than 20000).
	278	)))
4.2	279
23.2	280	(((
4.2	281	For example, if the data you get from the register is 0x00 0xC8, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.
23.2	282	)))
4.2	283
23.2	284	(((
4.2	285	Generally, the EC value of irrigation water is less than 800uS / cm.
23.2	286	)))
4.2	287
23.2	288	(((
	289
	290	)))
4.2	291
23.2	292	=== 2.3.7 MOD ===
	293
42.4	294
4.2	295	Firmware version at least v2.1 supports changing mode.
	296
	297	For example, bytes[10]=90
	298
	299	mod=(bytes[10]>>7)&0x01=1.
	300
	301
31.23	302	Downlink Command:
4.2	303
	304	If payload = 0x0A00, workmode=0
	305
	306	If payload = 0x0A01, workmode=1
	307
	308
23.2	309	=== 2.3.8 Decode payload in The Things Network ===
	310
42.4	311
4.2	312	While using TTN network, you can add the payload format to decode the payload.
	313
	314
23.2	315	[[image:1654505570700-128.png]]
4.2	316
32.12	317	(((
4.2	318	The payload decoder function for TTN is here:
32.12	319	)))
4.2	320
32.12	321	(((
45.2	322	LSE01 TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
32.12	323	)))
4.2	324
	325
23.3	326	== 2.4 Uplink Interval ==
4.2	327
42.4	328
31.26	329	The LSE01 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"]]
4.2	330
	331
24.2	332	== 2.5 Downlink Payload ==
	333
42.5	334
42.1	335	By default, LSE01 prints the downlink payload to console port.
4.2	336
24.2	337	[[image:image-20220606165544-8.png]]
4.2	338
24.2	339
32.14	340	(((
40.4	341	(% style="color:blue" %)Examples:
32.14	342	)))
4.2	343
32.14	344	(((
	345
	346	)))
4.2	347
32.14	348	* (((
40.4	349	(% style="color:blue" %)Set TDC
32.14	350	)))
4.2	351
32.14	352	(((
42.1	353	If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
32.14	354	)))
4.2	355
32.14	356	(((
4.2	357	Payload: 01 00 00 1E TDC=30S
32.14	358	)))
4.2	359
32.14	360	(((
4.2	361	Payload: 01 00 00 3C TDC=60S
32.14	362	)))
4.2	363
32.14	364	(((
	365
	366	)))
4.2	367
32.14	368	* (((
40.4	369	(% style="color:blue" %)Reset
32.14	370	)))
4.2	371
32.14	372	(((
4.2	373	If payload = 0x04FF, it will reset the LSE01
32.14	374	)))
4.2	375
	376
40.4	377	* (% style="color:blue" %)CFM
4.2	378
	379	Downlink Payload: 05000001, Set AT+CFM=1 or 05000000 , set AT+CFM=0
	380
	381
26.2	382	== 2.6 Show Data in DataCake IoT Server ==
	383
42.5	384
32.15	385	(((
4.2	386	[[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:
32.15	387	)))
4.2	388
32.15	389	(((
	390
	391	)))
4.2	392
32.15	393	(((
35.15	394	(% style="color:blue" %)Step 1(%%): Be sure that your device is programmed and properly connected to the network at this time.
32.15	395	)))
4.2	396
32.15	397	(((
35.15	398	(% 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:
32.15	399	)))
4.2	400
	401
26.2	402	[[image:1654505857935-743.png]]
4.2	403
	404
26.2	405	[[image:1654505874829-548.png]]
4.2	406
	407
35.15	408	(% style="color:blue" %)Step 3(%%): Create an account or log in Datacake.
4.2	409
35.15	410	(% style="color:blue" %)Step 4(%%): Search the LSE01 and add DevEUI.
4.2	411
35.15	412
27.2	413	[[image:1654505905236-553.png]]
4.2	414
	415
	416	After added, the sensor data arrive TTN, it will also arrive and show in Mydevices.
	417
28.2	418	[[image:1654505925508-181.png]]
4.2	419
	420
28.4	421	== 2.7 Frequency Plans ==
4.2	422
42.5	423
4.2	424	The LSE01 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.
	425
	426
28.5	427	=== 2.7.1 EU863-870 (EU868) ===
4.2	428
42.5	429
28.5	430	(% style="color:#037691" %) Uplink:
	431
4.2	432	868.1 - SF7BW125 to SF12BW125
	433
	434	868.3 - SF7BW125 to SF12BW125 and SF7BW250
	435
	436	868.5 - SF7BW125 to SF12BW125
	437
	438	867.1 - SF7BW125 to SF12BW125
	439
	440	867.3 - SF7BW125 to SF12BW125
	441
	442	867.5 - SF7BW125 to SF12BW125
	443
	444	867.7 - SF7BW125 to SF12BW125
	445
	446	867.9 - SF7BW125 to SF12BW125
	447
	448	868.8 - FSK
	449
	450
28.5	451	(% style="color:#037691" %) Downlink:
4.2	452
	453	Uplink channels 1-9 (RX1)
	454
	455	869.525 - SF9BW125 (RX2 downlink only)
	456
	457
28.5	458	=== 2.7.2 US902-928(US915) ===
	459
42.5	460
4.2	461	Used in USA, Canada and South America. Default use CHE=2
	462
28.5	463	(% style="color:#037691" %)Uplink:
4.2	464
	465	903.9 - SF7BW125 to SF10BW125
	466
	467	904.1 - SF7BW125 to SF10BW125
	468
	469	904.3 - SF7BW125 to SF10BW125
	470
	471	904.5 - SF7BW125 to SF10BW125
	472
	473	904.7 - SF7BW125 to SF10BW125
	474
	475	904.9 - SF7BW125 to SF10BW125
	476
	477	905.1 - SF7BW125 to SF10BW125
	478
	479	905.3 - SF7BW125 to SF10BW125
	480
	481
28.5	482	(% style="color:#037691" %)Downlink:
4.2	483
	484	923.3 - SF7BW500 to SF12BW500
	485
	486	923.9 - SF7BW500 to SF12BW500
	487
	488	924.5 - SF7BW500 to SF12BW500
	489
	490	925.1 - SF7BW500 to SF12BW500
	491
	492	925.7 - SF7BW500 to SF12BW500
	493
	494	926.3 - SF7BW500 to SF12BW500
	495
	496	926.9 - SF7BW500 to SF12BW500
	497
	498	927.5 - SF7BW500 to SF12BW500
	499
	500	923.3 - SF12BW500(RX2 downlink only)
	501
	502
28.5	503	=== 2.7.3 CN470-510 (CN470) ===
	504
42.5	505
4.2	506	Used in China, Default use CHE=1
	507
28.5	508	(% style="color:#037691" %)Uplink:
4.2	509
	510	486.3 - SF7BW125 to SF12BW125
	511
	512	486.5 - SF7BW125 to SF12BW125
	513
	514	486.7 - SF7BW125 to SF12BW125
	515
	516	486.9 - SF7BW125 to SF12BW125
	517
	518	487.1 - SF7BW125 to SF12BW125
	519
	520	487.3 - SF7BW125 to SF12BW125
	521
	522	487.5 - SF7BW125 to SF12BW125
	523
	524	487.7 - SF7BW125 to SF12BW125
	525
	526
28.5	527	(% style="color:#037691" %)Downlink:
4.2	528
	529	506.7 - SF7BW125 to SF12BW125
	530
	531	506.9 - SF7BW125 to SF12BW125
	532
	533	507.1 - SF7BW125 to SF12BW125
	534
	535	507.3 - SF7BW125 to SF12BW125
	536
	537	507.5 - SF7BW125 to SF12BW125
	538
	539	507.7 - SF7BW125 to SF12BW125
	540
	541	507.9 - SF7BW125 to SF12BW125
	542
	543	508.1 - SF7BW125 to SF12BW125
	544
	545	505.3 - SF12BW125 (RX2 downlink only)
	546
	547
28.5	548	=== 2.7.4 AU915-928(AU915) ===
	549
42.5	550
4.2	551	Default use CHE=2
	552
28.5	553	(% style="color:#037691" %)Uplink:
4.2	554
	555	916.8 - SF7BW125 to SF12BW125
	556
	557	917.0 - SF7BW125 to SF12BW125
	558
	559	917.2 - SF7BW125 to SF12BW125
	560
	561	917.4 - SF7BW125 to SF12BW125
	562
	563	917.6 - SF7BW125 to SF12BW125
	564
	565	917.8 - SF7BW125 to SF12BW125
	566
	567	918.0 - SF7BW125 to SF12BW125
	568
	569	918.2 - SF7BW125 to SF12BW125
	570
	571
28.5	572	(% style="color:#037691" %)Downlink:
4.2	573
	574	923.3 - SF7BW500 to SF12BW500
	575
	576	923.9 - SF7BW500 to SF12BW500
	577
	578	924.5 - SF7BW500 to SF12BW500
	579
	580	925.1 - SF7BW500 to SF12BW500
	581
	582	925.7 - SF7BW500 to SF12BW500
	583
	584	926.3 - SF7BW500 to SF12BW500
	585
	586	926.9 - SF7BW500 to SF12BW500
	587
	588	927.5 - SF7BW500 to SF12BW500
	589
	590	923.3 - SF12BW500(RX2 downlink only)
	591
	592
28.6	593	=== 2.7.5 AS920-923 & AS923-925 (AS923) ===
	594
42.5	595
28.7	596	(% style="color:#037691" %)Default Uplink channel:
4.2	597
	598	923.2 - SF7BW125 to SF10BW125
	599
	600	923.4 - SF7BW125 to SF10BW125
	601
	602
28.7	603	(% style="color:#037691" %)Additional Uplink Channel:
4.2	604
	605	(OTAA mode, channel added by JoinAccept message)
	606
28.7	607	(% style="color:#037691" %)AS920~~AS923 for Japan, Malaysia, Singapore:
4.2	608
	609	922.2 - SF7BW125 to SF10BW125
	610
	611	922.4 - SF7BW125 to SF10BW125
	612
	613	922.6 - SF7BW125 to SF10BW125
	614
	615	922.8 - SF7BW125 to SF10BW125
	616
	617	923.0 - SF7BW125 to SF10BW125
	618
	619	922.0 - SF7BW125 to SF10BW125
	620
	621
28.7	622	(% style="color:#037691" %)AS923 ~~ AS925 for Brunei, Cambodia, Hong Kong, Indonesia, Laos, Taiwan, Thailand, Vietnam:
4.2	623
	624	923.6 - SF7BW125 to SF10BW125
	625
	626	923.8 - SF7BW125 to SF10BW125
	627
	628	924.0 - SF7BW125 to SF10BW125
	629
	630	924.2 - SF7BW125 to SF10BW125
	631
	632	924.4 - SF7BW125 to SF10BW125
	633
	634	924.6 - SF7BW125 to SF10BW125
	635
	636
28.7	637	(% style="color:#037691" %) Downlink:
4.2	638
	639	Uplink channels 1-8 (RX1)
	640
	641	923.2 - SF10BW125 (RX2)
	642
	643
28.7	644	=== 2.7.6 KR920-923 (KR920) ===
	645
42.6	646
4.2	647	Default channel:
	648
	649	922.1 - SF7BW125 to SF12BW125
	650
	651	922.3 - SF7BW125 to SF12BW125
	652
	653	922.5 - SF7BW125 to SF12BW125
	654
	655
28.7	656	(% style="color:#037691" %)Uplink: (OTAA mode, channel added by JoinAccept message)
4.2	657
	658	922.1 - SF7BW125 to SF12BW125
	659
	660	922.3 - SF7BW125 to SF12BW125
	661
	662	922.5 - SF7BW125 to SF12BW125
	663
	664	922.7 - SF7BW125 to SF12BW125
	665
	666	922.9 - SF7BW125 to SF12BW125
	667
	668	923.1 - SF7BW125 to SF12BW125
	669
	670	923.3 - SF7BW125 to SF12BW125
	671
	672
28.7	673	(% style="color:#037691" %)Downlink:
4.2	674
	675	Uplink channels 1-7(RX1)
	676
	677	921.9 - SF12BW125 (RX2 downlink only; SF12BW125 might be changed to SF9BW125)
	678
	679
28.7	680	=== 2.7.7 IN865-867 (IN865) ===
4.2	681
42.6	682
28.7	683	(% style="color:#037691" %) Uplink:
	684
4.2	685	865.0625 - SF7BW125 to SF12BW125
	686
	687	865.4025 - SF7BW125 to SF12BW125
	688
	689	865.9850 - SF7BW125 to SF12BW125
	690
	691
28.7	692	(% style="color:#037691" %) Downlink:
4.2	693
	694	Uplink channels 1-3 (RX1)
	695
	696	866.550 - SF10BW125 (RX2)
	697
	698
28.7	699	== 2.8 LED Indicator ==
	700
42.6	701
4.2	702	The LSE01 has an internal LED which is to show the status of different state.
	703
	704	* Blink once when device power on.
	705	* Solid ON for 5 seconds once device successful Join the network.
	706	* Blink once when device transmit a packet.
	707
28.8	708	== 2.9 Installation in Soil ==
	709
42.6	710
4.2	711	Measurement the soil surface
	712
	713
29.2	714	[[image:1654506634463-199.png]]
4.2	715
42.6	716
29.2	717	(((
31.8	718	(((
4.2	719	Choose the proper measuring position. Avoid the probe to touch rocks or hard things. Split the surface soil according to the measured deep. Keep the measured as original density. Vertical insert the probe into the soil to be measured. Make sure not shake when inserting.
29.2	720	)))
31.8	721	)))
4.2	722
	723
35.18	724
30.2	725	[[image:1654506665940-119.png]]
4.2	726
42.6	727
31.8	728	(((
4.2	729	Dig a hole with diameter > 20CM.
31.8	730	)))
4.2	731
31.8	732	(((
4.2	733	Horizontal insert the probe to the soil and fill the hole for long term measurement.
31.8	734	)))
4.2	735
	736
30.3	737	== 2.10 Firmware Change Log ==
4.2	738
	739
31.7	740	(((
42.6	741	Firmware download link: [[https:~~/~~/www.dropbox.com/sh/8ixj7zgt477ip51/AADLrib9Oe6IuOpPF5o1GPf9a?dl=0>>https://www.dropbox.com/sh/8ixj7zgt477ip51/AADLrib9Oe6IuOpPF5o1GPf9a?dl=0]]
31.7	742	)))
4.2	743
31.7	744	(((
30.4	745	Firmware Upgrade Method: [[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome]]
31.7	746	)))
4.2	747
31.7	748	(((
	749
	750	)))
4.2	751
31.7	752	(((
4.2	753	V1.0.
31.7	754	)))
4.2	755
31.7	756	(((
4.2	757	Release
31.7	758	)))
4.2	759
	760
46.3	761	== 2.11 Battery & Power Consumption ==
4.2	762
	763
46.3	764	LSE01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
42.6	765
46.3	766	[[Battery Info & Power Consumption Analyze>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
4.2	767
	768
9.2	769	= 3. Using the AT Commands =
4.2	770
9.2	771	== 3.1 Access AT Commands ==
	772
11.4	773
4.2	774	LSE01 supports AT Command set in the stock firmware. You can use a USB to TTL adapter to connect to LSE01 for using AT command, as below.
	775
42.6	776
31.28	777	[[image:1654501986557-872.png\|\|height="391" width="800"]]
4.2	778
	779
	780	Or if you have below board, use below connection:
	781
	782
31.28	783	[[image:1654502005655-729.png\|\|height="503" width="801"]]
4.2	784
	785
11.2	786	In the PC, you need to set the serial baud rate to (% style="color:green" %)9600(%%) to access the serial console for LSE01. LSE01 will output system info once power on as below:
4.2	787
	788
31.28	789	[[image:1654502050864-459.png\|\|height="564" width="806"]]
4.2	790
	791
42.6	792	Below are the available commands, a more detailed AT Command manual can be found at [[AT Command Manual>>https://www.dropbox.com/sh/qr6vproz4z4kzjz/AAAD48h3OyWrU1hq_Cqm8jIwa?dl=0]].
4.2	793
	794
42.2	795	(% style="background-color:#dcdcdc" %)AT+<CMD>? (%%) : Help on <CMD>
4.2	796
42.2	797	(% style="background-color:#dcdcdc" %)AT+<CMD> (%%) : Run <CMD>
4.2	798
42.2	799	(% style="background-color:#dcdcdc" %)AT+<CMD>=<value>(%%) : Set the value
4.2	800
42.2	801	(% style="background-color:#dcdcdc" %)AT+<CMD>=?(%%) : Get the value
4.2	802
	803
11.6	804	(% style="color:#037691" %)General Commands(%%)
4.2	805
11.6	806	(% style="background-color:#dcdcdc" %)AT(%%) : Attention
4.2	807
11.6	808	(% style="background-color:#dcdcdc" %)AT?(%%) : Short Help
4.2	809
11.6	810	(% style="background-color:#dcdcdc" %)ATZ(%%) : MCU Reset
4.2	811
11.6	812	(% style="background-color:#dcdcdc" %)AT+TDC(%%) : Application Data Transmission Interval
4.2	813
	814
11.4	815	(% style="color:#037691" %)Keys, IDs and EUIs management
4.2	816
11.6	817	(% style="background-color:#dcdcdc" %)AT+APPEUI(%%) : Application EUI
4.2	818
11.6	819	(% style="background-color:#dcdcdc" %)AT+APPKEY(%%) : Application Key
4.2	820
11.6	821	(% style="background-color:#dcdcdc" %)AT+APPSKEY(%%) : Application Session Key
4.2	822
11.6	823	(% style="background-color:#dcdcdc" %)AT+DADDR(%%) : Device Address
4.2	824
11.6	825	(% style="background-color:#dcdcdc" %)AT+DEUI(%%) : Device EUI
4.2	826
11.6	827	(% style="background-color:#dcdcdc" %)AT+NWKID(%%) : Network ID (You can enter this command change only after successful network connection)
4.2	828
11.6	829	(% style="background-color:#dcdcdc" %)AT+NWKSKEY(%%) : Network Session Key Joining and sending date on LoRa network
4.2	830
11.6	831	(% style="background-color:#dcdcdc" %)AT+CFM(%%) : Confirm Mode
4.2	832
11.6	833	(% style="background-color:#dcdcdc" %)AT+CFS(%%) : Confirm Status
4.2	834
11.6	835	(% style="background-color:#dcdcdc" %)AT+JOIN(%%) : Join LoRa? Network
4.2	836
11.6	837	(% style="background-color:#dcdcdc" %)AT+NJM(%%) : LoRa? Network Join Mode
4.2	838
11.6	839	(% style="background-color:#dcdcdc" %)AT+NJS(%%) : LoRa? Network Join Status
4.2	840
11.6	841	(% style="background-color:#dcdcdc" %)AT+RECV(%%) : Print Last Received Data in Raw Format
4.2	842
11.6	843	(% style="background-color:#dcdcdc" %)AT+RECVB(%%) : Print Last Received Data in Binary Format
4.2	844
11.6	845	(% style="background-color:#dcdcdc" %)AT+SEND(%%) : Send Text Data
4.2	846
11.6	847	(% style="background-color:#dcdcdc" %)AT+SENB(%%) : Send Hexadecimal Data
4.2	848
	849
11.4	850	(% style="color:#037691" %)LoRa Network Management
4.2	851
11.6	852	(% style="background-color:#dcdcdc" %)AT+ADR(%%) : Adaptive Rate
4.2	853
11.6	854	(% style="background-color:#dcdcdc" %)AT+CLASS(%%) : LoRa Class(Currently only support class A
4.2	855
11.6	856	(% style="background-color:#dcdcdc" %)AT+DCS(%%) : Duty Cycle Setting
4.2	857
11.6	858	(% style="background-color:#dcdcdc" %)AT+DR(%%) : Data Rate (Can Only be Modified after ADR=0)
4.2	859
11.6	860	(% style="background-color:#dcdcdc" %)AT+FCD(%%) : Frame Counter Downlink
4.2	861
11.6	862	(% style="background-color:#dcdcdc" %)AT+FCU(%%) : Frame Counter Uplink
4.2	863
11.6	864	(% style="background-color:#dcdcdc" %)AT+JN1DL(%%) : Join Accept Delay1
4.2	865
11.6	866	(% style="background-color:#dcdcdc" %)AT+JN2DL(%%) : Join Accept Delay2
4.2	867
11.6	868	(% style="background-color:#dcdcdc" %)AT+PNM(%%) : Public Network Mode
4.2	869
11.6	870	(% style="background-color:#dcdcdc" %)AT+RX1DL(%%) : Receive Delay1
4.2	871
11.6	872	(% style="background-color:#dcdcdc" %)AT+RX2DL(%%) : Receive Delay2
4.2	873
11.6	874	(% style="background-color:#dcdcdc" %)AT+RX2DR(%%) : Rx2 Window Data Rate
4.2	875
11.6	876	(% style="background-color:#dcdcdc" %)AT+RX2FQ(%%) : Rx2 Window Frequency
4.2	877
11.6	878	(% style="background-color:#dcdcdc" %)AT+TXP(%%) : Transmit Power
4.2	879
11.6	880	(% style="background-color:#dcdcdc" %)AT+ MOD(%%) : Set work mode
4.2	881
	882
11.4	883	(% style="color:#037691" %)Information
4.2	884
11.6	885	(% style="background-color:#dcdcdc" %)AT+RSSI(%%) : RSSI of the Last Received Packet
4.2	886
11.6	887	(% style="background-color:#dcdcdc" %)AT+SNR(%%) : SNR of the Last Received Packet
4.2	888
11.6	889	(% style="background-color:#dcdcdc" %)AT+VER(%%) : Image Version and Frequency Band
4.2	890
11.6	891	(% style="background-color:#dcdcdc" %)AT+FDR(%%) : Factory Data Reset
4.2	892
11.6	893	(% style="background-color:#dcdcdc" %)AT+PORT(%%) : Application Port
4.2	894
11.6	895	(% style="background-color:#dcdcdc" %)AT+CHS(%%) : Get or Set Frequency (Unit: Hz) for Single Channel Mode
4.2	896
11.6	897	(% style="background-color:#dcdcdc" %)AT+CHE(%%) : Get or Set eight channels mode, Only for US915, AU915, CN470
4.2	898
	899
6.3	900	= 4. FAQ =
4.2	901
6.3	902	== 4.1 How to change the LoRa Frequency Bands/Region? ==
	903
42.7	904
31.35	905	(((
31.24	906	You can follow the instructions for [[how to upgrade image>>\|\|anchor="H2.10200BFirmwareChangeLog"]].
4.2	907	When downloading the images, choose the required image file for download.
31.35	908	)))
4.2	909
31.35	910	(((
	911
	912	)))
4.2	913
31.35	914	(((
8.3	915	How to set up LSE01 to work in 8 channel mode By default, the frequency bands US915, AU915, CN470 work in 72 frequencies. Many gateways are 8 channel gateways, and in this case, the OTAA join time and uplink schedule is long and unpredictable while the end node is hopping in 72 frequencies.
31.35	916	)))
4.2	917
31.35	918	(((
	919
	920	)))
4.2	921
31.35	922	(((
4.2	923	You can configure the end node to work in 8 channel mode by using the AT+CHE command. The 500kHz channels are always included for OTAA.
31.35	924	)))
4.2	925
31.35	926	(((
	927
	928	)))
4.2	929
31.35	930	(((
4.2	931	For example, in US915 band, the frequency table is as below. By default, the end node will use all channels (0~~71) for OTAA Join process. After the OTAA Join, the end node will use these all channels (0~~71) to send uplink packets.
31.35	932	)))
4.2	933
8.2	934	[[image:image-20220606154726-3.png]]
4.2	935
31.36	936
4.2	937	When you use the TTN network, the US915 frequency bands use are:
	938
	939	* 903.9 - SF7BW125 to SF10BW125
	940	* 904.1 - SF7BW125 to SF10BW125
	941	* 904.3 - SF7BW125 to SF10BW125
	942	* 904.5 - SF7BW125 to SF10BW125
	943	* 904.7 - SF7BW125 to SF10BW125
	944	* 904.9 - SF7BW125 to SF10BW125
	945	* 905.1 - SF7BW125 to SF10BW125
	946	* 905.3 - SF7BW125 to SF10BW125
	947	* 904.6 - SF8BW500
	948
31.38	949	(((
4.2	950	Because the end node is now hopping in 72 frequency, it makes it difficult for the devices to Join the TTN network and uplink data. To solve this issue, you can access the device via the AT commands and run:
	951
35.21	952	* (% style="color:#037691" %)AT+CHE=2
	953	* (% style="color:#037691" %)ATZ
8.3	954	)))
4.2	955
8.3	956	(((
35.19	957
4.2	958
	959	to set the end node to work in 8 channel mode. The device will work in Channel 8-15 & 64-71 for OTAA, and channel 8-15 for Uplink.
31.38	960	)))
4.2	961
31.38	962	(((
	963
	964	)))
4.2	965
31.38	966	(((
4.2	967	The AU915 band is similar. Below are the AU915 Uplink Channels.
31.38	968	)))
4.2	969
8.2	970	[[image:image-20220606154825-4.png]]
4.2	971
	972
40.1	973	== 4.2 Can I calibrate LSE01 to different soil types? ==
4.2	974
42.7	975
45.6	976	(((
40.1	977	LSE01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/&file=Calibrate_to_other_Soil_20220605.pdf]].
45.6	978	)))
40.1	979
	980
4.8	981	= 5. Trouble Shooting =
4.2	982
40.6	983	== 5.1 Why I can't join TTN in US915 / AU915 bands? ==
4.9	984
42.7	985
40.7	986	It is due to channel mapping. Please see the [[Eight Channel Mode>>doc:Main.End Device AT Commands and Downlink Command.WebHome\|\|anchor="H7.19EightChannelMode"]] section above for details.
4.2	987
	988
40.6	989	== 5.2 AT Command input doesn't work ==
4.2	990
42.7	991
31.29	992	(((
40.6	993	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.
31.29	994	)))
4.2	995
	996
4.10	997	== 5.3 Device rejoin in at the second uplink packet ==
4.2	998
42.7	999
6.2	1000	(% style="color:#4f81bd" %)Issue describe as below:
4.2	1001
6.2	1002	[[image:1654500909990-784.png]]
4.2	1003
	1004
6.2	1005	(% style="color:#4f81bd" %)Cause for this issue:
4.2	1006
31.30	1007	(((
4.2	1008	The fuse on LSE01 is not large enough, some of the soil probe require large current up to 5v 800mA, in a short pulse. When this happen, it cause the device reboot so user see rejoin.
31.30	1009	)))
4.2	1010
	1011
6.2	1012	(% style="color:#4f81bd" %)Solution:
4.2	1013
45.6	1014	(((
4.2	1015	All new shipped LSE01 after 2020-May-30 will have this to fix. For the customer who see this issue, please bypass the fuse as below:
45.6	1016	)))
4.2	1017
31.31	1018	[[image:1654500929571-736.png\|\|height="458" width="832"]]
4.2	1019
4.7	1020
4.4	1021	= 6. Order Info =
4.2	1022
	1023
4.6	1024	Part Number: (% style="color:#4f81bd" %)LSE01-XX-YY
4.2	1025
	1026
4.6	1027	(% style="color:#4f81bd" %)XX(%%): The default frequency band
4.2	1028
4.4	1029	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	1030	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	1031	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	1032	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	1033	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	1034	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
4.5	1035	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
4.4	1036	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
4.2	1037
4.4	1038	(% style="color:#4f81bd" %)YY(%%): Battery Option
4.2	1039
4.4	1040	* (% style="color:red" %)4(%%): 4000mAh battery
	1041	* (% style="color:red" %)8(%%): 8500mAh battery
4.2	1042
31.10	1043	(% class="wikigeneratedid" %)
	1044	(((
	1045
42.1	1046
	1047
31.10	1048	)))
	1049
4.3	1050	= 7. Packing Info =
4.2	1051
4.3	1052	(((
31.39	1053
	1054
31.40	1055	(% style="color:#037691" %)Package Includes:
4.3	1056	)))
4.2	1057
4.3	1058	* (((
	1059	LSE01 LoRaWAN Soil Moisture & EC Sensor x 1
	1060	)))
4.2	1061
4.3	1062	(((
31.40	1063
	1064
	1065	(% style="color:#037691" %)Dimension and weight:
4.3	1066	)))
4.2	1067
4.3	1068	* (((
	1069	Device Size: cm
	1070	)))
	1071	* (((
	1072	Device Weight: g
	1073	)))
	1074	* (((
	1075	Package Size / pcs : cm
	1076	)))
	1077	* (((
	1078	Weight / pcs : g
31.11	1079
42.1	1080
31.11	1081
4.3	1082	)))
4.2	1083
4.3	1084	= 8. Support =
4.2	1085
42.7	1086
4.2	1087	* 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.
	1088	* 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 LSE01-LoRaWAN Soil Moisture & EC Sensor User Manual

Applications