diff --git a/components/sensor/images/ld2413-front-back.png b/components/sensor/images/ld2413-front-back.png new file mode 100644 index 0000000000..4e7bb2c192 Binary files /dev/null and b/components/sensor/images/ld2413-front-back.png differ diff --git a/components/sensor/ld2413.rst b/components/sensor/ld2413.rst new file mode 100644 index 0000000000..6bc2b42092 --- /dev/null +++ b/components/sensor/ld2413.rst @@ -0,0 +1,101 @@ +LD2413 Sensor +============= + +.. seo:: + :description: Integration for the HLK-LD2413 mmWave liquid/material level sensor in ESPHome. + :image: ld2413.jpg + +The ``ld2413`` sensor allows you to integrate the Hi-Link HLK-LD2413 millimeter wave distance sensor with ESPHome using UART. + +The HLK-LD2413 is a compact, high-precision 24GHz mmWave sensor with built-in AIoT radar chip and intelligent firmware, designed specifically for non-contact detection of liquid levels and material heights in both industrial and consumer applications. + +It supports a detection range of **15 cm to 10 m** with an accuracy of **±3 mm**. + +You can find the full datasheet for the HLK-LD2413 sensor `here `_. + +.. figure:: images/ld2413-front-back.png + :align: center + :width: 50.0% + +Pinout: J1 +---------- + + .. list-table:: + :widths: 15 20 30 35 + :header-rows: 1 + + * - Pin + - Name + - Function + - Illustrate + * - J1Pin1 + - 3V3 + - Power Input + - 3.0 V~3.6 V, Typ. 3.3 V + * - J1Pin2 + - GND + - Grounding + - - + * - J1Pin3 + - OT1 + - UART_TX + - 0~3.3V + * - J1Pin4 + - RX + - UART_RX + - 0~3.3V + * - J1Pin5 + - OT2 + - IO Port + - 0~3.3V + +Pinout: J2 +---------- + + .. list-table:: + :widths: 15 20 30 35 + :header-rows: 1 + + * - Pin + - Name + - Function + - Illustrate + * - J2Pin1 + - 3V3 + - Power Input + - 3.0 V~3.6 V, Typ. 3.3 V + * - J2Pin2 + - CLK + - Clock signal + - 0~3.3V + * - J2Pin3 + - DIO + - Data port + - 0~3.3V + * - J2Pin4 + - GND + - Grounding + - - + +.. code-block:: yaml + + uart: + rx_pin: GPIO16 + tx_pin: GPIO17 + baud_rate: 115200 + + sensor: + - platform: ld2413 + name: "LD2413 Distance" + +Configuration variables: +------------------------ + +- **name** (**Required**, string): The name of the sensor. +- All other options from :ref:`Sensor `. + +See Also +-------- + +- :doc:`/components/sensor/index` +- :doc:`/components/uart` diff --git a/images/ld2413.jpg b/images/ld2413.jpg new file mode 100644 index 0000000000..e1b0e59754 Binary files /dev/null and b/images/ld2413.jpg differ