zigfred Benutzerdokumentation
  • Los geht's mit zigfred
  • Einrichtung
    • Installation
      • Verdrahtungsbeispiele
    • App einrichten
    • Ausgänge konfigurieren
    • Mit Gateway verbinden
    • Tasten konfigurieren
    • Geräte verwalten
    • Dashboard
  • Kompatibilität
    • Gateways
    • Drahtlose Leuchtmittel und Geräte
    • Konventionelle Leuchtmittel und Geräte
  • Problembehandlung
    • Ich habe Probleme
    • Werkseinstellungen
    • Flackernde Leuchtmittel
    • Firmware-Update
  • Weitere Informationen
    • Kontakt & Support
    • Release Notes
    • Beta Testprogramm
    • Ersatzteile
  • Extras
    • Zigbee2MQTT
    • Zigbee Home Automation für Home Assistant
    • Home Assistant
  • zigfred Integration in die Apple Home App (HomeKit)
Powered by GitBook
On this page
  • Setup
  • Voraussetzungen
  • Einrichten auf Raspberry Pi 4 mit Home Assistant
  • Einrichtung Fortgeschritten (Windows, Linux, Mac)
  • Für Entwickler

Was this helpful?

  1. Extras

Zigbee2MQTT

PreviousErsatzteileNextZigbee Home Automation für Home Assistant

Last updated 8 months ago

Was this helpful?

zigfred kann direkt über die Open-Source Software Zigbee2MQTT und den ConBee II USB Stick in viele unterschiedliche Smart Home Systeme wie Home Assistant eingelernt werden. Mittels Tastendruck-Ereignissen löst man nun beliebige Automationen aus, oder steuert die angeschlossenen Geräte am zigfred bequem über das Webinterface von Zigbee2MQTT, via Home Assistant, oder per Sprache.

So lässt sich z.B. auch dein Sonos bequem über die zigfred Tasten fernsteuern.

Dabei übernimmt der Zigbee2MQTT zusammen mit dem ConBee II USB Stick die Aufgabe des Zigbee-Gateways (ähnlich einer Philips Hue Bridge) und bietet über das Nachrichten-Protokoll MQTT deinem Home Assistant eine Schnittstelle um deine zigfreds und anderen Zigbee-Geräte einzubinden.

Storenzustand "unbekannt" Wird bei dir im Home Assistant (oder im Google Home über Nabu Case) der Storen-Zustand als "unbekannt", statt "offen"/"angeschlossen" angezeigt, kannst die Position und den Neigungswinkel aber über das Home Assistant-Dashboard steuern, hat dies damit zu tun, dass Zigbee2MQTT bei Geräten mit mehreren Storen-Endpunkten den Zustand noch nicht richtig für Home Assistant enkodiert.

Wir haben bereits einen Patch beim Zigbee2MQTT-Projekt eingereicht. Dieser sollte Anfang Oktober eingespielt werden. Du kannst dann ganz einfach dein Zigbee2MQTT-Addon oder Server updaten.

Im Unterschied zu Zigbee Home Automation für Home Assistant für Home Assistant unterstützt Zigbee2MQTT auch den Neigungswinkel von angeschlossenen Storen, und kann deaktivierte Ausgänge am zigfred ausblenden. Hinweis: Seit ZHA wird auch dort der Neigungswinkel von angeschlossenen Storen unterstützt.

Setup

Du findest im Internet zahlreiche Anleitungen und Videos, wie man Home Assistant mit Zigbee2MQTT einrichtet. Daher haben wir die Schritte nur kurz zusammengefasst.

Voraussetzungen

  • zigfred mit Firmware Version 30 oder höher

  • Ein wenig Erfahrung mit Kommandozeile und Programmierung, sowie ein wenig Geduld

  • Einen Zigbee2MQTT kompatiblen USB Stick wie z.B. den ConBee II Stick

  • Einen Raspberry Pi, Computer oder Heimserver (Windows oder Linux)

Einrichten auf Raspberry Pi 4 mit Home Assistant

Als erstes musst du sicherstellen, dass die ZHA Integration nicht installiert ist. Diese nutzt ebenfalls den lokalen Zigbee USB-Stick und steht daher im Konflikt mit Zigbee2MQTT.

Anschliessend musst du noch folgende Komponenten über die Einstellungen mit ein paar Klicks installieren:

Generell müssen nur die Einstellungen für den Zigbee USB-Stick im Zigbee2MQTT Addon einkonfiguriert werden.

