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

layout, title, description, date, sidebar, layout, comments, sharing, footer, ha_category, ha_iot_class, ha_release, logo

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

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 variables:

• leds array (Required): Can contain multiple LEDs.
  • 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 as a list.. 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)

{% 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