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)
-
Attachments (0 modified, 2 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Saxer - 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 4162334-2.png||height="468" width="800"]]38 +[[image:image-20230615152941-1.png||height="459" width="800"]] 39 39 40 40 41 41 == 1.2 Features == ... ... @@ -158,7 +158,6 @@ 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 - 162 162 == 1.9 Mechanical == 163 163 164 164 ... ... @@ -174,7 +174,6 @@ 174 174 (% style="color:blue" %)**Probe Mechanical:** 175 175 176 176 177 - 178 178 [[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"]] 179 179 180 180 ... ... @@ -194,7 +194,7 @@ 194 194 195 195 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. 196 196 197 -[[image:image-2023061 4162359-3.png||height="468" width="800"]](% style="display:none" %)195 +[[image:image-20230615153004-2.png||height="459" width="800"]](% style="display:none" %) 198 198 199 199 200 200 (% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from LDS12-LB. ... ... @@ -241,6 +241,73 @@ 241 241 == 2.3 Uplink Payload == 242 242 243 243 242 +=== 2.3.1 Device Status, FPORT~=5 === 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:529px" %) 249 +|=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)((( 250 +**Size(bytes)** 251 +)))|=(% 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 +|(% 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 Device Status, FPORT~=5 === 308 + 244 244 ((( 245 245 LDS12-LB will uplink payload via LoRaWAN with below payload format: 246 246 ))) ... ... @@ -249,16 +249,19 @@ 249 249 Uplink payload includes in total 11 bytes. 250 250 ))) 251 251 252 - 253 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 317 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:670px" %) 254 254 |=(% style="width: 62.5px;background-color:#4F81BD;color:white" %)((( 255 255 **Size(bytes)** 256 -)))|=(% 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**257 -|(% style="width:62.5px" %) **Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)(((320 +)))|=(% 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** 321 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1BatteryInfo"]]|(% style="width:62.5px" %)((( 258 258 [[Temperature DS18B20>>||anchor="H2.3.2DS18B20Temperaturesensor"]] 259 -)))|[[Distance>>||anchor="H2.3.3Distance"]]|[[Distance signal strength>>||anchor="H2.3.4Distancesignalstrength"]]|((( 323 +)))|[[Distance>>||anchor="H2.3.3Distance"]]|[[Distance signal strength>>||anchor="H2.3.4Distancesignalstrength"]]|(% style="width:122px" %)((( 260 260 [[Interrupt flag>>||anchor="H2.3.5InterruptPin"]] 261 -)))|[[LiDAR temp>>||anchor="H2.3.6LiDARtemp"]]|((( 325 + 326 +& 327 + 328 +[[Interrupt_level>>||anchor="H2.3.5InterruptPin"]] 329 +)))|(% style="width:54px" %)[[LiDAR temp>>||anchor="H2.3.6LiDARtemp"]]|(% style="width:96px" %)((( 262 262 [[Message Type>>||anchor="H2.3.7MessageType"]] 263 263 ))) 264 264 ... ... @@ -265,7 +265,7 @@ 265 265 [[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"]] 266 266 267 267 268 -=== 2.3. 1Battery Info ===336 +==== 2.3.2.a Battery Info ==== 269 269 270 270 271 271 Check the battery voltage for LDS12-LB. ... ... @@ -275,7 +275,7 @@ 275 275 Ex2: 0x0B49 = 2889mV 276 276 277 277 278 -=== 2.3.2 DS18B20 Temperature sensor === 346 +==== 2.3.2.b DS18B20 Temperature sensor ==== 279 279 280 280 281 281 This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature. ... ... @@ -288,7 +288,7 @@ 288 288 If payload is: FF3FH : (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees. 289 289 290 290 291 -=== 2.3. 3Distance ===359 +==== 2.3.2.c Distance ==== 292 292 293 293 294 294 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. ... ... @@ -299,7 +299,7 @@ 299 299 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. 300 300 301 301 302 -=== 2.3. 4Distance signal strength ===370 +==== 2.3.2.d Distance signal strength ==== 303 303 304 304 305 305 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. ... ... @@ -312,7 +312,7 @@ 312 312 Customers can judge whether they need to adjust the environment based on the signal strength. 313 313 314 314 315 -=== 2.3. 5Interrupt Pin ===383 +==== 2.3.2.e Interrupt Pin & Interrupt Level ==== 316 316 317 317 318 318 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. ... ... @@ -326,7 +326,7 @@ 326 326 0x01: Interrupt Uplink Packet. 327 327 328 328 329 -=== 2.3. 6LiDAR temp ===397 +==== 2.3.2.f LiDAR temp ==== 330 330 331 331 332 332 Characterize the internal temperature value of the sensor. ... ... @@ -336,7 +336,7 @@ 336 336 If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃. 337 337 338 338 339 -=== 2.3. 7Message Type ===407 +==== 2.3.2.g Message Type ==== 340 340 341 341 342 342 ((( ... ... @@ -352,8 +352,6 @@ 352 352 |(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]] 353 353 |(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.ConfigureLDS12-LB"]] 354 354 355 - 356 - 357 357 === 2.3.8 Decode payload in The Things Network === 358 358 359 359 ... ... @@ -504,16 +504,15 @@ 504 504 505 505 The LiDAR probe is based on TOF, namely, Time of Flight principle. To be specific, the product emits modulation wave of near infrared ray on a periodic basis, which will be reflected after contacting object. The product obtains the time of flight by measuring round-trip phase difference and then calculates relative range between the product and the detection object, as shown below. 506 506 573 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654831757579-263.png?rev=1.1||alt="1654831757579-263.png"]] 507 507 508 -[[image:1654831757579-263.png]] 509 509 510 - 511 511 === 2.8.2 Distance Measurement Characteristics === 512 512 513 513 514 514 With optimization of light path and algorithm, The LiDAR probe has minimized influence from external environment on distance measurement performance. Despite that, the range of distance measurement may still be affected by the environment illumination intensity and the reflectivity of detection object. As shown in below: 515 515 516 -[[image:1654831774373-275.png]] 581 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654831774373-275.png?rev=1.1||alt="1654831774373-275.png"]] 517 517 518 518 519 519 ((( ... ... @@ -533,23 +533,20 @@ 533 533 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: 534 534 ))) 535 535 601 +[[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"]] 536 536 537 -[[image:1654831797521-720.png]] 538 - 539 - 540 540 ((( 541 541 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. 542 542 ))) 543 543 544 -[[image:1654831810009-716.png]] 607 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LLDS12-LoRaWAN%20LiDAR%20ToF%20Distance%20Sensor%20User%20Manual/WebHome/1654831810009-716.png?rev=1.1||alt="1654831810009-716.png"]] 545 545 546 - 547 547 ((( 548 548 If the light spot reaches two objects with different distances, as shown in Figure 3, the output distance value will be a value between the actual distance values of the two objects. For a high accuracy requirement in practice, the above situation should be noticed to avoid the measurement error. 549 549 ))) 550 550 551 551 552 -=== 2.8.3 Notice of usage :===614 +=== 2.8.3 Notice of usage === 553 553 554 554 555 555 Possible invalid /wrong reading for LiDAR ToF tech: ... ... @@ -563,7 +563,7 @@ 563 563 564 564 565 565 (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:379px" %) 566 -|=(% style="width: 54px;background-color:# D9E2F3;color:#0070C0" %)Item|=(% style="width: 231px;background-color:#D9E2F3;color:#0070C0" %)Material|=(% style="width: 94px;background-color:#D9E2F3;color:#0070C0" %)Relectivity628 +|=(% style="width: 54px;background-color:#4F81BD;color:white" %)Item|=(% style="width: 231px;background-color:#4F81BD;color:white" %)Material|=(% style="width: 94px;background-color:#4F81BD;color:white" %)Relectivity 567 567 |(% style="width:53px" %)1|(% style="width:229px" %)Black foam rubber|(% style="width:93px" %)2.4% 568 568 |(% style="width:53px" %)2|(% style="width:229px" %)Black fabric|(% style="width:93px" %)3% 569 569 |(% style="width:53px" %)3|(% style="width:229px" %)Black rubber|(% style="width:93px" %)4% ... ... @@ -630,7 +630,7 @@ 630 630 ))) 631 631 632 632 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 633 -|=(% style="width: 156px;background-color:# D9E2F3;#0070c0" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3;#0070c0" %)**Function**|=(% style="background-color:#D9E2F3;#0070c0" %)**Response**695 +|=(% style="width: 156px;background-color:#4F81BD;color:white" %)**Command Example**|=(% style="width: 137px;background-color:#4F81BD;color:white" %)**Function**|=(% style="background-color:#4F81BD;color:white" %)**Response** 634 634 |(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|((( 635 635 30000 636 636 OK ... ... @@ -658,6 +658,9 @@ 658 658 ))) 659 659 * ((( 660 660 Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds 723 + 724 + 725 + 661 661 ))) 662 662 663 663 === 3.3.2 Set Interrupt Mode === ... ... @@ -670,7 +670,7 @@ 670 670 (% style="color:blue" %)**AT Command: AT+INTMOD** 671 671 672 672 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 673 -|=(% style="width: 155px;background-color:# D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response**738 +|=(% 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** 674 674 |(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)((( 675 675 0 676 676 OK ... ... @@ -695,85 +695,6 @@ 695 695 * Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger 696 696 697 697 698 -=== 3.3.3 Get Firmware Version Info === 699 - 700 - 701 -Feature: use downlink to get firmware version. 702 - 703 -(% style="color:#037691" %)**Downlink Command: 0x26** 704 - 705 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:492px" %) 706 -|(% style="background-color:#d9e2f3; color:#0070c0; width:191px" %)**Downlink Control Type**|(% style="background-color:#d9e2f3; color:#0070c0; width:57px" %)**FPort**|(% style="background-color:#d9e2f3; color:#0070c0; width:91px" %)**Type Code**|(% style="background-color:#d9e2f3; color:#0070c0; width:153px" %)**Downlink payload size(bytes)** 707 -|(% style="width:191px" %)Get Firmware Version Info|(% style="width:57px" %)Any|(% style="width:91px" %)26|(% style="width:151px" %)2 708 - 709 -* Reply to the confirmation package: 26 01 710 -* Reply to non-confirmed packet: 26 00 711 - 712 -Device will send an uplink after got this downlink command. With below payload: 713 - 714 -Configures info payload: 715 - 716 -(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %) 717 -|=(% style="background-color:#D9E2F3;color:#0070C0" %)((( 718 -**Size(bytes)** 719 -)))|=(% style="background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**5**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**1** 720 -|**Value**|Software Type|((( 721 -Frequency 722 -Band 723 -)))|Sub-band|((( 724 -Firmware 725 -Version 726 -)))|Sensor Type|Reserve|((( 727 -[[Message Type>>||anchor="H2.3.7A0MessageType"]] 728 -Always 0x02 729 -))) 730 - 731 -(% style="color:#037691" %)**Software Type**(%%): Always 0x03 for LLDS12 732 - 733 -(% style="color:#037691" %)**Frequency Band**: 734 - 735 -*0x01: EU868 736 - 737 -*0x02: US915 738 - 739 -*0x03: IN865 740 - 741 -*0x04: AU915 742 - 743 -*0x05: KZ865 744 - 745 -*0x06: RU864 746 - 747 -*0x07: AS923 748 - 749 -*0x08: AS923-1 750 - 751 -*0x09: AS923-2 752 - 753 -*0xa0: AS923-3 754 - 755 - 756 -(% style="color:#037691" %)**Sub-Band**(%%): value 0x00 ~~ 0x08 757 - 758 -(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version 759 - 760 -(% style="color:#037691" %)**Sensor Type**: 761 - 762 -0x01: LSE01 763 - 764 -0x02: LDDS75 765 - 766 -0x03: LDDS20 767 - 768 -0x04: LLMS01 769 - 770 -0x05: LSPH01 771 - 772 -0x06: LSNPK01 773 - 774 -0x07: LLDS12 775 - 776 - 777 777 = 4. Battery & Power Consumption = 778 778 779 779 ... ... @@ -794,7 +794,7 @@ 794 794 795 795 * Fix bugs. 796 796 797 -Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/p h4uyz0rchflrnw/AADr1f_5Sg30804NItpfOQbla?dl=0]]**783 +Firmware and changelog can be downloaded from : **[[Firmware download link>>url:https://www.dropbox.com/sh/w1p7ukjrx49e62r/AAB3uCNCt-koYUvMkZUPBRSca?dl=0]]** 798 798 799 799 Methods to Update Firmware: 800 800 ... ... @@ -822,11 +822,11 @@ 822 822 823 823 824 824 ((( 825 -(% 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.) 811 +(% 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.) 826 826 ))) 827 827 828 828 ((( 829 -Troubleshooting: Please avoid use of this product under such circumstance in practice. 815 +(% style="color:red" %)**Troubleshooting**(%%): Please avoid use of this product under such circumstance in practice. 830 830 ))) 831 831 832 832 ... ... @@ -835,7 +835,7 @@ 835 835 ))) 836 836 837 837 ((( 838 -Troubleshooting: please use dry dust-free cloth to gently remove the foreign matter. 824 +(% style="color:red" %)**Troubleshooting**(%%): please use dry dust-free cloth to gently remove the foreign matter. 839 839 ))) 840 840 841 841
- image-20230615152941-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +87.9 KB - Content
- image-20230615153004-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +87.9 KB - Content