Changes for page DS20L -- LoRaWAN Smart Distance Detector User Manual 01

Last modified by Mengting Qiu on 2023/12/14 11:15

From 82.2 to 82.3 From 82.4 to 82.5

From version 82.3

edited by Xiaoling
on 2023/06/14 16:32

Change comment: There is no comment for this version

To version 82.4

edited by Xiaoling
on 2023/06/14 16:46

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -99,135 +99,24 @@
  * Sleep Mode: 5uA @ 3.3v
  * LoRa Transmit Mode: 125mA @ 20dBm, 82mA @ 14dBm
--== 1.4 Suitable Container & Liquid ==
--* Solid Wall container such as: steel, iron, glass, ceramics, non-foaming plastics etc.
--* Container shape is regular, and surface is smooth.
--* Container Thickness:
--** Pure metal material.  2~~8mm, best is 3~~5mm
--** Pure non metal material: <10 mm
--* Pure liquid without irregular deposition.
++== 1.4 Applications ==
--(% style="display:none" %)
--== 1.5 Install LDS12-LB ==
++* Horizontal distance measurement
++* Parking management system
++* Object proximity and presence detection
++* Intelligent trash can management system
++* Robot obstacle avoidance
++* Automatic control
++* Sewer
--(% style="color:blue" %)**Step 1**(%%):  ** Choose the installation point.**
--LDS12-LB (% style="color:red" %)**MUST**(%%) be installed on the container bottom middle position.
--
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615091045-3.png?rev=1.1||alt="image-20220615091045-3.png"]]
--
--
--(((
--(% style="color:blue" %)**Step 2**(%%):   **Polish the installation point.**
--)))
--
--(((
--For Metal Surface with paint, it is important to polish the surface, first use crude sand paper to polish the paint level , then use exquisite sand paper to polish the metal level to make it shine & smooth.
--)))
--
--[[image:image-20230613143052-5.png]]
--
--
--No polish needed if the container is shine metal surface without paint or non-metal container.
--
--[[image:image-20230613143125-6.png]]
--
--
--(((
--(% style="color:blue" %)**Step3:   **(%%)**Test the installation point.**
--)))
--
--(((
--Power on LDS12-LB, check if the blue LED is on, If the blue LED is on, means the sensor works. Then put ultrasonic coupling paste on the sensor and put it tightly on the installation point.
--)))
--
--(((
--It is necessary to put the coupling paste between the sensor and the container, otherwise LDS12-LB won't detect the liquid level.
--)))
--
--(((
--After paste the LDS12-LB well, power on LDS12-LB. In the first 30 seconds of booting, device will check the sensors status and BLUE LED will show the status as below. After 30 seconds, BLUE LED will be off to save battery life.
--)))
--
--
--(((
--(% style="color:blue" %)**LED Status:**
--)))
--
--* (((
--**Onboard LED**: When power on device, the onboard LED will fast blink 4 times which means detect the sensor well.
--)))
--
--* (((
--(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** always ON**(%%): Sensor is power on but doesn't detect liquid. There is problem in installation point.
--)))
--* (((
--(% style="color:blue" %)**BLUE LED**(% style="color:red" %)** slowly blinking**(%%): Sensor detects Liquid Level, The installation point is good.
--)))
--
--(((
--LDS12-LB will enter into low power mode at 30 seconds after system reset or power on, Blue LED will be off after that.
--)))
--
--
--(((
--(% style="color:red" %)**Note :**(%%)** (% style="color:blue" %)Ultrasonic coupling paste(%%)**(% style="color:blue" %) (%%) is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.
--)))
--
--
--(((
--(% style="color:blue" %)**Step4:   **(%%)**Install use Epoxy ab glue.**
--)))
--
--(((
--Prepare Eproxy AB glue.
--)))
--
--(((
--Put Eproxy AB glue in the sensor and press it hard on the container installation point.
--)))
--
--(((
--Reset LDS12-LB and see if the BLUE LED is slowly blinking.
--)))
--
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615091045-8.png?width=341&height=203&rev=1.1||alt="image-20220615091045-8.png"]]      [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/image-20220615091045-9.png?width=284&height=200&rev=1.1||alt="image-20220615091045-9.png"]]
--
--
--(((
--(% style="color:red" %)**Note :**
--
--(% style="color:red" %)**1:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** needs 3~~ 5 minutes to stable attached. we can use other glue material to keep it in the position.
--)))
--
--(((
--(% style="color:red" %)**2:**(%%)** (% style="color:blue" %)Eproxy AB glue(%%)** is subjected in most shipping way. So the default package doesn't include it and user needs to purchase locally.
--)))
--
--
--== 1.6 Applications ==
--
--
--* Smart liquid control solution
--
--* Smart liquefied gas solution
--
--== 1.7 Precautions ==
--
--
--* At room temperature, containers of different materials, such as steel, glass, iron, ceramics, non-foamed plastics and other dense materials, have different detection blind areas and detection limit heights.
--
--* For containers of the same material at room temperature, the detection blind zone and detection limit height are also different for the thickness of the container.
--
--* When the detected liquid level exceeds the effective detection value of the sensor, and the liquid level of the liquid to be measured shakes or tilts, the detected liquid height is unstable.
--
  (% style="display:none" %)
