esphome-docs/esphomeyaml/components/dallas.rst

40 lines
1.3 KiB
ReStructuredText
Raw Normal View History

2018-05-13 11:37:02 +02:00
Dallas Temperature Component
============================
The ``dallas`` component allows you to use your
`DS18b20 <https://www.adafruit.com/product/374>`__
(`datasheet <https://datasheets.maximintegrated.com/en/ds/DS18B20.pdf>`__)
2018-06-01 18:10:00 +02:00
and similar One-Wire temperature sensors.
2018-05-13 11:37:02 +02:00
To use your dallas sensor, first define a dallas “hub” with a pin and
id, which you will later use to create the sensors. The 1-Wire bus the
sensors are connected to should have an external pullup resistor of
about 4.7KΩ.
.. code:: yaml
# Example configuration entry
dallas:
2018-06-01 18:10:00 +02:00
- pin: 23
2018-05-13 11:37:02 +02:00
# Individual sensors
sensor:
- platform: dallas
address: 0x1c0000031edd2a28
name: "Livingroom Temperature"
Configuration variables:
~~~~~~~~~~~~~~~~~~~~~~~~
2018-06-01 18:10:00 +02:00
- **pin** (**Required**, number): The pin the sensor bus is connected to.
- **update_interval** (*Optional*, :ref:`config-time`): The interval that the sensors should be checked.
2018-06-01 18:44:15 +02:00
Defaults to 15 seconds. See :ref:`sensor-default_filter`.
2018-06-01 18:10:00 +02:00
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
See Also
^^^^^^^^
- :doc:`sensor/dallas`
- :doc:`API Reference </api/sensor/dallas>`
2018-06-03 12:50:44 +02:00
- `Edit this page on GitHub <https://github.com/OttoWinter/esphomedocs/blob/master/esphomeyaml/components/dallas.rst>`__