This is a custom component to support a Pixie LED controller in Home Assistant.

https://www.tindie.com/products/iothus14/pixie-led-controller/

Requires Home Assistant 2021.12.0 or newer.

Find the Pixie integration in HACS and install it. If you haven't installed HACS, please, go get it at https://hacs.xyz/ and go through the installation and configuration. Restart Home Assistant and install the new integration through Configuration -> Integrations in HA (see the details below).

Copy the sub-path /custom_components/pixie of this repo into the path /config/custom_components/pixie of your HA installation. The next step is to create a pixie entity in configuration.yaml.

Every pixie device has its own unique ID which will be used to configure the device in Home Assistant. A Pixie controller has 4 independent hardware channels to controll addressable LED strips. Every channel can be configured separately.

A pixie configuration can be added manually to the configuration.yaml file like this:

light:
  - platform: pixie
    name: "My Pixie Light"
    device_id: abcdef
    channel: 0

Configuration variables:

This describes how to configure a pixie device vie Home Assistant Integration:

1. Open "Configuration" -> "Integration" in your Home Assistant instance.
2. Click the button "+ADD INTEGRATION".
3. In the window "Set up a new integration" type Pixie and run the configuration process by clicking on the found item of the list "Pixie LED Controller".
4. Type the pixie unique ID and select a channel of the device to configure.
5. Press "Ok". If the input data is correct the integration will create a light entity with a default name light.pixie_abcdef_0 where abcdef is the unique id of the controller. The number at the endd is the channel number.

The integration brings a several services which can be also found in "Developer Tools" -> "Services":

• pixie.set_effect - run an animation effect with parameters.
• pixie.set_picture - run a static effect with parameters.
• pixie.turn_on_transition - turn on the LED strip with any supported transition
• pixie.turn_off_transition - turn off the LED strip with any supported transition

All services can be used in any automation or script. Please check the service details below.

This service runs an animation effect on the LED strip.

Here is an example to run the "Comet" animation effect.

service: pixie.set_effect
data:
  entity_id: light.pixie_abcdef_0
  effect: "Comet"
  parameter1: 128
  parameter2: 200
  color: [255,0,0]
  brightness: 200

This service runs a random animation effect on the LED strip.

This service runs a static effect on the LED strip.

This example show how to display a static effect. In this case it runs "Rainbow" on the LED strip.

service: pixie.set_pixture
data:
  entity_id: light.pixie_abcdef_0
  picture: "Rainbow"
  parameter1: 200
  parameter2: 120
  brightness: 200

This service is very similar to light.turn_on which can be also used with a pixie device but pixie.turn_on_transition has extra parameters allowing to turn on the LED strip with the supported transitions and parameters to adjust them.

Here is an example to turn on the light light.pixie_abcdef_0 with the RGB color [128, 255, 0] for 30 seconds with a transition effect "SinIn"

service: pixie.turn_on_transition
data:
  entity_id: light.pixie_abcdef_0
  transition_name: "SinIn"
  transition: 30
  brightness: 200
  color: [128, 255, 0]

This service is very similar to light.turn_off which can be also used with a pixie device but pixie.turn_off_transition has extra parameters allowing to turn off the LED strip with the supported transitions and parameters to adjust them.

Here is an example to turn off the light light.pixie_abcdef_0 for 30 seconds with a transition effect "SinOut"

service: pixie.turn_off_transition
data:
  entity_id: light.pixie_abcdef_0
  transition_name: "SinOut"
  transition: 5

Please check the documentation for all supported animations, pictures and transitions.

(since verion 0.3.0) The service checks if there is an available firmware update. If there is a new firware version available Home Assistant will provide a possibility to perform the update directly in Home Assistant UI.

All sensor entities described below are disabled by default and can be enabled if needed. The integration brings two extra sensors:

• board temperature (The defailt entity id: sensor.pixie_abcdef_n_board_temperature)
• uptime (The defailt entity id: sensor.pixie_abcdef_n_uptime)

Here above abcdef is a unique id your the pixie device, n - the number of the channel

All select entities described below are disabled by default and can be enabled if needed. The integration brings two select entities:

• The list of the supported animation effects (The defailt entity id: select.pixie_abcdef_n_effect)
• The list of the supported pictures. (The defailt entity id: select.pixie_abcdef_n_picture)

Here above abcdef is a unique id your the pixie device, n - the number of the channel