Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 159.1
edited by Mengting Qiu
on 2023/12/09 18:03
Change comment: There is no comment for this version
To version 172.1
edited by Mengting Qiu
on 2023/12/12 12:00
Change comment: There is no comment for this version

Summary

Details

Page properties
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 +Continuously measurement with Alarm. 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:**
... ... @@ -311,26 +311,135 @@
311 311  
312 312   Actual sampling distance values.
313 313  
377 +**Example:**
314 314  
379 +**AT+DOL=1,500,244,**(% style="color:red" %)0(%%)**,120  **
380 +
381 +The distance is detected every 120ms.
382 +
383 +When the actual detection value is within the range of [244mm,500mm], the data is uploaded in the normal TDC time.
384 +
385 +When the actual detection value is outside the range of [244mm,500mm], the uplink data will be immediately alerted.
386 +
387 +If payload is: 0708H: distance = 0708H = 1800 mm
388 +
389 +
315 315  (% style="color:blue" %)**Upper limit:**
316 316  
317 -The upper limit of the threshold cannot exceed 2000mm.
392 +Show the pre-set upper limit in Hex, Unit: mm.
318 318  
394 +Ex: 01F4(H)=500mm
319 319  
396 +
320 320  (% style="color:blue" %)**Lower limit:**
321 321  
322 -The lower limit of the threshold cannot be less than 3mm.
399 +Show the pre-set lower limit in Hex, Unit: mm.
323 323  
401 +Ex: 0xF4(H)=244mm
324 324  
403 +
325 325  * **Set the person or object count mode: AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120**
326 326  
327 -Continuous measurement, detect and count people or things passing by in distance limit mode.
406 +Continuously measurement with Alarm, detect and count people or things passing by in distance limit mode.
328 328  
408 +**Uplink Payload totals 11 bytes.**
409 +
410 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
411 +|(% 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**
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
413 +
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 +
329 329  [[image:image-20231209173457-5.png||height="277" width="1098"]]
330 330  
447 +(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
331 331  
449 +(% style="color:red" %)**MOD:**
332 332  
451 +**Example: ** (0x60>>6) & 0x3f =1
333 333  
453 +**0x01:**  Regularly detect distance and report.
454 +**0x02: ** Uninterrupted measurement (external power supply).
455 +
456 +(% style="color:red" %)**Alarm:**
457 +
458 +When the detection distance exceeds the limit, the alarm flag is set to 1.
459 +
460 +(% style="color:red" %)**Do:**
461 +
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.
463 +
464 +(% style="color:red" %)**Threshold Flag for Alarm:**
465 +
466 +Mode for setting threshold: **0~~3**
467 +
468 +**0:** does not use upper and lower limits
469 +
470 +**1:** Use upper and lower limits
471 +
472 +**2:** Less than the upper limit
473 +
474 +**3: **Greater than the lower limit
475 +
476 +
477 +(% style="color:blue" %)**Distance limit alarm count:**
478 +
479 +People or objects are collected and counted within a limited distance.
480 +
481 +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.
482 +
483 +**Example:**
484 +
485 +**AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120   **
486 +
487 +People or objects passing within the distance range of [244mm,500mm] are detected and counted every 120ms.
488 +
489 +If payload is: 0x56H, interrupt count =0x56H =86
490 +
491 +
492 +(% style="color:blue" %)**Upper limit:**
493 +
494 +Show the pre-set upper limit in Hex, Unit: mm.
495 +
496 +Ex: 01F4(H)=500mm
497 +
498 +
499 +(% style="color:blue" %)**Lower limit:**
500 +
501 +Show the pre-set lower limit in Hex, Unit: mm.
502 +
503 +Ex: 0xF4(H)=244mm
504 +
505 +
334 334  == 2.4 Decode payload in The Things Network ==
335 335  
336 336  
... ... @@ -352,7 +352,7 @@
352 352  
353 353  
354 354  (((
355 -[[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:
356 356  )))
357 357  
358 358  
... ... @@ -402,12 +402,11 @@
402 402  
403 403  DS20L supports below configure method:
404 404  
405 -* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
406 -
407 407  * 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]].
408 408  
409 409  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
410 410  
581 +
411 411  == 3.2 General Commands ==
412 412  
413 413  
... ... @@ -425,7 +425,7 @@
425 425  == 3.3 Commands special design for DS20L ==
426 426  
427 427  
428 -These commands only valid for DS20L, as below:
599 +Below commands only valid for DS20L, as below:
429 429  
430 430  
431 431  === 3.3.1 Set Transmit Interval Time ===
... ... @@ -549,7 +549,8 @@
549 549  )))
550 550  |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
551 551  
552 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
723 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
724 +|=(% 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
553 553  |(% rowspan="11" style="color:blue; width:120px" %)(((
554 554  
555 555  
... ... @@ -562,14 +562,12 @@
562 562  
563 563  
564 564  
565 -**AT+DOL=5,1800,0,0,400**
737 +**AT+DOL=1,1800,3,0,400**
566 566  )))|(% rowspan="4" style="width:240px" %)(((
567 567  
568 568  
569 569  
570 570  
571 -
572 -
573 573  The first bit sets the limit mode
574 574  )))|(% style="width:150px" %)0: Do not use upper and lower limits
575 575  |(% style="width:251px" %)1: Use upper and lower limits
... ... @@ -595,10 +595,34 @@
595 595  
596 596  * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
597 597  
598 -* Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,1800100,0,400
768 +* Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,1800,100,0,400
599 599  
600 600  * Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,0,100,0,400
601 601  
772 +(% style="color:Red" %)**Note: The over-limit alarm is applied to MOD1 and MOD2.**
773 +
774 +**For example:**
775 +
776 +* **AT+MOD=1**
777 +
778 + **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300**
779 +
780 +Send data according to the normal TDC time. If the mode limit is exceeded, the alarm flag is set to 1:
781 +
782 +[[image:image-20231211113204-2.png||height="292" width="1093"]]
783 +
784 +* **AT+MOD=2  **
785 +
786 + **AT+DOL=1,500,244,**(% style="color:blue" %)0(%%)**,300**
787 +
788 +If the mode limit is exceeded, the data is immediately uplink and the alarm flag is set to 1:
789 +
790 +[[image:image-20231211114932-3.png||height="277" width="1248"]]
791 +
792 +
793 +
794 +
795 +
602 602  = 4. Battery & Power Consumption =
603 603  
604 604  
image-20231211113113-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +64.5 KB
Content
image-20231211113204-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +59.7 KB
Content
image-20231211114932-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +57.3 KB
Content
image-20231211220922-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +411.2 KB
Content
image-20231211221253-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +90.8 KB
Content
image-20231211221436-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +64.9 KB
Content