home-assistant
Setting Up Inovelli Blue Series 2-1 Switch with Home Assistant
Complete guide to pairing the Inovelli Blue Series 2-1 switch with Home Assistant via ZHA or Zigbee2MQTT, including scene control and LED notifications.
Prerequisites
- Home Assistant 2024.1 or later installed and running
- Zigbee coordinator (e.g., SONOFF Zigbee Dongle Plus-E or SkyConnect)
- ZHA or Zigbee2MQTT integration configured
- Inovelli Blue Series switch installed in electrical box
Step 1: Install the Switch
The Inovelli Blue works with or without a neutral wire. Follow the included wiring diagram for your configuration. Ensure the breaker is off during installation.
Step 2: Pair with Home Assistant
Using ZHA
- Go to Settings > Devices & Services > ZHA > Add Device
- Put the switch in pairing mode: press the config button (small button on the side) 3 times rapidly
- The switch should appear as “Inovelli VZM31-SN” within 30 seconds
- Confirm the pairing
Using Zigbee2MQTT
- Open the Zigbee2MQTT web interface
- Click Permit Join
- Press the config button on the switch 3 times rapidly
- The switch will appear in the device list
Step 3: Install the Inovelli Blueprint
The community has created a blueprint for Inovelli scene control:
- In Home Assistant, go to Settings > Automations & Scenes > Blueprints
- Import the Inovelli Blue Series blueprint from the community
- Create automations using multi-tap events (2x, 3x, 4x, 5x up/down)
Step 4: Configure LED Notifications
The Inovelli’s LED bar can display custom colors and effects. This turns every switch in your house into a notification display.
LED Notification Examples
Red pulse for water leak:
automation:
- alias: "LED alert on water leak"
trigger:
- platform: state
entity_id: binary_sensor.water_leak
to: "on"
action:
- service: zha.issue_zigbee_cluster_command
data:
ieee: "YOUR_SWITCH_IEEE"
endpoint_id: 1
cluster_id: 64561
command: 1
command_type: server
params:
effect_type: 1
color: 0
level: 100
duration: 255
Green for house secure, blue for unlocked: Use the LED bar to show at a glance whether all doors are locked and all windows closed.
Step 5: Scene Control Automations
Multi-tap scene control gives you up to 10 actions per switch:
| Action | Event |
|---|---|
| 2x tap up | Scene 1 |
| 2x tap down | Scene 2 |
| 3x tap up | Scene 3 |
| 3x tap down | Scene 4 |
| Hold up | Dim up |
| Hold down | Dim down |
Example: Double-tap up to activate “Movie Mode”, double-tap down to turn off all living room lights.
Troubleshooting
Switch won’t pair: Factory reset by holding the config button for 20 seconds until the LED bar turns red, then release. Retry pairing.
LED notifications not working: Ensure you’re using the correct cluster commands for your integration (ZHA vs Z2M). The command syntax differs between the two.
Dimming flickers with certain bulbs: Adjust the minimum dimming level parameter. Some LED bulbs require a higher minimum to avoid flickering. Set parameter 1 (minimum level) to 20-30%.