zigbee2mqtt (BRIDGE/Gateway software ZigBee)

4 minutes of reading
Developer: Koenkk
Availability: at Git repositoryHub
Category: BRIDGE/Gateway ZigBee↔︎MQTT
Type: software
Implementation difficulties: media
Card revision: 1.1

zigbee2mqtt logo"zigbee2mqtt”Is the software component useful for defining a BRIDGE/Gateway ZigBee↔︎MQTT, which hardware counterpart is the USB dongle CC2531 (opportunameprovided by the user with specific firmware, as we shall see).

In practice, the combined adoption of "zigbee2mqtt ”and one of the antennas mentioned above enables the user a integration, At the profirst personal home automation, components based on standards ZigBee of different brands and lines products.

As sappin fact, we adopt the components based on the excellent home automation standard ZigBee provides also the adoption of BRIDGE/Gateway of the same line products (eg. Gateway Philips HUE to check the components of the same line), except in cases of interoperability (eg the existing possibility to check components ZigBee LUMI Aqara means Gateway Xiaomi Mijia) - as well as the forced use of app furnishings apposite provided by proproducers of gateway. A hateful one vendor lock-in to always avoid, at all costs.

The adoption of zigbee2mqtt and its antenna CC2531, in association with the use of a proprio personale HUB software (eg. Home Assistant), solves all this: zigbee2mqtt acts as a link between the'personale HUB and the component ZigBee (using the proProtocol MQTT), whatever it may be, thus achieving the goal of full integration. The (very large) list of components compatible with this operating model is available here.

Nb. An alternative to zigbee2mqtt (same purposes, different modes) is deCONZ.

How it works

zigbee2mqtt is a free software that runs in "server" mode, that is it is a proprocess perpetually running, a bit like it happens to our loved ones HUB personal.

zigbee2mqtt can be easily installed and run on:

  • Rasberry Pi equipped with Raspbian operating system;
  • Ubuntu & linux-like
  • Microsoft WIndows 7 and 10;
  • Apple macOS;
  • How addon HASSIO

and others.

Once installed and configured zigbee2mqtt on the reference computer (which must obviously also have the antenna CC2531 USB dongle physically connected), our home network will magically have aMQTT interface to which to connect to be able to survey and manage the components ZigBee of our home automation.

zigbee2mqtt (as the name suggests) indeed does nothing but "translate" the communications of the proProtocol ZigBee in standard communications MQTT, effectively transforming the components ZigBee connected to it in MQTT components. The USB dongle antenna used by zigbee2mqtt, the CC2531, is usually purchased "virgin" (in terms of firmware) and provides, from the user, the implementation of a specific proreimbursement orderprogrammation to make it usable.

zigbee2mqtt architecture
the functional modelnamento of zigbee2mqtt.

Let's see in which modes the majors personal HUBmanage to integrate CC2531 via zigbee2mqtt (and therefore the components ZigBee on it certificates):

HUBModalità di integrazione
Home Assistant
(distribution HASSIO)
Add-on dedicated (server zigbee2mqtt) + native MQTT component Home Assistant HASSIO. Once riproprogrammed the CC2531 antenna with the expected firmware, you need to run the server zigbee2mqtt; subsequently it is necessary to carry out the pairing of the components ZigBee with the CC2531 antenna, so that their communications are transformed from the server into MQTT messages. Finally, the MQTT component Home Assistant (thanks to the autodiscovery) will automatically recognize these new virtual MQTT devices, prothus seeing the definition of the corresponding entity. It is also possible to manually configure each accessory via MQTT.

GUIDE TO INTEGRATION

Home Assistant
(installed as applicativo)
Service (server) zigbee2mqtt + broker MQTT + native MQTT component Home Assistant. One time riproprogrammed the CC2531 antenna with the expected firmware, you need to run the server zigbee2mqtt; subsequently it is necessary to carry out the pairing of the components ZigBee with the CC2531 antenna, so that their communications are transformed from the server into MQTT messages. Finally, the MQTT component Home Assistant (thanks to the autodiscovery) will automatically recognize these new virtual MQTT devices, prothus seeing the definition of the corresponding entity. It is also possible to manually configure each accessory via MQTT.

GUIDE TO INTEGRATION

openHABService (server) zigbee2mqtt + broker MQTT + native MQTT component openHAB. One time riproprogrammed the CC2531 antenna with the expected firmware, you need to run the server zigbee2mqtt; subsequently it is necessary to carry out the pairing of the components ZigBee with the CC2531 antenna, so that their communications are transformed from the server into MQTT messages. Finally, the MQTT component of openHAB (thanks to the autodiscovery) will automatically recognize these new virtual MQTT devices, prothus seeing the definition of the corresponding entities.
DomoticzService (server) zigbee2mqtt Once riproprogrammed the CC2531 antenna with the expected firmware, you need to run the server zigbee2mqtt; subsequently it is necessary to carry out the pairing of the components ZigBee with the CC2531 antenna, so that their communications are transformed from the server into MQTT messages. Finally, the Domoticz MQTT component (thanks to the autodiscovery) will automatically recognize these new virtual MQTT devices, prothus seeing the definition of the corresponding entities.
HomebridgeRegardless of where Home is runningbridge, it is necessary to install the server zigbee2mqtt (the installations vary depending on the type of operating system that will host it) on the same computer or on a computer connected on the same LAN and perform the pairing of accessories ZigBee with the CC2531 antenna appropriately reprogrammated in the firmware. Subsequently it is necessary to use one of the many plugins available for the management of the MQTT (we recommend homebridge-mqttthing) and define the various accessories manually, one by one, starting from the MQTT messages prolearned from zigbee2mqtt.
HomeyThink about using CC2531 with Homey it wouldn't make any sense: Homey it's a personale HUB hardware equipped with antenna ZigBee and of a whole series of apps to integrate a huge variety of components ZigBee.
CC2531
the CC2531 USB dongle.

Benefits and defects

The adoption of zigbee2mqtt has strengths and weaknesses. Compared to the use of his "rival" deCONZ, has the advantage of being cheaper (the CC2531 USB dongle and the necessary for program its firmware they cost less of the antennas used with deCONZ, that is ConBee o RaspBee); against, zigbee2mqtt provides a greater technical competence than deCONZ (extremely easier to use), and the antennas used by the latter are proto use, unlike the CC2531 that needs to be learn to reprogrammate for the purpose.

Another important thing to know is the limit the devices ZigBee manageable: in the presence of a single CC2531 antenna, the components that can be managed are 25 (against the 200 of ConBee / RaspBee), number which can be increased by using components ZigBee with router function. Also compared to ConBee and RaspBee, CC2531 keys have a radio range lower.


Please comment below