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