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

Applications

Navigation

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