Du hast nun deinen ersten zigfred eingelernt

  • Du möchtest die angeschlossenen Geräte direkt über Zigbee2MQTT-Oberfläche ausprobieren? Klicke dazu auf den blauen Gerätenamen-Link (Friendly Name) links. Unter "Details" findest du dann die einzelnen Regler für Schalter-LED, Licht und Storen.

  • Über den blauen Bleistiftknopf kannst du den Schalter umbenennen: Wir empfehlen dir hier noch die Option "Aktualisiere Home Assistant entity ID" zu aktivieren. Dann hat dein zigfred gleich auch den richtigen Namen in der Geräteverwaltung und Dashboard von Home Assistant selbst.

  • Du hast die Ausgänge nach dem Pairing umkonfiguriert? Mit Klick auf den gelben Refresh-Knopf kannst du die aktuelle Konfiguration ins Zigbee2MQTT übernehmen. Falls du die einzelnen Ausgänge unabhängig im Zigbee2MQTT aktivieren möchtest, kannst du auf den blauen Gerätenamen-Link (Friendly Name) klicken und die einzelnen Ausgänge unter "Einstellungen (spezifisch)" aktivieren.

Du möchtest nun dein Home Assistant auf dich abgestimmt anpassen? Unter Home Assistantfindest du unsere Tricks und Kniffe.

Einrichtung Fortgeschritten (Windows, Linux, Mac)

Du möchtest Zigbee2MQTT unabhängig von einem Raspberry Pi installieren? Kein Problem! Zigbee2MQTT ist in Javascript geschrieben und läuft auf nahezu jedem System.

  • Installiere Git, mosquitto, node.js und zigbee2MQTT auf deinem System

  • Bearbeite die Konfigurationsdatei data/configuration.yaml und füge folgende Konfiguration ein:

homeassistant: true
permit_join: true
mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://localhost
serial:
  adapter: deconz
  port: \\.\COM3 # Please change to the correct serial port designator as seen in `Device Manager`
frontend:
  port: 8080
  host: 0.0.0.0
  • Installiere Home Assistant auf diesem oder einem anderen System

  • Die Tasten können nun mit einer neuen Automation im Home Assistant einprogrammiert werden.

  • Parallel kannst du die Front-Tasten von zigfred via zigfred App direkt mit Zigbee-Funktionen belegen. So funktioniert ein Grossteil der Leuchten auch bei einem Ausfall deines Servers weiterhin.

Tasten-Layouts

Je nach Tasten-Layout sind die Tasten-Ereignisse im Home Assistant unterschiedlich. Die folgende Grafik hilft dir dabei, die Tasten am zigfred den Buttons in Home Assistant zuzuordnen.

Für Entwickler

Die zigfred-Integration für zigbee2MQTT findest du in den folgenden Repos:

Zuerst bespielst du deinen Raspberry Pi mit Home Assistant (siehe ) und verbindest dich über die Weboberfläche.

: Verbindet sich mit dem lokalen Mosquitto MQTT Broker per MQTT-Protokoll und integriert die verfügbaren Geräte auf der MQTT-Schnittstelle im Home Assistant.

: Bietet Home Assistant und Zigbee2MQTT einen MQTT Broker (Zwischenserver für das MQTT-Protokoll) um die Geräte von Zigbee2MQTT bereitzustellen.

: Verbindet sich mit dem lokalen Zigbee USB-Stick und stellt gegenüber dem MQTT Broker die Zigbee-Geräte bereit.

Starte zigbee2MQTT neu und füge deine zigfreds über die Weboberfläche von zigbee2MQTT () ins Netz ein.

Danach musst du nur noch das MQTT Plugin im Home Assistant () einrichten. Per zigfred App kannst du das Tastenlayout richtig einlernen und solltest die Tasten drücken, damit Home Assistant die Taste erkennt.

Ein kleines Video direkt aus dem Labor

Die zigbee2MQTT-Event-Signaturen für zigfred uno findest du unter

😄
Version 2023.11
https://www.zigbee2mqtt.io/guide/adapters/
https://www.digitec.ch/de/s1/product/dresden-elektronik-conbee-ii-usb-stick-smart-home-hub-11045397?ip=conbee
https://www.home-assistant.io/installation/raspberrypi/
MQTT integration
Mosquitto MQTT broker addon
Zigbee2MQTT addon
http://localhost:8080
https://www.home-assistant.io/integrations/mqtt/
https://www.zigbee2mqtt.io/devices/ZFU-1D-CH.html
https://github.com/Koenkk/zigbee-herdsman-converters/blob/master/devices/siglis.js
https://github.com/Koenkk/zigbee-herdsman/blob/master/src/zcl/definition/cluster.ts
Zuordnung der Tasten-Layouts zu den Tasten-Ereignissen in Home Assistant.