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
-
... ... @@ -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 ... ... @@ -221,6 +221,7 @@ 221 221 222 222 223 223 233 + 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 258 + 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 286 + 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 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 + 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 335 + 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 351 + 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 360 + 345 345 === 2.4.3 Battery Info === 346 346 347 347 ... ... @@ -352,6 +352,7 @@ 352 352 Ex2: 0x0B49 = 2889mV 353 353 354 354 371 + 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 391 + 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 402 + 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 415 + 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 424 + 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 443 + 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 456 + 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 462 +[[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 489 + 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 509 + 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 542 + 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 567 + 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 577 +== 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 - [[**BatteryInfo & 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 === 560 560 561 561 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 + 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 642 + 573 573 = 4. Using the AT Commands = 574 574 645 + 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 733 + 662 662 = 5. FAQ = 663 663 736 + 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 748 + 675 675 = 6. Trouble Shooting = 676 676 751 + 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 758 + 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 772 + 701 701 = 8. Packing Info = 702 702 703 703 ... ... @@ -712,6 +712,8 @@ 712 712 * Package Size / pcs : cm 713 713 * Weight / pcs : g 714 714 787 + 788 + 715 715 = 9. Support = 716 716 717 717