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

Version 43.1 by Edwin Chen on 2022/10/08 13:59

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

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

Applications

Navigation