Skip to Content
Version 75.4 by Xiaoling on 2022/07/09 09:02
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20220709085040-1.png||height="542" width="524"]]
3
4
5
6
7
8 **Table of Contents:**
9
10
11
12
13
14
15
16 = 1.  Introduction =
17
18 == 1.1 ​ What is NDDS75 Distance Detection Sensor ==
19
20 (((
21
22
23 (((
24 The Dragino NDDS75 is a (% style="color:blue" %)**NB-IoT Distance Detection Sensor**(%%) for Internet of Things solution. It is designed to measure the distance between the sensor and a flat object. The distance detection sensor is a module that uses ultrasonic sensing technology for distance measurement, and temperature compensation is performed internally to improve the reliability of data.
25 \\The NDDS75 can be applied to scenarios such as horizontal distance measurement, liquid level measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, bottom water level monitoring, etc. It detects the distance between the measured object and the sensor, and uploads the value via wireless to IoT Server via NB-IoT Network.
26 \\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.
27 \\NDDS75 supports different uplink methods include (% style="color:blue" %)**TCP, MQTT, UDP and CoAP** (%%)for different application requirement.
28 \\NDDS75 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)
29 \\To use NDDS75, user needs to check if there is NB-IoT coverage in local area and with the bands NDDS75 supports. If the local operate support it, user needs to get a NB-IoT SIM card from local operator and install NDDS75 to get NB-IoT network connection.
30 )))
31
32
33 )))
34
35 [[image:1654503236291-817.png]]
36
37
38 [[image:1657327959271-447.png]]
39
40
41
42 == 1.2 ​ Features ==
43
44
45 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
46 * Ultra low power consumption
47 * Distance Detection by Ultrasonic technology
48 * Flat object range 280mm - 7500mm
49 * Accuracy: ±(1cm+S*0.3%) (S: Distance)
50 * Cable Length: 25cm
51 * AT Commands to change parameters
52 * Uplink on periodically
53 * Downlink to change configure
54 * IP66 Waterproof Enclosure
55 * Micro SIM card slot for NB-IoT SIM
56 * 8500mAh Battery for long term use
57
58
59
60 == 1.3  Specification ==
61
62
63 (% style="color:#037691" %)**Common DC Characteristics:**
64
65 * Supply Voltage: 2.1v ~~ 3.6v
66 * Operating Temperature: -40 ~~ 85°C
67
68 (% style="color:#037691" %)**NB-IoT Spec:**
69
70 * - B1 @H-FDD: 2100MHz
71 * - B3 @H-FDD: 1800MHz
72 * - B8 @H-FDD: 900MHz
73 * - B5 @H-FDD: 850MHz
74 * - B20 @H-FDD: 800MHz
75 * - B28 @H-FDD: 700MHz
76
77
78 (% style="color:#037691" %)**Battery:**
79
80 * Li/SOCI2 un-chargeable battery
81 * Capacity: 8500mAh
82 * Self Discharge: <1% / Year @ 25°C
83 * Max continuously current: 130mA
84 * Max boost current: 2A, 1 second
85
86
87 (% style="color:#037691" %)**Power Consumption**
88
89 * STOP Mode: 10uA @ 3.3v
90 * Max transmit power: 350mA@3.3v
91
92
93
94
95 == ​1.4  Applications ==
96
97 * Smart Buildings & Home Automation
98 * Logistics and Supply Chain Management
99 * Smart Metering
100 * Smart Agriculture
101 * Smart Cities
102 * Smart Factory
103
104 (% class="wikigeneratedid" id="H200B1.5FirmwareChangelog" %)
105 ​
106
107
108
109 == 1.5  Pin Definitions ==
110
111
112 [[image:1657246476176-652.png]]
113
114
115
116 = 2.  Use NSE01 to communicate with IoT Server =
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 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 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 (% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]
210 )))
211
212
213
214 === 2.2.4 Use CoAP protocol to uplink data ===
215
216 (% 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/]]
217
218
219 **Use below commands:**
220
221 * (% style="color:blue" %)**AT+PRO=1**  (%%) ~/~/ Set to use CoAP protocol to uplink
222 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%)~/~/ to set CoAP server address and port
223 * (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path
224
225 For parameter description, please refer to AT command set
226
227 [[image:1657249793983-486.png]]
228
229
230 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.
231
232 [[image:1657249831934-534.png]]
233
234
235
236 === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
237
238 This feature is supported since firmware version v1.0.1
239
240
241 * (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
242 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/ to set UDP server address and port
243 * (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/If the server does not respond, this command is unnecessary
244
245 [[image:1657249864775-321.png]]
246
247
248 [[image:1657249930215-289.png]]
249
250
251
252 === 2.2.6 Use MQTT protocol to uplink data ===
253
254 This feature is supported since firmware version v110
255
256
257 * (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
258 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
259 * (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
260 * (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/Set the username of MQTT
261 * (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/Set the password of MQTT
262 * (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/Set the sending topic of MQTT
263 * (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          **(%%) ~/~/Set the subscription topic of MQTT
264
265 [[image:1657249978444-674.png]]
266
267
268 [[image:1657249990869-686.png]]
269
270
271 (((
272 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.
273 )))
274
275
276
277 === 2.2.7 Use TCP protocol to uplink data ===
278
279 This feature is supported since firmware version v110
280
281
282 * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
283 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/ to set TCP server address and port
284
285 [[image:1657250217799-140.png]]
286
287
288 [[image:1657250255956-604.png]]
289
290
291
292 === 2.2.8 Change Update Interval ===
293
294 User can use below command to change the (% style="color:green" %)**uplink interval**.
295
296 * (% style="color:blue" %)**AT+TDC=600      ** (%%)~/~/ Set Update Interval to 600s
297
298 (((
299 (% style="color:red" %)**NOTE:**
300 )))
301
302 (((
303 (% style="color:red" %)1. By default, the device will send an uplink message every 1 hour.
304 )))
305
306
307
308 == 2.3  Uplink Payload ==
309
310 In this mode, uplink payload includes in total 18 bytes
311
312 (% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
313 |=(% style="width: 60px;" %)(((
314 **Size(bytes)**
315 )))|=(% 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**
316 |(% 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"]]
317
318 (((
319 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data.
320 )))
321
322
323 [[image:image-20220708111918-4.png]]
324
325
326 The payload is ASCII string, representative same HEX:
327
328 0x72403155615900640c7817075e0a8c02f900 where:
329
330 * Device ID: 0x 724031556159 = 724031556159
331 * Version: 0x0064=100=1.0.0
332
333 * BAT: 0x0c78 = 3192 mV = 3.192V
334 * Singal: 0x17 = 23
335 * Soil Moisture: 0x075e= 1886 = 18.86  %
336 * Soil Temperature:0x0a8c =2700=27 °C
337 * Soil Conductivity(EC) = 0x02f9 =761 uS /cm
338 * Interrupt: 0x00 = 0
339
340 == 2.4  Payload Explanation and Sensor Interface ==
341
342
343 === 2.4.1  Device ID ===
344
345 (((
346 By default, the Device ID equal to the last 6 bytes of IMEI.
347 )))
348
349 (((
350 User can use (% style="color:blue" %)**AT+DEUI**(%%) to set Device ID
351 )))
352
353 (((
354 **Example:**
355 )))
356
357 (((
358 AT+DEUI=A84041F15612
359 )))
360
361 (((
362 The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
363 )))
364
365
366
367 === 2.4.2  Version Info ===
368
369 (((
370 Specify the software version: 0x64=100, means firmware version 1.00.
371 )))
372
373 (((
374 For example: 0x00 64 : this device is NSE01 with firmware version 1.0.0.
375 )))
376
377
378
379 === 2.4.3  Battery Info ===
380
381 (((
382 Check the battery voltage for LSE01.
383 )))
384
385 (((
386 Ex1: 0x0B45 = 2885mV
387 )))
388
389 (((
390 Ex2: 0x0B49 = 2889mV
391 )))
392
393
394
395 === 2.4.4  Signal Strength ===
396
397 (((
398 NB-IoT Network signal Strength.
399 )))
400
401 (((
402 **Ex1: 0x1d = 29**
403 )))
404
405 (((
406 (% style="color:blue" %)**0**(%%)  -113dBm or less
407 )))
408
409 (((
410 (% style="color:blue" %)**1**(%%)  -111dBm
411 )))
412
413 (((
414 (% style="color:blue" %)**2...30**(%%) -109dBm... -53dBm
415 )))
416
417 (((
418 (% style="color:blue" %)**31**  (%%) -51dBm or greater
419 )))
420
421 (((
422 (% style="color:blue" %)**99**   (%%) Not known or not detectable
423 )))
424
425
426
427 === 2.4.5  Soil Moisture ===
428
429 (((
430 (((
431 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.
432 )))
433 )))
434
435 (((
436 (((
437 For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the soil is
438 )))
439 )))
440
441 (((
442
443 )))
444
445 (((
446 (% style="color:#4f81bd" %)**05DC(H) = 1500(D) /100 = 15%.**
447 )))
448
449
450
451 === 2.4.6  Soil Temperature ===
452
453 (((
454 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
455 )))
456
457 (((
458 **Example**:
459 )))
460
461 (((
462 If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
463 )))
464
465 (((
466 If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
467 )))
468
469
470
471 === 2.4.7  Soil Conductivity (EC) ===
472
473 (((
474 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).
475 )))
476
477 (((
478 For example, if the data you get from the register is __**0x00 0xC8**__, the soil conductivity is 00C8(H) = 200(D) = 200 uS/cm.
479 )))
480
481 (((
482 Generally, the EC value of irrigation water is less than 800uS / cm.
483 )))
484
485 (((
486
487 )))
488
489 (((
490
491 )))
492
493 === 2.4.8  Digital Interrupt ===
494
495 (((
496 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.
497 )))
498
499 (((
500 The command is:
501 )))
502
503 (((
504 (% 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]])**.**
505 )))
506
507
508 (((
509 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.
510 )))
511
512
513 (((
514 Example:
515 )))
516
517 (((
518 0x(00): Normal uplink packet.
519 )))
520
521 (((
522 0x(01): Interrupt Uplink Packet.
523 )))
524
525
526
527 === 2.4.9  ​+5V Output ===
528
529 (((
530 NSE01 will enable +5V output before all sampling and disable the +5v after all sampling. 
531 )))
532
533
534 (((
535 The 5V output time can be controlled by AT Command.
536 )))
537
538 (((
539 (% style="color:blue" %)**AT+5VT=1000**
540 )))
541
542 (((
543 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.
544 )))
545
546
547
548 == 2.5  Downlink Payload ==
549
550 By default, NSE01 prints the downlink payload to console port.
551
552 [[image:image-20220708133731-5.png]]
553
554
555 (((
556 (% style="color:blue" %)**Examples:**
557 )))
558
559 (((
560
561 )))
562
563 * (((
564 (% style="color:blue" %)**Set TDC**
565 )))
566
567 (((
568 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
569 )))
570
571 (((
572 Payload:    01 00 00 1E    TDC=30S
573 )))
574
575 (((
576 Payload:    01 00 00 3C    TDC=60S
577 )))
578
579 (((
580
581 )))
582
583 * (((
584 (% style="color:blue" %)**Reset**
585 )))
586
587 (((
588 If payload = 0x04FF, it will reset the NSE01
589 )))
590
591
592 * (% style="color:blue" %)**INTMOD**
593
594 (((
595 Downlink Payload: 06000003, Set AT+INTMOD=3
596 )))
597
598
599
600 == 2.6  ​LED Indicator ==
601
602 (((
603 The NSE01 has an internal LED which is to show the status of different state.
604
605
606 * 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)
607 * Then the LED will be on for 1 second means device is boot normally.
608 * After NSE01 join NB-IoT network. The LED will be ON for 3 seconds.
609 * For each uplink probe, LED will be on for 500ms.
610 )))
611
612
613
614
615 == 2.7  Installation in Soil ==
616
617 __**Measurement the soil surface**__
618
619 (((
620 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]]
621 )))
622
623 [[image:1657259653666-883.png]] ​
624
625
626 (((
627
628
629 (((
630 Dig a hole with diameter > 20CM.
631 )))
632
633 (((
634 Horizontal insert the probe to the soil and fill the hole for long term measurement.
635 )))
636 )))
637
638 [[image:1654506665940-119.png]]
639
640 (((
641
642 )))
643
644
645 == 2.8  ​Firmware Change Log ==
646
647
648 Download URL & Firmware Change log
649
650 [[www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/Firmware/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/Firmware/]]
651
652
653 Upgrade Instruction: [[Upgrade_Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
654
655
656
657 == 2.9  ​Battery Analysis ==
658
659 === 2.9.1  ​Battery Type ===
660
661
662 (((
663 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.
664 )))
665
666
667 (((
668 The battery is designed to last for several years depends on the actually use environment and update interval. 
669 )))
670
671
672 (((
673 The battery related documents as below:
674 )))
675
676 * [[Battery Dimension>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
677 * [[Lithium-Thionyl Chloride Battery datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
678 * [[Lithium-ion Battery-Capacitor datasheet>>http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
679
680 (((
681 [[image:image-20220708140453-6.png]]
682 )))
683
684
685
686 === 2.9.2  Power consumption Analyze ===
687
688 (((
689 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.
690 )))
691
692
693 (((
694 Instruction to use as below:
695 )))
696
697 (((
698 (% 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/]]
699 )))
700
701
702 (((
703 (% style="color:blue" %)**Step 2: **(%%) Open it and choose
704 )))
705
706 * (((
707 Product Model
708 )))
709 * (((
710 Uplink Interval
711 )))
712 * (((
713 Working Mode
714 )))
715
716 (((
717 And the Life expectation in difference case will be shown on the right.
718 )))
719
720 [[image:image-20220708141352-7.jpeg]]
721
722
723
724 === 2.9.3  ​Battery Note ===
725
726 (((
727 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.
728 )))
729
730
731
732 === 2.9.4  Replace the battery ===
733
734 (((
735 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).
736 )))
737
738
739
740 = 3. ​ Access NB-IoT Module =
741
742 (((
743 Users can directly access the AT command set of the NB-IoT module.
744 )))
745
746 (((
747 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/]] 
748 )))
749
750 [[image:1657261278785-153.png]]
751
752
753
754 = 4.  Using the AT Commands =
755
756 == 4.1  Access AT Commands ==
757
758 See this link for detail: [[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]
759
760
761 AT+<CMD>?  : Help on <CMD>
762
763 AT+<CMD>         : Run <CMD>
764
765 AT+<CMD>=<value> : Set the value
766
767 AT+<CMD>=?  : Get the value
768
769
770 (% style="color:#037691" %)**General Commands**(%%)      
771
772 AT  : Attention       
773
774 AT?  : Short Help     
775
776 ATZ  : MCU Reset    
777
778 AT+TDC  : Application Data Transmission Interval
779
780 AT+CFG  : Print all configurations
781
782 AT+CFGMOD           : Working mode selection
783
784 AT+INTMOD            : Set the trigger interrupt mode
785
786 AT+5VT  : Set extend the time of 5V power  
787
788 AT+PRO  : Choose agreement
789
790 AT+WEIGRE  : Get weight or set weight to 0
791
792 AT+WEIGAP  : Get or Set the GapValue of weight
793
794 AT+RXDL  : Extend the sending and receiving time
795
796 AT+CNTFAC  : Get or set counting parameters
797
798 AT+SERVADDR  : Server Address
799
800
801 (% style="color:#037691" %)**COAP Management**      
802
803 AT+URI            : Resource parameters
804
805
806 (% style="color:#037691" %)**UDP Management**
807
808 AT+CFM          : Upload confirmation mode (only valid for UDP)
809
810
811 (% style="color:#037691" %)**MQTT Management**
812
813 AT+CLIENT               : Get or Set MQTT client
814
815 AT+UNAME  : Get or Set MQTT Username
816
817 AT+PWD                  : Get or Set MQTT password
818
819 AT+PUBTOPIC  : Get or Set MQTT publish topic
820
821 AT+SUBTOPIC  : Get or Set MQTT subscription topic
822
823
824 (% style="color:#037691" %)**Information**          
825
826 AT+FDR  : Factory Data Reset
827
828 AT+PWORD  : Serial Access Password
829
830
831
832 = ​5.  FAQ =
833
834 == 5.1 ​ How to Upgrade Firmware ==
835
836
837 (((
838 User can upgrade the firmware for 1) bug fix, 2) new feature release.
839 )))
840
841 (((
842 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]]
843 )))
844
845 (((
846 (% style="color:red" %)Notice, NSE01 and LSE01 share the same mother board. They use the same connection and method to update.
847 )))
848
849
850
851 == 5.2  Can I calibrate NSE01 to different soil types? ==
852
853 (((
854 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]].
855 )))
856
857
858 = 6.  Trouble Shooting =
859
860 == 6.1  ​Connection problem when uploading firmware ==
861
862
863 (((
864 **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]]
865 )))
866
867 (% class="wikigeneratedid" %)
868 (((
869
870 )))
871
872
873 == 6.2  AT Command input doesn't work ==
874
875 (((
876 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.
877
878
879 )))
880
881
882 = 7. ​ Order Info =
883
884
885 Part Number**:** (% style="color:#4f81bd" %)**NSE01**
886
887
888 (% class="wikigeneratedid" %)
889 (((
890
891 )))
892
893 = 8.  Packing Info =
894
895 (((
896
897
898 (% style="color:#037691" %)**Package Includes**:
899
900 * NSE01 NB-IoT Soil Moisture & EC Sensor x 1
901 * External antenna x 1
902 )))
903
904 (((
905
906
907 (% style="color:#037691" %)**Dimension and weight**:
908
909 * Size: 195 x 125 x 55 mm
910 * Weight:   420g
911 )))
912
913 (((
914
915
916
917
918 )))
919
920 = 9.  Support =
921
922 * 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.
923 * 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]]