Version 103.2 by Xiaoling on 2025/04/25 14:23

Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20240105141518-2.png]]
3
4
5
6
7
8
9
10
11 **Table of Contents:**
12
13 {{toc/}}
14
15
16
17
18
19 = 1. Introduction =
20
21 == 1.1 What is LoRaWAN Leaf Moisture Sensor ==
22
23
24 The Dragino LMS01-LB/LS is a (% style="color:blue" %)**LoRaWAN Leaf Moisture Sensor**(%%) for IoT of Agriculture. It is designed to measure the (% style="color:blue" %)**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.
25
26 LMS01-LB/LS 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.
27
28 The LoRa wireless technology used in LMS01-LB/LS allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
29
30 LMS01-LB/LS (% style="color:blue" %)**Supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
31
32 LMS01-LB/LS is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%) or (% style="color:blue" %)**solar powered + Li-ion battery **(%%)it is designed for long term use up to 5 years.
33
34 Each LMS01-LB/LS is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
35
36
37 == 1.2 ​Features ==
38
39
40 * LoRaWAN 1.0.3 Class A
41 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
42 * Ultra-low power consumption
43 * Monitor Leaf moisture
44 * Monitor Leaf temperature
45 * Monitor Battery Level
46 * Support Bluetooth v5.1 and LoRaWAN remote configure
47 * Support wireless OTA update firmware
48 * AT Commands to change parameters
49 * Downlink to change configure
50 * IP66 Waterproof Enclosure
51 * IP67 rate for the Sensor Probe
52 * 8500mAh Li/SOCl2 Battery (LMS01-LB)
53 * Solar panel + 3000mAh Li-ion battery (LMS01-LS)
54
55 == 1.3 Specification ==
56
57
58 (% style="color:blue" %)**Common DC Characteristics:**
59
60 * Supply Voltage: Built-in Battery , 2.5v ~~ 3.6v
61 * Operating Temperature: -40 ~~ 85°C
62
63 (% style="color:blue" %)**Leaf Moisture: percentage of water drop over total leaf surface**
64
65 * Range: 0~~100%
66 * Resolution: 0.1%
67 * Accuracy: ±3%(0~~50%); ±6%(>50%)
68 * IP67 Protection
69 * Length: 3.5 meters
70
71 (% style="color:blue" %)**Leaf Temperature:**
72
73 * Range: -50 ~~ 80°C
74 * Resolution: 0.1°C
75 * Accuracy: <±0.5°C(-10°C ~~ 70°C),<±1.0°C (others)
76 * IP67 Protection
77 * Length: 3.5 meters
78
79 (% style="color:blue" %)**LoRa Spec:**
80
81 * Frequency Range,  Band 1 (HF): 862 ~~ 1020 Mhz, Band 2 (LF): 410 ~~ 528 Mhz
82 * Max +22 dBm constant RF output vs.
83 * RX sensitivity: down to -139 dBm.
84 * Excellent blocking immunity
85
86 (% style="color:blue" %)**Battery:**
87
88 * Li/SOCI2 un-chargeable battery
89 * Capacity: 8500mAh
90 * Self-Discharge: <1% / Year @ 25°C
91 * Max continuously current: 130mA
92 * Max boost current: 2A, 1 second
93
94 (% style="color:blue" %)**Power Consumption**
95
96 * Sleep Mode: 5uA @ 3.3v
97 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
98
99 == 1.4 Applications ==
100
101
102 * Smart Agriculture
103
104 == 1.5 Sleep mode and working mode ==
105
106
107 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
108
109 (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
110
111
112 == 1.6 Button & LEDs ==
113
114
115 [[image:image-20250417091351-2.jpeg]]
116
117 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
118 |=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 225px;background-color:#4F81BD;color:white" %)**Action**
119 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
120 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
121 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
122 )))
123 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
124 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network.
125 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
126 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device join or not join LoRaWAN network.
127 )))
128 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
129
130 == 1.7 BLE connection ==
131
132
133 LMS01-LB/LS support BLE remote configure.
134
135
136 BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
137
138 * Press button to send an uplink
139 * Press button to active device.
140 * Device Power on or reset.
141
142 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
143
144
145 == 1.8 Pin Definitions ==
146
147
148 [[image:image-20250218142033-2.jpeg||height="406" width="884"]]
149
150
151 == 1.9 Mechanical ==
152
153 === 1.9.1 for LB version ===
154
155 (% style="color:blue" %)**Main Device Dimension:**
156
157 [[image:image-20250329155814-1.jpeg]]
158
159
160 === 1.9.2 for LS version ===
161
162
163 [[image:image-20250329155831-2.jpeg]]
164
165
166 = 2. Configure LMS01-LB/LS to connect to LoRaWAN network =
167
168 == 2.1 How it works ==
169
170
171 The LMS01-LB/LS is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the LMS01-LB/LS. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
172
173 (% style="display:none" %) (%%)
174
175 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
176
177
178 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
179
180 [[image:image-20250417091309-1.png]]
181
182 The LPS8v2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
183
184 (% style="display:none" %)
185
186
187 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from LMS01-LB/LS.
188
189 Each LMS01-LB/LS is shipped with a sticker with the default device EUI as below:
190
191 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
192
193
194 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
195
196 **Create the application.**
197
198 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SAC01L_LoRaWAN_Temperature%26Humidity_Sensor_User_Manual/WebHome/image-20250423093843-1.png?width=756&height=264&rev=1.1||alt="image-20250423093843-1.png"]]
199
200 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111305-2.png?width=1000&height=572&rev=1.1||alt="image-20240907111305-2.png"]]
201
202
203 **Add devices to the created Application.**
204
205 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111659-3.png?width=977&height=185&rev=1.1||alt="image-20240907111659-3.png"]]
206
207 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907111820-5.png?width=975&height=377&rev=1.1||alt="image-20240907111820-5.png"]]
208
209
210 **Enter end device specifics manually.**
211
212 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112136-6.png?width=697&height=687&rev=1.1||alt="image-20240907112136-6.png"]]
213
214
215 **Add DevEUI and AppKey. Customize a platform ID for the device.**
216
217 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LTC2-LB--LoRaWAN_Temperature_Transmitter_User_Manual/WebHome/image-20240907112427-7.png?rev=1.1||alt="image-20240907112427-7.png"]]
218
219
220 (% style="color:blue" %)**Step 2:**(%%) Add decoder.
221
222 In TTN, user can add a custom payload so it shows friendly reading.
223
224 Click this link to get the decoder: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/]]
225
226 Below is TTN screen shot:
227
228 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140556-1.png?width=1184&height=488&rev=1.1||alt="image-20241009140556-1.png" height="488" width="1184"]]
229
230 [[image:https://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS25-LBLDS25-LS--LoRaWAN_LiDAR_Distance_Auto-Clean_Sensor_User_Manual/WebHome/image-20241009140603-2.png?width=1168&height=562&rev=1.1||alt="image-20241009140603-2.png" height="562" width="1168"]]
231
232
233 (% style="color:blue" %)**Step 3:**(%%) Activate on LMS01-LB/LS
234
235 Press the button for 5 seconds to activate the LMS01-LB/LS.
236
237 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
238
239 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
240
241
242 == 2.3 ​Uplink Payload ==
243
244
245 (((
246 LMS01-LB/LS will uplink payload via LoRaWAN with below payload format: 
247 )))
248
249 (((
250 Uplink payload includes in total 11 bytes.
251 )))
252
253 (((
254 Normal uplink payload:
255 )))
256
257 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
258 |=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)(((
259 **Size(bytes)**
260 )))|=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)2|=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**1**
261 |(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((
262 [[Temperature (Optional)>>||anchor="H2.3.2DS18B20Temperaturesensor"]]
263 )))|[[ Leaf Moisture>>||anchor="H2.3.3LeafMoisture"]] |[[Leaf Temperature>>||anchor="H2.3.4LeafTemperature"]]|(((
264 [[Digital Interrupt (Optional)>>||anchor="H2.3.5InterruptPin"]]
265 )))|Reserve|(((
266 [[Message Type>>||anchor="H2.3.6MessageType"]]
267 )))
268
269 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/WebHome/1654649531303-864.png?rev=1.1||alt="1654649531303-864.png"]]
270
271
272 === 2.3.1 Battery Info ===
273
274
275 Check the battery voltage for LMS01-LB/LS.
276
277 Ex1: 0x0B45 = 2885mV
278
279 Ex2: 0x0B49 = 2889mV
280
281
282 === 2.3.2 DS18B20 Temperature sensor ===
283
284
285 This is optional, user can connect external DS18B20 sensor to the +3.3v, one-wire and GND pin . and this field will report temperature.
286
287
288 **Example**:
289
290 If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
291
292 If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
293
294
295 === 2.3.3 Leaf Moisture ===
296
297
298 Range: 0 ~~ 100%
299
300 **Example:**
301
302 (% style="color:#037691" %)**0x0015(H) = 21(D) /10= 2.1%**
303
304
305 === 2.3.4 Leaf Temperature ===
306
307
308 Get Leaf Temperature 
309
310
311 **Example**:
312
313 If payload is: **0105H**:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
314
315 If payload is: **FF3FH** :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
316
317
318 === 2.3.5 Interrupt Pin ===
319
320
321 This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3.2SetInterruptMode"]] for the hardware and software set up.
322
323
324 **Example:**
325
326 0x00: Normal uplink packet.
327
328 0x01: Interrupt Uplink Packet.
329
330
331 === 2.3.6 Message Type ===
332
333
334 (((
335 For a normal uplink payload, the message type is always 0x01.
336 )))
337
338 (((
339 Valid Message Type:
340 )))
341
342
343 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:496px" %)
344 |=(% style="width: 162px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 162px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 172px;background-color:#4F81BD;color:white" %)**Payload**
345 |(% style="width:160px" %)0x01|(% style="width:161px" %)Normal Uplink|(% style="width:170px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
346 |(% style="width:160px" %)0x02|(% style="width:161px" %)Reply configures info|(% style="width:170px" %)[[Configure Info Payload>>||anchor="H3.3.3GetFirmwareVersionInfo"]]
347
348 === 2.3.7 Decode payload in The Things Network ===
349
350
351 While using TTN network, you can add the payload format to decode the payload.
352
353
354 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLMS01-LoRaWAN%20Leaf%20Moisture%20Sensor%20User%20Manual/WebHome/1654592762713-715.png?rev=1.1||alt="1654592762713-715.png"]]
355
356 (((
357 (((
358 The payload decoder function for TTN is here:
359 )))
360
361 (((
362 LMS01-LB/LS TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
363 )))
364 )))
365
366
367 == 2.4 Uplink Interval ==
368
369
370 The LMS01-LB/LS by default uplink the sensor data every 20 minutes. User can change this interval by AT Command or LoRaWAN Downlink Command. See this link: [[Change Uplink Interval>>doc:Main.End Device AT Commands and Downlink Command.WebHome||anchor="H4.1ChangeUplinkInterval"]]
371
372
373 == 2.5 ​Show Data in DataCake IoT Server ==
374
375
376 (((
377 [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
378 )))
379
380 (((
381
382 )))
383
384 (((
385 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
386 )))
387
388 (((
389 (% style="color:blue" %)**Step 2**(%%)**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:**
390 )))
391
392
393 [[image:image-20250329160041-7.jpeg]]
394
395
396 [[image:image-20250329160057-8.jpeg]]
397
398
399 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
400
401 (% style="color:blue" %)**Step 4**(%%)**: Create LMS01-LB/LS product.**
402
403
404 [[image:image-20250329160113-9.jpeg]]
405
406
407
408 [[image:image-20250329160133-10.jpeg]]
409
410
411 [[image:image-20250329160157-11.jpeg]]
412
413
414 (((
415 (% style="color:blue" %)**Step 5**(%%)**: add payload decode**
416 )))
417
418 (((
419 Download Datacake decoder from:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>url:https://github.com/dragino/dragino-end-node-decoder]]
420
421
422 )))
423
424 [[image:image-20250329160218-12.jpeg]]
425
426
427 [[image:image-20250329160248-13.jpeg]]
428
429
430 [[image:image-20250329160303-14.jpeg]]
431
432
433 After added, the sensor data arrive TTN, it will also arrive and show in Mydevices.
434
435 [[image:image-20250329160321-15.jpeg]]
436
437
438 == 2.6 Datalog Feature ==
439
440
441 Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, LMS01-LB/LS will store the reading for future retrieving purposes.
442
443
444 === 2.6.1 Ways to get datalog via LoRaWAN ===
445
446
447 Set **PNACKMD=1**, LMS01-LB/LS will wait for ACK for every uplink, when there is no LoRaWAN network, LMS01-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
448
449 * (((
450 a) LMS01-LB/LS will do an ACK check for data records sending to make sure every data arrive server.
451 )))
452 * (((
453 b) LMS01-LB/LS will send data in **CONFIRMED Mode** when PNACKMD=1, but LMS01-LB/LS won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if LMS01-LB/LS gets a ACK, LMS01-LB/LS will consider there is a network connection and resend all NONE-ACK messages.
454 )))
455
456 === 2.6.2 Unix TimeStamp ===
457
458
459 LMS01-LB/LS uses Unix TimeStamp format based on
460
461 [[image:image-20250329160340-16.jpeg]]
462
463 User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
464
465 Below is the converter example
466
467 [[image:image-20250329160351-17.jpeg]]
468
469
470 So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
471
472
473 === 2.6.3 Set Device Time ===
474
475
476 User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
477
478 Once LMS01-LB/LS Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to LMS01-LB/LS. If LMS01-LB/LS fails to get the time from the server, LMS01-LB/LS will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
479
480 (% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
481
482
483 === 2.6.4 Poll sensor value ===
484
485
486 Users can poll sensor values based on timestamps. Below is the downlink command.
487
488 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %)
489 |(% colspan="4" style="background-color:#4f81bd; color:white; width:423px" %)**Downlink Command to poll Open/Close status (0x31)**
490 |(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte**
491 |(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval
492
493 (((
494 Timestamp start and Timestamp end-use Unix TimeStamp format as mentioned above. Devices will reply with all data logs during this period, using the uplink interval.
495 )))
496
497 (((
498 For example, downlink command [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/CPL01%20LoRaWAN%20Outdoor%20PulseContact%20%20Sensor%20Manual/WebHome/image-20220518162852-1.png?rev=1.1||alt="image-20220518162852-1.png"]]
499 )))
500
501 (((
502 Is to check 2021/11/12 12:00:00 to 2021/11/12 15:00:00's data
503 )))
504
505 (((
506 Uplink Internal =5s,means LMS01-LB/LS will send one packet every 5s. range 5~~255s.
507 )))
508
509
510 == 2.7 Frequency Plans ==
511
512
513 The LMS01-LB/LS uses OTAA mode and below frequency plans by default. Each frequency band use different firmware, user update the firmware to the corresponding band for their country.
514
515 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
516
517
518 == 2.8 Installation ==
519
520
521 LMS01-LB/LS probe has two sides. The side without words are the sense side. Please be ware when install the sensor.
522
523 [[image:image-20230715094850-4.png||height="466" width="839"]] ​
524
525
526
527 = 3. Configure LMS01-LB/LS =
528
529 == 3.1 Configure Methods ==
530
531
532 LMS01-LB/LS supports below configure method:
533
534 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
535
536 * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
537
538 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
539
540 == 3.2 General Commands ==
541
542
543 These commands are to configure:
544
545 * General system settings like: uplink interval.
546
547 * LoRaWAN protocol & radio related command.
548
549 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
550
551 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
552
553
554 == 3.3 Commands special design for LMS01-LB/LS ==
555
556
557 These commands only valid for LMS01-LB/LS, as below:
558
559
560 === 3.3.1 Set Transmit Interval Time ===
561
562
563 (((
564 Feature: Change LoRaWAN End Node Transmit Interval.
565 )))
566
567 (((
568 (% style="color:blue" %)**AT Command: AT+TDC**
569 )))
570
571 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
572 |=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response**
573 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
574 30000
575 OK
576 the interval is 30000ms = 30s
577 )))
578 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
579 OK
580 Set transmit interval to 60000ms = 60 seconds
581 )))
582
583 (((
584 (% style="color:blue" %)**Downlink Command: 0x01**
585 )))
586
587 (((
588 Format: Command Code (0x01) followed by 3 bytes time value.
589 )))
590
591 (((
592 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
593 )))
594
595 * (((
596 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
597 )))
598
599 * (((
600 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
601
602
603
604 )))
605
606 === 3.3.2 Set Interrupt Mode ===
607
608
609 Feature, Set Interrupt mode for GPIO_EXTI of pin.
610
611 When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
612
613 (% style="color:blue" %)**AT Command: AT+INTMOD**
614
615 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
616 |=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response**
617 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
618 0
619 OK
620 the mode is 0 =Disable Interrupt
621 )))
622 |(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
623 Set Transmit Interval
624 0. (Disable Interrupt),
625 ~1. (Trigger by rising and falling edge)
626 2. (Trigger by falling edge)
627 3. (Trigger by rising edge)
628 )))|(% style="width:157px" %)OK
629
630 (% style="color:blue" %)**Downlink Command: 0x06**
631
632 Format: Command Code (0x06) followed by 3 bytes.
633
634 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
635
636 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
637
638 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
639
640 === 3.3.3 Get Firmware Version Info ===
641
642
643 Feature: use downlink to get firmware version.
644
645 (% style="color:#037691" %)**Downlink Command: 0x26**
646
647 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
648 |(% style="background-color:#4f81bd; color:white; width:193px" %)**Downlink Control Type**|(% style="background-color:#4f81bd; color:white; width:57px" %)**FPort**|(% style="background-color:#4f81bd; color:white; width:91px" %)**Type Code**|(% style="background-color:#4f81bd; color:white; width:159px" %)**Downlink payload size(bytes)**
649 |(% style="width:193px" %)Get Firmware Version Info|(% style="width:57px" %)Any|(% style="width:91px" %)26|(% style="width:149px" %)2
650
651 * Reply to the confirmation package: 26 01
652 * Reply to non-confirmed packet: 26 00
653
654 Device will send an uplink after got this downlink command. With below payload:
655
656 Configures info payload:
657
658 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:470px" %)
659 |(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:70px" %)**1**|(% style="background-color:#4f81bd; color:white; width:100px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**1**|(% style="background-color:#4f81bd; color:white; width:60px" %)**2**
660 |Value|Sensor Model|Firmware Version|Frequency Band|Sub-band|BAT
661
662 (% style="color:#037691" %)**Software Type**(%%): Always 0x2D for LMS01-LB/LS
663
664 (% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
665
666 (% style="color:#037691" %)**Frequency Band**:
667
668 0x01: EU868
669
670 0x02: US915
671
672 0x03: IN865
673
674 0x04: AU915
675
676 0x05: KZ865
677
678 0x06: RU864
679
680 0x07: AS923
681
682 0x08: AS923-1
683
684 0x09: AS923-2
685
686 0x0a: AS923-3
687
688 0x0b: CN470
689
690 0x0c: EU433
691
692 0x0d: KR920
693
694 0x0e: MA869
695
696 (% style="color:#037691" %)**Sub-Band**(%%):
697
698 * AU915 and US915: value 0x00 ~~ 0x08
699 * CN470: value 0x0B ~~ 0x0C
700 * Other Bands: Always 0x00
701
702 (% style="color:#037691" %)**Battery Info**:
703
704 Check the battery voltage.
705
706 Ex1: 0x0B45 = 2885mV
707
708 Ex2: 0x0B49 = 2889mV
709
710
711 = 4. Battery & Power Consumption =
712
713
714 LMS01-LB use ER26500 + SPC1520 battery pack and LMS01-LS use 3000mAh Recharable Battery with Solar Panel. See below link for detail information about the battery info and how to replace.
715
716 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
717
718
719 = 5. OTA Firmware update =
720
721
722 (% class="wikigeneratedid" %)
723 User can change firmware LMS01-LB/LS to:
724
725 * Change Frequency band/ region.
726
727 * Update with new features.
728
729 * Fix bugs.
730
731 Firmware and changelog can be downloaded from : [[**Firmware download link**>>https://www.dropbox.com/sh/9ntqv4c79o98mmh/AADymEaHkXRojrJsz5Dl5sr8a?dl=0]]
732
733 Methods to Update Firmware:
734
735 * (Recommanded way) OTA firmware update via wireless : **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
736
737 * Update through UART TTL interface : **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
738
739 = 6. FAQ =
740
741 == 6.1  AT Commands input doesn't work ==
742
743
744 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.
745
746
747 = 7. Order Info =
748
749
750 **Part Number: (% style="color:blue" %)LMS01-LB-XX(%%) or (% style="color:blue" %)LMS01-LS-XX(%%)**
751
752 (% style="color:red" %)**XX**(%%): The default frequency band
753
754 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
755
756 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
757
758 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
759
760 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
761
762 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
763
764 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
765
766 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
767
768 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
769
770 = 8. ​Packing Info =
771
772
773 (% style="color:#037691" %)**Package Includes**:
774
775 * LMS01-LB or LMS01-LS LoRaWAN Leaf Moisture Sensor
776
777 (% style="color:#037691" %)**Dimension and weight**:
778
779 * Device Size: cm
780
781 * Device Weight: g
782
783 * Package Size / pcs : cm
784
785 * Weight / pcs : g
786
787 = 9. Support =
788
789
790 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
791
792 * 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.cc>>mailto:Support@dragino.cc]].