<
From version < 38.25 >
edited by Xiaoling
on 2024/01/18 14:39
To version < 38.9 >
edited by Xiaoling
on 2022/10/25 16:27
>
Change comment: There is no comment for this version

Summary

Details

Page properties
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,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
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  
83 83  == 1.4  Probe Specification ==
84 84  
... ... @@ -111,8 +111,10 @@
111 111  
112 112  **~ **
113 113  
109 +
114 114  = 2.  Use NLMS01 to communicate with IoT Server =
115 115  
112 +
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  
124 +
127 127  == 2.2 ​ Configure the NLMS01 ==
128 128  
127 +
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  
143 +
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  
155 +
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  
187 +
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  
210 +
208 208  === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
209 209  
210 210  
... ... @@ -221,6 +221,7 @@
221 221  
222 222  ​
223 223  
227 +
224 224  === 2.2.6 Use MQTT protocol to uplink data ===
225 225  
226 226  
... ... @@ -245,6 +245,7 @@
245 245  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.
246 246  
247 247  
252 +
248 248  === 2.2.7 Use TCP protocol to uplink data ===
249 249  
250 250  
... ... @@ -272,6 +272,7 @@
272 272  (% 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).**
273 273  
274 274  
280 +
275 275  == 2.3  Uplink Payload ==
276 276  
277 277  
... ... @@ -279,10 +279,11 @@
279 279  
280 280  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.
281 281  
282 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %)
283 -|(% 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**
284 -|(% 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  .....
285 285  
289 +(% border="1" style="background-color:#ffffcc; color:green; width:520px" %)
290 +|=(% 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**
291 +|=(% 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  .....
292 +
286 286  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data.
287 287  
288 288  
... ... @@ -319,6 +319,7 @@
319 319  
320 320  == 2.4  Payload Explanation and Sensor Interface ==
321 321  
329 +
322 322  === 2.4.1  Device ID ===
323 323  
324 324  
... ... @@ -334,6 +334,7 @@
334 334  The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
335 335  
336 336  
345 +
337 337  === 2.4.2  Version Info ===
338 338  
339 339  
... ... @@ -342,6 +342,7 @@
342 342  For example: 0x00 64 : this device is NLMS01 with firmware version 1.0.0.
343 343  
344 344  
354 +
345 345  === 2.4.3  Battery Info ===
346 346  
347 347  
... ... @@ -352,6 +352,7 @@
352 352  Ex2: 0x0B49 = 2889mV
353 353  
354 354  
365 +
355 355  === 2.4.4  Signal Strength ===
356 356  
357 357  
... ... @@ -371,6 +371,7 @@
371 371  **99**    Not known or not detectable
372 372  
373 373  
385 +
374 374  === 2.4.5  Leaf moisture ===
375 375  
376 376  
... ... @@ -381,6 +381,7 @@
381 381  (% style="color:blue" %)**0229(H) = 549(D) /100 = 54.9.**
382 382  
383 383  
396 +
384 384  === 2.4.6  Leaf Temperature ===
385 385  
386 386  
... ... @@ -393,6 +393,7 @@
393 393  If payload is **FF7EH**: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
394 394  
395 395  
409 +
396 396  === 2.4.7  Timestamp ===
397 397  
398 398  
... ... @@ -401,6 +401,7 @@
401 401  Convert Unix timestamp to time 2022-9-5 9:40:11.
402 402  
403 403  
418 +
404 404  === 2.4.8  Digital Interrupt ===
405 405  
406 406  
... ... @@ -419,6 +419,7 @@
419 419  0x(01): Interrupt Uplink Packet.
420 420  
421 421  
437 +
422 422  === 2.4.9  ​+5V Output ===
423 423  
424 424  
... ... @@ -431,18 +431,14 @@
431 431  Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** **
432 432  
433 433  
450 +
434 434  == 2.5  Downlink Payload ==
435 435  
436 436  
437 437  By default, NLMS01 prints the downlink payload to console port.
438 438  
439 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
440 -|=(% 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)**
441 -|(% style="width:183px" %)TDC (Transmit Time Interval)|(% style="width:55px" %)Any|(% style="width:93px" %)01|(% style="width:146px" %)4
442 -|(% style="width:183px" %)RESET|(% style="width:55px" %)Any|(% style="width:93px" %)04|(% style="width:146px" %)2
443 -|(% style="width:183px" %)INTMOD|(% style="width:55px" %)Any|(% style="width:93px" %)06|(% style="width:146px" %)4
456 +[[image:image-20220907171221-18.png]] ​
444 444  
445 - ​
446 446  
447 447  (% style="color:blue" %)**Examples:**
448 448  
... ... @@ -468,6 +468,7 @@
468 468  Downlink Payload: 06000003, Set AT+INTMOD=3
469 469  
470 470  
483 +
471 471  == 2.6  ​LED Indicator ==
472 472  
473 473  
... ... @@ -487,6 +487,7 @@
487 487  [[image:image-20220907171221-19.png]]
488 488  
489 489  
503 +
490 490  == 2.8  Moisture and Temperature alarm function ==
491 491  
492 492  
... ... @@ -519,6 +519,7 @@
519 519  AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
520 520  
521 521  
536 +
522 522  == 2.9  Set the number of data to be uploaded and the recording time ==
523 523  
524 524  
... ... @@ -543,6 +543,7 @@
543 543  [[image:image-20220907171221-20.png]]
544 544  
545 545  
561 +
546 546  == 2.11  ​Firmware Change Log ==
547 547  
548 548  
... ... @@ -551,14 +551,61 @@
551 551  Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
552 552  
553 553  
554 -== 2.12 Battery & Power Consumption ==
555 555  
571 +== 2.12  ​Battery Analysis ==
556 556  
557 -NLMS01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
558 558  
559 -[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
574 +=== 2.12.1  ​Battery Type ===
560 560  
561 561  
577 +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.
578 +
579 +The battery is designed to last for several years depends on the actually use environment and update interval. 
580 +
581 +The battery related documents as below:
582 +
583 +* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
584 +* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
585 +* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
586 +
587 +[[image:image-20220907171221-21.png]] ​
588 +
589 +
590 +
591 +=== 2.12.2  Power consumption Analyze ===
592 +
593 +
594 +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.
595 +
596 +Instruction to use as below:
597 +
598 +(% 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/]]
599 +
600 +(% style="color:blue" %)**Step 2: **(%%) Open it and choose
601 +
602 +* Product Model
603 +* Uplink Interval
604 +* Working Mode
605 +
606 +And the Life expectation in difference case will be shown on the right.
607 +
608 +[[image:image-20220907171221-22.jpeg]] ​
609 +
610 +
611 +=== 2.12.3  ​Battery Note ===
612 +
613 +
614 +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.
615 +
616 +
617 +
618 +=== 2.12.4  Replace the battery ===
619 +
620 +
621 +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).
622 +
623 +
624 +
562 562  = 3. ​ Access NB-IoT Module =
563 563  
564 564  
... ... @@ -570,8 +570,10 @@
570 570  [[image:image-20220907171221-23.png]] ​
571 571  
572 572  
636 +
573 573  = 4.  Using the AT Commands =
574 574  
639 +
575 575  == 4.1  Access AT Commands ==
576 576  
577 577  
... ... @@ -659,8 +659,10 @@
659 659  AT+PWORD :  Serial Access Password
660 660  
661 661  
727 +
662 662  = ​5.  FAQ =
663 663  
730 +
664 664  == 5.1 ​ How to Upgrade Firmware ==
665 665  
666 666  
... ... @@ -672,8 +672,10 @@
672 672  (% style="color:red" %)**Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.**
673 673  
674 674  
742 +
675 675  = 6.  Trouble Shooting =
676 676  
745 +
677 677  == 6.1  ​Connection problem when uploading firmware ==
678 678  
679 679  
... ... @@ -680,6 +680,7 @@
680 680  **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]]
681 681  
682 682  
752 +
683 683  == 6.2  AT Command input doesn't work ==
684 684  
685 685  
... ... @@ -686,12 +686,7 @@
686 686  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.
687 687  
688 688  
689 -== 6.3 Not able to connect to NB-IoT network and keep showing "Signal Strength:99". ==
690 690  
691 -
692 -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]]//**.
693 -
694 -
695 695  = 7. ​ Order Info =
696 696  
697 697  
... ... @@ -698,6 +698,7 @@
698 698  Part Number**:** NLMS01
699 699  
700 700  
766 +
701 701  = 8.  Packing Info =
702 702  
703 703  
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0