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 (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Saxer - Content
-
... ... @@ -54,6 +54,7 @@ 54 54 * Downlink to change configure 55 55 * 8500mAh Battery for long term use 56 56 57 + 57 57 == 1.3 Specification == 58 58 59 59 ... ... @@ -99,6 +99,7 @@ 99 99 * Sleep Mode: 5uA @ 3.3v 100 100 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 101 101 103 + 102 102 == 1.4 Applications == 103 103 104 104 ... ... @@ -110,6 +110,7 @@ 110 110 * Automatic control 111 111 * Sewer 112 112 115 + 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**133 +|=(% 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,7 @@ 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 145 + 142 142 == 1.7 BLE connection == 143 143 144 144 ... ... @@ -238,17 +238,17 @@ 238 238 239 239 == 2.3 Uplink Payload == 240 240 245 + 241 241 === 2.3.1 Device Status, FPORT~=5 === 242 242 243 - 244 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 245 246 246 The Payload format is as below. 247 247 248 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:5 10px" %)249 -|=(% style="width: 6 0px;background-color:#4F81BD;color:white" %)(((252 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:529px" %) 253 +|=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)((( 250 250 **Size(bytes)** 251 -)))|=(% style="width: 10 0px; 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**255 +)))|=(% style="width: 110px; background-color: rgb(79, 129, 189); color: white;" %)**1**|=(% style="width: 48px; background-color: rgb(79, 129, 189); color: white;" %)**2**|=(% style="background-color: rgb(79, 129, 189); color: white; width: 94px;" %)**1**|=(% style="background-color: rgb(79, 129, 189); color: white; width: 91px;" %)**1**|=(% style="background-color: rgb(79, 129, 189); color: white; width: 60px;" %)**2** 252 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 253 254 254 Example parse in TTNv3 ... ... @@ -304,9 +304,8 @@ 304 304 Ex2: 0x0B49 = 2889mV 305 305 306 306 307 -=== 2.3.2 UplinkPayload, FPORT~=2===311 +=== 2.3.2 Device Status, FPORT~=5 === 308 308 309 - 310 310 ((( 311 311 LDS12-LB will uplink payload via LoRaWAN with below payload format: 312 312 ))) ... ... @@ -315,22 +315,26 @@ 315 315 Uplink payload includes in total 11 bytes. 316 316 ))) 317 317 318 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width: 510px" %)319 -|=(% style="width: 6 0px;background-color:#4F81BD;color:white" %)(((321 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:670px" %) 322 +|=(% 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: #4F81BD;color:white; width: 70px;" %)**1**|=(% style="background-color: #4F81BD;color:white; 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"]] 324 +)))|=(% 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: rgb(79, 129, 189); color: white; width: 122px;" %)**1**|=(% style="background-color: rgb(79, 129, 189); color: white; width: 54px;" %)**1**|=(% style="background-color: rgb(79, 129, 189); color: white; width: 96px;" %)**1** 325 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)((( 326 +[[Temperature DS18B20>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 327 +)))|[[Distance>>||anchor="H2.3.3Distance"]]|[[Distance signal strength>>||anchor="H2.3.4Distancesignalstrength"]]|(% style="width:122px" %)((( 328 +[[Interrupt flag>>||anchor="H2.3.5InterruptPin"]] 329 + 330 +& 331 + 332 +[[Interrupt_level>>||anchor="H2.3.5InterruptPin"]] 333 +)))|(% style="width:54px" %)[[LiDAR temp>>||anchor="H2.3.6LiDARtemp"]]|(% style="width:96px" %)((( 334 +[[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**(%%)====340 +=== 2.3.2.a 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**(%%)====350 +=== 2.3.2.b 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**(%%)====363 +=== 2.3.2.c 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**(%%)====374 +=== 2.3.2.d 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**(%%)====387 +=== 2.3.2.e Interrupt Pin & Interrupt Level === 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**(%%)====401 +=== 2.3.2.f 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**(%%)====411 +=== 2.3.2.g 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 ===428 +=== 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)**542 +|(% 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,7 @@ 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 629 + 622 622 === 2.8.4 Reflectivity of different objects === 623 623 624 624 ... ... @@ -645,6 +645,7 @@ 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 656 + 648 648 = 3. Configure LDS12-LB = 649 649 650 650 == 3.1 Configure Methods == ... ... @@ -658,6 +658,7 @@ 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 670 + 661 661 == 3.2 General Commands == 662 662 663 663 ... ... @@ -757,33 +757,84 @@ 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 - Controltheoutputduration 3V3 . Before eachsampling,devicewill771 +=== 3.3.3 Get Firmware Version Info === 763 763 764 -~1. first enable the power output to external sensor, 765 765 766 - 2. keepitonasperduration,readsensorvalueand construct uplink payload774 +Feature: use downlink to get firmware version. 767 767 768 - 3.final,closethe poweroutput.776 +(% style="color:blue" %)**Downlink Command: 0x26** 769 769 770 -(% style="color:blue" %)**AT Command: AT+3V3T** 778 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:492px" %) 779 +|(% 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)** 780 +|(% style="width:191px" %)Get Firmware Version Info|(% style="width:57px" %)Any|(% style="width:91px" %)26|(% style="width:151px" %)2 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 782 +* Reply to the confirmation package: 26 01 783 +* Reply to non-confirmed packet: 26 00 778 778 779 -(% style="color:blue" %)**Downlink Command: 0x07**(%%) 780 -Format: Command Code (0x07) followed by 3 bytes. 785 +Device will send an uplink after got this downlink command. With below payload: 781 781 782 - Thefirst byteis01,the secondand third bytes are the time toturn on.787 +Configures info 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 789 +(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 790 +|=(% style="background-color:#4F81BD;color:white" %)((( 791 +**Size(bytes)** 792 +)))|=(% 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** 793 +|**Value**|Software Type|((( 794 +Frequency Band 795 +)))|Sub-band|((( 796 +Firmware Version 797 +)))|Sensor Type|Reserve|((( 798 +[[Message Type>>||anchor="H2.3.7MessageType"]] 799 +Always 0x02 800 +))) 786 786 802 +(% style="color:#037691" %)**Software Type**(%%): Always 0x03 for LLDS12 803 + 804 +(% style="color:#037691" %)**Frequency Band**: 805 + 806 +0x01: EU868 807 + 808 +0x02: US915 809 + 810 +0x03: IN865 811 + 812 +0x04: AU915 813 + 814 +0x05: KZ865 815 + 816 +0x06: RU864 817 + 818 +0x07: AS923 819 + 820 +0x08: AS923-1 821 + 822 +0x09: AS923-2 823 + 824 +0xa0: AS923-3 825 + 826 + 827 +(% style="color:#037691" %)**Sub-Band**(%%): value 0x00 ~~ 0x08 828 + 829 +(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 830 + 831 +(% style="color:#037691" %)**Sensor Type**: 832 + 833 +0x01: LSE01 834 + 835 +0x02: LDDS75 836 + 837 +0x03: LDDS20 838 + 839 +0x04: LLMS01 840 + 841 +0x05: LSPH01 842 + 843 +0x06: LSNPK01 844 + 845 +0x07: LLDS12 846 + 847 + 787 787 = 4. Battery & Power Consumption = 788 788 789 789 ... ... @@ -812,6 +812,7 @@ 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 876 + 815 815 = 6. FAQ = 816 816 817 817 == 6.1 What is the frequency plan for LDS12-LB? == ... ... @@ -872,6 +872,7 @@ 872 872 873 873 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 874 874 937 + 875 875 = 9. Packing Info = 876 876 877 877 ... ... @@ -889,6 +889,7 @@ 889 889 890 890 * Weight / pcs : g 891 891 955 + 892 892 = 10. Support = 893 893 894 894