Last modified by Bei Jinggeng on 2024/03/30 17:42
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20220606151504-2.jpeg||height="554" width="554"]]
3
4
5
6
7
8
9
10
11
12
13
14 **Table of Contents:**
15
16 {{toc/}}
17
18
19
20
21
22
23
24 = 1.  Introduction =
25
26 == 1.1 ​ What is NSE01 Soil Moisture & EC Sensor ==
27
28 (((
29
30
31 (((
32 The Dragino NSE01 is a (% style="color:blue" %)**NB-IOT soil moisture & EC sensor**(%%) designed for IoT of Agriculture. It detects Soil Moisture, Soil Temperature and Soil Conductivity, and upload the value via wireless to IoT Server via NB-IoT Network.
33 \\NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage.
34 \\NSE01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP **(%%)** **for different application requirement.
35 \\NES01 is powered by  (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
36 \\To use NSE01, user needs to check if there is NB-IoT coverage in local area and with the bands NSE01 supports. If the local operate support it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card**(%%) from local operator and install NSE01 to get NB-IoT network connection.
37 )))
38
39 (((
40
41 )))
42 )))
43
44 [[image:1654503236291-817.png]]
45
46
47 [[image:1657245163077-232.png]]
48
49
50 == 1.2 ​ Features ==
51
52
53 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
54 * Monitor Soil Moisture
55 * Monitor Soil Temperature
56 * Monitor Soil Conductivity
57 * AT Commands to change parameters
58 * Uplink on periodically
59 * Downlink to change configure
60 * IP66 Waterproof Enclosure
61 * Ultra-Low Power consumption
62 * Micro SIM card slot for NB-IoT SIM
63 * 8500mAh Battery for long term use
64
65 == 1.3  Specification ==
66
67
68 (% style="color:#037691" %)**Common DC Characteristics:**
69
70 * Supply Voltage: 2.1v ~~ 3.6v
71 * Operating Temperature: -40 ~~ 85°C
72
73 (% style="color:#037691" %)**NB-IoT Spec:**
74
75 * B1 @H-FDD: 2100MHz
76 * B3 @H-FDD: 1800MHz
77 * B8 @H-FDD: 900MHz
78 * B5 @H-FDD: 850MHz
79 * B20 @H-FDD: 800MHz
80 * B28 @H-FDD: 700MHz
81
82 (% style="color:#037691" %)**Probe Specification:**
83
84 Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height.
85
86 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
87 |(% style="background-color:#4f81bd; color:white; width:94px" %)**Parameter**|(% style="background-color:#4f81bd; color:white; width:145px" %)**Soil Moisture**|(% style="background-color:#4f81bd; color:white; width:135px" %)**Soil Conductivity**|(% style="background-color:#4f81bd; color:white; width:135px" %)**Soil Temperature**
88 |(% style="width:95px" %)Range|(% style="width:146px" %)0-100.00%|(% style="width:137px" %)(((
89 0-20000uS/cm
90 (25℃)(0-20.0EC)
91 )))|(% style="width:140px" %)-40.00℃～85.00℃
92 |(% style="width:95px" %)Unit|(% style="width:146px" %)V/V %|(% style="width:137px" %)uS/cm|(% style="width:140px" %)℃
93 |(% style="width:95px" %)Resolution|(% style="width:146px" %)0.01%|(% style="width:137px" %)1 uS/cm|(% style="width:140px" %)0.01℃
94 |(% style="width:95px" %)Accuracy|(% style="width:146px" %)(((
95 ±3% (0-53%)
96 ±5% (>53%)
97 )))|(% style="width:137px" %)2% FS|(% style="width:140px" %)(((
98 -10℃～50℃:<0.3℃
99 All other: <0.6℃
100 )))
101 |(% style="width:95px" %)(((
102 Measure
103 Method
104 )))|(% style="width:146px" %)FDR , with temperature &EC compensate|(% style="width:137px" %)Conductivity , with temperature compensate|(% style="width:140px" %)RTD, and calibrate
105
106 == 1.4  Dimension ==
107
108
109 Main Device Dimension:
110
111 See LSN50v2 from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/Mechanical_Drawing/ >>https://www.dragino.com/downloads/index.php?dir=LSN50-LoRaST/Mechanical_Drawing/]]
112
113 [[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-20221008140228-2.png?rev=1.1||alt="image-20221008140228-2.png"]]
114
115
116 **Probe Dimension**
117
118
119 [[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"]]
120
121
122 == ​1.5  Applications ==
123
124
125 * Smart Agriculture
126
127 (% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %)
128 ​
129
130
131 == 1.6  Pin Definitions ==
132
133
134 [[image:1657246476176-652.png]]
135
136
137 = 2.  Use NSE01 to communicate with IoT Server =
138
139 == 2.1  How it works ==
140
141
142 (((
143 The NSE01 is equipped with a NB-IoT module, the pre-loaded firmware in NSE01 will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module.  The NB-IoT network will forward this value to IoT server via the protocol defined by NSE01.
144 )))
145
146
147 (((
148 The diagram below shows the working flow in default firmware of NSE01:
149 )))
150
151 [[image:image-20220708101605-2.png]]
152
153 (((
154
155 )))
156
157 == 2.2 ​ Configure the NSE01 ==
158
159 === 2.2.1 Test Requirement ===
160
161
162 (((
163 To use NSE01 in your city, make sure meet below requirements:
164 )))
165
166 * Your local operator has already distributed a NB-IoT Network there.
167 * The local NB-IoT network used the band that NSE01 supports.
168 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
169
170 (((
171 Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NSE01 will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server
172 )))
173
174
175 [[image:1657249419225-449.png]]
176
177
178 === 2.2.2 Insert SIM card ===
179
180
181 (((
182 Insert the NB-IoT Card get from your provider.
183 )))
184
185 (((
186 User need to take out the NB-IoT module and insert the SIM card like below:
187 )))
188
189
190 [[image:1657249468462-536.png]]
191
192
193 === 2.2.3 Connect USB – TTL to NSE01 to configure it ===
194
195
196 (((
197 (((
198 User need to configure NSE01 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NSE01 support AT Commands, user can use a USB to TTL adapter to connect to NSE01 and use AT Commands to configure it, as below.
199 )))
200 )))
201
202
203 **Connection:**
204
205 (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND
206
207 (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD
208
209 (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD
210
211
212 In the PC, use below serial tool settings:
213
214 * Baud:  (% style="color:green" %)**9600**
215 * Data bits:** (% style="color:green" %)8(%%)**
216 * Stop bits: (% style="color:green" %)**1**
217 * Parity:  (% style="color:green" %)**None**
218 * Flow Control: (% style="color:green" %)**None**
219
220 (((
221 Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSE01. NSE01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
222 )))
223
224 [[image:image-20220708110657-3.png]]
225
226
227 (((
228 (% style="color:red" %)**Note: the valid AT Commands can be found at:  **(%%)**[[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]**
229 )))
230
231
232 === 2.2.4 Use CoAP protocol to uplink data ===
233
234
235 (% style="color:red" %)**Note: if you don't have CoAP server, you can refer this link to set up one: **(%%)**[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/>>http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]**
236
237
238 **Use below commands:**
239
240 * (% style="color:blue" %)**AT+PRO=1**  (%%) ~/~/ Set to use CoAP protocol to uplink
241 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%)~/~/ to set CoAP server address and port
242 * (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path
243
244 For parameter description, please refer to AT command set
245
246 [[image:1657249793983-486.png]]
247
248
249
250 After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NSE01 will start to uplink sensor values to CoAP server.
251
252 [[image:1657249831934-534.png]]
253
254
255 === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
256
257
258 This feature is supported since firmware version v1.0.1
259
260
261 * (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
262 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/ to set UDP server address and port
263 * (% style="color:blue" %)**AT+CFM=1     **(%%)~/~/If the server does not respond, this command is unnecessary
264
265 [[image:1657249864775-321.png]]
266
267
268 [[image:1657249930215-289.png]]
269
270
271 === 2.2.6 Use MQTT protocol to uplink data ===
272
273
274 This feature is supported since firmware version v110
275
276
277 * (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
278 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
279 * (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
280 * (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/Set the username of MQTT
281 * (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/Set the password of MQTT
282 * (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/Set the sending topic of MQTT
283 * (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          **(%%) ~/~/Set the subscription topic of MQTT
284
285 [[image:1657249978444-674.png]]
286
287
288 [[image:1657249990869-686.png]]
289
290
291 (((
292 MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
293 )))
294
295
296 === 2.2.7 Use TCP protocol to uplink data ===
297
298
299 This feature is supported since firmware version v110
300
301
302 * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
303 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/ to set TCP server address and port
304
305 [[image:1657250217799-140.png]]
306
307
308 [[image:1657250255956-604.png]]
309
310
311 === 2.2.8 Change Update Interval ===
312
313
314 User can use below command to change the (% style="color:green" %)**uplink interval**.
315
316 * (% style="color:blue" %)**AT+TDC=600      ** (%%)~/~/ Set Update Interval to 600s
317
318 (((
319
320
321 (((
322 (% style="color:red" %)**NOTE  : **
323 )))
324
325 (((
326 (% style="color:red" %)**1.  By default, the device will send an uplink message every 1 hour.**
327 )))
328 )))
329
330 (((
331 (% style="color:red" %)**2.  When the firmware version is v1.3.2 and later firmware:**
332 )))
333
334 (((
335 (% style="color:red" %)**By default, the device will send an uplink message every 2 hours. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).**
336 )))
337
338
339 == 2.3  Uplink Payload ==
340
341 === 2.3.1  Before Firmware version v1.3.2 ===
342
343
344 In this mode, uplink payload includes in total 18 bytes
345
346 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
347 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
348 **Size(bytes)**
349 )))|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**6**|=(% style="width: 25px;background-color:#4F81BD;color:white" %)2|=(% style="width: 25px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**1**
350 |(% style="width:97px" %)Value|(% style="width:83px" %)[[Device ID>>||anchor="H2.4.1A0A0DeviceID"]]|(% style="width:41px" %)[[Ver>>||anchor="H2.4.2A0VersionInfo"]]|(% style="width:46px" %)[[BAT>>||anchor="H2.4.3A0BatteryInfo"]]|(% style="width:123px" %)[[Signal Strength>>||anchor="H2.4.4A0SignalStrength"]]|(% style="width:108px" %)[[Soil Moisture>>||anchor="H2.4.5A0SoilMoisture"]]|(% style="width:133px" %)[[Soil Temperature>>||anchor="H2.4.6A0SoilTemperature"]]|(% style="width:159px" %)[[Soil Conductivity(EC)>>||anchor="H2.4.7A0SoilConductivity28EC29"]]|(% style="width:80px" %)[[Interrupt>>||anchor="H2.4.9A0DigitalInterrupt"]]
351
352 (((
353 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data.
354 )))
355
356
357 [[image:image-20220708111918-4.png]]
358
359
360 The payload is **ASCII** string, representative same HEX:
361
362 0x72403155615900640c7817075e0a8c02f900 where:
363
364 * (% style="color:#037691" %)**Device ID: **(%%)0x 724031556159 = 724031556159
365
366 * (% style="color:#037691" %)**Version:**  (%%) 0x0064=100=1.0.0
367
368 * (% style="color:#037691" %)**BAT:  ** (%%) 0x0c78 = 3192 mV = 3.192V
369
370 * (% style="color:#037691" %)**Singal:**(%%)  0x17 = 23
371
372 * (% style="color:#037691" %)**Soil Moisture:** (%%) 0x075e= 1886 = 18.86  %
373
374 * (% style="color:#037691" %)**Soil Temperature:**(%%)  0x0a8c =2700=27 °C
375
376 * (% style="color:#037691" %)**Soil Conductivity(EC)：**(%%) 0x02f9 =761 uS /cm
377
378 * (% style="color:#037691" %)**Interrupt: **(%%) 0x00 = 0
379
380 === 2.3.2  Since Firmware version v1.3.2 ===
381
382
383 In this mode, uplink payload includes 123 bytes in total by default.
384
385 Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded.
386
387 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:500px" %)
388 |(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**8**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:60px" %)**1**|(% style="background-color:#4f81bd; color:white; width:30px" %)**1**|(% style="background-color:#4f81bd; color:white; width:40px" %)**1**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:90px" %)**2**|(% style="background-color:#4f81bd; color:white; width:90px" %)**2**
389 |(% style="width:96px" %)Value|(% style="width:84px" %)Device ID|(% style="width:40px" %)Ver|(% style="width:44px" %)BAT|(% style="width:121px" %)Signal Strength|(% style="width:52px" %)MOD|(% style="width:84px" %) Interrupt|(% style="width:116px" %)Soil Moisture|(% style="width:57px" %)Soil Temperature|(% style="width:91px" %)Soil Conductivity(EC)
390
391 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:500px" %)
392 |(% style="background-color:#4f81bd; color:white; width:100px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**4**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**2**|(% style="background-color:#4f81bd; color:white; width:80px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**4**
393 |(% style="width:176px" %)Soil dielectric constant|(% style="width:98px" %)Time stamp|(% style="width:115px" %)Soil Temperature|(% style="width:92px" %)Soil Moisture|(% style="width:80px" %)Soil Conductivity(EC)|(% style="width:97px" %)Soil dielectric constant|(% style="width:100px" %)Time stamp .......
394
395 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data.
396
397 [[image:image-20220908115326-1.png]]
398
399
400 The payload is ASCII string, representative same HEX:
401
402 **0x (% style="color:red" %)__f867787050213317__  (% style="color:blue" %)__0084 __ (% style="color:green" %)__0cfd__  (% style="color:#00b0f0" %)__1b__  (% style="color:#7030a0" %)__01__  (% style="color:#d60093" %)__00__  (% style="color:#a14d07" %)__0000 __ (% style="color:#0020b0" %) __0ae8__  (% style="color:#420042" %)__0000__  (% style="color:#663300" %)__000a__ (% style="color:#660066" %) __6315537b__  (% style="color:#aaaa40" %)__0110034306f7004663185f19__(%%) __010f034306f7004663185b95__ __0105034606eb00476315c779__ __0102034a0000000a6315c3f5__ __010303410000000a6315c071__ __01040346000000006315bced__ __01040346000000006315b969__ __01040341000000006315b5e5__**
403
404
405 **where:**
406
407 * (% style="color:#037691" %)**Device ID:**(%%)** **f867787050213317 = f867787050213317
408
409 * (% style="color:#037691" %)**Version:**(%%) 0x0084=132=1.3.2
410
411 * (% style="color:#037691" %)**BAT:**       (%%)0x0c78 = 3325 mV = 3.325V
412
413 * (% style="color:#037691" %)** Singal:**(%%)  0x1b = 27
414
415 * (% style="color:#037691" %)**Mod:**(%%)  0x01 = 1
416
417 * (% style="color:#037691" %)**Interrupt:**(%%)  0x00= 0
418
419 * (% style="color:#037691" %)**Soil Moisture:**(%%)**   **0x0000= 0 = 0
420
421 * (% style="color:#037691" %)**Soil Temperature:   **(%%)0x0ae8 =2795=27.95 °C
422
423 * (% style="color:#037691" %)**Soil Conductivity(EC):  **(%%)0000=0
424
425 * (% style="color:#037691" %)**Soil dielectric constant:  **(%%)000a=1
426
427 * (% style="color:#037691" %)**Time stamp :**  (%%)0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
428
429 * (% style="color:#037691" %)**Soil Temperature,Soil Moisture,Soil Conductivity(EC),Soil dielectric constant,Time stamp :**(%%) 0110034306f7004663185f19
430
431 * (% style="color:#037691" %)**8 sets of recorded data:  **(%%)Soil Temperature,Soil Moisture,Soil Conductivity(EC),Soil dielectric constant,Time stamp : //**010f034306f7004663185b95**//,.......
432
433 == 2.4  Payload Explanation and Sensor Interface ==
434
435 === 2.4.1  Device ID ===
436
437
438 (((
439 By default, the Device ID equal to the last 6 bytes of IMEI.
440 )))
441
442 (((
443 User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
444
445
446 )))
447
448 (((
449 (% style="color:blue" %)**Example:**
450 )))
451
452 (((
453 AT+DEUI= A84041F15612
454 )))
455
456 (((
457 The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR** won't erase Device ID.
458 )))
459
460
461 (% style="color:red" %)**NOTE: When the firmware version is v1.3.2 and later firmware:**
462
463
464 By default, the Device ID equal to the last 15 bits of IMEI.
465
466 User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
467
468
469 (% style="color:blue" %)**Example:**
470
471 AT+DEUI= 868411056754138
472
473
474 === 2.4.2  Version Info ===
475
476
477 (((
478 Specify the software version: 0x64=100, means firmware version 1.00.
479 )))
480
481 (((
482 For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0.
483 )))
484
485
486 === 2.4.3  Battery Info ===
487
488
489 (((
490 Check the battery voltage for LSE01.
491 )))
492
493 (((
494 Ex1: 0x0B45 = 2885mV
495 )))
496
497 (((
498 Ex2: 0x0B49 = 2889mV
499 )))
500
501
502 === 2.4.4  Signal Strength ===
503
504
505 (((
506 NB-IoT Network signal Strength.
507 )))
508
509 (((
510 **Ex1: 0x1d = 29**
511 )))
512
513 (((
514 (% style="color:blue" %)**0**(%%)  -113dBm or less
515 )))
516
517 (((
518 (% style="color:blue" %)**1**(%%)  -111dBm
519 )))
520
521 (((
522 (% style="color:blue" %)**2...30**(%%) -109dBm... -53dBm
523 )))
524
525 (((
526 (% style="color:blue" %)**31**  (%%) -51dBm or greater
527 )))
528
529 (((
530 (% style="color:blue" %)**99**   (%%) Not known or not detectable
531 )))
532
533
534 === 2.4.5  Soil Moisture ===
535
536
537 (((
538 (((
539 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.
540 )))
541 )))
542
543 (((
544 (((
545 For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is
546 )))
547 )))
548
549 (((
550
551 )))
552
553 (((
554 (% style="color:blue" %)**05DC(H) = 1500(D) /100 = 15%.**
555 )))
556
557
558 === 2.4.6  Soil Temperature ===
559
560
561 (((
562 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
563 )))
564
565 (((
566 **Example**:
567 )))
568
569 (((
570 If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
571 )))
572
573 (((
574 If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
575 )))
576
577
578 === 2.4.7  Soil Conductivity (EC) ===
579
580
581 (((
582 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).
583 )))
584
585 (((
586 For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.
587 )))
588
589 (((
590 Generally, the EC value of irrigation water is less than 800uS / cm.
591 )))
592
593 (((
594
595
596 === 2.4.8  Soil dielectric constant ===
597
598
599 (((
600 Get the soil dielectric constant in the soil. The value range of the register is 10 - 800(Decimal)
601 )))
602
603 (((
604 For example, if the data you get from the register is __**0x00 0xD2**__, the soil conductivity is 00D2(H) = 210(D) = 21.
605 )))
606
607 (((
608 Generally, the EC value of irrigation water is less than 21.
609 )))
610 )))
611
612 (((
613
614 )))
615
616 === 2.4.9  Digital Interrupt ===
617
618
619 (((
620 Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NSE01 will send a packet to the server.
621 )))
622
623 (((
624 The command is:
625 )))
626
627 (((
628 (% style="color:blue" %)**AT+INTMOD=3 **(%%) ~/~/(more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.**
629 )))
630
631 (((
632 The lower four bits of this data field shows if this packet is generated by interrupt or not. Click here for the hardware and software set up.
633 )))
634
635
636 (((
637 **Example:**
638 )))
639
640 (((
641 0x(00): Normal uplink packet.
642 )))
643
644 (((
645 0x(01): Interrupt Uplink Packet.
646 )))
647
648
649 === 2.4.10  ​+5V Output ===
650
651
652 (((
653 NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 
654 )))
655
656 (((
657 The 5V output time can be controlled by AT Command.
658 )))
659
660 (((
661 (% style="color:blue" %)**AT+5VT=1000**
662 )))
663
664 (((
665 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
666 )))
667
668
669 == 2.5  Downlink Payload ==
670
671
672 By default, NSE01 prints the downlink payload to console port.
673
674 (% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
675 |=(% style="width: 183px; background-color:#4F81BD;color:white" %)**Downlink Control Type**|=(% style="width: 55px; background-color:#4F81BD;color:white" %)FPort|=(% style="width: 93px; background-color:#4F81BD;color:white" %)**Type Code**|=(% style="width: 179px; background-color:#4F81BD;color:white" %)**Downlink payload size(bytes)**
676 |(% style="width:183px" %)TDC (Transmit Time Interval)|(% style="width:55px" %)Any|(% style="width:93px" %)01|(% style="width:146px" %)4
677 |(% style="width:183px" %)RESET|(% style="width:55px" %)Any|(% style="width:93px" %)04|(% style="width:146px" %)2
678 |(% style="width:183px" %)INTMOD|(% style="width:55px" %)Any|(% style="width:93px" %)06|(% style="width:146px" %)4
679
680 (((
681 (% style="color:blue" %)**Examples:**
682 )))
683
684 (((
685
686 )))
687
688 * (((
689 (% style="color:blue" %)**Set TDC**
690 )))
691
692 (((
693 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
694 )))
695
696 (((
697 Payload:    01 00 00 1E    TDC=30S
698 )))
699
700 (((
701 Payload:    01 00 00 3C    TDC=60S
702 )))
703
704 (((
705
706 )))
707
708 * (((
709 (% style="color:blue" %)**Reset**
710 )))
711
712 (((
713 If payload = 0x04FF, it will reset the NSE01
714 )))
715
716
717 * (% style="color:blue" %)**INTMOD**
718
719 (((
720 Downlink Payload: 06000003, Set AT+INTMOD=3
721 )))
722
723
724 == 2.6  ​LED Indicator ==
725
726
727 (((
728 The NSE01 has an internal LED which is to show the status of different state.
729
730
731 * When power on, NSE01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe)
732 * Then the LED will be on for 1 second means device is boot normally.
733 * After NSE01 join NB-IoT network. The LED will be ON for 3 seconds.
734 * For each uplink probe, LED will be on for 500ms.
735 )))
736
737
738
739 == 2.7  Installation in Soil ==
740
741
742 __**Measurement the soil surface**__
743
744 (((
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. [[https:~~/~~/img.alicdn.com/imgextra/i3/2005165265/O1CN010rj9Oh1olPsQxrdUK_!!2005165265.jpg>>url:https://img.alicdn.com/imgextra/i3/2005165265/O1CN010rj9Oh1olPsQxrdUK_!!2005165265.jpg]]
746
747
748 )))
749
750 [[image:1657259653666-883.png]] ​
751
752
753 (((
754
755
756 (((
757 **Dig a hole with diameter > 20CM.**
758 )))
759
760 (((
761 Horizontal insert the probe to the soil and fill the hole for long term measurement.
762 )))
763 )))
764
765 [[image:1654506665940-119.png]]
766
767
768 == 2.8  Moisture and Temperature alarm function (Since Firmware 1.3.2) ==
769
770
771 (% style="color:blue" %)** ➢ AT Command:**
772
773 (% style="color:#037691" %)** AT+ HUMALARM=min,max**
774
775 ² When min=0, and max≠0, Alarm higher than max
776
777 ² When min≠0, and max=0, Alarm lower than min
778
779 ² When min≠0 and max≠0, Alarm higher than max or lower than min
780
781
782
783 (% style="color:blue" %)** Example:**
784
785 AT+ HUMALARM =50,80 ~/~/ Alarm when moisture lower than 50.
786
787
788 (% style="color:#037691" %)** AT+ TEMPALARM=min,max**
789
790 ² When min=0, and max≠0, Alarm higher than max
791
792 ² When min≠0, and max=0, Alarm lower than min
793
794 ² When min≠0 and max≠0, Alarm higher than max or lower than min
795
796
797 (% style="color:blue" %)** Example:**
798
799 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
800
801
802 == 2.9 Set the number of data to be uploaded and the recording time ==
803
804
805 (% style="color:blue" %)** ➢ AT Command:**
806
807 * (% style="color:#037691" %)**AT+TR=900** ** **(%%)** **~/~/ The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds)
808 * (% style="color:#037691" %)**AT+NOUD=8   **(%%)** **~/~/  The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
809
810 The diagram below explains the relationship between TR, NOUD, and TDC more clearly**:**
811
812 [[image:image-20221009000513-1.png||height="732" width="1018"]]
813
814
815 == 2.10  Read or Clear cached data ==
816
817
818 (% style="color:blue" %)** ➢ AT Command:**
819
820 * (% style="color:#037691" %)** AT+CDP**   (%%) ~/~/ Read cached data
821 * (% style="color:#037691" %)** AT+CDP=0** (%%) ~/~/ Clear cached data
822
823 [[image:image-20220908144940-2.png]]
824
825
826 == 2.11  ​Firmware Change Log ==
827
828
829 Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]
830
831 Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
832
833
834 == 2.12 Battery & Power Consumption ==
835
836
837 NSE01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
838
839 [[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
840
841
842 = 3. ​ Access NB-IoT Module =
843
844
845 (((
846 Users can directly access the AT command set of the NB-IoT module.
847 )))
848
849 (((
850 The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]] 
851
852
853 )))
854
855 [[image:1657261278785-153.png]]
856
857
858 = 4.  Using the AT Commands =
859
860 == 4.1  Access AT Commands ==
861
862
863 See this link for detail:  [[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
864
865
866 AT+<CMD>?  : Help on <CMD>
867
868 AT+<CMD>         : Run <CMD>
869
870 AT+<CMD>=<value> : Set the value
871
872 AT+<CMD>=?  : Get the value
873
874
875 (% style="color:#037691" %)**General Commands**(%%)      
876
877 AT  : Attention       
878
879 AT?  : Short Help     
880
881 ATZ  : MCU Reset    
882
883 AT+TDC  : Application Data Transmission Interval
884
885 AT+CFG  : Print all configurations
886
887 AT+CFGMOD           : Working mode selection
888
889 AT+INTMOD            : Set the trigger interrupt mode
890
891 AT+5VT  : Set extend the time of 5V power  
892
893 AT+PRO  : Choose agreement
894
895 AT+RXDL  : Extend the sending and receiving time
896
897 AT+SERVADDR  : Server Address
898
899 AT+TR      : Get or Set record time"
900
901 AT+APN     : Get or set the APN
902
903 AT+FBAND   : Get or Set whether to automatically modify the frequency band
904
905 AT+DNSCFG  : Get or Set DNS Server
906
907 AT+GETSENSORVALUE   : Returns the current sensor measurement
908
909 AT+NOUD      : Get or Set the number of data to be uploaded
910
911 AT+CDP     : Read or Clear cached data
912
913 AT+TEMPALARM      : Get or Set alarm of temp
914
915 AT+HUMALARM     : Get or Set alarm of moisture
916
917 (% style="color:#037691" %)**COAP Management**      
918
919 AT+URI            : Resource parameters
920
921
922 (% style="color:#037691" %)**UDP Management**
923
924 AT+CFM          : Upload confirmation mode (only valid for UDP)
925
926
927 (% style="color:#037691" %)**MQTT Management**
928
929 AT+CLIENT               : Get or Set MQTT client
930
931 AT+UNAME  : Get or Set MQTT Username
932
933 AT+PWD                  : Get or Set MQTT password
934
935 AT+PUBTOPIC  : Get or Set MQTT publish topic
936
937 AT+SUBTOPIC  : Get or Set MQTT subscription topic
938
939
940 (% style="color:#037691" %)**Information**          
941
942 AT+FDR  : Factory Data Reset
943
944 AT+PWORD  : Serial Access Password
945
946
947 = ​5.  FAQ =
948
949 == 5.1 ​ How to Upgrade Firmware ==
950
951
952 (((
953 User can upgrade the firmware for 1) bug fix, 2) new feature release.
954 )))
955
956 (((
957 Please see this link for how to upgrade: 
958
959 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]]
960 )))
961
962 (((
963 (% style="color:red" %)**Notice, NSE01 and LSE01 share the same mother board. They use the same connection and method to update.**
964 )))
965
966
967 == 5.2  Can I calibrate NSE01 to different soil types? ==
968
969
970 (((
971 NSE01 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_20220605.pdf]].
972 )))
973
974
975 = 6.  Trouble Shooting =
976
977 == 6.1  ​Connection problem when uploading firmware ==
978
979
980 (((
981 **Please see: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]]
982 )))
983
984
985 == 6.2  AT Command input doesn't work ==
986
987
988 (((
989 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.
990 )))
991
992
993 == 6.3 Not able to connect to NB-IoT network and keep showing "Signal Strength:99". ==
994
995
996 This means sensor is trying to join the NB-IoT network but fail. Please see this link for **//[[trouble shooting for signal strenght:99>>doc:Main.CSQ\:99,99.WebHome]]//**.
997
998
999 == 6.4  Possible reasons why the device is unresponsive：
1000 ​1. Check whether the battery voltage is lower than 2.8V
1001 2. Check whether the jumper of the device is correctly connected ==
1002
1003 [[image:image-20240330174217-1.png]]
1004 3. Check whether the switch here of the device is at the ISP（The switch can operate normally only when it is in RUN）
1005 ​[[image:image-20240330174223-2.png]]
1006
1007 = 7. ​ Order Info =
1008
1009
1010 Part Number**:** (% style="color:#4f81bd" %)**NSE01**
1011
1012
1013 = 8.  Packing Info =
1014
1015 (((
1016
1017
1018 (% style="color:#037691" %)**Package Includes**:
1019
1020 * NSE01 NB-IoT Soil Moisture & EC Sensor x 1
1021 * External antenna x 1
1022 )))
1023
1024 (((
1025
1026
1027 (% style="color:#037691" %)**Dimension and weight**:
1028
1029 * Size: 195 x 125 x 55 mm
1030 * Weight:   420g
1031 )))
1032
1033 (((
1034
1035
1036
1037 )))
1038
1039 = 9.  Support =
1040
1041
1042 * 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.
1043
1044 * 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]]
1045
1046

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0