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

Applications

Navigation

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