Changes for page NLMS01-NB-IoT Leaf Moisture Sensor User Manual
Last modified by Mengting Qiu on 2024/04/02 16:54
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 1 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. David1 +XWiki.Xiaoling - Content
-
... ... @@ -1,8 +1,15 @@ 1 + 2 + 1 1 (% style="text-align:center" %) 2 2 [[image:image-20220907171221-1.jpeg]] 3 3 4 4 5 5 8 + 9 + 10 + 11 + 12 + 6 6 {{toc/}} 7 7 8 8 ... ... @@ -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 22 +((( 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 29 +NLMS01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP **(%%)for different application requirement. 25 25 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. 34 +))) 35 + 36 + 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 ... ... @@ -50,7 +50,6 @@ 50 50 ((( 51 51 52 52 53 - 54 54 55 55 ))) 56 56 ... ... @@ -64,12 +64,12 @@ 64 64 65 65 (% style="color:#037691" %)**NB-IoT Spec:** 66 66 67 -* -B1 @H-FDD: 2100MHz68 -* -B3 @H-FDD: 1800MHz69 -* -B8 @H-FDD: 900MHz70 -* -B5 @H-FDD: 850MHz71 -* -B20 @H-FDD: 800MHz72 -* -B28 @H-FDD: 700MHz76 +* 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 73 73 74 74 75 75 == 1.4 Probe Specification == ... ... @@ -105,10 +105,8 @@ 105 105 106 106 **~ ** 107 107 108 - 109 109 = 2. Use NLMS01 to communicate with IoT Server = 110 110 111 - 112 112 == 2.1 How it works == 113 113 114 114 ... ... @@ -120,10 +120,8 @@ 120 120 [[image:image-20220907171221-5.png]] 121 121 122 122 123 - 124 124 == 2.2 Configure the NLMS01 == 125 125 126 - 127 127 === 2.2.1 Test Requirement === 128 128 129 129 ... ... @@ -139,7 +139,6 @@ 139 139 [[image:image-20220907171221-6.png]] 140 140 141 141 142 - 143 143 === 2.2.2 Insert SIM card === 144 144 145 145 ... ... @@ -151,7 +151,6 @@ 151 151 [[image:image-20220907171221-7.png]] 152 152 153 153 154 - 155 155 === 2.2.3 Connect USB – TTL to NLMS01 to configure it === 156 156 157 157 ... ... @@ -183,7 +183,6 @@ 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 186 - 187 187 === 2.2.4 Use CoAP protocol to uplink data === 188 188 189 189 ... ... @@ -206,7 +206,6 @@ 206 206 [[image:image-20220907171221-10.png]] 207 207 208 208 209 - 210 210 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 211 211 212 212 ... ... @@ -223,7 +223,6 @@ 223 223 224 224 225 225 226 - 227 227 === 2.2.6 Use MQTT protocol to uplink data === 228 228 229 229 ... ... @@ -248,7 +248,6 @@ 248 248 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. 249 249 250 250 251 - 252 252 === 2.2.7 Use TCP protocol to uplink data === 253 253 254 254 ... ... @@ -276,7 +276,6 @@ 276 276 (% 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).** 277 277 278 278 279 - 280 280 == 2.3 Uplink Payload == 281 281 282 282 ... ... @@ -284,11 +284,10 @@ 284 284 285 285 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. 286 286 285 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:517px" %) 286 +|(% 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** 287 +|(% 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 ..... 287 287 288 -(% border="1" style="background-color:#ffffcc; color:green; width:1251px" %) 289 -|(% 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 290 -|(% 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 ..... 291 - 292 292 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data. 293 293 294 294 ... ... @@ -301,22 +301,31 @@ 301 301 302 302 where: 303 303 304 -* Device ID: 0xf868411056754138 = f868411056754138 305 -* Version: 0x0064=100=1.0.0 306 -* BAT: 0x0c78 = 3192 mV = 3.192V 307 -* Singal: 0x17 = 23 308 -* Mod: 0x01 = 1 309 -* Interrupt: 0x00= 0 310 -* Leaf moisture: 0x0225= 549 = 54.9% 311 -* Leaf Temperature:0x010B =267=26.7 °C 312 -* Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]]) 313 -* Leaf Temperature, Leaf moisture,Time stamp : 010b0226631550fb 314 -* 8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,....... 301 +* (% style="color:#037691" %)**Device ID:**(%%) 0xf868411056754138 = f868411056754138 315 315 303 +* (% style="color:#037691" %)**Version:**(%%) 0x0064=100=1.0.0 316 316 317 - ==2.4Payload Explanation and SensorInterface==305 +* (% style="color:#037691" %)**BAT:** (%%)0x0c78 = 3192 mV = 3.192V 318 318 307 +* (% style="color:#037691" %)**Singal:**(%%) 0x17 = 23 319 319 309 +* (% style="color:#037691" %)**Mod:**(%%) 0x01 = 1 310 + 311 +* (% style="color:#037691" %)**Interrupt:**(%%) 0x00= 0 312 + 313 +* (% style="color:#037691" %)**Leaf moisture:**(%%) 0x0225= 549 = 54.9% 314 + 315 +* (% style="color:#037691" %)**Leaf Temperature: **(%%)0x010B =267=26.7 °C 316 + 317 +* (% style="color:#037691" %)**Time stamp :** (%%)0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]]) 318 + 319 +* (% style="color:#037691" %)**Leaf Temperature, Leaf moisture,Time stamp : **(%%)010b0226631550fb 320 + 321 +* (% style="color:#037691" %)**8 sets of recorded data: **(%%)Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,....... 322 + 323 + 324 +== 2.4 Payload Explanation and Sensor Interface == 325 + 320 320 === 2.4.1 Device ID === 321 321 322 322 ... ... @@ -332,7 +332,6 @@ 332 332 The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 333 333 334 334 335 - 336 336 === 2.4.2 Version Info === 337 337 338 338 ... ... @@ -341,7 +341,6 @@ 341 341 For example: 0x00 64 : this device is NLMS01 with firmware version 1.0.0. 342 342 343 343 344 - 345 345 === 2.4.3 Battery Info === 346 346 347 347 ... ... @@ -352,7 +352,6 @@ 352 352 Ex2: 0x0B49 = 2889mV 353 353 354 354 355 - 356 356 === 2.4.4 Signal Strength === 357 357 358 358 ... ... @@ -372,7 +372,6 @@ 372 372 **99** Not known or not detectable 373 373 374 374 375 - 376 376 === 2.4.5 Leaf moisture === 377 377 378 378 ... ... @@ -383,7 +383,6 @@ 383 383 (% style="color:blue" %)**0229(H) = 549(D) /100 = 54.9.** 384 384 385 385 386 - 387 387 === 2.4.6 Leaf Temperature === 388 388 389 389 ... ... @@ -396,7 +396,6 @@ 396 396 If payload is **FF7EH**: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C 397 397 398 398 399 - 400 400 === 2.4.7 Timestamp === 401 401 402 402 ... ... @@ -405,7 +405,6 @@ 405 405 Convert Unix timestamp to time 2022-9-5 9:40:11. 406 406 407 407 408 - 409 409 === 2.4.8 Digital Interrupt === 410 410 411 411 ... ... @@ -424,7 +424,6 @@ 424 424 0x(01): Interrupt Uplink Packet. 425 425 426 426 427 - 428 428 === 2.4.9 +5V Output === 429 429 430 430 ... ... @@ -437,14 +437,18 @@ 437 437 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** ** 438 438 439 439 440 - 441 441 == 2.5 Downlink Payload == 442 442 443 443 444 444 By default, NLMS01 prints the downlink payload to console port. 445 445 446 -[[image:image-20220907171221-18.png]] 443 +(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %) 444 +|=(% 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)** 445 +|(% style="width:183px" %)TDC (Transmit Time Interval)|(% style="width:55px" %)Any|(% style="width:93px" %)01|(% style="width:146px" %)4 446 +|(% style="width:183px" %)RESET|(% style="width:55px" %)Any|(% style="width:93px" %)04|(% style="width:146px" %)2 447 +|(% style="width:183px" %)INTMOD|(% style="width:55px" %)Any|(% style="width:93px" %)06|(% style="width:146px" %)4 447 447 449 + 448 448 449 449 (% style="color:blue" %)**Examples:** 450 450 ... ... @@ -470,7 +470,6 @@ 470 470 Downlink Payload: 06000003, Set AT+INTMOD=3 471 471 472 472 473 - 474 474 == 2.6 LED Indicator == 475 475 476 476 ... ... @@ -491,7 +491,6 @@ 491 491 [[image:image-20220907171221-19.png]] 492 492 493 493 494 - 495 495 == 2.8 Moisture and Temperature alarm function == 496 496 497 497 ... ... @@ -524,7 +524,6 @@ 524 524 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20. 525 525 526 526 527 - 528 528 == 2.9 Set the number of data to be uploaded and the recording time == 529 529 530 530 ... ... @@ -533,12 +533,11 @@ 533 533 * (% 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) 534 534 * (% 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. 535 535 535 + The diagram below explains the relationship between TR, NOUD, and TDC more clearly**:** 536 536 537 - This linkexplains therelationship betweenTR, NOUD andTDC more clearly.537 +[[image:image-20221009001002-1.png||height="706" width="982"]] 538 538 539 -[[https:~~/~~/www.processon.com/view/link/6340e606e401fd390891af87>>https://www.processon.com/view/link/6340e606e401fd390891af87]] 540 540 541 - 542 542 == 2.10 Read or Clear cached data == 543 543 544 544 ... ... @@ -550,7 +550,6 @@ 550 550 [[image:image-20220907171221-20.png]] 551 551 552 552 553 - 554 554 == 2.11 Firmware Change Log == 555 555 556 556 ... ... @@ -559,61 +559,14 @@ 559 559 Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]] 560 560 561 561 559 +== 2.12 Battery & Power Consumption == 562 562 563 -== 2.12 Battery Analysis == 564 564 562 +NLMS01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace. 565 565 566 - === 2.12.1 BatteryType===564 +[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] . 567 567 568 568 569 -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. 570 - 571 -The battery is designed to last for several years depends on the actually use environment and update interval. 572 - 573 -The battery related documents as below: 574 - 575 -* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 576 -* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 577 -* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]] 578 - 579 -[[image:image-20220907171221-21.png]] 580 - 581 - 582 - 583 -=== 2.12.2 Power consumption Analyze === 584 - 585 - 586 -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. 587 - 588 -Instruction to use as below: 589 - 590 -(% 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/]] 591 - 592 -(% style="color:blue" %)**Step 2: **(%%) Open it and choose 593 - 594 -* Product Model 595 -* Uplink Interval 596 -* Working Mode 597 - 598 -And the Life expectation in difference case will be shown on the right. 599 - 600 -[[image:image-20220907171221-22.jpeg]] 601 - 602 - 603 -=== 2.12.3 Battery Note === 604 - 605 - 606 -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. 607 - 608 - 609 - 610 -=== 2.12.4 Replace the battery === 611 - 612 - 613 -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). 614 - 615 - 616 - 617 617 = 3. Access NB-IoT Module = 618 618 619 619 ... ... @@ -625,10 +625,8 @@ 625 625 [[image:image-20220907171221-23.png]] 626 626 627 627 628 - 629 629 = 4. Using the AT Commands = 630 630 631 - 632 632 == 4.1 Access AT Commands == 633 633 634 634 ... ... @@ -716,10 +716,8 @@ 716 716 AT+PWORD : Serial Access Password 717 717 718 718 719 - 720 720 = 5. FAQ = 721 721 722 - 723 723 == 5.1 How to Upgrade Firmware == 724 724 725 725 ... ... @@ -731,10 +731,8 @@ 731 731 (% style="color:red" %)**Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.** 732 732 733 733 734 - 735 735 = 6. Trouble Shooting = 736 736 737 - 738 738 == 6.1 Connection problem when uploading firmware == 739 739 740 740 ... ... @@ -741,7 +741,6 @@ 741 741 **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]] 742 742 743 743 744 - 745 745 == 6.2 AT Command input doesn't work == 746 746 747 747 ... ... @@ -748,7 +748,12 @@ 748 748 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. 749 749 750 750 694 +== 6.3 Not able to connect to NB-IoT network and keep showing "Signal Strength:99". == 751 751 696 + 697 +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]]//**. 698 + 699 + 752 752 = 7. Order Info = 753 753 754 754 ... ... @@ -755,7 +755,6 @@ 755 755 Part Number**:** NLMS01 756 756 757 757 758 - 759 759 = 8. Packing Info = 760 760 761 761
- image-20221009001002-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +282.9 KB - Content