Upstream/esphome-docs
1
0
Fork 0
mirror of https://github.com/esphome/esphome-docs.git synced 2024-09-28 04:17:47 +02:00
Code Issues Projects Releases Wiki Activity

Added documentation in order to use ADS1015 (#2581)

Browse Source 
Co-authored-by: Jesse Hills <3060199+jesserockz@users.noreply.github.com>
This commit is contained in:
WitchKing 2023-01-26 05:21:07 +01:00 committed by GitHub
parent c8fefadfa4
commit a55a071a7c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
components/sensor/ads1115.rst
View File

@ -2,9 +2,9 @@ ADS1115 Sensor
============== ==============
.. seo:: .. seo::
:description: Instructions for setting up ADS1115 multiplexed analog voltage sensors. :description: Instructions for setting up ADS1115/ADS1015 multiplexed analog voltage sensors.
:image: ads1115.jpg :image: ads1115.jpg
:keywords: ADS1115 :keywords: ADS1115 ADS1015
.. _ads1115-component: .. _ads1115-component:
@ -21,7 +21,9 @@ To use this hub, first setup the :ref:`I²C Bus <i2c>` and connect the sensor to
ADS1115 16-Bit ADC. ADS1115 16-Bit ADC.
.. _Adafruit: https://www.adafruit.com/product/1085 .. _Adafruit_ADS1115: https://www.adafruit.com/product/1085
.. _Adafruit_ADS1015: https://www.adafruit.com/product/1083
.. code-block:: yaml .. code-block:: yaml
@ -59,7 +61,7 @@ Sensor
------ ------
The ``ads1115`` sensor allows you to use your ADS1115 sigma-delta ADC The ``ads1115`` sensor allows you to use your ADS1115 sigma-delta ADC
sensors (`datasheet <http://www.ti.com/lit/ds/symlink/ads1115.pdf>`__, `Adafruit`_) with ESPHome. sensors (`datasheet <http://www.ti.com/lit/ds/symlink/ads1115.pdf>`__, `Adafruit_ADS1115`_) or your ADS1015 sigma-delta ADC sensors (`datasheet <http://www.ti.com/lit/ds/symlink/ads1015.pdf>`__, `Adafruit_ADS1015`_) with ESPHome.
First, setup an :ref:`ADS1115 Hub <ads1115-component>` for your ADS1115 sensor and then use this First, setup an :ref:`ADS1115 Hub <ads1115-component>` for your ADS1115 sensor and then use this
sensor platform to create individual sensors that will report the sensor platform to create individual sensors that will report the
voltage to Home Assistant. voltage to Home Assistant.
@ -92,6 +94,11 @@ Configuration variables:
- **update_interval** (*Optional*, :ref:`config-time`): The interval - **update_interval** (*Optional*, :ref:`config-time`): The interval
to check the sensor. Defaults to ``60s``. to check the sensor. Defaults to ``60s``.
- **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation. - **id** (*Optional*, :ref:`config-id`): Manually specify the ID used for code generation.
- **resolution** (*Optional*, string): the resolution of this sensor. Defaults to ``16 bits``.
- **16 bits**
- **12 bits**
Multiplexer and Gain Multiplexer and Gain
-------------------- --------------------
@ -121,7 +128,11 @@ Additionally, the ADS1115 has a Programmable Gain Amplifier (PGA) that can help
- ``1.024`` (measures up to 1.024V) - ``1.024`` (measures up to 1.024V)
- ``0.512`` (measures up to 0.512V) - ``0.512`` (measures up to 0.512V)
- ``0.256`` (measures up to 0.256V) - ``0.256`` (measures up to 0.256V)
The ADS1115 can be used with defaults settings.
When using an ADS1015, the resolution has to be specified and should be defined to ``12_BITS``
(or equivalent notations like ``12 BITS`` or ``12 bits``).
See Also See Also
-------- --------