From 860677d09de17faeb5faeba74977e55751b51d26 Mon Sep 17 00:00:00 2001 From: kahrendt Date: Tue, 11 Jul 2023 00:24:23 -0400 Subject: [PATCH] Add documentation for new Zio Ultrasonic Distance Sensor component (#3043) --- components/sensor/images/zio_ultrasonic.jpg | Bin 0 -> 80913 bytes components/sensor/zio_ultrasonic.rst | 48 ++++++++++++++++++++ images/zio_ultrasonic.jpg | Bin 0 -> 14397 bytes index.rst | 1 + 4 files changed, 49 insertions(+) create mode 100644 components/sensor/images/zio_ultrasonic.jpg create mode 100644 components/sensor/zio_ultrasonic.rst create mode 100644 images/zio_ultrasonic.jpg diff --git a/components/sensor/images/zio_ultrasonic.jpg b/components/sensor/images/zio_ultrasonic.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b1eb1e09d575120855b2f3fdc87ddc7f03a76c87 GIT binary patch literal 80913 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\S{ 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 CX_Th` literal 0 HcmV?d00001 diff --git a/components/sensor/zio_ultrasonic.rst b/components/sensor/zio_ultrasonic.rst new file mode 100644 index 000000000..39dfb3844 --- /dev/null +++ b/components/sensor/zio_ultrasonic.rst @@ -0,0 +1,48 @@ +Zio Ultrasonic Distance Sensor +============================== + +.. seo:: + :description: Instructions for setting up the Zio Ultrasonic Distance sensor. + :image: zio_ultrasonic.jpg + :keywords: ultrasonic, i2c + +The Zio Ultrasonic Distance sensor allows you to use your compatible +(`datasheet `__, +`sparkfun `__) +sensors with ESPHome. + +.. figure:: images/zio_ultrasonic.jpg + :align: center + :width: 30.0% + + Zio Ultrasonic Distance Sensor. + (Credit: `Sparkfun `__, image cropped and compressed) + +.. _Sparkfun: https://www.sparkfun.com/products/17777 + +The Zio Ultrasonic Distance Sensor is an ultrasonic distance sensor based on the HC-SR04 sensor. Unlike the :doc:`Ultrasonic Distance Sensor component `, measurements are read over the I²C bus. + +To use the sensor, first set up an :ref:`I²C Bus ` and connect the sensor to the specified pins. + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: zio_ultrasonic + name: "Distance" + update_interval: 60s + +Configuration variables: +------------------------ + +- **address** (*Optional*, int): Manually specifiy the I²C address of the sensor. Defaults to ``0x00``. +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``. +- All other options from :ref:`Sensor `. + +See Also +-------- + +- :doc:`Ultrasonic Sensor Component ` +- :ref:`sensor-filters` +- :doc:`template` +- :ghedit:`Edit` diff --git a/images/zio_ultrasonic.jpg b/images/zio_ultrasonic.jpg new file mode 100644 index 0000000000000000000000000000000000000000..5cf4211a88c76f3cd1bfa7226e4a771da3e070fe GIT binary patch literal 14397 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 o94G0?-k*zf@g+(Ce}5LovuQY&@zTtD76