diff --git a/components/sensor/a01nyub.rst b/components/sensor/a01nyub.rst new file mode 100644 index 000000000..04371bd0a --- /dev/null +++ b/components/sensor/a01nyub.rst @@ -0,0 +1,46 @@ +A01NYUB Waterproof Ultrasonic Sensor +==================================== + +.. seo:: + :description: Instructions for setting up A01NYUB waterproof ultrasonic distance sensor in ESPHome. + :image: a01nyub.jpg + :keywords: ultrasonic, DFRobot, A01NYUB + +This sensor allows you to use A01NYUB waterproof ultrasonic sensor by DFRobot +(`datasheet `__) +with ESPHome to measure distances. This sensor can measure +ranges between 28 centimeters and 750 centimeters with a resolution of 1 milimeter. + +Since this sensor reads multiple times per second, :ref:`sensor-filters` are highly recommended. + +To use the sensor, first set up an :ref:`uart` with a baud rate of 9600 and connect the sensor to the specified pin. + +.. figure:: images/a01nyub-full.jpg + :align: center + :width: 50.0% + + A01NYUB Waterproof Ultrasonic Distance Sensor. + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: "a01nyub" + name: "Distance" + + +Configuration variables: +------------------------ + +- **name** (**Required**, string): The name of the sensor. +- **uart_id** (*Optional*, :ref:`config-id`): The ID of the :ref:`UART bus ` you wish to use for this sensor. + Use this if you want to use multiple UART buses at once. +- All other options from :ref:`Sensor `. + +See Also +-------- + +- :ref:`sensor-filters` +- :ref:`uart` +- :apiref:`a01nyub/a01nyub.h` +- :ghedit:`Edit` diff --git a/components/sensor/images/a01nyub-full.jpg b/components/sensor/images/a01nyub-full.jpg new file mode 100644 index 000000000..6060496d8 Binary files /dev/null and b/components/sensor/images/a01nyub-full.jpg differ diff --git a/images/a01nyub.jpg b/images/a01nyub.jpg new file mode 100644 index 000000000..49d48c545 Binary files /dev/null and b/images/a01nyub.jpg differ diff --git a/index.rst b/index.rst index cafa44213..16ab70395 100644 --- a/index.rst +++ b/index.rst @@ -236,6 +236,7 @@ Distance ******** .. imgtable:: + A01NYUB, components/sensor/a01nyub, a01nyub.jpg, Acoustic distance HRXL MaxSonar WR, components/sensor/hrxl_maxsonar_wr, hrxl_maxsonar_wr.jpg, Acoustic distance TOF10120, components/sensor/tof10120, tof10120.jpg, IR optical distance Ultrasonic Sensor, components/sensor/ultrasonic, ultrasonic.jpg, Acoustic distance