Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01
Last modified by Mengting Qiu on 2023/12/14 11:15
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 2 removed)
Details
- Page properties
-
- Content
-
... ... @@ -35,7 +35,7 @@ 35 35 36 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-2023061 5152941-1.png||height="459" width="800"]]38 +[[image:image-20230614162334-2.png||height="468" width="800"]] 39 39 40 40 41 41 == 1.2 Features == ... ... @@ -127,7 +127,7 @@ 127 127 128 128 129 129 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 130 -|=(% style="width: 167px;background-color:# 4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 225px;background-color:#4F81BD;color:white" %)**Action**130 +|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action** 131 131 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 132 132 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 133 133 Meanwhile, BLE module will be active and user can connect via BLE to configure device. ... ... @@ -158,6 +158,7 @@ 158 158 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/WL03A-LB_LoRaWAN_None-Position_Rope_Type_Water_Leak_Controller_User_Manual/WebHome/image-20230613144156-1.png?rev=1.1||alt="image-20230613144156-1.png"]] 159 159 160 160 161 + 161 161 == 1.9 Mechanical == 162 162 163 163 ... ... @@ -173,6 +173,7 @@ 173 173 (% style="color:blue" %)**Probe Mechanical:** 174 174 175 175 177 + 176 176 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654827224480-952.png?rev=1.1||alt="1654827224480-952.png"]] 177 177 178 178 ... ... @@ -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-2023061 5153004-2.png||height="459" width="800"]](% style="display:none" %)197 +[[image:image-20230614162359-3.png||height="468" width="800"]](% 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. ... ... @@ -238,75 +238,7 @@ 238 238 239 239 == 2.3 Uplink Payload == 240 240 241 -=== 2.3.1 Device Status, FPORT~=5 === 242 242 243 - 244 -Users can use the downlink command(**0x26 01**) to ask LDS12-LB to send device configure detail, include device configure status. LDS12-LB will uplink a payload via FPort=5 to server. 245 - 246 -The Payload format is as below. 247 - 248 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 249 -|=(% style="width: 60px;background-color:#4F81BD;color:white" %)((( 250 -**Size(bytes)** 251 -)))|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**1**|=(% style="width: 100px; background-color: #4F81BD;color:white;" %)**2**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 100px;" %)**1**|=(% style="background-color: #4F81BD;color:white; width: 50px;" %)**2** 252 -|(% style="width:62.5px" %)Value|(% style="width:110px" %)Sensor Model|(% style="width:48px" %)Firmware Version|(% style="width:94px" %)Frequency Band|(% style="width:91px" %)Sub-band|(% style="width:60px" %)BAT 253 - 254 -Example parse in TTNv3 255 - 256 -**Sensor Model**: For LDS12-LB, this value is 0x24 257 - 258 -**Firmware Version**: 0x0100, Means: v1.0.0 version 259 - 260 -**Frequency Band**: 261 - 262 -0x01: EU868 263 - 264 -0x02: US915 265 - 266 -0x03: IN865 267 - 268 -0x04: AU915 269 - 270 -0x05: KZ865 271 - 272 -0x06: RU864 273 - 274 -0x07: AS923 275 - 276 -0x08: AS923-1 277 - 278 -0x09: AS923-2 279 - 280 -0x0a: AS923-3 281 - 282 -0x0b: CN470 283 - 284 -0x0c: EU433 285 - 286 -0x0d: KR920 287 - 288 -0x0e: MA869 289 - 290 -**Sub-Band**: 291 - 292 -AU915 and US915:value 0x00 ~~ 0x08 293 - 294 -CN470: value 0x0B ~~ 0x0C 295 - 296 -Other Bands: Always 0x00 297 - 298 -**Battery Info**: 299 - 300 -Check the battery voltage. 301 - 302 -Ex1: 0x0B45 = 2885mV 303 - 304 -Ex2: 0x0B49 = 2889mV 305 - 306 - 307 -=== 2.3.2 Uplink Payload, FPORT~=2 === 308 - 309 - 310 310 ((( 311 311 LDS12-LB will uplink payload via LoRaWAN with below payload format: 312 312 ))) ... ... @@ -316,21 +316,21 @@ 316 316 ))) 317 317 318 318 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 319 -|=(% style="width: 6 0px;background-color:#4F81BD;color:white" %)(((253 +|=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)((( 320 320 **Size(bytes)** 321 -)))|=(% style="width: 30px;background-color:#4F81BD;color:white" %)**2**|=(% style="width:80px;background-color:#4F81BD;color:white" %)**2**|=(% 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: 80px;" %)**1**|=(% style="background-color:; width: 70px;" %)**1**|=(% style="background-color:; width: 70px;" %)**1**322 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)((( 323 -[[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]] 324 -)))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|( % style="width:122px" %)(((325 -[[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]]326 -)))| (% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)(((327 -[[Message Type>>||anchor="HMessageType"]] 255 +)))|=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)**2**|=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)**2**|=(% style="background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**1** 256 +|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)((( 257 +[[Temperature DS18B20>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 258 +)))|[[Distance>>||anchor="H2.3.3Distance"]]|[[Distance signal strength>>||anchor="H2.3.4Distancesignalstrength"]]|((( 259 +[[Interrupt flag>>||anchor="H2.3.5InterruptPin"]] 260 +)))|[[LiDAR temp>>||anchor="H2.3.6LiDARtemp"]]|((( 261 +[[Message Type>>||anchor="H2.3.7MessageType"]] 328 328 ))) 329 329 330 330 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654833689380-972.png?rev=1.1||alt="1654833689380-972.png"]] 331 331 332 332 333 -=== =(%style="color:blue" %)**Battery Info**(%%)====267 +=== 2.3.1 Battery Info === 334 334 335 335 336 336 Check the battery voltage for LDS12-LB. ... ... @@ -340,7 +340,7 @@ 340 340 Ex2: 0x0B49 = 2889mV 341 341 342 342 343 -=== =(%style="color:blue" %)**DS18B20 Temperature sensor**(%%)====277 +=== 2.3.2 DS18B20 Temperature sensor === 344 344 345 345 346 346 This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. ... ... @@ -353,7 +353,7 @@ 353 353 If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 354 354 355 355 356 -=== =(%style="color:blue" %)**Distance**(%%)====290 +=== 2.3.3 Distance === 357 357 358 358 359 359 Represents the distance value of the measurement output, the default unit is cm, and the value range parsed as a decimal number is 0-1200. In actual use, when the signal strength value Strength. ... ... @@ -364,7 +364,7 @@ 364 364 If the data you get from the register is 0x0B 0xEA, the distance between the sensor and the measured object is 0BEA(H) = 3050 (D)/10 = 305cm. 365 365 366 366 367 -=== =(%style="color:blue" %)**Distance signal strength**(%%)====301 +=== 2.3.4 Distance signal strength === 368 368 369 369 370 370 Refers to the signal strength, the default output value will be between 0-65535. When the distance measurement gear is fixed, the farther the distance measurement is, the lower the signal strength; the lower the target reflectivity, the lower the signal strength. When Strength is greater than 100 and not equal to 65535, the measured value of Dist is considered credible. ... ... @@ -377,7 +377,7 @@ 377 377 Customers can judge whether they need to adjust the environment based on the signal strength. 378 378 379 379 380 -=== =(%style="color:blue" %)**Interrupt Pin& Interrupt Level**(%%)====314 +=== 2.3.5 Interrupt Pin === 381 381 382 382 383 383 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. ... ... @@ -391,7 +391,7 @@ 391 391 0x01: Interrupt Uplink Packet. 392 392 393 393 394 -=== =(%style="color:blue" %)**LiDAR temp**(%%)====328 +=== 2.3.6 LiDAR temp === 395 395 396 396 397 397 Characterize the internal temperature value of the sensor. ... ... @@ -401,7 +401,7 @@ 401 401 If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃. 402 402 403 403 404 -=== =(%style="color:blue" %)**Message Type**(%%)====338 +=== 2.3.7 Message Type === 405 405 406 406 407 407 ((( ... ... @@ -418,7 +418,7 @@ 418 418 |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.ConfigureLDS12-LB"]] 419 419 420 420 421 -=== 2.3. 3Decode payload in The Things Network ===355 +=== 2.3.8 Decode payload in The Things Network === 422 422 423 423 424 424 While using TTN network, you can add the payload format to decode the payload. ... ... @@ -532,7 +532,7 @@ 532 532 Users can poll sensor values based on timestamps. Below is the downlink command. 533 533 534 534 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %) 535 -|(% colspan="4" style="background-color:# 4f81bd; color:white; width:423px" %)**Downlink Command to poll Open/Close status (0x31)**469 +|(% colspan="4" style="background-color:#d9e2f3; color:#0070c0; width:423px" %)**Downlink Command to poll Open/Close status (0x31)** 536 536 |(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte** 537 537 |(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval 538 538 ... ... @@ -596,8 +596,10 @@ 596 596 Vertical Coordinates: Represents the radius of light spot for The LiDAR probe at different distances. The diameter of light spot depends on the FOV of The LiDAR probe (the term of FOV generally refers to the smaller value between the receiving angle and the transmitting angle), which is calculated as follows: 597 597 ))) 598 598 533 + 599 599 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654831797521-720.png?rev=1.1||alt="1654831797521-720.png"]] 600 600 536 + 601 601 ((( 602 602 In the formula above, d is the diameter of light spot; D is detecting range; β is the value of the receiving angle of The LiDAR probe, 3.6°. Correspondence between the diameter of light spot and detecting range is given in Table below. 603 603 ))) ... ... @@ -619,6 +619,9 @@ 619 619 * The LiDAR probe is cover by dirty things; the reading might be wrong. In this case, need to clean the probe. 620 620 * The sensor window is made by Acrylic. Don't touch it with alcohol material. This will destroy the sensor window. 621 621 558 + 559 + 560 + 622 622 === 2.8.4 Reflectivity of different objects === 623 623 624 624 ... ... @@ -645,6 +645,9 @@ 645 645 |(% style="width:53px" %)17|(% style="width:229px" %)stainless steel|(% style="width:93px" %)200% 646 646 |(% style="width:53px" %)18|(% style="width:229px" %)Reflector plate, reflective tape|(% style="width:93px" %)>300% 647 647 587 + 588 + 589 + 648 648 = 3. Configure LDS12-LB = 649 649 650 650 == 3.1 Configure Methods == ... ... @@ -658,6 +658,9 @@ 658 658 659 659 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 660 660 603 + 604 + 605 + 661 661 == 3.2 General Commands == 662 662 663 663 ... ... @@ -718,9 +718,6 @@ 718 718 ))) 719 719 * ((( 720 720 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 721 - 722 - 723 - 724 724 ))) 725 725 726 726 === 3.3.2 Set Interrupt Mode === ... ... @@ -757,33 +757,87 @@ 757 757 758 758 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 759 759 760 -=== 3.3.3 Set Power Output Duration === 761 761 762 -Control the output duration 3V3 . Before each sampling, device will 763 763 764 -~1. first enable the power output to external sensor, 765 765 766 -2. keep it on as per duration, read sensor value and construct uplink payload 767 767 768 -3. final, closethepower output.706 +=== 3.3.3 Get Firmware Version Info === 769 769 770 -(% style="color:blue" %)**AT Command: AT+3V3T** 771 771 772 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 773 -|=(% style="width: 155px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 197px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width: 158px;background-color:#4F81BD;color:white" %)**Response** 774 -|(% style="width:154px" %)AT+3V3T=?|(% style="width:196px" %)Show 3V3 open time.|(% style="width:157px" %)0 (default) 775 -OK 776 -|(% style="width:154px" %)AT+3V3T=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 777 -|(% style="width:154px" %)AT+3V3T=0|(% style="width:196px" %)Always turn on the power supply of 3V3 pin.|(% style="width:157px" %)OK 709 +Feature: use downlink to get firmware version. 778 778 779 -(% style="color:blue" %)**Downlink Command: 0x07**(%%) 780 -Format: Command Code (0x07) followed by 3 bytes. 711 +(% style="color:blue" %)**Downlink Command: 0x26** 781 781 782 -The first byte is 01,the second and third bytes are the time to turn on. 713 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:492px" %) 714 +|(% style="background-color:#4F81BD;color:white; width:191px" %)**Downlink Control Type**|(% style="background-color:#4F81BD;color:white; width:57px" %)**FPort**|(% style="background-color:#4F81BD;color:white; width:91px" %)**Type Code**|(% style="background-color:#4F81BD;color:white; width:153px" %)**Downlink payload size(bytes)** 715 +|(% style="width:191px" %)Get Firmware Version Info|(% style="width:57px" %)Any|(% style="width:91px" %)26|(% style="width:151px" %)2 783 783 784 -* Example1:DownlinkPayload:070100 00 **~-~-->** AT+3V3T=0785 -* Example2:DownlinkPayload:070101 F4 **~-~-->** AT+3V3T=500717 +* Reply to the confirmation package: 26 01 718 +* Reply to non-confirmed packet: 26 00 786 786 720 +Device will send an uplink after got this downlink command. With below payload: 721 + 722 +Configures info payload: 723 + 724 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 725 +|=(% style="background-color:#4F81BD;color:white" %)((( 726 +**Size(bytes)** 727 +)))|=(% style="background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**1**|=(% style="background-color:#4F81BD;color:white" %)**5**|=(% style="background-color:#4F81BD;color:white" %)**1** 728 +|**Value**|Software Type|((( 729 +Frequency Band 730 +)))|Sub-band|((( 731 +Firmware Version 732 +)))|Sensor Type|Reserve|((( 733 +[[Message Type>>||anchor="H2.3.7MessageType"]] 734 +Always 0x02 735 +))) 736 + 737 +(% style="color:#037691" %)**Software Type**(%%): Always 0x03 for LLDS12 738 + 739 +(% style="color:#037691" %)**Frequency Band**: 740 + 741 +*0x01: EU868 742 + 743 +*0x02: US915 744 + 745 +*0x03: IN865 746 + 747 +*0x04: AU915 748 + 749 +*0x05: KZ865 750 + 751 +*0x06: RU864 752 + 753 +*0x07: AS923 754 + 755 +*0x08: AS923-1 756 + 757 +*0x09: AS923-2 758 + 759 +*0xa0: AS923-3 760 + 761 + 762 +(% style="color:#037691" %)**Sub-Band**(%%): value 0x00 ~~ 0x08 763 + 764 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 765 + 766 +(% style="color:#037691" %)**Sensor Type**: 767 + 768 +0x01: LSE01 769 + 770 +0x02: LDDS75 771 + 772 +0x03: LDDS20 773 + 774 +0x04: LLMS01 775 + 776 +0x05: LSPH01 777 + 778 +0x06: LSNPK01 779 + 780 +0x07: LLDS12 781 + 782 + 787 787 = 4. Battery & Power Consumption = 788 788 789 789 ... ... @@ -832,11 +832,11 @@ 832 832 833 833 834 834 ((( 835 -(% style="color:blue" %)**Cause ①**(%%)**:**Due to the physical principles of The LiDAR probe, the above phenomenon is likely to occur if the detection object is the material with high reflectivity (such as mirror, smooth floor tile, etc.) or transparent substance .(such as glass and water, etc.)831 +(% style="color:blue" %)**Cause ①**(%%)**:**Due to the physical principles of The LiDAR probe, the above phenomenon is likely to occur if the detection object is the material with high reflectivity (such as mirror, smooth floor tile, etc.) or transparent substance (such as glass and water, etc.) 836 836 ))) 837 837 838 838 ((( 839 - (% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice.835 +Troubleshooting: Please avoid use of this product under such circumstance in practice. 840 840 ))) 841 841 842 842 ... ... @@ -845,7 +845,7 @@ 845 845 ))) 846 846 847 847 ((( 848 - (% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter.844 +Troubleshooting: please use dry dust-free cloth to gently remove the foreign matter. 849 849 ))) 850 850 851 851
- image-20230615152941-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -87.9 KB - Content
- image-20230615153004-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -87.9 KB - Content