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

Version 47.3 by Xiaoling on 2023/05/23 13:52

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