Last modified by Mengting Qiu on 2024/04/02 16:54
<
From version < 30.1 >
edited by Edwin Chen
on 2022/09/08 00:23
To version < 33.2 >
edited by Xiaoling
on 2022/09/13 09:14
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Xiaoling
Content
... ... @@ -7,76 +7,62 @@
7 7  
8 8  
9 9  
10 -= 1. Introduction =
10 += 1.  Introduction =
11 11  
12 -== 1.1 ​What is NLMS01 Leaf Moisture Sensor ==
13 13  
13 +== 1.1 ​ What is NLMS01 Leaf Moisture Sensor ==
14 14  
15 -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.
16 16  
17 -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.
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.
18 18  
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 +
19 19  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.
20 -\\NLMS01 supports different uplink methods include **TCP,MQTT,UDP and CoAP  **for different application requirement.
21 -\\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)
22 -\\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
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.
23 23  
25 +
24 24  ​[[image:image-20220907171221-2.png]]
25 25  
28 +
26 26  ​ [[image:image-20220907171221-3.png]]
27 27  
28 -== ​1.2 Features ==
29 29  
30 -* (((
31 -NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
32 -)))
33 -* (((
34 -Monitor Leaf moisture
35 -)))
36 36  
37 -* (((
38 - Monitor Leaf temperature
39 -)))
33 +== ​1.2  Features ==
40 40  
41 -* (((
42 -Moisture and Temperature alarm function
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 +
43 43  )))
44 -* (((
45 -Monitor Battery Level
46 -)))
47 -* (((
48 -Uplink on periodically
49 -)))
50 -* (((
51 -Downlink to change configure
52 -)))
53 -* (((
54 -IP66 Waterproof Enclosure
55 -)))
56 -* (((
57 -IP67 rate for the Sensor Probe
58 -)))
59 -* (((
60 -Ultra-Low Power consumption
61 -)))
62 -* (((
63 -AT Commands to change parameters
64 -)))
65 -* (((
66 -Micro SIM card slot for NB-IoT SIM
67 -)))
68 -* (((
69 -8500mAh Battery for long term use
70 -)))
71 71  
72 72  == 1.3  Specification ==
73 73  
74 -**Common DC Characteristics:**
75 75  
60 +(% style="color:#037691" %)**Common DC Characteristics:**
61 +
76 76  * Supply Voltage: 2.1v ~~ 3.6v
77 77  * Operating Temperature: -40 ~~ 85°C
78 78  
79 -**NB-IoT Spec:**
65 +(% style="color:#037691" %)**NB-IoT Spec:**
80 80  
81 81  * - B1 @H-FDD: 2100MHz
82 82  * - B3 @H-FDD: 1800MHz
... ... @@ -85,10 +85,10 @@
85 85  * - B20 @H-FDD: 800MHz
86 86  * - B28 @H-FDD: 700MHz
87 87  
88 -== 1.4 Probe Specification ==
74 +== 1.4  Probe Specification ==
89 89  
90 90  
91 -**Leaf Moisture: percentage of water drop over total leaf surface**
77 +(% style="color:#037691" %)**Leaf Moisture: percentage of water drop over total leaf surface**
92 92  
93 93  * Range 0-100%
94 94  * Resolution: 0.1%
... ... @@ -96,7 +96,7 @@
96 96  * IP67 Protection
97 97  * Length: 3.5 meters
98 98  
99 -**Leaf Temperature:**
85 +(% style="color:#037691" %)**Leaf Temperature:**
100 100  
101 101  * Range -50℃～80℃
102 102  * Resolution: 0.1℃
... ... @@ -104,30 +104,40 @@
104 104  * IP67 Protection
105 105  * Length: 3.5 meters
106 106  
107 -== 1.5 ​Applications ==
93 +== 1.5 ​ Applications ==
108 108  
95 +
109 109  * Smart Agriculture
110 110  
111 -== 1.6 Pin mapping and power on ==
98 +== 1.6  Pin mapping and power on ==
112 112  
100 +
113 113  ​[[image:image-20220907171221-4.png]]
114 114  
115 115  **~ **
116 116  
105 +
117 117  = 2.  Use NLMS01 to communicate with IoT Server =
118 118  
108 +
119 119  == 2.1  How it works ==
120 120  
111 +
121 121  The NLMS01 is equipped with a NB-IoT module, the pre-loaded firmware in NLMS01 will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module.  The NB-IoT network will forward this value to IoT server via the protocol defined by NLMS01.
122 122  
123 123  The diagram below shows the working flow in default firmware of NLMS01:
124 124  
116 +
125 125  [[image:image-20220907171221-5.png]]
126 126  
119 +
120 +
127 127  == 2.2 ​ Configure the NLMS01 ==
128 128  
123 +
129 129  === 2.2.1 Test Requirement ===
130 130  
126 +
131 131  To use NLMS01 in your city, make sure meet below requirements:
132 132  
133 133  * Your local operator has already distributed a NB-IoT Network there.
... ... @@ -134,90 +134,120 @@
134 134  * The local NB-IoT network used the band that NLMS01 supports.
135 135  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
136 136  
137 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NLMS01 will use CoAP(120.24.4.116:5683) or raw UDP(120.24.4.116:5601) or MQTT(120.24.4.116:1883)or TCP(120.24.4.116:5600)protocol to send data to the test server
133 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NLMS01 will use(% style="color:#037691" %)** CoAP(120.24.4.116:5683) **(%%)or raw(% style="color:#037691" %)** UDP(120.24.4.116:5601)** or(%%) (% style="color:#037691" %)**MQTT(120.24.4.116:1883)**(%%)or (% style="color:#037691" %)**TCP(120.24.4.116:5600)**(%%)protocol to send data to the test server
138 138  
135 +
139 139  [[image:image-20220907171221-6.png]] ​
140 140  
138 +
139 +
141 141  === 2.2.2 Insert SIM card ===
142 142  
142 +
143 143  Insert the NB-IoT Card get from your provider.
144 144  
145 145  User need to take out the NB-IoT module and insert the SIM card like below:
146 146  
147 +
147 147  [[image:image-20220907171221-7.png]] ​
148 148  
150 +
151 +
149 149  === 2.2.3 Connect USB – TTL to NLMS01 to configure it ===
150 150  
151 -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.
152 152  
153 -**Connection:**
155 +User need to configure NLMS01 via serial port to set the (% style="color:#037691" %)**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.
154 154  
155 - USB TTL GND <~-~-~-~-> GND
156 156  
157 - USB TTL TXD <~-~-~-~-> UART_RXD
158 +(% style="color:blue" %)**Connection:**
158 158  
159 - USB TTL RXD <~-~-~-~-> UART_TXD
160 +**~ (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND(%%)**
160 160  
162 +**~ (% style="background-color:yellow" %)USB TTL TXD  <~-~-~-~-> UART_RXD(%%)**
163 +
164 +**~ (% style="background-color:yellow" %)USB TTL RXD  <~-~-~-~-> UART_TXD(%%)**
165 +
166 +
161 161  In the PC, use below serial tool settings:
162 162  
163 -* Baud:  **9600**
164 -* Data bits:** 8**
165 -* Stop bits: **1**
166 -* Parity:  **None**
167 -* Flow Control: **None**
169 +* Baud:  (% style="color:green" %)**9600**
170 +* Data bits:**  (% style="color:green" %)8(%%)**
171 +* Stop bits:  (% style="color:green" %)**1**
172 +* Parity:  (% style="color:green" %)**None**
173 +* Flow Control: (% style="color:green" %)**None**
168 168  
169 -Make sure the switch is in FLASH position, then power on device by connecting the jumper on NLMS01. NLMS01 will output system info once power on as below, we can enter the **password: 12345678** to access AT Command input.
175 +Make sure the switch is in FLASH position, then power on device by connecting the jumper on NLMS01. NLMS01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
170 170  
171 -​[[image:image-20220907171221-8.png]]
177 +​[[image:image-20220913090720-1.png]]
172 172  
173 -**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]]
174 174  
180 +(% 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]]
181 +
182 +
183 +
175 175  === 2.2.4 Use CoAP protocol to uplink data ===
176 176  
177 -**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/]]
178 178  
179 -**Use below commands:**
187 +(% style="color:red" %)**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/]]
180 180  
181 -* **AT+PRO=1**   ~/~/ Set to use CoAP protocol to uplink
182 -* **AT+SERVADDR=120.24.4.116,5683   ** ~/~/ to set CoAP server address and port
183 -* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** ~/~/Set COAP resource path
184 184  
190 +(% style="color:blue" %)**Use below commands:**
191 +
192 +* (% style="color:#037691" %)**AT+PRO=1**          (%%) ~/~/  Set to use CoAP protocol to uplink
193 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/  to set CoAP server address and port
194 +* (% style="color:#037691" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/  Set COAP resource path
195 +
196 +
197 +
185 185  For parameter description, please refer to AT command set
186 186  
187 187  [[image:image-20220907171221-9.png]]
188 188  
189 -After configure the server address and **reset the device** (via AT+ATZ ), NLMS01 will start to uplink sensor values to CoAP server.
190 190  
203 +After configure the server address and (% style="color:#037691" %)**reset the device**(%%) (via AT+ATZ ), NLMS01 will start to uplink sensor values to CoAP server.
204 +
191 191  [[image:image-20220907171221-10.png]] ​
192 192  
207 +
208 +
193 193  === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
194 194  
211 +
195 195  This feature is supported since firmware version v1.0.1
196 196  
197 -* **AT+PRO=2   ** ~/~/ Set to use UDP protocol to uplink
198 -* **AT+SERVADDR=120.24.4.116,5601   ** ~/~/ to set UDP server address and port
199 -* **AT+CFM=1       ** ~/~/If the server does not respond, this command is unnecessary
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  ** (%%) ~/~/  to set UDP server address and port
216 +* (% style="color:#037691" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessary
200 200  
218 +
219 +
201 201  ​ [[image:image-20220907171221-11.png]]
202 202  
222 +
203 203  [[image:image-20220907171221-12.png]]
204 204  
205 205  ​
206 206  
227 +
207 207  === 2.2.6 Use MQTT protocol to uplink data ===
208 208  
230 +
209 209  This feature is supported since firmware version v110
210 210  
211 -* **AT+PRO=3   ** ~/~/Set to use MQTT protocol to uplink
212 -* **AT+SERVADDR=120.24.4.116,1883   ** ~/~/Set MQTT server address and port
213 -* **AT+CLIENT=CLIENT       ** ~/~/Set up the CLIENT of MQTT
214 -* **AT+UNAME=UNAME                               **~/~/Set the username of MQTT
215 -* **AT+PWD=PWD                                        **~/~/Set the password of MQTT
216 -* **AT+PUBTOPIC=PUB                    **~/~/Set the sending topic of MQTT
217 -* **AT+SUBTOPIC=SUB          ** ~/~/Set the subscription topic of MQTT
233 +* (% style="color:#037691" %)**AT+PRO=3   ** (%%) ~/~/  Set to use MQTT protocol to uplink
234 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/  Set MQTT server address and port
235 +* (% style="color:#037691" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/  Set up the CLIENT of MQTT
236 +* (% style="color:#037691" %)**AT+UNAME=UNAME                        **(%%)** **~/~/  Set the username of MQTT
237 +* (% style="color:#037691" %)**AT+PWD=PWD                            **(%%)** **~/~/  Set the password of MQTT
238 +* (% style="color:#037691" %)**AT+PUBTOPIC=PUB                    ** (%%) ~/~/  Set the sending topic of MQTT
239 +* (% style="color:#037691" %)**AT+SUBTOPIC=SUB          ** (%%) ~/~/  Set the subscription topic of MQTT
218 218  
241 +
242 +
219 219  ​ [[image:image-20220907171221-13.png]]
220 220  
245 +
246 +
221 221  [[image:image-20220907171221-14.png]]
222 222  
223 223  ​
... ... @@ -224,41 +224,59 @@
224 224  
225 225  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.
226 226  
253 +
254 +
227 227  === 2.2.7 Use TCP protocol to uplink data ===
228 228  
257 +
229 229  This feature is supported since firmware version v110
230 230  
231 -* **AT+PRO=4   ** ~/~/ Set to use TCP protocol to uplink
232 -* **AT+SERVADDR=120.24.4.116,5600   ** ~/~/ to set TCP server address and port
260 +* (% style="color:#037691" %)**AT+PRO=4   ** (%%) ~/~/  Set to use TCP protocol to uplink
261 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/  to set TCP server address and port
233 233  
263 +
264 +
234 234  ​ [[image:image-20220907171221-15.png]]
235 235  
267 +
268 +
236 236  [[image:image-20220907171221-16.png]]
237 237  
238 238  ​
239 239  
273 +
240 240  === 2.2.8 Change Update Interval ===
241 241  
276 +
242 242  User can use below command to change the **uplink interval**.
243 243  
244 -* **AT+TDC=7200      ** ~/~/ Set Update Interval to 7200s (2 hour)
279 +* (% style="color:#037691" %)**AT+TDC=7200      ** (%%) ~/~/ Set Update Interval to 7200s (2 hour)
245 245  
246 -**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).**
247 247  
248 248  
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 +
285 +
286 +
249 249  == 2.3  Uplink Payload ==
250 250  
289 +
251 251  In this mode, uplink payload includes 87 bytes in total by default.
252 252  
253 253  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.
254 254  
255 -|**Size(bytes)**|**8**|**2**|**2**|1|1|1|2|2|4|2|2|4
256 -|**Value**|Device ID|Ver|BAT|Signal Strength|MOD|Interrupt|Leaf moisture|Leaf Temperature|Time stamp|Leaf Temperature|Leaf moisture|Time stamp  .....
257 257  
295 +(% border="1" style="background-color:#ffffcc; color:green; width:1251px" %)
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 +|(% 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 +
299 +
258 258  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NLMS01 uplink data.
259 259  
302 +
260 260  [[image:image-20220907171221-17.png]]
261 261  
305 +
262 262  The payload is ASCII string, representative same HEX:
263 263  
264 264  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:
... ... @@ -271,10 +271,14 @@
271 271  * (% style="color:green" %)Interrupt: 0x00= 0
272 272  * Leaf moisture: 0x0225= 549 = 54.9%
273 273  * Leaf Temperature:0x010B =267=26.7 °C
274 -* Time stamp : 0x6315537b =1662342011
318 +* Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>https://www.epochconverter.com/]])
275 275  * Leaf Temperature, Leaf moisture,Time stamp : 010b0226631550fb
276 276  * (% style="color:blue" %)8 sets of recorded data: Leaf Temperature, Leaf moisture,Time stamp : 010e022663154d77,.......
277 277  
322 +
323 +
324 +
325 +
278 278  == 2.4  Payload Explanation and Sensor Interface ==
279 279  
280 280  === 2.4.1  Device ID ===
... ... @@ -552,15 +552,20 @@
552 552  
553 553  AT+SERVADDR  : Server Address
554 554  
555 -AT+TR      : Get or Set record time"
603 +AT+APN     : Get or set the APN
556 556  
605 +AT+FBAND   : Get or Set whether to automatically modify the frequency band
557 557  
558 -AT+NOUD      : Get or Set the number of data to be uploaded
607 +AT+DNSCFG  : Get or Set DNS Server
559 559  
609 +AT+GETSENSORVALUE   : Returns the current sensor measurement
560 560  
561 -AT+CDP     : Read or Clear cached data
611 +AT+TR      : Get or Set record time"
562 562  
613 +AT+NOUD      : Get or Set the number of data to be uploaded
563 563  
615 +AT+CDP     : Read or Clear cached data
616 +
564 564  AT+TEMPALARM      : Get or Set alarm of temp
565 565  
566 566  AT+HUMALARM     : Get or Set alarm of PH
image-20220913090720-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +224.9 KB
Content

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0