Version 82.1 by Edwin Chen on 2022/10/09 00:05
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
27 == 1.1 ​ What is NSE01 Soil Moisture & EC Sensor ==
28
29 (((
30
31
32 (((
33 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.
34 \\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.
35 \\NSE01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP **(%%)** **for different application requirement.
36 \\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)
37 \\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.
38 )))
39
40 (((
41
42 )))
43
44
45 )))
46
47 [[image:1654503236291-817.png]]
48
49
50 [[image:1657245163077-232.png]]
51
52
53
54 == 1.2 ​ Features ==
55
56
57 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
58 * Monitor Soil Moisture
59 * Monitor Soil Temperature
60 * Monitor Soil Conductivity
61 * AT Commands to change parameters
62 * Uplink on periodically
63 * Downlink to change configure
64 * IP66 Waterproof Enclosure
65 * Ultra-Low Power consumption
66 * Micro SIM card slot for NB-IoT SIM
67 * 8500mAh Battery for long term use
68
69
70 == 1.3  Specification ==
71
72
73 (% style="color:#037691" %)**Common DC Characteristics:**
74
75 * Supply Voltage: 2.1v ~~ 3.6v
76 * Operating Temperature: -40 ~~ 85°C
77
78 (% style="color:#037691" %)**NB-IoT Spec:**
79
80 * - B1 @H-FDD: 2100MHz
81 * - B3 @H-FDD: 1800MHz
82 * - B8 @H-FDD: 900MHz
83 * - B5 @H-FDD: 850MHz
84 * - B20 @H-FDD: 800MHz
85 * - B28 @H-FDD: 700MHz
86
87 (% style="color:#037691" %)**Probe Specification:**
88
89 Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height.
90
91 [[image:image-20220708101224-1.png]]
92
93
94
95 == 1.4  Dimension ==
96
97 Main Device Dimension:
98
99 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/]]
100
101 [[image:image-20221008140228-2.png||height="358" width="571"]]
102
103 Probe Dimension
104
105 [[image:image-20221008135912-1.png]]
106
107
108 == ​1.5  Applications ==
109
110
111 * Smart Agriculture
112
113 (% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %)
114 ​
115
116
117
118 == 1.6  Pin Definitions ==
119
120
121 [[image:1657246476176-652.png]]
122
123
124
125 = 2.  Use NSE01 to communicate with IoT Server =
126
127
128 == 2.1  How it works ==
129
130
131 (((
132 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.
133 )))
134
135
136 (((
137 The diagram below shows the working flow in default firmware of NSE01:
138 )))
139
140 [[image:image-20220708101605-2.png]]
141
142 (((
143
144 )))
145
146
147
148 == 2.2 ​ Configure the NSE01 ==
149
150
151 === 2.2.1 Test Requirement ===
152
153
154 (((
155 To use NSE01 in your city, make sure meet below requirements:
156 )))
157
158 * Your local operator has already distributed a NB-IoT Network there.
159 * The local NB-IoT network used the band that NSE01 supports.
160 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
161
162 (((
163 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
164 )))
165
166
167 [[image:1657249419225-449.png]]
168
169
170
171 === 2.2.2 Insert SIM card ===
172
173
174 (((
175 Insert the NB-IoT Card get from your provider.
176 )))
177
178 (((
179 User need to take out the NB-IoT module and insert the SIM card like below:
180 )))
181
182
183 [[image:1657249468462-536.png]]
184
185
186
187 === 2.2.3 Connect USB – TTL to NSE01 to configure it ===
188
189
190 (((
191 (((
192 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.
193 )))
194 )))
195
196
197 **Connection:**
198
199 (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND
200
201 (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD
202
203 (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD
204
205
206 In the PC, use below serial tool settings:
207
208 * Baud:  (% style="color:green" %)**9600**
209 * Data bits:** (% style="color:green" %)8(%%)**
210 * Stop bits: (% style="color:green" %)**1**
211 * Parity:  (% style="color:green" %)**None**
212 * Flow Control: (% style="color:green" %)**None**
213
214 (((
215 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.
216 )))
217
218 [[image:image-20220708110657-3.png]]
219
220
221 (((
222 (% 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]]**
223 )))
224
225
226
227 === 2.2.4 Use CoAP protocol to uplink data ===
228
229
230 (% 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/]]**
231
232
233 **Use below commands:**
234
235 * (% style="color:blue" %)**AT+PRO=1**  (%%) ~/~/ Set to use CoAP protocol to uplink
236 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%)~/~/ to set CoAP server address and port
237 * (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path
238
239 For parameter description, please refer to AT command set
240
241 [[image:1657249793983-486.png]]
242
243
244
245 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.
246
247 [[image:1657249831934-534.png]]
248
249
250
251 === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
252
253
254 This feature is supported since firmware version v1.0.1
255
256
257 * (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
258 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/ to set UDP server address and port
259 * (% style="color:blue" %)**AT+CFM=1     **(%%)~/~/If the server does not respond, this command is unnecessary
260
261 [[image:1657249864775-321.png]]
262
263
264 [[image:1657249930215-289.png]]
265
266
267
268 === 2.2.6 Use MQTT protocol to uplink data ===
269
270
271 This feature is supported since firmware version v110
272
273
274 * (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
275 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
276 * (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
277 * (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/Set the username of MQTT
278 * (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/Set the password of MQTT
279 * (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/Set the sending topic of MQTT
280 * (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          **(%%) ~/~/Set the subscription topic of MQTT
281
282 [[image:1657249978444-674.png]]
283
284
285 [[image:1657249990869-686.png]]
286
287
288 (((
289 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.
290 )))
291
292
293
294 === 2.2.7 Use TCP protocol to uplink data ===
295
296
297 This feature is supported since firmware version v110
298
299
300 * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
301 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/ to set TCP server address and port
302
303 [[image:1657250217799-140.png]]
304
305
306 [[image:1657250255956-604.png]]
307
308
309
310 === 2.2.8 Change Update Interval ===
311
312
313 User can use below command to change the (% style="color:green" %)**uplink interval**.
314
315 * (% style="color:blue" %)**AT+TDC=600      ** (%%)~/~/ Set Update Interval to 600s
316
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
340 == 2.3  Uplink Payload ==
341
342
343 === **2.3.1 Before Firmware version v1.3.2** ===
344
345
346 In this mode, uplink payload includes in total 18 bytes
347
348 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
349 |=(% style="width: 60px;" %)(((
350 **Size(bytes)**
351 )))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 70px;" %)**1**|=(% style="width: 60px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 90px;" %)**2**|=(% style="width: 50px;" %)**1**
352 |(% 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"]]
353
354 (((
355 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data.
356 )))
357
358
359 [[image:image-20220708111918-4.png]]
360
361
362 The payload is **ASCII** string, representative same HEX:
363
364 0x72403155615900640c7817075e0a8c02f900 where:
365
366 * Device ID: 0x 724031556159 = 724031556159
367 * Version:  0x0064=100=1.0.0
368
369 * BAT:  0x0c78 = 3192 mV = 3.192V
370 * Singal: 0x17 = 23
371 * Soil Moisture:  0x075e= 1886 = 18.86  %
372 * Soil Temperature:  0x0a8c =2700=27 °C
373 * Soil Conductivity(EC) = 0x02f9 =761 uS /cm
374 * Interrupt:  0x00 = 0
375
376 === **2.3.2 Since Firmware version v1.3.2** ===
377
378
379 In this mode, uplink payload includes 123 bytes in total by default.
380
381 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.
382
383 (% border="1" style="background-color:#ffffcc; color:green; width:1229.2px" %)
384 |**Size(bytes)**|(% style="width:62px" %)**8**|(% style="width:40px" %)**2**|(% style="width:45px" %)**2**|(% style="width:77px" %)**1**|(% style="width:55px" %)**1**|(% style="width:80px" %)**1**|(% style="width:64px" %)**2**|(% style="width:103px" %)**2**|(% style="width:76px" %)**2**|(% style="width:99px" %)**2**|(% style="width:49px" %)**4**|(% style="width:85px" %)**2**|(% style="width:54px" %)**2**|(% style="width:68px" %)**2**|(% style="width:136px" %)**2**|(% style="width:100px" %)**4**
385 |**Value**|(% style="width:62px" %)Device ID|(% style="width:40px" %)Ver|(% style="width:45px" %)BAT|(% style="width:77px" %)Signal Strength|(% style="width:55px" %)MOD|(% style="width:80px" %)Interrupt|(% style="width:64px" %)Soil Moisture|(% style="width:103px" %)Soil Temperature|(% style="width:76px" %)Soil Conductivity(EC)|(% style="width:99px" %)(((
386 Soil dielectric constant
387 )))|(% style="width:49px" %)Time stamp |(% style="width:85px" %)Soil Temperature|(% style="width:54px" %)Soil Moisture|(% style="width:68px" %)Soil Conductivity(EC)|(% style="width:136px" %)Soil dielectric constant|(% style="width:144.203px" %)Time stamp .......
388
389 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data.
390
391 [[image:image-20220908115326-1.png]]
392
393
394 The payload is ASCII string, representative same HEX:
395
396 0x(% style="color:red" %)f867787050213317(% style="color:blue" %)0084(% style="color:green" %)0cfd(% style="color:red" %)1b(% style="color:blue" %)01(% style="color:green" %)00(% style="color:red" %)**//00000ae80000000a00000000//**0110034306f7004663185f19//**010f034306f7004663185b95**//0105034606eb00476315c779//**0102034a0000000a6315c3f**//5010303410000000a6315c071//**01040346000000006315bced**//01040346000000006315b969//**01040341000000006315b5e5**//(%%) where:
397
398 * (% style="color:red" %)Device ID: f867787050213317 = f867787050213317
399 * (% style="color:blue" %)Version: 0x0084=132=1.3.2
400 * (% style="color:green" %) BAT: 0x0c78 = 3325 mV = 3.325V
401 * (% style="color:red" %) Singal: 0x1b = 27
402 * (% style="color:blue" %)Mod: 0x01 = 1
403 * (% style="color:green" %)Interrupt: 0x00= 0
404 * Soil Moisture: 0x0000= 0 = 0
405 * Soil Temperature:0x0ae8 =2795=27.95 °C
406 * Soil Conductivity(EC) =0000=0
407 * Soil dielectric constant=000a=1
408 * Time stamp : 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
409 * (% style="color:red" %)Soil Temperature,Soil Moisture,Soil Conductivity(EC),Soil dielectric constant,Time stamp : 0110034306f7004663185f19
410 * (% style="color:red" %)8 sets of recorded data: Soil Temperature,Soil Moisture,Soil Conductivity(EC),Soil dielectric constant,Time stamp : //**010f034306f7004663185b95**//(%%),.......
411
412 == 2.4  Payload Explanation and Sensor Interface ==
413
414
415 === 2.4.1  Device ID ===
416
417
418 (((
419 By default, the Device ID equal to the last 6 bytes of IMEI.
420 )))
421
422 (((
423 User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
424
425
426 )))
427
428 (((
429 (% style="color:blue" %)**Example:**
430 )))
431
432 (((
433 AT+DEUI= A84041F15612
434 )))
435
436 (((
437 The Device ID is stored in a none-erase area, Upgrade the firmware or run **AT+FDR** won't erase Device ID.
438 )))
439
440
441 (% style="color:red" %)**NOTE: When the firmware version is v1.3.2 and later firmware:**
442
443
444 By default, the Device ID equal to the last 15 bits of IMEI.
445
446 User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
447
448
449 (% style="color:blue" %)**Example:**
450
451 AT+DEUI= 868411056754138
452
453
454
455 === 2.4.2  Version Info ===
456
457
458 (((
459 Specify the software version: 0x64=100, means firmware version 1.00.
460 )))
461
462 (((
463 For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0.
464 )))
465
466
467
468 === 2.4.3  Battery Info ===
469
470
471 (((
472 Check the battery voltage for LSE01.
473 )))
474
475 (((
476 Ex1: 0x0B45 = 2885mV
477 )))
478
479 (((
480 Ex2: 0x0B49 = 2889mV
481 )))
482
483
484
485 === 2.4.4  Signal Strength ===
486
487
488 (((
489 NB-IoT Network signal Strength.
490 )))
491
492 (((
493 **Ex1: 0x1d = 29**
494 )))
495
496 (((
497 (% style="color:blue" %)**0**(%%)  -113dBm or less
498 )))
499
500 (((
501 (% style="color:blue" %)**1**(%%)  -111dBm
502 )))
503
504 (((
505 (% style="color:blue" %)**2...30**(%%) -109dBm... -53dBm
506 )))
507
508 (((
509 (% style="color:blue" %)**31**  (%%) -51dBm or greater
510 )))
511
512 (((
513 (% style="color:blue" %)**99**   (%%) Not known or not detectable
514 )))
515
516
517
518 === 2.4.5  Soil Moisture ===
519
520
521 (((
522 (((
523 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.
524 )))
525 )))
526
527 (((
528 (((
529 For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is
530 )))
531 )))
532
533 (((
534
535 )))
536
537 (((
538 (% style="color:blue" %)**05DC(H) = 1500(D) /100 = 15%.**
539 )))
540
541
542
543 === 2.4.6  Soil Temperature ===
544
545
546 (((
547 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
548 )))
549
550 (((
551 **Example**:
552 )))
553
554 (((
555 If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
556 )))
557
558 (((
559 If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
560 )))
561
562
563
564 === 2.4.7  Soil Conductivity (EC) ===
565
566
567 (((
568 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).
569 )))
570
571 (((
572 For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.
573 )))
574
575 (((
576 Generally, the EC value of irrigation water is less than 800uS / cm.
577 )))
578
579 (((
580
581
582 === 2.4.8  Soil dielectric constant ===
583
584
585 (((
586 Get the soil dielectric constant in the soil. The value range of the register is 10 - 800(Decimal)
587 )))
588
589 (((
590 For example, if the data you get from the register is __**0x00 0xD2**__, the soil conductivity is 00D2(H) = 210(D) = 21.
591 )))
592
593 (((
594 Generally, the EC value of irrigation water is less than 21.
595 )))
596 )))
597
598 (((
599
600 )))
601
602 === 2.4.9  Digital Interrupt ===
603
604
605 (((
606 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.
607 )))
608
609 (((
610 The command is:
611 )))
612
613 (((
614 (% 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]])**.**
615 )))
616
617
618 (((
619 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.
620 )))
621
622
623 (((
624 Example:
625 )))
626
627 (((
628 0x(00): Normal uplink packet.
629 )))
630
631 (((
632 0x(01): Interrupt Uplink Packet.
633 )))
634
635
636
637 === 2.4.10  ​+5V Output ===
638
639
640 (((
641 NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 
642 )))
643
644 (((
645 The 5V output time can be controlled by AT Command.
646
647
648 )))
649
650 (((
651 (% style="color:blue" %)**AT+5VT=1000**
652
653
654 )))
655
656 (((
657 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
658 )))
659
660
661
662 == 2.5  Downlink Payload ==
663
664
665 By default, NSE01 prints the downlink payload to console port.
666
667 [[image:image-20220708133731-5.png]]
668
669
670 (((
671 (% style="color:blue" %)**Examples:**
672 )))
673
674 (((
675
676 )))
677
678 * (((
679 (% style="color:blue" %)**Set TDC**
680 )))
681
682 (((
683 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
684 )))
685
686 (((
687 Payload:    01 00 00 1E    TDC=30S
688 )))
689
690 (((
691 Payload:    01 00 00 3C    TDC=60S
692 )))
693
694 (((
695
696 )))
697
698 * (((
699 (% style="color:blue" %)**Reset**
700 )))
701
702 (((
703 If payload = 0x04FF, it will reset the NSE01
704 )))
705
706
707 * (% style="color:blue" %)**INTMOD**
708
709 (((
710 Downlink Payload: 06000003, Set AT+INTMOD=3
711 )))
712
713
714
715 == 2.6  ​LED Indicator ==
716
717
718 (((
719 The NSE01 has an internal LED which is to show the status of different state.
720
721
722 * 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)
723 * Then the LED will be on for 1 second means device is boot normally.
724 * After NSE01 join NB-IoT network. The LED will be ON for 3 seconds.
725 * For each uplink probe, LED will be on for 500ms.
726 )))
727
728
729
730
731 == 2.7  Installation in Soil ==
732
733
734 __**Measurement the soil surface**__
735
736 (((
737 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]]
738
739
740 )))
741
742 [[image:1657259653666-883.png]] ​
743
744
745 (((
746
747
748 (((
749 Dig a hole with diameter > 20CM.
750 )))
751
752 (((
753 Horizontal insert the probe to the soil and fill the hole for long term measurement.
754 )))
755 )))
756
757 [[image:1654506665940-119.png]]
758
759 (((
760
761 )))
762
763 == 2.8  Moisture and Temperature alarm function (Since Firmware 1.3.2) ==
764
765
766 (% style="color:blue" %)** ➢ AT Command:**
767
768 (% style="color:#037691" %)** AT+ HUMALARM=min,max**
769
770 ² When min=0, and max≠0, Alarm higher than max
771
772 ² When min≠0, and max=0, Alarm lower than min
773
774 ² When min≠0 and max≠0, Alarm higher than max or lower than min
775
776
777
778 (% style="color:blue" %)** Example:**
779
780 AT+ HUMALARM =50,80 ~/~/ Alarm when moisture lower than 50.
781
782
783 (% style="color:#037691" %)** AT+ TEMPALARM=min,max**
784
785 ² When min=0, and max≠0, Alarm higher than max
786
787 ² When min≠0, and max=0, Alarm lower than min
788
789 ² When min≠0 and max≠0, Alarm higher than max or lower than min
790
791
792 (% style="color:blue" %)** Example:**
793
794 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
795
796
797
798 == 2.9 Set the number of data to be uploaded and the recording time ==
799
800
801 (% style="color:blue" %)** ➢ AT Command:**
802
803 * (% 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)
804 * (% 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.
805
806 This link explains the relationship between TR, NOUD and TDC more clearly **: **[[https:~~/~~/www.processon.com/view/link/6340e606e401fd390891af87>>url:https://www.processon.com/view/link/6340e606e401fd390891af87]]
807
808 == 2.10  Read or Clear cached data ==
809
810
811 (% style="color:blue" %)** ➢ AT Command:**
812
813 * (% style="color:#037691" %)** AT+CDP**   (%%) ~/~/ Read cached data
814 * (% style="color:#037691" %)** AT+CDP=0** (%%) ~/~/ Clear cached data
815
816 [[image:image-20220908144940-2.png]]
817
818
819
820 == 2.11  ​Firmware Change Log ==
821
822
823 Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]
824
825
826 Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
827
828
829
830 == 2.12  ​Battery Analysis ==
831
832
833 === 2.12.1  ​Battery Type ===
834
835
836 (((
837 The NSE01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.
838 )))
839
840
841 (((
842 The battery is designed to last for several years depends on the actually use environment and update interval. 
843 )))
844
845
846 (((
847 The battery related documents as below:
848 )))
849
850 * [[Battery Dimension>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
851 * [[Lithium-Thionyl Chloride Battery datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
852 * [[Lithium-ion Battery-Capacitor datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
853
854 (((
855 [[image:image-20220708140453-6.png]]
856 )))
857
858
859
860 === 2.12.2  Power consumption Analyze ===
861
862
863 (((
864 Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
865 )))
866
867
868 (((
869 Instruction to use as below:
870 )))
871
872 (((
873 (% style="color:blue" %)**Step 1:  **(%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
874 )))
875
876
877 (((
878 (% style="color:blue" %)**Step 2: **(%%) Open it and choose
879 )))
880
881 * (((
882 Product Model
883 )))
884 * (((
885 Uplink Interval
886 )))
887 * (((
888 Working Mode
889 )))
890
891 (((
892 And the Life expectation in difference case will be shown on the right.
893 )))
894
895 [[image:image-20220708141352-7.jpeg]]
896
897
898
899 === 2.12.3  ​Battery Note ===
900
901
902 (((
903 The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
904 )))
905
906
907
908 === 2.12.4  Replace the battery ===
909
910
911 (((
912 The default battery pack of NSE01 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).
913 )))
914
915
916
917 = 3. ​ Access NB-IoT Module =
918
919
920 (((
921 Users can directly access the AT command set of the NB-IoT module.
922 )))
923
924 (((
925 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/]] 
926
927
928 )))
929
930 [[image:1657261278785-153.png]]
931
932
933
934 = 4.  Using the AT Commands =
935
936
937 == 4.1  Access AT Commands ==
938
939
940 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]]
941
942
943 AT+<CMD>?  : Help on <CMD>
944
945 AT+<CMD>         : Run <CMD>
946
947 AT+<CMD>=<value> : Set the value
948
949 AT+<CMD>=?  : Get the value
950
951
952 (% style="color:#037691" %)**General Commands**(%%)      
953
954 AT  : Attention       
955
956 AT?  : Short Help     
957
958 ATZ  : MCU Reset    
959
960 AT+TDC  : Application Data Transmission Interval
961
962 AT+CFG  : Print all configurations
963
964 AT+CFGMOD           : Working mode selection
965
966 AT+INTMOD            : Set the trigger interrupt mode
967
968 AT+5VT  : Set extend the time of 5V power  
969
970 AT+PRO  : Choose agreement
971
972 AT+RXDL  : Extend the sending and receiving time
973
974 AT+SERVADDR  : Server Address
975
976 AT+TR      : Get or Set record time"
977
978 AT+APN     : Get or set the APN
979
980 AT+FBAND   : Get or Set whether to automatically modify the frequency band
981
982 AT+DNSCFG  : Get or Set DNS Server
983
984 AT+GETSENSORVALUE   : Returns the current sensor measurement
985
986 AT+NOUD      : Get or Set the number of data to be uploaded
987
988 AT+CDP     : Read or Clear cached data
989
990 AT+TEMPALARM      : Get or Set alarm of temp
991
992 AT+HUMALARM     : Get or Set alarm of moisture
993
994 (% style="color:#037691" %)**COAP Management**      
995
996 AT+URI            : Resource parameters
997
998
999 (% style="color:#037691" %)**UDP Management**
1000
1001 AT+CFM          : Upload confirmation mode (only valid for UDP)
1002
1003
1004 (% style="color:#037691" %)**MQTT Management**
1005
1006 AT+CLIENT               : Get or Set MQTT client
1007
1008 AT+UNAME  : Get or Set MQTT Username
1009
1010 AT+PWD                  : Get or Set MQTT password
1011
1012 AT+PUBTOPIC  : Get or Set MQTT publish topic
1013
1014 AT+SUBTOPIC  : Get or Set MQTT subscription topic
1015
1016
1017 (% style="color:#037691" %)**Information**          
1018
1019 AT+FDR  : Factory Data Reset
1020
1021 AT+PWORD  : Serial Access Password
1022
1023
1024
1025 = ​5.  FAQ =
1026
1027
1028 == 5.1 ​ How to Upgrade Firmware ==
1029
1030
1031 (((
1032 User can upgrade the firmware for 1) bug fix, 2) new feature release.
1033 )))
1034
1035 (((
1036 Please see this link for how to upgrade:  [[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]]
1037 )))
1038
1039 (((
1040 (% style="color:red" %)**Notice, NSE01 and LSE01 share the same mother board. They use the same connection and method to update.**
1041 )))
1042
1043
1044
1045 == 5.2  Can I calibrate NSE01 to different soil types? ==
1046
1047
1048 (((
1049 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]].
1050 )))
1051
1052
1053
1054 = 6.  Trouble Shooting =
1055
1056
1057 == 6.1  ​Connection problem when uploading firmware ==
1058
1059
1060 (((
1061 **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]]
1062 )))
1063
1064 (% class="wikigeneratedid" %)
1065 (((
1066
1067 )))
1068
1069
1070 == 6.2  AT Command input doesn't work ==
1071
1072
1073 (((
1074 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.
1075
1076
1077 )))
1078
1079
1080 = 7. ​ Order Info =
1081
1082
1083 Part Number**:** (% style="color:#4f81bd" %)**NSE01**
1084
1085
1086 (% class="wikigeneratedid" %)
1087 (((
1088
1089 )))
1090
1091 = 8.  Packing Info =
1092
1093 (((
1094
1095
1096 (% style="color:#037691" %)**Package Includes**:
1097
1098 * NSE01 NB-IoT Soil Moisture & EC Sensor x 1
1099 * External antenna x 1
1100 )))
1101
1102 (((
1103
1104
1105 (% style="color:#037691" %)**Dimension and weight**:
1106
1107 * Size: 195 x 125 x 55 mm
1108 * Weight:   420g
1109 )))
1110
1111 (((
1112
1113
1114
1115
1116 )))
1117
1118 = 9.  Support =
1119
1120
1121 * 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.
1122 * 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]]
1123
1124

Applications

Navigation

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