--== 1.8 Sleep mode and working mode ==
++== 1.5 Sleep mode and working mode ==
  (% style="color:blue" %)**Deep Sleep Mode: **(%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
@@ -235,7 +235,7 @@
  (% style="color:blue" %)**Working Mode:** (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
--== 1.9 Button & LEDs ==
++== 1.6 Button & LEDs ==
  [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
@@ -254,7 +254,7 @@
  )))
  |(% 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.
--== 1.10 BLE connection ==
++== 1.7 BLE connection ==
  LDS12-LB support BLE remote configure.
@@ -268,14 +268,15 @@
  If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
--== 1.11 Pin Definitions ==
++== 1.8 Pin Definitions ==
--[[image:image-20230523174230-1.png]]
++[[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"]]
--== 1.12 Mechanical ==
++== 1.9 Mechanical ==
++
  [[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675143884058-338.png]]
@@ -360,21 +360,23 @@
  )))
  (((
--Uplink payload includes in total 8 bytes.
++Uplink payload includes in total 11 bytes.
  )))
++
  (% border="1" cellspacing="5" style="background-color:#f2f2f2; width:510px" %)
  |=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)(((
  **Size(bytes)**
--)))|=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="background-color:#D9E2F3;color:#0070C0" %)1|=(% style="background-color:#D9E2F3;color:#0070C0" %)2|=(% style="background-color:#D9E2F3;color:#0070C0" %)**1**
--|(% style="width:62.5px" %)Value|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(((
--[[Distance>>||anchor="H2.3.2A0Distance"]]
--(unit: mm)
--)))|[[Digital Interrupt (Optional)>>||anchor="H2.3.3A0InterruptPin"]]|(((
--[[Temperature (Optional )>>||anchor="H2.3.4A0DS18B20Temperaturesensor"]]
--)))|[[Sensor Flag>>||anchor="H2.3.5A0SensorFlag"]]
++)))|=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 62.5px;background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="background-color:#d9e2f3; color:#0070c0" %)**2**|=(% style="background-color:#d9e2f3; color:#0070c0" %)**2**|=(% style="background-color:#d9e2f3; color:#0070c0" %)**1**|=(% style="background-color:#d9e2f3; color:#0070c0" %)**1**|=(% style="background-color:#d9e2f3; color:#0070c0" %)**1**
++|(% style="width:62.5px" %)**Value**|(% style="width:62.5px" %)[[BAT>>||anchor="H2.3.1A0BatteryInfo"]]|(% style="width:62.5px" %)(((
++[[Temperature DS18B20>>||anchor="H2.3.2A0DS18B20Temperaturesensor"]]
++)))|[[Distance>>||anchor="H2.3.3A0Distance"]]|[[Distance signal strength>>||anchor="H2.3.4A0Distancesignalstrength"]]|(((
++[[Interrupt  flag>>||anchor="H2.3.5A0InterruptPin"]]
++)))|[[LiDAR temp>>||anchor="H2.3.6A0LiDARtemp"]]|(((
++[[Message Type>>||anchor="H2.3.7A0MessageType"]]
++)))
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS20%20-%20LoRaWAN%20Liquid%20Level%20Sensor%20User%20Manual/WebHome/1654850511545-399.png?rev=1.1||alt="1654850511545-399.png"]]
++[[image:1654833689380-972.png]]
  === 2.3.1  Battery Info ===
