Changes for page NLMS01-NB-IoT Leaf Moisture Sensor User Manual

Last modified by Mengting Qiu on 2024/04/02 16:54

From version < 38.21 >

edited by Xiaoling
on 2023/05/24 10:04

To version < 33.8 >

edited by Xiaoling
on 2022/09/23 17:18

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Attachments (0 modified, 0 added, 1 removed)
- image-20221009001002-1.png

Details

Page properties

Content

@@ -9,24 +9,20 @@
  = 1.  Introduction =
++
  == 1.1  What is NLMS01 Leaf Moisture Sensor ==
--(((
  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.
  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.
  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.
++\\NLMS01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
++\\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).
++\\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.
--NLMS01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
--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).
--
--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.
--)))
--
--
  [[image:image-20220907171221-2.png]]
@@ -33,6 +33,7 @@
   [[image:image-20220907171221-3.png]]
++
  == 1.2  Features ==
@@ -53,6 +53,7 @@
  (((
++
  )))
@@ -66,13 +66,15 @@
  (% style="color:#037691" %)**NB-IoT Spec:**
--* B1 @H-FDD: 2100MHz
--* B3 @H-FDD: 1800MHz
--* B8 @H-FDD: 900MHz
--* B5 @H-FDD: 850MHz
--* B20 @H-FDD: 800MHz
--* B28 @H-FDD: 700MHz
++* - B1 @H-FDD: 2100MHz
++* - B3 @H-FDD: 1800MHz
++* - B8 @H-FDD: 900MHz
++* - B5 @H-FDD: 850MHz
++* - B20 @H-FDD: 800MHz
++* - B28 @H-FDD: 700MHz
++
++
  == 1.4  Probe Specification ==
@@ -92,11 +92,15 @@
  * IP67 Protection
  * Length: 3.5 meters
++
++
  == 1.5  Applications ==
  * Smart Agriculture
++
++
  == 1.6  Pin mapping and power on ==
@@ -104,8 +104,10 @@
  **~ **
++
  = 2.  Use NLMS01 to communicate with IoT Server =
++
  == 2.1  How it works ==
@@ -117,8 +117,10 @@
  [[image:image-20220907171221-5.png]]
++
  == 2.2  Configure the NLMS01 ==
++
  === 2.2.1  Test Requirement ===
@@ -134,6 +134,7 @@
  [[image:image-20220907171221-6.png]]
++
  === 2.2.2  Insert SIM card ===
@@ -145,6 +145,7 @@
  [[image:image-20220907171221-7.png]]
++
  === 2.2.3  Connect USB – TTL to NLMS01 to configure it ===
@@ -176,6 +176,7 @@
  (% 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]]
++
  === 2.2.4  Use CoAP protocol to uplink data ===
@@ -198,6 +198,7 @@
  [[image:image-20220907171221-10.png]]
++
  === 2.2.5  Use UDP protocol to uplink data(Default protocol) ===
@@ -214,6 +214,7 @@
++
  === 2.2.6  Use MQTT protocol to uplink data ===
@@ -238,6 +238,7 @@
  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.
++
  === 2.2.7  Use TCP protocol to uplink data ===
@@ -265,6 +265,7 @@
  (% 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).**
++
  == 2.3  Uplink Payload ==
@@ -273,9 +273,9 @@
  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.
--(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)
--|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**Size(bytes)**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**8**|(% style="background-color:#d9e2f3; color:#0070c0; width:20px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:20px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:30px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**1**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**4**|(% style="background-color:#d9e2f3; color:#0070c0; width:50px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**2**|(% style="background-color:#d9e2f3; color:#0070c0; width:40px" %)**4**
--|(% 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  .....
++(% border="1" style="background-color:#ffffcc; color:green; width:1251px" %)
++|(% 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
++|(% 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  .....
  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data.
@@ -289,30 +289,23 @@
  where:
--* (% style="color:#037691" %)**Device ID:**(%%) 0xf868411056754138 = f868411056754138
++* Device ID: 0xf868411056754138 = f868411056754138
++* Version: 0x0064=100=1.0.0
++* BAT: 0x0c78 = 3192 mV = 3.192V
++* Singal: 0x17 = 23
++* Mod: 0x01 = 1
++* Interrupt: 0x00= 0
++* Leaf moisture: 0x0225= 549 = 54.9%
++* Leaf Temperature:0x010B =267=26.7 °C
++* Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]])
++* Leaf Temperature, Leaf moisture,Time stamp : 010b0226631550fb
++* 8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,.......
--* (% style="color:#037691" %)**Version:**(%%) 0x0064=100=1.0.0
--* (% style="color:#037691" %)**BAT:**       (%%)0x0c78 = 3192 mV = 3.192V
--* (% style="color:#037691" %)**Singal:**(%%)   0x17 = 23
--
--* (% style="color:#037691" %)**Mod:**(%%)  0x01 = 1
--
--* (% style="color:#037691" %)**Interrupt:**(%%) 0x00= 0
--
--* (% style="color:#037691" %)**Leaf moisture:**(%%) 0x0225= 549 = 54.9%
--
--* (% style="color:#037691" %)**Leaf Temperature: **(%%)0x010B =267=26.7 °C
--
--* (% style="color:#037691" %)**Time stamp :**   (%%)0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]])
--
--* (% style="color:#037691" %)**Leaf Temperature, Leaf moisture,Time stamp :  **(%%)010b0226631550fb
--
--* (% style="color:#037691" %)**8 sets of recorded data: **(%%)Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,.......
--
  == 2.4  Payload Explanation and Sensor Interface ==
