Last modified by Mengting Qiu on 2023/12/14 11:15

From version 170.1
edited by Edwin Chen
on 2023/12/11 22:50
Change comment: There is no comment for this version
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
... ... @@ -47,7 +47,6 @@
47 47  * Firmware upgradable via program port or LoRa protocol
48 48  * Built-in 2400mAh battery or power by external power source
49 49  
50 -
51 51  == 1.3 Specification ==
52 52  
53 53  (% style="color:#037691" %)**LiDAR Sensor:**
... ... @@ -60,7 +60,6 @@
60 60  * ToF FoV: ±9°, Total 18°
61 61  * Light source: VCSEL
62 62  
63 -
64 64  == 1.4 Power Consumption ==
65 65  
66 66  
... ... @@ -74,7 +74,6 @@
74 74  * Idle: 21 mA @ 3.3v
75 75  * Max : 360 mA
76 76  
77 -
78 78  == 1.5 Use Case ==
79 79  
80 80  (% class="mark" %)**Regular Distance Detect**
... ... @@ -222,12 +222,27 @@
222 222  
223 223  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.
224 224  
225 -Uplink Payload totals 10 bytes.
222 +**Uplink Payload totals 10 bytes.**
226 226  
227 227  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
228 -|(% 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**
229 -|(% 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
230 230  
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 +
231 231  [[image:image-20231209152917-1.png||height="300" width="1172"]]
232 232  
233 233  (% style="color:blue" %)**Battery Info:**
... ... @@ -264,9 +264,9 @@
264 264  
265 265  (% style="color:blue" %)**Sensor State:**
266 266  
267 -Ex1: 0x00: Normal collection distance
279 +Ex1: 0x00: Distance Reading is valid
268 268  
269 -Ex2: 0x0x: Distance collection is wrong
281 +Ex2: 0x0x: Distance Reading is invalid
270 270  
271 271  
272 272  (% style="color:blue" %)**Interrupt Count:**
... ... @@ -286,12 +286,46 @@
286 286  * **Set over-limit alarm mode: AT+DOL=3,500,244,**(% style="color:red" %)0(%%)**,120**
287 287  
288 288  (% class="wikigeneratedid" id="HUninterruptedmeasurement.Whenthedistanceexceedsthelimit2CtheoutputIOissethighandreportsarereportedeveryfiveminutes.Thetimecanbesetandpoweredbyanexternalpowersupply.UplinkPayloadtotals11bytes." %)
289 -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.
290 290  
291 -(% 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" %)
292 292  |(% 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**
293 -|(% 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
294 294  
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 +
295 295  [[image:image-20231209171127-3.png||height="374" width="1209"]]
296 296  
297 297  (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
... ... @@ -309,19 +309,19 @@
309 309  
310 310  (% style="color:red" %)**DO:**
311 311  
312 -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.
313 313  
314 -(% style="color:red" %)**Limit flag:**
360 +(% style="color:red" %)**Threshold Flag for Alarm:**
315 315  
316 316  Mode for setting threshold: **0~~3**
317 317  
318 -**0:** does not use upper and lower limits
364 +**0:** Distance limit range is not enabled, alarm:0.
319 319  
320 -**1:** Use upper and lower limits
366 +**1:** Trigger Alarm if distance exceed the range between lower and upper.
321 321  
322 -**2:** Less than the upper limit
368 +**2:** Trigger Alarm if distance smaller than the upper limit.
323 323  
324 -**3: **Greater than the lower limit
370 +**3: **Trigger Alarm if distance bigger than the lower limit .
325 325  
326 326  
327 327  (% style="color:blue" %)**Distance:**
... ... @@ -343,22 +343,59 @@
343 343  
344 344  (% style="color:blue" %)**Upper limit:**
345 345  
346 -The upper limit of the threshold cannot exceed 2000mm.
392 +Show the pre-set upper limit in Hex, Unit: mm.
347 347  
394 +Ex: 01F4(H)=500mm
348 348  
396 +
349 349  (% style="color:blue" %)**Lower limit:**
350 350  
351 -The lower limit of the threshold cannot be less than 3mm.
399 +Show the pre-set lower limit in Hex, Unit: mm.
352 352  
401 +Ex: 0xF4(H)=244mm
353 353  
403 +
354 354  * **Set the person or object count mode: AT+DOL=1,500,244,**(% style="color:red" %)1(%%)**,120**
355 355  
356 -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.
357 357  
358 -(% 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" %)
359 359  |(% 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**
360 -|(% 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
361 361  
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 +
362 362  [[image:image-20231209173457-5.png||height="277" width="1098"]]
363 363  
364 364  (% style="color:blue" %)**MOD & Alarm & Do & Limit flag:**
... ... @@ -376,9 +376,9 @@
376 376  
377 377  (% style="color:red" %)**Do:**
378 378  
379 -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.
380 380  
381 -(% style="color:red" %)**Limit flag:**
464 +(% style="color:red" %)**Threshold Flag for Alarm:**
382 382  
383 383  Mode for setting threshold: **0~~3**
384 384  
... ... @@ -408,14 +408,18 @@
408 408  
409 409  (% style="color:blue" %)**Upper limit:**
410 410  
411 -The upper limit of the threshold cannot exceed 2000mm.
494 +Show the pre-set upper limit in Hex, Unit: mm.
412 412  
496 +Ex: 01F4(H)=500mm
413 413  
498 +
414 414  (% style="color:blue" %)**Lower limit:**
415 415  
416 -The lower limit of the threshold cannot be less than 3mm.
501 +Show the pre-set lower limit in Hex, Unit: mm.
417 417  
503 +Ex: 0xF4(H)=244mm
418 418  
505 +
419 419  == 2.4 Decode payload in The Things Network ==
420 420  
421 421  
... ... @@ -487,12 +487,11 @@
487 487  
488 488  DS20L supports below configure method:
489 489  
490 -* AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
491 -
492 492  * 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]].
493 493  
494 494  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
495 495  
581 +
496 496  == 3.2 General Commands ==
497 497  
498 498  
... ... @@ -596,7 +596,6 @@
596 596  
597 597  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
598 598  
599 -
600 600  === 3.3.3 Set work mode ===
601 601  
602 602  
... ... @@ -618,7 +618,6 @@
618 618  
619 619  * **Example:** 0x0A02  ~/~/  Same as AT+MOD=2
620 620  
621 -
622 622  === 3.3.4 Set threshold and threshold mode ===
623 623  
624 624  
... ... @@ -737,7 +737,6 @@
737 737  
738 738  * 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]]**.
739 739  
740 -
741 741  = 6. FAQ =
742 742  
743 743  == 6.1 What is the frequency plan for DS20L? ==