esphome-docs/esphomeyaml/components/sensor/dallas.rst

109 lines
3.7 KiB
ReStructuredText
Raw Normal View History

2018-05-13 11:37:02 +02:00
Dallas Temperature Sensor
=========================
2018-06-03 21:58:32 +02:00
The ``dallas`` sensor allows you to use ds18b20 and similar sensors.
First, you need to define a :doc:`dallas sensor component </esphomeyaml/components/dallas>`.
The dallas sensor component (or "hub") is an internal model that defines which pins the ds18b20
sensors are connected to. This is because with these sensors you can actually connect multiple
sensors to a single pin and use them all at once.
2018-05-13 11:37:02 +02:00
2018-06-01 18:10:00 +02:00
To initialize a sensor, first supply either ``address`` **or** ``index`` to identify the sensor.
2018-05-13 11:37:02 +02:00
2018-06-01 18:10:00 +02:00
.. figure:: images/ds18b20-full.jpg
:align: center
:target: `Adafruit`_
:width: 50.0%
2018-05-13 11:37:02 +02:00
2018-06-01 18:10:00 +02:00
DS18b20 One-Wire Temperature Sensor. Image by `Adafruit`_.
2018-05-13 11:37:02 +02:00
.. _Adafruit: https://www.adafruit.com/product/374
2018-06-01 18:10:00 +02:00
.. figure:: images/temperature.png
:align: center
:width: 80.0%
2018-05-13 11:37:02 +02:00
.. code:: yaml
# Example configuration entry
dallas:
2018-06-03 21:58:32 +02:00
- pin: GPIO23
2018-05-13 11:37:02 +02:00
# Individual sensors
sensor:
- platform: dallas
address: 0x1C0000031EDD2A28
name: "Living Room Temperature"
Configuration variables:
~~~~~~~~~~~~~~~~~~~~~~~~
2018-06-01 18:10:00 +02:00
- **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:`Its 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:
2018-05-13 11:37:02 +02:00
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
2018-06-01 18:10:00 +02:00
device with a configured dallas hub and observe the log output (the :ref:`log
level <logger-log_levels>` must be set to at least
2018-06-03 21:58:32 +02:00
``debug``!). Note that you don't need to define the individual sensors just yet, as
the scanning will happen even with no sensors connected. For example with this configuration:
.. code:: yaml
# Example configuration entry
dallas:
- pin: GPIO23
2018-06-05 21:07:47 +02:00
# Note you don't have to add any sensors at this point
2018-06-03 21:58:32 +02:00
You will find something like this:
2018-05-13 11:37:02 +02:00
2018-06-01 18:10:00 +02:00
.. figure:: images/dallas-log.png
2018-05-13 11:37:02 +02:00
2018-06-03 21:58:32 +02:00
Now we can add the individual sensors to our configuration:
.. code:: yaml
# Example configuration entry
dallas:
- pin: GPIO23
sensor:
- platform: dallas
address: 0xA40000031F055028
name: "Temperature #1"
- platform: dallas
address: 0xDD0000031EFB0428
name: "Temperature #2"
- platform: dallas
# ...
Next, individually warm up or cool down the sensors and observe the log again.
You will see the outputted sensor values changing when they're being warmed.
When you're finished mapping each address to a name, just change the ``Temperature #1``
to your assigned names and you should be ready.
2018-05-13 11:37:02 +02:00
2018-06-01 18:10:00 +02:00
See Also
^^^^^^^^
2018-05-13 11:37:02 +02:00
2018-06-01 18:10:00 +02:00
- :ref:`sensor-filters`
- :doc:`/esphomeyaml/components/dallas`
- :doc:`max6675`
- :doc:`API Reference </api/sensor/dallas>`
2018-06-04 08:17:22 +02:00
- `Edit this page on GitHub <https://github.com/OttoWinter/esphomedocs/blob/current/esphomeyaml/components/sensor/dallas.rst>`__