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,8 @@ 71 71 * - B20 @H-FDD: 800MHz 72 72 * - B28 @H-FDD: 700MHz 73 73 74 + 75 + 74 74 == 1.4 Probe Specification == 75 75 76 76 ... ... @@ -90,11 +90,15 @@ 90 90 * IP67 Protection 91 91 * Length: 3.5 meters 92 92 95 + 96 + 93 93 == 1.5 Applications == 94 94 95 95 96 96 * Smart Agriculture 97 97 102 + 103 + 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,11 +212,9 @@ 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 219 +* (% 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 - 219 - 220 220 [[image:image-20220907171221-11.png]] 221 221 222 222 ... ... @@ -238,8 +238,6 @@ 238 238 * (% style="color:#037691" %)**AT+PUBTOPIC=PUB ** (%%) ~/~/ Set the sending topic of MQTT 239 239 * (% style="color:#037691" %)**AT+SUBTOPIC=SUB ** (%%) ~/~/ Set the subscription topic of MQTT 240 240 241 - 242 - 243 243 [[image:image-20220907171221-13.png]] 244 244 245 245 ... ... @@ -260,8 +260,6 @@ 260 260 * (% style="color:#037691" %)**AT+PRO=4 ** (%%) ~/~/ Set to use TCP protocol to uplink 261 261 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ to set TCP server address and port 262 262 263 - 264 - 265 265 [[image:image-20220907171221-15.png]] 266 266 267 267 ... ... @@ -278,8 +278,6 @@ 278 278 279 279 * (% style="color:#037691" %)**AT+TDC=7200 ** (%%) ~/~/ Set Update Interval to 7200s (2 hour) 280 280 281 - 282 - 283 283 (% 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).** 284 284 285 285 ... ... @@ -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 ... ... @@ -305,24 +305,24 @@ 305 305 306 306 The payload is ASCII string, representative same HEX: 307 307 308 -0x(% style="color:red" %)f868411056754138(% style="color:blue" %)0064(% style="color:green" %)0c78(% style="color: red" %)17(% style="color:blue" %)01(% style="color:green" %)00(% style="color:blue" %)**0225010b6315537b**010b0226631550fb**010e022663154d77**01110225631549f1**011502246315466b**01190223631542e5**011d022163153f62**011e022163153bde**011e022163153859**(%%)****where:303 +**0x (% style="color:red" %)__f868411056754138__ (% style="color:blue" %)__0064 __ (% style="color:green" %)__0c78__ (% style="color:#00b0f0" %)__17__ (% style="color:#7030a0" %)__01__ (% style="color:#d60093" %)__00__ (% style="color:#a14d07" %)__0225 __ (% style="color:#0020b0" %) __010b__ (% style="color:#420042" %)__6315537b__ (% style="color:#663300" %)//__010b0226631550fb__ __010e022663154d77 01110225631549f1 011502246315466b 01190223631542e5 011d022163153f62 011e022163153bde 011e022163153859__//(%%)** 309 309 310 -* (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138 311 -* (% style="color:blue" %)Version: 0x0064=100=1.0.0 312 -* (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V 313 -* (% style="color:red" %)Singal: 0x17 = 23 314 -* (% style="color:blue" %)Mod: 0x01 = 1 315 -* (% style="color:green" %)Interrupt: 0x00= 0 305 +where: 306 + 307 +* Device ID: 0xf868411056754138 = f868411056754138 308 +* Version: 0x0064=100=1.0.0 309 +* BAT: 0x0c78 = 3192 mV = 3.192V 310 +* Singal: 0x17 = 23 311 +* Mod: 0x01 = 1 312 +* Interrupt: 0x00= 0 316 316 * Leaf moisture: 0x0225= 549 = 54.9% 317 317 * Leaf Temperature:0x010B =267=26.7 °C 318 318 * Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]]) 319 319 * Leaf Temperature, Leaf moisture,Time stamp : 010b0226631550fb 320 -* (% style="color:blue" %)8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,.......317 +* 8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,....... 321 321 322 322 323 323 324 - 325 - 326 326 == 2.4 Payload Explanation and Sensor Interface == 327 327 328 328 ... ... @@ -331,10 +331,10 @@ 331 331 332 332 By default, the Device ID equal to the last 15 bits of IMEI. 333 333 334 -User can use **AT+DEUI** to set Device ID 329 +User can use (% style="color:#037691" %)**AT+DEUI**(%%) to set Device ID 335 335 336 336 337 -**Example :**332 +(% style="color:blue" %)**Example**: 338 338 339 339 AT+DEUI=868411056754138 340 340 ... ... @@ -367,8 +367,9 @@ 367 367 368 368 NB-IoT Network signal Strength. 369 369 370 -**Ex1: 0x1d = 29** 371 371 366 +(% style="color:blue" %)**Ex1: 0x1d = 29** 367 + 372 372 **0** -113dBm or less 373 373 374 374 **1** -111dBm ... ... @@ -384,11 +384,11 @@ 384 384 === 2.4.5 Leaf moisture === 385 385 386 386 387 -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**.383 +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. 388 388 389 -For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the **Leaf** is 385 +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 390 390 391 -**0229(H) = 549(D) /100 = 54.9.** 387 +(% style="color:blue" %)**0229(H) = 549(D) /100 = 54.9.** 392 392 393 393 394 394 ... ... @@ -395,13 +395,13 @@ 395 395 === 2.4.6 Leaf Temperature === 396 396 397 397 398 -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 **is394 +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 399 399 400 -**Example**: 396 +(% style="color:blue" %)**Example**: 401 401 402 -If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C 398 +If payload is **0105H**: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C 403 403 404 -If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C 400 +If payload is **FF7EH**: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C 405 405 406 406 407 407 ... ... @@ -413,14 +413,15 @@ 413 413 Convert Unix timestamp to time 2022-9-5 9:40:11. 414 414 415 415 412 + 416 416 === 2.4.8 Digital Interrupt === 417 417 418 418 419 -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. 416 +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. 420 420 421 421 The command is: 422 422 423 -**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]])**.** 420 +(% 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]])**.** 424 424 425 425 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. 426 426 ... ... @@ -439,7 +439,7 @@ 439 439 440 440 The 5V output time can be controlled by AT Command. 441 441 442 -**AT+5VT=1000** 439 +(% style="color:blue" %)**AT+5VT=1000** 443 443 444 444 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** ** 445 445 ... ... @@ -453,10 +453,11 @@ 453 453 [[image:image-20220907171221-18.png]] 454 454 455 455 456 -**Examples:** 453 +(% style="color:blue" %)**Examples:** 457 457 458 -* **Set TDC** 459 459 456 +* (% style="color:#037691" %)**Set TDC** 457 + 460 460 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01. 461 461 462 462 Payload: 01 00 00 1E TDC=30S ... ... @@ -463,12 +463,16 @@ 463 463 464 464 Payload: 01 00 00 3C TDC=60S 465 465 466 -* **Reset** 467 467 465 + 466 +* (% style="color:#037691" %)**Reset** 467 + 468 468 If payload = 0x04FF, it will reset the NLMS01 469 469 470 -* **INTMOD** 471 471 471 + 472 +* (% style="color:#037691" %)**INTMOD** 473 + 472 472 Downlink Payload: 06000003, Set AT+INTMOD=3 473 473 474 474 ... ... @@ -485,7 +485,6 @@ 485 485 486 486 487 487 488 - 489 489 == 2.7 Installation == 490 490 491 491 ... ... @@ -499,9 +499,9 @@ 499 499 == 2.8 Moisture and Temperature alarm function == 500 500 501 501 502 -**➢ AT Command:** 503 +(% style="color:blue" %)**➢ AT Command:** 503 503 504 -**AT+ HUMALARM =min,max** 505 +(% style="color:#037691" %)**AT+ HUMALARM =min,max** 505 505 506 506 ² When min=0, and max≠0, Alarm higher than max 507 507 ... ... @@ -510,7 +510,7 @@ 510 510 ² When min≠0 and max≠0, Alarm higher than max or lower than min 511 511 512 512 513 -**Example:** 514 +(% style="color:blue" %)**Example:** 514 514 515 515 AT+ HUMALARM =50,60 ~/~/ Alarm when moisture lower than 50. 516 516 ... ... @@ -523,7 +523,7 @@ 523 523 ² When min≠0 and max≠0, Alarm higher than max or lower than min 524 524 525 525 526 -**Example:** 527 +(% style="color:blue" %)**Example:** 527 527 528 528 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20. 529 529 ... ... @@ -532,24 +532,21 @@ 532 532 == 2.9 Set the number of data to be uploaded and the recording time == 533 533 534 534 535 -**➢ AT Command:** 536 +(% style="color:blue" %)**➢ AT Command:** 536 536 537 -**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) 538 +* (% 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) 539 +* (% 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. 538 538 539 -**AT+NOUD=8** ~/~/ The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 540 540 541 541 542 - 543 543 == 2.10 Read or Clear cached data == 544 544 545 545 546 -**➢ AT Command:** 546 +(% style="color:blue" %)**➢ AT Command:** 547 547 548 -**AT+CDP** ~/~/ Read cached data 548 +* (% style="color:#037691" %)**AT+CDP** (%%) ~/~/ Read cached data 549 +* (% style="color:#037691" %)**AT+CDP=0 ** (%%) ~/~/ Clear cached data 549 549 550 -**AT+CDP=0 ** ~/~/ Clear cached data 551 - 552 - 553 553 [[image:image-20220907171221-20.png]] 554 554 555 555 ... ... @@ -557,9 +557,9 @@ 557 557 == 2.11 Firmware Change Log == 558 558 559 559 560 -Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/ 1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]558 +Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/qdc3js2iu1vlipx/AACMHI3CvVb8g7YQMrIHY673a?dl=0>>https://www.dropbox.com/sh/qdc3js2iu1vlipx/AACMHI3CvVb8g7YQMrIHY673a?dl=0]] 561 561 562 -Upgrade Instruction: [[Upgrade Firmware>> path:#H5.1200BHowtoUpgradeFirmware]]560 +Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]] 563 563 564 564 565 565 ... ... @@ -590,9 +590,9 @@ 590 590 591 591 Instruction to use as below: 592 592 593 -**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 +(% 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/]] 594 594 595 -**Step 2: ** Open it and choose 593 +(% style="color:blue" %)**Step 2: **(%%) Open it and choose 596 596 597 597 * Product Model 598 598 * Uplink Interval ... ... @@ -637,86 +637,86 @@ 637 637 638 638 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]] 639 639 640 -AT+<CMD>? 638 +AT+<CMD>? : Help on <CMD> 641 641 642 -AT+<CMD> :Run <CMD>640 +AT+<CMD> : Run <CMD> 643 643 644 -AT+<CMD>=<value> 642 +AT+<CMD>=<value>: Set the value 645 645 646 -AT+<CMD>=? :Get the value644 +AT+<CMD>=? : Get the value 647 647 648 648 649 -**General Commands** 647 +(% style="color:#037691" %)**General Commands** 650 650 651 -AT :Attention649 +AT : Attention 652 652 653 -AT? :Short Help651 +AT? : Short Help 654 654 655 -ATZ 653 +ATZ : MCU Reset 656 656 657 -AT+TDC 655 +AT+TDC : Application Data Transmission Interval 658 658 659 -AT+CFG 657 +AT+CFG : Print all configurations 660 660 661 -AT+CFGMOD 659 +AT+CFGMOD : Working mode selection 662 662 663 -AT+INTMOD 661 +AT+INTMOD : Set the trigger interrupt mode 664 664 665 -AT+5VT 663 +AT+5VT : Set extend the time of 5V power 666 666 667 -AT+PRO 665 +AT+PRO : Choose agreement 668 668 669 -AT+RXDL :Extend the sending and receiving time667 +AT+RXDL: Extend the sending and receiving time 670 670 671 -AT+SERVADDR 669 +AT+SERVADDR : Server Address 672 672 673 -AT+APN :Get or set the APN671 +AT+APN : Get or set the APN 674 674 675 -AT+FBAND :Get or Set whether to automatically modify the frequency band673 +AT+FBAND : Get or Set whether to automatically modify the frequency band 676 676 677 -AT+DNSCFG 675 +AT+DNSCFG : Get or Set DNS Server 678 678 679 679 AT+GETSENSORVALUE : Returns the current sensor measurement 680 680 681 -AT+TR 679 +AT+TR : Get or Set record time" 682 682 683 -AT+NOUD 681 +AT+NOUD : Get or Set the number of data to be uploaded 684 684 685 -AT+CDP 683 +AT+CDP : Read or Clear cached data 686 686 687 -AT+TEMPALARM 685 +AT+TEMPALARM : Get or Set alarm of temp 688 688 689 -AT+HUMALARM PH687 +AT+HUMALARM : Get or Set alarm of humidity 690 690 691 691 692 -**COAP Management** 690 +(% style="color:#037691" %)**COAP Management** 693 693 694 -AT+URI 692 +AT+URI : Resource parameters 695 695 696 696 697 -**UDP Management** 695 +(% style="color:#037691" %)**UDP Management** 698 698 699 -AT+CFM 697 +AT+CFM : Upload confirmation mode (only valid for UDP) 700 700 701 701 702 -**MQTT Management** 700 +(% style="color:#037691" %)**MQTT Management** 703 703 704 -AT+CLIENT 702 +AT+CLIENT : Get or Set MQTT client 705 705 706 -AT+UNAME 704 +AT+UNAME : Get or Set MQTT Username 707 707 708 -AT+PWD 706 +AT+PWD : Get or Set MQTT password 709 709 710 -AT+PUBTOPIC 708 +AT+PUBTOPIC : Get or Set MQTT publish topic 711 711 712 -AT+SUBTOPIC :Get or Set MQTT subscription topic710 +AT+SUBTOPIC : Get or Set MQTT subscription topic 713 713 714 714 715 -**Information** 713 +(% style="color:#037691" %)**Information** 716 716 717 -AT+FDR :Factory Data Reset715 +AT+FDR : Factory Data Reset 718 718 719 -AT+PWORD 717 +AT+PWORD : Serial Access Password 720 720 721 721 722 722 ... ... @@ -730,10 +730,11 @@ 730 730 731 731 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]] 732 732 733 -**Notice, NLMS01** **and LLMS01** **share the same mother board. They use the same connection and method to update.** 734 734 732 +(% style="color:red" %)**Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.** 735 735 736 736 735 + 737 737 = 6. Trouble Shooting = 738 738 739 739 ... ... @@ -747,7 +747,7 @@ 747 747 == 6.2 AT Command input doesn't work == 748 748 749 749 750 -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. 749 +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. 751 751 752 752 753 753 ... ... @@ -761,11 +761,11 @@ 761 761 = 8. Packing Info = 762 762 763 763 764 -**Package Includes** :763 +(% style="color:#037691" %)**Package Includes:** 765 765 766 766 * NLMS01 NB-IoT Leaf Moisture Sensor x 1 767 767 768 -**Dimension and weight**: 767 +(% style="color:#037691" %)**Dimension and weight**: 769 769 770 770 * Device Size: cm 771 771 * Device Weight: g ... ... @@ -773,8 +773,6 @@ 773 773 * Weight / pcs : g 774 774 775 775 776 - 777 - 778 778 = 9. Support = 779 779 780 780