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

Version 68.1 by David Huang on 2023/06/06 16:35

version	line-number	content
67.19	1	(% style="text-align:center" %)
	2	[[image:image-20230530181154-3.jpeg\|\|height="697" width="697"]]
1.1	3
67.2	4
	5
	6
	7
31.2	8	Table of Contents：
30.1	9
67.19	10	{{toc/}}
1.1	11
	12
	13
	14
	15
	16
31.1	17	= 1. Introduction =
1.1	18
67.20	19	== 1.1 What is LoRaWAN Soil Moisture & EC Sensor ==
1.1	20
39.6	21
67.5	22	The Dragino SE01-LB is a (% style="color:blue" %)LoRaWAN Soil Moisture & EC Sensor(%%) for IoT of Agriculture. It is designed to measure the (% style="color:blue" %)soil moisture of saline-alkali soil and loamy soil(%%). The soil sensor uses (% style="color:blue" %)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.
1.1	23
67.5	24	It detects (% style="color:blue" %)Soil Moisture(%%), (% style="color:blue" %)Soil Temperature(%%) and (% style="color:blue" %)Soil Conductivity(%%), and uploads the value via wireless to LoRaWAN IoT Server.
1.1	25
67.5	26	The LoRa wireless technology used in SE01-LB 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.
1.1	27
67.5	28	SE01-LB (% style="color:blue" %)supports BLE configure(%%) and (% style="color:blue" %)wireless OTA update(%%) which make user easy to use.
1.1	29
67.5	30	SE01-LB is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), it is designed for long term use up to 5 years.
62.4	31
67.5	32	Each SE01-LB 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.
1.1	33
67.19	34	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654503236291-817.png?rev=1.1\|\|alt="1654503236291-817.png"]]
1.1	35
67.19	36	[[image:image-20230530181051-1.png\|\|height="403" width="806"]]
64.2	37
	38
1.1	39	== 1.2 Features ==
	40
39.6	41
1.1	42	* LoRaWAN 1.0.3 Class A
62.4	43	* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
1.1	44	* Ultra-low power consumption
67.5	45	* Monitor Soil Moisture
	46	* Monitor Soil Temperature
	47	* Monitor Soil Conductivity
1.1	48	* Support Bluetooth v5.1 and LoRaWAN remote configure
	49	* Support wireless OTA update firmware
67.5	50	* AT Commands to change parameters
1.1	51	* Downlink to change configure
67.5	52	* IP66 Waterproof Enclosure
1.1	53	* 8500mAh Battery for long term use
	54
67.19	55
	56
1.1	57	== 1.3 Specification ==
	58
	59
67.5	60	(% style="color:blue" %)Common DC Characteristics:
1.1	61
	62	* Supply Voltage: built in 8500mAh Li-SOCI2 battery , 2.5v ~~ 3.6v
	63	* Operating Temperature: -40 ~~ 85°C
	64
67.5	65	(% style="color:blue" %)Soil Moisture:
1.1	66
67.5	67	* Range: 0-100.00 V/V %
	68	* Resolution: 0.01 V/V %
	69	* Accuracy: ±3% (0-53%)V/V %, ±5% (>53%) V/V %
	70	* Measure Method: FDR , with temperature &EC compensate
	71
	72	(% style="color:blue" %)Soil Temperature
	73
	74	* Range: -40.00℃～85.00℃
	75	* Resolution: 0.01℃
	76	* Accuracy: -10℃～50℃:<0.3℃ ,All other: <0.6℃
	77	* Measure Method: RTD, and calibrate
	78
	79	(% style="color:blue" %)Soil Conductivity
	80
	81	* Range: 0-20000 uS/cm(25℃)(0-20.0EC)
	82	* Resolution: 1 uS/cm
	83	* Accuracy: 2%FS
	84	* Measure Method: Conductivity , with temperature compensate
	85
	86	(% style="color:blue" %)LoRa Spec:
	87
1.1	88	* Frequency Range, Band 1 (HF): 862 ~~ 1020 Mhz
	89	* Max +22 dBm constant RF output vs.
	90	* RX sensitivity: down to -139 dBm.
	91	* Excellent blocking immunity
	92
