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

From version 125.8
edited by Xiaoling
on 2023/11/29 09:19
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,22 +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 -**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
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,8 +575,6 @@
575 575  
576 576  )))
577 577  
578 -
579 -
580 580  (% style="color:blue" %)**Downlink Command: 0x07**
581 581  
582 582  Format: Command Code (0x07) followed by 9bytes.
... ... @@ -585,16 +585,7 @@
585 585  
586 586  * Example 1: Downlink Payload: 070107080064000190  **~-~-->**  AT+MOD=1,1800,100,0,400
587 587  
588 -* Example 2: Downlink Payload: 070200000064000190  **~-~-->**  AT+MOD=2,0,100,0,400
589 589  
590 -* Example 3: Downlink Payload: 070300000064000190  **~-~-->**  AT+MOD=3,1800,100,0,400
591 -
592 -* Example 4: Downlink Payload: 070407080000000190  **~-~-->**  AT+MOD=4,0,100,0,400
593 -
594 -* Example 5: Downlink Payload: 070507080000000190  **~-~-->**  AT+MOD=5,1800,100,0,400
595 -
596 -
597 -
598 598  = 4. Battery & Power Consumption =
599 599  
600 600  
... ... @@ -623,8 +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 -
628 628  = 6. FAQ =
629 629  
630 630  == 6.1 What is the frequency plan for DS20L? ==
... ... @@ -712,8 +712,6 @@
712 712  
713 713  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
714 714  
715 -
716 -
717 717  = 9. ​Packing Info =
718 718  
719 719  
... ... @@ -731,8 +731,6 @@
731 731  
732 732  * Weight / pcs : g
733 733  
734 -
735 -
736 736  = 10. Support =
737 737  
738 738  
image-20231129085201-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -70.6 KB
Content