Blue Series • Single LED Notifications with mqtt.publish • Zigbee2MQTT

Introduction

The Inovelli Blue Series is a powerful Zigbee product that allows for individual LED notifications. These LEDs can be customized for alerts like doorbell rings, security warnings, or even smart home statuses.

In this guide, we'll walk through:

Setting up Zigbee2MQTT to work with the VZM31-SN
Configuring Home Assistant for LED notifications
Creating automations to trigger the LEDs

Prerequisites

Before starting, ensure you have:

Home Assistant running on a compatible device (Raspberry Pi, NAS, VM, etc.)
Zigbee2MQTT installed and configured
MQTT Broker (Mosquitto or equivalent)
Inovelli Blue Series Switch paired via Zigbee2MQTT
Basic familiarity with Home Assistant automation YAML or UI-based automations

Step 1: Pair the Inovelli with Zigbee2MQTT

Open Zigbee2MQTT in Home Assistant.
Put the device into pairing mode:
Rename the device for easy identification (e.g., inovelli_dimmer).

Once paired, navigate to the device settings in Zigbee2MQTT. You should see the Individual LED notification parameters available.

Step 2: Configure Zigbee2MQTT for LED Notifications

Each LED notification on the blue series can controlled by MQTT parameters.

A sample MQTT payload to control LED notifications looks like this:

{"individual_led_effect":{"color":196,"duration":41,"effect":"fast_blink","led":"3","level":8}}

Where:

led – Defines the LED number. The bottom LED is 1 and it works its way up to 7.
effect – Defines the LED behavior (solid, blink, pulse, etc.).
color – Color in RGB format (0-255).
level – Brightness level (0-100%).
duration – How long the notification lasts in seconds.

To test LED notifications manually:

Open Developer Tools → Actions → MQTT: Publish in Home Assistant.
Publish to the topic:
```
zigbee2mqtt/inovelli_dimmer/set
```

Use a JSON payload like:

{"individual_led_effect":{"color":1,"duration":41,"effect":"fast_blink","led":"3","level":99}}

This should trigger an LED notification.

Step 3: Create a Home Assistant Automation

Now, let's create an automation that triggers LED notifications when the front door is opened.

Using Home Assistant UI

Go to Settings → Automations & Scenes.
Click Create Automation → Start with a Blank Automation.
Set Trigger:
- Device: Select your door sensor (e.g., Front Door Sensor).
- Trigger Type: "Opens".

Set Action:

Action Type: Call service
Service: mqtt.publish

Service Data:

topic: "zigbee2mqtt/inovelli_dimmer/set" 
payload: {"individual_led_effect":{"color":1,"duration":41,"effect":"fast_blink","led":"3","level":99}}

Click Save and Enable the automation.

Step 4: Advanced Automations

You can set up multiple LED notifications based on different events.

Example: Different LED Colors for Different Events

Modify the payload based on triggers:

1. Red Flashing LED for Security Alert

topic: "zigbee2mqtt/inovelli_dimmer/set" 
payload: {"individual_led_effect":{"color":1,"duration":41,"effect":"fast_blink","led":"3","level":55}}

LED 3 = 3rd LED from bottom
Effect fast_blink = Fast Blink
Color 1 = Red
Duration 41 seconds
Level 55 = 55%

2. Blue Pulsing LED for Door Open Notification

topic: "zigbee2mqtt/inovelli_dimmer/set" 
payload: {"individual_led_effect":{"color":170,"duration":10,"effect":"pulse","led":"1","level":77}}

LED 1 = bottom LED
Effect pulse = Pulse
Color 170 = Blue
Duration 10 seconds
Level 77 = 77%

3. Green Solid LED for System Ready

topic: "zigbee2mqtt/inovelli_dimmer/set" 
payload: {"individual_led_effect":{"color":85,"duration":5,"effect":"solid","led":"7","level":69}}

LED 7 = top LED
Effect solid = Solid
Color 85 = Green
Duration 5 seconds
Level 99 = 99%

Step 5: Testing & Debugging

To ensure your setup works:

Trigger each automation manually in Home Assistant.
Monitor MQTT messages in Zigbee2MQTT logs.
If LEDs don’t respond, check:
- Zigbee2MQTT logs (Settings → Logs).
- MQTT Broker settings (Configuration → MQTT in Home Assistant).
- If the correct MQTT topic is used.

Conclusion

Using Zigbee2MQTT, Home Assistant, and the Inovelli Blue Series, you can create powerful LED notifications for your smart home. Whether for security alerts, door notifications, or system statuses, this setup enhances your automation capabilities.

Next Steps

Customize LED effects for other automations.
Integrate additional devices (motion sensors, door locks, etc.).
Experiment with different MQTT payloads to enhance notifications (Like Single LED).

Blue Series Fan Switch • Parameters

Blue Series Fan Switch • Manual

Blue Series 2-1 Switch • Setup Instructions • Home Assistant - ZHA

Blue Series 2-1 Switch • Setup Instructions • Home Assistant - Zigbee2MQTT

Blue Series • LED Notifications with mqtt.publish • Zigbee2MQTT