Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 103.1
edited by Saxer Lin
on 2023/08/05 15:55
Change comment: Uploaded new attachment "image-20230805155515-3.png", version {1}
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,8 +416,8 @@
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  
422 422  [[image:image-20230805150315-4.png||height="233" width="723"]]
423 423  
... ... @@ -424,14 +424,15 @@
424 424  
425 425  === 2.3.3 Historical measuring distance, FPORT~=3 ===
426 426  
427 -LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS12-LB_LoRaWAN_LiDAR_ToF_Distance_Sensor_User_Manual/#H2.5.4Pollsensorvalue]].
428 428  
429 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status.
441 +LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
430 430  
443 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
444 +
431 431  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
432 432  |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
433 433  **Size(bytes)**
434 -)))|=(% style="width: 30px;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: rgb(79, 129, 189); color: white; width: 88px;" %)**1**|=(% style="background-color: rgb(79, 129, 189); color: white; width: 85px;" %)4
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
435 435  |(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
436 436  Reserve(0xFF)
437 437  )))|Distance|Distance signal strength|(% style="width:88px" %)(((
... ... @@ -440,16 +440,16 @@
440 440  
441 441  **Interrupt flag & Interrupt level:**
442 442  
443 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:501px" %)
457 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
444 444  |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
445 445  **Size(bit)**
446 -)))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**bit7**|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**bit6**|=(% style="width: 50px;background-color:#4F81BD;color:white" %)**[bit5:bit2]**|=(% style="width: 91px; background-color: rgb(79, 129, 189); color: white;" %)**bit1**|=(% style="background-color: rgb(79, 129, 189); color: white; width: 88px;" %)**bit0**
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**
447 447  |(% 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" %)(((
448 448  Interrupt flag
449 449  )))
450 450  
451 451  * (((
452 -Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS12-LB_LoRaWAN_LiDAR_ToF_Distance_Sensor_User_Manual/#H2.3.2UplinkPayload2CFPORT3D2]], 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.
453 453  )))
454 454  
455 455  For example, in the US915 band, the max payload for different DR is:
... ... @@ -498,7 +498,7 @@
498 498  [362,173,30,Low,False,2023-08-04 02:58:53],
499 499  
500 500  
501 -History read from serial port：
515 +**History read from serial port：**
502 502  
503 503  [[image:image-20230805145056-3.png]]
504 504  
... ... @@ -805,9 +805,9 @@
805 805  === 3.3.2 Set Interrupt Mode ===
806 806  
807 807  
808 -Feature, Set Interrupt mode for PA8 of pin.
822 +Feature, Set Interrupt mode for pin of GPIO_EXTI.
809 809  
810 -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.
811 811  
812 812  (% style="color:blue" %)**AT Command: AT+INTMOD**
813 813  
... ... @@ -818,7 +818,11 @@
818 818  OK
819 819  the mode is 0 =Disable Interrupt
820 820  )))
821 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
835 +|(% style="width:154px" %)(((
836 +AT+INTMOD=2
837 +
838 +(default)
839 +)))|(% style="width:196px" %)(((
822 822  Set Transmit Interval
823 823  0. (Disable Interrupt),
824 824  ~1. (Trigger by rising and falling edge)
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