Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 124.2
edited by Xiaoling
on 2023/11/28 15:12
Change comment: There is no comment for this version
To version 131.1
edited by Mengting Qiu
on 2023/12/06 19:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.ting
Content
... ... @@ -8,7 +8,7 @@
8 8  
9 9  
10 10  
11 -**Table of Contents：**
11 +**Table of Contents:(% style="display:none" %) (%%)**
12 12  
13 13  {{toc/}}
14 14  
... ... @@ -47,6 +47,7 @@
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 +
50 50  == 1.3 Specification ==
51 51  
52 52  
... ... @@ -60,6 +60,7 @@
60 60  * ToF FoV: ±9°, Total 18°
61 61  * Light source: VCSEL
62 62  
64 +
63 63  == 1.4 Power Consumption ==
64 64  
65 65  
... ... @@ -73,6 +73,7 @@
73 73  * Idle: 21 mA @ 3.3v
74 74  * Max : 360 mA
75 75  
78 +
76 76  = 2. Configure DS20L to connect to LoRaWAN network =
77 77  
78 78  == 2.1 How it works ==
... ... @@ -150,7 +150,7 @@
150 150  
151 151  Example parse in TTNv3
152 152  
153 -[[image:1701149922873-259.png]]
156 +[[image:image-20231206151412-3.png||height="179" width="1070"]]
154 154  
155 155  (% style="color:blue" %)**Sensor Model**(%%): For DS20L, this value is 0x21
156 156  
... ... @@ -216,7 +216,7 @@
216 216  |(% 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**
217 217  |(% 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
218 218  
219 -[[image:1701155076393-719.png]]
222 +[[image:image-20231206154621-4.png||height="214" width="1019"]]
220 220  
221 221  (% style="color:blue" %)**Battery Info:**
222 222  
... ... @@ -292,19 +292,19 @@
292 292  
293 293  (% style="color:red" %)**Limit flag:**
294 294  
295 -Mode for setting threshold: 0~~5
298 +Mode for setting threshold: **0~~5**
296 296  
297 -0: does not use upper and lower limits
300 +**0:** does not use upper and lower limits
298 298  
299 -1: Use upper and lower limits
302 +**1:** Use upper and lower limits
300 300  
301 -2: is less than the lower limit value
304 +**2:** is less than the lower limit value
302 302  
303 -3: is greater than the lower limit value
306 +**3:** is greater than the lower limit value
304 304  
305 -4: is less than the upper limit
308 +**4:** is less than the upper limit
306 306  
307 -5: is greater than the upper limit
310 +**5:** is greater than the upper limit
308 308  
309 309  
310 310  (% style="color:blue" %)**Upper limit:**
... ... @@ -317,94 +317,12 @@
317 317  The lower limit of the threshold cannot be less than 3mm.
318 318  
319 319  
320 -=== 2.3.3 Historical measuring distance, FPORT~=3 ===
323 +== 2.4 Decode payload in The Things Network ==
321 321  
322 322  
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 -
405 405  While using TTN network, you can add the payload format to decode the payload.
406 406  
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"]]
328 +[[image:image-20231206143515-1.png||height="534" width="759"]]
408 408  
409 409  
410 410  (((
... ... @@ -416,7 +416,7 @@
416 416  )))
417 417  
418 418  
419 -== 2.4 ​Show Data in DataCake IoT Server ==
340 +== 2.5 ​Show Data in DataCake IoT Server ==
420 420  
421 421  
422 422  (((
... ... @@ -448,10 +448,10 @@
448 448  
449 449  After added, the sensor data arrive TTN V3, it will also arrive and show in Datacake.
450 450  
451 -[[image:1701152946067-561.png]]
372 +[[image:image-20231129100454-2.png||height="501" width="928"]]
452 452  
453 453  
454 -== 2.5 Frequency Plans ==
375 +== 2.6 Frequency Plans ==
455 455  
456 456  
457 457  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.
... ... @@ -472,6 +472,7 @@
472 472  
473 473  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
474 474  
396 +
475 475  == 3.2 General Commands ==
476 476  
477 477  
... ... @@ -532,6 +532,9 @@
532 532  )))
533 533  * (((
534 534  Example 2: Downlink Payload: 0100003C  ~/~/ Set Transmit Interval (TDC) = 60 seconds
457 +
458 +
459 +
535 535  )))
536 536  
537 537  === 3.3.2 Set Interrupt Mode ===
... ... @@ -572,9 +572,10 @@
572 572  
573 573  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
574 574  
575 -== 3.3.3 Set work mode ==
576 576  
501 +=== 3.3.3 Set work mode ===
577 577  
503 +
578 578  Feature: Switch working mode
579 579  
580 580  (% style="color:blue" %)**AT Command: AT+MOD**
... ... @@ -589,10 +589,11 @@
589 589  
590 590  (% style="color:blue" %)**Downlink Command:**
591 591  
592 -* **Example: **0x0A00  ~/~/  Same as AT+MOD=0
518 +* **Example: **0x0A01 ~/~/  Same as AT+MOD=1
593 593  
594 -* **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
520 +* **Example:** 0x0A02  ~/~/  Same as AT+MOD=2
595 595  
522 +
596 596  === 3.3.4 Set threshold and threshold mode ===
597 597  
598 598  
... ... @@ -610,9 +610,29 @@
610 610  )))
611 611  |(% style="width:172px" %)AT+ DOL =1,1800,100,0,400|(% style="width:279px" %)Set only the upper and lower thresholds|(% style="width:118px" %)OK
612 612  
613 -
614 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
541 +|(% rowspan="11" style="color:blue; width:120px" %)(((
542 +
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
616 616  |(% style="width:251px" %)1: Use upper and lower limits
617 617  |(% style="width:251px" %)2: Less than the lower limit
618 618  |(% style="width:251px" %)3: Greater than the lower limit
... ... @@ -628,15 +628,26 @@
628 628  
629 629  )))
630 630  
578 +
631 631  (% style="color:blue" %)**Downlink Command: 0x07**
632 632  
633 -Format: Command Code (0x07) followed by 9bytes.
581 +Format: Command Code (0x07) followed by 9 bytes.
634 634  
635 -* Example 0: Downlink Payload: 070000000000000190  **~-~-->**  AT+MOD=0,0,0,0,400
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.
636 636  
585 +* Example 0: Downlink Payload: 07 00 0000 0000 00 0190  **~-~-->**  AT+MOD=0,0,0,0,400
586 +
637 637  * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
638 638  
589 +* Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
639 639  
591 +* Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
592 +
593 +* Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
594 +
595 +* Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
596 +
597 +
640 640  = 4. Battery & Power Consumption =
641 641  
642 642  
... ... @@ -665,6 +665,7 @@
665 665  
666 666  * 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]]**.
667 667  
626 +
668 668  = 6. FAQ =
669 669  
670 670  == 6.1 What is the frequency plan for DS20L? ==
... ... @@ -752,6 +752,7 @@
752 752  
753 753  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
754 754  
714 +
755 755  = 9. ​Packing Info =
756 756  
757 757  
... ... @@ -769,6 +769,7 @@
769 769  
770 770  * Weight / pcs : g
771 771  
732 +
772 772  = 10. Support =
773 773  
774 774  
... ... @@ -775,3 +775,6 @@
775 775  * 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.
776 776  
777 777  * 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,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +70.6 KB
Content
image-20231129100454-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +70.1 KB
Content
image-20231206143515-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +89.5 KB
Content
image-20231206144950-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +41.0 KB
Content
image-20231206151412-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +58.8 KB
Content
image-20231206154621-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.ting
Size
... ... @@ -1,0 +1,1 @@
1 +71.2 KB
Content