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

From version 31.38
edited by Xiaoling
on 2022/06/07 10:35
Change comment: There is no comment for this version
To version 42.2
edited by Xiaoling
on 2022/07/08 09:52
Change comment: There is no comment for this version

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,7 +58,6 @@
58 58  * IP66 Waterproof Enclosure
59 59  * 4000mAh or 8500mAh Battery for long term use
60 60  
61 -
62 62  == 1.3 Specification ==
63 63  
64 64  Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height.
... ... @@ -106,7 +106,7 @@
106 106  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.
107 107  
108 108  
109 -**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.
110 110  
111 111  Each LSE01 is shipped with a sticker with the default device EUI as below:
112 112  
... ... @@ -127,7 +127,7 @@
127 127  
128 128  
129 129  
130 -**Step 2**: Power on LSE01
128 +(% style="color:blue" %)**Step 2**(%%): Power on LSE01
131 131  
132 132  
133 133  Put a Jumper on JP2 to power on the device. ( The Jumper must be in FLASH position).
... ... @@ -135,7 +135,7 @@
135 135  [[image:image-20220606163915-7.png]]
136 136  
137 137  
138 -**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.
139 139  
140 140  [[image:1654504778294-788.png]]
141 141  
... ... @@ -143,88 +143,104 @@
143 143  
144 144  == 2.3 Uplink Payload ==
145 145  
144 +
146 146  === 2.3.1 MOD~=0(Default Mode) ===
147 147  
148 148  LSE01 will uplink payload via LoRaWAN with below payload format: 
149 149  
150 -
149 +(((
151 151  Uplink payload includes in total 11 bytes.
152 -
151 +)))
153 153  
154 -(% border="1" cellspacing="10" style="background-color:#f7faff; width:510px" %)
155 -|=(((
153 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
154 +|(((
156 156  **Size**
157 157  
158 158  **(bytes)**
159 -)))|=(% style="width: 46px;" %)**2**|=(% style="width: 160px;" %)**2**|=(% style="width: 104px;" %)**2**|=(% style="width: 126px;" %)**2**|=(% style="width: 159px;" %)**2**|=(% style="width: 114px;" %)**1**
160 -|**Value**|(% style="width:46px" %)[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(% style="width:160px" %)(((
158 +)))|**2**|**2**|**2**|**2**|**2**|**1**
159 +|**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(((
161 161  Temperature
162 162  
163 163  (Reserve, Ignore now)
164 -)))|(% style="width:104px" %)[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|(% style="width:126px" %)[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|(% style="width:159px" %)[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|(% style="width:114px" %)(((
163 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]]|(((
165 165  MOD & Digital Interrupt
166 166  
167 167  (Optional)
168 168  )))
169 169  
170 -[[image:1654504881641-514.png]]
171 -
172 -
173 -
174 174  === 2.3.2 MOD~=1(Original value) ===
175 175  
176 176  This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation).
177 177  
178 -(% border="1" cellspacing="10" style="background-color:#f7faff; width:510px" %)
179 -|=(((
173 +(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
174 +|(((
180 180  **Size**
181 181  
182 182  **(bytes)**
183 -)))|=**2**|=**2**|=**2**|=**2**|=**2**|=**1**
178 +)))|**2**|**2**|**2**|**2**|**2**|**1**
184 184  |**Value**|[[BAT>>||anchor="H2.3.3BatteryInfo"]]|(((
185 185  Temperature
186 186  
187 187  (Reserve, Ignore now)
188 -)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]]|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|(((
183 +)))|[[Soil Moisture>>||anchor="H2.3.4SoilMoisture"]](raw)|[[Soil Temperature>>||anchor="H2.3.5SoilTemperature"]]|[[Soil Conductivity (EC)>>||anchor="H2.3.6SoilConductivity28EC29"]](raw)|(((
189 189  MOD & Digital Interrupt
190 190  
191 191  (Optional)
192 192  )))
193 193  
194 -[[image:1654504907647-967.png]]
195 -
196 -
197 -
198 198  === 2.3.3 Battery Info ===
199 199  
191 +(((
200 200  Check the battery voltage for LSE01.
193 +)))
201 201  
195 +(((
202 202  Ex1: 0x0B45 = 2885mV
197 +)))
203 203  
199 +(((
204 204  Ex2: 0x0B49 = 2889mV
201 +)))
205 205  
206 206  
207 207  
208 208  === 2.3.4 Soil Moisture ===
209 209  
207 +(((
210 210  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 +)))
211 211  
211 +(((
212 212  For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is
213 +)))
213 213  
215 +(((
216 +
217 +)))
214 214  
219 +(((
215 215  (% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.**
221 +)))
216 216  
217 217  
218 218  
219 219  === 2.3.5 Soil Temperature ===
220 220  
227 +(((
221 221   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 +)))
222 222  
231 +(((
223 223  **Example**:
233 +)))
224 224  
235 +(((
225 225  If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
237 +)))
226 226  
239 +(((
227 227  If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
241 +)))
228 228  
229 229  
230 230  
... ... @@ -274,12 +274,15 @@
274 274  
275 275  [[image:1654505570700-128.png]]
276 276  
291 +(((
277 277  The payload decoder function for TTN is here:
293 +)))
278 278  
279 -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 +)))
280 280  
281 281  
282 -
283 283  == 2.4 Uplink Interval ==
284 284  
285 285  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"]]
... ... @@ -293,24 +293,44 @@
293 293  [[image:image-20220606165544-8.png]]
294 294  
295 295  
296 -**Examples:**
313 +(((
314 +(% style="color:blue" %)**Examples:**
315 +)))
297 297  
317 +(((
318 +
319 +)))
298 298  
299 -* **Set TDC**
321 +* (((
322 +(% style="color:blue" %)**Set TDC**
323 +)))
300 300  
325 +(((
301 301  If the payload=0100003C, it means set the END Node’s TDC to 0x00003C=60(S), while type code is 01.
327 +)))
302 302  
329 +(((
303 303  Payload:    01 00 00 1E    TDC=30S
331 +)))
304 304  
333 +(((
305 305  Payload:    01 00 00 3C    TDC=60S
335 +)))
306 306  
337 +(((
338 +
339 +)))
307 307  
308 -* **Reset**
341 +* (((
342 +(% style="color:blue" %)**Reset**
343 +)))
309 309  
345 +(((
310 310  If payload = 0x04FF, it will reset the LSE01
347 +)))
311 311  
312 312  
313 -* **CFM**
350 +* (% style="color:blue" %)**CFM**
314 314  
315 315  Downlink Payload: 05000001, Set AT+CFM=1 or 05000000 , set AT+CFM=0
316 316  
... ... @@ -318,12 +318,21 @@
318 318  
319 319  == 2.6 ​Show Data in DataCake IoT Server ==
320 320  
358 +(((
321 321  [[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 +)))
322 322  
362 +(((
363 +
364 +)))
323 323  
324 -**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 +)))
325 325  
326 -**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 +)))
327 327  
328 328  
329 329  [[image:1654505857935-743.png]]
... ... @@ -331,11 +331,12 @@
331 331  
332 332  [[image:1654505874829-548.png]]
333 333  
334 -Step 3: Create an account or log in Datacake.
335 335  
336 -Step 4: Search the LSE01 and add DevEUI.
381 +(% style="color:blue" %)**Step 3**(%%)**:**  Create an account or log in Datacake.
337 337  
383 +(% style="color:blue" %)**Step 4**(%%)**:**  Search the LSE01 and add DevEUI.
338 338  
385 +
339 339  [[image:1654505905236-553.png]]
340 340  
341 341  
... ... @@ -631,8 +631,6 @@
631 631  * Solid ON for 5 seconds once device successful Join the network.
632 632  * Blink once when device transmit a packet.
633 633  
634 -
635 -
636 636  == 2.9 Installation in Soil ==
637 637  
638 638  **Measurement the soil surface**
... ... @@ -647,6 +647,7 @@
647 647  )))
648 648  
649 649  
695 +
650 650  [[image:1654506665940-119.png]]
651 651  
652 652  (((
... ... @@ -708,16 +708,16 @@
708 708  )))
709 709  
710 710  * (((
711 -[[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/]],
712 712  )))
713 713  * (((
714 -[[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/]],
715 715  )))
716 716  * (((
717 -[[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/]]
718 718  )))
719 719  
720 - [[image:image-20220606171726-9.png]]
766 + [[image:image-20220610172436-1.png]]
721 721  
722 722  
723 723  
... ... @@ -768,7 +768,7 @@
768 768   [[image:1654502050864-459.png||height="564" width="806"]]
769 769  
770 770  
771 -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]]
772 772  
773 773  
774 774  (% style="background-color:#dcdcdc" %)**AT+<CMD>=?AT+<CMD>? **(%%) : Help on <CMD>
... ... @@ -926,19 +926,14 @@
926 926  
927 927  (((
928 928  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:
929 -)))
930 930  
931 -(% class="box infomessage" %)
932 -(((
933 -**AT+CHE=2**
976 +* (% style="color:#037691" %)**AT+CHE=2**
977 +* (% style="color:#037691" %)**ATZ**
934 934  )))
935 935  
936 -(% class="box infomessage" %)
937 937  (((
938 -**ATZ**
939 -)))
981 +
940 940  
941 -(((
942 942  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.
943 943  )))
944 944  
... ... @@ -953,18 +953,22 @@
953 953  [[image:image-20220606154825-4.png]]
954 954  
955 955  
997 +== 4.2 ​Can I calibrate LSE01 to different soil types? ==
956 956  
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 +
957 957  = 5. Trouble Shooting =
958 958  
959 -== 5.1 ​Why I cant join TTN in US915 / AU915 bands? ==
1004 +== 5.1 ​Why I can't join TTN in US915 / AU915 bands? ==
960 960  
961 -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.
962 962  
963 963  
964 -== 5.2 AT Command input doesnt work ==
1009 +== 5.2 AT Command input doesn't work ==
965 965  
966 966  (((
967 -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.
968 968  )))
969 969  
970 970  
... ... @@ -1019,7 +1019,9 @@
1019 1019  = 7. Packing Info =
1020 1020  
1021 1021  (((
1022 -**Package Includes**:
1067 +
1068 +
1069 +(% style="color:#037691" %)**Package Includes**:
1023 1023  )))
1024 1024  
1025 1025  * (((
... ... @@ -1028,10 +1028,8 @@
1028 1028  
1029 1029  (((
1030 1030  
1031 -)))
1032 1032  
1033 -(((
1034 -**Dimension and weight**:
1079 +(% style="color:#037691" %)**Dimension and weight**:
1035 1035  )))
1036 1036  
1037 1037  * (((
... ... @@ -1046,7 +1046,6 @@
1046 1046  * (((
1047 1047  Weight / pcs : g
1048 1048  
1049 -
1050 1050  
1051 1051  )))
1052 1052  
... ... @@ -1054,5 +1054,3 @@
1054 1054  
1055 1055  * 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.
1056 1056  * 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]]
1057 -
1058 -
1657245163077-232.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +81.0 KB
Content
image-20220610172436-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +370.3 KB
Content