MAX31855 K-Type Thermocouple Temperature Sensor
===============================================

.. seo::
    :description: Instructions for setting up MAX31855 Thermocouple temperature sensors.
    :image: max31855.jpg

The ``max31855`` temperature sensor allows you to use your MAX31855 thermocouple
temperature sensor (`datasheet <https://datasheets.maximintegrated.com/en/ds/MAX31855.pdf>`__) with ESPHome

As the communication with the MAX31855 is done using SPI, you need
to have an :ref:`SPI bus <spi>` in your configuration with the **miso_pin** set (MOSI is not required).

Connect ``GND`` to ``GND``, ``VCC`` to ``3.3V`` and the other three ``MISO`` (or ``SO`` for short),
``CS`` and ``CLOCK`` (or ``CLK``) to free GPIO pins.

.. figure:: images/temperature.png
    :align: center
    :width: 80.0%

.. code:: yaml

    # Example configuration entry
    spi:
      miso_pin: D0
      clk_pin: D1

    sensor:
      - platform: max31855
        name: "Living Room Temperature"
        cs_pin: D2
        update_interval: 60s

Configuration variables:
------------------------

- **name** (**Required**, string): The name for the temperature sensor.
- **cs_pin** (*Optional*, :ref:`Pin Schema <config-pin_schema>`): The pin on the ESP that that the CS line is connected to.
  The CS line can be connected to GND if this is the only device on the SPI bus.
- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``.
- **reference_temperature** (*Optional*, :ref:`Sensor <config-sensor>`): Access the internal temperature sensor of the MAX31855. Requires a **name** and/or **id**.
- **spi_id** (*Optional*, :ref:`config-id`): Manually specify the ID of the :ref:`SPI Component <spi>` if you want to use multiple SPI buses.
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- All other options from :ref:`Sensor <config-sensor>`.

See Also
--------

- :ref:`sensor-filters`
- :doc:`dallas`
- :doc:`dht`
- :doc:`adc`
- :doc:`max6675`
- :doc:`max31865`
- `MAX31855 Library <https://github.com/adafruit/Adafruit-MAX31855-library>`__ by `Adafruit <https://www.adafruit.com/>`__
- :apiref:`max31855/max31855.h`
- :ghedit:`Edit`