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,8 +71,6 @@ 71 71 * - B20 @H-FDD: 800MHz 72 72 * - B28 @H-FDD: 700MHz 73 73 74 - 75 - 76 76 == 1.4 Probe Specification == 77 77 78 78 ... ... @@ -92,15 +92,11 @@ 92 92 * IP67 Protection 93 93 * Length: 3.5 meters 94 94 95 - 96 - 97 97 == 1.5 Applications == 98 98 99 99 100 100 * Smart Agriculture 101 101 102 - 103 - 104 104 == 1.6 Pin mapping and power on == 105 105 106 106 ... ... @@ -199,6 +199,8 @@ 199 199 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683 ** (%%) ~/~/ to set CoAP server address and port 200 200 * (% style="color:#037691" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/ Set COAP resource path 201 201 196 + 197 + 202 202 For parameter description, please refer to AT command set 203 203 204 204 [[image:image-20220907171221-9.png]] ... ... @@ -216,9 +216,11 @@ 216 216 This feature is supported since firmware version v1.0.1 217 217 218 218 * (% style="color:#037691" %)**AT+PRO=2 ** (%%) ~/~/ Set to use UDP protocol to uplink 219 -* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601 215 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601 ** (%%) ~/~/ to set UDP server address and port 220 220 * (% style="color:#037691" %)**AT+CFM=1 ** (%%) ~/~/ If the server does not respond, this command is unnecessary 221 221 218 + 219 + 222 222 [[image:image-20220907171221-11.png]] 223 223 224 224 ... ... @@ -240,6 +240,8 @@ 240 240 * (% style="color:#037691" %)**AT+PUBTOPIC=PUB ** (%%) ~/~/ Set the sending topic of MQTT 241 241 * (% style="color:#037691" %)**AT+SUBTOPIC=SUB ** (%%) ~/~/ Set the subscription topic of MQTT 242 242 241 + 242 + 243 243 [[image:image-20220907171221-13.png]] 244 244 245 245 ... ... @@ -260,6 +260,8 @@ 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 + 263 263 [[image:image-20220907171221-15.png]] 264 264 265 265 ... ... @@ -276,6 +276,8 @@ 276 276 277 277 * (% style="color:#037691" %)**AT+TDC=7200 ** (%%) ~/~/ Set Update Interval to 7200s (2 hour) 278 278 281 + 282 + 279 279 (% 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).** 280 280 281 281 ... ... @@ -292,6 +292,7 @@ 292 292 |(% 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 293 293 |(% 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 ..... 294 294 299 + 295 295 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data. 296 296 297 297 ... ... @@ -300,24 +300,24 @@ 300 300 301 301 The payload is ASCII string, representative same HEX: 302 302 303 - **0x__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__//(%%)**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: 304 304 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 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 313 313 * Leaf moisture: 0x0225= 549 = 54.9% 314 314 * Leaf Temperature:0x010B =267=26.7 °C 315 315 * Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]]) 316 316 * Leaf Temperature, Leaf moisture,Time stamp : 010b0226631550fb 317 -* 8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,....... 320 +* (% style="color:blue" %)8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,....... 318 318 319 319 320 320 324 + 325 + 321 321 == 2.4 Payload Explanation and Sensor Interface == 322 322 323 323 ... ... @@ -326,10 +326,10 @@ 326 326 327 327 By default, the Device ID equal to the last 15 bits of IMEI. 328 328 329 -User can use (% style="color:#037691" %)**AT+DEUI**(%%)to set Device ID334 +User can use **AT+DEUI** to set Device ID 330 330 331 331 332 - (% style="color:blue" %)**Example**:337 +**Example:** 333 333 334 334 AT+DEUI=868411056754138 335 335 ... ... @@ -362,9 +362,8 @@ 362 362 363 363 NB-IoT Network signal Strength. 364 364 370 +**Ex1: 0x1d = 29** 365 365 366 -(% style="color:blue" %)**Ex1: 0x1d = 29** 367 - 368 368 **0** -113dBm or less 369 369 370 370 **1** -111dBm ... ... @@ -380,11 +380,11 @@ 380 380 === 2.4.5 Leaf moisture === 381 381 382 382 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.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**. 384 384 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**(%%)is389 +For example, if the data you get from the register is **__0x05 0xDC__**, the moisture content in the **Leaf** is 386 386 387 - (% style="color:blue" %)**0229(H) = 549(D) /100 = 54.9.**391 +**0229(H) = 549(D) /100 = 54.9.** 388 388 389 389 390 390 ... ... @@ -391,13 +391,13 @@ 391 391 === 2.4.6 Leaf Temperature === 392 392 393 393 394 -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 **(%%)is398 +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 395 395 396 - (% style="color:blue" %)**Example**:400 +**Example**: 397 397 398 -If payload is **0105H**: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C402 +If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C 399 399 400 -If payload is **FF7EH**: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C404 +If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C 401 401 402 402 403 403 ... ... @@ -409,15 +409,14 @@ 409 409 Convert Unix timestamp to time 2022-9-5 9:40:11. 410 410 411 411 412 - 413 413 === 2.4.8 Digital Interrupt === 414 414 415 415 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.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. 417 417 418 418 The command is: 419 419 420 - (% style="color:blue" %)**AT+INTMOD=3 **(%%)~/~/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]])**.** 421 421 422 422 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. 423 423 ... ... @@ -436,7 +436,7 @@ 436 436 437 437 The 5V output time can be controlled by AT Command. 438 438 439 - (% style="color:blue" %)**AT+5VT=1000**442 +**AT+5VT=1000** 440 440 441 441 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** ** 442 442 ... ... @@ -450,11 +450,10 @@ 450 450 [[image:image-20220907171221-18.png]] 451 451 452 452 453 - (% style="color:blue" %)**Examples:**456 +**Examples:** 454 454 458 +* **Set TDC** 455 455 456 -* (% style="color:#037691" %)**Set TDC** 457 - 458 458 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01. 459 459 460 460 Payload: 01 00 00 1E TDC=30S ... ... @@ -461,16 +461,12 @@ 461 461 462 462 Payload: 01 00 00 3C TDC=60S 463 463 466 +* **Reset** 464 464 465 - 466 -* (% style="color:#037691" %)**Reset** 467 - 468 468 If payload = 0x04FF, it will reset the NLMS01 469 469 470 +* **INTMOD** 470 470 471 - 472 -* (% style="color:#037691" %)**INTMOD** 473 - 474 474 Downlink Payload: 06000003, Set AT+INTMOD=3 475 475 476 476 ... ... @@ -487,6 +487,7 @@ 487 487 488 488 489 489 488 + 490 490 == 2.7 Installation == 491 491 492 492 ... ... @@ -500,9 +500,9 @@ 500 500 == 2.8 Moisture and Temperature alarm function == 501 501 502 502 503 - (% style="color:blue" %)**➢ AT Command:**502 +**➢ AT Command:** 504 504 505 - (% style="color:#037691" %)**AT+ HUMALARM =min,max**504 +**AT+ HUMALARM =min,max** 506 506 507 507 ² When min=0, and max≠0, Alarm higher than max 508 508 ... ... @@ -511,7 +511,7 @@ 511 511 ² When min≠0 and max≠0, Alarm higher than max or lower than min 512 512 513 513 514 - (% style="color:blue" %)**Example:**513 +**Example:** 515 515 516 516 AT+ HUMALARM =50,60 ~/~/ Alarm when moisture lower than 50. 517 517 ... ... @@ -524,7 +524,7 @@ 524 524 ² When min≠0 and max≠0, Alarm higher than max or lower than min 525 525 526 526 527 - (% style="color:blue" %)**Example:**526 +**Example:** 528 528 529 529 AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20. 530 530 ... ... @@ -533,21 +533,24 @@ 533 533 == 2.9 Set the number of data to be uploaded and the recording time == 534 534 535 535 536 - (% style="color:blue" %)**➢ AT Command:**535 +**➢ AT Command:** 537 537 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. 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) 540 540 539 +**AT+NOUD=8** ~/~/ The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 541 541 542 542 542 + 543 543 == 2.10 Read or Clear cached data == 544 544 545 545 546 - (% style="color:blue" %)**➢ AT Command:**546 +**➢ AT Command:** 547 547 548 -* (% style="color:#037691" %)**AT+CDP** (%%) ~/~/ Read cached data 549 -* (% style="color:#037691" %)**AT+CDP=0 ** (%%) ~/~/ Clear cached data 548 +**AT+CDP** ~/~/ Read cached data 550 550 550 +**AT+CDP=0 ** ~/~/ Clear cached data 551 + 552 + 551 551 [[image:image-20220907171221-20.png]] 552 552 553 553 ... ... @@ -555,9 +555,9 @@ 555 555 == 2.11 Firmware Change Log == 556 556 557 557 558 -Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/ qdc3js2iu1vlipx/AACMHI3CvVb8g7YQMrIHY673a?dl=0>>https://www.dropbox.com/sh/qdc3js2iu1vlipx/AACMHI3CvVb8g7YQMrIHY673a?dl=0]]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]] 559 559 560 -Upgrade Instruction: [[Upgrade Firmware>> ||anchor="H5.1200BHowtoUpgradeFirmware"]]562 +Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]] 561 561 562 562 563 563 ... ... @@ -588,9 +588,9 @@ 588 588 589 589 Instruction to use as below: 590 590 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/]]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/]] 592 592 593 - (% style="color:blue" %)**Step 2: **(%%)Open it and choose595 +**Step 2: ** Open it and choose 594 594 595 595 * Product Model 596 596 * Uplink Interval ... ... @@ -644,7 +644,7 @@ 644 644 AT+<CMD>=? : Get the value 645 645 646 646 647 - (% style="color:#037691" %)**General Commands**649 +**General Commands** 648 648 649 649 AT : Attention 650 650 ... ... @@ -687,17 +687,17 @@ 687 687 AT+HUMALARM : Get or Set alarm of PH 688 688 689 689 690 - (% style="color:#037691" %)**COAP Management**692 +**COAP Management** 691 691 692 692 AT+URI : Resource parameters 693 693 694 694 695 - (% style="color:#037691" %)**UDP Management**697 +**UDP Management** 696 696 697 697 AT+CFM : Upload confirmation mode (only valid for UDP) 698 698 699 699 700 - (% style="color:#037691" %)**MQTT Management**702 +**MQTT Management** 701 701 702 702 AT+CLIENT : Get or Set MQTT client 703 703 ... ... @@ -710,7 +710,7 @@ 710 710 AT+SUBTOPIC : Get or Set MQTT subscription topic 711 711 712 712 713 - (% style="color:#037691" %)**Information**715 +**Information** 714 714 715 715 AT+FDR : Factory Data Reset 716 716 ... ... @@ -728,11 +728,10 @@ 728 728 729 729 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]] 730 730 733 +**Notice, NLMS01** **and LLMS01** **share the same mother board. They use the same connection and method to update.** 731 731 732 -(% style="color:red" %)**Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.** 733 733 734 734 735 - 736 736 = 6. Trouble Shooting = 737 737 738 738 ... ... @@ -746,7 +746,7 @@ 746 746 == 6.2 AT Command input doesn't work == 747 747 748 748 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.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. 750 750 751 751 752 752 ... ... @@ -760,11 +760,11 @@ 760 760 = 8. Packing Info = 761 761 762 762 763 - (% style="color:#037691" %)**Package Includes:**764 +**Package Includes**: 764 764 765 765 * NLMS01 NB-IoT Leaf Moisture Sensor x 1 766 766 767 - (% style="color:#037691" %)**Dimension and weight**:768 +**Dimension and weight**: 768 768 769 769 * Device Size: cm 770 770 * Device Weight: g ... ... @@ -772,6 +772,8 @@ 772 772 * Weight / pcs : g 773 773 774 774 776 + 777 + 775 775 = 9. Support = 776 776 777 777