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)
Details
- Page properties
-
- Content
-
... ... @@ -54,6 +54,8 @@ 54 54 * Downlink to change configure 55 55 * 8500mAh Battery for long term use 56 56 57 + 58 + 57 57 == 1.3 Specification == 58 58 59 59 ... ... @@ -99,6 +99,8 @@ 99 99 * Sleep Mode: 5uA @ 3.3v 100 100 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 101 101 104 + 105 + 102 102 == 1.4 Applications == 103 103 104 104 ... ... @@ -110,6 +110,8 @@ 110 110 * Automatic control 111 111 * Sewer 112 112 117 + 118 + 113 113 (% style="display:none" %) 114 114 115 115 == 1.5 Sleep mode and working mode == ... ... @@ -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**136 +|=(% 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. ... ... @@ -139,6 +139,8 @@ 139 139 ))) 140 140 |(% style="width:167px" %)Fast press ACT 5 times.|(% style="width:117px" %)Deactivate Device|(% style="width:225px" %)(% style="color:red" %)**Red led**(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode. 141 141 148 + 149 + 142 142 == 1.7 BLE connection == 143 143 144 144 ... ... @@ -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" %)(((259 +|=(% 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"]] 261 +)))|=(% 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** 262 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)((( 263 +[[Temperature DS18B20>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 264 +)))|[[Distance>>||anchor="H2.3.3Distance"]]|[[Distance signal strength>>||anchor="H2.3.4Distancesignalstrength"]]|((( 265 +[[Interrupt flag>>||anchor="H2.3.5InterruptPin"]] 266 +)))|[[LiDAR temp>>||anchor="H2.3.6LiDARtemp"]]|((( 267 +[[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**(%%)====273 +=== 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**(%%)====283 +=== 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**(%%)====296 +=== 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**(%%)====307 +=== 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**(%%)====320 +=== 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**(%%)====334 +=== 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**(%%)====344 +=== 2.3.7 Message Type === 405 405 406 406 407 407 ((( ... ... @@ -418,9 +418,10 @@ 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.3 Decode payload in The Things Network === 422 422 362 +=== 2.3.8 Decode payload in The Things Network === 423 423 364 + 424 424 While using TTN network, you can add the payload format to decode the payload. 425 425 426 426 [[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"]] ... ... @@ -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)**476 +|(% 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 ... ... @@ -619,6 +619,8 @@ 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 563 + 564 + 622 622 === 2.8.4 Reflectivity of different objects === 623 623 624 624 ... ... @@ -645,6 +645,8 @@ 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 591 + 592 + 648 648 = 3. Configure LDS12-LB = 649 649 650 650 == 3.1 Configure Methods == ... ... @@ -658,6 +658,8 @@ 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 606 + 607 + 661 661 == 3.2 General Commands == 662 662 663 663 ... ... @@ -757,33 +757,85 @@ 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 enablethepowerutput to externalsensor,709 +=== 3.3.3 Get Firmware Version Info === 765 765 766 -2. keep it on as per duration, read sensor value and construct uplink payload 767 767 768 - 3. final,close thepower output.712 +Feature: use downlink to get firmware version. 769 769 770 -(% style="color:blue" %)** ATCommand:AT+3V3T**714 +(% style="color:blue" %)**Downlink Command: 0x26** 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 716 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:492px" %) 717 +|(% 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)** 718 +|(% style="width:191px" %)Get Firmware Version Info|(% style="width:57px" %)Any|(% style="width:91px" %)26|(% style="width:151px" %)2 778 778 779 - (%style="color:blue"%)**Downlink Command: 0x07**(%%)780 - Format:CommandCode(0x07) followedby3bytes.720 +* Reply to the confirmation package: 26 01 721 +* Reply to non-confirmed packet: 26 00 781 781 782 - Thefirst byte is01,thesecond andthirdbytes arethetimetoturn on.723 +Device will send an uplink after got this downlink command. With below payload: 783 783 784 -* Example 1: Downlink Payload: 07 01 00 00 **~-~-->** AT+3V3T=0 785 -* Example 2: Downlink Payload: 07 01 01 F4 **~-~-->** AT+3V3T=500 725 +Configures info payload: 786 786 727 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 728 +|=(% style="background-color:#4F81BD;color:white" %)((( 729 +**Size(bytes)** 730 +)))|=(% 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** 731 +|**Value**|Software Type|((( 732 +Frequency Band 733 +)))|Sub-band|((( 734 +Firmware Version 735 +)))|Sensor Type|Reserve|((( 736 +[[Message Type>>||anchor="H2.3.7MessageType"]] 737 +Always 0x02 738 +))) 739 + 740 +(% style="color:#037691" %)**Software Type**(%%): Always 0x03 for LLDS12 741 + 742 +(% style="color:#037691" %)**Frequency Band**: 743 + 744 +0x01: EU868 745 + 746 +0x02: US915 747 + 748 +0x03: IN865 749 + 750 +0x04: AU915 751 + 752 +0x05: KZ865 753 + 754 +0x06: RU864 755 + 756 +0x07: AS923 757 + 758 +0x08: AS923-1 759 + 760 +0x09: AS923-2 761 + 762 +0xa0: AS923-3 763 + 764 + 765 +(% style="color:#037691" %)**Sub-Band**(%%): value 0x00 ~~ 0x08 766 + 767 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 768 + 769 +(% style="color:#037691" %)**Sensor Type**: 770 + 771 +0x01: LSE01 772 + 773 +0x02: LDDS75 774 + 775 +0x03: LDDS20 776 + 777 +0x04: LLMS01 778 + 779 +0x05: LSPH01 780 + 781 +0x06: LSNPK01 782 + 783 +0x07: LLDS12 784 + 785 + 787 787 = 4. Battery & Power Consumption = 788 788 789 789 ... ... @@ -812,6 +812,8 @@ 812 812 813 813 * 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]]**. 814 814 814 + 815 + 815 815 = 6. FAQ = 816 816 817 817 == 6.1 What is the frequency plan for LDS12-LB? == ... ... @@ -872,6 +872,8 @@ 872 872 873 873 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 874 874 876 + 877 + 875 875 = 9. Packing Info = 876 876 877 877 ... ... @@ -889,6 +889,8 @@ 889 889 890 890 * Weight / pcs : g 891 891 895 + 896 + 892 892 = 10. Support = 893 893 894 894