++
  === 2.4.1  Device ID ===
@@ -328,6 +328,7 @@
  The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
++
  === 2.4.2  Version Info ===
@@ -336,6 +336,7 @@
  For example: 0x00 64 : this device is NLMS01 with firmware version 1.0.0.
++
  === 2.4.3  Battery Info ===
@@ -346,6 +346,7 @@
  Ex2: 0x0B49 = 2889mV
++
  === 2.4.4  Signal Strength ===
@@ -365,6 +365,7 @@
  **99**      Not known or not detectable
++
  === 2.4.5  Leaf moisture ===
@@ -375,6 +375,7 @@
  (% style="color:blue" %)**0229(H) = 549(D) /100 = 54.9.**
++
  === 2.4.6  Leaf Temperature ===
@@ -387,6 +387,7 @@
  If payload is **FF7EH**: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
++
  === 2.4.7  Timestamp ===
@@ -395,6 +395,7 @@
  Convert Unix timestamp to time 2022-9-5 9:40:11.
++
  === 2.4.8  Digital Interrupt ===
@@ -413,6 +413,7 @@
 x(01): Interrupt Uplink Packet.
++
  === 2.4.9  +5V Output ===
@@ -425,18 +425,14 @@
  Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** **
++
  == 2.5  Downlink Payload ==
  By default, NLMS01 prints the downlink payload to console port.
--(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:479.818px" %)
--|=(% style="width: 183px; background-color:#D9E2F3;color:#0070C0" %)**Downlink Control Type**|=(% style="width: 55px; background-color:#D9E2F3;color:#0070C0" %)FPort|=(% style="width: 93px; background-color:#D9E2F3;color:#0070C0" %)**Type Code**|=(% style="width: 146px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)**Downlink payload size(bytes)**
--|(% style="width:183px" %)TDC (Transmit Time Interval)|(% style="width:55px" %)Any|(% style="width:93px" %)01|(% style="width:146px" %)4
--|(% style="width:183px" %)RESET|(% style="width:55px" %)Any|(% style="width:93px" %)04|(% style="width:146px" %)2
--|(% style="width:183px" %)INTMOD|(% style="width:55px" %)Any|(% style="width:93px" %)06|(% style="width:146px" %)4
++[[image:image-20220907171221-18.png]]
--
  (% style="color:blue" %)**Examples:**
@@ -462,6 +462,7 @@
  Downlink Payload: 06000003, Set AT+INTMOD=3
++
  == 2.6  LED Indicator ==
@@ -472,6 +472,8 @@
  * After NLMS01 join NB-IoT network. The LED will be ON for 3 seconds.
  * For each uplink probe, LED will be on for 500ms.
++
++
  == 2.7  Installation ==
@@ -481,6 +481,7 @@
  [[image:image-20220907171221-19.png]]
++
  == 2.8  Moisture and Temperature alarm function ==
@@ -513,6 +513,7 @@
  AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
++
  == 2.9  Set the number of data to be uploaded and the recording time ==
@@ -521,11 +521,8 @@
  * (% 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)
  * (% 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.
-- The diagram below explains the relationship between TR, NOUD, and TDC more clearly**:**
--[[image:image-20221009001002-1.png||height="706" width="982"]]
--
  == 2.10  Read or Clear cached data ==
@@ -537,6 +537,7 @@
  [[image:image-20220907171221-20.png]]
++
  == 2.11  Firmware Change Log ==
@@ -545,14 +545,61 @@
  Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
--== 2.12 Battery & Power Consumption ==
++== 2.12  Battery Analysis ==
--NLMS01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
--[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
++=== 2.12.1  Battery Type ===
++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.
++
++The battery is designed to last for several years depends on the actually use environment and update interval.
++
++The battery related documents as below:
++
++* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
++* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
++* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
++
++[[image:image-20220907171221-21.png]]
++
++
++
++=== 2.12.2  Power consumption Analyze ===
++
++
++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.
++
++Instruction to use as below:
++
++(% 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/]]
++
++(% style="color:blue" %)**Step 2: **(%%) Open it and choose
++
++* Product Model
++* Uplink Interval
++* Working Mode
++
++And the Life expectation in difference case will be shown on the right.
++
++[[image:image-20220907171221-22.jpeg]]
++
++
++=== 2.12.3  Battery Note ===
++
++
++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.
++
++
++
++=== 2.12.4  Replace the battery ===
++
++
++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).
++
++
++
  = 3.  Access NB-IoT Module =
@@ -564,97 +564,101 @@
  [[image:image-20220907171221-23.png]]
++
  = 4.  Using the AT Commands =
++
  == 4.1  Access AT Commands ==
  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]]