@@ -387,73 +387,102 @@
  Ex2: 0x0B49 = 2889mV
--=== 2.3.2  Distance ===
++=== 2.3.2  DS18B20 Temperature sensor ===
--(((
--Get the distance. Flat object range 20mm - 2000mm.
--)))
++This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
--(((
--For example, if the data you get from the register is **0x06 0x05**, the distance between the sensor and the measured object is(% style="color:#4472c4" %)** **
--(% style="color:blue" %)**0605(H) = 1541 (D) = 1541 mm.**
--)))
++**Example**:
--* If the sensor value is 0x0000, it means system doesn't detect ultrasonic sensor.
++If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
--* If the sensor value lower than 0x0014 (20mm), the sensor value will be invalid.
++If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
--=== 2.3.3  Interrupt Pin ===
++=== 2.3.3  Distance ===
--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.
--**Example:**
++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.
--0x00: Normal uplink packet.
--0x01: Interrupt Uplink Packet.
++**Example**:
++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.
--=== 2.3.4  DS18B20 Temperature sensor ===
++=== 2.3.4  Distance signal strength ===
--This is optional, user can connect external DS18B20 sensor to the +3.3v, 1-wire and GND pin . and this field will report temperature.
++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.
++
++
  **Example**:
--If payload is: 0105H:  (0105 & FC00 == 0), temp = 0105H /10 = 26.1 degree
++If payload is: 01D7(H)=471(D), distance signal strength=471, 471>100,471≠65535, the measured value of Dist is considered credible.
--If payload is: FF3FH :  (FF3F & FC00 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
++Customers can judge whether they need to adjust the environment based on the signal strength.
--=== 2.3.5  Sensor Flag ===
++=== 2.3.5  Interrupt Pin ===
++This data field shows if this packet is generated by interrupt or not. [[Click here>>||anchor="H4.2A0SetInterruptMode"]] for the hardware and software set up.
++
++Note: The Internet Pin is a separate pin in the screw terminal. See [[pin mapping>>||anchor="H1.6A0Pinmappingandpoweron"]].
++
++**Example:**
++
++0x00: Normal uplink packet.
++
++0x01: Interrupt Uplink Packet.
++
++
++=== 2.3.6  LiDAR temp ===
++
++
++Characterize the internal temperature value of the sensor.
++
++**Example: **
++If payload is: 1C(H) <<24>>24=28(D),LiDAR temp=28℃.
++If payload is: F2(H) <<24>>24=-14(D),LiDAR temp=-14℃.
++
++
++=== 2.3.7  Message Type ===
++
++
  (((
--0x01: Detect Ultrasonic Sensor
++For a normal uplink payload, the message type is always 0x01.
  )))
  (((
--0x00: No Ultrasonic Sensor
++Valid Message Type:
  )))
++(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:499px" %)
++|=(% style="width: 161px;background-color:#D9E2F3;color:#0070C0" %)**Message Type Code**|=(% style="width: 164px;background-color:#D9E2F3;color:#0070C0" %)**Description**|=(% style="width: 174px;background-color:#D9E2F3;color:#0070C0" %)**Payload**
++|(% style="width:160px" %)0x01|(% style="width:163px" %)Normal Uplink|(% style="width:173px" %)[[Normal Uplink Payload>>||anchor="H2.3A0200BUplinkPayload"]]
++|(% style="width:160px" %)0x02|(% style="width:163px" %)Reply configures info|(% style="width:173px" %)[[Configure Info Payload>>||anchor="H4.3A0GetFirmwareVersionInfo"]]
--=== 2.3.6  Decode payload in The Things Network ===
++=== 2.3.8  Decode payload in The Things Network ===
++
  While using TTN network, you can add the payload format to decode the payload.
--[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LDDS75%20-%20LoRaWAN%20Distance%20Detection%20Sensor%20User%20Manual/WebHome/1654850829385-439.png?rev=1.1||alt="1654850829385-439.png"]]
--The payload decoder function for TTN V3 is here:
++[[image:1654592762713-715.png]]
++
  (((
--LDS12-LB TTN V3 Payload Decoder:  [[ttps:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
++The payload decoder function for TTN is here:
  )))
++(((
++LDS12-LB TTN Payload Decoder:  [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
++)))
++
  == 2.4  Uplink Interval ==
@@ -580,6 +580,96 @@
  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
++== 2.8 LiDAR ToF Measurement ==
++
++=== 2.8.1 Principle of Distance Measurement ===
++
++
++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.
++
++
++[[image:1654831757579-263.png]]
++
++
++=== 2.8.2 Distance Measurement Characteristics ===
++
++
++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:
++
++[[image:1654831774373-275.png]]
++
++
++(((
++(% style="color:blue" %)**① **(%%)Represents the detection blind zone of The LiDAR probe, 0-10cm, within which the output data is unreliable.
++)))
++
++(((
++(% style="color:blue" %)**② **(%%)Represents the operating range of The LiDAR probe detecting black target with 10% reflectivity, 0.1-5m.
++)))
++
++(((
++(% style="color:blue" %)**③ **(%%)Represents the operating range of The LiDAR probe detecting white target with 90% reflectivity, 0.1-12m.
++)))
++
++
++(((
++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:
++)))
++
++
++[[image:1654831797521-720.png]]
++
++
++(((
++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.
++)))
++
++[[image:1654831810009-716.png]]
++
++
++(((
++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.
++)))
++
++
++=== 2.8.3  Notice of usage: ===
++
++
++Possible invalid /wrong reading for LiDAR ToF tech:
++
++* Measure high reflectivity object such as: Mirror, Smooth ceramic tile, static milk surface, will have possible wrong readings.
++* While there is transparent object such as glass, water drop between the measured object and the LiDAR sensor, the reading might be wrong.
++* The LiDAR probe is cover by dirty things; the reading might be wrong. In this case, need to clean the probe.
++* The sensor window is made by Acrylic. Don't touch it with alcohol material. This will destroy the sensor window.
++
++
++=== 2.8.4  Reflectivity of different objects ===
++
++
++(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:379px" %)
++|=(% 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" %)Relectivity
++|(% style="width:53px" %)1|(% style="width:229px" %)Black foam rubber|(% style="width:93px" %)2.4%
++|(% style="width:53px" %)2|(% style="width:229px" %)Black fabric|(% style="width:93px" %)3%
++|(% style="width:53px" %)3|(% style="width:229px" %)Black rubber|(% style="width:93px" %)4%
++|(% style="width:53px" %)4|(% style="width:229px" %)Coal (different types of coal)|(% style="width:93px" %)4~~8%
++|(% style="width:53px" %)5|(% style="width:229px" %)Black car paint|(% style="width:93px" %)5%
++|(% style="width:53px" %)6|(% style="width:229px" %)Black Jam|(% style="width:93px" %)10%
++|(% style="width:53px" %)7|(% style="width:229px" %)Opaque black plastic|(% style="width:93px" %)14%
++|(% style="width:53px" %)8|(% style="width:229px" %)Clean rough board|(% style="width:93px" %)20%
++|(% style="width:53px" %)9|(% style="width:229px" %)Translucent plastic bottle|(% style="width:93px" %)62%
++|(% style="width:53px" %)10|(% style="width:229px" %)Carton cardboard|(% style="width:93px" %)68%
++|(% style="width:53px" %)11|(% style="width:229px" %)Clean pine|(% style="width:93px" %)70%
++|(% style="width:53px" %)12|(% style="width:229px" %)Opaque white plastic|(% style="width:93px" %)87%
++|(% style="width:53px" %)13|(% style="width:229px" %)White Jam|(% style="width:93px" %)90%
++|(% style="width:53px" %)14|(% style="width:229px" %)Kodak Standard Whiteboard|(% style="width:93px" %)100%
++|(% style="width:53px" %)15|(% style="width:229px" %)(((
++Unpolished white metal surface
++)))|(% style="width:93px" %)130%
++|(% style="width:53px" %)16|(% style="width:229px" %)Glossy light metal surface|(% style="width:93px" %)150%
++|(% style="width:53px" %)17|(% style="width:229px" %)stainless steel|(% style="width:93px" %)200%
++|(% style="width:53px" %)18|(% style="width:229px" %)Reflector plate, reflective tape|(% style="width:93px" %)>300%
++
++
  = 3. Configure LDS12-LB =
  == 3.1 Configure Methods ==