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.11
edited by Xiaoling
on 2022/10/25 16:33
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,6 +16,7 @@
16 16  
17 17  = 1.  Introduction =
18 18  
12 +
19 19  == 1.1 ​ What is NLMS01 Leaf Moisture Sensor ==
20 20  
21 21  
... ... @@ -40,6 +40,7 @@
40 40  ​ [[image:image-20220907171221-3.png]]
41 41  
42 42  
37 +
43 43  == ​1.2  Features ==
44 44  
45 45  
... ... @@ -73,13 +73,15 @@
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
71 +* - B1 @H-FDD: 2100MHz
72 +* - B3 @H-FDD: 1800MHz
73 +* - B8 @H-FDD: 900MHz
74 +* - B5 @H-FDD: 850MHz
75 +* - B20 @H-FDD: 800MHz
76 +* - B28 @H-FDD: 700MHz
82 82  
78 +
79 +
83 83  == 1.4  Probe Specification ==
84 84  
85 85  
... ... @@ -99,11 +99,15 @@
99 99  * IP67 Protection
100 100  * Length: 3.5 meters
101 101  
99 +
100 +
102 102  == 1.5 ​ Applications ==
103 103  
104 104  
105 105  * Smart Agriculture
106 106  
106 +
107 +
107 107  == 1.6  Pin mapping and power on ==
108 108  
109 109  
... ... @@ -111,8 +111,10 @@
111 111  
112 112  **~ **
113 113  
115 +
114 114  = 2.  Use NLMS01 to communicate with IoT Server =
115 115  
118 +
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  
130 +
127 127  == 2.2 ​ Configure the NLMS01 ==
128 128  
133 +
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  
149 +
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  
161 +
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  
193 +
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  
216 +
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
224 +* (% 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  
233 +
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  
258 +
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  
286 +
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  
295 +(% border="1" style="background-color:#ffffcc; color:green; width:520px" %)
296 +|=(% 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**
297 +|=(% 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  .....
298 +
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  
335 +
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  
351 +
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  
360 +
344 344  === 2.4.3  Battery Info ===
345 345  
346 346  
... ... @@ -351,6 +351,7 @@
351 351  Ex2: 0x0B49 = 2889mV
352 352  
353 353  
371 +
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  
391 +
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  
402 +
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  
415 +
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  
424 +
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  
443 +
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  
456 +
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
462 +[[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  
489 +
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  
509 +
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  
542 +
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  
567 +
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  
577 +== 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/]] .
580 +=== 2.12.1  ​Battery Type ===
559 559  
560 560  
583 +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.
584 +
585 +The battery is designed to last for several years depends on the actually use environment and update interval. 
586 +
587 +The battery related documents as below:
588 +
589 +* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
590 +* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
591 +* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
592 +
593 +[[image:image-20220907171221-21.png]] ​
594 +
595 +
596 +
597 +=== 2.12.2  Power consumption Analyze ===
598 +
599 +
600 +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.
601 +
602 +Instruction to use as below:
603 +
604 +(% 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/]]
605 +
606 +(% style="color:blue" %)**Step 2: **(%%) Open it and choose
607 +
608 +* Product Model
609 +* Uplink Interval
610 +* Working Mode
611 +
612 +And the Life expectation in difference case will be shown on the right.
613 +
614 +[[image:image-20220907171221-22.jpeg]] ​
615 +
616 +
617 +=== 2.12.3  ​Battery Note ===
618 +
619 +
620 +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.
621 +
622 +
623 +
624 +=== 2.12.4  Replace the battery ===
625 +
626 +
627 +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).
628 +
629 +
630 +
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  
642 +
572 572  = 4.  Using the AT Commands =
573 573  
645 +
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  
708 +(% style="color:#037691" %)**UDP Management**
709 +
710 +AT+CFM :  Upload confirmation mode (only valid for UDP)
711 +
712 +
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  
733 +
656 656  = ​5.  FAQ =
657 657  
736 +
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  
748 +
669 669  = 6.  Trouble Shooting =
670 670  
751 +
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  
758 +
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  
772 +
707 707  = 8.  Packing Info =
708 708  
709 709  
... ... @@ -718,6 +718,8 @@
718 718  * Package Size / pcs : cm
719 719  * Weight / pcs : g
720 720  
787 +
788 +
721 721  = 9.  Support =
722 722  
723 723  
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