3.4 KiB
title, description, ha_category, ha_iot_class, ha_release, ha_domain, ha_codeowners, ha_platforms
| title | description | ha_category | ha_iot_class | ha_release | ha_domain | ha_codeowners | ha_platforms | |||
|---|---|---|---|---|---|---|---|---|---|---|
| pigpio Daemon PWM LED | Instructions on how to setup PWM LEDs within Home Assistant. |
|
Local Push | 0.43 | 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 (same host or remote) 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).
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
frequency:
description: The PWM frequency.
required: false
default: 200
type: integer
address:
description: The address of the PCA9685 driver.
required: false
default: 0x40
type: string
host:
description: The remote host address for the GPIO driver.
required: false
type: string
{% endconfiguration %}
Examples
In this section you find some real-life examples of how to use this sensor.
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
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
RGB LED connected to the GPIO pins of an remote Raspberry Pi.
On the Raspberry Pi the pigpio daemon is running on the default port 6666.
# Example configuration.yaml entry
light:
- platform: rpi_gpio_pwm
leds:
- name: Lightstrip Sideboard
driver: gpio
host: 192.168.0.66