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
-
... ... @@ -71,6 +71,9 @@ 71 71 * - B20 @H-FDD: 800MHz 72 72 * - B28 @H-FDD: 700MHz 73 73 74 + 75 + 76 + 74 74 == 1.4 Probe Specification == 75 75 76 76 ... ... @@ -82,6 +82,8 @@ 82 82 * IP67 Protection 83 83 * Length: 3.5 meters 84 84 88 + 89 + 85 85 (% style="color:#037691" %)**Leaf Temperature:** 86 86 87 87 * Range -50℃~80℃ ... ... @@ -90,11 +90,17 @@ 90 90 * IP67 Protection 91 91 * Length: 3.5 meters 92 92 98 + 99 + 100 + 93 93 == 1.5 Applications == 94 94 95 95 96 96 * Smart Agriculture 97 97 106 + 107 + 108 + 98 98 == 1.6 Pin mapping and power on == 99 99 100 100 ... ... @@ -193,8 +193,6 @@ 193 193 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683 ** (%%) ~/~/ to set CoAP server address and port 194 194 * (% style="color:#037691" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/ Set COAP resource path 195 195 196 - 197 - 198 198 For parameter description, please refer to AT command set 199 199 200 200 [[image:image-20220907171221-9.png]] ... ... @@ -212,7 +212,7 @@ 212 212 This feature is supported since firmware version v1.0.1 213 213 214 214 * (% style="color:#037691" %)**AT+PRO=2 ** (%%) ~/~/ Set to use UDP protocol to uplink 215 -* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601 224 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 216 216 * (% style="color:#037691" %)**AT+CFM=1 ** (%%) ~/~/ If the server does not respond, this command is unnecessary 217 217 218 218 ... ... @@ -296,7 +296,6 @@ 296 296 |(% 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 297 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 298 299 - 300 300 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data. 301 301 302 302 ... ... @@ -322,29 +322,37 @@ 322 322 323 323 324 324 325 - 326 326 == 2.4 Payload Explanation and Sensor Interface == 327 327 335 + 328 328 === 2.4.1 Device ID === 329 329 338 + 330 330 By default, the Device ID equal to the last 15 bits of IMEI. 331 331 332 -User can use **AT+DEUI** to set Device ID 341 +User can use (% style="color:#037691" %)**AT+DEUI**(%%) to set Device ID 333 333 334 -**Example:** 335 335 344 +(% style="color:blue" %)**Example**: 345 + 336 336 AT+DEUI=868411056754138 337 337 338 338 The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 339 339 350 + 351 + 340 340 === 2.4.2 Version Info === 341 341 354 + 342 342 Specify the software version: 0x64=100, means firmware version 1.00. 343 343 344 344 For example: 0x00 64 : this device is NLMS01 with firmware version 1.0.0. 345 345 359 + 360 + 346 346 === 2.4.3 Battery Info === 347 347 363 + 348 348 Check the battery voltage for NLMS01. 349 349 350 350 Ex1: 0x0B45 = 2885mV ... ... @@ -351,12 +351,16 @@ 351 351 352 352 Ex2: 0x0B49 = 2889mV 353 353 370 + 371 + 354 354 === 2.4.4 Signal Strength === 355 355 374 + 356 356 NB-IoT Network signal Strength. 357 357 358 -**Ex1: 0x1d = 29** 359 359 378 +(% style="color:blue" %)**Ex1: 0x1d = 29** 379 + 360 360 **0** -113dBm or less 361 361 362 362 **1** -111dBm ... ... @@ -367,37 +367,49 @@ 367 367 368 368 **99** Not known or not detectable 369 369 390 + 391 + 370 370 === 2.4.5 Leaf moisture === 371 371 372 -Get the moisture of the **Leaf**. The value range of the register is 300-1000(Decimal), divide this value by 100 to get the percentage of moisture in the **Leaf**. 373 373 374 - Forexample,if thedatayou getfromthe register is**__0x050xDC__**, themoisture content in the**Leaf** is395 +Get the moisture of the (% style="color:#037691" %)**Leaf**(%%). The value range of the register is 300-1000(Decimal), divide this value by 100 to get the percentage of moisture in the Leaf. 375 375 376 - **0229(H)= 549(D)/100=54.9.**397 +For example, if the data you get from the register is (% style="color:#037691" %)**__0x05 0xDC__**(%%), the moisture content in the (% style="color:#037691" %)**Leaf**(%%) is 377 377 399 +(% style="color:blue" %)**0229(H) = 549(D) /100 = 54.9.** 400 + 401 + 402 + 378 378 === 2.4.6 Leaf Temperature === 379 379 380 -Get the temperature in the **Leaf**. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the **Leaf**. For example, if the data you get from the register is **__0x09 0xEC__**, the temperature content in the **Leaf **is 381 381 382 - **Example**:406 +Get the temperature in the Leaf. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the Leaf. For example, if the data you get from the register is (% style="color:#037691" %)**__0x09 0xEC__**(%%), the temperature content in the (% style="color:#037691" %)**Leaf **(%%)is 383 383 384 - Ifpayload is 0105H:((0x0105 & 0x8000)>>15 === 0),temp= 0105(H)/10 = 26.1 °C408 +(% style="color:blue" %)**Example**: 385 385 386 -If payload is FF7EH: ((FF7E& 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 =-12.9°C410 +If payload is **0105H**: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C 387 387 412 +If payload is **FF7EH**: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C 413 + 414 + 415 + 388 388 === 2.4.7 Timestamp === 389 389 418 + 390 390 Time stamp : 0x6315537b =1662342011 391 391 392 392 Convert Unix timestamp to time 2022-9-5 9:40:11. 393 393 423 + 424 + 394 394 === 2.4.8 Digital Interrupt === 395 395 396 -Digital Interrupt refers to pin **GPIO_EXTI**, and there are different trigger methods. When there is a trigger, the NLMS01 will send a packet to the server. 397 397 428 +Digital Interrupt refers to pin (% style="color:#037691" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NLMS01 will send a packet to the server. 429 + 398 398 The command is: 399 399 400 -**AT+INTMOD=3 ** ~/~/(more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.** 432 +(% style="color:blue" %)**AT+INTMOD=3 ** (%%) ~/~/ (more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.** 401 401 402 402 The lower four bits of this data field shows if this packet is generated by interrupt or not. Click here for the hardware and software set up. 403 403 ... ... @@ -407,27 +407,34 @@ 407 407 408 408 0x(01): Interrupt Uplink Packet. 409 409 442 + 443 + 410 410 === 2.4.9 +5V Output === 411 411 446 + 412 412 NLMS01 will enable +5V output before all sampling and disable the +5v after all sampling. 413 413 414 414 The 5V output time can be controlled by AT Command. 415 415 416 -**AT+5VT=1000** 451 +(% style="color:blue" %)**AT+5VT=1000** 417 417 418 418 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** ** 419 419 420 420 456 + 421 421 == 2.5 Downlink Payload == 422 422 459 + 423 423 By default, NLMS01 prints the downlink payload to console port. 424 424 425 425 [[image:image-20220907171221-18.png]] 426 426 427 -**Examples:** 428 428 429 - ***Set TDC**465 +(% style="color:blue" %)**Examples:** 430 430 467 + 468 +* (% style="color:#037691" %)**Set TDC** 469 + 431 431 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01. 432 432 433 433 Payload: 01 00 00 1E TDC=30S ... ... @@ -434,16 +434,23 @@ 434 434 435 435 Payload: 01 00 00 3C TDC=60S 436 436 437 -* **Reset** 438 438 477 + 478 +* (% style="color:#037691" %)**Reset** 479 + 439 439 If payload = 0x04FF, it will reset the NLMS01 440 440 441 -* **INTMOD** 442 442 483 + 484 +* (% style="color:#037691" %)**INTMOD** 485 + 443 443 Downlink Payload: 06000003, Set AT+INTMOD=3 444 444 488 + 489 + 445 445 == 2.6 LED Indicator == 446 446 492 + 447 447 The NLMS01 has an internal LED which is to show the status of different state. 448 448 449 449 * When power on, NLMS01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe) ... ... @@ -451,18 +451,26 @@ 451 451 * After NLMS01 join NB-IoT network. The LED will be ON for 3 seconds. 452 452 * For each uplink probe, LED will be on for 500ms. 453 453 454 -== 2.7 Installation == 455 455 501 + 502 + 503 +== 2.7 Installation == 504 + 505 + 456 456 NLMS01 probe has two sides. The side without words are the sense side. Please be ware when install the sensor. 457 457 508 + 458 458 [[image:image-20220907171221-19.png]] 459 459 460 -== 2.8 Moisture and Temperature alarm function == 461 461 462 -➢ AT Command: 463 463 464 - AT+HUMALARM=min,max513 +== 2.8 Moisture and Temperature alarm function == 465 465 515 + 516 +(% style="color:blue" %)**➢ AT Command:** 517 + 518 +(% style="color:#037691" %)**AT+ HUMALARM =min,max** 519 + 466 466 ² When min=0, and max≠0, Alarm higher than max 467 467 468 468 ² When min≠0, and max=0, Alarm lower than min ... ... @@ -469,8 +469,9 @@ 469 469 470 470 ² When min≠0 and max≠0, Alarm higher than max or lower than min 471 471 472 -Example: 473 473 527 +(% style="color:blue" %)**Example:** 528 + 474 474 AT+ HUMALARM =50,60 ~/~/ Alarm when moisture lower than 50. 475 475 476 476 AT+ TEMPALARM=min,max ... ... @@ -481,41 +481,53 @@ 481 481 482 482 ² When min≠0 and max≠0, Alarm higher than max or lower than min 483 483 484 -Example: 485 485 540 +(% style="color:blue" %)**Example:** 541 + 486 486 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20. 487 487 488 488 489 -== 2.9 Set the number of data to be uploaded and the recording time == 490 490 491 - ➢ATCommand:546 +== 2.9 Set the number of data to be uploaded and the recording time == 492 492 493 -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) 494 494 495 - AT+NOUD=8~/~/The device uploads8 sets of recorded databy default. Up to 32 setsofrecorddata can be uploaded.549 +(% style="color:blue" %)**➢ AT Command:** 496 496 497 -== 2.10 Read or Clear cached data == 551 +* (% 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) 552 +* (% 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. 498 498 499 -➢ AT Command: 500 500 501 -AT+CDP ~/~/ Read cached data 502 502 503 -[[image:image-20220907171221-20.png]] 504 504 557 +== 2.10 Read or Clear cached data == 505 505 506 -AT+CDP=0 ~/~/ Clear cached data 507 507 560 +(% style="color:blue" %)**➢ AT Command:** 508 508 562 +* (% style="color:#037691" %)**AT+CDP** (%%) ~/~/ Read cached data 563 +* (% style="color:#037691" %)**AT+CDP=0 ** (%%) ~/~/ Clear cached data 564 + 565 + 566 + 567 +[[image:image-20220907171221-20.png]] 568 + 569 + 570 + 509 509 == 2.11 Firmware Change Log == 510 510 573 + 511 511 Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]] 512 512 513 513 Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]] 514 514 578 + 579 + 515 515 == 2.12 Battery Analysis == 516 516 582 + 517 517 === 2.12.1 Battery Type === 518 518 585 + 519 519 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. 520 520 521 521 The battery is designed to last for several years depends on the actually use environment and update interval. ... ... @@ -528,15 +528,18 @@ 528 528 529 529 [[image:image-20220907171221-21.png]] 530 530 598 + 599 + 531 531 === 2.12.2 Power consumption Analyze === 532 532 602 + 533 533 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. 534 534 535 535 Instruction to use as below: 536 536 537 -**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/]] 607 +(% 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/]] 538 538 539 -**Step 2: ** Open it and choose 609 +(% style="color:blue" %)**Step 2: **(%%) Open it and choose 540 540 541 541 * Product Model 542 542 * Uplink Interval ... ... @@ -546,26 +546,39 @@ 546 546 547 547 [[image:image-20220907171221-22.jpeg]] 548 548 619 + 549 549 === 2.12.3 Battery Note === 550 550 622 + 551 551 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. 552 552 625 + 626 + 553 553 === 2.12.4 Replace the battery === 554 554 629 + 555 555 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). 556 556 632 + 633 + 557 557 = 3. Access NB-IoT Module = 558 558 636 + 559 559 Users can directly access the AT command set of the NB-IoT module. 560 560 561 561 The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]] 562 562 641 + 563 563 [[image:image-20220907171221-23.png]] 564 564 644 + 645 + 565 565 = 4. Using the AT Commands = 566 566 648 + 567 567 == 4.1 Access AT Commands == 568 568 651 + 569 569 See this link for detail: [[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]] 570 570 571 571 AT+<CMD>? : Help on <CMD> ... ... @@ -576,8 +576,9 @@ 576 576 577 577 AT+<CMD>=? : Get the value 578 578 579 -**General Commands** 580 580 663 +(% style="color:#037691" %)**General Commands** 664 + 581 581 AT : Attention 582 582 583 583 AT? : Short Help ... ... @@ -619,16 +619,18 @@ 619 619 AT+HUMALARM : Get or Set alarm of PH 620 620 621 621 622 -**COAP Management** 706 +(% style="color:#037691" %)**COAP Management** 623 623 624 624 AT+URI : Resource parameters 625 625 626 -**UDP Management** 627 627 711 +(% style="color:#037691" %)**UDP Management** 712 + 628 628 AT+CFM : Upload confirmation mode (only valid for UDP) 629 629 630 -**MQTT Management** 631 631 716 +(% style="color:#037691" %)**MQTT Management** 717 + 632 632 AT+CLIENT : Get or Set MQTT client 633 633 634 634 AT+UNAME : Get or Set MQTT Username ... ... @@ -639,43 +639,62 @@ 639 639 640 640 AT+SUBTOPIC : Get or Set MQTT subscription topic 641 641 642 -**Information** 643 643 729 +(% style="color:#037691" %)**Information** 730 + 644 644 AT+FDR : Factory Data Reset 645 645 646 646 AT+PWORD : Serial Access Password 647 647 735 + 736 + 648 648 = 5. FAQ = 649 649 739 + 650 650 == 5.1 How to Upgrade Firmware == 651 651 742 + 652 652 User can upgrade the firmware for 1) bug fix, 2) new feature release. 653 653 654 654 Please see this link for how to upgrade: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]] 655 655 656 -**Notice, **NLMS01 **and **NLMS01 **share the same mother board. They use the same connection and method to update.** 657 657 748 +(% style="color:red" %)**Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.** 749 + 750 + 751 + 658 658 = 6. Trouble Shooting = 659 659 754 + 660 660 == 6.1 Connection problem when uploading firmware == 661 661 757 + 662 662 **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]] 663 663 760 + 761 + 664 664 == 6.2 AT Command input doesn't work == 665 665 666 -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 **ENTER** while sending out the command. Some serial tool doesn't send **ENTER** while press the send key, user need to add ENTER in their string. 667 667 765 +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. 766 + 767 + 768 + 668 668 = 7. Order Info = 669 669 771 + 670 670 Part Number**:** NLMS01 671 671 774 + 775 + 672 672 = 8. Packing Info = 673 673 674 -**Package Includes**: 675 675 779 +(% style="color:#037691" %)**Package Includes:** 780 + 676 676 * NLMS01 NB-IoT Leaf Moisture Sensor x 1 677 677 678 -**Dimension and weight**: 783 +(% style="color:#037691" %)**Dimension and weight**: 679 679 680 680 * Device Size: cm 681 681 * Device Weight: g ... ... @@ -682,8 +682,11 @@ 682 682 * Package Size / pcs : cm 683 683 * Weight / pcs : g 684 684 790 + 791 + 685 685 = 9. Support = 686 686 794 + 687 687 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 688 688 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]] 689 689