Skip to Content
Last modified by Mengting Qiu on 2023/12/14 11:15
From version 98.1
edited by Saxer Lin
on 2023/08/05 15:03
Change comment: Uploaded new attachment "image-20230805150315-4.png", version {1}
To version 109.14
edited by Xiaoling
on 2023/11/10 08:51
Change comment: Update document after refactoring.

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -LDS12-LB -- LoRaWAN LiDAR ToF Distance Sensor User Manual
1 +DS20L_LoRaWAN_Smart_Distance_Detector_User_Manual
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Saxer
1 +XWiki.Xiaoling
Content
... ... @@ -45,8 +45,8 @@
45 45  * Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
46 46  * Ultra-low power consumption
47 47  * Laser technology for distance detection
48 -* Measure Distance: 0.1m~~12m @ 90% Reflectivity
49 -* Accuracy :  ±5cm@(0.1-6m), ±1%@(6m-12m)
48 +* Measure Distance: 0.1m~~12m
49 +* Accuracy :  ±5cm@(0.1-5m), ±1%@(5m-12m)
50 50  * Monitor Battery Level
51 51  * Support Bluetooth v5.1 and LoRaWAN remote configure
52 52  * Support wireless OTA update firmware
... ... @@ -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  
... ... @@ -69,8 +69,8 @@
69 69  * Measure Distance:
70 70  ** 0.1m ~~ 12m @ 90% Reflectivity
71 71  ** 0.1m ~~ 4m @ 10% Reflectivity
72 -* Accuracy : ±5cm@(0.1-6m), ±1%@(6m-12m)
73 -* Distance resolution : 5mm
73 +* Accuracy : ±5cm@(0.1-5m), ±1%@(5m-12m)
74 +* Distance resolution : 1cm
74 74  * Ambient light immunity : 70klux
75 75  * Enclosure rating : IP65
76 76  * Light source : LED
... ... @@ -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 ==
... ... @@ -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  
... ... @@ -312,7 +312,7 @@
312 312  (((
313 313  LDS12-LB will send this uplink **after** Device Status once join the LoRaWAN network successfully. And LDS12-LB will:
314 314  
315 -periodically send this uplink every 20 minutes, this interval [[can be changed>>http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDS12-LB_LoRaWAN_LiDAR_ToF_Distance_Sensor_User_Manual/#H3.3.1SetTransmitIntervalTime]].
319 +periodically send this uplink every 20 minutes, this interval [[can be changed>>||anchor="H3.3.1SetTransmitIntervalTime"]].
316 316  
317 317  Uplink Payload totals 11 bytes.
318 318  )))
... ... @@ -379,18 +379,33 @@
379 379  Customers can judge whether they need to adjust the environment based on the signal strength.
380 380  
381 381  
386 +**1) When the sensor detects valid data:**
387 +
388 +[[image:image-20230805155335-1.png||height="145" width="724"]]
389 +
390 +
391 +**2) When the sensor detects invalid data:**
392 +
393 +[[image:image-20230805155428-2.png||height="139" width="726"]]
394 +
395 +
396 +**3) When the sensor is not connected:**
397 +
398 +[[image:image-20230805155515-3.png||height="143" width="725"]]
399 +
400 +
382 382  ==== (% style="color:blue" %)**Interrupt Pin & Interrupt Level**(%%) ====
383 383  
384 384  
385 385  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.
386 386  
387 -Note: The Internet Pin is a separate pin in the screw terminal. See GPIO_EXTI of [[pin mapping>>||anchor="H1.8PinDefinitions"]].
406 +Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.8PinDefinitions"]] of GPIO_EXTI .
388 388  
389 389  **Example:**
390 390  
391 -0x00: Normal uplink packet.
410 +If byte[0]&0x01=0x00 : Normal uplink packet.
392 392  
393 -0x01: Interrupt Uplink Packet.
412 +If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
394 394  
395 395  
396 396  ==== (% style="color:blue" %)**LiDAR temp**(%%) ====
... ... @@ -416,19 +416,41 @@
416 416  
417 417  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
418 418  |=(% style="width: 161px;background-color:#4F81BD;color:white" %)**Message Type Code**|=(% style="width: 164px;background-color:#4F81BD;color:white" %)**Description**|=(% style="width: 174px;background-color:#4F81BD;color:white" %)**Payload**
419 -|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3200BUplinkPayload"]]
420 -|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H3.ConfigureLDS12-LB"]]
438 +|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)Normal Uplink Payload
439 +|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)Configure Info Payload
421 421  
441 +[[image:image-20230805150315-4.png||height="233" width="723"]]
422 422  
423 -=== 2.3.3 Historical Water Flow Status, FPORT~=3 ===
424 424  
425 -LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/#H2.5DatalogFeature]].
444 +=== 2.3.3 Historical measuring distance, FPORT~=3 ===
426 426  
427 -The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time water flow status.
428 428  
447 +LDS12-LB stores sensor values and users can retrieve these history values via the [[downlink command>>||anchor="H2.5.4Pollsensorvalue"]].
429 429  
449 +The historical payload includes one or multiplies entries and every entry has the same payload as Real-Time measuring distance.
450 +
451 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
452 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
453 +**Size(bytes)**
454 +)))|=(% style="width: 80px;background-color:#4F81BD;color:white" %)1|=(% style="width: 80px;background-color:#4F81BD;color:white" %)**1**|=(% 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: 85px;" %)**1**|=(% style="background-color: #4F81BD; color: white; width: 85px;" %)4
455 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)Interrupt flag & Interrupt_level|(% style="width:62.5px" %)(((
456 +Reserve(0xFF)
457 +)))|Distance|Distance signal strength|(% style="width:88px" %)(((
458 +LiDAR temp
459 +)))|(% style="width:85px" %)Unix TimeStamp
460 +
461 +**Interrupt flag & Interrupt level:**
462 +
463 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:480px" %)
464 +|=(% style="width: 60px;background-color:#4F81BD;color:white" %)(((
465 +**Size(bit)**
466 +)))|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit7**|=(% style="width: 90px;background-color:#4F81BD;color:white" %)**bit6**|=(% style="width: 60px;background-color:#4F81BD;color:white" %)**[bit5:bit2]**|=(% style="width: 90px; background-color: #4F81BD; color: white;" %)**bit1**|=(% style="background-color: #4F81BD; color: white; width: 90px;" %)**bit0**
467 +|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)No ACK message|(% style="width:62.5px" %)Poll Message Flag|Reserve|(% style="width:91px" %)Interrupt level|(% style="width:88px" %)(((
468 +Interrupt flag
469 +)))
470 +
430 430  * (((
431 -Each data entry is 11 bytes and has the same structure as [[real time water flow status>>url:http://8.211.40.43/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L-LB_LoRaWAN_Flow_Sensor_User_Manual/#H2.3.3A0WaterFlowValue2CUplinkFPORT3D2]], to save airtime and battery, LDS12-LB will send max bytes according to the current DR and Frequency bands.
472 +Each data entry is 11 bytes and has the same structure as [[Uplink Payload>>||anchor="H2.3.2UplinkPayload2CFPORT3D2"]], to save airtime and battery, LDS12-LB will send max bytes according to the current DR and Frequency bands.
432 432  )))
433 433  
434 434  For example, in the US915 band, the max payload for different DR is:
... ... @@ -477,12 +477,12 @@
477 477  [362,173,30,Low,False,2023-08-04 02:58:53],
478 478  
479 479  
480 -History read from serial port：
521 +**History read from serial port：**
481 481  
482 482  [[image:image-20230805145056-3.png]]
483 483  
484 484  
485 -=== 2.3.3 Decode payload in The Things Network ===
526 +=== 2.3.4 Decode payload in The Things Network ===
486 486  
487 487  
488 488  While using TTN network, you can add the payload format to decode the payload.
... ... @@ -677,6 +677,7 @@
677 677  * The LiDAR probe is cover by dirty things; the reading might be wrong. In this case, need to clean the probe.
678 678  * The sensor window is made by Acrylic. Don't touch it with alcohol material. This will destroy the sensor window.
679 679  
721 +
680 680  === 2.7.4  Reflectivity of different objects ===
681 681  
682 682  
... ... @@ -703,6 +703,7 @@
703 703  |(% style="width:53px" %)17|(% style="width:229px" %)stainless steel|(% style="width:93px" %)200%
704 704  |(% style="width:53px" %)18|(% style="width:229px" %)Reflector plate, reflective tape|(% style="width:93px" %)>300%
705 705  
748 +
706 706  = 3. Configure LDS12-LB =
707 707  
708 708  == 3.1 Configure Methods ==
... ... @@ -716,6 +716,7 @@
716 716  
717 717  * LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
718 718  
762 +
719 719  == 3.2 General Commands ==
720 720  
721 721  
... ... @@ -784,9 +784,9 @@
784 784  === 3.3.2 Set Interrupt Mode ===
785 785  
786 786  
787 -Feature, Set Interrupt mode for PA8 of pin.
831 +Feature, Set Interrupt mode for pin of GPIO_EXTI.
788 788  
789 -When AT+INTMOD=0 is set, PA8 is used as a digital input port.
833 +When AT+INTMOD=0 is set, GPIO_EXTI is used as a digital input port.
790 790  
791 791  (% style="color:blue" %)**AT Command: AT+INTMOD**
792 792  
... ... @@ -797,7 +797,11 @@
797 797  OK
798 798  the mode is 0 =Disable Interrupt
799 799  )))
800 -|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
844 +|(% style="width:154px" %)(((
845 +AT+INTMOD=2
846 +
847 +(default)
848 +)))|(% style="width:196px" %)(((
801 801  Set Transmit Interval
802 802  0. (Disable Interrupt),
803 803  ~1. (Trigger by rising and falling edge)
... ... @@ -815,6 +815,7 @@
815 815  
816 816  * Example 2: Downlink Payload: 06000003  ~/~/  Set the interrupt mode to rising edge trigger
817 817  
866 +
818 818  === 3.3.3  Set Power Output Duration ===
819 819  
820 820  Control the output duration 3V3(pin of VBAT_OUT) . Before each sampling, device will
... ... @@ -844,6 +844,7 @@
844 844  * Example 2: Downlink Payload: 07 01 01 F4  **~-~-->**  AT+3V3T=500
845 845  * Example 3: Downlink Payload: 07 01 FF FF  **~-~-->**  AT+3V3T=65535
846 846  
896 +
847 847  = 4. Battery & Power Consumption =
848 848  
849 849  
... ... @@ -872,6 +872,7 @@
872 872  
873 873  * 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]]**.
874 874  
925 +
875 875  = 6. FAQ =
876 876  
877 877  == 6.1 What is the frequency plan for LDS12-LB? ==
... ... @@ -932,6 +932,7 @@
932 932  
933 933  * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band
934 934  
986 +
935 935  = 9. ​Packing Info =
936 936  
937 937  
... ... @@ -949,6 +949,7 @@
949 949  
950 950  * Weight / pcs : g
951 951  
1004 +
952 952  = 10. Support =
953 953  
954 954  
image-20230805155335-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +45.4 KB
Content
image-20230805155428-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +45.5 KB
Content
image-20230805155515-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +45.7 KB
Content