DISCLAIMER: You may notice there are a lot of over-used keywords or phrases as well as English that seems a little off. This is because these articles are used to feed our AI Robot (Ira) and she needs the data to be structured in a certain way.
REMINDER: This switch is only to be used to control lights (except ballasts or any lights connected to a transformer). Do not use the switches on outlets, fans, or any other inductive load.
This is the digital setup instructions for the Blue Series Smart 2-1 Switch (On/Off or Dimmer) on the Home Assistant (Zigbee2MQTT) platform.
Navigating the Instructions
Please click on any of the sections in the Table of Contents to get started. We recommend working your way down as it follows an intentional flow that is user friendly and hub/gateway specific. As always, any questions, please see the Additional Resources links section or submit a ticket, we’re happy to help.
Quick Setup Instructions
Follow these if you have already installed the 2-1 switch before and are just looking for some quick pairing instructions. If this is your first time installing the 2-1 switch, please skip this section and work your way through the various sections below starting with the Prerequisites.
This section assumes the following:
You've installed Zigbee2MQTT or Zigbee2MQTT Edge
You have a compatible Zigbee stick
You've wired the switch and it works manually
Let’s begin:
Make sure your switch LED is lit up blue
Open up your Home Assistant App, click on the hamburger bar at the top left (three lines) and select, "Zigbee2MQTT" from the sidebar (if you don't have a shortcut, go to, "Configuration" → "Add-ons, Backups, & Supervisor" → "Zigbee2MQTT" → "Open Web UI")
Click on, "Permit join (All)" at the top
Make sure your switch LED is pulsing blue as shown in Video #1 – if it’s not, press the config/favorite button three (3) times as shown in Video #2
Zigbee2MQTT should then search for, find and initialize the switch
Video #1 & Video #2
Video #1 & Video #2
Video #1: Switch Already Pulsing Blue
Video #2: Press config/favorites button to initiate the LED pulsing blue
If your LED bar refuses to pulse blue, then please hold down on the top of the paddle as well as the config/favorites button for approximately 20 seconds until the LED Bar turns Red and then let go. The LED Bar will blink red three times to confirm as shown in the video below.
Video Demonstration
Video Demonstration
NOTE: Video sped up to save time/space
Prerequisites
There are three prerequisites to pairing this switch to ZHA and they are:
Install Zigbee2MQTT
Compatible Zigbee USB Sticks
We've tested the following Zigbee sticks to work with our Blue Series switches: Compatible Zigbee Sticks • Home Assistant
For a full list of compatible Zigbee2MQTT USB sticks, please see the following link from the Home Assistant Documentation: Home Assistant Zigbee2MQTT Compatible USB Sticks
DISCLAIMER: As an Amazon Associate Inovelli, LLC earns from qualifying purchases.
Installing Zigbee2MQTT
WARNING: These instructions may vary depending on your setup. The below instructions use the Home Assistant Add-On store.
Click on the hamburger menu at the top and select, "Configuration"
Next, click on, "Add-Ons, Backups, & Supervisor" (make sure you're on the, "Add-Ons" tab)
Click on, "Add-On Store" and search for, "Mosquitto Broker"
Install, "Mosquitto Broker"
Next, go back to the, "Add-On Store", click on the three dots at the top right and select, "Repositories"
On the line that says, "Add" paste the following URL: <a href="https://github.com/zigbee2mqtt/hassio-zigbee2mqtt" target="_blank">https://github.com/zigbee2mqtt/hassio-zigbee2mqtt</a> and click, "Add" (NOTE: you may get a warning about an invalid repository -- ignore it)
Refresh the page and search for, "Zigbee2MQTT" and install either, "Zigbee2MQTT" or "Zigbee2MQTT Edge"
Install, "Zigbee2MQTT" and select, "Start on boot" and "Show in sidebar" (Optional)
For troubleshooting and/or official instructions, please see the Zigbee2MQTT installation guide: https://www.zigbee2mqtt.io/guide/installation/
Installation Instructions
Before setting up your switch within Zigbee2MQTT, you will have to manually install your switch in the wall and have it powered up. In order to do that, you (or your licensed electrician) will need to follow our Wiring Instructions which can be found below:
Pairing Instructions
The below instructions assume you have installed Zigbee2MQTT prior to pairing.
With your LED pulsing blue, open your Home Assistant App (web or mobile) and click on the hamburger menu at the top left
Select, "Zigbee2MQTT" from the sidebar (if you don't have a shortcut, go to, "Configuration" → "Add-ons, Backups, & Supervisor" → "Zigbee2MQTT" → "Open Web UI")
Click on, "Permit join (All)" at the top
While Home Assistant is scanning, make sure your switch LED is pulsing blue as shown in Video #1 – if it’s not, press the config/favorite button three (3) times as shown in Video #2. The LED Bar should start pulsing blue and, if successfully paired to Home Assistant, it will briefly turn green
Video #1: Switch Already Pulsing BlueVideo #2: Press config/favorites button to initiate the LED pulsing blue
In addition, your app will show your switch under the, "Devices" tab -- locate your switch and click on it
If you'd like to rename your switch, under the, "About" tab, scroll down and click on the pencil icon -- a pop-up will appear and you can rename the, "Friendly Name" to whatever you'd like
Finally, click on the, "Exposes" section and toggle the on/off button (located in the, "State" section at the top) -- you may need to click the refresh button.
Once your switch is successfully paired, check to make sure you have basic functionality of your switch by turning it on/off (and if you have it as a dimmer, test the dimming) in the app.
If you'd like to change your switch to a ceiling fan switch or need to program it to work in a multi-way setup, please move on to the, "Switch Configuration" section below.
Switch Configuration
In this section, we will help you change your switch mode (ie: Exhaust or Ceiling) and type (Single-Pole, 3-Way Aux).
If you are trying to setup your switch in Smart Bulb Mode, please still select the Switch Mode and Type from the below instructions, and then follow the directions to setup Smart Bulb Mode
Switch Mode (On/Off or Dimmer)
To change your Blue Series 2-1 switch from an On/Off switch to a Dimmer switch or vice versa in Zigbee2MQTT, please follow the instructions below:
Open your Zigbee2MQTT Web App and go to the, "Devices" tab
Find your Blue Series 2-1 Switch and click on it and then click on the "Exposes" tab
Scroll down to where it says, "OutputMode"
Find "OutputMode" and select either, "Dimmer" or "On/Off" and select the option you desire.
Test your switch to make sure the setting applied
Switch Type (Single-Pole, Multi-Way Aux/Dumb, Full Sine)
To program your Blue Series 2-1 switch to operate in a Single-Pole, Multi-Way Aux, Multi-Way Dumb, or Full Sine Mode in Zigbee2MQTT, please follow the instructions below:
Open your Zigbee2MQTT Web App and go to the, "Devices" tab
Find your Blue Series Fan Switch and click on it and then click on the "Exposes" tab
Scroll down to where it says, "SwitchType"
Find "SwitchType" and select either, "Load Only (default)" or "Aux".
Test your switch to make sure the setting applied
Advanced Feature Setup
This switch is packed with features and most of them come directly from this community. They've been debated back and forth, added to wishlists, and talked about over the course of 4+ years (as this switch builds on our Red Series lineup).
Below we will explain all the parameters and show you how to change them from within Home Assistant (Zigbee2MQTT) and then we'll go into some of the advanced features and explain how to set them up in Zigbee2MQTT. If you have any questions along the way, feel free to create a post in our community as there are many Home Assistant users here who are excited to help.
Parameter Explanations
A parameter is a setting within the switch firmware that allows you to change how the switch operates. For example, you want to change how fast your lights dim on and off, the color of the LED bar, minimum dimming level and much more -- all with a few clicks within the app.
For a list of the most up-to-date parameters and the firmware version they are associated with, please visit the Blue Series 2-1 Switch Parameter Page
Zigbee Bindings
Zigbee binding is when two or more Zigbee products communicate directly with one another without the need to communicate with a hub. There are two main benefits of utilizing Zigbee binding: speed & local control.
From a speed standpoint, cutting out the middle-man (hub) can save precious milliseconds or even seconds depending on your cloud and/or processing power off your hub. Whereas from a local control standpoint, if your hub goes does down and cannot communicate, your products can still talk to each other.
To setup Zigbee Binding with Zigbee2MQTT, please see this article: Setting Up Zigbee Bindings • Home Assistant - Zigbee2MQTT