--AT+<CMD>?    :  Help on <CMD>
++AT+<CMD>?                    : Help on <CMD>
--AT+<CMD>   :    Run <CMD>
++AT+<CMD>                      : Run <CMD>
--AT+<CMD>=<value>:  Set the value
++AT+<CMD>=<value>      : Set the value
--AT+<CMD>=?     :        Get the value
++AT+<CMD>=?                  : Get the value
  (% style="color:#037691" %)**General Commands**
--AT    :     Attention
++AT                            : Attention
--AT?   :    Short Help
++AT?                           : Short Help
--ATZ    :   MCU Reset
++ATZ                          : MCU Reset
--AT+TDC   :  Application Data Transmission Interval
++AT+TDC                   : Application Data Transmission Interval
--AT+CFG   :  Print all configurations
++AT+CFG                   : Print all configurations
--AT+CFGMOD  :   Working mode selection
++AT+CFGMOD           : Working mode selection
--AT+INTMOD  :    Set the trigger interrupt mode
++AT+INTMOD            : Set the trigger interrupt mode
--AT+5VT  :   Set extend the time of 5V power
++AT+5VT                     : Set extend the time of 5V power
--AT+PRO :   Choose agreement
++AT+PRO                    : Choose agreement
--AT+RXDL:   Extend the sending and receiving time
++AT+RXDL                   : Extend the sending and receiving time
--AT+SERVADDR :   Server Address
++AT+SERVADDR          : Server Address
--AT+APN :         Get or set the APN
++AT+APN            : Get or set the APN
--AT+FBAND :    Get or Set whether to automatically modify the frequency band
++AT+FBAND          : Get or Set whether to automatically modify the frequency band
--AT+DNSCFG :  Get or Set DNS Server
++AT+DNSCFG         :  Get or Set DNS Server
  AT+GETSENSORVALUE   : Returns the current sensor measurement
--AT+TR :             Get or Set record time"
++AT+TR      : Get or Set record time"
--AT+NOUD :      Get or Set the number of data to be uploaded
++AT+NOUD      : Get or Set the number of data to be uploaded
--AT+CDP :          Read or Clear cached data
++AT+CDP     : Read or Clear cached data
--AT+TEMPALARM :  Get or Set alarm of temp
++AT+TEMPALARM      : Get or Set alarm of temp
--AT+HUMALARM :  Get or Set alarm of humidity
++AT+HUMALARM     : Get or Set alarm of humidity
  (% style="color:#037691" %)**COAP Management**
--AT+URI :    Resource parameters
++AT+URI            : Resource parameters
  (% style="color:#037691" %)**UDP Management**
--AT+CFM :  Upload confirmation mode (only valid for UDP)
++AT+CFM          : Upload confirmation mode (only valid for UDP)
  (% style="color:#037691" %)**MQTT Management**
--AT+CLIENT  :   Get or Set MQTT client
++AT+CLIENT               : Get or Set MQTT client
--AT+UNAME  : Get or Set MQTT Username
++AT+UNAME             : Get or Set MQTT Username
--AT+PWD   :    Get or Set MQTT password
++AT+PWD                  : Get or Set MQTT password
--AT+PUBTOPIC  :   Get or Set MQTT publish topic
++AT+PUBTOPIC          : Get or Set MQTT publish topic
--AT+SUBTOPIC :    Get or Set MQTT subscription topic
++AT+SUBTOPIC          : Get or Set MQTT subscription topic
  (% style="color:#037691" %)**Information**
--AT+FDR :          Factory Data Reset
++AT+FDR              : Factory Data Reset
--AT+PWORD :   Serial Access Password
++AT+PWORD       : Serial Access Password
++
  = 5.  FAQ =
++
  == 5.1  How to Upgrade Firmware ==
@@ -666,8 +666,10 @@
  (% style="color:red" %)**Notice, NLMS01 and LLMS01 share the same mother board. They use the same connection and method to update.**
++
  = 6.  Trouble Shooting =
++
  == 6.1  Connection problem when uploading firmware ==
@@ -674,6 +674,7 @@
  **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]]
++
  == 6.2  AT Command input doesn't work ==
@@ -680,12 +680,7 @@
  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.
--== 6.3  Not able to connect to NB-IoT network and keep showing "Signal Strength:99". ==
--
--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]]//**.
--
--
  = 7.  Order Info =
@@ -692,6 +692,7 @@
  Part Number**:** NLMS01
++
  = 8.  Packing Info =
@@ -706,6 +706,7 @@
  * Package Size / pcs : cm
  * Weight / pcs : g
++
  = 9.  Support =

image-20221009001002-1.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.Edwin

Size

...	...	@@ -1,1 +1,0 @@
1		-282.9 KB

Content

Changes for page NLMS01-NB-IoT Leaf Moisture Sensor User Manual

Summary

Details

Applications

Navigation