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

  1. Go to Settings > Devices & Services > ZHA > Add Device
  2. Put the switch in pairing mode: press the config button (small button on the side) 3 times rapidly
  3. The switch should appear as “Inovelli VZM31-SN” within 30 seconds
  4. Confirm the pairing

Using Zigbee2MQTT

  1. Open the Zigbee2MQTT web interface
  2. Click Permit Join
  3. Press the config button on the switch 3 times rapidly
  4. The switch will appear in the device list

Step 3: Install the Inovelli Blueprint

The community has created a blueprint for Inovelli scene control:

  1. In Home Assistant, go to Settings > Automations & Scenes > Blueprints
  2. Import the Inovelli Blue Series blueprint from the community
  3. 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:

ActionEvent
2x tap upScene 1
2x tap downScene 2
3x tap upScene 3
3x tap downScene 4
Hold upDim up
Hold downDim 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%.