Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 157.1
edited by Mengting Qiu
on 2023/12/09 17:15
Change comment: Uploaded new attachment "image-20231209171549-4.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
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,12 +112,16 @@
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  
119 119  Press the button for 5 seconds to activate the DS20L.
120 120  
135 +The switch is switched to (% style="color:blue" %)**E** (%%)and the external power supply is used.
136 +
137 +The switch is switched to (% style="color:blue" %)**I** (%%)and DS20L will be power by the built-in battery.
138 +
121 121  (% 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.
122 122  
123 123  After join success, it will start to upload messages to TTN and you can see the messages in the panel.
... ... @@ -197,16 +197,31 @@
197 197  === 2.3.2 Uplink Payload, FPORT~=2 ===
198 198  
199 199  
200 -==== (% style="color:red" %)**MOD~=1**(%%) ====
218 +==== (% style="color:red" %)**AT+MOD~=1**(%%) ====
201 201  
202 202  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.
203 203  
204 -Uplink Payload totals 10 bytes.
222 +**Uplink Payload totals 10 bytes.**
205 205  
206 206  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
207 -|(% 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**
208 -|(% 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
209 209  
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 +
210 210  [[image:image-20231209152917-1.png||height="300" width="1172"]]
211 211  
212 212  (% style="color:blue" %)**Battery Info:**
... ... @@ -243,27 +243,174 @@
243 243  
244 244  (% style="color:blue" %)**Sensor State:**
245 245  
246 -Ex1: 0x00: Normal collection distance
279 +Ex1: 0x00: Distance Reading is valid
247 247  
248 -Ex2 0x0x: Distance collection is wrong
281 +Ex2: 0x0x: Distance Reading is invalid
249 249  
250 250  
251 -(% style="color:blue" %)**Interript Count:**
284 +(% style="color:blue" %)**Interrupt Count:**
252 252  
253 253  If payload is:000007D0H: count = 07D0H =2000
254 254  
255 255  
256 256  
257 -==== (% style="color:red" %)**MOD~=2**(%%)** ** ====
290 +==== (% style="color:red" %)**AT+MOD~=2**(%%)** ** ====
258 258  
259 -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.
260 260  
261 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
293 +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.)
294 +
295 +[[image:image-20231128133704-1.png||height="189" width="441"]]
296 +
297 +
298 +* **Set over-limit alarm mode: AT+DOL=3,500,244,**(% style="color:red" %)0(%%)**,120**
299 +
300 +(% class="wikigeneratedid" id="HUninterruptedmeasurement.Whenthedistanceexceedsthelimit2CtheoutputIOissethighandreportsarereportedeveryfiveminutes.Thetimecanbesetandpoweredbyanexternalpowersupply.UplinkPayloadtotals11bytes." %)
301 +Uninterrupted measurement. When the distance exceeds the limit, the output IO high, instant alarm.
302 +
303 +(% class="wikigeneratedid" %)
304 +**Uplink Payload totals 9 bytes.**
305 +
306 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
307 +|(% 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**
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
309 +
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 +
341 +[[image:image-20231209171127-3.png||height="374" width="1209"]]
342 +
343 +(% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
344 +
345 +(% style="color:red" %)**MOD:**
346 +
347 +**Example: ** (0x60>>6) & 0x3f =1
348 +
349 +**0x01:**  Regularly detect distance and report.
350 +**0x02: ** Uninterrupted measurement (external power supply).
351 +
352 +(% style="color:red" %)**Alarm:**
353 +
354 +When the detection distance exceeds the limit, the alarm flag is set to 1.
355 +
356 +(% style="color:red" %)**DO:**
357 +
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.
359 +
360 +(% style="color:red" %)**Threshold Flag for Alarm:**
361 +
362 +Mode for setting threshold: **0~~3**
363 +
364 +**0:** Distance limit range is not enabled, alarm:0.
365 +
366 +**1:** Trigger Alarm if distance exceed the range between lower and upper.
367 +
368 +**2:** Trigger Alarm if distance smaller than the upper limit.
369 +
370 +**3: **Trigger Alarm if distance bigger than the lower limit .
371 +
372 +
373 +(% style="color:blue" %)**Distance:**
374 +
375 + Actual sampling distance values.
376 +
377 +**Example:**
378 +
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 +
390 +(% style="color:blue" %)**Upper limit:**
391 +
392 +Show the pre-set upper limit in Hex, Unit: mm.
393 +
394 +Ex: 01F4(H)=500mm
395 +
396 +
397 +(% style="color:blue" %)**Lower limit:**
398 +
399 +Show the pre-set lower limit in Hex, Unit: mm.
400 +
401 +Ex: 0xF4(H)=244mm
402 +
403 +
404 +* **Set the person or object count mode: AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120**
405 +
406 +Continuous measurement, detect and count people or things passing by in distance limit mode.
407 +
408 +**Uplink Payload totals 11 bytes.**
409 +
410 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:680px" %)
262 262  |(% 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**
263 -|(% 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
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
264 264  
265 -[[image:image-20231209155616-2.png||height="271" width="1262"]]
414 +**MOD+DO+ Alarm+ Do flag+ Limit flag:**
266 266  
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 +
445 +[[image:image-20231209173457-5.png||height="277" width="1098"]]
446 +
267 267  (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
268 268  
269 269  (% style="color:red" %)**MOD:**
... ... @@ -279,9 +279,9 @@
279 279  
280 280  (% style="color:red" %)**Do:**
281 281  
282 -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.
283 283  
284 -(% style="color:red" %)**Limit flag:**
464 +(% style="color:red" %)**Threshold Flag for Alarm:**
285 285  
286 286  Mode for setting threshold: **0~~3**
287 287  
... ... @@ -294,16 +294,35 @@
294 294  **3: **Greater than the lower limit
295 295  
296 296  
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 +
297 297  (% style="color:blue" %)**Upper limit:**
298 298  
299 -The upper limit of the threshold cannot exceed 2000mm.
494 +Show the pre-set upper limit in Hex, Unit: mm.
300 300  
496 +Ex: 01F4(H)=500mm
301 301  
498 +
302 302  (% style="color:blue" %)**Lower limit:**
303 303  
304 -The lower limit of the threshold cannot be less than 3mm.
501 +Show the pre-set lower limit in Hex, Unit: mm.
305 305  
503 +Ex: 0xF4(H)=244mm
306 306  
505 +
307 307  == 2.4 Decode payload in The Things Network ==
308 308  
309 309  
... ... @@ -325,7 +325,7 @@
325 325  
326 326  
327 327  (((
328 -[[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:
329 329  )))
330 330  
331 331  
... ... @@ -375,12 +375,11 @@
375 375  
376 376  DS20L supports below configure method:
377 377  
378 -* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
379 -
380 380  * 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]].
381 381  
382 382  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
383 383  
581 +
384 384  == 3.2 General Commands ==
385 385  
386 386  
... ... @@ -398,7 +398,7 @@
398 398  == 3.3 Commands special design for DS20L ==
399 399  
400 400  
401 -These commands only valid for DS20L, as below:
599 +Below commands only valid for DS20L, as below:
402 402  
403 403  
404 404  === 3.3.1 Set Transmit Interval Time ===
... ... @@ -522,7 +522,8 @@
522 522  )))
523 523  |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
524 524  
525 -(% 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
526 526  |(% rowspan="11" style="color:blue; width:120px" %)(((
527 527  
528 528  
... ... @@ -535,14 +535,12 @@
535 535  
536 536  
537 537  
538 -**AT+DOL=5,1800,0,0,400**
737 +**AT+DOL=1,1800,3,0,400**
539 539  )))|(% rowspan="4" style="width:240px" %)(((
540 540  
541 541  
542 542  
543 543  
544 -
545 -
546 546  The first bit sets the limit mode
547 547  )))|(% style="width:150px" %)0: Do not use upper and lower limits
548 548  |(% style="width:251px" %)1: Use upper and lower limits
... ... @@ -568,10 +568,34 @@
568 568  
569 569  * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
570 570  
571 -* Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,1800100,0,400
768 +* Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,1800,100,0,400
572 572  
573 573  * Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,0,100,0,400
574 574  
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 +
575 575  = 4. Battery & Power Consumption =
576 576  
577 577  
image-20231209173457-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +66.3 KB
Content
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