mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-06-27 10:44:57 +02:00
69 lines
2.3 KiB
ReStructuredText
69 lines
2.3 KiB
ReStructuredText
|
ADS1115 Sensor
|
||
|
==============
|
||
|
|
||
|
The ``ads1115`` sensor allows you to use your ADS1115 sigma-delta ADC
|
||
|
sensors (`datasheet <http://www.ti.com/lit/ds/symlink/ads1115.pdf>`__,
|
||
|
`adafruit <https://www.adafruit.com/product/1085>`__) with esphomelib.
|
||
|
First, setup a `ADS1115 Hub </esphomeyaml/components/ads1115.html>`__ for your ADS1115 sensor and then use this
|
||
|
sensor platform to create individual sensors that will report the
|
||
|
voltage to Home Assistant.
|
||
|
|
||
|
.. figure:: /esphomeyaml/components/sensor/ads1115-full.jpg
|
||
|
:align: center
|
||
|
:target: `Adafruit`_
|
||
|
:width: 50.0%
|
||
|
|
||
|
ADS1115 16-Bit ADC. Image by `Adafruit`_.
|
||
|
|
||
|
.. _Adafruit: https://www.adafruit.com/product/1085
|
||
|
|
||
|
|image0|
|
||
|
|
||
|
.. |image0| image:: /esphomeyaml/components/sensor/adc.png
|
||
|
:class: align-center
|
||
|
:width: 80.0%
|
||
|
|
||
|
.. code:: yaml
|
||
|
|
||
|
ads1115:
|
||
|
- address: 0x48
|
||
|
sensor:
|
||
|
- platform: ads1115
|
||
|
multiplexer: 'A0_A1'
|
||
|
gain: 1.024
|
||
|
name: "Living Room Brightness"
|
||
|
|
||
|
Configuration variables:
|
||
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
||
|
|
||
|
- **multiplexer** (**Required**): The multiplexer channel of this sensor. Effectively means between which pins you want to measure voltage.
|
||
|
- **gain** (**Required**, float): The gain of this sensor.
|
||
|
- **name** (**Required**, string): The name for this sensor.
|
||
|
- **ads1115_id** (*Optional*, `id </esphomeyaml/configuration-types.html#id>`__): Manually specify the ID of the `ADS1115 Hub </esphomeyaml/components/ads1115.html>`__ you want to use this sensor.
|
||
|
- **id** (*Optional*, `id </esphomeyaml/configuration-types.html#id>`__): Manually specify
|
||
|
the ID used for code generation.
|
||
|
|
||
|
Multiplexer And Gain
|
||
|
~~~~~~~~~~~~~~~~~~~~
|
||
|
|
||
|
The ADS1115 has a multiplexer that can be configured to measure voltage between several pin configurations. These are:
|
||
|
|
||
|
- `A0_A1` (between Pin 0 and Pin 1)
|
||
|
- `A0_A3` (between Pin 0 and Pin 3)
|
||
|
- `A1_A3` (between Pin 1 and Pin 3)
|
||
|
- `A2_A3` (between Pin 2 and Pin 3)
|
||
|
- `A0_GND` (between Pin 0 and GND)
|
||
|
- `A1_GND` (between Pin 1 and GND)
|
||
|
- `A2_GND` (between Pin 2 and GND)
|
||
|
- `A3_GND` (between Pin 3 and GND)
|
||
|
|
||
|
Additionally, the ADS1115 has a Programmable Gain Amplifier (PGA) that can help you measure voltages in different ranges, these are:
|
||
|
|
||
|
- `6.144` (measures up to 6.144V)
|
||
|
- `4.096` (measures up to 4.096V)
|
||
|
- `2.048` (measures up to 2.048V)
|
||
|
- `1.024` (measures up to 1.024V)
|
||
|
- `0.512` (measures up to 0.512V)
|
||
|
- `0.256` (measures up to 0.256V)
|
||
|
|