Changes for page NLMS01-NB-IoT Leaf Moisture Sensor User Manual
Last modified by Mengting Qiu on 2024/04/02 16:54
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -9,20 +9,24 @@ 9 9 10 10 = 1. Introduction = 11 11 12 - 13 13 == 1.1 What is NLMS01 Leaf Moisture Sensor == 14 14 15 15 15 +((( 16 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 17 18 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 19 20 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 24 22 +NLMS01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP **(%%)for different application requirement. 25 25 24 +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). 25 + 26 +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. 27 +))) 28 + 29 + 26 26 [[image:image-20220907171221-2.png]] 27 27 28 28 ... ... @@ -29,7 +29,6 @@ 29 29 [[image:image-20220907171221-3.png]] 30 30 31 31 32 - 33 33 == 1.2 Features == 34 34 35 35 ... ... @@ -63,12 +63,12 @@ 63 63 64 64 (% style="color:#037691" %)**NB-IoT Spec:** 65 65 66 -* -B1 @H-FDD: 2100MHz67 -* -B3 @H-FDD: 1800MHz68 -* -B8 @H-FDD: 900MHz69 -* -B5 @H-FDD: 850MHz70 -* -B20 @H-FDD: 800MHz71 -* -B28 @H-FDD: 700MHz69 +* B1 @H-FDD: 2100MHz 70 +* B3 @H-FDD: 1800MHz 71 +* B8 @H-FDD: 900MHz 72 +* B5 @H-FDD: 850MHz 73 +* B20 @H-FDD: 800MHz 74 +* B28 @H-FDD: 700MHz 72 72 73 73 74 74 == 1.4 Probe Specification == ... ... @@ -104,10 +104,8 @@ 104 104 105 105 **~ ** 106 106 107 - 108 108 = 2. Use NLMS01 to communicate with IoT Server = 109 109 110 - 111 111 == 2.1 How it works == 112 112 113 113 ... ... @@ -119,10 +119,8 @@ 119 119 [[image:image-20220907171221-5.png]] 120 120 121 121 122 - 123 123 == 2.2 Configure the NLMS01 == 124 124 125 - 126 126 === 2.2.1 Test Requirement === 127 127 128 128 ... ... @@ -138,7 +138,6 @@ 138 138 [[image:image-20220907171221-6.png]] 139 139 140 140 141 - 142 142 === 2.2.2 Insert SIM card === 143 143 144 144 ... ... @@ -150,7 +150,6 @@ 150 150 [[image:image-20220907171221-7.png]] 151 151 152 152 153 - 154 154 === 2.2.3 Connect USB – TTL to NLMS01 to configure it === 155 155 156 156 ... ... @@ -182,7 +182,6 @@ 182 182 (% 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]] 183 183 184 184 185 - 186 186 === 2.2.4 Use CoAP protocol to uplink data === 187 187 188 188 ... ... @@ -205,7 +205,6 @@ 205 205 [[image:image-20220907171221-10.png]] 206 206 207 207 208 - 209 209 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 210 210 211 211 ... ... @@ -222,7 +222,6 @@ 222 222 223 223 224 224 225 - 226 226 === 2.2.6 Use MQTT protocol to uplink data === 227 227 228 228 ... ... @@ -247,7 +247,6 @@ 247 247 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. 248 248 249 249 250 - 251 251 === 2.2.7 Use TCP protocol to uplink data === 252 252 253 253 ... ... @@ -275,7 +275,6 @@ 275 275 (% 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).** 276 276 277 277 278 - 279 279 == 2.3 Uplink Payload == 280 280 281 281 ... ... @@ -284,8 +284,8 @@ 284 284 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. 285 285 286 286 287 -(% border="1" style="background-color:#fff fcc;color:green;width:520px" %)288 -|(% style="width: 45px" %)**Size(bytes)**|(% style="width:45px" %)**8**|(% style="width:20px" %)**2**|(% style="width:20px" %)**2**|(% style="width:70px" %)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:50px" %)2|(% style="width:40px" %)4279 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %) 280 +|(% style="width:50px;background-color:#D9E2F3;color:#0070C0" %)**Size(bytes)**|(% style="width:40px;background-color:#D9E2F3;color:#0070C0" %)**8**|(% style="width:20px;background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:20px;background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:60px;background-color:#D9E2F3;color:#0070C0" %)**1**|(% style="width:20px;background-color:#D9E2F3;color:#0070C0" %)**1**|(% style="width:40px;background-color:#D9E2F3;color:#0070C0" %)**1**|(% style="width:40px;background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:50px;background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:50px;background-color:#D9E2F3;color:#0070C0" %)**4**|(% style="width:50px;background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:40px;background-color:#D9E2F3;color:#0070C0" %)**2**|(% style="width:40px;background-color:#D9E2F3;color:#0070C0" %)**4** 289 289 |(% 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 ..... 290 290 291 291 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data. ... ... @@ -322,10 +322,8 @@ 322 322 323 323 * (% style="color:#037691" %)**8 sets of recorded data: **(%%)Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,....... 324 324 325 - 326 326 == 2.4 Payload Explanation and Sensor Interface == 327 327 328 - 329 329 === 2.4.1 Device ID === 330 330 331 331 ... ... @@ -341,7 +341,6 @@ 341 341 The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 342 342 343 343 344 - 345 345 === 2.4.2 Version Info === 346 346 347 347 ... ... @@ -350,7 +350,6 @@ 350 350 For example: 0x00 64 : this device is NLMS01 with firmware version 1.0.0. 351 351 352 352 353 - 354 354 === 2.4.3 Battery Info === 355 355 356 356 ... ... @@ -361,7 +361,6 @@ 361 361 Ex2: 0x0B49 = 2889mV 362 362 363 363 364 - 365 365 === 2.4.4 Signal Strength === 366 366 367 367 ... ... @@ -381,7 +381,6 @@ 381 381 **99** Not known or not detectable 382 382 383 383 384 - 385 385 === 2.4.5 Leaf moisture === 386 386 387 387 ... ... @@ -392,7 +392,6 @@ 392 392 (% style="color:blue" %)**0229(H) = 549(D) /100 = 54.9.** 393 393 394 394 395 - 396 396 === 2.4.6 Leaf Temperature === 397 397 398 398 ... ... @@ -405,7 +405,6 @@ 405 405 If payload is **FF7EH**: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C 406 406 407 407 408 - 409 409 === 2.4.7 Timestamp === 410 410 411 411 ... ... @@ -414,7 +414,6 @@ 414 414 Convert Unix timestamp to time 2022-9-5 9:40:11. 415 415 416 416 417 - 418 418 === 2.4.8 Digital Interrupt === 419 419 420 420 ... ... @@ -433,7 +433,6 @@ 433 433 0x(01): Interrupt Uplink Packet. 434 434 435 435 436 - 437 437 === 2.4.9 +5V Output === 438 438 439 439 ... ... @@ -446,7 +446,6 @@ 446 446 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** ** 447 447 448 448 449 - 450 450 == 2.5 Downlink Payload == 451 451 452 452 ... ... @@ -479,7 +479,6 @@ 479 479 Downlink Payload: 06000003, Set AT+INTMOD=3 480 480 481 481 482 - 483 483 == 2.6 LED Indicator == 484 484 485 485 ... ... @@ -499,7 +499,6 @@ 499 499 [[image:image-20220907171221-19.png]] 500 500 501 501 502 - 503 503 == 2.8 Moisture and Temperature alarm function == 504 504 505 505 ... ... @@ -532,7 +532,6 @@ 532 532 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20. 533 533 534 534 535 - 536 536 == 2.9 Set the number of data to be uploaded and the recording time == 537 537 538 538 ... ... @@ -557,7 +557,6 @@ 557 557 [[image:image-20220907171221-20.png]] 558 558 559 559 560 - 561 561 == 2.11 Firmware Change Log == 562 562 563 563 ... ... @@ -566,61 +566,14 @@ 566 566 Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]] 567 567 568 568 546 +== 2.12 Battery & Power Consumption == 569 569 570 -== 2.12 Battery Analysis == 571 571 549 +NLMS01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 572 572 573 - === 2.12.1 BatteryType===551 +[[**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 574 575 575 576 -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. 577 - 578 -The battery is designed to last for several years depends on the actually use environment and update interval. 579 - 580 -The battery related documents as below: 581 - 582 -* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 583 -* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 584 -* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 585 - 586 -[[image:image-20220907171221-21.png]] 587 - 588 - 589 - 590 -=== 2.12.2 Power consumption Analyze === 591 - 592 - 593 -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. 594 - 595 -Instruction to use as below: 596 - 597 -(% 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/]] 598 - 599 -(% style="color:blue" %)**Step 2: **(%%) Open it and choose 600 - 601 -* Product Model 602 -* Uplink Interval 603 -* Working Mode 604 - 605 -And the Life expectation in difference case will be shown on the right. 606 - 607 -[[image:image-20220907171221-22.jpeg]] 608 - 609 - 610 -=== 2.12.3 Battery Note === 611 - 612 - 613 -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. 614 - 615 - 616 - 617 -=== 2.12.4 Replace the battery === 618 - 619 - 620 -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). 621 - 622 - 623 - 624 624 = 3. Access NB-IoT Module = 625 625 626 626 ... ... @@ -632,10 +632,8 @@ 632 632 [[image:image-20220907171221-23.png]] 633 633 634 634 635 - 636 636 = 4. Using the AT Commands = 637 637 638 - 639 639 == 4.1 Access AT Commands == 640 640 641 641 ... ... @@ -723,10 +723,8 @@ 723 723 AT+PWORD : Serial Access Password 724 724 725 725 726 - 727 727 = 5. FAQ = 728 728 729 - 730 730 == 5.1 How to Upgrade Firmware == 731 731 732 732 ... ... @@ -738,10 +738,8 @@ 738 738 (% style="color:red" %)**Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.** 739 739 740 740 741 - 742 742 = 6. Trouble Shooting = 743 743 744 - 745 745 == 6.1 Connection problem when uploading firmware == 746 746 747 747 ... ... @@ -748,7 +748,6 @@ 748 748 **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]] 749 749 750 750 751 - 752 752 == 6.2 AT Command input doesn't work == 753 753 754 754 ... ... @@ -755,7 +755,12 @@ 755 755 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. 756 756 757 757 681 +== 6.3 Not able to connect to NB-IoT network and keep showing "Signal Strength:99". == 758 758 683 + 684 +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]]//**. 685 + 686 + 759 759 = 7. Order Info = 760 760 761 761 ... ... @@ -762,7 +762,6 @@ 762 762 Part Number**:** NLMS01 763 763 764 764 765 - 766 766 = 8. Packing Info = 767 767 768 768 ... ... @@ -777,7 +777,6 @@ 777 777 * Package Size / pcs : cm 778 778 * Weight / pcs : g 779 779 780 - 781 781 = 9. Support = 782 782 783 783