esphome-docs/components/tca9548a.rst
Andreas Hergert d48c9e800e
Add i2c multiplexer (#897)
* added doc

* tidy

* tidy

* tidy

* tidy again

* argh tidy

* Bump version to v1.15.2

Conflicts:
	Doxygen
	Makefile
	_static/version
	conf.py

* rezised images

Co-authored-by: Andreas Hergert <andreas.hergert@otrs.com>
2021-03-29 16:50:43 -03:00

55 lines
1.4 KiB
ReStructuredText

TCA9548A I²C Multiplexer
========================
.. seo::
:description: Instructions for setting up TCA9548A I²C multiplexer in ESPHome.
:image: tca9548a.jpg
The TCA9548A component allows you to use TCA9548A as a I²C multiplexer
(`datasheet <https://www.ti.com/lit/ds/symlink/tca9548a.pdf>`__,
`AdaFruit`_) in ESPHome. It uses :ref:`I²C Bus <i2c>` for communication.
Once configured, you can use any of the 8 channels (TCA9548A) as seperated channels for your projects.
.. figure:: images/tca9548a.jpg
:align: center
:width: 80.0%
tca9548a I2C Multiplexer.
.. _AdaFruit: https://learn.adafruit.com/adafruit-tca9548a-1-to-8-i2c-multiplexer-breakout
.. code-block:: yaml
# Example configuration entry
tca9548a:
- address: 0x70
id: multiplex0
i2c_id: i2c0
scan: True
# Individual I2C Devices
sensor:
- platform: bmp280
multiplexer:
id: multiplex0
channel: 0
...
Configuration variables:
~~~~~~~~~~~~~~~~~~~~~~~~
- **id** (**Required**, :ref:`config-id`): The id to use for this TCA9548A component.
- **address** (*Optional*, int): The I²C address of the Multiplexer.
Defaults to ``0x70``.
- **i2c_id** (*Optional*): The I²C Bus ID
- **scan** (*Optional*, bool): if the channel should be scanned
Defaults to ``false``
See Also
--------
- :ref:`i2c`
- :ghedit:`Edit`