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

From version 32.5
edited by Xiaoling
on 2022/06/07 11:33
Change comment: There is no comment for this version
To version 43.1
edited by Xiaoling
on 2022/07/08 10:12
Change comment: Uploaded new attachment "image-20220708101224-1.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  
... ... @@ -105,7 +105,7 @@
105 105  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.
106 106  
107 107  
108 -**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.
109 109  
110 110  Each LSE01 is shipped with a sticker with the default device EUI as below:
111 111  
... ... @@ -126,7 +126,7 @@
126 126  
127 127  
128 128  
129 -**Step 2**: Power on LSE01
128 +(% style="color:blue" %)**Step 2**(%%): Power on LSE01
130 130  
131 131  
132 132  Put a Jumper on JP2 to power on the device. ( The Jumper must be in FLASH position).
... ... @@ -134,7 +134,7 @@
134 134  [[image:image-20220606163915-7.png]]
135 135  
136 136  
137 -**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.
138 138  
139 139  [[image:1654504778294-788.png]]
140 140  
... ... @@ -142,14 +142,15 @@
142 142  
143 143  == 2.3 Uplink Payload ==
144 144  
144 +
145 145  === 2.3.1 MOD~=0(Default Mode) ===
146 146  
147 147  LSE01 will uplink payload via LoRaWAN with below payload format: 
148 148  
149 -
149 +(((
150 150  Uplink payload includes in total 11 bytes.
151 +)))
151 151  
152 -
153 153  (% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
154 154  |(((
155 155  **Size**
... ... @@ -166,8 +166,6 @@
166 166  (Optional)
167 167  )))
168 168  
169 -
170 -
171 171  === 2.3.2 MOD~=1(Original value) ===
172 172  
173 173  This mode can get the original AD value of moisture and original conductivity (with temperature drift compensation).
... ... @@ -188,38 +188,59 @@
188 188  (Optional)
189 189  )))
190 190  
191 -
192 -
193 193  === 2.3.3 Battery Info ===
194 194  
191 +(((
195 195  Check the battery voltage for LSE01.
193 +)))
196 196  
195 +(((
197 197  Ex1: 0x0B45 = 2885mV
197 +)))
198 198  
199 +(((
199 199  Ex2: 0x0B49 = 2889mV
201 +)))
200 200  
201 201  
202 202  
203 203  === 2.3.4 Soil Moisture ===
204 204  
207 +(((
205 205  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 +)))
206 206  
211 +(((
207 207  For example, if the data you get from the register is __0x05 0xDC__, the moisture content in the soil is
213 +)))
208 208  
215 +(((
216 +
217 +)))
209 209  
219 +(((
210 210  (% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.**
221 +)))
211 211  
212 212  
213 213  
214 214  === 2.3.5 Soil Temperature ===
215 215  
227 +(((
216 216   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 +)))
217 217  
231 +(((
218 218  **Example**:
233 +)))
219 219  
235 +(((
220 220  If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
237 +)))
221 221  
239 +(((
222 222  If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
241 +)))
223 223  
224 224  
225 225  
... ... @@ -269,12 +269,15 @@
269 269  
270 270  [[image:1654505570700-128.png]]
271 271  
291 +(((
272 272  The payload decoder function for TTN is here:
293 +)))
273 273  
274 -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 +)))
275 275  
276 276  
277 -
278 278  == 2.4 Uplink Interval ==
279 279  
280 280  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"]]
... ... @@ -288,24 +288,44 @@
288 288  [[image:image-20220606165544-8.png]]
289 289  
290 290  
291 -**Examples:**
313 +(((
314 +(% style="color:blue" %)**Examples:**
315 +)))
292 292  
317 +(((
318 +
319 +)))
293 293  
294 -* **Set TDC**
321 +* (((
322 +(% style="color:blue" %)**Set TDC**
323 +)))
295 295  
325 +(((
296 296  If the payload=0100003C, it means set the END Node’s TDC to 0x00003C=60(S), while type code is 01.
327 +)))
297 297  
329 +(((
298 298  Payload:    01 00 00 1E    TDC=30S
331 +)))
299 299  
333 +(((
300 300  Payload:    01 00 00 3C    TDC=60S
335 +)))
301 301  
337 +(((
338 +
339 +)))
302 302  
303 -* **Reset**
341 +* (((
342 +(% style="color:blue" %)**Reset**
343 +)))
304 304  
345 +(((
305 305  If payload = 0x04FF, it will reset the LSE01
347 +)))
306 306  
307 307  
308 -* **CFM**
350 +* (% style="color:blue" %)**CFM**
309 309  
310 310  Downlink Payload: 05000001, Set AT+CFM=1 or 05000000 , set AT+CFM=0
311 311  
... ... @@ -313,12 +313,21 @@
313 313  
314 314  == 2.6 ​Show Data in DataCake IoT Server ==
315 315  
358 +(((
316 316  [[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 +)))
317 317  
362 +(((
363 +
364 +)))
318 318  
319 -**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 +)))
320 320  
321 -**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 +)))
322 322  
323 323  
324 324  [[image:1654505857935-743.png]]
... ... @@ -326,11 +326,12 @@
326 326  
327 327  [[image:1654505874829-548.png]]
328 328  
329 -Step 3: Create an account or log in Datacake.
330 330  
331 -Step 4: Search the LSE01 and add DevEUI.
381 +(% style="color:blue" %)**Step 3**(%%)**:**  Create an account or log in Datacake.
332 332  
383 +(% style="color:blue" %)**Step 4**(%%)**:**  Search the LSE01 and add DevEUI.
333 333  
385 +
334 334  [[image:1654505905236-553.png]]
335 335  
336 336  
... ... @@ -640,6 +640,7 @@
640 640  )))
641 641  
642 642  
695 +
643 643  [[image:1654506665940-119.png]]
644 644  
645 645  (((
... ... @@ -701,16 +701,16 @@
701 701  )))
702 702  
703 703  * (((
704 -[[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/]],
705 705  )))
706 706  * (((
707 -[[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/]],
708 708  )))
709 709  * (((
710 -[[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/]]
711 711  )))
712 712  
713 - [[image:image-20220606171726-9.png]]
766 + [[image:image-20220610172436-1.png]]
714 714  
715 715  
716 716  
... ... @@ -761,7 +761,7 @@
761 761   [[image:1654502050864-459.png||height="564" width="806"]]
762 762  
763 763  
764 -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]]
765 765  
766 766  
767 767  (% style="background-color:#dcdcdc" %)**AT+<CMD>=?AT+<CMD>? **(%%) : Help on <CMD>
... ... @@ -919,19 +919,14 @@
919 919  
920 920  (((
921 921  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:
922 -)))
923 923  
924 -(% class="box infomessage" %)
925 -(((
926 -**AT+CHE=2**
976 +* (% style="color:#037691" %)**AT+CHE=2**
977 +* (% style="color:#037691" %)**ATZ**
927 927  )))
928 928  
929 -(% class="box infomessage" %)
930 930  (((
931 -**ATZ**
932 -)))
981 +
933 933  
934 -(((
935 935  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.
936 936  )))
937 937  
... ... @@ -946,18 +946,22 @@
946 946  [[image:image-20220606154825-4.png]]
947 947  
948 948  
997 +== 4.2 ​Can I calibrate LSE01 to different soil types? ==
949 949  
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 +
950 950  = 5. Trouble Shooting =
951 951  
952 -== 5.1 ​Why I cant join TTN in US915 / AU915 bands? ==
1004 +== 5.1 ​Why I can't join TTN in US915 / AU915 bands? ==
953 953  
954 -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.
955 955  
956 956  
957 -== 5.2 AT Command input doesnt work ==
1009 +== 5.2 AT Command input doesn't work ==
958 958  
959 959  (((
960 -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.
961 961  )))
962 962  
963 963  
... ... @@ -1039,7 +1039,6 @@
1039 1039  * (((
1040 1040  Weight / pcs : g
1041 1041  
1042 -
1043 1043  
1044 1044  )))
1045 1045  
... ... @@ -1047,8 +1047,3 @@
1047 1047  
1048 1048  * 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.
1049 1049  * 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]]
1050 -
1051 -
1052 -~)~)~)
1053 -~)~)~)
1054 -~)~)~)
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
image-20220708101224-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +22.2 KB
Content