67.5	93	(% style="color:blue" %)Battery:
1.1	94
	95	* Li/SOCI2 un-chargeable battery
	96	* Capacity: 8500mAh
	97	* Self-Discharge: <1% / Year @ 25°C
	98	* Max continuously current: 130mA
	99	* Max boost current: 2A, 1 second
	100
67.5	101	(% style="color:blue" %)Power Consumption
1.1	102
	103	* Sleep Mode: 5uA @ 3.3v
	104	* LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
	105
67.19	106
	107
62.4	108	== 1.4 Applications ==
1.1	109
62.4	110
67.6	111	* Smart Agriculture
62.4	112
67.19	113
	114
62.4	115	== 1.5 Sleep mode and working mode ==
	116
	117
1.1	118	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
	119
	120	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
	121
	122
62.9	123	== 1.6 Button & LEDs ==
1.1	124
	125
67.19	126	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
1.1	127
	128
14.13	129	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
14.11	130	\|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)Behavior on ACT\|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)Action
1.1	131	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
	132	If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
	133	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	134	)))
	135	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
	136	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)OTA mode(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
	137	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
	138	Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
	139	)))
6.1	140	\|(% style="width:167px" %)Fast press ACT 5 times.\|(% style="width:117px" %)Deactivate Device\|(% style="width:225px" %)(% style="color:red" %)Red led(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
1.1	141
67.19	142
	143
62.9	144	== 1.7 BLE connection ==
1.1	145
	146
67.12	147	SE01-LB support BLE remote configure.
1.1	148
	149
	150	BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
	151
	152	* Press button to send an uplink
	153	* Press button to active device.
	154	* Device Power on or reset.
	155
	156	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	157
	158
62.9	159	== 1.8 Pin Definitions ==
1.1	160
67.19	161	[[image:image-20230523174230-1.png]]
1.1	162
43.1	163
62.9	164	== 1.9 Mechanical ==
43.1	165
	166
67.19	167	(% style="color:blue" %)Main Device Dimension:
1.1	168
67.19	169	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]]
1.1	170
	171
67.19	172	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143899218-599.png]]
1.1	173
	174
67.19	175	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143909447-639.png]]
1.1	176
67.18	177
67.6	178	(% style="color:blue" %)Probe Dimension:
	179
67.19	180	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/image-20221008135912-1.png?rev=1.1\|\|alt="image-20221008135912-1.png"]]
67.6	181
67.19	182
67.12	183	= 2. Configure SE01-LB to connect to LoRaWAN network =
1.1	184
	185	== 2.1 How it works ==
	186
	187
67.6	188	The SE01-LB is configured as (% style="color:#037691" %)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 press the button to activate the SE01-LB. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
1.1	189
64.2	190	(% style="display:none" %) (%%)
1.1	191
	192	== 2.2 Quick guide to connect to LoRaWAN server (OTAA) ==
	193
	194
	195	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 [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
	196
67.19	197	[[image:image-20230530181115-2.png\|\|height="403" width="806"]]
	198
62.5	199	The LPS8v2 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.
1.1	200
67.19	201	(% style="display:none" %)
1.1	202
64.2	203
67.6	204	(% style="color:blue" %)Step 1:(%%) Create a device in TTN with the OTAA keys from SE01-LB.
1.1	205
67.6	206	Each SE01-LB is shipped with a sticker with the default device EUI as below:
1.1	207
67.19	208	[[image:image-20230426084152-1.png\|\|alt="图片-20230426084152-1.png" height="233" width="502"]]
1.1	209
	210
	211	You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
	212
	213
	214	(% style="color:blue" %)Register the device
	215
67.19	216	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/1654935135620-998.png?rev=1.1\|\|alt="1654935135620-998.png"]]
1.1	217
	218
	219	(% style="color:blue" %)Add APP EUI and DEV EUI
	220
67.19	221	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-4.png?width=753&height=551&rev=1.1\|\|alt="图片-20220611161308-4.png"]]
1.1	222
	223
	224	(% style="color:blue" %)Add APP EUI in the application
	225
	226
67.19	227	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-5.png?width=742&height=601&rev=1.1\|\|alt="图片-20220611161308-5.png"]]
1.1	228
	229
	230	(% style="color:blue" %)Add APP KEY
	231
