Skip to Content
Version 33.4 by Xiaoling on 2022/09/13 09:41
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20220907171221-1.jpeg]]
3
4 ​
5
6 {{toc/}}
7
8
9
10 = 1.  Introduction =
11
12
13 == 1.1 ​ What is NLMS01 Leaf Moisture Sensor ==
14
15
16 The Dragino NLMS01 is a (% style="color:blue" %)**NB-IOT Leaf Moisture Sensor**(%%) for IoT of Agriculture. It is designed to measure the leaf moisture and temperature, so to send to the platform to analyze the leaf status such as : watering, moisturizing, dew, frozen. The probe is IP67 waterproof.
17
18 NLMS01 detects leaf's(% style="color:blue" %)** moisture and temperature use FDR method**(%%), it senses the dielectric constant cause by liquid over the leaf surface, and cover the value to leaf moisture. The probe is design in a leaf shape to best simulate the real leaf characterizes. The probe has as density as 15 leaf vein lines per centimeter which make it can senses small drop and more accuracy.
19
20 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.
21 \\NLMS01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
22 \\NLMS01 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).
23 \\To use NLMS01, user needs to check if there is NB-IoT coverage in local area and with the bands NLMS01 supports. If the local operate support it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card**(%%) from local operator and install NLMS01 to get NB-IoT network connection.
24
25
26 ​[[image:image-20220907171221-2.png]]
27
28
29 ​ [[image:image-20220907171221-3.png]]
30
31
32
33 == ​1.2  Features ==
34
35
36 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
37 * Monitor Leaf moisture
38 * Monitor Leaf temperature
39 * Moisture and Temperature alarm function
40 * Monitor Battery Level
41 * Uplink on periodically
42 * Downlink to change configure
43 * IP66 Waterproof Enclosure
44 * IP67 rate for the Sensor Probe
45 * Ultra-Low Power consumption
46 * AT Commands to change parameters
47 * Micro SIM card slot for NB-IoT SIM
48 * 8500mAh Battery for long term use
49
50 (((
51
52
53
54
55 )))
56
57 == 1.3  Specification ==
58
59
60 (% style="color:#037691" %)**Common DC Characteristics:**
61
62 * Supply Voltage: 2.1v ~~ 3.6v
63 * Operating Temperature: -40 ~~ 85°C
64
65 (% style="color:#037691" %)**NB-IoT Spec:**
66
67 * - B1 @H-FDD: 2100MHz
68 * - B3 @H-FDD: 1800MHz
69 * - B8 @H-FDD: 900MHz
70 * - B5 @H-FDD: 850MHz
71 * - B20 @H-FDD: 800MHz
72 * - B28 @H-FDD: 700MHz
73
74
75
76
77 == 1.4  Probe Specification ==
78
79
80 (% style="color:#037691" %)**Leaf Moisture: percentage of water drop over total leaf surface**
81
82 * Range 0-100%
83 * Resolution: 0.1%
84 * Accuracy: ±3%（0-50%）；±6%（>50%）
85 * IP67 Protection
86 * Length: 3.5 meters
87
88
89
90 (% style="color:#037691" %)**Leaf Temperature:**
91
92 * Range -50℃～80℃
93 * Resolution: 0.1℃
94 * Accuracy: <±0.5℃(-10℃～70℃)，<±1.0℃ (others)
95 * IP67 Protection
96 * Length: 3.5 meters
97
98
99
100
101 == 1.5 ​ Applications ==
102
103
104 * Smart Agriculture
105
106
107
108
109 == 1.6  Pin mapping and power on ==
110
111
112 ​[[image:image-20220907171221-4.png]]
113
114 **~ **
115
116
117 = 2.  Use NLMS01 to communicate with IoT Server =
118
119
120 == 2.1  How it works ==
121
122
123 The NLMS01 is equipped with a NB-IoT module, the pre-loaded firmware in NLMS01 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 NLMS01.
124
125 The diagram below shows the working flow in default firmware of NLMS01:
126
127
128 [[image:image-20220907171221-5.png]]
129
130
131
132 == 2.2 ​ Configure the NLMS01 ==
133
134
135 === 2.2.1 Test Requirement ===
136
137
138 To use NLMS01 in your city, make sure meet below requirements:
139
140 * Your local operator has already distributed a NB-IoT Network there.
141 * The local NB-IoT network used the band that NLMS01 supports.
142 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
143
144 Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NLMS01 will use(% style="color:#037691" %)** CoAP(120.24.4.116:5683) **(%%)or raw(% style="color:#037691" %)** UDP(120.24.4.116:5601)** or(%%) (% style="color:#037691" %)**MQTT(120.24.4.116:1883)**(%%)or (% style="color:#037691" %)**TCP(120.24.4.116:5600)**(%%)protocol to send data to the test server
145
146
147 [[image:image-20220907171221-6.png]] ​
148
149
150
151 === 2.2.2 Insert SIM card ===
152
153
154 Insert the NB-IoT Card get from your provider.
155
156 User need to take out the NB-IoT module and insert the SIM card like below:
157
158
159 [[image:image-20220907171221-7.png]] ​
160
161
162
163 === 2.2.3 Connect USB – TTL to NLMS01 to configure it ===
164
165
166 User need to configure NLMS01 via serial port to set the (% style="color:#037691" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NLMS01 support AT Commands, user can use a USB to TTL adapter to connect to NLMS01 and use AT Commands to configure it, as below.
167
168
169 (% style="color:blue" %)**Connection:**
170
171 **~ (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND(%%)**
172
173 **~ (% style="background-color:yellow" %)USB TTL TXD  <~-~-~-~-> UART_RXD(%%)**
174
175 **~ (% style="background-color:yellow" %)USB TTL RXD  <~-~-~-~-> UART_TXD(%%)**
176
177
178 In the PC, use below serial tool settings:
179
180 * Baud:  (% style="color:green" %)**9600**
181 * Data bits:**  (% style="color:green" %)8(%%)**
182 * Stop bits:  (% style="color:green" %)**1**
183 * Parity:  (% style="color:green" %)**None**
184 * Flow Control: (% style="color:green" %)**None**
185
186 Make sure the switch is in FLASH position, then power on device by connecting the jumper on NLMS01. NLMS01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
187
188 ​[[image:image-20220913090720-1.png]]
189
190
191 (% style="color:red" %)**Note: the valid AT Commands can be found at:  **(%%)[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
192
193
194
195 === 2.2.4 Use CoAP protocol to uplink data ===
196
197
198 (% 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/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
199
200
201 (% style="color:blue" %)**Use below commands:**
202
203 * (% style="color:#037691" %)**AT+PRO=1**          (%%) ~/~/  Set to use CoAP protocol to uplink
204 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/  to set CoAP server address and port
205 * (% style="color:#037691" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/  Set COAP resource path
206
207 For parameter description, please refer to AT command set
208
209 [[image:image-20220907171221-9.png]]
210
211
212 After configure the server address and (% style="color:#037691" %)**reset the device**(%%) (via AT+ATZ ), NLMS01 will start to uplink sensor values to CoAP server.
213
214 [[image:image-20220907171221-10.png]] ​
215
216
217
218 === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
219
220
221 This feature is supported since firmware version v1.0.1
222
223 * (% style="color:#037691" %)**AT+PRO=2   ** (%%) ~/~/  Set to use UDP protocol to uplink
224 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601     ** (%%) ~/~/  to set UDP server address and port
225 * (% style="color:#037691" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessary
226
227
228
229 ​ [[image:image-20220907171221-11.png]]
230
231
232 [[image:image-20220907171221-12.png]]
233
234 ​
235
236
237 === 2.2.6 Use MQTT protocol to uplink data ===
238
239
240 This feature is supported since firmware version v110
241
242 * (% style="color:#037691" %)**AT+PRO=3   ** (%%) ~/~/  Set to use MQTT protocol to uplink
243 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/  Set MQTT server address and port
244 * (% style="color:#037691" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/  Set up the CLIENT of MQTT
245 * (% style="color:#037691" %)**AT+UNAME=UNAME                        **(%%)** **~/~/  Set the username of MQTT
246 * (% style="color:#037691" %)**AT+PWD=PWD                            **(%%)** **~/~/  Set the password of MQTT
247 * (% style="color:#037691" %)**AT+PUBTOPIC=PUB                    ** (%%) ~/~/  Set the sending topic of MQTT
248 * (% style="color:#037691" %)**AT+SUBTOPIC=SUB          ** (%%) ~/~/  Set the subscription topic of MQTT
249
250
251
252 ​ [[image:image-20220907171221-13.png]]
253
254
255
256 [[image:image-20220907171221-14.png]]
257
258 ​
259
260 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.
261
262
263
264 === 2.2.7 Use TCP protocol to uplink data ===
265
266
267 This feature is supported since firmware version v110
268
269 * (% style="color:#037691" %)**AT+PRO=4   ** (%%) ~/~/  Set to use TCP protocol to uplink
270 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/  to set TCP server address and port
271
272
273
274 ​ [[image:image-20220907171221-15.png]]
275
276
277
278 [[image:image-20220907171221-16.png]]
279
280 ​
281
282
283 === 2.2.8 Change Update Interval ===
284
285
286 User can use below command to change the **uplink interval**.
287
288 * (% style="color:#037691" %)**AT+TDC=7200      ** (%%) ~/~/ Set Update Interval to 7200s (2 hour)
289
290
291
292 (% style="color:red" %)**NOTE: By default, the device will send an uplink message every 2 hour. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).**
293
294
295
296 == 2.3  Uplink Payload ==
297
298
299 In this mode, uplink payload includes 87 bytes in total by default.
300
301 Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded.
302
303
304 (% border="1" style="background-color:#ffffcc; color:green; width:1251px" %)
305 |(% style="width:96px" %)**Size(bytes)**|(% style="width:82px" %)**8**|(% style="width:42px" %)**2**|(% style="width:48px" %)**2**|(% style="width:124px" %)1|(% style="width:58px" %)1|(% style="width:82px" %)1|(% style="width:113px" %)2|(% style="width:134px" %)2|(% style="width:100px" %)4|(% style="width:137px" %)2|(% style="width:110px" %)2|(% style="width:122px" %)4
306 |(% style="width:96px" %)**Value**|(% style="width:82px" %)Device ID|(% style="width:42px" %)Ver|(% style="width:48px" %)BAT|(% style="width:124px" %)Signal Strength|(% style="width:58px" %)MOD|(% style="width:82px" %)Interrupt|(% style="width:113px" %)Leaf moisture|(% style="width:134px" %)Leaf Temperature|(% style="width:100px" %)Time stamp|(% style="width:137px" %)Leaf Temperature|(% style="width:110px" %)Leaf moisture|(% style="width:122px" %)Time stamp  .....
307
308 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data.
309
310
311 [[image:image-20220907171221-17.png]]
312
313
314 The payload is ASCII string, representative same HEX:
315
316 0x(% style="color:red" %)f868411056754138(% style="color:blue" %)0064(% style="color:green" %)0c78(% style="color:red" %)17(% style="color:blue" %)01(% style="color:green" %)00(% style="color:blue" %)**0225010b6315537b**010b0226631550fb**010e022663154d77**01110225631549f1**011502246315466b**01190223631542e5**011d022163153f62**011e022163153bde**011e022163153859**(%%)** **where:
317
318 * (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138
319 * (% style="color:blue" %)Version: 0x0064=100=1.0.0
320 * (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V
321 * (% style="color:red" %)Singal: 0x17 = 23
322 * (% style="color:blue" %)Mod: 0x01 = 1
323 * (% style="color:green" %)Interrupt: 0x00= 0
324 * Leaf moisture: 0x0225= 549 = 54.9%
325 * Leaf Temperature:0x010B =267=26.7 °C
326 * Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]])
327 * Leaf Temperature, Leaf moisture,Time stamp : 010b0226631550fb
328 * (% style="color:blue" %)8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,.......
329
330
331
332
333 == 2.4  Payload Explanation and Sensor Interface ==
334
335
336 === 2.4.1  Device ID ===
337
338
339 By default, the Device ID equal to the last 15 bits of IMEI.
340
341 User can use (% style="color:#037691" %)**AT+DEUI**(%%) to set Device ID
342
343
344 (% style="color:blue" %)**Example**:
345
346 AT+DEUI=868411056754138
347
348 The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
349
350
351
352 === 2.4.2  Version Info ===
353
354
355 Specify the software version: 0x64=100, means firmware version 1.00.
356
357 For example: 0x00 64 : this device is NLMS01 with firmware version 1.0.0.
358
359
360
361 === 2.4.3  Battery Info ===
362
363
364 Check the battery voltage for NLMS01.
365
366 Ex1: 0x0B45 = 2885mV
367
368 Ex2: 0x0B49 = 2889mV
369
370
371
372 === 2.4.4  Signal Strength ===
373
374
375 NB-IoT Network signal Strength.
376
377
378 (% style="color:blue" %)**Ex1: 0x1d = 29**
379
380 **0**  -113dBm or less
381
382 **1**  -111dBm
383
384 **2...30** -109dBm... -53dBm
385
386 **31**   -51dBm or greater
387
388 **99**    Not known or not detectable
389
390
391
392 === 2.4.5  Leaf moisture ===
393
394
395 Get the moisture of the (% style="color:#037691" %)**Leaf**(%%). The value range of the register is 300-1000(Decimal), divide this value by 100 to get the percentage of moisture in the Leaf.
396
397 For example, if the data you get from the register is (% style="color:#037691" %)**__0x05 0xDC__**(%%), the moisture content in the (% style="color:#037691" %)**Leaf**(%%) is
398
399 (% style="color:blue" %)**0229(H) = 549(D) /100 = 54.9.**
400
401
402
403 === 2.4.6  Leaf Temperature ===
404
405
406 Get the temperature in the Leaf. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the Leaf. For example, if the data you get from the register is (% style="color:#037691" %)**__0x09 0xEC__**(%%), the temperature content in the (% style="color:#037691" %)**Leaf **(%%)is
407
408 (% style="color:blue" %)**Example**:
409
410 If payload is **0105H**: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C
411
412 If payload is **FF7EH**: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
413
414
415
416 === 2.4.7  Timestamp ===
417
418
419 Time stamp : 0x6315537b =1662342011
420
421 Convert Unix timestamp to time 2022-9-5 9:40:11.
422
423
424
425 === 2.4.8  Digital Interrupt ===
426
427
428 Digital Interrupt refers to pin (% style="color:#037691" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NLMS01 will send a packet to the server.
429
430 The command is:
431
432 (% 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]])**.**
433
434 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.
435
436 Example:
437
438 0x(00): Normal uplink packet.
439
440 0x(01): Interrupt Uplink Packet.
441
442
443
444 === 2.4.9  ​+5V Output ===
445
446
447 NLMS01 will enable +5V output before all sampling and disable the +5v after all sampling. 
448
449 The 5V output time can be controlled by AT Command.
450
451 (% style="color:blue" %)**AT+5VT=1000**
452
453 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** **
454
455
456
457 == 2.5  Downlink Payload ==
458
459
460 By default, NLMS01 prints the downlink payload to console port.
461
462 [[image:image-20220907171221-18.png]] ​
463
464
465 (% style="color:blue" %)**Examples:**
466
467
468 * (% style="color:#037691" %)**Set TDC**
469
470 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
471
472 Payload:    01 00 00 1E    TDC=30S
473
474 Payload:    01 00 00 3C    TDC=60S
475
476
477
478 * (% style="color:#037691" %)**Reset**
479
480 If payload = 0x04FF, it will reset the NLMS01
481
482
483
484 * (% style="color:#037691" %)**INTMOD**
485
486 Downlink Payload: 06000003, Set AT+INTMOD=3
487
488
489
490 == 2.6  ​LED Indicator ==
491
492
493 The NLMS01 has an internal LED which is to show the status of different state.
494
495 * When power on, NLMS01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe)
496 * Then the LED will be on for 1 second means device is boot normally.
497 * After NLMS01 join NB-IoT network. The LED will be ON for 3 seconds.
498 * For each uplink probe, LED will be on for 500ms.
499
500
501
502
503 == 2.7  Installation ==
504
505
506 NLMS01 probe has two sides. The side without words are the sense side. Please be ware when install the sensor.
507
508
509 [[image:image-20220907171221-19.png]]
510
511
512
513 == 2.8  Moisture and Temperature alarm function ==
514
515
516 (% style="color:blue" %)**➢ AT Command:**
517
518 (% style="color:#037691" %)**AT+ HUMALARM =min,max**
519
520 ² When min=0, and max≠0, Alarm higher than max
521
522 ² When min≠0, and max=0, Alarm lower than min
523
524 ² When min≠0 and max≠0, Alarm higher than max or lower than min
525
526
527 (% style="color:blue" %)**Example:**
528
529 AT+ HUMALARM =50,60 ~/~/ Alarm when moisture lower than 50.
530
531 AT+ TEMPALARM=min,max
532
533 ² When min=0, and max≠0, Alarm higher than max
534
535 ² When min≠0, and max=0, Alarm lower than min
536
537 ² When min≠0 and max≠0, Alarm higher than max or lower than min
538
539
540 (% style="color:blue" %)**Example:**
541
542 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
543
544
545
546 == 2.9  Set the number of data to be uploaded and the recording time ==
547
548
549 (% style="color:blue" %)**➢ AT Command:**
550
551 * (% style="color:#037691" %)**AT+TR=900**   (%%) ~/~/  The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds)
552 * (% style="color:#037691" %)**AT+NOUD=8**  (%%)~/~/  The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
553
554
555
556
557 == 2.10  Read or Clear cached data ==
558
559
560 (% style="color:blue" %)**➢ AT Command:**
561
562 * (% style="color:#037691" %)**AT+CDP**      (%%) ~/~/  Read cached data
563 * (% style="color:#037691" %)**AT+CDP=0  ** (%%) ~/~/  Clear cached data
564
565
566
567 [[image:image-20220907171221-20.png]]
568
569
570
571 == 2.11  ​Firmware Change Log ==
572
573
574 Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]
575
576 Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]]
577
578
579
580 == 2.12  ​Battery Analysis ==
581
582
583 === 2.12.1  ​Battery Type ===
584
585
586 The NLMS01 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.
587
588 The battery is designed to last for several years depends on the actually use environment and update interval. 
589
590 The battery related documents as below:
591
592 * [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
593 * [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
594 * [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
595
596 [[image:image-20220907171221-21.png]] ​
597
598
599
600 === 2.12.2  Power consumption Analyze ===
601
602
603 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.
604
605 Instruction to use as below:
606
607 (% 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/]]
608
609 (% style="color:blue" %)**Step 2: **(%%) Open it and choose
610
611 * Product Model
612 * Uplink Interval
613 * Working Mode
614
615 And the Life expectation in difference case will be shown on the right.
616
617 [[image:image-20220907171221-22.jpeg]] ​
618
619
620 === 2.12.3  ​Battery Note ===
621
622
623 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.
624
625
626
627 === 2.12.4  Replace the battery ===
628
629
630 The default battery pack of NLMS01 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).
631
632
633
634 = 3. ​ Access NB-IoT Module =
635
636
637 Users can directly access the AT command set of the NB-IoT module.
638
639 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/]] 
640
641
642 [[image:image-20220907171221-23.png]] ​
643
644
645
646 = 4.  Using the AT Commands =
647
648
649 == 4.1  Access AT Commands ==
650
651
652 See this link for detail:  [[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
653
654 AT+<CMD>?  : Help on <CMD>
655
656 AT+<CMD>         : Run <CMD>
657
658 AT+<CMD>=<value> : Set the value
659
660 AT+<CMD>=?  : Get the value
661
662
663 (% style="color:#037691" %)**General Commands**      
664
665 AT  : Attention       
666
667 AT?  : Short Help     
668
669 ATZ  : MCU Reset    
670
671 AT+TDC  : Application Data Transmission Interval
672
673 AT+CFG  : Print all configurations
674
675 AT+CFGMOD           : Working mode selection
676
677 AT+INTMOD            : Set the trigger interrupt mode
678
679 AT+5VT  : Set extend the time of 5V power  
680
681 AT+PRO  : Choose agreement
682
683 AT+RXDL  : Extend the sending and receiving time
684
685 AT+SERVADDR  : Server Address
686
687 AT+APN     : Get or set the APN
688
689 AT+FBAND   : Get or Set whether to automatically modify the frequency band
690
691 AT+DNSCFG  : Get or Set DNS Server
692
693 AT+GETSENSORVALUE   : Returns the current sensor measurement
694
695 AT+TR      : Get or Set record time"
696
697 AT+NOUD      : Get or Set the number of data to be uploaded
698
699 AT+CDP     : Read or Clear cached data
700
701 AT+TEMPALARM      : Get or Set alarm of temp
702
703 AT+HUMALARM     : Get or Set alarm of PH
704
705
706 (% style="color:#037691" %)**COAP Management**      
707
708 AT+URI            : Resource parameters
709
710
711 (% style="color:#037691" %)**UDP Management**
712
713 AT+CFM          : Upload confirmation mode (only valid for UDP)
714
715
716 (% style="color:#037691" %)**MQTT Management**
717
718 AT+CLIENT               : Get or Set MQTT client
719
720 AT+UNAME  : Get or Set MQTT Username
721
722 AT+PWD                  : Get or Set MQTT password
723
724 AT+PUBTOPIC  : Get or Set MQTT publish topic
725
726 AT+SUBTOPIC  : Get or Set MQTT subscription topic
727
728
729 (% style="color:#037691" %)**Information**          
730
731 AT+FDR  : Factory Data Reset
732
733 AT+PWORD  : Serial Access Password
734
735
736
737 = ​5.  FAQ =
738
739
740 == 5.1 ​ How to Upgrade Firmware ==
741
742
743 User can upgrade the firmware for 1) bug fix, 2) new feature release.
744
745 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>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]]
746
747
748 (% style="color:red" %)**Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.**
749
750
751
752 = 6.  Trouble Shooting =
753
754
755 == 6.1  ​Connection problem when uploading firmware ==
756
757
758 **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]]
759
760
761
762 == 6.2  AT Command input doesn't work ==
763
764
765 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.
766
767
768
769 = 7. ​ Order Info =
770
771
772 Part Number**:** NLMS01
773
774
775
776 = 8.  Packing Info =
777
778
779 (% style="color:#037691" %)**Package Includes:**
780
781 * NLMS01 NB-IoT Leaf Moisture Sensor x 1
782
783 (% style="color:#037691" %)**Dimension and weight**:
784
785 * Device Size: cm
786 * Device Weight: g
787 * Package Size / pcs : cm
788 * Weight / pcs : g
789
790
791
792 = 9.  Support =
793
794
795 * 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.
796 * 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]]
797
798 ​