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