This blueprint and script can set and clear effects as well as configure the LED or LED strip on Inovelli dimmers, switches, and fan / light combo dimmers from the “Black”, “Red 500”, “Red 800”, and “Blue” series. Devices of different types can be called simultaneously. It will accept entities, the device ID, groups, labels, areas (or area: all ), floors (or floor: 'all' ), and find all Inovelli devices in the house. This blueprint and script can set everything at once—even if the devices are different series and being called from different combinations of sources (e.g. 2 areas, and 3 entities).
Supported Inovelli devices:
- Z-Wave:
- Zigbee2MQTT or ZHA:
[2025.04.09] Refactored entity selection code for performance; Z2M topic customization; allowed_domains variable.
[2025.04.09] Individual LED Effects (Red 800 and Blue Series only)
[2025.03.30] Selector Mode and Device filters
[2025.03.18] Handling Devices with No Manufacturer or Model ID
[2025.02.23] Labels! (For areas, devices, and entities)
[2025.01.03] ZHA Stability, Better Z2M Entity Detection, and Z2M 2.0.0 Compatibility (and it’s a LOT faster!)
[2024-11-02] Fixed LZW30-SN effect clearing; area and floor selectors.
[2024-07-16] Fixing Effects for Blue Series ZHA and Red 800 Series Devices
[2024-06-23] Floor selector and individual LED control
[2024-03-28] Added ZHA support and brightness levels were converted to float. Devices that support 0 – 100 brightness levels will be multiplied by 10; devices that support 0 – 10 brightness levels will be rounded off.
[2024-01-24] Black series support, correcting some effect values in the Blue series, and some general cleanup.
[2024-01-05] Adding support for Blue Series devices and groups of devices. These groups can be of the light.* or group.* domain, and any combo of Blue or Red series switches, dimmers, or fan / light combo devices.
[2023-05-01] The script will use the areas() function introduced in 2023-04 to accept “area: all”. This will search each area Home Assistant knows about, and apply the settings to all compatible Inovelli devices.
[2022-06-06] Areas and devices no longer need to be lists (entities were already being converted if they were in list format). This should make the script much easier to call from automations and scripts using templates.
[2022-05-17] Fixed a typo that caused an error when setting “pulse” effects on switch devices.
Setting the LED indicator
These parameters are all optional and can be configured together or individually (to change the brightness at sunrise but not the color, for example).
- LEDnumber: (Blue Series only; LED 1 .. LED 7 or All) Set to `all` to configure the whole LED bar (default if the parameter is left out) or configure a single LED.
If specific LEDs have been set, they'll need to be unset before the LED bar will show anything. The easiest way is to call LEDnumber 'all' with LEDcolor 'all clear'.
- LEDcolor: (int or string) Sets color of the status LED. If LEDcolor_off is defined and supported by the device, this is only used for "on" status.
If a "color set" is used like "all unicorn", LEDnumber cannot be set to "LED {n}"; "all" LEDs must be configured or none will be.
- LEDcolor_off: (Red 800 and Blue Series only; int or string) Sets color of status LED when off, for devices that support this feature.
Note that the Blue Series and Red 800 Series support separate colors for on and off while the Black 500 and Red 500 Series devices do not and will ignore the variable.
If a "color set" is used like "all unicorn", LEDnumber cannot be set to "LED {n}"; "all" LEDs must be configured or none will be.
- LEDbrightness: (float 0.0 – 10.0) Sets the brightness of the status LED. If LEDbrightness_off is defined and supported by the device, this is only used for "on" status.
LEDbrightness is multiplied by 10 or rounded off for each device, depending on whether they support 0 – 100 or 0 – 10 brightness levels. This was done for backwards compatibility with old automations.
- LEDbrightness_off: (Red 800 and Blue Series only; float 0.0 – 10.0; see note above) Sets the brightness of the status LED when off, for devices that support this feature.
Required for setting LED effects
All four parameters must be passed in order to cange the effect.
- duration: (string) Either "Off", or a whole integer followed by "Seconds", "Minutes", "Hours", "Indefinitely", or "Forever".
- effect: (string) Where older devices and individual LEDs don't support a given effect, that effect has been mapped to something that is supported.
- brightness: (integer 1 – 10) Sets the brightness of the LED's effect
- color: (int or string) Sets color of LED effect and must be one of: "Off", Red, Orange, Lemon, Yellow, Lime, Green, Cyan, Teal, Blue, Purple, Magenta, Light Pink, Pink, Hot Pink, White
Color sets like "all usa" cannot be used with effects. I can't think of a way to get all 7 LEDs synchronized for effects like "pulse" or "chase".
Selector Mode:
Select devices that meet ANY requirements (logical OR) or ALL requirements (logical AND). Since the default for selector_mode: is any, you can leave this field out / unselected and get the same result. Blueprints and script calls written before this feature was added do not need to be updated, and will have the same behavior as before.
Turning off the LED bar for everything that’s upstairs, OR ANY fans:
This service call will turn off the LED bar for all Inovelli devices that are upstairs, and also all fans in the house (e.g. upstairs, downstairs, in the garage, or outside).
service: script.inovelli_led
data:
selector_mode: any
domain: 'fan'
floor: 'upstairs'
LEDcolor: 'Off'
LEDcolor_off: 'Off'
Turning off the LED bar only for fans that are upstairs:
By using selector_mode: 'all', we can now limit the entities to upstairs fans. Fans that are downstairs, or lights that are upstairs will not be changed by this call.
service: script.inovelli_led
data:
selector_mode: all
domain: 'fan'
floor: 'upstairs'
LEDcolor: "Off"
LEDcolor_off: "Off"
Domain:
Include all entities with domain(s) light., fan., or switch.* or deselect for all. In the background, it uses areas() and selecting all three domains makes it functionally equivalent to calling area: 'all''.
Set the LED bar on all fans in the house to purple:
service: script.inovelli_led
data:
domain: 'fan'
LEDcolor: 'purple'
LEDcolor_off: 'purple'
Set the LED bar on all lights and switches in the house to blue:
service: script.inovelli_led
data:
domain:
- light
- switch
LEDcolor: 'blue'
LEDcolor_off: 'blue'
Label:
Labels on Inovelli devices and entities, or areas containing Inovelli devices. Labels can be on the entity, device, or area.
Set all bedroom LEDs to a dim red in the evening:
action: script.inovelli_led
data:
LEDcolor: 'RED'
LEDcolor_off: 'Red'
LEDbrightness: 2
LEDbrightness_off: 0.1
label: `bedroom`
Floor:
Floor names or IDs containing areas with Inovelli devices.
Setting an an effect on all devices upstairs:
service: script.inovelli_led
data:
floor: 'upstairs'
duration: 'Forever'
effect: 'CHASE'
brightness: 8
color: 'Teal'
Area:
Area names or IDs containing Inovelli devices.
‘area: all’ will find any compatible Inovelli devices in Home Assistant 2023.04 or newer.
Setting an effect on every Inovelli device in the house
service: script.inovelli_led
data:
area: 'all'
duration: 'Forever'
effect: 'Fast Blink'
brightness: 8.7
color: 'light pink'
String of comma-separated values (improper list format still works)
Setting an effect on all devices in two areas:
service: script.inovelli_led
data:
area: 'Family Room, 7d7a44fe4d0f4bee947c430d2714e45c'
duration: 'Forever'
effect: 'CHASE'
brightness: 8
color: 'Teal'
Group:
Group names or IDs for groups containing Inovelli devices. Mix and match types as you like.
Proper list format
Setting a 2min effect on all devices in two groups:
service: script.inovelli_led
data:
group:
- group.lights_and_switches
- 0249abdc634c12cbf6cdc06d7a507495
duration: '2 minutes'
effect: 'pulse'
brightness: 8
color: 'red'
Device:
Device IDs of Inovelli devices. Mix and match types as you like. Devices will only accept the device ID, making them harder to use unless it’s a templated device, like
Mix and match fields:
Clearing an effect on all devices upstairs, in the office, the device that triggered the event, and the front porch:
Since the default behavior for the script is to clear any effects, there’s no need to call effect: 'Clear Effect'.
service: script.inovelli_led
data:
floor: 'upstairs'
area: 'office'
device: '{{ trigger.event.data.device_id }}'
entity: 'fan.front_porch'
Full LED configuration, using device ID
service: script.inovelli_led
data:
device:
- 531d79e9270d72d9cab44a4f295967d4
- ef82d0eb91499feadf45e257c0e5eda1
LEDcolor: 'blue'
LEDcolor_off: 'hOt PiNk'
LEDbrightness: 7
LEDbrightness_off: 2.5
LEDnumber: 'all'
Entity:
The light., switch., or fan.* entity for the LED we’re setting.
A 30 sec effect to signal an event, followed by LED 7 (at the top) turning green as an on-going notification:
service: script.inovelli_led
data:
entity: 'light.office'
LEDcolor: 'green'
LEDnumber: 'led 7'
LEDbrightness: 7.5
LEDbrightness_off: 2.3
duration: '30 second'
effect: 'fast blink'
color: 'green'
brightness: 7
LEDnumber:
Sets the full LED bar by default or 'all', or specific LEDs (1 – 7) starting at the bottom.
Configuring an LED color set (color sets start with ‘all’ and must be set with all LEDs)
Once an invidivual LED or an LED color set has been configured, it must be cleared. The full LED bar settings will be overridden by the individual LED settings.
service: script.inovelli_led
data:
device:
- 88f56168bdb28f3ac764fc3d7e3d407b
LEDnumber: 'All'
LEDcolor: 'All Unicorn'
LEDcolor_off: 'All USA'
LEDbrightness: 8.6
LEDbrightness_off: 0.4
Configuring an LED color for one LED
service: script.inovelli_led
data:
entity: 'light.office'
LEDnumber: 'led 4'
LEDcolor: 'red'
Clearing all individual LED color settings in the house
This will reset the LED bars to red.
service: script.inovelli_led
data:
area: 'all'
LEDnumber: 'all'
LEDcolor: 'all clear'
LEDcolor_off: 'all clear'
LEDcolor:
Sets the color of the LED status bar, which indicates brightness levels of the light.
- This is not for effects.
LEDcolor_off:
Sets the color of the LED status bar, which indicates brightness levels of the light.
- Red 800 and Blue Series only. No support on Black, or Red 500 devices.
- This is not for effects.
LEDbrightness:
Sets the brightness of the LED status when on. 0 means off.
- This is not for effects.
LEDbrightness_off:
Sets the brightness of the LED status when off. 0 means off.
- This is not for effects.
LEDnumber_effect:
Sets the effect on the full LED bar by default, or specific LEDs (1 – 7) starting at the bottom.
- Red800 and Blue Series only. No support on Black or Red 500 series devices.
- The full LED bar will override individual LEDs (e.g. you won’t see LED 3 through an effect for the full bar)
- When using
duration: forevereach LED’s effect will need to be cleared with a separate command.
effect:
Type of effect. (Red and Blue Series only. Black Series devices do not support effects.)
brightness:
Sets the brightness of the LED’s effect. 0 means off.
color:
Color of LED for the effect
duration:
How long the effect will last.
