Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 169.1
edited by Edwin Chen
on 2023/12/11 22:14
Change comment: Uploaded new attachment "image-20231211221436-3.png", version {1}
To version 171.3
edited by Mengting Qiu
on 2023/12/12 11:48
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.ting
Content
... ... @@ -49,7 +49,6 @@
49 49  
50 50  == 1.3 Specification ==
51 51  
52 -
53 53  (% style="color:#037691" %)**LiDAR Sensor:**
54 54  
55 55  * Operation Temperature: -40 ~~ 80 °C
... ... @@ -65,7 +65,7 @@
65 65  
66 66  (% style="color:#037691" %)**Battery Power Mode:**
67 67  
68 -* Idle: 0.003 mA @ 3.3v
67 +* Idle: 3uA @ 3.3v
69 69  * Max : 360 mA
70 70  
71 71  (% style="color:#037691" %)**Continuously mode**:
... ... @@ -73,6 +73,21 @@
73 73  * Idle: 21 mA @ 3.3v
74 74  * Max : 360 mA
75 75  
75 +== 1.5 Use Case ==
76 +
77 +(% class="mark" %)**Regular Distance Detect**
78 +
79 +[[image:image-20231211220922-1.png||height="352" width="605"]]
80 +
81 +
82 +(% class="mark" %)**Counting / Alarm**
83 +
84 +[[image:image-20231211221253-2.png]]
85 +
86 +
87 +[[image:image-20231211221436-3.png]]
88 +
89 +
76 76  = 2. Configure DS20L to connect to LoRaWAN network =
77 77  
78 78  == 2.1 How it works ==
... ... @@ -112,7 +112,7 @@
112 112  
113 113  
114 114  
115 -=== Step 2: Activate on DS20L ===
129 +=== Step 2: Activate DS20L ===
116 116  
117 117  [[image:image-20231128133704-1.png||height="189" width="441"]]
118 118  
... ... @@ -120,7 +120,7 @@
120 120  
121 121  The switch is switched to (% style="color:blue" %)**E** (%%)and the external power supply is used.
122 122  
123 -The switch is switched to (% style="color:blue" %)**I** (%%)and the motherboard battery is used for power supply.
137 +The switch is switched to (% style="color:blue" %)**I** (%%)and DS20L will be power by the built-in battery.
124 124  
125 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 126  
... ... @@ -205,12 +205,27 @@
205 205  
206 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 207  
208 -Uplink Payload totals 10 bytes.
222 +**Uplink Payload totals 10 bytes.**
209 209  
210 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
225 +|(% 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**
226 +|(% 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 213  
228 +**MOD+ Alarm+ Interrupt:**
229 +
230 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:400px" %)
231 +|(% style="background-color:#4f81bd; color:White; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:White; width:60px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:White; width:70px" %)**bit5**|(% style="background-color:#4f81bd; color:White; width:120px" %)**bit4**
232 +|(% style="width:80px" %)Value|(% style="width:80px" %)MOD|(% style="width:89px" %)Digital Interrupt
233 + |(% style="width:167px" %)(((
234 +Distance Alarm
235 +
236 +0: No Alarm;
237 +
238 +1: Alarm
239 +)))
240 +
241 +Example parse in TTNv3
242 +
214 214  [[image:image-20231209152917-1.png||height="300" width="1172"]]
215 215  
216 216  (% style="color:blue" %)**Battery Info:**
... ... @@ -247,12 +247,12 @@
247 247  
248 248  (% style="color:blue" %)**Sensor State:**
249 249  
250 -Ex1: 0x00: Normal collection distance
279 +Ex1: 0x00: Distance Reading is valid
251 251  
252 -Ex2 0x0x: Distance collection is wrong
281 +Ex2: 0x0x: Distance Reading is invalid
253 253  
254 254  
255 -(% style="color:blue" %)**Interript Count:**
284 +(% style="color:blue" %)**Interrupt Count:**
256 256  
257 257  If payload is:000007D0H: count = 07D0H =2000
258 258  
... ... @@ -269,12 +269,46 @@
269 269  * **Set over-limit alarm mode: AT+DOL=3,500,244,**(% style="color:red" %)0(%%)**,120**
270 270  
271 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.
301 +Uninterrupted measurement. When the distance exceeds the limit, the output IO high, instant alarm.
273 273  
274 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
303 +(% class="wikigeneratedid" %)
304 +**Uplink Payload totals 9 bytes.**
305 +
306 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
275 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
308 +|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:210px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag|(% style="width:74px" %)Distance |(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit
277 277  
310 +**MOD+DO+ Alarm+ Do flag+ Limit flag:**
311 +
312 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
313 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit5**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit4**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**[bit2:bit1:bit0]**
314 +|(% style="width:50px" %)Value|(% style="width:60px" %)MOD|(% style="width:89px" %)(((
315 +(((
316 +DO
317 +)))
318 +
319 +(((
320 +0：Within limit
321 +
322 +1：Out of limit
323 +)))
324 +)))|(% style="width:73px" %)(((
325 +Alarm
326 +
327 +0: No Alarm;
328 +
329 +1: Alarm
330 +)))|(% style="width:150px" %)(((
331 +DO flag
332 +
333 +0：the over-limit alarm mode
334 +
335 +1：the person or object count mode
336 +)))|(% style="width:103px" %)Limit flag
337 +(0~~3)
338 +
339 +Example parse in TTNv3
340 +
278 278  [[image:image-20231209171127-3.png||height="374" width="1209"]]
279 279  
280 280  (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
... ... @@ -290,21 +290,21 @@
290 290  
291 291  When the detection distance exceeds the limit, the alarm flag is set to 1.
292 292  
293 -(% style="color:red" %)**Do:**
356 +(% style="color:red" %)**DO:**
294 294  
295 -When the distance exceeds the set threshold, pull the Do pin high.
358 +Shows the DO pin status, while there is alarm trigger, The DO pin will be set to high (3.3v), It will be set to 0 low level when there is no alarm.
296 296  
297 -(% style="color:red" %)**Limit flag:**
360 +(% style="color:red" %)**Threshold Flag for Alarm:**
298 298  
299 299  Mode for setting threshold: **0~~3**
300 300  
301 -**0:** does not use upper and lower limits
364 +**0:** Distance limit range is not enabled, alarm:0.
302 302  
303 -**1:** Use upper and lower limits
366 +**1:** Trigger Alarm if distance exceed the range between lower and upper.
304 304  
305 -**2:** Less than the upper limit
368 +**2:** Trigger Alarm if distance smaller than the upper limit.
306 306  
307 -**3: **Greater than the lower limit
370 +**3: **Trigger Alarm if distance bigger than the lower limit .
308 308  
309 309  
310 310  (% style="color:blue" %)**Distance:**
... ... @@ -326,22 +326,59 @@
326 326  
327 327  (% style="color:blue" %)**Upper limit:**
328 328  
329 -The upper limit of the threshold cannot exceed 2000mm.
392 +Show the pre-set upper limit in Hex, Unit: mm.
330 330  
394 +Ex: 01F4(H)=500mm
331 331  
396 +
332 332  (% style="color:blue" %)**Lower limit:**
333 333  
334 -The lower limit of the threshold cannot be less than 3mm.
399 +Show the pre-set lower limit in Hex, Unit: mm.
335 335  
401 +Ex: 0xF4(H)=244mm
336 336  
403 +
337 337  * **Set the person or object count mode: AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120**
338 338  
339 -Continuous measurement, detect and count people or things passing by in distance limit mode. Uplink Payload totals 11 bytes.
406 +Continuous measurement, detect and count people or things passing by in distance limit mode.
340 340  
341 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:600px" %)
408 +**Uplink Payload totals 11 bytes.**
409 +
410 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
342 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
412 +|(% style="width:91px" %)Value|(% style="width:41px" %)BAT|(% style="width:210px" %)MOD+ DO+ Alarm+ DO flag+ Limit flag|(% style="width:176px" %)Distance limit alarm count|(% style="width:100px" %)Upper limit|(% style="width:119px" %)Lower limit
344 344  
414 +**MOD+DO+ Alarm+ Do flag+ Limit flag:**
415 +
416 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
417 +|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bit)**|(% style="background-color:#4f81bd; color:white; width:60px" %)**[bit7:bit6]**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit5**|(% style="background-color:#4f81bd; color:white; width:90px" %)**bit4**|(% style="background-color:#4f81bd; color:white; width:120px" %)**bit3**|(% style="background-color:#4f81bd; color:white; width:100px" %)**[bit2:bit1:bit0]**
418 +|(% style="width:50px" %)Value|(% style="width:60px" %)MOD|(% style="width:89px" %)(((
419 +(((
420 +DO
421 +)))
422 +
423 +(((
424 +0：Within limit
425 +
426 +1：Out of limit
427 +)))
428 +)))|(% style="width:73px" %)(((
429 +Alarm
430 +
431 +0: No Alarm;
432 +
433 +1: Alarm
434 +)))|(% style="width:150px" %)(((
435 +DO flag
436 +
437 +0：the over-limit alarm mode
438 +
439 +1：the person or object count mode
440 +)))|(% style="width:103px" %)Limit flag
441 +(0~~3)
442 +
443 +Example parse in TTNv3
444 +
345 345  [[image:image-20231209173457-5.png||height="277" width="1098"]]
346 346  
347 347  (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
... ... @@ -359,9 +359,9 @@
359 359  
360 360  (% style="color:red" %)**Do:**
361 361  
362 -When the distance exceeds the set threshold, pull the Do pin high.
462 +Shows the DO pin status, while there is alarm trigger, The DO pin will be set to high (3.3v), It will be set to 0 low level when there is no alarm.
363 363  
364 -(% style="color:red" %)**Limit flag:**
464 +(% style="color:red" %)**Threshold Flag for Alarm:**
365 365  
366 366  Mode for setting threshold: **0~~3**
367 367  
... ... @@ -391,14 +391,18 @@
391 391  
392 392  (% style="color:blue" %)**Upper limit:**
393 393  
394 -The upper limit of the threshold cannot exceed 2000mm.
494 +Show the pre-set upper limit in Hex, Unit: mm.
395 395  
496 +Ex: 01F4(H)=500mm
396 396  
498 +
397 397  (% style="color:blue" %)**Lower limit:**
398 398  
399 -The lower limit of the threshold cannot be less than 3mm.
501 +Show the pre-set lower limit in Hex, Unit: mm.
400 400  
503 +Ex: 0xF4(H)=244mm
401 401  
505 +
402 402  == 2.4 Decode payload in The Things Network ==
403 403  
404 404  
... ... @@ -420,7 +420,7 @@
420 420  
421 421  
422 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:
527 +[[DATACAKE>>url:https://datacake.co/]] provides a human friendly interface to show the sensor data, onhuman-friendlya 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 424  )))
425 425  
426 426  
... ... @@ -470,12 +470,11 @@
470 470  
471 471  DS20L supports below configure method:
472 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 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 476  
477 477  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
478 478  
581 +
479 479  == 3.2 General Commands ==
480 480  
481 481  
... ... @@ -493,7 +493,7 @@
493 493  == 3.3 Commands special design for DS20L ==
494 494  
495 495  
496 -These commands only valid for DS20L, as below:
599 +Below commands only valid for DS20L, as below:
497 497  
498 498  
499 499  === 3.3.1 Set Transmit Interval Time ===