Skip to Content
Last modified by Mengting Qiu on 2024/04/02 16:54
From version 43.1
edited by Mengting Qiu
on 2024/04/02 16:54
Change comment: There is no comment for this version
To version 38.8
edited by Xiaoling
on 2022/10/25 16:25
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ting
1 +XWiki.Xiaoling
Content
... ... @@ -1,15 +3,8 @@
1 -
2 -
3 3  (% style="text-align:center" %)
4 4  [[image:image-20220907171221-1.jpeg]]
5 5  
6 6  ​
7 7  
8 -
9 -
10 -
11 -
12 -
13 13  {{toc/}}
14 14  
15 15  
... ... @@ -16,21 +16,23 @@
16 16  
17 17  = 1.  Introduction =
18 18  
12 +
19 19  == 1.1 ​ What is NLMS01 Leaf Moisture Sensor ==
20 20  
21 21  
22 22  (((
23 23  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.
18 +)))
24 24  
20 +(((
25 25  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.
22 +)))
26 26  
24 +(((
27 27  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.
28 -
29 -NLMS01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
30 -
31 -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).
32 -
33 -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.
26 +\\NLMS01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
27 +\\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).
28 +\\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.
34 34  )))
35 35  
36 36  
... ... @@ -40,6 +40,7 @@
40 40  ​ [[image:image-20220907171221-3.png]]
41 41  
42 42  
38 +
43 43  == ​1.2  Features ==
44 44  
45 45  
... ... @@ -73,12 +73,12 @@
73 73  
74 74  (% style="color:#037691" %)**NB-IoT Spec:**
75 75  
76 -* B1 @H-FDD: 2100MHz
77 -* B3 @H-FDD: 1800MHz
78 -* B8 @H-FDD: 900MHz
79 -* B5 @H-FDD: 850MHz
80 -* B20 @H-FDD: 800MHz
81 -* B28 @H-FDD: 700MHz
72 +* - B1 @H-FDD: 2100MHz
73 +* - B3 @H-FDD: 1800MHz
74 +* - B8 @H-FDD: 900MHz
75 +* - B5 @H-FDD: 850MHz
76 +* - B20 @H-FDD: 800MHz
77 +* - B28 @H-FDD: 700MHz
82 82  
83 83  == 1.4  Probe Specification ==
84 84  
... ... @@ -111,8 +111,10 @@
111 111  
112 112  **~ **
113 113  
110 +
114 114  = 2.  Use NLMS01 to communicate with IoT Server =
115 115  
113 +
116 116  == 2.1  How it works ==
117 117  
118 118  
... ... @@ -124,8 +124,10 @@
124 124  [[image:image-20220907171221-5.png]]
125 125  
126 126  
125 +
127 127  == 2.2 ​ Configure the NLMS01 ==
128 128  
128 +
129 129  === 2.2.1 Test Requirement ===
130 130  
131 131  
... ... @@ -141,6 +141,7 @@
141 141  [[image:image-20220907171221-6.png]] ​
142 142  
143 143  
144 +
144 144  === 2.2.2 Insert SIM card ===
145 145  
146 146  
... ... @@ -152,6 +152,7 @@
152 152  [[image:image-20220907171221-7.png]] ​
153 153  
154 154  
156 +
155 155  === 2.2.3 Connect USB – TTL to NLMS01 to configure it ===
156 156  
157 157  
... ... @@ -183,6 +183,7 @@
183 183  (% 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]]
184 184  
185 185  
188 +
186 186  === 2.2.4 Use CoAP protocol to uplink data ===
187 187  
188 188  
... ... @@ -205,6 +205,7 @@
205 205  [[image:image-20220907171221-10.png]] ​
206 206  
207 207  
211 +
208 208  === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
209 209  
210 210  
... ... @@ -212,6 +212,7 @@
212 212  
213 213  * (% style="color:#037691" %)**AT+PRO=2   ** (%%) ~/~/  Set to use UDP protocol to uplink
214 214  * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601     ** (%%) ~/~/  to set UDP server address and port
219 +* (% style="color:#037691" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessary
215 215  
216 216  ​ [[image:image-20220907171221-11.png]]
217 217  
... ... @@ -220,6 +220,7 @@
220 220  
221 221  ​
222 222  
228 +
223 223  === 2.2.6 Use MQTT protocol to uplink data ===
224 224  
225 225  
... ... @@ -244,6 +244,7 @@
244 244  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.
245 245  
246 246  
253 +
247 247  === 2.2.7 Use TCP protocol to uplink data ===
248 248  
249 249  
... ... @@ -271,6 +271,7 @@
271 271  (% 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).**
272 272  
273 273  
281 +
274 274  == 2.3  Uplink Payload ==
275 275  
276 276  
... ... @@ -278,10 +278,11 @@
278 278  
279 279  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.
280 280  
281 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)
282 -|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**8**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**1**|(% style="background-color:#4f81bd; color:white; width:30px" %)**1**|(% style="background-color:#4f81bd; color:white; width:40px" %)**1**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:50px" %)**4**|(% style="background-color:#4f81bd; color:white; width:50px" %)**2**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:37px" %)**4**
283 -|(% 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  .....
284 284  
290 +(% border="1" style="background-color:#ffffcc; color:green; width:520px" %)
291 +|=(% scope="row" style="width: 50px;" %)**Size(bytes)**|(% style="width:40px" %)**8**|(% style="width:20px" %)**2**|(% style="width:20px" %)**2**|(% style="width:60px" %)**1**|(% style="width:20px" %)**1**|(% style="width:40px" %)**1**|(% style="width:40px" %)**2**|(% style="width:50px" %)**2**|(% style="width:50px" %)**4**|(% style="width:50px" %)**2**|(% style="width:40px" %)**2**|(% style="width:40px" %)**4**
292 +|=(% 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  .....
293 +
285 285  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data.
286 286  
287 287  
... ... @@ -318,6 +318,7 @@
318 318  
319 319  == 2.4  Payload Explanation and Sensor Interface ==
320 320  
330 +
321 321  === 2.4.1  Device ID ===
322 322  
323 323  
... ... @@ -333,6 +333,7 @@
333 333  The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
334 334  
335 335  
346 +
336 336  === 2.4.2  Version Info ===
337 337  
338 338  
... ... @@ -341,6 +341,7 @@
341 341  For example: 0x00 64 : this device is NLMS01 with firmware version 1.0.0.
342 342  
343 343  
355 +
344 344  === 2.4.3  Battery Info ===
345 345  
346 346  
... ... @@ -351,6 +351,7 @@
351 351  Ex2: 0x0B49 = 2889mV
352 352  
353 353  
366 +
354 354  === 2.4.4  Signal Strength ===
355 355  
356 356  
... ... @@ -370,6 +370,7 @@
370 370  **99**    Not known or not detectable
371 371  
372 372  
386 +
373 373  === 2.4.5  Leaf moisture ===
374 374  
375 375  
... ... @@ -380,6 +380,7 @@
380 380  (% style="color:blue" %)**0229(H) = 549(D) /100 = 54.9.**
381 381  
382 382  
397 +
383 383  === 2.4.6  Leaf Temperature ===
384 384  
385 385  
... ... @@ -392,6 +392,7 @@
392 392  If payload is **FF7EH**: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
393 393  
394 394  
410 +
395 395  === 2.4.7  Timestamp ===
396 396  
397 397  
... ... @@ -400,6 +400,7 @@
400 400  Convert Unix timestamp to time 2022-9-5 9:40:11.
401 401  
402 402  
419 +
403 403  === 2.4.8  Digital Interrupt ===
404 404  
405 405  
... ... @@ -418,6 +418,7 @@
418 418  0x(01): Interrupt Uplink Packet.
419 419  
420 420  
438 +
421 421  === 2.4.9  ​+5V Output ===
422 422  
423 423  
... ... @@ -430,18 +430,14 @@
430 430  Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** **
431 431  
432 432  
451 +
433 433  == 2.5  Downlink Payload ==
434 434  
435 435  
436 436  By default, NLMS01 prints the downlink payload to console port.
437 437  
438 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
439 -|=(% style="width: 183px; background-color:#4F81BD;color:white" %)**Downlink Control Type**|=(% style="width: 55px; background-color:#4F81BD;color:white" %)FPort|=(% style="width: 93px; background-color:#4F81BD;color:white" %)**Type Code**|=(% style="width: 179px; background-color:#4F81BD;color:white" %)**Downlink payload size(bytes)**
440 -|(% style="width:183px" %)TDC (Transmit Time Interval)|(% style="width:55px" %)Any|(% style="width:93px" %)01|(% style="width:146px" %)4
441 -|(% style="width:183px" %)RESET|(% style="width:55px" %)Any|(% style="width:93px" %)04|(% style="width:146px" %)2
442 -|(% style="width:183px" %)INTMOD|(% style="width:55px" %)Any|(% style="width:93px" %)06|(% style="width:146px" %)4
457 +[[image:image-20220907171221-18.png]] ​
443 443  
444 - ​
445 445  
446 446  (% style="color:blue" %)**Examples:**
447 447  
... ... @@ -467,6 +467,7 @@
467 467  Downlink Payload: 06000003, Set AT+INTMOD=3
468 468  
469 469  
484 +
470 470  == 2.6  ​LED Indicator ==
471 471  
472 472  
... ... @@ -486,6 +486,7 @@
486 486  [[image:image-20220907171221-19.png]]
487 487  
488 488  
504 +
489 489  == 2.8  Moisture and Temperature alarm function ==
490 490  
491 491  
... ... @@ -518,6 +518,7 @@
518 518  AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
519 519  
520 520  
537 +
521 521  == 2.9  Set the number of data to be uploaded and the recording time ==
522 522  
523 523  
... ... @@ -542,6 +542,7 @@
542 542  [[image:image-20220907171221-20.png]]
543 543  
544 544  
562 +
545 545  == 2.11  ​Firmware Change Log ==
546 546  
547 547  
... ... @@ -550,14 +550,61 @@
550 550  Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
551 551  
552 552  
553 -== 2.12 Battery & Power Consumption ==
554 554  
572 +== 2.12  ​Battery Analysis ==
555 555  
556 -NLMS01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
557 557  
558 -[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
575 +=== 2.12.1  ​Battery Type ===
559 559  
560 560  
578 +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.
579 +
580 +The battery is designed to last for several years depends on the actually use environment and update interval. 
581 +
582 +The battery related documents as below:
583 +
584 +* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
585 +* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
586 +* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
587 +
588 +[[image:image-20220907171221-21.png]] ​
589 +
590 +
591 +
592 +=== 2.12.2  Power consumption Analyze ===
593 +
594 +
595 +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.
596 +
597 +Instruction to use as below:
598 +
599 +(% 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/]]
600 +
601 +(% style="color:blue" %)**Step 2: **(%%) Open it and choose
602 +
603 +* Product Model
604 +* Uplink Interval
605 +* Working Mode
606 +
607 +And the Life expectation in difference case will be shown on the right.
608 +
609 +[[image:image-20220907171221-22.jpeg]] ​
610 +
611 +
612 +=== 2.12.3  ​Battery Note ===
613 +
614 +
615 +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.
616 +
617 +
618 +
619 +=== 2.12.4  Replace the battery ===
620 +
621 +
622 +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).
623 +
624 +
625 +
561 561  = 3. ​ Access NB-IoT Module =
562 562  
563 563  
... ... @@ -569,8 +569,10 @@
569 569  [[image:image-20220907171221-23.png]] ​
570 570  
571 571  
637 +
572 572  = 4.  Using the AT Commands =
573 573  
640 +
574 574  == 4.1  Access AT Commands ==
575 575  
576 576  
... ... @@ -633,6 +633,11 @@
633 633  AT+URI :  Resource parameters
634 634  
635 635  
703 +(% style="color:#037691" %)**UDP Management**
704 +
705 +AT+CFM :  Upload confirmation mode (only valid for UDP)
706 +
707 +
636 636  (% style="color:#037691" %)**MQTT Management**
637 637  
638 638  AT+CLIENT  :  Get or Set MQTT client
... ... @@ -653,8 +653,10 @@
653 653  AT+PWORD :  Serial Access Password
654 654  
655 655  
728 +
656 656  = ​5.  FAQ =
657 657  
731 +
658 658  == 5.1 ​ How to Upgrade Firmware ==
659 659  
660 660  
... ... @@ -666,8 +666,10 @@
666 666  (% style="color:red" %)**Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.**
667 667  
668 668  
743 +
669 669  = 6.  Trouble Shooting =
670 670  
746 +
671 671  == 6.1  ​Connection problem when uploading firmware ==
672 672  
673 673  
... ... @@ -674,6 +674,7 @@
674 674  **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]]
675 675  
676 676  
753 +
677 677  == 6.2  AT Command input doesn't work ==
678 678  
679 679  
... ... @@ -680,24 +680,7 @@
680 680  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.
681 681  
682 682  
683 -== 6.3 Not able to connect to NB-IoT network and keep showing "Signal Strength:99". ==
684 684  
685 -
686 -This means sensor is trying to join the NB-IoT network but fail. Please see this link for **//[[trouble shooting for signal strenght:99>>doc:Main.CSQ\:99,99.WebHome]]//**.
687 -
688 -
689 -== 6.4 Possible reasons why the device is unresponsive： ==
690 -
691 -
692 -​1. Check whether the battery voltage is lower than 2.8V
693 -2. Check whether the jumper of the device is correctly connected
694 -
695 -[[image:image-20240330175629-2.png]]
696 -3. Check whether the switch here of the device is at the ISP（The switch can operate normally only when it is in RUN）
697 -​
698 -
699 -[[image:image-20240330175554-1.png]]
700 -
701 701  = 7. ​ Order Info =
702 702  
703 703  
... ... @@ -704,6 +704,7 @@
704 704  Part Number**:** NLMS01
705 705  
706 706  
767 +
707 707  = 8.  Packing Info =
708 708  
709 709  
image-20240330175554-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -445.4 KB
Content
image-20240330175629-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Bei
Size
... ... @@ -1,1 +1,0 @@
1 -445.4 KB
Content