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