Skip to Content
Version 168.1 by Edwin Chen on 2023/12/11 22:12
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 The switch is switched to (% style="color:blue" %)**E** (%%)and the external power supply is used.
122
123 The switch is switched to (% style="color:blue" %)**I** (%%)and the motherboard battery is used for power supply.
124
125 (% 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.
126
127 After join success, it will start to upload messages to TTN and you can see the messages in the panel.
128
129
130
131 == 2.3 ​Uplink Payload ==
132
133 === 2.3.1 Device Status, FPORT~=5 ===
134
135
136 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.
137
138 The Payload format is as below.
139
140 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
141 |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
142 **Size(bytes)**
143 )))|=(% 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**
144 |(% 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
145
146 Example parse in TTNv3
147
148 [[image:image-20231206151412-3.png||height="179" width="1070"]]
149
150 (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
151
152 (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
153
154 (% style="color:blue" %)**Frequency Band**:
155
156 0x01: EU868
157
158 0x02: US915
159
160 0x03: IN865
161
162 0x04: AU915
163
164 0x05: KZ865
165
166 0x06: RU864
167
168 0x07: AS923
169
170 0x08: AS923-1
171
172 0x09: AS923-2
173
174 0x0a: AS923-3
175
176 0x0b: CN470
177
178 0x0c: EU433
179
180 0x0d: KR920
181
182 0x0e: MA869
183
184 (% style="color:blue" %)**Sub-Band**:
185
186 AU915 and US915:value 0x00 ~~ 0x08
187
188 CN470: value 0x0B ~~ 0x0C
189
190 Other Bands: Always 0x00
191
192 (% style="color:blue" %)**Battery Info**:
193
194 Check the battery voltage.
195
196 Ex1: 0x0B45 = 2885mV
197
198 Ex2: 0x0B49 = 2889mV
199
200
201 === 2.3.2 Uplink Payload, FPORT~=2 ===
202
203
204 ==== (% style="color:red" %)**AT+MOD~=1**(%%) ====
205
206 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.
207
208 Uplink Payload totals 10 bytes.
209
210 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
211 |(% 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**
212 |(% 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
213
214 [[image:image-20231209152917-1.png||height="300" width="1172"]]
215
216 (% style="color:blue" %)**Battery Info:**
217
218 Check the battery voltage for DS20L
219
220 Ex1: 0x0E10 = 3600mV
221
222
223 (% style="color:blue" %)**MOD & Alarm & Interrupt:**
224
225 (% style="color:red" %)**MOD:**
226
227 **Example: ** (0x60>>6) & 0x3f =1
228
229 **0x01:**  Regularly detect distance and report.
230 **0x02: ** Uninterrupted measurement (external power supply).
231
232 (% style="color:red" %)**Alarm:**
233
234 When the detection distance exceeds the limit, the alarm flag is set to 1.
235
236 (% style="color:red" %)**Interrupt:**
237
238 Whether it is an external interrupt.
239
240
241 (% style="color:blue" %)**Distance info:**
242
243 **Example**:
244
245 If payload is: 0708H: distance = 0708H = 1800 mm
246
247
248 (% style="color:blue" %)**Sensor State:**
249
250 Ex1: 0x00: Normal collection distance
251
252 Ex2 0x0x: Distance collection is wrong
253
254
255 (% style="color:blue" %)**Interript Count:**
256
257 If payload is:000007D0H: count = 07D0H =2000
258
259
260
261 ==== (% style="color:red" %)**AT+MOD~=2**(%%)** ** ====
262
263
264 The power consumption of uninterrupted measurement is high, and the device needs to use external power supply.(The switch is switched to E and the external power supply is used.)
265
266 [[image:image-20231128133704-1.png||height="189" width="441"]]
267
268
269 * **Set over-limit alarm mode: AT+DOL=3,500,244,**(% style="color:red" %)0(%%)**,120**
270
271 (% class="wikigeneratedid" id="HUninterruptedmeasurement.Whenthedistanceexceedsthelimit2CtheoutputIOissethighandreportsarereportedeveryfiveminutes.Thetimecanbesetandpoweredbyanexternalpowersupply.UplinkPayloadtotals11bytes." %)
272 Uninterrupted measurement. When the distance exceeds the limit, the output IO high, instant alarm. Uplink Payload totals 9 bytes.
273
274 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
275 |(% 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" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**|(% style="background-color:#4f81bd; color:white; width:70px" %)**2**
276 |(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:74px" %)Distance |(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit
277
278 [[image:image-20231209171127-3.png||height="374" width="1209"]]
279
280 (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
281
282 (% style="color:red" %)**MOD:**
283
284 **Example: ** (0x60>>6) & 0x3f =1
285
286 **0x01:**  Regularly detect distance and report.
287 **0x02: ** Uninterrupted measurement (external power supply).
288
289 (% style="color:red" %)**Alarm:**
290
291 When the detection distance exceeds the limit, the alarm flag is set to 1.
292
293 (% style="color:red" %)**Do:**
294
295 When the distance exceeds the set threshold, pull the Do pin high.
296
297 (% style="color:red" %)**Limit flag:**
298
299 Mode for setting threshold: **0~~3**
300
301 **0:** does not use upper and lower limits
302
303 **1:** Use upper and lower limits
304
305 **2:** Less than the upper limit
306
307 **3: **Greater than the lower limit
308
309
310 (% style="color:blue" %)**Distance:**
311
312 Actual sampling distance values.
313
314 **Example:**
315
316 **AT+DOL=1,500,244,**(% style="color:red" %)0(%%)**,120  **
317
318 The distance is detected every 120ms.
319
320 When the actual detection value is within the range of [244mm,500mm], the data is uploaded in the normal TDC time.
321
322 When the actual detection value is outside the range of [244mm,500mm], the uplink data will be immediately alerted.
323
324 If payload is: 0708H: distance = 0708H = 1800 mm
325
326
327 (% style="color:blue" %)**Upper limit:**
328
329 The upper limit of the threshold cannot exceed 2000mm.
330
331
332 (% style="color:blue" %)**Lower limit:**
333
334 The lower limit of the threshold cannot be less than 3mm.
335
336
337 * **Set the person or object count mode: AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120**
338
339 Continuous measurement, detect and count people or things passing by in distance limit mode. Uplink Payload totals 11 bytes.
340
341 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:600px" %)
342 |(% 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**
343 |(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:176px" %)MOD+Alarm+Do+Limit flag|(% style="width:176px" %)Distance limit alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit
344
345 [[image:image-20231209173457-5.png||height="277" width="1098"]]
346
347 (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
348
349 (% style="color:red" %)**MOD:**
350
351 **Example: ** (0x60>>6) & 0x3f =1
352
353 **0x01:**  Regularly detect distance and report.
354 **0x02: ** Uninterrupted measurement (external power supply).
355
356 (% style="color:red" %)**Alarm:**
357
358 When the detection distance exceeds the limit, the alarm flag is set to 1.
359
360 (% style="color:red" %)**Do:**
361
362 When the distance exceeds the set threshold, pull the Do pin high.
363
364 (% style="color:red" %)**Limit flag:**
365
366 Mode for setting threshold: **0~~3**
367
368 **0:** does not use upper and lower limits
369
370 **1:** Use upper and lower limits
371
372 **2:** Less than the upper limit
373
374 **3: **Greater than the lower limit
375
376
377 (% style="color:blue" %)**Distance limit alarm count:**
378
379 People or objects are collected and counted within a limited distance.
380
381 The detection of a stationary person or object at each sampling time will be repeated three times, and the fourth sampling count will be added by 1.
382
383 **Example:**
384
385 **AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120   **
386
387 People or objects passing within the distance range of [244mm,500mm] are detected and counted every 120ms.
388
389 If payload is: 0x56H, interrupt count =0x56H =86
390
391
392 (% style="color:blue" %)**Upper limit:**
393
394 The upper limit of the threshold cannot exceed 2000mm.
395
396
397 (% style="color:blue" %)**Lower limit:**
398
399 The lower limit of the threshold cannot be less than 3mm.
400
401
402 == 2.4 Decode payload in The Things Network ==
403
404
405 While using TTN network, you can add the payload format to decode the payload.
406
407 [[image:image-20231206143515-1.png||height="534" width="759"]]
408
409
410 (((
411 The payload decoder function for TTN is here:
412 )))
413
414 (((
415 DS20L TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
416 )))
417
418
419 == 2.5 ​Show Data in DataCake IoT Server ==
420
421
422 (((
423 [[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:
424 )))
425
426
427 (((
428 (% style="color:blue" %)**Step 1**(%%)**: Be sure that your device is programmed and properly connected to the network at this time.**
429 )))
430
431 (((
432 (% 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:**
433 )))
434
435
436 [[image:image-20231207153532-6.png||height="562" width="861"]]
437
438
439 [[image:image-20231207155940-8.png]]
440
441 For more detailed instructions, refer to the following instructions: [[Welcome - Datacake Docs>>url:https://docs.datacake.de/]]
442
443 [[image:image-20231207160733-11.png||height="429" width="759"]]
444
445
446 (% style="color:blue" %)**Step 3**(%%)**: Create an account or log in Datacake.**
447
448 (% style="color:blue" %)**Step 4**(%%)**: Search the DS20L and add DevEUI.**
449
450 [[image:image-20231207160343-10.png||height="665" width="705"]]
451
452
453 After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
454
455 [[image:image-20231129100454-2.png||height="501" width="928"]]
456
457
458 == 2.6 Frequency Plans ==
459
460
461 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.
462
463 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
464
465
466 = 3. Configure DS20L =
467
468 == 3.1 Configure Methods ==
469
470
471 DS20L supports below configure method:
472
473 * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
474
475 * 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]].
476
477 * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
478
479 == 3.2 General Commands ==
480
481
482 These commands are to configure:
483
484 * General system settings like: uplink interval.
485
486 * LoRaWAN protocol & radio related command.
487
488 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
489
490 [[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/]]
491
492
493 == 3.3 Commands special design for DS20L ==
494
495
496 These commands only valid for DS20L, as below:
497
498
499 === 3.3.1 Set Transmit Interval Time ===
500
501
502 (((
503 Feature: Change LoRaWAN End Node Transmit Interval.
504 )))
505
506 (((
507 (% style="color:blue" %)**AT Command: AT+TDC**
508 )))
509
510 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
511 |=(% 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**
512 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
513 30000
514 OK
515 the interval is 30000ms = 30s
516 )))
517 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
518 OK
519 Set transmit interval to 60000ms = 60 seconds
520 )))
521
522 (((
523 (% style="color:blue" %)**Downlink Command: 0x01**
524 )))
525
526 (((
527 Format: Command Code (0x01) followed by 3 bytes time value.
528 )))
529
530 (((
531 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
532 )))
533
534 * (((
535 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
536 )))
537 * (((
538 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
539
540
541
542 )))
543
544 === 3.3.2 Set Interrupt Mode ===
545
546
547 Feature, Set Interrupt mode for pin of GPIO_EXTI.
548
549 When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
550
551 (% style="color:blue" %)**AT Command: AT+INTMOD**
552
553 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
554 |=(% 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**
555 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
556 0
557 OK
558 the mode is 0 =Disable Interrupt
559 )))
560 |(% style="width:154px" %)(((
561 AT+INTMOD=3
562
563 (default)
564 )))|(% style="width:196px" %)(((
565 Set Transmit Interval
566 0. (Disable Interrupt),
567 ~1. (Trigger by rising and falling edge)
568 2. (Trigger by falling edge)
569 3. (Trigger by rising edge)
570 )))|(% style="width:157px" %)OK
571
572 (% style="color:blue" %)**Downlink Command: 0x06**
573
574 Format: Command Code (0x06) followed by 3 bytes.
575
576 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
577
578 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
579
580 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
581
582 === 3.3.3 Set work mode ===
583
584
585 Feature: Switch working mode
586
587 (% style="color:blue" %)**AT Command: AT+MOD**
588
589 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
590 |=(% 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**
591 |(% style="width:162px" %)AT+MOD=?|(% style="width:191px" %)Get the current working mode.|(% style="width:106px" %)OK
592 |(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the working mode to Regular measurements.|(% style="width:106px" %)(((
593 OK
594 Attention:Take effect after ATZ
595 )))
596
597 (% style="color:blue" %)**Downlink Command:**
598
599 * **Example: **0x0A01 ~/~/  Same as AT+MOD=1
600
601 * **Example:** 0x0A02  ~/~/  Same as AT+MOD=2
602
603 === 3.3.4 Set threshold and threshold mode ===
604
605
606 Feature, Set threshold and threshold mode
607
608 When (% style="color:#037691" %)**AT+DOL=0,0,0,0,400**(%%) is set, No threshold is used, the sampling time is 400ms.
609
610 (% style="color:blue" %)**AT Command: AT+DOL**
611
612 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
613 |(% 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**
614 |(% style="width:172px" %)AT+ DOL =?|(% style="width:279px" %)Get the current threshold mode and sampling time|(% style="width:118px" %)(((
615 0,0,0,0,400
616 OK
617 )))
618 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
619
620 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
621 |=(% 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" %) Parameter
622 |(% rowspan="11" style="color:blue; width:120px" %)(((
623
624
625
626
627
628
629
630
631
632
633
634 **AT+DOL=1,1800,3,0,400**
635 )))|(% rowspan="4" style="width:240px" %)(((
636
637
638
639
640 The first bit sets the limit mode
641 )))|(% style="width:150px" %)0: Do not use upper and lower limits
642 |(% style="width:251px" %)1: Use upper and lower limits
643 |(% style="width:251px" %)2:Less than the upper limit
644 |(% style="width:251px" %)3: Greater than the lower limit
645 |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM
646 |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM
647 |(% 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
648 |(% style="width:251px" %)1 Person or object counting statistics
649 |(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)(((
650 100~~10000ms
651
652
653 )))
654
655 (% style="color:blue" %)**Downlink Command: 0x07**
656
657 Format: Command Code (0x07) followed by 9 bytes.
658
659 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.
660
661 * Example 0: Downlink Payload: 07 00 0000 0000 00 0190  **~-~-->**  AT+MOD=0,0,0,0,400
662
663 * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
664
665 * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,1800,100,0,400
666
667 * Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,0,100,0,400
668
669 (% style="color:Red" %)**Note: The over-limit alarm is applied to MOD1 and MOD2.**
670
671 **For example:**
672
673 * **AT+MOD=1**
674
675 **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300**
676
677 Send data according to the normal TDC time. If the mode limit is exceeded, the alarm flag is set to 1:
678
679 [[image:image-20231211113204-2.png||height="292" width="1093"]]
680
681 * **AT+MOD=2  **
682
683 **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300**
684
685 If the mode limit is exceeded, the data is immediately uplink and the alarm flag is set to 1:
686
687 [[image:image-20231211114932-3.png||height="277" width="1248"]]
688
689
690
691
692
693 = 4. Battery & Power Consumption =
694
695
696 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.
697
698 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
699
700
701 = 5. OTA Firmware update =
702
703
704 (% class="wikigeneratedid" %)
705 User can change firmware DS20L to:
706
707 * Change Frequency band/ region.
708
709 * Update with new features.
710
711 * Fix bugs.
712
713 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**
714
715 Methods to Update Firmware:
716
717 * (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/]]**
718
719 * 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]]**.
720
721 = 6. FAQ =
722
723 == 6.1 What is the frequency plan for DS20L? ==
724
725
726 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"]]
727
728
729 == 6.2 DS20L programming line ==
730
731
732 缺图 后续补上
733
734 feature:
735
736 for AT commands
737
738 Update the firmware of DS20L
739
740 Support interrupt mode
741
742
743 == 6.3 LiDAR probe position ==
744
745
746 [[image:1701155390576-216.png||height="285" width="307"]]
747
748 The black oval hole in the picture is the LiDAR probe.
749
750
751 == 6.4 Interface definition ==
752
753 [[image:image-20231128151132-2.png||height="305" width="557"]]
754
755
756 = 7. Trouble Shooting =
757
758 == 7.1 AT Command input doesn't work ==
759
760
761 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.
762
763
764 == 7.2 Significant error between the output distant value of LiDAR and actual distance ==
765
766
767 (((
768 (% 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.)
769 )))
770
771 (((
772 (% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.
773 )))
774
775
776 (((
777 (% style="color:blue" %)**Cause ②**(%%)**: **The IR-pass filters are blocked.
778 )))
779
780 (((
781 (% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.
782 )))
783
784
785 = 8. Order Info =
786
787
788 Part Number: (% style="color:blue" %)**DS20L-XXX**
789
790 (% style="color:red" %)**XXX**(%%): **The default frequency band**
791
792 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
793
794 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
795
796 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
797
798 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
799
800 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
801
802 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
803
804 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
805
806 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
807
808 = 9. ​Packing Info =
809
810
811 (% style="color:#037691" %)**Package Includes**:
812
813 * DS20L LoRaWAN Smart Distance Detector x 1
814
815 (% style="color:#037691" %)**Dimension and weight**:
816
817 * Device Size: cm
818
819 * Device Weight: g
820
821 * Package Size / pcs : cm
822
823 * Weight / pcs : g
824
825 = 10. Support =
826
827
828 * 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.
829
830 * 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]].