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

From version 124.3
edited by Xiaoling
on 2023/11/28 15:14
Change comment: There is no comment for this version
To version 125.8
edited by Xiaoling
on 2023/11/29 09:19
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -47,6 +47,8 @@
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 +
50 50  == 1.3 Specification ==
51 51  
52 52  
... ... @@ -60,6 +60,8 @@
60 60  * ToF FoV: ±9°, Total 18°
61 61  * Light source: VCSEL
62 62  
65 +
66 +
63 63  == 1.4 Power Consumption ==
64 64  
65 65  
... ... @@ -73,6 +73,8 @@
73 73  * Idle: 21 mA @ 3.3v
74 74  * Max : 360 mA
75 75  
80 +
81 +
76 76  = 2. Configure DS20L to connect to LoRaWAN network =
77 77  
78 78  == 2.1 How it works ==
... ... @@ -292,19 +292,19 @@
292 292  
293 293  (% style="color:red" %)**Limit flag:**
294 294  
295 -Mode for setting threshold: 0~~5
301 +Mode for setting threshold: **0~~5**
296 296  
297 -0: does not use upper and lower limits
303 +**0:** does not use upper and lower limits
298 298  
299 -1: Use upper and lower limits
305 +**1:** Use upper and lower limits
300 300  
301 -2: is less than the lower limit value
307 +**2:** is less than the lower limit value
302 302  
303 -3: is greater than the lower limit value
309 +**3:** is greater than the lower limit value
304 304  
305 -4: is less than the upper limit
311 +**4:** is less than the upper limit
306 306  
307 -5: is greater than the upper limit
313 +**5:** is greater than the upper limit
308 308  
309 309  
310 310  (% style="color:blue" %)**Upper limit:**
... ... @@ -317,91 +317,9 @@
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 ===
326 +== 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 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"]]
... ... @@ -416,7 +416,7 @@
416 416  )))
417 417  
418 418  
419 -== 2.4 ​Show Data in DataCake IoT Server ==
343 +== 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]]
375 +[[image:image-20231129085201-1.png||height="515" width="961"]]
452 452  
453 453  
454 -== 2.5 Frequency Plans ==
378 +== 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,8 @@
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  
399 +
400 +
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
461 +
462 +
463 +
535 535  )))
536 536  
537 537  === 3.3.2 Set Interrupt Mode ===
... ... @@ -572,9 +572,11 @@
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  
577 577  
506 +=== 3.3.3 Set work mode ===
507 +
508 +
578 578  Feature: Switch working mode
579 579  
580 580  (% style="color:blue" %)**AT Command: AT+MOD**
... ... @@ -593,6 +593,8 @@
593 593  
594 594  * **Example:** 0x0A01  ~/~/  Same as AT+MOD=1
595 595  
527 +
528 +
596 596  === 3.3.4 Set threshold and threshold mode ===
597 597  
598 598  
... ... @@ -611,8 +611,22 @@
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 613  
547 +
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
549 +|(% rowspan="11" style="color:blue; width:120px" %)(((
550 +
551 +
552 +
553 +
554 +
555 +
556 +
557 +
558 +
559 +
560 +
561 +**AT+DOL=5,1800,0,0,400**
562 +)))|(% rowspan="6" style="width:240px" %)The first bit sets the limit mode|(% 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,6 +628,8 @@
628 628  
629 629  )))
630 630  
578 +
579 +
631 631  (% style="color:blue" %)**Downlink Command: 0x07**
632 632  
633 633  Format: Command Code (0x07) followed by 9bytes.
... ... @@ -638,7 +638,7 @@
638 638  
639 639  * Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
640 640  
641 -* Example 3: Downlink Payload: 0703200000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
590 +* Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
642 642  
643 643  * Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
644 644  
... ... @@ -645,6 +645,7 @@
645 645  * Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
646 646  
647 647  
597 +
648 648  = 4. Battery & Power Consumption =
649 649  
650 650  
... ... @@ -673,6 +673,8 @@
673 673  
674 674  * 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]]**.
675 675  
626 +
627 +
676 676  = 6. FAQ =
677 677  
678 678  == 6.1 What is the frequency plan for DS20L? ==
... ... @@ -760,6 +760,8 @@
760 760  
761 761  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
762 762  
715 +
716 +
763 763  = 9. ​Packing Info =
764 764  
765 765  
... ... @@ -777,6 +777,8 @@
777 777  
778 778  * Weight / pcs : g
779 779  
734 +
735 +
780 780  = 10. Support =
781 781  
782 782  
image-20231129085201-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +70.6 KB
Content