Skip to Content
Version 127.1 by Mengting Qiu on 2023/12/06 14:35
Show last authors
1 (% style="text-align:center" %)
2 [[image:image-20231110085342-2.png||height="481" width="481"]]
3
4
5
6
7
8
9
10
11 **Table of Contents:(% style="display:none" %) (%%)**
12
13 {{toc/}}
14
15
16
17
18
19
20 = 1. Introduction =
21
22 == 1.1 What is LoRaWAN Smart Distance Detector ==
23
24
25 The Dragino (% style="color:blue" %)**DS20L is a smart distance detector**(%%) base on long-range wireless LoRaWAN technology. It uses (% style="color:blue" %)**LiDAR sensor**(%%) to detect the distance between DS20L and object, then DS20L will send the distance data to the IoT Platform via LoRaWAN. DS20L can measure range between 3cm ~~ 200cm.
26
27 DS20L allows users to send data and reach extremely long ranges via LoRaWAN. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current 
28 consumption. It targets professional wireless sensor network applications such smart cities, building automation, and so on.
29
30 DS20L has a (% style="color:blue" %)**built-in 2400mAh non-chargeable battery**(%%) for long-term use up to several years*. Users can also power DS20L with an external power source for (% style="color:blue" %)**continuous measuring and distance alarm / counting purposes.**
31
32 DS20L is fully compatible with (% style="color:blue" %)**LoRaWAN v1.0.3 Class A protocol**(%%), it can work with a standard LoRaWAN gateway.
33
34
35 [[image:image-20231110102635-5.png||height="402" width="807"]]
36
37
38 == 1.2 ​Features ==
39
40
41 * LoRaWAN Class A protocol
42 * LiDAR distance detector, range 3 ~~ 200cm
43 * Periodically detect or continuously detect mode
44 * AT Commands to change parameters
45 * Remotely configure parameters via LoRaWAN Downlink
46 * Alarm & Counting mode
47 * Firmware upgradable via program port or LoRa protocol
48 * Built-in 2400mAh battery or power by external power source
49
50
51
52 == 1.3 Specification ==
53
54
55 (% style="color:#037691" %)**LiDAR Sensor:**
56
57 * Operation Temperature: -40 ~~ 80 °C
58 * Operation Humidity: 0~~99.9%RH (no Dew)
59 * Storage Temperature: -10 ~~ 45°C
60 * Measure Range: 3cm~~200cm @ 90% reflectivity
61 * Accuracy: ±2cm @ (3cm~~100cm); ±5% @ (100~~200cm)
62 * ToF FoV: ±9°, Total 18°
63 * Light source: VCSEL
64
65
66
67 == 1.4 Power Consumption ==
68
69
70 (% style="color:#037691" %)**Battery Power Mode:**
71
72 * Idle: 0.003 mA @ 3.3v
73 * Max : 360 mA
74
75 (% style="color:#037691" %)**Continuously mode**:
76
77 * Idle: 21 mA @ 3.3v
78 * Max : 360 mA
79
80
81
82 = 2. Configure DS20L to connect to LoRaWAN network =
83
84 == 2.1 How it works ==
85
86
87 The DS20L is configured as (% style="color:#037691" %)**LoRaWAN OTAA Class A**(%%) mode by default. It has OTAA keys to join LoRaWAN network. To connect a local LoRaWAN network, you need to input the OTAA keys in the LoRaWAN IoT server and press the button to activate the DS20L. It will automatically join the network via OTAA and start to send the sensor value. The default uplink interval is 20 minutes.
88
89 (% style="display:none" %) (%%)
90
91 == 2.2 ​Quick guide to connect to LoRaWAN server (OTAA) ==
92
93
94 Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]] as a LoRaWAN gateway in this example.
95
96 The LPS8v2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.(% style="display:none" %)
97
98 [[image:image-20231110102635-5.png||height="402" width="807"]](% style="display:none" %)
99
100 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from DS20L.
101
102 Each DS20L is shipped with a sticker with the default device EUI as below:
103
104 [[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
105
106
107 You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
108
109
110 (% style="color:blue" %)**Register the device**
111
112 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/1654935135620-998.png?rev=1.1||alt="1654935135620-998.png"]]
113
114
115 (% style="color:blue" %)**Add APP EUI and DEV EUI**
116
117 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-4.png?width=753&height=551&rev=1.1||alt="图片-20220611161308-4.png"]]
118
119
120 (% style="color:blue" %)**Add APP EUI in the application**
121
122
123 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-5.png?width=742&height=601&rev=1.1||alt="图片-20220611161308-5.png"]]
124
125
126 (% style="color:blue" %)**Add APP KEY**
127
128 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1||alt="图片-20220611161308-6.png"]]
129
130
131 (% style="color:blue" %)**Step 2:**(%%) Activate on DS20L
132
133 [[image:image-20231128133704-1.png||height="189" width="441"]]
134
135 Press the button for 5 seconds to activate the DS20L.
136
137 (% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
138
139 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
140
141
142 == 2.3 ​Uplink Payload ==
143
144 === 2.3.1 Device Status, FPORT~=5 ===
145
146
147 Users can use the downlink command(**0x26 01**) to ask DS20L to send device configure detail, include device configure status. DS20L will uplink a payload via FPort=5 to server.
148
149 The Payload format is as below.
150
151 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
152 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
153 **Size(bytes)**
154 )))|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**1**|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**2**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 50px;" %)**2**
155 |(% style="width:62.5px" %)Value|(% style="width:110px" %)Sensor Model|(% style="width:48px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:91px" %)Sub-band|(% style="width:60px" %)BAT
156
157 Example parse in TTNv3
158
159 [[image:1701149922873-259.png]]
160
161 (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
162
163 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
164
165 (% style="color:blue" %)**Frequency Band**:
166
167 0x01: EU868
168
169 0x02: US915
170
171 0x03: IN865
172
173 0x04: AU915
174
175 0x05: KZ865
176
177 0x06: RU864
178
179 0x07: AS923
180
181 0x08: AS923-1
182
183 0x09: AS923-2
184
185 0x0a: AS923-3
186
187 0x0b: CN470
188
189 0x0c: EU433
190
191 0x0d: KR920
192
193 0x0e: MA869
194
195 (% style="color:blue" %)**Sub-Band**:
196
197 AU915 and US915:value 0x00 ~~ 0x08
198
199 CN470: value 0x0B ~~ 0x0C
200
201 Other Bands: Always 0x00
202
203 (% style="color:blue" %)**Battery Info**:
204
205 Check the battery voltage.
206
207 Ex1: 0x0B45 = 2885mV
208
209 Ex2: 0x0B49 = 2889mV
210
211
212 === 2.3.2 Uplink Payload, FPORT~=2 ===
213
214
215 ==== (% style="color:red" %)**MOD~=1**(%%) ====
216
217 Regularly detect distance and report. When the distance exceeds the limit, the alarm flag is set to 1, and the report can be triggered by external interrupts.
218
219 Uplink Payload totals 10 bytes.
220
221 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
222 |(% style="background-color:#4f81bd; color:white; width:60px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:30px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:100px" %)**1**|(% style="background-color:#4f81bd; color:white; width:120px" %)**4**
223 |(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+ Alarm+Interrupt|(% style="width:74px" %)Distance|(% style="width:100px" %)Sensor State|(% style="width:119px" %)Interrupt Count
224
225 [[image:1701155076393-719.png]]
226
227 (% style="color:blue" %)**Battery Info:**
228
229 Check the battery voltage for DS20L
230
231 Ex1: 0x0E10 = 3600mV
232
233
234 (% style="color:blue" %)**MOD & Alarm & Interrupt:**
235
236 (% style="color:red" %)**MOD:**
237
238 **Example: ** (0x60>>6) & 0x3f =1
239
240 **0x01:**  Regularly detect distance and report.
241 **0x02: ** Uninterrupted measurement (external power supply).
242
243 (% style="color:red" %)**Alarm:**
244
245 When the detection distance exceeds the limit, the alarm flag is set to 1.
246
247 (% style="color:red" %)**Interrupt:**
248
249 Whether it is an external interrupt.
250
251
252 (% style="color:blue" %)**Distance info:**
253
254 **Example**:
255
256 If payload is: 0708H: distance = 0708H = 1800 mm
257
258
259 (% style="color:blue" %)**Sensor State:**
260
261 Ex1: 0x00: Normal collection distance
262
263 Ex2 0x0x: Distance collection is wrong
264
265
266 (% style="color:blue" %)**Interript Count:**
267
268 If payload is:000007D0H: count = 07D0H =2000
269
270
271
272 ==== (% style="color:red" %)**MOD~=2**(%%)** ** ====
273
274 Uninterrupted measurement. When the distance exceeds the limit, the output IO is set high and reports are reported every five minutes. The time can be set and powered by an external power supply.Uplink Payload totals 11bytes.
275
276 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
277 |(% style="background-color:#4f81bd; color:white; width:70px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:130px" %)**1**|(% style="background-color:#4f81bd; color:white; width:130px" %)**4**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**
278 |(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:74px" %)Distance Limit Alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit
279
280 [[image:1701155150328-206.png]]
281
282 (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
283
284 (% style="color:red" %)**MOD:**
285
286 **Example: ** (0x60>>6) & 0x3f =1
287
288 **0x01:**  Regularly detect distance and report.
289 **0x02: ** Uninterrupted measurement (external power supply).
290
291 (% style="color:red" %)**Alarm:**
292
293 When the detection distance exceeds the limit, the alarm flag is set to 1.
294
295 (% style="color:red" %)**Do:**
296
297 When the distance exceeds the set threshold, pull the Do pin high.
298
299 (% style="color:red" %)**Limit flag:**
300
301 Mode for setting threshold: **0~~5**
302
303 **0:** does not use upper and lower limits
304
305 **1:** Use upper and lower limits
306
307 **2:** is less than the lower limit value
308
309 **3:** is greater than the lower limit value
310
311 **4:** is less than the upper limit
312
313 **5:** is greater than the upper limit
314
315
316 (% style="color:blue" %)**Upper limit:**
317
318 The upper limit of the threshold cannot exceed 2000mm.
319
320
321 (% style="color:blue" %)**Lower limit:**
322
323 The lower limit of the threshold cannot be less than 3mm.
324
325
326 == 2.4 Decode payload in The Things Network ==
327
328
329 While using TTN network, you can add the payload format to decode the payload.
330
331 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654592762713-715.png?rev=1.1||alt="1654592762713-715.png"]]
332
333
334 (((
335 The payload decoder function for TTN is here:
336 )))
337
338 (((
339 DS20L TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
340 )))
341
342
343 == 2.5 ​Show Data in DataCake IoT Server ==
344
345
346 (((
347 [[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, once we have data in TTN, we can use [[DATACAKE>>url:https://datacake.co/]] to connect to TTN and see the data in DATACAKE. Below are the steps:
348 )))
349
350
351 (((
352 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
353 )))
354
355 (((
356 (% style="color:blue" %)**Step 2**(%%)**: To configure the Application to forward data to DATACAKE you will need to add integration. To add the DATACAKE integration, perform the following steps:**
357 )))
358
359
360 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592790040-760.png?rev=1.1||alt="1654592790040-760.png"]]
361
362
363 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654592800389-571.png?rev=1.1||alt="1654592800389-571.png"]]
364
365
366 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
367
368 (% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
369
370 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654851029373-510.png?rev=1.1||alt="1654851029373-510.png"]]
371
372
373 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
374
375 [[image:image-20231129100454-2.png||height="501" width="928"]]
376
377
378 == 2.6 Frequency Plans ==
379
380
381 The DS20L uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
382
383 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
384
385
386 = 3. Configure DS20L =
387
388 == 3.1 Configure Methods ==
389
390
391 DS20L supports below configure method:
392
393 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
394
395 * 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]].
396
397 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
398
399
400
401 == 3.2 General Commands ==
402
403
404 These commands are to configure:
405
406 * General system settings like: uplink interval.
407
408 * LoRaWAN protocol & radio related command.
409
410 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
411
412 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
413
414
415 == 3.3 Commands special design for DS20L ==
416
417
418 These commands only valid for DS20L, as below:
419
420
421 === 3.3.1 Set Transmit Interval Time ===
422
423
424 (((
425 Feature: Change LoRaWAN End Node Transmit Interval.
426 )))
427
428 (((
429 (% style="color:blue" %)**AT Command: AT+TDC**
430 )))
431
432 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
433 |=(% 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**
434 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
435 30000
436 OK
437 the interval is 30000ms = 30s
438 )))
439 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
440 OK
441 Set transmit interval to 60000ms = 60 seconds
442 )))
443
444 (((
445 (% style="color:blue" %)**Downlink Command: 0x01**
446 )))
447
448 (((
449 Format: Command Code (0x01) followed by 3 bytes time value.
450 )))
451
452 (((
453 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
454 )))
455
456 * (((
457 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
458 )))
459 * (((
460 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
461
462
463
464 )))
465
466 === 3.3.2 Set Interrupt Mode ===
467
468
469 Feature, Set Interrupt mode for pin of GPIO_EXTI.
470
471 When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
472
473 (% style="color:blue" %)**AT Command: AT+INTMOD**
474
475 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
476 |=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response**
477 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
478 0
479 OK
480 the mode is 0 =Disable Interrupt
481 )))
482 |(% style="width:154px" %)(((
483 AT+INTMOD=3
484
485 (default)
486 )))|(% style="width:196px" %)(((
487 Set Transmit Interval
488 0. (Disable Interrupt),
489 ~1. (Trigger by rising and falling edge)
490 2. (Trigger by falling edge)
491 3. (Trigger by rising edge)
492 )))|(% style="width:157px" %)OK
493
494 (% style="color:blue" %)**Downlink Command: 0x06**
495
496 Format: Command Code (0x06) followed by 3 bytes.
497
498 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
499
500 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
501
502 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
503
504
505
506 === 3.3.3 Set work mode ===
507
508
509 Feature: Switch working mode
510
511 (% style="color:blue" %)**AT Command: AT+MOD**
512
513 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
514 |=(% style="width: 162px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 193px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Response**
515 |(% style="width:162px" %)AT+MOD=?|(% style="width:191px" %)Get the current working mode.|(% style="width:106px" %)OK
516 |(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the working mode to Regular measurements.|(% style="width:106px" %)(((
517 OK
518 Attention:Take effect after ATZ
519 )))
520
521 (% style="color:blue" %)**Downlink Command:**
522
523 * **Example: **0x0A00  ~/~/  Same as AT+MOD=0
524
525 * **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
526
527
528
529 === 3.3.4 Set threshold and threshold mode ===
530
531
532 Feature, Set threshold and threshold mode
533
534 When (% style="color:#037691" %)**AT+DOL=0,0,0,0,400**(%%) is set, No threshold is used, the sampling time is 400ms.
535
536 (% style="color:blue" %)**AT Command: AT+DOL**
537
538 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
539 |(% style="background-color:#4f81bd; color:white; width:162px" %)**Command Example**|(% style="background-color:#4f81bd; color:white; width:240px" %)**Function**|(% style="background-color:#4f81bd; color:white; width:108px" %)**Response**
540 |(% style="width:172px" %)AT+ DOL =?|(% style="width:279px" %)Get the current threshold mode and sampling time|(% style="width:118px" %)(((
541 0,0,0,0,400
542 OK
543 )))
544 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
545
546
547
548 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
549 |(% rowspan="11" style="color:blue; width:120px" %)(((
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571 **AT+DOL=5,1800,0,0,400**
572 )))|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits
573 |(% style="width:251px" %)1: Use upper and lower limits
574 |(% style="width:251px" %)2: Less than the lower limit
575 |(% style="width:251px" %)3: Greater than the lower limit
576 |(% style="width:251px" %)4: Less than the upper limit
577 |(% style="width:251px" %)5: Greater than the upper limit
578 |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM
579 |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM
580 |(% rowspan="2" style="width:226px" %)The fourth bit sets the over-limit alarm or person or object count.|(% style="width:251px" %)0 Over-limit alarm, DO output is high
581 |(% style="width:251px" %)1 Person or object counting statistics
582 |(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)(((
583 0~~10000ms
584
585
586 )))
587
588
589
590 (% style="color:blue" %)**Downlink Command: 0x07**
591
592 Format: Command Code (0x07) followed by 9bytes.
593
594 * Example 0: Downlink Payload: 070000000000000190  **~-~-->**  AT+MOD=0,0,0,0,400
595
596 * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
597
598 * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
599
600 * Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
601
602 * Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
603
604 * Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
605
606
607
608 = 4. Battery & Power Consumption =
609
610
611 DS20L use built-in 2400mAh non-chargeable battery for long-term use up to several years*. See below link for detail information about the battery info and how to replace.
612
613 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
614
615
616 = 5. OTA Firmware update =
617
618
619 (% class="wikigeneratedid" %)
620 User can change firmware DS20L to:
621
622 * Change Frequency band/ region.
623
624 * Update with new features.
625
626 * Fix bugs.
627
628 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**
629
630 Methods to Update Firmware:
631
632 * (Recommanded way) OTA firmware update via wireless:  **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20OTA%20Update%20for%20Sensors/]]**
633
634 * Update through UART TTL interface: **[[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]]**.
635
636
637
638 = 6. FAQ =
639
640 == 6.1 What is the frequency plan for DS20L? ==
641
642
643 DS20L use the same frequency as other Dragino products. User can see the detail from this link:  [[Introduction>>doc:Main.End Device Frequency Band.WebHome||anchor="H1.Introduction"]]
644
645
646 == 6.2 DS20L programming line ==
647
648
649 缺图 后续补上
650
651 feature:
652
653 for AT commands
654
655 Update the firmware of DS20L
656
657 Support interrupt mode
658
659
660 == 6.3 LiDAR probe position ==
661
662
663 [[image:1701155390576-216.png||height="285" width="307"]]
664
665 The black oval hole in the picture is the LiDAR probe.
666
667
668 == 6.4 Interface definition ==
669
670 [[image:image-20231128151132-2.png||height="305" width="557"]]
671
672
673 = 7. Trouble Shooting =
674
675 == 7.1 AT Command input doesn't work ==
676
677
678 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:blue" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:blue" %)**ENTER**(%%) while press the send key, user need to add ENTER in their string.
679
680
681 == 7.2 Significant error between the output distant value of LiDAR and actual distance ==
682
683
684 (((
685 (% style="color:blue" %)**Cause ①**(%%)**：**Due to the physical principles of The LiDAR probe, the above phenomenon is likely to occur if the detection object is the material with high reflectivity (such as mirror, smooth floor tile, etc.) or transparent substance. (such as glass and water, etc.)
686 )))
687
688 (((
689 (% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.
690 )))
691
692
693 (((
694 (% style="color:blue" %)**Cause ②**(%%)**: **The IR-pass filters are blocked.
695 )))
696
697 (((
698 (% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.
699 )))
700
701
702 = 8. Order Info =
703
704
705 Part Number: (% style="color:blue" %)**DS20L-XXX**
706
707 (% style="color:red" %)**XXX**(%%): **The default frequency band**
708
709 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
710
711 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
712
713 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
714
715 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
716
717 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
718
719 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
720
721 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
722
723 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
724
725
726
727 = 9. ​Packing Info =
728
729
730 (% style="color:#037691" %)**Package Includes**:
731
732 * DS20L LoRaWAN Smart Distance Detector x 1
733
734 (% style="color:#037691" %)**Dimension and weight**:
735
736 * Device Size: cm
737
738 * Device Weight: g
739
740 * Package Size / pcs : cm
741
742 * Weight / pcs : g
743
744
745
746 = 10. Support =
747
748
749 * 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.
750
751 * 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]].