home-assistant.io/source/_components/light.rpi_gpio_pwm.markdown
Sören Oldag 43e3b56ae9 Add docs for pwm led platform. (#2402)
* Add docs for pwm led platform.

* Renamed pwm platform to rpi_gpio_pwm.
2017-04-21 09:03:15 -07:00

1.6 KiB

layout, title, description, date, sidebar, layout, comments, sharing, footer, ha_category, ha_iot_class, ha_release
layout title description date sidebar layout comments sharing footer ha_category ha_iot_class ha_release
page PWM LED Instructions on how to setup pwm leds within Home Assistant. 2017-04-04 13:00 true page false true true Light Local Push 0.43

The rpi_gpio_pwm platform allows to control multiple lights using pulse-width modulation, for example led strips. It supports one-color, RGB and RGBW leds driven by GPIOs of an Raspberry Pi or a PCA9685 controller.

{% linkable_title Configuration %}

# Example configuration.yaml entry
light:
  platform: rpi_gpio_pwm
  leds:
    # One-color led directly connected to GPIO
    - name: Lightstrip Cupboard
      driver: gpio
      pins: [17]
      type: simple
    # RGB led connected to PCA9685 controller
    - name: TV Backlight
      driver: pca9685
      pins: [0, 1, 2] # [R, G, B]
      type: rgb
    # RGBW led connected to PCA9685 controller
    - name: Lightstrip Desk
      driver: pca9685
      pins: [3, 4, 5, 6] # [R, G, B, W]
      type: rgbw

Configuration variables:

  • leds array (Required):
    • name (Required): The name of the led.
    • driver (Required): The driver, which controls the led. Choose either gpio or pca9685.
    • pins (Required): The pins connected to the led. The order of pins is determined by the specified type.
    • type (Required): The type of led. Choose either rgb, rgbw or simple.
    • freq (Optional): The PWM frequency. (Default: 200)
    • address (Optional): The address of the PCA9685 driver. (Default: 0x40)