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

Applications

Navigation

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