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