Version 242.1 by Ellie Zhang on 2023/07/01 15:11
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20230203113613-1.png]]
3
4
5
6
7 **Table of Contents:**
8
9 {{toc/}}
10
11
12
13
14
15
16
17
18 = 1.  Introduction =
19
20 == 1.1 ​ What is LMDS120 Microwave Radar Distance Sensor ==
21
22
23 (((
24 The Dragino LMDS120 is a (% style="color:blue" %)**LoRaWAN Microwave Radar distance sensor**(%%). It uses use Microwave Radar to detect the distance between sensor and different objects. Different from ultrosonic or Lidar measurement. Microwave Radar is (% style="color:blue" %)**more reliable for condensation / dusty environment**(%%). It can sense correct distance even there is water or think dust on top of the sensor.
25 )))
26
27 (((
28 The LMDS120 can be applied to scenarios such as horizontal distance measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, etc.
29 )))
30
31 (((
32 The LoRa wireless technology used in LMDS120 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.
33 )))
34
35 (((
36 LMDS120 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
37 )))
38
39 (((
40 Each LMDS120 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.
41 )))
42
43
44 [[image:image-20230203114147-2.png]]
45
46
47 == ​1.2  Features ==
48
49
50 * LoRaWAN 1.0.3 Class A
51 * Ultra-low power consumption
52 * 60Ghz Microwave Radar for distance detection
53 * Monitor Battery Level
54 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
55 * AT Commands to change parameters
56 * Uplink on periodically
57 * Downlink to change configure
58 * 8500mAh Battery for long term use
59 * Wall Mountable
60 * Outdoor Use
61
62
63 == 1.3  Radar probe specification ==
64
65
66 * Measuring Method: FMCW
67 * Frequency: 60 GHz
68 * Measure Range : 150mm ~~ 12000mm
69 * Accuracy: ± (3mm + S*0.2%). S: Measure Value
70 * Resolution: 0.01m
71 * Measurement Angle : 25 degrees horizontal and 23 degrees vertical
72
73
74 == 1.4  Storage & Operation Temperature ==
75
76
77 -15°C to +65°C
78
79
80 == 1.5 ​ Applications ==
81
82
83 * Horizontal distance measurement
84 * Liquid level measurement
85 * Parking management system
86 * Object proximity and presence detection
87 * Intelligent trash can management system
88 * Robot obstacle avoidance
89 * Automatic control
90 * Sewer
91 * Bottom water level monitoring
92
93
94 == 1.6  Pin mapping and power on ==
95
96
97 [[image:1655257026882-201.png]]
98
99 (% style="display:none" %) (%%)
100
101 = 2.  Operation Mode =
102
103 == 2.1  How it works ==
104
105
106 (((
107 Each LMDS120 is shipped with a worldwide unique set of OTAA keys. To use LMDS120 in a LoRaWAN network, user needs to input the OTAA keys in the LoRaWAN network server. So LMDS120 can join the LoRaWAN network and start to transmit sensor data.
108 )))
109
110
111 == 2.2  ​Example to use for LoRaWAN network ==
112
113
114 (((
115 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 [[DLOS8 >>https://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]] as a LoRaWAN gateway in this example.
116 )))
117
118 (((
119 [[image:image-20230203115545-3.png]]
120
121 * In this user case, the LMDS120 is installed on top of river to detect the water level and send the level info to the LoRaWAN server. The LMDS120 will uplink different types of messages to the LoRaWAN server. See [[Uplink payload>>path:#Uplink_Payload]] for detail.
122 )))
123
124 (((
125 Assume the LoRaWAN Gateway DLOS8 is already set to connect to the [[TTN V3 network >>url:https://eu1.cloud.thethings.network]]. We need to add the LMDS120 device in TTN V3:
126 )))
127
128 (((
129 (((
130
131 )))
132
133 (((
134 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from LMDS120.
135 )))
136 )))
137
138 (((
139 (((
140 Each LMDS120 is shipped with a sticker with the default device keys, user can find this sticker in the box. it looks like below.
141
142 [[image:image-20230426085652-1.png||height="258" width="556"]]
143
144
145 )))
146 )))
147
148 Users can enter these keys in the LoRaWAN Server portal. Below is the TTN V3 screenshot:
149
150 __**Add APP EUI**__ in the application.
151
152
153 [[image:image-20220610161353-4.png]]
154
155
156 [[image:image-20220610161353-5.png]]
157
158
159 [[image:image-20220610161353-6.png]]
160
161
162 [[image:image-20220610161353-7.png]]
163
164
165
166 You can also choose to create the device manually.
167
168 [[image:image-20220610161538-8.png]]
169
170
171
172 **Add APP KEY and DEV EUI**
173
174 [[image:1655278497961-944.png]]
175
176
177 (% style="color:blue" %)**Step 2**(%%):  Power on LMDS120
178
179
180 Put a Jumper on JP2 to power on the device. ( The Switch must be in FLASH position).
181
182 [[image:1655278589727-228.png]]
183
184 (((
185 Put the jumper to power on LMDS120 and it will auto-join to the TTN V3 network. After join success, it will start to upload sensor data to TTN V3 and the user can see it in the panel.
186 )))
187
188
189 == 2.3  ​Uplink Payload ==
190
191
192 Uplink payloads have two types:
193
194 * Distance Value: Use FPORT=2
195 * Other control commands: Use other FPORT fields.
196
197 The application server should parse the correct value based on FPORT settings.
198
199
200 === 2.3.1  Device Status, FPORT~=5 ===
201
202
203 (((
204 Include device configure status. Once LMDS120 Joined the network, it will uplink this message to the server.
205 )))
206
207 Users can also use the downlink command (0x26 01) to ask LMDS120 to resend Device Status.
208
209 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:490px" %)
210 |=(% colspan="6" style="background-color:#4F81BD;color:white" %)Device Status (FPORT=5)
211 |(% style="width:60px" %)**Size(bytes)**|(% style="width:80px" %)**1**|(% style="width:140px" %)**2**|(% style="width:140px" %)**1**|(% style="width:70px" %)**1**
212 |(% style="width:94px" %)**Value**|(% style="width:68px" %)Sensor Model|(% style="width:80px" %)Firmware Version|(% style="width:86px" %)Frequency Band|(% style="width:61px" %)Sub-band
213
214 [[image:image-20230203133803-4.png]]
215
216
217 * (% style="color:#037691" %)**Sensor Model:**(%%) For LMDS120, this value is 0x18
218
219 * (% style="color:#037691" %)**Firmware Version:**(%%) 0x0100, Means: v1.0.0 version
220
221 * (% style="color:#037691" %)**Frequency Band:**
222
223 *0x01: EU868
224
225 *0x02: US915
226
227 *0x03: IN865
228
229 *0x04: AU915
230
231 *0x05: KZ865
232
233 *0x06: RU864
234
235 *0x07: AS923
236
237 *0x08: AS923-1
238
239 *0x09: AS923-2
240
241 *0x0a: AS923-3
242
243 *0x0b: AS923-4
244
245
246 * (% style="color:#037691" %)**Sub-Band**(%%)**:**
247 ** AU915 and US915:value 0x00 ~~ 0x08
248 ** CN470: value 0x0B ~~ 0x0C
249 ** Other Bands: Always 0x00
250
251
252 === 2.3.2  Distance, Uplink FPORT~=2 ===
253
254
255 LMDS120 will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LMDS120 will:
256
257 1. periodically send this uplink every 20 minute (TDC time), this interval [[can be changed>>||anchor="H3.1A0SetTransmitIntervalTime280x0129"]].
258 1. send this uplink while there is [[interrupt event>>||anchor="H3.2A0SetInterruptMode280x0629"]].
259
260 Uplink Payload totals 8 bytes.
261
262 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:400px" %)
263 |=(% colspan="6" style="width: 400px;background-color:#4F81BD;color:white" %)**Distance Value, FPORT=2**
264 |(% style="width:60px" %)**Size(bytes)**|(% style="width:40px" %)**2**|(% style="width:60px" %)**2**|(% style="width:60px" %)**1**|(% style="width:100px" %)**2**|(% style="width:80px" %)**1**
265 |(% style="width:72px" %)**Value**|(% style="width:43px" %)BAT|(% style="width:76px" %)Distance|(% style="width:76px" %)interrupt|(% style="width:75px" %)DS18B20 temperature|(% style="width:75px" %)Sensor flag
266
267 [[image:image-20230203142732-5.png]]
268
269
270 (((
271 (% style="color:blue" %)**Distance:**
272 )))
273
274 (((
275 Distance between sensor probe to the first object. (unit: mm)
276 )))
277
278 (((
279 For example, if the data you get from the register is** __0x0D 0xC6__**, the distance between the sensor and the measured object is(% style="color:#037691" %)** 0DC6(H) = 3526 (D) = 3526 mm.**
280 )))
281
282
283 (((
284 (% style="color:red" %)**Notice: The distance has a special value :**
285 )))
286
287 (((
288 (% style="color:blue" %)**0x3FFF**(%%): Reading Invalid (exceed the valid range of the probe) or Probe not detected.
289 )))
290
291
292 === 2.3.3  Decoder in TTN V3 ===
293
294
295 [[image:1655261164557-670.png]]
296
297
298 (((
299 Please check the decoder from this link: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
300 )))
301
302
303 == 2.4  ​Show data on Datacake ==
304
305
306 (((
307 Datacake IoT platform provides a human-friendly interface to show the sensor data, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:
308
309
310 )))
311
312 (((
313 (% style="color:blue" %)**Step 1**(%%)**: **Link TTNv3 to [[DATACAKE>>url:https://datacake.co/]]
314 )))
315
316 (((
317 (% style="color:blue" %)**Step 2**(%%)**: **Configure LMDS120 in Datacake
318 )))
319
320
321 [[image:image-20230203150230-6.png]]
322
323
324 [[image:image-20220615163646-7.png]]
325
326
327 [[image:image-20230203150402-8.png]]
328
329
330 [[image:image-20230203150513-9.png]]
331
332 (% style="display:none" %) (%%)
333
334 [[image:image-20230203150531-10.png]](% style="display:none" %)
335
336
337 (% style="display:none" %)
338
339 (% style="display:none" %) (%%) [[image:image-20230203150555-11.png]]
340
341
342 (% style="display:none" %)
343
344 = 3.  Configure LMDS120 via AT Command or LoRaWAN Downlink =
345
346
347 (((
348 (((
349 Use can configure LMDS120 via AT Command or LoRaWAN Downlink.
350 )))
351 )))
352
353 * (((
354 (((
355 AT Command Connection: See [[FAQ>>||anchor="H5.A0FAQ"]].
356 )))
357 )))
358 * (((
359 (((
360 LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]]
361 )))
362 )))
363
364 (((
365 (((
366
367 )))
368
369 (((
370 There are two kinds of commands to configure LMDS120, they are:
371 )))
372 )))
373
374 * (((
375 (((
376 (% style="color:#4f81bd" %)** General Commands**.
377 )))
378 )))
379
380 (((
381 (((
382 These commands are to configure:
383 )))
384 )))
385
386 * (((
387 (((
388 General system settings like: uplink interval.
389 )))
390 )))
391 * (((
392 (((
393 LoRaWAN protocol & radio related command.
394 )))
395 )))
396
397 (((
398 (((
399 They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack**(Note~*~*)**. These commands can be found on the wiki: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
400 )))
401 )))
402
403 (((
404 (((
405
406 )))
407 )))
408
409 * (((
410 (((
411 (% style="color:#4f81bd" %)** Commands special design for LMDS120**
412 )))
413 )))
414
415 (((
416 (((
417 These commands only valid for LMDS120, as below:
418 )))
419 )))
420
421
422 == 3.1  Set Transmit Interval Time(0x01) ==
423
424
425 Feature: Change LoRaWAN End Node Transmit Interval.
426
427 (% style="color:#037691" %)**AT Command: AT+TDC**
428
429 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
430 |=(% 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**
431 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
432 30000
433 OK
434 the interval is 30000ms = 30s
435 )))
436 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
437 OK
438 Set transmit interval to 60000ms = 60 seconds
439 )))
440
441 (((
442 (% style="color:#037691" %)**Downlink Command: 0x01**
443 )))
444
445 Format: Command Code (0x01) followed by 3 bytes time value.
446
447 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
448
449 **Example 1:** Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
450
451 **Example 2: **Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
452
453
454 == 3.2  Set Interrupt Mode(0x06) ==
455
456
457 (((
458 Feature, Set Interrupt mode for GPIO_EXIT.
459 )))
460
461 (((
462 (% style="color:#037691" %)**Downlink Command: AT+INTMOD**
463 )))
464
465 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
466 |=(% style="width: 154px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 196px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 157px;background-color:#4F81BD;color:white" %)**Response**
467 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
468 0
469 OK
470 the mode is 0 = No interruption
471 )))
472 |(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
473 Set Transmit Interval
474 ~1. (Disable Interrupt),
475 2. (Trigger by rising and falling edge)
476 3. (Trigger by falling edge)
477 4. (Trigger by rising edge)
478 )))|(% style="width:157px" %)OK
479
480 (% style="color:#037691" %)**Downlink Command: 0x06**
481
482 Format: Command Code (0x06) followed by 3 bytes.
483
484 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
485
486 **Example 1: **Downlink Payload: 06000000  ~/~/ Turn off interrupt mode
487
488 **Example 2:** Downlink Payload: 06000003  ~/~/ Set the interrupt mode to rising edge trigger
489
490
491 = 4. Battery & Power Consumption =
492
493
494 LMDS120 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
495
496 [[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
497
498
499 = 5.  FAQ =
500
501 == 5.1  How to use AT Command to configure LMDS120 ==
502
503
504 LMDS120 UART connection photo
505
506
507 [[image:image-20230203155404-15.png]]
508
509
510 LMDS120 supports AT Command set. User can use a USB to TTL adapter plus the 3.5mm Program Cable to connect to LMDS120 to use AT command, as below.
511
512 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/test/WebHome/1654135840598-282.png?rev=1.1||alt="1654135840598-282.png"]]
513
514
515 In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LMDS120. LMDS120 will output system info once power on as below:
516
517 [[image:image-20220615180555-4.png]]
518
519
520 == 5.2  How to upgrade the firmware? ==
521
522
523 (((
524 A new firmware might be available for:
525 )))
526
527 * (((
528 Support new features
529 )))
530 * (((
531 For bug fix
532 )))
533 * (((
534 Change LoRaWAN bands.
535 )))
536
537 (((
538 Instruction for how to upgrade: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]]
539 )))
540
541 (((
542 Firmware location: [[https:~~/~~/www.dropbox.com/sh/vxhj7k0utq5dk4a/AAC-DW1UeeWSnSPeG-lHWg4da?dl=0>>https://www.dropbox.com/sh/vxhj7k0utq5dk4a/AAC-DW1UeeWSnSPeG-lHWg4da?dl=0]]
543 )))
544
545
546 == 5.3  How to change the LoRa Frequency Bands/Region ==
547
548
549 You can follow the instructions for [[how to upgrade image>>||anchor="H5.2A0Howtoupgradethefirmware3F"]].
550 When downloading the images, choose the required image file for download. ​
551
552
553 = 6.  Trouble Shooting =
554
555 == 6.1  AT Command input doesn't work ==
556
557
558 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.
559
560
561 = 7.  Order Info =
562
563
564 Part Number **:** (% style="color:blue" %)**LMDS120-XX**
565
566 (% style="color:blue" %)**XX**(%%)**: **The default frequency band
567
568 * (% style="color:red" %)**AS923 **(%%)**:** LoRaWAN AS923 band
569 * (% style="color:red" %)**AU915 **(%%)**:** LoRaWAN AU915 band
570 * (% style="color:red" %)**EU433 **(%%)**:** LoRaWAN EU433 band
571 * (% style="color:red" %)**EU868 **(%%)**:** LoRaWAN EU868 band
572 * (% style="color:red" %)**KR920 **(%%)**:** LoRaWAN KR920 band
573 * (% style="color:red" %)**US915 **(%%)**:** LoRaWAN US915 band
574 * (% style="color:red" %)**IN865 **(%%)**:**  LoRaWAN IN865 band
575 * (% style="color:red" %)**CN470 **(%%)**:** LoRaWAN CN470 band
576
577
578 = 8. ​ Packing Info =
579
580
581 (((
582 **Package Includes**:
583 )))
584
585 (((
586 * LMDS120 LoRaWAN Microwave Radar Distance Sensor x 1
587 )))
588
589
590
591 = 9.  ​Support =
592
593
594 * 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.
595
596 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]].

Applications

Navigation

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