Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 97.1
edited by Saxer Lin
on 2023/08/05 14:59
Change comment: There is no comment for this version
To version 113.3
edited by Xiaoling
on 2023/11/10 09:28
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -LDS12-LB -- LoRaWAN LiDAR ToF Distance Sensor User Manual
1 +DS20L -- LoRaWAN Smart Distance Detector User Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Saxer
1 +XWiki.Xiaoling
Content
... ... @@ -1,5 +1,5 @@
1 1  (% style="text-align:center" %)
2 -[[image:image-20230614153353-1.png]]
2 +[[image:image-20231110085342-2.png||height="481" width="481"]]
3 3  
4 4  
5 5  
... ... @@ -7,6 +7,7 @@
7 7  
8 8  
9 9  
10 +
10 10  **Table of Contents：**
11 11  
12 12  {{toc/}}
... ... @@ -18,26 +18,23 @@
18 18  
19 19  = 1. Introduction =
20 20  
21 -== 1.1 What is LoRaWAN LiDAR ToF Distance Sensor ==
22 +== 1.1 What is LoRaWAN Smart Distance Detector ==
22 22  
23 23  
24 -The Dragino LDS12-LB is a (% style="color:blue" %)**LoRaWAN LiDAR ToF (Time of Flight) Distance Sensor**(%%) for Internet of Things solution. It is capable to measure the distance to an object as close as 10 centimeters (+/- 5cm up to 6m) and as far as 12 meters (+/-1% starting at 6m)!. The LiDAR probe uses laser induction technology for distance measurement.
25 +The Dragino (% style="color:blue" %)**DS20L is a smart distance detector**(%%) base on long-range wireless LoRaWAN technology. It uses (% style="color:blue" %)**LiDAR sensor**(%%) to detect the distance between DS20L and object, then DS20L will send the distance data to the IoT Platform via LoRaWAN.
25 25  
26 -The LDS12-LB can be applied to scenarios such as horizontal distance measurement, parking management system, object proximity and presence detection, intelligent trash can management system, robot obstacle avoidance, automatic control, sewer, etc.
27 +DS20L allows users to send data and reach extremely long ranges via LoRaWAN. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current 
28 +consumption. It targets professional wireless sensor network applications such smart cities, building automation, and so on.
27 27  
28 -It detects the distance between the measured object and the sensor, and uploads the value via wireless to LoRaWAN IoT Server.
30 +DS20L has a (% style="color:blue" %)**built-in 2400mAh non-chargeable battery**(%%) for long-term use up to several years*. Users can also power DS20L with an external power source for (% style="color:blue" %)**continuous measuring and distance alarm / counting purposes.**
29 29  
30 -The LoRa wireless technology used in LDS12-LB allows device to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
32 +DS20L is fully compatible with (% style="color:blue" %)**LoRaWAN v1.0.3 Class A protocol**(%%), it can work with a standard LoRaWAN gateway.
31 31  
32 -LDS12-LB (% style="color:blue" %)**supports BLE configure**(%%) and (% style="color:blue" %)**wireless OTA update**(%%) which make user easy to use.
34 +DS20L supports (% style="color:blue" %)**Datalog feature**(%%). It will record the data when there is no network coverage and users can retrieve the sensor value later to ensure no miss for every sensor reading.
33 33  
34 -LDS12-LB is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), it is designed for long term use up to 5 years.
36 +[[image:image-20231110091506-4.png||height="391" width="768"]]
35 35  
36 -Each LDS12-LB is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to local LoRaWAN server and it will auto connect after power on.
37 37  
38 -[[image:image-20230615152941-1.png||height="459" width="800"]]
39 -
40 -
41 41  == 1.2 ​Features ==
42 42  
43 43  
... ... @@ -45,8 +45,8 @@
45 45  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
46 46  * Ultra-low power consumption
47 47  * Laser technology for distance detection
48 -* Measure Distance: 0.1m~~12m @ 90% Reflectivity
49 -* Accuracy :  ±5cm@(0.1-6m), ±1%@(6m-12m)
46 +* Measure Distance: 0.1m~~12m
47 +* Accuracy :  ±5cm@(0.1-5m), ±1%@(5m-12m)
50 50  * Monitor Battery Level
51 51  * Support Bluetooth v5.1 and LoRaWAN remote configure
52 52  * Support wireless OTA update firmware
... ... @@ -69,8 +69,8 @@
69 69  * Measure Distance:
70 70  ** 0.1m ~~ 12m @ 90% Reflectivity
71 71  ** 0.1m ~~ 4m @ 10% Reflectivity
72 -* Accuracy : ±5cm@(0.1-6m), ±1%@(6m-12m)
73 -* Distance resolution : 5mm
70 +* Accuracy : ±5cm@(0.1-5m), ±1%@(5m-12m)
71 +* Distance resolution : 1cm
74 74  * Ambient light immunity : 70klux
75 75  * Enclosure rating : IP65
76 76  * Light source : LED
... ... @@ -192,7 +192,7 @@
192 192  
193 193  The LPS8v2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
194 194  
195 -[[image:image-20230615153004-2.png||height="459" width="800"]](% style="display:none" %)
193 +[[image:image-20231110091447-3.png||height="383" width="752"]](% style="display:none" %)
196 196  
197 197  
198 198  (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from LDS12-LB.
... ... @@ -312,7 +312,7 @@
312 312  (((
313 313  LDS12-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LDS12-LB will:
314 314  
315 -periodically send this uplink every 20 minutes, this interval [[can be changed>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS12-LB_LoRaWAN_LiDAR_ToF_Distance_Sensor_User_Manual/#H3.3.1SetTransmitIntervalTime]].
313 +periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
316 316  
317 317  Uplink Payload totals 11 bytes.
318 318  )))
... ... @@ -379,18 +379,33 @@
379 379  Customers can judge whether they need to adjust the environment based on the signal strength.
380 380  
381 381  
380 +**1) When the sensor detects valid data:**
381 +
382 +[[image:image-20230805155335-1.png||height="145" width="724"]]
383 +
384 +
385 +**2) When the sensor detects invalid data:**
386 +
387 +[[image:image-20230805155428-2.png||height="139" width="726"]]
388 +
389 +
390 +**3) When the sensor is not connected:**
391 +
392 +[[image:image-20230805155515-3.png||height="143" width="725"]]
393 +
394 +
382 382  ==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====
383 383  
384 384  
385 385  This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H3.3.2SetInterruptMode"]] for the hardware and software set up.
386 386  
387 -Note: The Internet Pin is a separate pin in the screw terminal. See GPIO_EXTI of [[pin mapping>>||anchor="H1.8PinDefinitions"]].
400 +Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]] of GPIO_EXTI .
388 388  
389 389  **Example:**
390 390  
391 -0x00: Normal uplink packet.
404 +If byte[0]&0x01=0x00 : Normal uplink packet.
392 392  
393 -0x01: Interrupt Uplink Packet.
406 +If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
394 394  
395 395  
396 396  ==== (% style="color:blue" %)**LiDAR temp**(%%) ====
... ... @@ -416,19 +416,41 @@
416 416  
417 417  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
418 418  |=(% style="width: 161px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 164px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 174px;background-color:#4F81BD;color:white" %)**Payload**
419 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
420 -|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.ConfigureLDS12-LB"]]
432 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload
433 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload
421 421  
435 +[[image:image-20230805150315-4.png||height="233" width="723"]]
422 422  
423 -=== 2.3.3 Historical Water Flow Status, FPORT~=3 ===
424 424  
425 -LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/#H2.5DatalogFeature]].
438 +=== 2.3.3 Historical measuring distance, FPORT~=3 ===
426 426  
427 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status.
428 428  
441 +LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
429 429  
443 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
444 +
445 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
446 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
447 +**Size(bytes)**
448 +)))|=(% 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
449 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
450 +Reserve(0xFF)
451 +)))|Distance|Distance signal strength|(% style="width:88px" %)(((
452 +LiDAR temp
453 +)))|(% style="width:85px" %)Unix TimeStamp
454 +
455 +**Interrupt flag & Interrupt level:**
456 +
457 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
458 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
459 +**Size(bit)**
460 +)))|=(% 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**
461 +|(% 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" %)(((
462 +Interrupt flag
463 +)))
464 +
430 430  * (((
431 -Each data entry is 11 bytes and has the same structure as [[real time water flow status>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/#H2.3.3A0WaterFlowValue2CUplinkFPORT3D2]], to save airtime and battery, LDS12-LB will send max bytes according to the current DR and Frequency bands.
466 +Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, LDS12-LB will send max bytes according to the current DR and Frequency bands.
432 432  )))
433 433  
434 434  For example, in the US915 band, the max payload for different DR is:
... ... @@ -477,12 +477,12 @@
477 477  [362,173,30,Low,False,2023-08-04 02:58:53],
478 478  
479 479  
480 -History read from serial port：
515 +**History read from serial port：**
481 481  
482 482  [[image:image-20230805145056-3.png]]
483 483  
484 484  
485 -=== 2.3.3 Decode payload in The Things Network ===
520 +=== 2.3.4 Decode payload in The Things Network ===
486 486  
487 487  
488 488  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -784,9 +784,9 @@
784 784  === 3.3.2 Set Interrupt Mode ===
785 785  
786 786  
787 -Feature, Set Interrupt mode for PA8 of pin.
822 +Feature, Set Interrupt mode for pin of GPIO_EXTI.
788 788  
789 -When AT+INTMOD=0 is set, PA8 is used as a digital input port.
824 +When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
790 790  
791 791  (% style="color:blue" %)**AT Command: AT+INTMOD**
792 792  
... ... @@ -797,7 +797,11 @@
797 797  OK
798 798  the mode is 0 =Disable Interrupt
799 799  )))
800 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
835 +|(% style="width:154px" %)(((
836 +AT+INTMOD=2
837 +
838 +(default)
839 +)))|(% style="width:196px" %)(((
801 801  Set Transmit Interval
802 802  0. (Disable Interrupt),
803 803  ~1. (Trigger by rising and falling edge)
image-20230805150315-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +90.6 KB
Content
image-20230805155335-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +45.4 KB
Content
image-20230805155428-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +45.5 KB
Content
image-20230805155515-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +45.7 KB
Content
image-20231110085300-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +613.3 KB
Content
image-20231110085342-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +178.7 KB
Content
image-20231110091447-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +85.4 KB
Content
image-20231110091506-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +85.4 KB
Content