home-assistant.io/source/_components/rpi_gpio_pwm.markdown

layout	title	description	date	sidebar	comments	sharing	footer	ha_category	ha_iot_class	ha_release	logo	redirect_from
page	PWM LED Light	Instructions on how to setup PWM LEDs within Home Assistant.	2017-04-04 13:00	true	false	true	true	DIY	Local Push	0.43	raspberry-pi.png	/components/light.rpi_gpio_pwm/

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 a Raspberry Pi or a PCA9685 controller.

For controlling the GPIOs, the platform connects to the pigpio-daemon, which must be running. On Raspbian Jessie 2016-05-10 or newer the pigpio library is already included. On other operating systems it needs to be installed first (see installation instructions).

{% linkable_title Configuration %}

To enable this platform, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
light:
  - platform: rpi_gpio_pwm
    leds:
      - name: Lightstrip Cupboard
        driver: gpio
        pins: [17]
        type: simple

{% configuration %} leds: description: Can contain multiple LEDs. required: true type: list keys: name: description: The name of the LED. required: true type: string driver: description: The driver which controls the LED. Choose either gpio or pca9685. required: true type: string pins: description: The pins connected to the LED as a list. The order of pins is determined by the specified type. required: true type: [list, integer] type: description: The type of LED. Choose either rgb, rgbw or simple. required: true type: string freq: description: The PWM frequency. required: false default: 200 type: integer address: description: The address of the PCA9685 driver. required: false default: 0x40 type: string {% endconfiguration %}

{% linkable_title Examples %}

In this section you find some real-life examples of how to use this sensor.

{% linkable_title RGB LED connected to PCA9685 controller %}

This example uses a PCA9685 controller to control a RGB LED.

# Example configuration.yaml entry
light:
  - platform: rpi_gpio_pwm
    leds:
      - name: TV Backlight
        driver: pca9685
        pins: [0, 1, 2] # [R, G, B]
        type: rgb

{% linkable_title RGBW LED connected to PCA9685 controller %}

This example uses a PCA9685 controller to interact with a RGBW LED.

# Example configuration.yaml entry
light:
  - platform: rpi_gpio_pwm
    leds:
      - name: Lightstrip Desk
        driver: pca9685
        pins: [3, 4, 5, 6] # [R, G, B, W]
        type: rgbw