diff --git a/components/sensor/images/sen0321.jpg b/components/sensor/images/sen0321.jpg new file mode 100644 index 000000000..ffb2f1b28 Binary files /dev/null and b/components/sensor/images/sen0321.jpg differ diff --git a/components/sensor/sen0321.rst b/components/sensor/sen0321.rst new file mode 100644 index 000000000..ed86548d1 --- /dev/null +++ b/components/sensor/sen0321.rst @@ -0,0 +1,49 @@ +SEN0321 DFRobot Ozone Sensor +============================ + +.. seo:: + :description: Instructions for setting up SEN0321 DFRobot ozone sensors + :image: sen0321.jpg + :keywords: sen0321 + +The ``sen0321`` sensor platform allows you to use your DFRobot +(`product wiki `__, +`DFRobot`_) ozone sensors with ESPHome. The sensor is used in automatic mode where the sensor actively +updates its measurements every 2 seconds. +:ref:`I²C ` is required to be set up in your configuration for this sensor to work. + +.. figure:: images/sen0321.jpg + :align: center + :width: 50.0% + + DFRobot Ozone Sensor (sen0321). + +.. _DFRobot: https://www.dfrobot.com/product-2005.html + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: sen0321 + name: "Ozone Sensor" + address: 0x73 + update_interval: 60s + +Configuration variables: +------------------------ + +- All options from :ref:`Sensor `. + +- **address** (*Optional*, int): Manually specify the I²C address of + the sensor. Defaults to ``0x73``. Sensor can be configured to ``0x70``, ``0x71``, ``0x72``, or ``0x73`` using jumpers on the board. + +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the + sensor. Defaults to ``60s``. + +See Also +-------- + +- :ref:`sensor-filters` +- :apiref:`sen0321/sen0321.h` +- `DFRobot SEN0321 Library `__ by `DFRobot `__ +- :ghedit:`Edit` diff --git a/images/sen0321.jpg b/images/sen0321.jpg new file mode 100644 index 000000000..55ac6dcf8 Binary files /dev/null and b/images/sen0321.jpg differ diff --git a/index.rst b/index.rst index 5feaf4036..0a07c4a4b 100644 --- a/index.rst +++ b/index.rst @@ -185,6 +185,7 @@ Air Quality PMSX003, components/sensor/pmsx003, pmsx003.svg, Particulate RadonEye BLE, components/sensor/radon_eye_ble, radon_eye_logo.png, Radon SDS011 Sensor, components/sensor/sds011, sds011.jpg, Particulate + SEN0321, components/sensor/sen0321, sen0321.jpg, Ozone SEN5x, components/sensor/sen5x, sen54.jpg, Temperature & Humidity, Volatile organics and NOx SenseAir, components/sensor/senseair, senseair_s8.jpg, CO2 SCD30, components/sensor/scd30, scd30.jpg, CO2 & Temperature & Humidity