mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-09-17 02:44:36 +02:00
76 lines
2.5 KiB
ReStructuredText
76 lines
2.5 KiB
ReStructuredText
Dallas Temperature Sensor
|
||
=========================
|
||
|
||
The ``dallas`` sensor allows you to define sensors for you :doc:`dallas sensor hub </esphomeyaml/components/dallas>`.
|
||
|
||
To initialize a sensor, first supply either ``address`` **or** ``index`` to identify the sensor.
|
||
|
||
.. figure:: images/ds18b20-full.jpg
|
||
:align: center
|
||
:target: `Adafruit`_
|
||
:width: 50.0%
|
||
|
||
DS18b20 One-Wire Temperature Sensor. Image by `Adafruit`_.
|
||
|
||
.. _Adafruit: https://www.adafruit.com/product/374
|
||
|
||
.. figure:: images/temperature.png
|
||
:align: center
|
||
:width: 80.0%
|
||
|
||
.. code:: yaml
|
||
|
||
# Example configuration entry
|
||
dallas:
|
||
- id: dallas_hub1
|
||
pin: 23
|
||
|
||
# Individual sensors
|
||
sensor:
|
||
- platform: dallas
|
||
dallas_id: "dallas_hub1"
|
||
address: 0x1C0000031EDD2A28
|
||
index: 0
|
||
name: "Living Room Temperature"
|
||
|
||
Configuration variables:
|
||
~~~~~~~~~~~~~~~~~~~~~~~~
|
||
|
||
- **address** (**Required**, int): The address of the sensor. Use either
|
||
this option or index.
|
||
- **index** (**Required**, int): The index of the sensor starting with 0.
|
||
So the first sensor will for example have index 0. :ref:`It’s recommended
|
||
to use address instead <dallas-getting-ids>`.
|
||
- **resolution** (*Optional*, int): An optional resolution from 8 to
|
||
12. Higher means more accurate. Defaults to the maximum for most dallas temperature sensors: 12.
|
||
- **dallas_id** (*Optional*, :ref:`config-id`): The ID of the :doc:`dallas hub </esphomeyaml/components/dallas>`.
|
||
Use this if you have multiple dallas hubs.
|
||
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
|
||
- All other options from :ref:`Sensor <config-sensor>` and :ref:`MQTT Component <config-mqtt-component>`.
|
||
|
||
.. _dallas-getting-ids:
|
||
|
||
Getting Sensor IDs
|
||
~~~~~~~~~~~~~~~~~~
|
||
|
||
It is highly recommended to use the ``address`` attribute for creating
|
||
dallas sensors, because if you have multiple sensors on a bus and the
|
||
automatic sensor discovery fails, all sensors indices will be shifted by
|
||
one. In order to get the address, simply start the firmware on your
|
||
device with a configured dallas hub and observe the log output (the :ref:`log
|
||
level <logger-log_levels>` must be set to at least
|
||
``debug``!). You will find something like this:
|
||
|
||
.. figure:: images/dallas-log.png
|
||
|
||
Next, individually warm up or cool down the sensors and observe the log
|
||
output to determine which address points to which sensor.
|
||
|
||
See Also
|
||
^^^^^^^^
|
||
|
||
- :ref:`sensor-filters`
|
||
- :doc:`/esphomeyaml/components/dallas`
|
||
- :doc:`max6675`
|
||
- :doc:`API Reference </api/sensor/dallas>`
|