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
-
... ... @@ -55,7 +55,6 @@ 55 55 * 8500mAh Battery for long term use 56 56 57 57 58 - 59 59 == 1.3 Specification == 60 60 61 61 ... ... @@ -102,7 +102,6 @@ 102 102 * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm 103 103 104 104 105 - 106 106 == 1.4 Applications == 107 107 108 108 ... ... @@ -115,7 +115,6 @@ 115 115 * Sewer 116 116 117 117 118 - 119 119 (% style="display:none" %) 120 120 121 121 == 1.5 Sleep mode and working mode == ... ... @@ -133,7 +133,7 @@ 133 133 134 134 135 135 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 136 -|=(% 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** 137 137 |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)((( 138 138 If sensor is already Joined to LoRaWAN network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once. 139 139 Meanwhile, BLE module will be active and user can connect via BLE to configure device. ... ... @@ -145,6 +145,7 @@ 145 145 ))) 146 146 |(% 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. 147 147 145 + 148 148 == 1.7 BLE connection == 149 149 150 150 ... ... @@ -244,26 +244,26 @@ 244 244 245 245 == 2.3 Uplink Payload == 246 246 245 + 247 247 === 2.3.1 Device Status, FPORT~=5 === 248 248 249 - 250 250 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. 251 251 252 252 The Payload format is as below. 253 253 254 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:5 10px" %)255 -|=(% 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" %)((( 256 256 **Size(bytes)** 257 -)))|=(% 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** 258 258 |(% 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 259 259 260 260 Example parse in TTNv3 261 261 262 - (% style="color:blue" %)**Sensor Model**(%%): For LDS12-LB, this value is 0x24260 +**Sensor Model**: For LDS12-LB, this value is 0x24 263 263 264 - (% style="color:blue" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version262 +**Firmware Version**: 0x0100, Means: v1.0.0 version 265 265 266 - (% style="color:blue" %)**Frequency Band**:264 +**Frequency Band**: 267 267 268 268 0x01: EU868 269 269 ... ... @@ -293,7 +293,7 @@ 293 293 294 294 0x0e: MA869 295 295 296 - (% style="color:blue" %)**Sub-Band**:294 +**Sub-Band**: 297 297 298 298 AU915 and US915:value 0x00 ~~ 0x08 299 299 ... ... @@ -301,7 +301,7 @@ 301 301 302 302 Other Bands: Always 0x00 303 303 304 - (% style="color:blue" %)**Battery Info**:302 +**Battery Info**: 305 305 306 306 Check the battery voltage. 307 307 ... ... @@ -310,9 +310,8 @@ 310 310 Ex2: 0x0B49 = 2889mV 311 311 312 312 313 -=== 2.3.2 UplinkPayload, FPORT~=2===311 +=== 2.3.2 Device Status, FPORT~=5 === 314 314 315 - 316 316 ((( 317 317 LDS12-LB will uplink payload via LoRaWAN with below payload format: 318 318 ))) ... ... @@ -321,22 +321,26 @@ 321 321 Uplink payload includes in total 11 bytes. 322 322 ))) 323 323 324 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width: 510px" %)325 -|=(% 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" %)((( 326 326 **Size(bytes)** 327 -)))|=(% 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** 328 -|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="HBatteryInfo"]]|(% style="width:62.5px" %)((( 329 -[[Temperature DS18B20>>||anchor="HDS18B20Temperaturesensor"]] 330 -)))|[[Distance>>||anchor="HDistance"]]|[[Distance signal strength>>||anchor="HDistancesignalstrength"]]|(% style="width:122px" %)((( 331 -[[Interrupt flag & Interrupt_level>>||anchor="HInterruptPin26A0InterruptLevel"]] 332 -)))|(% style="width:54px" %)[[LiDAR temp>>||anchor="HLiDARtemp"]]|(% style="width:96px" %)((( 333 -[[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"]] 334 334 ))) 335 335 336 336 [[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"]] 337 337 338 338 339 -=== =(%style="color:blue" %)**Battery Info**(%%)====340 +=== 2.3.2.a Battery Info === 340 340 341 341 342 342 Check the battery voltage for LDS12-LB. ... ... @@ -346,7 +346,7 @@ 346 346 Ex2: 0x0B49 = 2889mV 347 347 348 348 349 -=== =(% style="color:blue"%)**DS18B20 Temperature sensor**(%%)====350 +=== 2.3.2.b DS18B20 Temperature sensor === 350 350 351 351 352 352 This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. ... ... @@ -359,7 +359,7 @@ 359 359 If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 360 360 361 361 362 -=== =(% style="color:blue"%)**Distance**(%%)====363 +=== 2.3.2.c Distance === 363 363 364 364 365 365 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. ... ... @@ -370,7 +370,7 @@ 370 370 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. 371 371 372 372 373 -=== =(%style="color:blue" %)**Distance signal strength**(%%)====374 +=== 2.3.2.d Distance signal strength === 374 374 375 375 376 376 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. ... ... @@ -383,7 +383,7 @@ 383 383 Customers can judge whether they need to adjust the environment based on the signal strength. 384 384 385 385 386 -=== =(% style="color:blue"%)**Interrupt Pin & Interrupt Level**(%%)====387 +=== 2.3.2.e Interrupt Pin & Interrupt Level === 387 387 388 388 389 389 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. ... ... @@ -397,7 +397,7 @@ 397 397 0x01: Interrupt Uplink Packet. 398 398 399 399 400 -=== =(%style="color:blue" %)**LiDAR temp**(%%)====401 +=== 2.3.2.f LiDAR temp === 401 401 402 402 403 403 Characterize the internal temperature value of the sensor. ... ... @@ -407,7 +407,7 @@ 407 407 If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃. 408 408 409 409 410 -=== =(%style="color:blue" %)**Message Type**(%%)====411 +=== 2.3.2.g Message Type === 411 411 412 412 413 413 ((( ... ... @@ -423,9 +423,10 @@ 423 423 |(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]] 424 424 |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.ConfigureLDS12-LB"]] 425 425 426 -=== 2.3.3 Decode payload in The Things Network === 427 427 428 +=== 2.3.8 Decode payload in The Things Network === 428 428 430 + 429 429 While using TTN network, you can add the payload format to decode the payload. 430 430 431 431 [[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"]] ... ... @@ -537,7 +537,7 @@ 537 537 Users can poll sensor values based on timestamps. Below is the downlink command. 538 538 539 539 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:425.818px" %) 540 -|(% 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)** 541 541 |(% style="width:58px" %)**1byte**|(% style="width:127px" %)**4bytes**|(% style="width:124px" %)**4bytes**|(% style="width:114px" %)**1byte** 542 542 |(% style="width:58px" %)31|(% style="width:127px" %)Timestamp start|(% style="width:124px" %)Timestamp end|(% style="width:114px" %)Uplink Interval 543 543 ... ... @@ -624,6 +624,7 @@ 624 624 * The LiDAR probe is cover by dirty things; the reading might be wrong. In this case, need to clean the probe. 625 625 * The sensor window is made by Acrylic. Don't touch it with alcohol material. This will destroy the sensor window. 626 626 629 + 627 627 === 2.8.4 Reflectivity of different objects === 628 628 629 629 ... ... @@ -650,6 +650,7 @@ 650 650 |(% style="width:53px" %)17|(% style="width:229px" %)stainless steel|(% style="width:93px" %)200% 651 651 |(% style="width:53px" %)18|(% style="width:229px" %)Reflector plate, reflective tape|(% style="width:93px" %)>300% 652 652 656 + 653 653 = 3. Configure LDS12-LB = 654 654 655 655 == 3.1 Configure Methods == ... ... @@ -663,6 +663,7 @@ 663 663 664 664 * LoRaWAN Downlink. Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section. 665 665 670 + 666 666 == 3.2 General Commands == 667 667 668 668 ... ... @@ -762,33 +762,84 @@ 762 762 763 763 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 764 764 765 -=== 3.3.3 Set Power Output Duration === 766 766 767 - Controltheoutputduration 3V3 . Before eachsampling,devicewill771 +=== 3.3.3 Get Firmware Version Info === 768 768 769 -~1. first enable the power output to external sensor, 770 770 771 - 2. keepitonasperduration,readsensorvalueand construct uplink payload774 +Feature: use downlink to get firmware version. 772 772 773 - 3.final,closethe poweroutput.776 +(% style="color:blue" %)**Downlink Command: 0x26** 774 774 775 -(% 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 776 776 777 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 778 -|=(% 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** 779 -|(% style="width:154px" %)AT+3V3T=?|(% style="width:196px" %)Show 3V3 open time.|(% style="width:157px" %)0 (default) 780 -OK 781 -|(% style="width:154px" %)AT+3V3T=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK 782 -|(% 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 783 783 784 -(% style="color:blue" %)**Downlink Command: 0x07**(%%) 785 -Format: Command Code (0x07) followed by 3 bytes. 785 +Device will send an uplink after got this downlink command. With below payload: 786 786 787 - Thefirst byteis01,the secondand third bytes are the time toturn on.787 +Configures info payload: 788 788 789 -* Example 1: Downlink Payload: 07 01 00 00 **~-~-->** AT+3V3T=0 790 -* 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 +))) 791 791 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 + 792 792 = 4. Battery & Power Consumption = 793 793 794 794 ... ... @@ -817,6 +817,7 @@ 817 817 818 818 * 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]]**. 819 819 876 + 820 820 = 6. FAQ = 821 821 822 822 == 6.1 What is the frequency plan for LDS12-LB? == ... ... @@ -877,6 +877,7 @@ 877 877 878 878 * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band 879 879 937 + 880 880 = 9. Packing Info = 881 881 882 882 ... ... @@ -894,6 +894,7 @@ 894 894 895 895 * Weight / pcs : g 896 896 955 + 897 897 = 10. Support = 898 898 899 899