67.19	232	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1\|\|alt="图片-20220611161308-6.png"]]
1.1	233
	234
67.6	235	(% style="color:blue" %)Step 2:(%%) Activate on SE01-LB
1.1	236
	237
67.6	238	Press the button for 5 seconds to activate the SE01-LB.
6.1	239
1.1	240	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:blue" %)OTA mode(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
	241
	242	After join success, it will start to upload messages to TTN and you can see the messages in the panel.
	243
	244
	245	== 2.3 Uplink Payload ==
	246
67.7	247	=== 2.3.1 MOD~=0(Default Mode)(% style="display:none" %) (%%) ===
1.1	248
	249
67.12	250	SE01-LB will uplink payload via LoRaWAN with below payload format:
1.1	251
67.7	252	(((
	253	Uplink payload includes in total 11 bytes.
	254	)))
1.1	255
67.7	256	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
67.17	257	\|(% style="background-color:#d9e2f3; color:#0070c0" %)Size(bytes)\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)1
67.7	258	\|Value\|[[BAT>>\|\|anchor="H2.3.3BatteryInfo"]]\|(((
	259	Temperature
	260	(Reserve, Ignore now)
	261	)))\|[[Soil Moisture>>\|\|anchor="H2.3.4SoilMoisture"]]\|[[Soil Temperature>>\|\|anchor="H2.3.5SoilTemperature"]]\|[[Soil Conductivity (EC)>>\|\|anchor="H2.3.6SoilConductivity28EC29"]]\|(((
	262	MOD & Digital Interrupt(Optional)
	263	)))
1.1	264
67.19	265
	266
67.7	267	=== 2.3.2 MOD~=1(Original value) ===
1.1	268
	269
67.7	270	This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation).
1.1	271
67.7	272	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
67.17	273	\|(% style="background-color:#d9e2f3; color:#0070c0" %)Size(bytes)\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)2\|(% style="background-color:#d9e2f3; color:#0070c0" %)1
67.7	274	\|Value\|[[BAT>>\|\|anchor="H2.3.3BatteryInfo"]]\|(((
	275	Temperature
	276	(Reserve, Ignore now)
	277	)))\|[[Soil Conductivity (EC)>>\|\|anchor="H2.3.6SoilConductivity28EC29"]](raw)\|[[Soil Moisture>>\|\|anchor="H2.3.4SoilMoisture"]](raw)\|[[Dielectric constant>>\|\|anchor="H2.3.6SoilConductivity28EC29"]](raw)\|(((
	278	MOD & Digital Interrupt(Optional)
	279	)))
1.1	280
67.19	281
	282
67.7	283	=== 2.3.3 Battery Info ===
1.1	284
	285
62.5	286	(((
67.12	287	Check the battery voltage for SE01-LB.
62.5	288	)))
58.1	289
62.5	290	(((
67.7	291	Ex1: 0x0B45 = 2885mV
62.5	292	)))
1.1	293
62.5	294	(((
67.7	295	Ex2: 0x0B49 = 2889mV
62.5	296	)))
1.1	297
	298
67.7	299	=== 2.3.4 Soil Moisture ===
1.1	300
	301
62.5	302	(((
67.7	303	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.
62.5	304	)))
1.1	305
62.5	306	(((
67.19	307	For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is (% style="color:blue" %)05DC(H) = 1500(D) /100 = 15%.
62.5	308	)))
1.1	309
	310
67.7	311	=== 2.3.5 Soil Temperature ===
1.1	312
	313
62.5	314	(((
67.7	315	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
62.5	316	)))
46.1	317
62.5	318	(((
67.7	319	Example:
62.5	320	)))
46.1	321
62.5	322	(((
67.7	323	If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
62.5	324	)))
1.1	325
62.5	326	(((
67.7	327	If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
62.5	328	)))
1.1	329
	330
