Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 130.2
edited by Mengting Qiu
on 2023/12/06 18:46
Change comment: There is no comment for this version
To version 124.4
edited by Xiaoling
on 2023/11/28 15:18
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  
... ... @@ -48,6 +48,7 @@
48 48  * Built-in 2400mAh battery or power by external power source
49 49  
50 50  
51 +
51 51  == 1.3 Specification ==
52 52  
53 53  
... ... @@ -62,6 +62,7 @@
62 62  * Light source: VCSEL
63 63  
64 64  
66 +
65 65  == 1.4 Power Consumption ==
66 66  
67 67  
... ... @@ -76,6 +76,7 @@
76 76  * Max : 360 mA
77 77  
78 78  
81 +
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"]]
159 +[[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"]]
225 +[[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**
301 +Mode for setting threshold: 0~~5
299 299  
300 -**0:** does not use upper and lower limits
303 +0: does not use upper and lower limits
301 301  
302 -**1:** Use upper and lower limits
305 +1: Use upper and lower limits
303 303  
304 -**2:** is less than the lower limit value
307 +2: is less than the lower limit value
305 305  
306 -**3:** is greater than the lower limit value
309 +3: is greater than the lower limit value
307 307  
308 -**4:** is less than the upper limit
311 +4: is less than the upper limit
309 309  
310 -**5:** is greater than the upper limit
313 +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 ==
326 +=== 2.3.3 Historical measuring distance, FPORT~=3 ===
324 324  
325 325  
329 +DS20L stores sensor values and users can retrieve these history values via the downlink command.
330 +
331 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
332 +
333 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
334 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
335 +**Size(bytes)**
336 +)))|=(% 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
337 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
338 +Reserve(0xFF)
339 +)))|Distance|Distance signal strength|(% style="width:88px" %)(((
340 +LiDAR temp
341 +)))|(% style="width:85px" %)Unix TimeStamp
342 +
343 +**Interrupt flag & Interrupt level:**
344 +
345 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
346 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
347 +**Size(bit)**
348 +)))|=(% 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**
349 +|(% 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" %)(((
350 +Interrupt flag
351 +)))
352 +
353 +* (((
354 +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.
355 +)))
356 +
357 +For example, in the US915 band, the max payload for different DR is:
358 +
359 +**a) DR0:** max is 11 bytes so one entry of data
360 +
361 +**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
362 +
363 +**c) DR2:** total payload includes 11 entries of data
364 +
365 +**d) DR3:** total payload includes 22 entries of data.
366 +
367 +If DS20L doesn't have any data in the polling time. It will uplink 11 bytes of 0
368 +
369 +
370 +**Downlink:**
371 +
372 +0x31 64 CC 68 0C 64 CC 69 74 05
373 +
374 +[[image:image-20230805144936-2.png||height="113" width="746"]]
375 +
376 +**Uplink:**
377 +
378 +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
379 +
380 +
381 +**Parsed Value:**
382 +
383 +[DISTANCE , DISTANCE_SIGNAL_STRENGTH，LIDAR_TEMP，EXTI_STATUS , EXTI_FLAG , TIME]
384 +
385 +
386 +[360,176,30,High,True,2023-08-04 02:53:00],
387 +
388 +[355,168,30,Low,False,2023-08-04 02:53:29],
389 +
390 +[245,211,30,Low,False,2023-08-04 02:54:29],
391 +
392 +[57,700,30,Low,False,2023-08-04 02:55:29],
393 +
394 +[361,164,30,Low,True,2023-08-04 02:56:00],
395 +
396 +[337,184,30,Low,False,2023-08-04 02:56:40],
397 +
398 +[20,4458,30,Low,False,2023-08-04 02:57:40],
399 +
400 +[362,173,30,Low,False,2023-08-04 02:58:53],
401 +
402 +
403 +**History read from serial port：**
404 +
405 +[[image:image-20230805145056-3.png]]
406 +
407 +
408 +=== 2.3.4 Decode payload in The Things Network ===
409 +
410 +
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"]]
413 +[[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 ==
425 +== 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"]]
457 +[[image:1701152946067-561.png]]
373 373  
374 374  
375 -== 2.6 Frequency Plans ==
460 +== 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  
... ... @@ -497,10 +497,9 @@
497 497  
498 498  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
499 499  
584 +== 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
601 +* **Example: **0x0A00  ~/~/  Same as AT+MOD=0
519 519  
520 -* **Example:** 0x0A02  ~/~/  Same as AT+MOD=2
603 +* **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
521 521  
522 -
523 523  === 3.3.4 Set threshold and threshold mode ===
524 524  
525 525  
... ... @@ -538,28 +538,7 @@
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 540  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
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
623 +|(% 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,7 +575,6 @@
575 575  
576 576  )))
577 577  
578 -
579 579  (% style="color:blue" %)**Downlink Command: 0x07**
580 580  
581 581  Format: Command Code (0x07) followed by 9bytes.
... ... @@ -586,7 +586,7 @@
586 586  
587 587  * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
588 588  
589 -* Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
649 +* Example 3: Downlink Payload: 0703200000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
590 590  
591 591  * Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
592 592  
... ... @@ -593,6 +593,7 @@
593 593  * Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
594 594  
595 595  
656 +
596 596  = 4. Battery & Power Consumption =
597 597  
598 598  
... ... @@ -621,7 +621,6 @@
621 621  
622 622  * 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]]**.
623 623  
624 -
625 625  = 6. FAQ =
626 626  
627 627  == 6.1 What is the frequency plan for DS20L? ==
... ... @@ -709,7 +709,6 @@
709 709  
710 710  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
711 711  
712 -
713 713  = 9. ​Packing Info =
714 714  
715 715  
... ... @@ -727,7 +727,6 @@
727 727  
728 728  * Weight / pcs : g
729 729  
730 -
731 731  = 10. Support =
732 732  
733 733  
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