mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-12-27 17:37:45 +01:00
43 lines
1.6 KiB
ReStructuredText
43 lines
1.6 KiB
ReStructuredText
Dallas Temperature Sensor
|
|
=========================
|
|
|
|
.. seo::
|
|
:description: Instructions for setting up Dallas 1-Wire temperature sensors
|
|
:image: dallas.jpg
|
|
:keywords: Dallas, ds18b20, onewire
|
|
|
|
The ``dallas_temp`` component allows you to use
|
|
`DS18B20 <https://www.adafruit.com/product/374>`__
|
|
(`datasheet <https://datasheets.maximintegrated.com/en/ds/DS18B20.pdf>`__)
|
|
and similar 1-Wire temperature sensors. A :ref:`1-Wire bus <one_wire>` is
|
|
required to be set up in your configuration for this sensor to work.
|
|
|
|
.. code-block:: yaml
|
|
|
|
# Example configuration entry
|
|
sensor:
|
|
- platform: dallas_temp
|
|
address: 0x1234567812345628
|
|
name: temperature
|
|
update_interval: 120s
|
|
|
|
Configuration variables:
|
|
************************
|
|
|
|
- **address** (*Optional*, int): The address of the sensor. Required if there is more than one device on the bus.
|
|
- **resolution** (*Optional*, int): An optional resolution from 9 to 12. Higher means more accurate.
|
|
Defaults to the maximum for most Dallas temperature sensors: 12.
|
|
- **update_interval** (*Optional*, :ref:`config-time`): The interval that the sensors should be checked.
|
|
Defaults to 60 seconds.
|
|
- **one_wire_id** (*Optional*, :ref:`one_wire`): The ID of the 1-Wire bus to use.
|
|
Required if there is more than one bus.
|
|
- All other options from :ref:`Sensor <config-sensor>`.
|
|
|
|
See Also
|
|
--------
|
|
|
|
- `Arduino DallasTemperature library <https://github.com/milesburton/Arduino-Temperature-Control-Library>`__
|
|
by `Miles Burton <https://github.com/milesburton>`__
|
|
- :apiref:`dallas_temp/dallas_temp.h`
|
|
- :ghedit:`Edit`
|