PCA9685 PWM Output
==================

.. seo::
    :description: Instructions for setting up PCA9685 PWM controller outputs.
    :image: pca9685.jpg

The PCA9685 output component exposes a PCA9685 PWM channel of a global
:doc:`PCA9685 hub </esphomeyaml/components/pca9685>` as a float
output.

.. figure:: images/pca9685-full.jpg
    :align: center
    :width: 75.0%

    PCA9685 16-Channel PWM Driver.

.. code:: yaml

    # Example configuration entry
    pca9685:
      - frequency: 500

    # Individual outputs
    output:
      - platform: pca9685
        id: 'pca9685_output1'
        channel: 0

Configuration variables:
------------------------

- **id** (**Required**, :ref:`config-id`): The id to use for this output component.
- **channel** (**Required**, int): Chose the channel of the PCA9685 of
  this output component. Must be in range from 0 to 15.
- **pca9685_id** (*Optional*, :ref:`config-id`): Manually specify the ID of the
  :doc:`PCA9685 hub </esphomeyaml/components/pca9685>`.
  Use this if you have multiple PCA9685s you want to use at the same time.
- All other options from :ref:`Output <config-output>`.

See Also
--------

- :doc:`/esphomeyaml/components/pca9685`
- :doc:`/esphomeyaml/components/output/index`
- :doc:`/esphomeyaml/components/output/esp8266_pwm`
- :doc:`/esphomeyaml/components/output/ledc`
- :doc:`/esphomeyaml/components/light/monochromatic`
- :doc:`/esphomeyaml/components/fan/speed`
- :doc:`/esphomeyaml/components/power_supply`
- :doc:`API Reference </api/output/pca9685>`
- `PCA9685 Arduino Library <https://github.com/NachtRaveVL/PCA9685-Arduino>`__ by `@NachtRaveVL <https://github.com/NachtRaveVL>`__
- `Edit this page on GitHub <https://github.com/OttoWinter/esphomedocs/blob/current/esphomeyaml/components/output/pca9685.rst>`__

.. disqus::