67.7	331	=== 2.3.6 Soil Conductivity (EC) ===
14.22	332
1.1	333
62.5	334	(((
67.14	335	Obtain (% style="color:blue" %)__soluble salt concentration__(%%) in soil or (% style="color:blue" %)__soluble ion concentration in liquid fertilizer__(%%) or (% style="color:blue" %)__planting medium__(%%). The value range of the register is 0 - 20000(Decimal)( Can be greater than 20000).
62.5	336	)))
1.1	337
62.5	338	(((
67.7	339	For example, if the data you get from the register is 0x00 0xC8, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.
62.5	340	)))
1.1	341
62.5	342	(((
67.7	343	Generally, the EC value of irrigation water is less than 800uS / cm.
62.5	344	)))
1.1	345
62.5	346	(((
	347
	348	)))
1.1	349
67.7	350	=== 2.3.7 MOD ===
62.5	351
1.1	352
67.7	353	Firmware version at least v2.1 supports changing mode.
1.1	354
67.7	355	For example, bytes[10]=90
1.1	356
67.7	357	mod=(bytes[10]>>7)&0x01=1.
39.5	358
1.1	359
67.7	360	(% style="color:blue" %)Downlink Command:
1.1	361
67.7	362	If payload = 0x0A00, workmode=0
1.1	363
67.7	364	If payload = 0x0A01, workmode=1
1.1	365
	366
67.7	367	=== 2.3.8 Decode payload in The Things Network ===
1.1	368
	369
67.7	370	While using TTN network, you can add the payload format to decode the payload.
39.5	371
67.19	372	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654505570700-128.png?rev=1.1\|\|alt="1654505570700-128.png"]]
1.1	373
55.1	374	(((
67.7	375	The payload decoder function for TTN is here:
55.1	376	)))
	377
	378	(((
67.8	379	SE01-LB TTN Payload Decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
46.1	380
62.5	381
	382	)))
1.1	383
67.7	384	== 2.4 Uplink Interval ==
1.1	385
	386
67.8	387	The SE01-LB 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"]]
1.1	388
	389
67.7	390	== 2.5 Downlink Payload ==
1.1	391
	392
67.7	393	By default, LSE01 prints the downlink payload to console port.
1.1	394
67.7	395	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479.818px" %)
	396	\|=(% style="width: 183px; background-color:#D9E2F3;color:#0070C0" %)Downlink Control Type\|=(% style="width: 55px; background-color:#D9E2F3;color:#0070C0" %)FPort\|=(% style="width: 93px; background-color:#D9E2F3;color:#0070C0" %)Type Code\|=(% style="width: 146px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)Downlink payload size(bytes)
	397	\|(% style="width:183px" %)TDC (Transmit Time Interval)\|(% style="width:55px" %)Any\|(% style="width:93px" %)01\|(% style="width:146px" %)4
	398	\|(% style="width:183px" %)RESET\|(% style="width:55px" %)Any\|(% style="width:93px" %)04\|(% style="width:146px" %)2
	399	\|(% style="width:183px" %)AT+CFM\|(% style="width:55px" %)Any\|(% style="width:93px" %)05\|(% style="width:146px" %)4
	400	\|(% style="width:183px" %)INTMOD\|(% style="width:55px" %)Any\|(% style="width:93px" %)06\|(% style="width:146px" %)4
	401	\|(% style="width:183px" %)MOD\|(% style="width:55px" %)Any\|(% style="width:93px" %)0A\|(% style="width:146px" %)2
1.1	402
62.5	403	(((
67.7	404	(% style="color:blue" %)Examples:
62.5	405	)))
1.1	406
67.7	407	* (((
	408	(% style="color:blue" %)Set TDC
62.5	409	)))
1.1	410
62.5	411	(((
67.7	412	If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
62.5	413	)))
14.26	414
62.5	415	(((
67.7	416	Payload: 01 00 00 1E TDC=30S
62.5	417	)))
55.1	418
14.44	419	(((
67.7	420	Payload: 01 00 00 3C TDC=60S
14.44	421	)))
1.1	422
14.44	423	(((
67.7	424
14.44	425	)))
1.1	426
67.7	427	* (((
	428	(% style="color:blue" %)Reset
14.44	429	)))
1.1	430
14.44	431	(((
67.12	432	If payload = 0x04FF, it will reset the SE01-LB
14.44	433	)))
1.1	434
	435
67.7	436	* (% style="color:blue" %)CFM
1.1	437
67.7	438	Downlink Payload: 05000001, Set AT+CFM=1 or 05000000 , set AT+CFM=0
62.5	439
1.1	440
67.9	441	== 2.6 Datalog Feature ==
1.1	442
	443
67.12	444	Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, SE01-LB will store the reading for future retrieving purposes.
62.5	445
	446
67.9	447	=== 2.6.1 Ways to get datalog via LoRaWAN ===
62.5	448
	449
67.12	450	Set PNACKMD=1, SE01-LB will wait for ACK for every uplink, when there is no LoRaWAN network,SE01-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
62.5	451
	452	* (((
67.12	453	a) SE01-LB will do an ACK check for data records sending to make sure every data arrive server.
62.5	454	)))
	455	* (((
67.12	456	b) SE01-LB will send data in CONFIRMED Mode when PNACKMD=1, but SE01-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if SE01-LB gets a ACK, SE01-LB will consider there is a network connection and resend all NONE-ACK messages.
62.5	457	)))
	458
	459	Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
	460
