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)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.David - Content
-
... ... @@ -1,70 +1,78 @@ 1 -(% style="text-align:center" %) 2 -[[image:image-20220907171221-1.jpeg]] 1 +[[image:image-20220907171221-1.jpeg]] 3 3 4 - 5 5 6 -{{toc/}} 7 7 5 += 1. Introduction = 8 8 7 +== 1.1 What is NLMS01 Leaf Moisture Sensor == 9 9 10 -= 1. Introduction = 11 11 10 +The Dragino NLMS01 is a **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. 12 12 13 - ==1.1What isNLMS01 LeafMoistureSensor==12 +NLMS01 detects leaf's** 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. 14 14 15 - 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 - 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 - 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.15 +\\NLMS01 supports different uplink methods include **TCP,MQTT,UDP and CoAP **for different application requirement. 16 +\\NLMS01 is powered by **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) 17 +\\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 **NB-IoT SIM card** from local operator and install NLMS01 to get NB-IoT network connection 24 24 25 - 26 26 [[image:image-20220907171221-2.png]] 27 27 28 - 29 29 [[image:image-20220907171221-3.png]] 30 30 23 +== 1.2 Features == 31 31 25 +* ((( 26 +NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD 27 +))) 28 +* ((( 29 +Monitor Leaf moisture 30 +))) 32 32 33 -== 1.2 Features == 32 +* ((( 33 + Monitor Leaf temperature 34 +))) 34 34 35 - 36 -* NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD 37 -* Monitor Leaf moisture 38 -* Monitor Leaf temperature 39 -* Moisture and Temperature alarm function 40 -* Monitor Battery Level 41 -* Uplink on periodically 42 -* Downlink to change configure 43 -* IP66 Waterproof Enclosure 44 -* IP67 rate for the Sensor Probe 45 -* Ultra-Low Power consumption 46 -* AT Commands to change parameters 47 -* Micro SIM card slot for NB-IoT SIM 48 -* 8500mAh Battery for long term use 49 - 50 -((( 51 - 52 - 53 - 54 - 36 +* ((( 37 +Moisture and Temperature alarm function 55 55 ))) 39 +* ((( 40 +Monitor Battery Level 41 +))) 42 +* ((( 43 +Uplink on periodically 44 +))) 45 +* ((( 46 +Downlink to change configure 47 +))) 48 +* ((( 49 +IP66 Waterproof Enclosure 50 +))) 51 +* ((( 52 +IP67 rate for the Sensor Probe 53 +))) 54 +* ((( 55 +Ultra-Low Power consumption 56 +))) 57 +* ((( 58 +AT Commands to change parameters 59 +))) 60 +* ((( 61 +Micro SIM card slot for NB-IoT SIM 62 +))) 63 +* ((( 64 +8500mAh Battery for long term use 65 +))) 56 56 57 57 == 1.3 Specification == 58 58 69 +**Common DC Characteristics:** 59 59 60 -(% style="color:#037691" %)**Common DC Characteristics:** 61 - 62 62 * Supply Voltage: 2.1v ~~ 3.6v 63 63 * Operating Temperature: -40 ~~ 85°C 64 64 74 +**NB-IoT Spec:** 65 65 66 -(% style="color:#037691" %)**NB-IoT Spec:** 67 - 68 68 * - B1 @H-FDD: 2100MHz 69 69 * - B3 @H-FDD: 1800MHz 70 70 * - B8 @H-FDD: 900MHz ... ... @@ -72,8 +72,6 @@ 72 72 * - B20 @H-FDD: 800MHz 73 73 * - B28 @H-FDD: 700MHz 74 74 75 - 76 - 77 77 == 1.4 Probe Specification == 78 78 79 79 ... ... @@ -113,9 +113,9 @@ 113 113 114 114 [[image:image-20220907171221-5.png]] 115 115 116 -== 2.2 Configure the NLMS01 == 122 +== **2.2 Configure the NLMS01** == 117 117 118 - ===2.2.1 Test Requirement===124 +**2.2.1 Test Requirement** 119 119 120 120 To use NLMS01 in your city, make sure meet below requirements: 121 121 ... ... @@ -127,7 +127,7 @@ 127 127 128 128 [[image:image-20220907171221-6.png]] 129 129 130 - ===2.2.2 Insert SIM card===136 +**2.2.2 Insert SIM card** 131 131 132 132 Insert the NB-IoT Card get from your provider. 133 133 ... ... @@ -135,7 +135,7 @@ 135 135 136 136 [[image:image-20220907171221-7.png]] 137 137 138 - ===2.2.3 Connect USB – TTL to NLMS01 to configure it===144 +**2.2.3 Connect USB – TTL to NLMS01 to configure it** 139 139 140 140 User need to configure NLMS01 via serial port to set the **Server Address** / **Uplink Topic** to define where and how-to uplink packets. NLMS01 support AT Commands, user can use a USB to TTL adapter to connect to NLMS01 and use AT Commands to configure it, as below. 141 141 ... ... @@ -161,7 +161,7 @@ 161 161 162 162 **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]] 163 163 164 - ===2.2.4 Use CoAP protocol to uplink data===170 +**2.2.4 Use CoAP protocol to uplink data** 165 165 166 166 **Note: if you don't have CoAP server, you can refer this link to set up one: **[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]] 167 167 ... ... @@ -179,7 +179,7 @@ 179 179 180 180 [[image:image-20220907171221-10.png]] 181 181 182 - ===2.2.5 Use UDP protocol to uplink data(Default protocol)===188 +**2.2.5 Use UDP protocol to uplink data(Default protocol)** 183 183 184 184 This feature is supported since firmware version v1.0.1 185 185 ... ... @@ -193,7 +193,7 @@ 193 193 194 194 195 195 196 - ===2.2.6 Use MQTT protocol to uplink data===202 +**2.2.6 Use MQTT protocol to uplink data** 197 197 198 198 This feature is supported since firmware version v110 199 199 ... ... @@ -213,7 +213,7 @@ 213 213 214 214 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. 215 215 216 - ===2.2.7 Use TCP protocol to uplink data===222 +**2.2.7 Use TCP protocol to uplink data** 217 217 218 218 This feature is supported since firmware version v110 219 219 ... ... @@ -226,14 +226,15 @@ 226 226 227 227 228 228 229 - ===2.2.8 Change Update Interval===235 +**2.2.8 Change Update Interval** 230 230 231 231 User can use below command to change the **uplink interval**. 232 232 233 -* **AT+TDC= 7200 ** ~/~/ Set Update Interval to7200s(2 hour)239 +* **AT+TDC=600 ** ~/~/ Set Update Interval to 600s 234 234 235 -**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).**241 +**NOTE:** 236 236 243 +**~1. By default, the device will send an uplink message every 2 hour.** 237 237 238 238 == 2.3 Uplink Payload == 239 239 ... ... @@ -250,23 +250,24 @@ 250 250 251 251 The payload is ASCII string, representative same HEX: 252 252 253 -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:260 +0xf86841105675413800640c781701000225010b6315537b010b0226631550fb010e022663154d7701110225631549f1011502246315466b01190223631542e5011d022163153f62011e022163153bde011e022163153859 where: 254 254 255 -* (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138 256 -* (% style="color:blue" %)Version: 0x0064=100=1.0.0 257 -* (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V 258 -* (% style="color:red" %)Singal: 0x17 = 23 259 -* (% style="color:blue" %)Mod: 0x01 = 1 260 -* (% style="color:green" %)Interrupt: 0x00= 0 262 +* Device ID: 0xf868411056754138 = f868411056754138 263 +* Version: 0x0064=100=1.0.0 264 + 265 +* BAT: 0x0c78 = 3192 mV = 3.192V 266 +* Singal: 0x17 = 23 267 +* Mod: 0x01 = 1 268 +* Interrupt: 0x00= 0 261 261 * Leaf moisture: 0x0225= 549 = 54.9% 262 262 * Leaf Temperature:0x010B =267=26.7 °C 263 -* Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]])271 +* Time stamp : 0x6315537b =1662342011 264 264 * Leaf Temperature, Leaf moisture,Time stamp : 010b0226631550fb 265 -* (% style="color:blue" %)8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,.......273 +* 8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,....... 266 266 267 267 == 2.4 Payload Explanation and Sensor Interface == 268 268 269 - ===2.4.1 Device ID===277 +**2.4.1 Device ID** 270 270 271 271 By default, the Device ID equal to the last 15 bits of IMEI. 272 272 ... ... @@ -278,13 +278,13 @@ 278 278 279 279 The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 280 280 281 - ===2.4.2 Version Info===289 +**2.4.2 Version Info** 282 282 283 283 Specify the software version: 0x64=100, means firmware version 1.00. 284 284 285 285 For example: 0x00 64 : this device is NLMS01 with firmware version 1.0.0. 286 286 287 - ===2.4.3 Battery Info===295 +**2.4.3 Battery Info** 288 288 289 289 Check the battery voltage for NLMS01. 290 290 ... ... @@ -292,7 +292,7 @@ 292 292 293 293 Ex2: 0x0B49 = 2889mV 294 294 295 - ===2.4.4 Signal Strength===303 +**2.4.4 Signal Strength** 296 296 297 297 NB-IoT Network signal Strength. 298 298 ... ... @@ -308,7 +308,7 @@ 308 308 309 309 **99** Not known or not detectable 310 310 311 - ===2.4.5 Leaf moisture===319 +**2.4.5 Leaf** moisture 312 312 313 313 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**. 314 314 ... ... @@ -316,7 +316,7 @@ 316 316 317 317 **0229(H) = 549(D) /100 = 54.9.** 318 318 319 - ===2.4.6 Leaf Temperature===327 +**2.4.6 Leaf Temperature** 320 320 321 321 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 322 322 ... ... @@ -326,13 +326,13 @@ 326 326 327 327 If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C 328 328 329 - ===2.4.7 Timestamp===337 +**2.4.7 Timestamp** 330 330 331 331 Time stamp : 0x6315537b =1662342011 332 332 333 333 Convert Unix timestamp to time 2022-9-5 9:40:11. 334 334 335 - ===2.4.8 Digital Interrupt===343 +**2.4.8 Digital Interrupt** 336 336 337 337 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. 338 338 ... ... @@ -348,7 +348,7 @@ 348 348 349 349 0x(01): Interrupt Uplink Packet. 350 350 351 - ===2.4.9 +5V Output===359 +**2.4.9 +5V Output** 352 352 353 353 NLMS01 will enable +5V output before all sampling and disable the +5v after all sampling. 354 354 ... ... @@ -455,7 +455,7 @@ 455 455 456 456 == 2.12 Battery Analysis == 457 457 458 - ===2.12.1 Battery Type===466 +**2.12.1 Battery Type** 459 459 460 460 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. 461 461 ... ... @@ -469,7 +469,7 @@ 469 469 470 470 [[image:image-20220907171221-21.png]] 471 471 472 - ===2.12.2 Power consumption Analyze===480 +**2.12.2 Power consumption Analyze** 473 473 474 474 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. 475 475 ... ... @@ -487,11 +487,11 @@ 487 487 488 488 [[image:image-20220907171221-22.jpeg]] 489 489 490 - ===2.12.3 Battery Note===498 +**2.12.3 Battery Note** 491 491 492 492 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. 493 493 494 - ===2.12.4 Replace the battery===502 +**2.12.4 Replace the battery** 495 495 496 496 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). 497 497 ... ... @@ -505,7 +505,7 @@ 505 505 506 506 = 4. Using the AT Commands = 507 507 508 - ==4.1 Access AT Commands==516 +**4.1 Access AT Commands** 509 509 510 510 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]] 511 511 ... ... @@ -541,20 +541,15 @@ 541 541 542 542 AT+SERVADDR : Server Address 543 543 544 -AT+APN : Get or set the APN 545 - 546 -AT+FBAND : Get or Set whether to automatically modify the frequency band 547 - 548 -AT+DNSCFG : Get or Set DNS Server 549 - 550 -AT+GETSENSORVALUE : Returns the current sensor measurement 551 - 552 552 AT+TR : Get or Set record time" 553 553 554 + 554 554 AT+NOUD : Get or Set the number of data to be uploaded 555 555 557 + 556 556 AT+CDP : Read or Clear cached data 557 557 560 + 558 558 AT+TEMPALARM : Get or Set alarm of temp 559 559 560 560 AT+HUMALARM : Get or Set alarm of PH ... ... @@ -588,7 +588,7 @@ 588 588 589 589 = 5. FAQ = 590 590 591 - ==5.1 How to Upgrade Firmware==594 +**5.1 How to Upgrade Firmware** 592 592 593 593 User can upgrade the firmware for 1) bug fix, 2) new feature release. 594 594 ... ... @@ -598,11 +598,11 @@ 598 598 599 599 = 6. Trouble Shooting = 600 600 601 - ==6.1 Connection problem when uploading firmware==604 +**6.1 Connection problem when uploading firmware** 602 602 603 603 **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]] 604 604 605 - ==6.2 AT Command input doesn't work==608 +**6.2 AT Command input doesn't work** 606 606 607 607 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. 608 608 ... ... @@ -629,3 +629,5 @@ 629 629 * 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]] 630 630 631 631 635 + 636 +