diff --git a/components/sensor/images/max9611.jpg b/components/sensor/images/max9611.jpg new file mode 100644 index 000000000..53d2f8833 Binary files /dev/null and b/components/sensor/images/max9611.jpg differ diff --git a/components/sensor/max9611.rst b/components/sensor/max9611.rst new file mode 100644 index 000000000..4f3b02428 --- /dev/null +++ b/components/sensor/max9611.rst @@ -0,0 +1,78 @@ +MAX9611/9612 High Side Current+Voltage+Temperature Sensor +========================================================= + +.. seo:: + :description: Instructions for setting up MAX9611 MAX9612 High-Side Current-Sense Amplifier + :image: max9611.jpg + :keywords: MAX9611 MAX9612 + +The ``MAX9611`` sensor platform allows you to use your MAX9611/MAX9612 +(`datasheet `__) +High-side current, voltage and temperature sensors with ESPHome. + +This sensor supports up to +60V DC common mode voltage, has a 1.8V to 3.3V logic range, +a 12-Bit integrated ADC with :ref:`I²C `, and is meant to act as a high-side current sense amplifier. + +The :ref:`I²C ` is +required to be set up in your configuration for this sensor to work. + +.. figure:: images/max9611.jpg + :align: center + :width: 50.0% + + MAX9611 High-Side Current-Sense Amplifier + +.. code-block:: yaml + + # Example configuration entry + sensor: + - platform: max9611 + shunt_resistance: 0.2 ohm + gain: '1X' + voltage: + name: Max9611 Voltage + current: + name: Max9611 Current + power: + name: Max9611 Watts + temperature: + name: Max9611 Temperature + address: 0x70 + update_interval: 60s + +Configuration variables: +------------------------ + +- **shunt_resistance** (*Required*): The value of the High Side Shunt Resistor. + +- **Voltage** (*Optional*): The information for the voltage sensor + + - **name** (**Required**, string): The name for the voltage sensor. + - All other options from :ref:`Sensor `. + +- **Current** (*Optional*): The information for the current sensor, scaled by the gain factor and multiplied by voltage + + - **name** (**Required**, string): The name for the current sensor. + - All other options from :ref:`Sensor `. + +- **Power** (*Optional*): The information for the power sensor + + - **name** (**Required**, string): The name for the power sensor. + - All other options from :ref:`Sensor `. + +- **temperature** (*Optional*): The information for the temperature sensor + + - **name** (**Required**, string): The name for the temperature sensor. + - All other options from :ref:`Sensor `. + + +- **address** (*Optional*, int): Manually specify the I²C address of + the sensor. Defaults to ``0x70``. +- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the + sensor. Defaults to ``60s``. + +See Also +-------- + +- :ref:`sensor-filters` +- :ghedit:`Edit` diff --git a/images/max9611.jpg b/images/max9611.jpg new file mode 100644 index 000000000..f82413301 Binary files /dev/null and b/images/max9611.jpg differ diff --git a/index.rst b/index.rst index 71afdd990..d16eeef0b 100644 --- a/index.rst +++ b/index.rst @@ -263,6 +263,7 @@ Electricity INA226, components/sensor/ina226, ina226.jpg, DC Current & Power INA260, components/sensor/ina260, ina260.jpg, DC Current & Power INA3221, components/sensor/ina3221, ina3221.jpg, 3-Ch DC current + MAX9611, components/sensor/max9611, max9611.jpg, +60VDC Voltage & Current & Power & Temperature PZEM AC, components/sensor/pzemac, pzem-ac.jpg, Voltage & Current & Power PZEM DC, components/sensor/pzemdc, pzem-dc.jpg, Voltage & Current & Power PZEM004T, components/sensor/pzem004t, pzem004t.svg, Voltage & Current & Power