67.19	461	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1\|\|alt="图片-20220703111700-2.png" height="381" width="1119"]]
62.5	462
	463
67.9	464	=== 2.6.2 Unix TimeStamp ===
62.5	465
	466
67.12	467	SE01-LB uses Unix TimeStamp format based on
62.5	468
67.19	469	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1\|\|alt="图片-20220523001219-11.png" height="97" width="627"]]
62.5	470
	471	User can get this time from link: [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
	472
	473	Below is the converter example
	474
67.19	475	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1\|\|alt="图片-20220523001219-12.png" height="298" width="720"]]
62.5	476
	477
	478	So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
	479
	480
67.9	481	=== 2.6.3 Set Device Time ===
62.5	482
	483
	484	User need to set (% style="color:blue" %)SYNCMOD=1(%%) to enable sync time via MAC command.
	485
67.12	486	Once SE01-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to SE01-LB. If SE01-LB fails to get the time from the server, SE01-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
62.5	487
	488	(% style="color:red" %)Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.
	489
	490
67.9	491	=== 2.6.4 Poll sensor value ===
62.5	492
	493
	494	Users can poll sensor values based on timestamps. Below is the downlink command.
	495
	496	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %)
	497	\|(% colspan="4" style="background-color:#d9e2f3; color:#0070c0; width:423px" %)Downlink Command to poll Open/Close status (0x31)
	498	\|(% style="width:58px" %)1byte\|(% style="width:127px" %)4bytes\|(% style="width:124px" %)4bytes\|(% style="width:114px" %)1byte
	499	\|(% style="width:58px" %)31\|(% style="width:127px" %)Timestamp start\|(% style="width:124px" %)Timestamp end\|(% style="width:114px" %)Uplink Interval
	500
	501	(((
	502	Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval.
	503	)))
	504
	505	(((
67.19	506	For example, downlink command [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1\|\|alt="image-20220518162852-1.png"]]
62.5	507	)))
	508
	509	(((
	510	Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
	511	)))
	512
	513	(((
67.12	514	Uplink Internal =5s，means SE01-LB will send one packet every 5s. range 5~~255s.
62.5	515	)))
	516
	517
67.9	518	== 2.7 Frequency Plans ==
1.1	519
	520
67.12	521	The SE01-LB 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.
1.1	522
	523	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
	524
	525
67.9	526	== 2.8 Installation in Soil ==
1.1	527
67.9	528
	529	(% style="color:blue" %)Measurement the soil surface
	530
67.19	531	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654506634463-199.png?rev=1.1\|\|alt="1654506634463-199.png"]]
67.9	532
	533	(((
	534	(((
	535	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.
	536	)))
	537	)))
	538
	539
67.19	540	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/1654506665940-119.png?rev=1.1\|\|alt="1654506665940-119.png"]]
67.9	541
	542	(((
	543	Dig a hole with diameter > 20CM.
	544	)))
	545
	546	(((
	547	Horizontal insert the probe to the soil and fill the hole for long term measurement.
	548
	549
	550	)))
	551
	552	= 3. Configure SE01-LB =
	553
16.4	554	== 3.1 Configure Methods ==
1.1	555
	556
67.12	557	SE01-LB supports below configure method:
1.1	558
	559	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
