Last modified by Mengting Qiu on 2024/04/02 16:44

From version 32.2
edited by Xiaoling
on 2022/06/07 11:19
Change comment: There is no comment for this version
To version 44.1
edited by Xiaoling
on 2022/07/08 10:14
Change comment: Uploaded new attachment "1657246476176-652.png", version {1}

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -LSE01-LoRaWAN Soil Moisture & EC Sensor User Manual
1 +NSE01 - NB-IoT Soil Moisture & EC Sensor User Manual
Content
... ... @@ -3,9 +3,7 @@
3 3  
4 4  
5 5  
6 -**Contents:**
7 7  
8 -{{toc/}}
9 9  
10 10  
11 11  
... ... @@ -12,35 +12,36 @@
12 12  
13 13  
14 14  
13 +
14 +**Table of Contents:**
15 +
16 +
17 +
18 +
19 +
20 +
15 15  = 1. Introduction =
16 16  
17 17  == 1.1 ​What is LoRaWAN Soil Moisture & EC Sensor ==
18 18  
19 19  (((
20 -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.
21 -)))
26 +
22 22  
23 -(((
24 -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.
25 -)))
28 +Dragino NSE01 is an **NB-IOT soil moisture & EC sensor** for agricultural IoT. Used to measure the soil moisture of saline-alkali soil and loam. The soil sensor uses the FDR method to calculate soil moisture and compensates it with soil temperature and electrical conductivity. It has also been calibrated for mineral soil types at the factory.
26 26  
27 -(((
28 -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.
29 -)))
30 +It can detect **Soil Moisture, Soil Temperature and Soil Conductivity**, and upload its value to the server wirelessly.
30 30  
31 -(((
32 -LES01 is powered by (% style="color:#4f81bd" %)**4000mA or 8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 10 years.
33 -)))
32 +The wireless technology used in NSE01 allows the device to send data at a low data rate and reach ultra-long distances, providing ultra-long-distance spread spectrum Communication.
34 34  
35 -(((
36 -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.
34 +NSE01 are powered by **8500mAh Li-SOCI2** batteries, which can be used for up to 5 years.
35 +
36 +
37 37  )))
38 38  
39 -
40 40  [[image:1654503236291-817.png]]
41 41  
42 42  
43 -[[image:1654503265560-120.png]]
42 +[[image:1657245163077-232.png]]
44 44  
45 45  
46 46  
... ... @@ -58,9 +58,6 @@
58 58  * IP66 Waterproof Enclosure
59 59  * 4000mAh or 8500mAh Battery for long term use
60 60  
61 -
62 -
63 -
64 64  == 1.3 Specification ==
65 65  
66 66  Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height.
... ... @@ -108,7 +108,7 @@
108 108  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.
109 109  
110 110  
111 -**Step 1**: Create a device in TTN with the OTAA keys from LSE01.
107 +(% style="color:blue" %)**Step 1**(%%):  Create a device in TTN with the OTAA keys from LSE01.
112 112  
113 113  Each LSE01 is shipped with a sticker with the default device EUI as below:
114 114  
... ... @@ -129,7 +129,7 @@
129 129  
130 130  
131 131  
132 -**Step 2**: Power on LSE01
128 +(% style="color:blue" %)**Step 2**(%%): Power on LSE01
133 133  
134 134  
135 135  Put a Jumper on JP2 to power on the device. ( The Jumper must be in FLASH position).
... ... @@ -137,7 +137,7 @@
137 137  [[image:image-20220606163915-7.png]]
138 138  
139 139  
140 -**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.
136 +(% 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.
141 141  
142 142  [[image:1654504778294-788.png]]
143 143  
... ... @@ -145,114 +145,104 @@
145 145  
146 146  == 2.3 Uplink Payload ==
147 147  
144 +
148 148  === 2.3.1 MOD~=0(Default Mode) ===
149 149  
150 150  LSE01 will uplink payload via LoRaWAN with below payload format: 
151 151  
152 -
149 +(((
153 153  Uplink payload includes in total 11 bytes.
154 -
151 +)))
155 155  
156 -(% border="1" cellspacing="10" style="background-color:#f7faff; width:510px" %)
157 -|=(((
153 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
154 +|(((
158 158  **Size**
159 159  
160 160  **(bytes)**
161 -)))|=(% style="width: 45px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**1**
162 -|**Value**|(% style="width:45px" %)[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(% style="width:80px" %)(((
163 -(((
158 +)))|**2**|**2**|**2**|**2**|**2**|**1**
159 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(((
164 164  Temperature
165 165  
166 -(((
167 167  (Reserve, Ignore now)
168 -)))
169 -
170 -~|(% style="width:80px" %)[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|
171 -
172 -(% style="width:80px" %)
173 -(((
174 -(((
163 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|(((
175 175  MOD & Digital Interrupt
176 176  
177 -(((
178 178  (Optional)
179 179  )))
180 -)))
181 181  
182 -[[image:1654504881641-514.png]]
183 -
184 -
185 -
186 186  === 2.3.2 MOD~=1(Original value) ===
187 187  
188 188  This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation).
189 189  
190 -(% border="1" cellspacing="10" style="background-color:#f7faff; width:510px" %)
191 -|=(((
173 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
174 +|(((
192 192  **Size**
193 193  
194 194  **(bytes)**
195 -)))|=**2**|=**2**|=**2**|=**2**|=**2**|=**1**
178 +)))|**2**|**2**|**2**|**2**|**2**|**1**
196 196  |**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(((
197 -(((
198 198  Temperature
199 199  
200 -(((
201 201  (Reserve, Ignore now)
202 -)))
203 -)))
204 -
205 -~|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|
206 -
207 -(((
208 -[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)
209 -)))
210 -
211 -~|
212 -
213 -(((
214 -(((
183 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]](raw)|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|(((
215 215  MOD & Digital Interrupt
216 -)))
217 217  
218 218  (Optional)
219 219  )))
220 -)))
221 221  
222 -[[image:1654504907647-967.png]]
223 -
224 -
225 -
226 226  === 2.3.3 Battery Info ===
227 227  
191 +(((
228 228  Check the battery voltage for LSE01.
193 +)))
229 229  
195 +(((
230 230  Ex1: 0x0B45 = 2885mV
197 +)))
231 231  
199 +(((
232 232  Ex2: 0x0B49 = 2889mV
201 +)))
233 233  
234 234  
235 235  
236 236  === 2.3.4 Soil Moisture ===
237 237  
207 +(((
238 238  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.
209 +)))
239 239  
211 +(((
240 240  For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is
213 +)))
241 241  
215 +(((
216 +
217 +)))
242 242  
219 +(((
243 243  (% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.**
221 +)))
244 244  
245 245  
246 246  
247 247  === 2.3.5 Soil Temperature ===
248 248  
227 +(((
249 249   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
229 +)))
250 250  
231 +(((
251 251  **Example**:
233 +)))
252 252  
235 +(((
253 253  If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
237 +)))
254 254  
239 +(((
255 255  If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
241 +)))
256 256  
257 257  
258 258  
... ... @@ -302,12 +302,15 @@
302 302  
303 303  [[image:1654505570700-128.png]]
304 304  
291 +(((
305 305  The payload decoder function for TTN is here:
293 +)))
306 306  
307 -LSE01 TTN Payload Decoder: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/Payload_Decoder/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/Payload_Decoder/]]
295 +(((
296 +LSE01 TTN Payload Decoder: [[https:~~/~~/www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0>>https://www.dropbox.com/sh/si8icbrjlamxqdb/AAACYwjsxxr5fj_vpqRtrETAa?dl=0]]
297 +)))
308 308  
309 309  
310 -
311 311  == 2.4 Uplink Interval ==
312 312  
313 313  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"]]
... ... @@ -321,24 +321,44 @@
321 321  [[image:image-20220606165544-8.png]]
322 322  
323 323  
324 -**Examples:**
313 +(((
314 +(% style="color:blue" %)**Examples:**
315 +)))
325 325  
317 +(((
318 +
319 +)))
326 326  
327 -* **Set TDC**
321 +* (((
322 +(% style="color:blue" %)**Set TDC**
323 +)))
328 328  
325 +(((
329 329  If the payload=0100003C, it means set the END Node’s TDC to 0x00003C=60(S), while type code is 01.
327 +)))
330 330  
329 +(((
331 331  Payload:    01 00 00 1E    TDC=30S
331 +)))
332 332  
333 +(((
333 333  Payload:    01 00 00 3C    TDC=60S
335 +)))
334 334  
337 +(((
338 +
339 +)))
335 335  
336 -* **Reset**
341 +* (((
342 +(% style="color:blue" %)**Reset**
343 +)))
337 337  
345 +(((
338 338  If payload = 0x04FF, it will reset the LSE01
347 +)))
339 339  
340 340  
341 -* **CFM**
350 +* (% style="color:blue" %)**CFM**
342 342  
343 343  Downlink Payload: 05000001, Set AT+CFM=1 or 05000000 , set AT+CFM=0
344 344  
... ... @@ -346,12 +346,21 @@
346 346  
347 347  == 2.6 ​Show Data in DataCake IoT Server ==
348 348  
358 +(((
349 349  [[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:
360 +)))
350 350  
362 +(((
363 +
364 +)))
351 351  
352 -**Step 1**: Be sure that your device is programmed and properly connected to the network at this time.
366 +(((
367 +(% style="color:blue" %)**Step 1**(%%):  Be sure that your device is programmed and properly connected to the network at this time.
368 +)))
353 353  
354 -**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:
370 +(((
371 +(% 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:
372 +)))
355 355  
356 356  
357 357  [[image:1654505857935-743.png]]
... ... @@ -359,11 +359,12 @@
359 359  
360 360  [[image:1654505874829-548.png]]
361 361  
362 -Step 3: Create an account or log in Datacake.
363 363  
364 -Step 4: Search the LSE01 and add DevEUI.
381 +(% style="color:blue" %)**Step 3**(%%)**:**  Create an account or log in Datacake.
365 365  
383 +(% style="color:blue" %)**Step 4**(%%)**:**  Search the LSE01 and add DevEUI.
366 366  
385 +
367 367  [[image:1654505905236-553.png]]
368 368  
369 369  
... ... @@ -673,6 +673,7 @@
673 673  )))
674 674  
675 675  
695 +
676 676  [[image:1654506665940-119.png]]
677 677  
678 678  (((
... ... @@ -734,16 +734,16 @@
734 734  )))
735 735  
736 736  * (((
737 -[[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/&file=LSN50-Battery-Dimension.pdf]],
757 +[[Battery Dimension>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]],
738 738  )))
739 739  * (((
740 -[[Lithium-Thionyl Chloride Battery  datasheet>>url:https://www.dragino.com/downloads/downloads/datasheet/Battery/ER26500/ER26500_Datasheet-EN.pdf]],
760 +[[Lithium-Thionyl Chloride Battery  datasheet>>https://www.dragino.com/downloads/index.php?dir=datasheet/Battery/]],
741 741  )))
742 742  * (((
743 -[[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC_1520_datasheet.jpg]], [[Tech Spec>>url:http://www.dragino.com/downloads/downloads/datasheet/Battery/SPC1520%20Technical%20Specification20171123.pdf]]
763 +[[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/]]
744 744  )))
745 745  
746 - [[image:image-20220606171726-9.png]]
766 + [[image:image-20220610172436-1.png]]
747 747  
748 748  
749 749  
... ... @@ -794,7 +794,7 @@
794 794   [[image:1654502050864-459.png||height="564" width="806"]]
795 795  
796 796  
797 -Below are the available commands, a more detailed AT Command manual can be found at [[AT Command Manual>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/]]: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LSE01/]]
817 +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]]: [[https:~~/~~/www.dropbox.com/sh/qr6vproz4z4kzjz/AAAD48h3OyWrU1hq_Cqm8jIwa?dl=0>>https://www.dropbox.com/sh/qr6vproz4z4kzjz/AAAD48h3OyWrU1hq_Cqm8jIwa?dl=0]]
798 798  
799 799  
800 800  (% style="background-color:#dcdcdc" %)**AT+<CMD>=?AT+<CMD>? **(%%) : Help on <CMD>
... ... @@ -952,19 +952,14 @@
952 952  
953 953  (((
954 954  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:
955 -)))
956 956  
957 -(% class="box infomessage" %)
958 -(((
959 -**AT+CHE=2**
976 +* (% style="color:#037691" %)**AT+CHE=2**
977 +* (% style="color:#037691" %)**ATZ**
960 960  )))
961 961  
962 -(% class="box infomessage" %)
963 963  (((
964 -**ATZ**
965 -)))
981 +
966 966  
967 -(((
968 968  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.
969 969  )))
970 970  
... ... @@ -979,18 +979,22 @@
979 979  [[image:image-20220606154825-4.png]]
980 980  
981 981  
997 +== 4.2 ​Can I calibrate LSE01 to different soil types? ==
982 982  
999 +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]].
1000 +
1001 +
983 983  = 5. Trouble Shooting =
984 984  
985 -== 5.1 ​Why I cant join TTN in US915 / AU915 bands? ==
1004 +== 5.1 ​Why I can't join TTN in US915 / AU915 bands? ==
986 986  
987 -It is due to channel mapping. Please see the [[Eight Channel Mode>>doc:Main.LoRaWAN Communication Debug.WebHome||anchor="H2.NoticeofUS9152FCN4702FAU915Frequencyband"]] section above for details.
1006 +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.
988 988  
989 989  
990 -== 5.2 AT Command input doesnt work ==
1009 +== 5.2 AT Command input doesn't work ==
991 991  
992 992  (((
993 -In the case if user can see the console output but cant type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesnt send (% style="color:green" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
1012 +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.
994 994  )))
995 995  
996 996  
... ... @@ -1072,7 +1072,6 @@
1072 1072  * (((
1073 1073  Weight / pcs : g
1074 1074  
1075 -
1076 1076  
1077 1077  )))
1078 1078  
... ... @@ -1080,8 +1080,3 @@
1080 1080  
1081 1081  * 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.
1082 1082  * 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]]
1083 -
1084 -
1085 -)))
1086 -)))
1087 -)))
1657245163077-232.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +81.0 KB
Content
1657246476176-652.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +492.6 KB
Content
image-20220610172436-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +370.3 KB
Content
image-20220708101224-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +22.2 KB
Content