diff --git a/components/sensor/images/mpl3115a2-full.jpg b/components/sensor/images/mpl3115a2-full.jpg new file mode 100644 index 000000000..a923f4c4d Binary files /dev/null and b/components/sensor/images/mpl3115a2-full.jpg differ diff --git a/components/sensor/mpl3115a2.rst b/components/sensor/mpl3115a2.rst new file mode 100644 index 000000000..8bbb69c1e --- /dev/null +++ b/components/sensor/mpl3115a2.rst @@ -0,0 +1,70 @@ +MPL3115A2 Barometric Pressure/Altitude/Temperature Sensor +========================================================= + +.. seo:: + :description: Instructions for setting up MPL3115A2 atmospheric pressure sensors. + :image: mpl3115a2.jpg + :keywords: MPL3115A2 + +The ``mpl3115a2`` sensor platform allows you to use your MPL3115A2 atmospheric pressure sensors +(`datasheet `__, +`Adafruit`_) temperature and pressure sensors with ESPHome. The :ref:`I²C ` is +required to be set up in your configuration for this sensor to work. + +.. figure:: images/mpl3115a2-full.jpg + :align: center + :width: 50.0% + + MPL3115A2 Barometric Pressure/Altitude/Temperature Sensor + +.. _Adafruit: https://www.adafruit.com/product/1893 + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: mpl3115a2 + temperature: + name: "MPL3115A2 Temperature" + pressure: + name: "MPL3115A2 Pressure" + update_interval: 10s + +Configuration variables: +------------------------ +The MPL3115A2 can be configured to output either pressure or altitude depending on which +sensor is configured. + +- **pressure** (**Optional**): The information for the pressure sensor. + + - **name** (**Required**, string): The name for the pressure sensor. + - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas. + - All other options from :ref:`Sensor `. + +- **altitude** (**Optional**): The information for the altitude sensor. + + - **name** (**Required**, string): The name for the altitude sensor. + - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas. + - All other options from :ref:`Sensor `. + +- **temperature** (**Optional**): The information for the temperature sensor. + + - **name** (**Required**, string): The name for the temperature sensor. + - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas. + - All other options from :ref:`Sensor `. + +- **address** (*Optional*, int): Manually specify the I²C address of + the sensor. Defaults to ``0x60``. +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the + sensor. Defaults to ``60s``. + +See Also +-------- + +- :ref:`sensor-filters` +- :doc:`bmp280` +- :doc:`bme280` +- :doc:`bmp085` +- :doc:`ms5611` +- :apiref:`mpl3115a2/mpl3115a2.h` +- :ghedit:`Edit` diff --git a/images/mpl3115a2.jpg b/images/mpl3115a2.jpg new file mode 100644 index 000000000..76f323a38 Binary files /dev/null and b/images/mpl3115a2.jpg differ diff --git a/index.rst b/index.rst index b59559358..e0f10527a 100644 --- a/index.rst +++ b/index.rst @@ -303,6 +303,7 @@ Environmental Inkbird IBS-TH1 Mini, components/sensor/inkbird_ibsth1_mini, inkbird_isbth1_mini.jpg, Temperature & Humidity MCP9808, components/sensor/mcp9808, mcp9808.jpg, Temperature MH-Z19, components/sensor/mhz19, mhz19.jpg, CO2 & Temperature + MPL3115A2, components/sensor/mpl3115a2, mpl3115a2.jpg, Temperature & Pressure MS5611, components/sensor/ms5611, ms5611.jpg, Pressure NTC Thermistor, components/sensor/ntc, ntc.jpg, Temperature QMP6988, components/sensor/qmp6988, qmp6988_env3.png, Temperature & Pressure