Version 90.2 by Xiaoling on 2022/07/09 09:45

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