mirror of
https://github.com/esphome/esphome-docs.git
synced 2024-11-10 10:11:29 +01:00
67 lines
2.2 KiB
ReStructuredText
67 lines
2.2 KiB
ReStructuredText
|
ADC128S102 8-Channel 12-Bit A/D Converter
|
||
|
|
==========================================
|
||
|
|
|
||
|
|
.. seo::
|
||
|
|
:description: Instructions for setting up ADC128S102 12 Bit Analog to Digital Converter in ESPHome.
|
||
|
|
:keywords: ADC128S102
|
||
|
|
:image: adc128s102.png
|
||
|
|
|
||
|
|
The ADC128S102 is a low-power, eight-channel CMOS 12-bit analog-to-digital converter specified for conversion
|
||
|
|
throughput rates of 500 ksps to 1 MSPS. The converter is based on a successive-approximation register architecture
|
||
|
|
with an internal track-and-hold circuit.
|
||
|
|
|
||
|
|
.. figure:: images/adc128s102.png
|
||
|
|
:align: center
|
||
|
|
:width: 50.0%
|
||
|
|
|
||
|
|
.. _adc128s102-component:
|
||
|
|
|
||
|
|
Component/Hub
|
||
|
|
-------------
|
||
|
|
|
||
|
|
The ADC128S102 component allows you to use ADC128S102 8-Channel 12-Bit A/D Converter
|
||
|
|
(`datasheet <https://www.ti.com/lit/ds/symlink/adc128s102.pdf>`__,
|
||
|
|
`Texas Instruments <https://www.ti.com/product/ADC128S102>`__) in ESPHome.
|
||
|
|
It uses the :ref:`SPI Bus <spi>` for communication.
|
||
|
|
|
||
|
|
Once configured, you can use any of the 8 pins as
|
||
|
|
sensors for your projects.
|
||
|
|
|
||
|
|
.. code-block:: yaml
|
||
|
|
|
||
|
|
# Example configuration entry
|
||
|
|
adc128s102:
|
||
|
|
cs_pin: GPIO15
|
||
|
|
id: my_adc
|
||
|
|
|
||
|
|
sensor:
|
||
|
|
- platform: adc128s102 # Attached to pin 0 of the ADC128S102.
|
||
|
|
update_interval: 1s
|
||
|
|
adc128s102_id: my_adc
|
||
|
|
id: freezer_temp_source
|
||
|
|
channel: 0 # ADC128S102 channel
|
||
|
|
|
||
|
|
Configuration variables:
|
||
|
|
- **id** (**Required**, :ref:`config-id`): The id to use for this ADC128S102 component.
|
||
|
|
- **cs_pin** (**Required**, int): The SPI cable select pin to use
|
||
|
|
|
||
|
|
Sensor
|
||
|
|
------
|
||
|
|
|
||
|
|
The ``adc128s102`` sensor allows you to use your ADC128S102 12-Bit A/D Converter sensors with ESPHome.
|
||
|
|
First, setup a :ref:`ADC128S102 Hub <adc128s102-component>` for your ADC128S102 sensor and then use this
|
||
|
|
sensor platform to create individual sensors that will report the voltage to Home Assistant.
|
||
|
|
|
||
|
|
Configuration variables:
|
||
|
|
|
||
|
|
- **adc128s102_id** (**Required**, :ref:`config-id`): The id of the parent ADC128S102 component.
|
||
|
|
- **channel** (**Required**, int): The channel of the ADC128S102 to use.
|
||
|
|
- **update_interval** (*Optional*, :ref:`config-time`): The interval to check the sensor. Defaults to ``60s``.
|
||
|
|
|
||
|
|
See Also
|
||
|
|
--------
|
||
|
|
|
||
|
|
- :ref:`spi`
|
||
|
|
- :apiref:`adc128s102/adc128s102.h`
|
||
|
|
- :ghedit:`Edit`
|