2020-03-12 22:24:48 +01:00
TMP117 Temperature Sensor
=========================
.. seo ::
:description: Instructions for setting up the TMP117 Temperature sensor.
:image: tmp117.jpg
:keywords: TMP117
2021-01-24 10:20:48 +01:00
The TMP117 Temperature sensor allows you to use your TMP117
2020-03-12 22:24:48 +01:00
(`datasheet <https://www.ti.com/lit/ds/symlink/tmp117.pdf> `__ ,
`sparkfun <https://www.sparkfun.com/products/15805> `__ )
sensors with ESPHome.
.. figure :: images/tmp117.jpg
:align: center
:width: 30.0%
TMP117 Temperature Sensor.
(Credit: `Sparkfun <https://www.sparkfun.com/products/15805> `__ , image cropped and compressed)
.. _Sparkfun: https://www.sparkfun.com/products/15805
2020-11-09 02:22:55 +01:00
The TMP117 is a high precision temperature sensor that communicates over I²C. Each sensor is tested on a NIST tracable test setup during Texas Instruments' production process. Accuracy should be at worst 0.1C across the -20C to +50C temperature range.
2020-03-12 22:24:48 +01:00
To use the sensor, first set up an :ref: `I²C Bus <i2c>` and connect the sensor to the specified pins.
If accuracy is a must, see section 8.2.2.2 of the `datasheet <https://www.ti.com/lit/ds/symlink/tmp117.pdf> `__ .
.. code-block :: yaml
# Example configuration entry
sensor:
- platform: tmp117
name: "Living Room Temperature"
update_interval: 60s
2021-02-20 22:02:46 +01:00
Configuration variables:
------------------------
2020-03-12 22:24:48 +01:00
- **address** (*Optional* , int): The I²C address of the sensor.
See :ref: `I²C Addresses <tmp117_i2c_addresses>` for more information.
- **update_interval** (*Optional* , :ref: `config-time` ): The interval to check the sensor. Defaults to `` 60s `` . The sensor component sets the maximum possible averaging in the sensor based on this.
2024-08-14 04:33:05 +02:00
- All other options from :ref: `Sensor <config-sensor>` .
2020-03-12 22:24:48 +01:00
.. _tmp117_i2c_addresses:
I²C Addresses
-------------
In order to allow multiple sensors to be connected to the same I²C bus,
the creators of this sensor hardware have included some options to
change the i²c address.
- If the address pin is pulled to GND, the address is `` 0x48 `` (Default).
- If the address pin is pulled to VCC, the address is `` 0x49 `` .
- If the address pin is tied to SDA, the address is `` 0x4A `` .
- If the address pin is tied to SCL, the address is `` 0x4B `` .
