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