Skip to Content
Version 238.3 by Xiaoling on 2023/02/03 15:46
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20230203113613-1.png]]
3
4
5
6
7 **Table of Contents:**
8
9
10
11
12
13
14
15
16
17 = 1.  Introduction =
18
19 == 1.1 ​ What is LMDS120 Microwave Radar DistanceSensor ==
20
21
22 (((
23 The Dragino LMDS120 is a 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 more reliable for condensation / dusty environment. It can sense correct distance even there is water or think dust on top of the sensor.
24
25 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.
26
27 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.
28
29 LMDS120 is powered by 8500mAh Li-SOCI2 battery, it is designed for long term use up to 5 years.
30
31 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.
32 )))
33
34
35 [[image:image-20230203114147-2.png]]
36
37
38 == ​1.2  Features ==
39
40
41 * LoRaWAN 1.0.3 Class A
42 * Ultra-low power consumption
43 * 60Ghz Microwave Radar for distance detection
44 * Monitor Battery Level
45 * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
46 * AT Commands to change parameters
47 * Uplink on periodically
48 * Downlink to change configure
49 * 8500mAh Battery for long term use
50 * Wall Mountable
51 * Outdoor Use
52
53 == 1.3  Radar probe specification ==
54
55
56 * Measuring Method: FMCW
57 * Frequency: 60 GHz
58 * Measure Range : 15cm ~~ 1200cm
59 * Accuracy:± (3mm + S*02%). S: Measure Value
60 * Resolution: 0.01m
61 * Measurement Angle : 25 degrees horizontal and 23 degrees vertical
62
63 == 1.4  Storage & Operation Temperature ==
64
65
66 -15°C to +65°C
67
68
69 == 1.5 ​ Applications ==
70
71
72 * Horizontal distance measurement
73 * Liquid level measurement
74 * Parking management system
75 * Object proximity and presence detection
76 * Intelligent trash can management system
77 * Robot obstacle avoidance
78 * Automatic control
79 * Sewer
80 * Bottom water level monitoring
81
82 == 1.6  Pin mapping and power on ==
83
84
85 [[image:1655257026882-201.png]]
86
87 (% style="display:none" %) (%%)
88
89 = 2.  Operation Mode =
90
91 == 2.1  How it works ==
92
93
94 (((
95 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.
96 )))
97
98
99 == 2.2  ​Example to use for LoRaWAN network ==
100
101
102 (((
103 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 [[LG308>>url:http://www.dragino.com/products/lora/item/140-lg308.html]] as a LoRaWAN gateway in this example.
104 )))
105
106 (((
107 [[image:image-20230203115545-3.png]]
108
109 * 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.
110 )))
111
112 (((
113 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:
114 )))
115
116 (((
117 (((
118
119 )))
120
121 (((
122 (% style="color:blue" %)**Step 1**(%%): Create a device in TTN with the OTAA keys from LMDS120.
123 )))
124 )))
125
126 (((
127 (((
128 Each LMDS120 is shipped with a sticker with the default device keys, user can find this sticker in the box. it looks like below.
129
130 [[image:1655278302970-688.png]]
131
132
133 )))
134 )))
135
136 Users can enter these keys in the LoRaWAN Server portal. Below is the TTN V3 screenshot:
137
138 __**Add APP EUI**__ in the application.
139
140
141 [[image:image-20220610161353-4.png]]
142
143
144 [[image:image-20220610161353-5.png]]
145
146
147 [[image:image-20220610161353-6.png]]
148
149
150 [[image:image-20220610161353-7.png]]
151
152
153
154 You can also choose to create the device manually.
155
156 [[image:image-20220610161538-8.png]]
157
158
159
160 **Add APP KEY and DEV EUI**
161
162 [[image:1655278497961-944.png]]
163
164
165 (% style="color:blue" %)**Step 2**(%%):  Power on LMDS120
166
167
168 Put a Jumper on JP2 to power on the device. ( The Switch must be in FLASH position).
169
170 [[image:1655278589727-228.png]]
171
172 (((
173 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.
174 )))
175
176
177 == 2.3  ​Uplink Payload ==
178
179
180 Uplink payloads have two types:
181
182 * Distance Value: Use FPORT=2
183 * Other control commands: Use other FPORT fields.
184
185 The application server should parse the correct value based on FPORT settings.
186
187
188 === 2.3.1  Device Status, FPORT~=5 ===
189
190
191 (((
192 Include device configure status. Once LMDS120 Joined the network, it will uplink this message to the server.
193 )))
194
195 (((
196 Users can also use the downlink command (0x26 01) to ask LMDS120 to resend Device Status.
197 )))
198
199 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
200 |(% colspan="6" %)**Device Status (FPORT=5)**
201 |(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
202 |(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT
203
204 [[image:image-20230203133803-4.png]]
205
206
207 * (% style="color:#037691" %)**Sensor Model**(%%)**:** For LMDS120, this value is 0x18
208
209 * (% style="color:#037691" %)**Firmware Version**(%%)**:** 0x0100, Means: v1.0.0 version
210
211 * (% style="color:#037691" %)**Frequency Band**(%%)**:**
212
213 *0x01: EU868
214
215 *0x02: US915
216
217 *0x03: IN865
218
219 *0x04: AU915
220
221 *0x05: KZ865
222
223 *0x06: RU864
224
225 *0x07: AS923
226
227 *0x08: AS923-1
228
229 *0x09: AS923-2
230
231 *0x0a: AS923-3
232
233 *0x0b: AS923-3
234
235
236
237 * (% style="color:#037691" %)**Sub-Band**(%%)**:**
238 ** AU915 and US915:value 0x00 ~~ 0x08
239 ** CN470: value 0x0B ~~ 0x0C
240 ** Other Bands: Always 0x00
241
242 === 2.3.2  Distance, Uplink FPORT~=2 ===
243
244
245 LMDS120 will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LMDS120 will:
246
247 1. periodically send this uplink every 20 minute (TDC time), this interval [[can be changed>>||anchor="H3.1A0SetTransmitIntervalTime280x0129"]].
248 1. send this uplink while there is [[interrupt event>>||anchor="H3.5A0SetInterruptMode280x0629"]].
249
250 Uplink Payload totals 11 bytes.
251
252
253 (% border="1" cellspacing="4" style="background-color:#f7faff; width:370px" %)
254 |=(% colspan="6" style="width: 367px;" %)**Distance Value, FPORT=2**
255 |(% style="width:72px" %)**Size(bytes)**|(% style="width:43px" %)**2**|(% style="width:76px" %)**2**|(% style="width:76px" %)**1**|(% style="width:75px" %)**2**|(% style="width:75px" %)**1**
256 |(% style="width:72px" %)**Value**|(% style="width:43px" %)[[BAT>>||anchor="H2.3.1A0DeviceStatus2CFPORT3D5"]]|(% style="width:76px" %)Distance|(% style="width:76px" %)interrupt|(% style="width:75px" %)DS18B20 temperature|(% style="width:75px" %)Sensor flag
257
258 [[image:image-20230203142732-5.png]]
259
260
261
262 (((
263 (% style="color:#037691" %)**Distance:**
264 )))
265
266 (((
267 Distance between sensor probe to the first object. (unit: cm)
268 )))
269
270 (((
271 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) = 115 (D) = 115 cm.**
272 )))
273
274
275 (((
276 (% style="color:red" %)**Notice: The distance has a special value :**
277 )))
278
279 * (((
280 **0x3FFF**: Reading Invalid (exceed the valid range of the probe) or Probe not detected
281 )))
282
283 === 2.3.3  Decoder in TTN V3 ===
284
285
286 [[image:1655261164557-670.png]]
287
288 (((
289 (((
290 Please check the decoder from this link: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
291
292
293 )))
294 )))
295
296 == 2.4  ​Show data on Datacake ==
297
298
299 (((
300 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:
301
302
303 )))
304
305 (((
306 (% style="color:blue" %)**Step 1**(%%)**: **Link TTNv3 to [[DATACAKE>>url:https://datacake.co/]]
307 )))
308
309 (((
310 (% style="color:blue" %)**Step 2**(%%)**: **Configure LMDS120 in Datacake
311 )))
312
313
314 [[image:image-20230203150230-6.png]]
315
316
317 [[image:image-20220615163646-7.png]]
318
319
320 [[image:image-20230203150402-8.png]]
321
322
323 [[image:image-20220615163646-8.png]]
324
325
326
327 [[image:image-20230203150513-9.png]]
328
329 (% style="display:none" %) (%%)
330
331 [[image:image-20230203150531-10.png]](% style="display:none" %)
332
333
334 (% style="display:none" %)
335
336 (% style="display:none" %) (%%) [[image:image-20230203150555-11.png]]
337
338 (% style="display:none" %)
339
340
341
342 = 3.  Configure LMDS200 via AT Command or LoRaWAN Downlink =
343
344
345 (((
346 (((
347 Use can configure LMDS200 via AT Command or LoRaWAN Downlink.
348 )))
349 )))
350
351 * (((
352 (((
353 AT Command Connection: See [[FAQ>>||anchor="H5.A0FAQ"]].
354 )))
355 )))
356 * (((
357 (((
358 LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>doc:Main.WebHome]]
359 )))
360 )))
361
362 (((
363 (((
364
365 )))
366
367 (((
368 There are two kinds of commands to configure LMDS200, they are:
369 )))
370 )))
371
372 * (((
373 (((
374 (% style="color:#4f81bd" %)** General Commands**.
375 )))
376 )))
377
378 (((
379 (((
380 These commands are to configure:
381 )))
382 )))
383
384 * (((
385 (((
386 General system settings like: uplink interval.
387 )))
388 )))
389 * (((
390 (((
391 LoRaWAN protocol & radio related command.
392 )))
393 )))
394
395 (((
396 (((
397 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]]
398 )))
399 )))
400
401 (((
402 (((
403
404 )))
405 )))
406
407 * (((
408 (((
409 (% style="color:#4f81bd" %)** Commands special design for LMDS200**
410 )))
411 )))
412
413 (((
414 (((
415 These commands only valid for LMDS200, as below:
416 )))
417 )))
418
419
420 == 3.1  Set Transmit Interval Time(0x01) ==
421
422
423 Feature: Change LoRaWAN End Node Transmit Interval.
424
425 (% style="color:#037691" %)**AT Command: AT+TDC**
426
427 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
428 |=(% style="width: 156px;" %)**Command Example**|=(% style="width: 137px;" %)**Function**|=**Response**
429 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
430 30000
431 OK
432 the interval is 30000ms = 30s
433 )))
434 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
435 OK
436 Set transmit interval to 60000ms = 60 seconds
437 )))
438
439 (((
440 (% style="color:#037691" %)**Downlink Command: 0x01**
441 )))
442
443 Format: Command Code (0x01) followed by 3 bytes time value.
444
445 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
446
447 Example 1: Downlink Payload: 0100001E  ~/~/  Set Transmit Interval (TDC) = 30 seconds
448
449 Example 2: Downlink Payload: 0100003C  ~/~/  Set Transmit Interval (TDC) = 60 seconds
450
451
452 == 3.2  Set Interrupt Mode(0x06) ==
453
454
455 (((
456 Feature, Set Interrupt mode for GPIO_EXIT.
457 )))
458
459 (((
460 (% style="color:#037691" %)**Downlink Command: AT+INTMOD**
461 )))
462
463 (% border="1" cellspacing="4" style="background-color:#f7faff; color:black; width:510px" %)
464 |=(% style="width: 154px;" %)**Command Example**|=(% style="width: 196px;" %)**Function**|=(% style="width: 157px;" %)**Response**
465 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
466 0
467 OK
468 the mode is 0 = No interruption
469 )))
470 |(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
471 Set Transmit Interval
472 ~1. (Disable Interrupt),
473 2. (Trigger by rising and falling edge)
474 3. (Trigger by falling edge)
475 4. (Trigger by rising edge)
476 )))|(% style="width:157px" %)OK
477
478 (% style="color:#037691" %)**Downlink Command: 0x06**
479
480 Format: Command Code (0x06) followed by 3 bytes.
481
482 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
483
484 Example 1: Downlink Payload: 06000000  ~/~/ Turn off interrupt mode
485
486 Example 2: Downlink Payload: 06000003  ~/~/ Set the interrupt mode to rising edge trigger
487
488
489 = 4. Battery & how to replace =
490
491 == 4.1 Battery Type ==
492
493
494 LMDS120 is equipped with a [[8500mAH ER26500 Li-SOCI2 battery>>https://www.dropbox.com/sh/w9l2oa3ytpculph/AAAPtt-apH4lYfCj-2Y6lHvQa?dl=0]]. The battery is un-rechargeable battery with low discharge rate targeting for 8~~10 years use. This type of battery is commonly used in IoT target for long-term running, such as water meter.
495
496 The discharge curve is not linear so can't simply use percentage to show the battery level. Below is the battery performance.
497
498 [[image:image-20230203154536-12.png]]
499
500
501 Minimum Working Voltage for the LMDS120:
502
503 LMDS120:  2.45v ~~ 3.6v
504
505
506 == 4.2 Replace Battery ==
507
508
509 Any battery with range 2.45 ~~ 3.6v can be a replacement. We recommend to use Li-SOCl2 Battery.
510
511 And make sure the positive and negative pins match.
512
513
514 == 4.3 Power Consumption Analyze ==
515
516
517 Dragino Battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
518
519 Instruction to use as below:
520
521 (% style="color:blue" %)**Step 1:**(%%) Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0>>https://www.dropbox.com/sh/zwex6i331j5oeq2/AACIMf9f_v2qsJ39CuMQ5Py_a?dl=0]]
522
523 (% style="color:blue" %)**Step 2:**(%%) Open it and choose
524
525 * Product Model
526 * Uplink Interval
527 * Working Mode
528
529 And the Life expectation in difference case will be shown on the right.
530
531 [[image:image-20230203154554-13.png]]
532
533
534 The battery related documents as below:
535
536 * [[Battery Dimension>>https://www.dropbox.com/s/ox5g9njwjle7aw3/LSN50-Battery-Dimension.pdf?dl=0]],
537 * [[Lithium-Thionyl Chloride Battery datasheet, Tech Spec>>https://www.dropbox.com/sh/d4oyfnp8o94180o/AABQewCNSh5GPeQH86UxRgQQa?dl=0]]
538 * [[Lithium-ion Battery-Capacitor datasheet>>https://www.dropbox.com/s/791gjes2lcbfi1p/SPC_1520_datasheet.jpg?dl=0]], [[Tech Spec>>https://www.dropbox.com/s/4pkepr9qqqvtzf2/SPC1520%20Technical%20Specification20171123.pdf?dl=0]]
539
540 [[image:image-20230203154622-14.png]]
541
542
543 === 4.3.1 ​Battery Note ===
544
545
546 The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
547
548
549 === 4.3.2 Replace the battery ===
550
551
552 You can change the battery in the LMDS120.The type of battery is not limited as long as the output is between 3v to 3.6v. On the main board, there is a diode (D1) between the battery and the main circuit. If you need to use a battery with less than 3.3v, please remove the D1 and shortcut the two pads of it so there won't be voltage drop between battery and main board.
553
554 The default battery pack of LMDS120 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).
555
556
557 = 5.  FAQ =
558
559 == 5.1  How to use AT Command to configure LMDS120 ==
560
561
562 LMDS200 UART connection photo
563
564
565 [[image:image-20220615180555-3.png||height="541" width="863"]]
566
567
568 LMDS200 supports AT Command set. User can use a USB to TTL adapter plus the 3.5mm Program Cable to connect to LMDS200 to use AT command, as below.
569
570 [[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"]]
571
572
573 In the PC, you need to set the serial baud rate to (% style="color:green" %)**9600**(%%) to access the serial console for LMDS200. LMDS200 will output system info once power on as below:
574
575 [[image:image-20220615180555-4.png]]
576
577
578 == 5.2  How to upgrade the firmware? ==
579
580
581 (((
582 A new firmware might be available for:
583 )))
584
585 * (((
586 Support new features
587 )))
588 * (((
589 For bug fix
590 )))
591 * (((
592 Change LoRaWAN bands.
593 )))
594
595 (((
596 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]]
597 )))
598
599 (((
600
601 )))
602
603 (((
604 Firmware location: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LMDS200/Firmware/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/LDS03A/Firmware/]]
605 )))
606
607
608 == 5.3  How to change the LoRa Frequency Bands/Region ==
609
610
611 You can follow the instructions for [[how to upgrade image>>||anchor="H5.2A0Howtoupgradethefirmware3F"]].
612 When downloading the images, choose the required image file for download. ​
613
614
615 = 6.  Trouble Shooting =
616
617 == 6.1  AT Command input doesn't work ==
618
619
620 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.
621
622 (((
623
624 )))
625
626 = 7.  Order Info =
627
628
629 Part Number **:** (% style="color:blue" %)**LMDS200-XX**
630
631
632 (% style="color:blue" %)**XX**(%%)**: **The default frequency band
633
634 * (% style="color:red" %)**AS923 **(%%)**:** LoRaWAN AS923 band
635 * (% style="color:red" %)**AU915 **(%%)**:** LoRaWAN AU915 band
636 * (% style="color:red" %)**EU433 **(%%)**:** LoRaWAN EU433 band
637 * (% style="color:red" %)**EU868 **(%%)**:** LoRaWAN EU868 band
638 * (% style="color:red" %)**KR920 **(%%)**:** LoRaWAN KR920 band
639 * (% style="color:red" %)**US915 **(%%)**:** LoRaWAN US915 band
640 * (% style="color:red" %)**IN865 **(%%)**:**  LoRaWAN IN865 band
641 * (% style="color:red" %)**CN470 **(%%)**:** LoRaWAN CN470 band
642
643 = 8. ​ Packing Info =
644
645
646 (((
647 **Package Includes**:
648 )))
649
650 (((
651 LMDS200 LoRaWAN Microwave Radar Distance Sensor x 1
652
653
654 )))
655
656 = 9.  ​Support =
657
658
659 * 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.
660 * 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]].