Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 125.10
edited by Xiaoling
on 2023/11/29 09:52
Change comment: There is no comment for this version
To version 124.3
edited by Xiaoling
on 2023/11/28 15:14
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -47,8 +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 -
52 52  == 1.3 Specification ==
53 53  
54 54  
... ... @@ -62,8 +62,6 @@
62 62  * ToF FoV: ±9°, Total 18°
63 63  * Light source: VCSEL
64 64  
65 -
66 -
67 67  == 1.4 Power Consumption ==
68 68  
69 69  
... ... @@ -77,8 +77,6 @@
77 77  * Idle: 21 mA @ 3.3v
78 78  * Max : 360 mA
79 79  
80 -
81 -
82 82  = 2. Configure DS20L to connect to LoRaWAN network =
83 83  
84 84  == 2.1 How it works ==
... ... @@ -298,19 +298,19 @@
298 298  
299 299  (% style="color:red" %)**Limit flag:**
300 300  
301 -Mode for setting threshold: **0~~5**
295 +Mode for setting threshold: 0~~5
302 302  
303 -**0:** does not use upper and lower limits
297 +0: does not use upper and lower limits
304 304  
305 -**1:** Use upper and lower limits
299 +1: Use upper and lower limits
306 306  
307 -**2:** is less than the lower limit value
301 +2: is less than the lower limit value
308 308  
309 -**3:** is greater than the lower limit value
303 +3: is greater than the lower limit value
310 310  
311 -**4:** is less than the upper limit
305 +4: is less than the upper limit
312 312  
313 -**5:** is greater than the upper limit
307 +5: is greater than the upper limit
314 314  
315 315  
316 316  (% style="color:blue" %)**Upper limit:**
... ... @@ -323,9 +323,91 @@
323 323  The lower limit of the threshold cannot be less than 3mm.
324 324  
325 325  
326 -== 2.4 Decode payload in The Things Network ==
320 +=== 2.3.3 Historical measuring distance, FPORT~=3 ===
327 327  
328 328  
323 +DS20L stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
324 +
325 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
326 +
327 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
328 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
329 +**Size(bytes)**
330 +)))|=(% style="width: 80px;background-color:#4F81BD;color:white" %)1|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**1**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 70px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD; color: white; width: 85px;" %)**1**|=(% style="background-color: #4F81BD; color: white; width: 85px;" %)4
331 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
332 +Reserve(0xFF)
333 +)))|Distance|Distance signal strength|(% style="width:88px" %)(((
334 +LiDAR temp
335 +)))|(% style="width:85px" %)Unix TimeStamp
336 +
337 +**Interrupt flag & Interrupt level:**
338 +
339 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
340 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
341 +**Size(bit)**
342 +)))|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit7**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit6**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**[bit5:bit2]**|=(% style="width: 90px; background-color: #4F81BD; color: white;" %)**bit1**|=(% style="background-color: #4F81BD; color: white; width: 90px;" %)**bit0**
343 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)No ACK message|(% style="width:62.5px" %)Poll Message Flag|Reserve|(% style="width:91px" %)Interrupt level|(% style="width:88px" %)(((
344 +Interrupt flag
345 +)))
346 +
347 +* (((
348 +Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, DS20L will send max bytes according to the current DR and Frequency bands.
349 +)))
350 +
351 +For example, in the US915 band, the max payload for different DR is:
352 +
353 +**a) DR0:** max is 11 bytes so one entry of data
354 +
355 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
356 +
357 +**c) DR2:** total payload includes 11 entries of data
358 +
359 +**d) DR3:** total payload includes 22 entries of data.
360 +
361 +If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0
362 +
363 +
364 +**Downlink:**
365 +
366 +0x31 64 CC 68 0C 64 CC 69 74 05
367 +
368 +[[image:image-20230805144936-2.png||height="113" width="746"]]
369 +
370 +**Uplink:**
371 +
372 +43 FF 0E 10 00 B0 1E 64 CC 68 0C 40 FF 0D DE 00 A8 1E 64 CC 68 29 40 FF 09 92 00 D3 1E 64 CC 68 65 40 FF 02 3A 02 BC 1E 64 CC 68 A1 41 FF 0E 1A 00 A4 1E 64 CC 68 C0 40 FF 0D 2A 00 B8 1E 64 CC 68 E8 40 FF 00 C8 11 6A 1E 64 CC 69 24 40 FF 0E 24 00 AD 1E 64 CC 69 6D
373 +
374 +
375 +**Parsed Value:**
376 +
377 +[DISTANCE , DISTANCE_SIGNAL_STRENGTH，LIDAR_TEMP，EXTI_STATUS , EXTI_FLAG , TIME]
378 +
379 +
380 +[360,176,30,High,True,2023-08-04 02:53:00],
381 +
382 +[355,168,30,Low,False,2023-08-04 02:53:29],
383 +
384 +[245,211,30,Low,False,2023-08-04 02:54:29],
385 +
386 +[57,700,30,Low,False,2023-08-04 02:55:29],
387 +
388 +[361,164,30,Low,True,2023-08-04 02:56:00],
389 +
390 +[337,184,30,Low,False,2023-08-04 02:56:40],
391 +
392 +[20,4458,30,Low,False,2023-08-04 02:57:40],
393 +
394 +[362,173,30,Low,False,2023-08-04 02:58:53],
395 +
396 +
397 +**History read from serial port：**
398 +
399 +[[image:image-20230805145056-3.png]]
400 +
401 +
402 +=== 2.3.4 Decode payload in The Things Network ===
403 +
404 +
329 329  While using TTN network, you can add the payload format to decode the payload.
330 330  
331 331  [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654592762713-715.png?rev=1.1||alt="1654592762713-715.png"]]
... ... @@ -340,7 +340,7 @@
340 340  )))
341 341  
342 342  
343 -== 2.5 ​Show Data in DataCake IoT Server ==
419 +== 2.4 ​Show Data in DataCake IoT Server ==
344 344  
345 345  
346 346  (((
... ... @@ -372,10 +372,10 @@
372 372  
373 373  After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
374 374  
375 -[[image:image-20231129085201-1.png||height="515" width="961"]]
451 +[[image:1701152946067-561.png]]
376 376  
377 377  
378 -== 2.6 Frequency Plans ==
454 +== 2.5 Frequency Plans ==
379 379  
380 380  
381 381  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.
... ... @@ -396,8 +396,6 @@
396 396  
397 397  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
398 398  
399 -
400 -
401 401  == 3.2 General Commands ==
402 402  
403 403  
... ... @@ -458,9 +458,6 @@
458 458  )))
459 459  * (((
460 460  Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
461 -
462 -
463 -
464 464  )))
465 465  
466 466  === 3.3.2 Set Interrupt Mode ===
... ... @@ -501,11 +501,9 @@
501 501  
502 502  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
503 503  
575 +== 3.3.3 Set work mode ==
504 504  
505 505  
506 -=== 3.3.3 Set work mode ===
507 -
508 -
509 509  Feature: Switch working mode
510 510  
511 511  (% style="color:blue" %)**AT Command: AT+MOD**
... ... @@ -524,8 +524,6 @@
524 524  
525 525  * **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
526 526  
527 -
528 -
529 529  === 3.3.4 Set threshold and threshold mode ===
530 530  
531 531  
... ... @@ -544,25 +544,8 @@
544 544  |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
545 545  
546 546  
547 -
548 548  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
549 -|(% rowspan="11" style="color:blue; width:120px" %)(((
550 -
551 -
552 -
553 -
554 -
555 -
556 -
557 -
558 -
559 -
560 -
561 -
562 -
563 -
564 -**AT+DOL=5,1800,0,0,400**
565 -)))|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits
615 +|(% rowspan="11" style="color:blue; width:120px" %)**AT+DOL=5,1800,0,0,400**|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% style="width:150px" %)0: Do not use upper and lower limits
566 566  |(% style="width:251px" %)1: Use upper and lower limits
567 567  |(% style="width:251px" %)2: Less than the lower limit
568 568  |(% style="width:251px" %)3: Greater than the lower limit
... ... @@ -578,8 +578,6 @@
578 578  
579 579  )))
580 580  
581 -
582 -
583 583  (% style="color:blue" %)**Downlink Command: 0x07**
584 584  
585 585  Format: Command Code (0x07) followed by 9bytes.
... ... @@ -590,7 +590,7 @@
590 590  
591 591  * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
592 592  
593 -* Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
641 +* Example 3: Downlink Payload: 0703200000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
594 594  
595 595  * Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
596 596  
... ... @@ -597,7 +597,6 @@
597 597  * Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
598 598  
599 599  
600 -
601 601  = 4. Battery & Power Consumption =
602 602  
603 603  
... ... @@ -626,8 +626,6 @@
626 626  
627 627  * 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]]**.
628 628  
629 -
630 -
631 631  = 6. FAQ =
632 632  
633 633  == 6.1 What is the frequency plan for DS20L? ==
... ... @@ -715,8 +715,6 @@
715 715  
716 716  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
717 717  
718 -
719 -
720 720  = 9. ​Packing Info =
721 721  
722 722  
... ... @@ -734,8 +734,6 @@
734 734  
735 735  * Weight / pcs : g
736 736  
737 -
738 -
739 739  = 10. Support =
740 740  
741 741  
image-20231129085201-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -70.6 KB
Content