64.12	560
11.1	561	* AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
64.12	562
1.1	563	* LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
	564
67.19	565
	566
1.1	567	== 3.2 General Commands ==
	568
	569
	570	These commands are to configure:
	571
	572	* General system settings like: uplink interval.
64.12	573
1.1	574	* LoRaWAN protocol & radio related command.
	575
	576	They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
	577
	578	[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
	579
	580
67.9	581	== 3.3 Commands special design for SE01-LB ==
1.1	582
	583
67.9	584	These commands only valid for SE01-LB, as below:
1.1	585
	586
	587	=== 3.3.1 Set Transmit Interval Time ===
	588
	589
62.5	590	(((
1.1	591	Feature: Change LoRaWAN End Node Transmit Interval.
62.5	592	)))
	593
	594	(((
1.1	595	(% style="color:blue" %)AT Command: AT+TDC
62.5	596	)))
1.1	597
14.34	598	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
62.5	599	\|=(% style="width: 156px;background-color:#D9E2F3; color:#0070c0" %)Command Example\|=(% style="width: 137px;background-color:#D9E2F3; color:#0070c0" %)Function\|=(% style="background-color:#D9E2F3; color:#0070c0" %)Response
1.1	600	\|(% style="width:156px" %)AT+TDC=?\|(% style="width:137px" %)Show current transmit Interval\|(((
	601	30000
	602	OK
	603	the interval is 30000ms = 30s
	604	)))
	605	\|(% style="width:156px" %)AT+TDC=60000\|(% style="width:137px" %)Set Transmit Interval\|(((
	606	OK
	607	Set transmit interval to 60000ms = 60 seconds
	608	)))
	609
62.5	610	(((
1.1	611	(% style="color:blue" %)Downlink Command: 0x01
62.5	612	)))
1.1	613
62.5	614	(((
1.1	615	Format: Command Code (0x01) followed by 3 bytes time value.
62.5	616	)))
1.1	617
62.5	618	(((
1.1	619	If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
62.5	620	)))
1.1	621
62.5	622	* (((
	623	Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	624	)))
64.13	625
62.5	626	* (((
	627	Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
64.15	628
	629
	630
62.5	631	)))
1.1	632
62.5	633	=== 3.3.2 Quit AT Command ===
	634
	635
	636	Feature: Quit AT Command mode, so user needs to input the password again before using AT Commands.
	637
	638	(% style="color:blue" %)AT Command: AT+DISAT
	639
	640	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:452px" %)
	641	\|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 198px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 99px;background-color:#D9E2F3;color:#0070C0" %)Response
	642	\|(% style="width:155px" %)AT+DISAT\|(% style="width:198px" %)Quit AT Commands mode\|(% style="width:96px" %)OK
	643
	644	(% style="color:blue" %)Downlink Command:
	645
	646	No downlink command for this feature.
	647
	648
67.10	649	=== 3.3.3 Set Interrupt Mode ===
62.5	650
	651
43.1	652	Feature, Set Interrupt mode for PA8 of pin.
1.1	653
46.1	654	When AT+INTMOD=0 is set, PA8 is used as a digital input port.
	655
1.1	656	(% style="color:blue" %)AT Command: AT+INTMOD
	657
14.34	658	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
62.5	659	\|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)Response
1.1	660	\|(% style="width:154px" %)AT+INTMOD=?\|(% style="width:196px" %)Show current interrupt mode\|(% style="width:157px" %)(((
	661	0
	662	OK
	663	the mode is 0 =Disable Interrupt
	664	)))
	665	\|(% style="width:154px" %)AT+INTMOD=2\|(% style="width:196px" %)(((
	666	Set Transmit Interval
	667	0. (Disable Interrupt),
	668	~1. (Trigger by rising and falling edge)
	669	2. (Trigger by falling edge)
	670	3. (Trigger by rising edge)
	671	)))\|(% style="width:157px" %)OK
	672
	673	(% style="color:blue" %)Downlink Command: 0x06
	674
	675	Format: Command Code (0x06) followed by 3 bytes.
	676
	677	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	678
	679	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
62.6	680
1.1	681	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
	682
67.19	683
	684
