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

From version 125.12
edited by Xiaoling
on 2023/11/29 09:53
Change comment: There is no comment for this version
To version 124.2
edited by Xiaoling
on 2023/11/28 15:12
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,32 +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 -
565 -
566 -
567 -
568 -
569 -
570 -
571 -**AT+DOL=5,1800,0,0,400**
572 -)))|(% 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
573 573  |(% style="width:251px" %)1: Use upper and lower limits
574 574  |(% style="width:251px" %)2: Less than the lower limit
575 575  |(% style="width:251px" %)3: Greater than the lower limit
... ... @@ -585,8 +585,6 @@
585 585  
586 586  )))
587 587  
588 -
589 -
590 590  (% style="color:blue" %)**Downlink Command: 0x07**
591 591  
592 592  Format: Command Code (0x07) followed by 9bytes.
... ... @@ -595,16 +595,7 @@
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,0,100,0,400
599 599  
600 -* Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
601 -
602 -* Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
603 -
604 -* Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
605 -
606 -
607 -
608 608  = 4. Battery & Power Consumption =
609 609  
610 610  
... ... @@ -633,8 +633,6 @@
633 633  
634 634  * 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]]**.
635 635  
636 -
637 -
638 638  = 6. FAQ =
639 639  
640 640  == 6.1 What is the frequency plan for DS20L? ==
... ... @@ -722,8 +722,6 @@
722 722  
723 723  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
724 724  
725 -
726 -
727 727  = 9. ​Packing Info =
728 728  
729 729  
... ... @@ -741,8 +741,6 @@
741 741  
742 742  * Weight / pcs : g
743 743  
744 -
745 -
746 746  = 10. Support =
747 747  
748 748  
image-20231129085201-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -70.6 KB
Content