Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 106.1
edited by Saxer Lin
on 2023/08/05 16:14
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  )))
... ... @@ -399,7 +399,7 @@
399 399  
400 400  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.
401 401  
402 -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 .
403 403  
404 404  **Example:**
405 405  
... ... @@ -431,8 +431,8 @@
431 431  
432 432  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
433 433  |=(% 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**
434 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
435 -|(% 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
436 436  
437 437  [[image:image-20230805150315-4.png||height="233" width="723"]]
438 438  
... ... @@ -439,14 +439,15 @@
439 439  
440 440  === 2.3.3 Historical measuring distance, FPORT~=3 ===
441 441  
442 -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]].
443 443  
444 -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"]].
445 445  
443 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
444 +
446 446  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
447 447  |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
448 448  **Size(bytes)**
449 -)))|=(% 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
450 450  |(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
451 451  Reserve(0xFF)
452 452  )))|Distance|Distance signal strength|(% style="width:88px" %)(((
... ... @@ -455,16 +455,16 @@
455 455  
456 456  **Interrupt flag & Interrupt level:**
457 457  
458 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:501px" %)
457 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
459 459  |=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
460 460  **Size(bit)**
461 -)))|=(% 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**
462 462  |(% 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" %)(((
463 463  Interrupt flag
464 464  )))
465 465  
466 466  * (((
467 -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.
468 468  )))
469 469  
470 470  For example, in the US915 band, the max payload for different DR is:
... ... @@ -513,7 +513,7 @@
513 513  [362,173,30,Low,False,2023-08-04 02:58:53],
514 514  
515 515  
516 -History read from serial port：
515 +**History read from serial port：**
517 517  
518 518  [[image:image-20230805145056-3.png]]
519 519  
... ... @@ -820,9 +820,9 @@
820 820  === 3.3.2 Set Interrupt Mode ===
821 821  
822 822  
823 -Feature, Set Interrupt mode for PA8 of pin.
822 +Feature, Set Interrupt mode for pin of GPIO_EXTI.
824 824  
825 -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.
826 826  
827 827  (% style="color:blue" %)**AT Command: AT+INTMOD**
828 828  
... ... @@ -833,7 +833,11 @@
833 833  OK
834 834  the mode is 0 =Disable Interrupt
835 835  )))
836 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
835 +|(% style="width:154px" %)(((
836 +AT+INTMOD=2
837 +
838 +(default)
839 +)))|(% style="width:196px" %)(((
837 837  Set Transmit Interval
838 838  0. (Disable Interrupt),
839 839  ~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