67.10	685	=== 3.3.4 Set Power Output Duration ===
62.5	686
	687
41.1	688	Control the output duration 5V . Before each sampling, device will
	689
	690	~1. first enable the power output to external sensor,
	691
	692	2. keep it on as per duration, read sensor value and construct uplink payload
	693
	694	3. final, close the power output.
	695
	696	(% style="color:blue" %)AT Command: AT+5VT
	697
	698	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
62.5	699	\|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)Response
41.1	700	\|(% style="width:154px" %)AT+5VT=?\|(% style="width:196px" %)Show 5V open time.\|(% style="width:157px" %)0 (default)
	701	OK
	702	\|(% style="width:154px" %)AT+5VT=500\|(% style="width:196px" %)Close after a delay of 1000 milliseconds.\|(% style="width:157px" %)OK
	703
	704	(% style="color:blue" %)Downlink Command: 0x07
	705
	706	Format: Command Code (0x07) followed by 2 bytes.
	707
	708	The first and second bytes are the time to turn on.
	709
	710	* Example 1: Downlink Payload: 070000 ~-~--> AT+5VT=0
62.7	711
41.1	712	* Example 2: Downlink Payload: 0701F4 ~-~--> AT+5VT=500
	713
67.19	714
	715
16.4	716	= 4. Battery & Power Consumption =
14.45	717
1.1	718
67.12	719	SE01-LB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	720
	721	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	722
	723
16.4	724	= 5. OTA Firmware update =
1.1	725
	726
13.1	727	(% class="wikigeneratedid" %)
67.12	728	User can change firmware SE01-LB to:
1.1	729
13.1	730	* Change Frequency band/ region.
62.7	731
13.1	732	* Update with new features.
62.7	733
13.1	734	* Fix bugs.
1.1	735
31.1	736	Firmware and changelog can be downloaded from : [[Firmware download link>>url:https://www.dropbox.com/sh/kwqv57tp6pejias/AAAopYMATh1GM6fZ-VRCLrpDa?dl=0]]
1.1	737
31.1	738	Methods to Update Firmware:
1.1	739
31.1	740	* (Recommanded way) OTA firmware update via wireless: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]
62.7	741
39.6	742	* Update through UART TTL interface. [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]].
1.1	743
67.19	744
	745
31.1	746	= 6. FAQ =
1.1	747
62.7	748	== 6.1 AT Commands input doesn't work ==
1.1	749
	750
62.7	751	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.
	752
	753
67.12	754	== 6.2 Can I calibrate SE01-LB to different soil types? ==
67.10	755
	756
	757	(((
67.13	758	SE01-LB 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/downloads/LoRa_End_Node/LSE01/Calibrate_to_other_Soil_20230522.pdf]].
67.10	759	)))
	760
	761
	762	== 6.3 Why I can't join TTN in US915 / AU915 bands? ==
	763
	764
	765	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.
	766
	767
31.1	768	= 7. Order Info =
1.1	769
	770
67.10	771	Part Number: (% style="color:blue" %)SE01-LB-XXX
1.1	772
62.7	773	(% style="color:red" %)XXX(%%): The default frequency band
1.1	774
38.1	775	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
1.1	776
38.1	777	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
1.1	778
38.1	779	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
1.1	780
38.1	781	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
1.1	782
38.1	783	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
1.1	784
38.1	785	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
1.1	786
38.1	787	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
1.1	788
38.1	789	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
1.1	790
67.10	791
	792
31.1	793	= 8. Packing Info =
1.1	794
39.6	795
39.1	796	(% style="color:#037691" %)Package Includes:
1.1	797
67.10	798	* SE01-LB LoRaWAN Soil Moisture & EC Sensor
1.1	799
39.1	800	(% style="color:#037691" %)Dimension and weight:
1.1	801
31.1	802	* Device Size: cm
1.1	803
31.1	804	* Device Weight: g
1.1	805
31.1	806	* Package Size / pcs : cm
1.1	807
31.1	808	* Weight / pcs : g
1.1	809
67.19	810
	811
31.1	812	= 9. Support =
1.1	813
	814
31.1	815	* 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.
39.6	816
	817	* 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.cc>>mailto:Support@dragino.cc]].

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

Applications

Navigation