Last modified by Mengting Qiu on 2024/05/09 11:35
Show last authors
1
2
3 (% aria-label="image-20231014174558-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)
4 (((
5 (% data-widget="image" style="text-align:center" %)
6 [[image:image-20231014174558-2.png||height="535" width="754"]](% title="Click and drag to resize" %)​
7
8 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
9 )))
10
11
12
13
14
15
16
17 **Table of Contents:**
18
19 (% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %)
20 (((
21 {{toc/}}
22
23 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
24 )))
25
26
27
28
29
30
31 = 1. Introduction =
32
33 == 1.1 What is NB-IoT Leaf Moisture Sensor ==
34
35
36 The Dragino LMS01-NB is a (% style="color:blue" %)**NB-IoT 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.
37
38 LMS01-NB 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.
39
40 LMS01-NB supports different uplink methods including (% style="color:blue" %)**MQTT, MQTTs, UDP & TCP**(%%) for different application requirement, and support uplinks to various IoT Servers.
41
42 LMS01-NB (% style="color:blue" %)**supports BLE configure and OTA update**(%%) which make user easy to use.
43
44 LMS01-NB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long-term use up to several years.
45
46 LMS01-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
47
48 (% aria-label="image-20231014174452-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231014174452-1.png||data-widget="image" height="311" width="893"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​(% style="display:none" %)
49
50
51 == 1.2 ​Features ==
52
53
54 * NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
55 * Ultra-low power consumption
56 * Monitor Leaf moisture
57 * Monitor Leaf temperature
58 * Multiply Sampling and one uplink
59 * Support Bluetooth v5.1 remote configure and update firmware
60 * Uplink on periodically
61 * Downlink to change configure
62 * IP66 Waterproof Enclosure
63 * IP67 rate for the Sensor Probe
64 * 8500mAh Battery for long term use
65 * Nano SIM card slot for NB-IoT SIM
66
67 == 1.3 Specification ==
68
69
70 (% style="color:blue" %)**Common DC Characteristics:**
71
72 * Supply Voltage: 2.5v ~~ 3.6v
73 * Operating Temperature: -40 ~~ 85°C
74
75 (% style="color:blue" %)**Leaf Moisture: percentage of water drop over total leaf surface**
76
77 * Range: 0~~100%
78 * Resolution: 0.1%
79 * Accuracy: ±3%(0 ~~ 50%); ±6%(>50%)
80 * IP67 Protection
81 * Length: 3.5 meters
82
83 (% style="color:blue" %)**Leaf Temperature:**
84
85 * Range: -50 ~~ 80°C
86 * Resolution: 0.1°C
87 * Accuracy: <±0.5°C(-10°C ~~ 70°C),<±1.0°C (others)
88 * IP67 Protection
89 * Length: 3.5 meters
90
91 (% style="color:blue" %)**NB-IoT Spec:**
92
93 (% style="color:#037691" %)**NB-IoT Module: BC660K-GL**
94
95 (% style="color:#037691" %)**Support Bands:**
96
97 * B1 @H-FDD: 2100MHz
98 * B2 @H-FDD: 1900MHz
99 * B3 @H-FDD: 1800MHz
100 * B4 @H-FDD: 2100MHz
101 * B5 @H-FDD: 860MHz
102 * B8 @H-FDD: 900MHz
103 * B12 @H-FDD: 720MHz
104 * B13 @H-FDD: 740MHz
105 * B17 @H-FDD: 730MHz
106 * B18 @H-FDD: 870MHz
107 * B19 @H-FDD: 870MHz
108 * B20 @H-FDD: 790MHz
109 * B25 @H-FDD: 1900MHz
110 * B28 @H-FDD: 750MHz
111 * B66 @H-FDD: 2000MHz
112 * B70 @H-FDD: 2000MHz
113 * B85 @H-FDD: 700MHz
114
115 (% style="color:blue" %)**Battery:**
116
117 * Li/SOCI2 un-chargeable battery
118 * Capacity: 8500mAh
119 * Self Discharge: <1% / Year @ 25°C
120 * Max continuously current: 130mA
121 * Max boost current: 2A, 1 second
122
123 (% style="color:blue" %)**Power Consumption**
124
125 * STOP Mode: 10uA @ 3.3v
126 * Max transmit power: 350mA@3.3v
127
128 (% class="wikigeneratedid" %)
129 (% style="display:none" %) (%%)
130
131
132 == 1.4 Applications ==
133
134
135 * Smart Agriculture
136
137 == 1.5 Mechanical ==
138
139 (% aria-label="1675143884058-338.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143884058-338.png?rev=1.1||alt="1675143884058-338.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
140
141
142 (% aria-label="1675143899218-599.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143899218-599.png?rev=1.1||alt="1675143899218-599.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
143
144
145 (% aria-label="1675143909447-639.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual/WebHome/1675143909447-639.png?rev=1.1||alt="1675143909447-639.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
146
147
148 == 1.6 Sleep mode and working mode ==
149
150
151 (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any NB-IoT activate. This mode is used for storage and shipping to save battery life.
152
153 (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT 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.
154
155
156 == 1.7 Button & LEDs ==
157
158
159 (% aria-label="1675071855856-879.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
160
161
162 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
163 |=(% 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**
164 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
165 If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
166 Meanwhile, BLE module will be active and user can connect via BLE to configure device.
167 )))
168 |(% style="width:167px" %)Pressing ACT for more than 3s|(% style="width:117px" %)Active Device|(% style="width:225px" %)(((
169 (% 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 attach NB-IoT network.
170 (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
171 Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device attach NB-IoT network or not.
172 )))
173 |(% 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.
174
175 (% style="color:red" %)**Note: When the device is executing a program, the buttons may become invalid. It is best to press the buttons after the device has completed the program execution.**
176
177
178 == 1.8 BLE connection ==
179
180
181 LMS01-NB support BLE remote configure and firmware update.
182
183
184 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:
185
186 * Press button to send an uplink
187 * Press button to active device.
188 * Device Power on or reset.
189
190 If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
191
192
193 == 1.9 Pin Definitions , Switch & SIM Direction ==
194
195 (% aria-label="image-20231028145756-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231028145756-8.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
196
197
198 === 1.9.1 Jumper JP2 ===
199
200
201 Power on Device when put this jumper.
202
203
204 === 1.9.2 BOOT MODE / SW1 ===
205
206
207 **1)** (% style="color:blue" %)**ISP**(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
208
209 **2)** (% style="color:blue" %)**Flash**(%%): work mode, device starts to work and send out console output for further debug
210
211
212 === 1.9.3 Reset Button ===
213
214
215 Press to reboot the device.
216
217
218 === 1.9.4 SIM Card Direction ===
219
220
221 See this link. [[How to insert SIM Card>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
222
223
224 = 2. Use LMS01-NB to communicate with IoT Server =
225
226 == 2.1 Send data to IoT server via NB-IoT network ==
227
228
229 The LMS01-NB is equipped with a NB-IoT module, the pre-loaded firmware in LMS01-NB 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 LMS01-NB.
230
231 Below shows the network structure:
232
233 (% aria-label="image-20231014174452-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LMS01-NB_NB-IoT_Leaf_Moisture_Sensor_User_Manual/WebHome/image-20231014174452-1.png?width=893&height=311&rev=1.1||alt="image-20231014174452-1.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
234
235
236 There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of LMS01-NB.
237
238
239 (% style="color:blue" %)**GE Version**(%%): This version doesn't include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set LMS01-NB send data to IoT server.
240
241 * Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
242
243 * Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]]. 
244
245 Below shows result of different server as a glance.
246
247 (% border="1" cellspacing="4" style="width:515px" %)
248 |(% style="background-color:#4f81bd; color:white; width:100px" %)**Servers**|(% style="background-color:#4f81bd; color:white; width:300px" %)**Dash Board**|(% style="background-color:#4f81bd; color:white; width:115px" %)**Comments**
249 |(% style="width:127px" %)[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]|(% style="width:385px" %)(((
250 (% aria-label="image-20230819113244-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)
251 (((
252 (% data-widget="image" style="text-align:center" %)
253 [[image:image-20230819113244-8.png||height="183" width="367"]](% title="Click and drag to resize" %)​
254
255 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
256 )))
257 )))|(% style="width:170px" %)
258 |(% style="width:127px" %)[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]|(% style="width:385px" %)(((
259 (% aria-label="image-20230819113244-9.png image widget" contenteditable="false" role="region" tabindex="-1" %)
260 (((
261 (% data-widget="image" style="text-align:center" %)
262 [[image:image-20230819113244-9.png||height="119" width="367"]](% title="Click and drag to resize" %)​
263
264 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
265 )))
266 )))|(% style="width:170px" %)
267 |(% style="width:127px" %)[[Tago.IO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.7A0Tago.ioA028viaA0MQTT29]]|(% style="width:385px" %) |(% style="width:170px" %)
268 |(% style="width:127px" %)[[General UDP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.1GeneralA0UDPA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
269 |(% style="width:127px" %)[[General MQTT>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.2GeneralA0MQTTA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
270 |(% style="width:127px" %)[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]|(% style="width:385px" %)(((
271 (% aria-label="image-20230819113244-10.png image widget" contenteditable="false" role="region" tabindex="-1" %)
272 (((
273 (% data-widget="image" style="text-align:center" %)
274 [[image:image-20230819113244-10.png||height="104" width="367"]](% title="Click and drag to resize" %)​
275
276 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
277 )))
278 )))|(% style="width:170px" %)
279 |(% style="width:127px" %)[[ThingsBoard>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.6A0ThingsBoard.CloudA028viaA0MQTT29]]|(% style="width:385px" %)(((
280 (% aria-label="image-20230819113244-11.png image widget" contenteditable="false" role="region" tabindex="-1" %)
281 (((
282 (% data-widget="image" style="text-align:center" %)
283 [[image:image-20230819113244-11.png||height="141" width="367"]](% title="Click and drag to resize" %)​
284
285 (% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||height="15" role="presentation" title="Click and drag to move" width="15"]]
286 )))
287 )))|(% style="width:170px" %)
288
289 (% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate LMS01-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
290
291
292 == 2.2 ​Payload Types ==
293
294
295 To meet different server requirement, LMS01-NB supports different payload type.
296
297 **Includes:**
298
299 * [[General JSON format payload>>||anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
300
301 * [[HEX format Payload>>||anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
302
303 * [[ThingSpeak Format>>||anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
304
305 * [[ThingsBoard Format>>||anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
306
307 User can specify the payload type when choose the connection protocol. Example:
308
309 (% style="color:#037691" %)**AT+PRO=2,0**  (%%) ~/~/ Use UDP Connection & hex Payload
310
311 (% style="color:#037691" %)**AT+PRO=2,5**   (%%) ~/~/ Use UDP Connection & Json Payload
312
313 (% style="color:#037691" %)**AT+PRO=3,5 ** (%%) ~/~/ Use MQTT Connection & Json Payload
314
315
316 === 2.2.1 General Json Format(Type~=5) ===
317
318
319 This is the General Json Format. As below:
320
321 (% style="color:#4472c4" %)**{"IMEI":"866207058378443","Model":"LMS01-NB","humidity":0.8,"temperature":26.1,"battery":3.55,"signal":28,"1":{26.8,1.2,2023/10/28 03:25:20},"2":{0.0,0.0,2023/10/26 03:41:52},"3":{0.0,0.0,2023/10/26 03:36:17},"4":{0.0,0.0,2023/10/26 03:33:17},"5":{0.0,0.0,2023/10/26 03:30:17},"6":{0.0,0.0,2023/10/26 03:27:17},"7":{0.0,0.0,2023/10/26 03:21:59},"8":{0.0,0.0,2023/10/26 03:18:57}}**
322
323
324 (% aria-label="image-20231028114139-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231028114139-1.png||data-widget="image" height="669" width="895"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
325
326
327 (% style="color:red" %)**Notice, from above payload:**
328
329 * Humidity,Temperature ,Battery & Signal are the value at uplink time.
330
331 * Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Leaf Moisture, Leaf Temperature & Sampling time.
332
333 === 2.2.2 HEX format Payload(Type~=0) ===
334
335
336 This is the HEX Format. As below:
337
338 (% style="color:#4472c4" %)**f86620705837844307640ddf190100000900fc653c863b010c000c653c7f20000000006539e000000000006539deb1000000006539ddfd000000006539dd49000000006539dc95000000006539db57000000006539daa1**
339
340 (% aria-label="image-20231028115949-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231028115949-5.png||data-widget="image" height="164" width="1194"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
341
342
343 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NB sensor uplink data.
344
345
346 (% aria-label="image-20231028115642-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231028115642-3.png||data-widget="image" height="664" width="893"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
347
348
349 (% style="color:blue" %)**Version:**
350
351 These bytes include the hardware and software version.
352
353 (% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x07 for LMS01-NB
354
355 (% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100
356
357
358 (% style="color:blue" %)**BAT (Battery Info):**
359
360 Ex1: 0x0CC6 = 3270mV
361
362
363 (% style="color:blue" %)**Signal Strength:**
364
365 NB-IoT Network signal Strength.
366
367 **Ex1: 0x18 = 24**
368
369 **0**  -113dBm or less
370
371 **1**  -111dBm
372
373 **2...30** -109dBm... -53dBm
374
375 **31**   -51dBm or greater
376
377 **99**    Not known or not detectable
378
379
380 (% style="color:blue" %) **DS18B20 Temperature sensor**
381
382 This is optional, user can connect external DS18B20 sensor to the +3.3v, one-wire and GND pin . and this field will report temperature.
383
384 **Example**:
385
386 If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
387
388 If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
389
390
391 (% style="color:blue" %)**Leaf Moisture**
392
393 Range: 0 ~~ 100%
394
395 **Example:**
396
397 (% style="color:#037691" %)**0x0015(H) = 21(D) /10= 2.1%**
398
399
400 (% style="color:blue" %)**Leaf Temperature**
401
402 Get Leaf Temperature 
403
404
405 **Example**:
406
407 If payload is: **0105H**:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
408
409 If payload is: **FF3FH** :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
410
411
412 (% style="color:blue" %)**TimeStamp:   **
413
414 Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
415
416 Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]]) to get the time.
417
418
419 === 2.2.3 ThingsBoard Payload(Type~=3) ===
420
421
422 Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
423
424 (% style="color:#4472c4" %)** {
425 "IMEI": "866207058378443",
426 "Model": "LMS01-NB",
427 "humidity": 0.9,
428 "temperature": 25.0,
429 "battery": 3.56,
430 "signal": 27
431 }**
432
433
434 (% aria-label="image-20231028141128-6.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231028141128-6.png||data-widget="image" height="491" width="999"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
435
436
437 === 2.2.4 ThingSpeak Payload(Type~=1) ===
438
439
440 This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are:
441
442 Humidity,Temperature ,Battery & Signal. This payload type only valid for ThingsSpeak Platform.
443
444 As below:
445
446 (% style="color:#4472c4" %)**field1=Humidity value&field2=Temperature value&field3=Battery value&field4=Signal value**
447
448 (% aria-label="image-20231028144453-7.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20231028144453-7.png||data-widget="image" height="595" width="828"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
449
450
451 (% style="color:inherit; font-family:inherit; font-size:26px" %)2.3 Test Uplink and Change Update Interval
452
453
454 By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
455
456 User can use below commands to change the (% style="color:blue" %)**uplink interval**.
457
458 (% style="color:#037691" %)**AT+TDC=600 ** (%%) ~/~/ Set Update Interval to 600s
459
460 User can also push the button for more than 1 seconds to activate an uplink.
461
462
463 == 2.4 Multi-Samplings and One uplink ==
464
465 (% style="color:red" %)Notice: The AT+NOUD feature is upgraded to Clock Logging, please refer [[Clock Logging Feature>>||anchor="H2.7Clocklogging28Sincefirmwareversionv1.2.129"]]
466
467 To save battery life, LMS01-NB will sample temperature & humidity data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
468
469 * (% style="color:#037691" %)**AT+TR=900**   (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
470
471 * (% 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.
472
473 The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
474
475 (% aria-label="1692424376354-959.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:1692424376354-959.png||data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​
476
477
478 == 2.5 Trggier an uplink by external interrupt ==
479
480
481 LMS01-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
482
483 (% style="color:blue" %)**AT command:**
484
485 * (% style="color:#037691" %)**AT+INTMOD **(%%) ~/~/ Set the trigger interrupt mode
486
487 * (% style="color:#037691" %)**AT+INTMOD=0 **(%%) ~/~/ Disable Interrupt
488
489 * (% style="color:#037691" %)**AT+INTMOD=1 **(%%) ~/~/ Trigger by rising and falling edge
490
491 * (% style="color:#037691" %)**AT+INTMOD=2 **(%%) ~/~/ Trigger by falling edge
492
493 * (% style="color:#037691" %)**AT+INTMOD=3  **(%%) ~/~/ Trigger by rising edge
494
495 == 2.6 Installation ==
496
497
498 LMS01-NB probe has two sides. The side without words are the sense side. Please be ware when install the sensor.
499
500 (% aria-label="image-20230715094850-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LMS01-LB_LoRaWAN_Leaf_Moisture_Sensor_User_Manual/WebHome/image-20230715094850-4.png?width=839&height=466&rev=1.1||alt="image-20230715094850-4.png" data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)​(%%) ​
501
502
503
504
505 == 2.7 Clock logging (Since firmware version v1.2.1) ==
506
507
508 Sometimes when we deploy lots of end nodes in field. We want all sensors sample data at the same time, and upload these data together for analyze. In such case, we can use clock loging feature.
509
510 We can use this command to set the start time of data recording and the time interval to meet the requirements of the specific collection time of data.
511
512 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+CLOCKLOG=a,b,c,d(%%)**
513
514 (% style="color:#037691" %)**a: **(%%)**0:** Disable Clock logging.  ** 1: **Enable Clock Logging
515
516 (% style="color:#037691" %)**b:**(%%)** **Specify First sampling start second: range **(0 ~~ 3599, 65535)   ** ~/~/ (% style="color:red" %)**Note:**(%%)** **If parameter b is set to 65535, the log period starts after the node accesses the network and sends packets.
517
518 (% style="color:#037691" %)**c:**(%%)** **Specify the sampling interval: range **(0 ~~ 255 minutes)**
519
520 (% style="color:#037691" %)**d:**(%%)** **How many entries should be uplink on every TDC **(max 32)**
521
522 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SPH01-NB_NB-IoT_Soil_pH_Sensor_User_Manual/WebHome/image-20240315141254-1.png?rev=1.1||alt="image-20240315141254-1.png"]]
523
524
525 **Example:**
526
527 **AT+CLOCKLOG=1,65535,1,5**
528
529 After the node sends the first packet, data is recorded to the memory at intervals of 1 minute. For each TDC uplink, the uplink load will include: battery information + the last 5 memory records (payload + timestamp).
530
531 [[image:image-20240315174859-1.png||height="516" width="1213"]]
532
533 (% style="color:red" %)**Note: Users need to synchronize the server time before configuring this command. If the server time is not synchronized before this command is configured, the command takes effect only after the node is reset.**
534
535
536 == 2.8 Example Query saved historical records ==
537
538
539 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+CDP(%%)**
540
541 This command can be used to search the saved history, recording up to 32 groups of data, each group of historical data contains a maximum of 100 bytes.
542
543 [[image:image-20240315174946-2.png||height="615" width="806"]]
544
545
546 == 2.9 Uplink log query ==
547
548 * (% style="color:blue" %)**AT command:**(%%)** (% style="color:#037691" %)AT+GETLOG(%%)**
549
550 This command can be used to query upstream logs of data packets.
551
552 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PS-NB-NA_NB-IoT_Analog_Sensor_User_Manual/WebHome/image-20240407191922-2.png?width=903&height=631&rev=1.1||alt="image-20240407191922-2.png"]]
553
554
555
556 = 3. Configure LMS01-NB =
557
558 == 3.1 Configure Methods ==
559
560
561 LMS01-NB supports below configure method:
562
563 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
564
565 * 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]].
566
567 == 3.2 AT Commands Set ==
568
569
570 AT+<CMD>?        : Help on <CMD>
571
572 AT+<CMD>         : Run <CMD>
573
574 AT+<CMD>=<value> : Set the value
575
576 AT+<CMD>=?       : Get the value
577
578
579 (% style="color:blue" %)**General Commands**      
580
581 AT                    : Attention       
582
583 AT?  : Short Help     
584
585 ATZ  : MCU Reset    
586
587 AT+TDC  : Application Data Transmission Interval
588
589 AT+CFG  : Print all configurations
590
591 AT+CFGMOD           : Working mode selection
592
593 AT+DEUI  : Get or set the Device ID
594
595 AT+INTMOD            : Set the trigger interrupt mode
596
597 AT+5VT           : Set extend the time of 5V power  
598
599 AT+PRO          : Choose agreement
600
601 AT+RXDL  : Extend the sending and receiving time
602
603 AT+DNSCFG  : Get or Set DNS Server
604
605 AT+GETSENSORVALUE   : Returns the current sensor measurement
606
607 AT+NOUD  : Get or Set the number of data to be uploaded
608
609 AT+CDP     : Read or Clear cached data
610
611 AT+SHTEMP:  Get or Set alarm of temp
612
613 AT+SHHUM:  Get or Set alarm of moisture
614
615 AT+SERVADDR :  Server Address
616
617
618 (% style="color:blue" %)**MQTT Management**
619
620 AT+CLIENT               : Get or Set MQTT client
621
622 AT+UNAME              : Get or Set MQTT Username
623
624 AT+PWD                  : Get or Set MQTT password
625
626 AT+PUBTOPIC  : Get or Set MQTT publish topic
627
628 AT+SUBTOPIC  : Get or Set MQTT subscription topic
629
630
631 (% style="color:blue" %)**Information**          
632
633 AT+FDR  : Factory Data Reset
634
635 AT+PWORD  : Serial Access Password
636
637 AT+LDATA  : Get the last upload data
638
639 AT+CDP  : Read or Clear cached data
640
641
642 = 4. Battery & Power Consumption =
643
644
645 LMS01-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
646
647 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
648
649
650 = 5. Firmware update =
651
652
653 User can change device firmware to::
654
655 * Update with new features.
656
657 * Fix bugs.
658
659 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/16ynrme8s0bmkaw/AAD0kvRmNSkf0Jz54OCxQnPRa?dl=0]]**
660
661 Methods to Update Firmware:
662
663 * (Recommended way) OTA firmware update via BLE: [[**Instruction**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
664
665 * Update through UART TTL interface : **[[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]]**.
666
667 = 6. FAQ =
668
669 == 6.1 How can I access t BC660K-GL AT Commands? ==
670
671
672 User can access to BC660K-GL directly and send AT Commands.
673
674 [[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
675
676
677 = 7. Order Info =
678
679
680 Part Number: (% style="color:blue" %)**LMS01-NB-XX**
681
682 (% style="color:red" %)**XX**(%%):
683
684 * (% style="color:#037691" %)**GE**(%%): General version ( Exclude SIM card)
685
686 * (% style="color:#037691" %)**1D**(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
687
688 (% style="color:#037691" %)**1NCE SIM Card NB-IoT network coverage**(%%): Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
689
690
691 = 8. ​Packing Info =
692
693
694 (% style="color:#037691" %)**Package Includes**:
695
696 * LMS01-NB NB-IoT Leaf Moisture Sensor x 1
697
698 * External antenna x 1
699
700 (% style="color:#037691" %)**Dimension and weight**:
701
702 * Device Size: cm
703
704 * Device Weight: g
705
706 * Package Size / pcs : cm
707
708 * Weight / pcs : g
709
710 = 9. Support =
711
712
713 * 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.
714
715 * 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]].
716
717 (% style="display:none" %) (%%)

Applications

Navigation

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