jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-06-23 02:26:51 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_integrations/flux_led.markdown
Franck Nijhof a5cd7fc19b
Merge branch 'current' into next
2022-01-23 20:11:56 +01:00

12 KiB
Raw Blame History

title, description, ha_category, ha_iot_class, ha_release, ha_domain, ha_platforms, ha_codeowners, ha_quality_scale, ha_config_flow, ha_dhcp
title description ha_category ha_iot_class ha_release ha_domain ha_platforms ha_codeowners ha_quality_scale ha_config_flow ha_dhcp
Magic Home Instructions on how to setup Magic Home within Home Assistant.
Button
Light
Number
Select
Sensor
Switch
Local Push 0.25 flux_led
button
light
number
select
sensor
switch
@icemanch
platinum true true

The Magic Home integration supports several brands of switches, bulbs, and controllers that use the same protocol. Chances are high that your bulb or controller (eg. WiFi LED CONTROLLER) will work with this integration if you can control the device with the Magic Home app.

This integration will provide local control over your LED lights/strips and can be configured to auto-scan your network for controllers or for you to manually configure individual lights by their IP address.

Example of bulbs:

Examples of controllers with strips:

Examples of controllers:

Examples of addressable controllers:

These devices have been sold under at least the following brands:

{% include integrations/config_flow.md %}

After the devices have been added they can be configured with different effects listed below. These settings can be accessed by navigating to the integration settings in Configuration -> Integrations and selecting the "Magic Home" configuration for the bulb or controller.

Custom Effect
A list of RGB colors can be entered to create an effect. The effect speed can be adjusted using the slider underneath.

Custom Effect Type
This determines the transition between each color.

Supported Models

The following models have been tested with integration.

Model Description Notes
0x01 Legacy RGB Controller Original protocol
0x03 Legacy CCT Controller Original protocol
0x04 UFO Controller RGBW
0x06 Controller RGBW
0x07 Controller RGBCW
0x08 Controller RGB with MIC
0x0E Floor Lamp RGBCW
0x10 Christmas Light
0x1A Christmas Light
0x1C Table Light CCT
0x21 Bulb Dimmable
0x25 Controller RGB/WW/CW Supports RGB,RGBW,RGBWW,CW,DIM
0x33 Controller RGB
0x35 Bulb RGBCW
0x41 Controller Dimmable
0x44 Bulb RGBW
0x52 Bulb CCT
0x54 Downlight RGBW
0x93 Switch 1c
0x94 Switch 1c Watt
0x97 Socket 1c
0xA1 Addressable v1
0xA2 Addressable v2
0xA3 Addressable v3

Unsupported Models

The following models have not been tested with integration but may work.

Model Description Notes
0x02 Legacy Dimmable Controller Original protocol
0x09 Ceiling Light CCT
0x16 Magnetic Light CCT
0x17 Magnetic Light Dimmable
0x19 Socket 2 USB
0x18 Plant Light
0x1B Spray Light
0x1E Ceiling Light RGBCW Probably works & same as 0x35
0x62 Controller CCT May be discontinued
0x95 Switch 2c
0x96 Switch 4c
0xD1 Digital Light
0xE1 Ceiling Light
0xE2 Ceiling Light Assist
0xA4 Addressable v4 Probably works & same as 0xA3
0xA6 Addressable v6 Probably works & same as 0xA3

Effects

The Magic Home light offers a number of effects which are not included in other lighting packages. These can be selected from the front-end, or sent in the effect field of the light.turn_on command.

Effect Name Description
colorloop Smoothly transitions through the rainbow.
colorjump Jumps through seven different rainbow colors.
colorstrobe Strobes each rainbow color in a loop.
red_fade, green_fade, blue_fade, yellow_fade, cyan_fade, purple_fade, white_fade Fades between the color as indicated in the effect name and black.
rg_cross_fade Fades between red and green.
rb_cross_fade Fades between red and blue.
gb_cross_fade Fades between green and blue.
red_strobe, green_strobe, blue_strobe, yellow_strobe, cyan_strobe, purple_strobe, white_strobe Strobes the color indicated by the effect name.
random Chooses a random color by selecting random values for R, G, and B.

Custom Effects - Service flux_led.set_custom_effect

The integration offers a custom service to enable you to set the lights to a custom light effect.

Service data attribute Description
entity_id The entity_id of the LED light to set the effect on.
colors List of RGB colors to transition between in your effect. (Max 16, Required)
speed_pct The speed of the effect in % (0-100. Default 50)
transition The transition effect you would like. Valid options are gradual, jump, or strobe. (Default gradual) 
#Example Service Call
entity_id: light.led_strip
colors:
  - [255,0,0]
  - [0,255,0]
  - [0,0,255]
speed_pct: 80
transition: "jump"

Set Zones - Service flux_led.set_zones

The Addressable v3 (0xA3) models allow setting a color effect per zone. The length of each zone is the number of pixels per segment divided by the number of colors. If the device is turned off, setting the zones will not turn it on. A separate call to light.turn_on is needed to turn on the device.

Service data attribute Description
entity_id The entity_id of the LED light to set the effect on.
colors List of colors for each zone (RGB). (Max 2048 Colors)
speed_pct The speed of the effect in % (0-100. Default 50)
effect The effect you would like. Valid options are static, running_water, strobe, jump, or breathing. (Default static) 
#Example Service Call
service: flux_led.set_zones
target:
  entity_id:
    - light.addressable_v3_8e2f7f
    - light.addressable_v3_8ebdeb
data:
  colors:
    - [255, 0, 0]
    - [0, 255, 0]
    - [0, 0, 255]
    - [255, 255, 255]
  speed_pct: 80

Set Music Mode - Service flux_led.set_music_mode

The RGB with MIC (0x08), Addressable v2 (0xA2), and Addressable v3 (0xA3) models have a built-in microphone that have multiple music mode settings.

Service data attribute Description
entity_id The entity_id of the LED light to set the effect on.
sensitivity Microphone sensitivity (0-100)
brightness Light brightness (0-100)
light_screen Light screen mode for 2 dimensional pixels (Addressable models only)
effect Effect (1-16 on Addressable models, 0-3 on RGB with MIC models)
foreground_color The foreground RGB color
background_color The background RGB color (Addressable models only) 
#Example Service Call
service: flux_led.set_music_mode
target:
  entity_id:
    - light.addressable_v3_8e2f7f
    - light.addressable_v3_8ebdeb
data:
  sensitivity: 100
  brightness: 100
  effect: 2
  light_screen: false
  background_color: [0, 255, 0]
  foreground_color: [255, 0, 0]