Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 132.1
edited by Mengting Qiu
on 2023/12/06 19:48
Change comment: Uploaded new attachment "image-20231206194804-5.png", version {1}
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
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ting
1 +XWiki.Xiaoling
Content
... ... @@ -8,7 +8,7 @@
8 8  
9 9  
10 10  
11 -**Table of Contents:(% style="display:none" %) (%%)**
11 +**Table of Contents：**
12 12  
13 13  {{toc/}}
14 14  
... ... @@ -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  
... ... @@ -61,7 +61,6 @@
61 61  * ToF FoV: ±9°, Total 18°
62 62  * Light source: VCSEL
63 63  
64 -
65 65  == 1.4 Power Consumption ==
66 66  
67 67  
... ... @@ -75,7 +75,6 @@
75 75  * Idle: 21 mA @ 3.3v
76 76  * Max : 360 mA
77 77  
78 -
79 79  = 2. Configure DS20L to connect to LoRaWAN network =
80 80  
81 81  == 2.1 How it works ==
... ... @@ -153,7 +153,7 @@
153 153  
154 154  Example parse in TTNv3
155 155  
156 -[[image:image-20231206151412-3.png||height="179" width="1070"]]
153 +[[image:1701149922873-259.png]]
157 157  
158 158  (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
159 159  
... ... @@ -219,7 +219,7 @@
219 219  |(% 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**
220 220  |(% 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
221 221  
222 -[[image:image-20231206154621-4.png||height="214" width="1019"]]
219 +[[image:1701155076393-719.png]]
223 223  
224 224  (% style="color:blue" %)**Battery Info:**
225 225  
... ... @@ -295,19 +295,19 @@
295 295  
296 296  (% style="color:red" %)**Limit flag:**
297 297  
298 -Mode for setting threshold: **0~~5**
295 +Mode for setting threshold: 0~~5
299 299  
300 -**0:** does not use upper and lower limits
297 +0: does not use upper and lower limits
301 301  
302 -**1:** Use upper and lower limits
299 +1: Use upper and lower limits
303 303  
304 -**2:** is less than the lower limit value
301 +2: is less than the lower limit value
305 305  
306 -**3:** is greater than the lower limit value
303 +3: is greater than the lower limit value
307 307  
308 -**4:** is less than the upper limit
305 +4: is less than the upper limit
309 309  
310 -**5:** is greater than the upper limit
307 +5: is greater than the upper limit
311 311  
312 312  
313 313  (% style="color:blue" %)**Upper limit:**
... ... @@ -320,12 +320,94 @@
320 320  The lower limit of the threshold cannot be less than 3mm.
321 321  
322 322  
323 -== 2.4 Decode payload in The Things Network ==
320 +=== 2.3.3 Historical measuring distance, FPORT~=3 ===
324 324  
325 325  
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 +
326 326  While using TTN network, you can add the payload format to decode the payload.
327 327  
328 -[[image:image-20231206143515-1.png||height="534" width="759"]]
407 +[[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"]]
329 329  
330 330  
331 331  (((
... ... @@ -337,7 +337,7 @@
337 337  )))
338 338  
339 339  
340 -== 2.5 ​Show Data in DataCake IoT Server ==
419 +== 2.4 ​Show Data in DataCake IoT Server ==
341 341  
342 342  
343 343  (((
... ... @@ -369,10 +369,10 @@
369 369  
370 370  After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
371 371  
372 -[[image:image-20231129100454-2.png||height="501" width="928"]]
451 +[[image:1701152946067-561.png]]
373 373  
374 374  
375 -== 2.6 Frequency Plans ==
454 +== 2.5 Frequency Plans ==
376 376  
377 377  
378 378  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.
... ... @@ -393,7 +393,6 @@
393 393  
394 394  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
395 395  
396 -
397 397  == 3.2 General Commands ==
398 398  
399 399  
... ... @@ -454,9 +454,6 @@
454 454  )))
455 455  * (((
456 456  Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
457 -
458 -
459 -
460 460  )))
461 461  
462 462  === 3.3.2 Set Interrupt Mode ===
... ... @@ -497,10 +497,9 @@
497 497  
498 498  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
499 499  
575 +== 3.3.3 Set work mode ==
500 500  
501 -=== 3.3.3 Set work mode ===
502 502  
503 -
504 504  Feature: Switch working mode
505 505  
506 506  (% style="color:blue" %)**AT Command: AT+MOD**
... ... @@ -515,11 +515,10 @@
515 515  
516 516  (% style="color:blue" %)**Downlink Command:**
517 517  
518 -* **Example: **0x0A01 ~/~/  Same as AT+MOD=1
592 +* **Example: **0x0A00  ~/~/  Same as AT+MOD=0
519 519  
520 -* **Example:** 0x0A02  ~/~/  Same as AT+MOD=2
594 +* **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
521 521  
522 -
523 523  === 3.3.4 Set threshold and threshold mode ===
524 524  
525 525  
... ... @@ -537,29 +537,9 @@
537 537  )))
538 538  |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
539 539  
540 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
541 -|(% rowspan="11" style="color:blue; width:120px" %)(((
542 -
543 543  
544 -
545 -
546 -
547 -
548 -
549 -
550 -
551 -
552 -
553 -**AT+DOL=5,1800,0,0,400**
554 -)))|(% rowspan="6" style="width:240px" %)(((
555 -
556 -
557 -
558 -
559 -
560 -
561 -The first bit sets the limit mode
562 -)))|(% style="width:150px" %)0: Do not use upper and lower limits
614 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
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
563 563  |(% style="width:251px" %)1: Use upper and lower limits
564 564  |(% style="width:251px" %)2: Less than the lower limit
565 565  |(% style="width:251px" %)3: Greater than the lower limit
... ... @@ -575,20 +575,17 @@
575 575  
576 576  )))
577 577  
578 -
579 579  (% style="color:blue" %)**Downlink Command: 0x07**
580 580  
581 -Format: Command Code (0x07) followed by 9 bytes.
633 +Format: Command Code (0x07) followed by 9bytes.
582 582  
583 -If the downlink payload=**07 01 0708 0064 00 0190**, it means set the END Node's limit mode to 0x01,upper limit value to 0x0708=1800(mm), lower limit value to 0x0064=100(mm), to over-limit alarm(0x00) ,the sampling time to 0x0190=400(ms), while type code is 0x07.
635 +* Example 0: Downlink Payload: 070000000000000190  **~-~-->**  AT+MOD=0,0,0,0,400
584 584  
585 -* Example 0: Downlink Payload: 07 00 0000 0000 00 0190  **~-~-->**  AT+MOD=0,0,0,0,400
586 -
587 587  * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
588 588  
589 589  * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
590 590  
591 -* 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
592 592  
593 593  * Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
594 594  
... ... @@ -623,7 +623,6 @@
623 623  
624 624  * 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]]**.
625 625  
626 -
627 627  = 6. FAQ =
628 628  
629 629  == 6.1 What is the frequency plan for DS20L? ==
... ... @@ -711,7 +711,6 @@
711 711  
712 712  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
713 713  
714 -
715 715  = 9. ​Packing Info =
716 716  
717 717  
... ... @@ -729,7 +729,6 @@
729 729  
730 730  * Weight / pcs : g
731 731  
732 -
733 733  = 10. Support =
734 734  
735 735  
... ... @@ -736,6 +736,3 @@
736 736  * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
737 737  
738 738  * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].
739 -
740 -
741 -
image-20231129085201-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -70.6 KB
Content
image-20231129100454-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -70.1 KB
Content
image-20231206143515-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -89.5 KB
Content
image-20231206144950-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -41.0 KB
Content
image-20231206151412-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -58.8 KB
Content
image-20231206154621-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -71.2 KB
Content
image-20231206194804-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.ting
Size
... ... @@ -1,1 +1,0 @@
1 -53.7 KB
Content