Skip to Content
Version 133.1 by Mengting Qiu on 2023/12/06 19:57
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 == 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:image-20231206151412-3.png||height="179" width="1070"]]
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:image-20231206154621-4.png||height="214" width="1019"]]
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.4 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:image-20231206143515-1.png||height="534" width="759"]]
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.5 ​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-20231129100454-2.png||height="501" width="928"]]
373
374
375 == 2.6 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
397 == 3.2 General Commands ==
398
399
400 These commands are to configure:
401
402 * General system settings like: uplink interval.
403
404 * LoRaWAN protocol & radio related command.
405
406 They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
407
408 [[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/]]
409
410
411 == 3.3 Commands special design for DS20L ==
412
413
414 These commands only valid for DS20L, as below:
415
416
417 === 3.3.1 Set Transmit Interval Time ===
418
419
420 (((
421 Feature: Change LoRaWAN End Node Transmit Interval.
422 )))
423
424 (((
425 (% style="color:blue" %)**AT Command: AT+TDC**
426 )))
427
428 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
429 |=(% 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**
430 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
431 30000
432 OK
433 the interval is 30000ms = 30s
434 )))
435 |(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
436 OK
437 Set transmit interval to 60000ms = 60 seconds
438 )))
439
440 (((
441 (% style="color:blue" %)**Downlink Command: 0x01**
442 )))
443
444 (((
445 Format: Command Code (0x01) followed by 3 bytes time value.
446 )))
447
448 (((
449 If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
450 )))
451
452 * (((
453 Example 1: Downlink Payload: 0100001E  ~/~/ Set Transmit Interval (TDC) = 30 seconds
454 )))
455 * (((
456 Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
457
458
459
460 )))
461
462 === 3.3.2 Set Interrupt Mode ===
463
464
465 Feature, Set Interrupt mode for pin of GPIO_EXTI.
466
467 When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
468
469 (% style="color:blue" %)**AT Command: AT+INTMOD**
470
471 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
472 |=(% 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**
473 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
474 0
475 OK
476 the mode is 0 =Disable Interrupt
477 )))
478 |(% style="width:154px" %)(((
479 AT+INTMOD=3
480
481 (default)
482 )))|(% style="width:196px" %)(((
483 Set Transmit Interval
484 0. (Disable Interrupt),
485 ~1. (Trigger by rising and falling edge)
486 2. (Trigger by falling edge)
487 3. (Trigger by rising edge)
488 )))|(% style="width:157px" %)OK
489
490 (% style="color:blue" %)**Downlink Command: 0x06**
491
492 Format: Command Code (0x06) followed by 3 bytes.
493
494 This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
495
496 * Example 1: Downlink Payload: 06000000  ~/~/  Turn off interrupt mode
497
498 * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
499
500
501 === 3.3.3 Set work mode ===
502
503
504 Feature: Switch working mode
505
506 (% style="color:blue" %)**AT Command: AT+MOD**
507
508 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
509 |=(% 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**
510 |(% style="width:162px" %)AT+MOD=?|(% style="width:191px" %)Get the current working mode.|(% style="width:106px" %)OK
511 |(% style="width:162px" %)AT+MOD=1|(% style="width:191px" %)Set the working mode to Regular measurements.|(% style="width:106px" %)(((
512 OK
513 Attention:Take effect after ATZ
514 )))
515
516 (% style="color:blue" %)**Downlink Command:**
517
518 * **Example: **0x0A01 ~/~/  Same as AT+MOD=1
519
520 * **Example:** 0x0A02  ~/~/  Same as AT+MOD=2
521
522
523 === 3.3.4 Set threshold and threshold mode ===
524
525
526 Feature, Set threshold and threshold mode
527
528 When (% style="color:#037691" %)**AT+DOL=0,0,0,0,400**(%%) is set, No threshold is used, the sampling time is 400ms.
529
530 (% style="color:blue" %)**AT Command: AT+DOL**
531
532 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
533 |(% 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**
534 |(% style="width:172px" %)AT+ DOL =?|(% style="width:279px" %)Get the current threshold mode and sampling time|(% style="width:118px" %)(((
535 0,0,0,0,400
536 OK
537 )))
538 |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
539
540 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
541 |(% rowspan="11" style="color:blue; width:120px" %)(((
542
543
544
545
546
547
548
549
550
551
552
553 **AT+DOL=5,1800,0,0,400**
554 )))|(% rowspan="6" style="width:240px" %)(((
555
556
557
558
559
560
561 The first bit sets the limit mode
562 )))|(% style="width:150px" %)0: Do not use upper and lower limits
563 |(% style="width:251px" %)1: Use upper and lower limits
564 |(% style="width:251px" %)2: Less than the lower limit
565 |(% style="width:251px" %)3: Greater than the lower limit
566 |(% style="width:251px" %)4: Less than the upper limit
567 |(% style="width:251px" %)5: Greater than the upper limit
568 |(% style="width:226px" %)The second bit sets the upper limit value|(% style="width:251px" %)3~~2000MM
569 |(% style="width:226px" %)The third bit sets the lower limit value|(% style="width:251px" %)3~~2000MM
570 |(% 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
571 |(% style="width:251px" %)1 Person or object counting statistics
572 |(% style="width:226px" %)The fifth bit sets the sampling time|(% style="width:251px" %)(((
573 0~~10000ms
574
575
576 )))
577
578
579 (% style="color:blue" %)**Downlink Command: 0x07**
580
581 Format: Command Code (0x07) followed by 9 bytes.
582
583 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.
584
585 * Example 0: Downlink Payload: 07 00 0000 0000 00 0190  **~-~-->**  AT+MOD=0,0,0,0,400
586
587 * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
588
589 * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
590
591 * Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
592
593 * Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
594
595 * Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
596
597
598 = 4. Battery & Power Consumption =
599
600
601 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.
602
603 [[**Battery Info & Power Consumption Analyze**>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
604
605
606 = 5. OTA Firmware update =
607
608
609 (% class="wikigeneratedid" %)
610 User can change firmware DS20L to:
611
612 * Change Frequency band/ region.
613
614 * Update with new features.
615
616 * Fix bugs.
617
618 Firmware and changelog can be downloaded from : **[[Firmware download link>>https://www.dropbox.com/sh/zqv1vt3komgp4tu/AAC33PnXIcWOVl_UXBEAeT_xa?dl=0]]**
619
620 Methods to Update Firmware:
621
622 * (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/]]**
623
624 * 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]]**.
625
626
627 = 6. FAQ =
628
629 == 6.1 What is the frequency plan for DS20L? ==
630
631
632 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"]]
633
634
635 == 6.2 DS20L programming line ==
636
637
638 缺图 后续补上
639
640 feature:
641
642 for AT commands
643
644 Update the firmware of DS20L
645
646 Support interrupt mode
647
648
649 == 6.3 LiDAR probe position ==
650
651
652 [[image:1701155390576-216.png||height="285" width="307"]]
653
654 The black oval hole in the picture is the LiDAR probe.
655
656
657 == 6.4 Interface definition ==
658
659 [[image:image-20231128151132-2.png||height="305" width="557"]]
660
661
662 = 7. Trouble Shooting =
663
664 == 7.1 AT Command input doesn't work ==
665
666
667 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.
668
669
670 == 7.2 Significant error between the output distant value of LiDAR and actual distance ==
671
672
673 (((
674 (% 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.)
675 )))
676
677 (((
678 (% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.
679 )))
680
681
682 (((
683 (% style="color:blue" %)**Cause ②**(%%)**: **The IR-pass filters are blocked.
684 )))
685
686 (((
687 (% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.
688 )))
689
690
691 = 8. Order Info =
692
693
694 Part Number: (% style="color:blue" %)**DS20L-XXX**
695
696 (% style="color:red" %)**XXX**(%%): **The default frequency band**
697
698 * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band
699
700 * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band
701
702 * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band
703
704 * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band
705
706 * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band
707
708 * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band
709
710 * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band
711
712 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
713
714
715 = 9. ​Packing Info =
716
717
718 (% style="color:#037691" %)**Package Includes**:
719
720 * DS20L LoRaWAN Smart Distance Detector x 1
721
722 (% style="color:#037691" %)**Dimension and weight**:
723
724 * Device Size: cm
725
726 * Device Weight: g
727
728 * Package Size / pcs : cm
729
730 * Weight / pcs : g
731
732
733 = 10. Support =
734
735
736 * 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.
737
738 * 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]].
739
740
741