# Zigbee-Geräte

## **1. Zigbee-Adapter installieren**

Wenn Sie bei der Installation von CUBE die optionalen Schritte für Zigbee befolgt haben, können Sie direkt zu [Schritt 2](#id-2.-initialize-zigbee) springen, um Ihren Dongle als Zigbee-Netzwerkkoordinator zu initialisieren.

Bevor Sie ein Zigbee-Gerät hinzufügen, benötigen Sie einen Zigbee-Adapter, in der Regel einen USB-Dongle. Stecken Sie den Zigbee-Adapter in den USB-Anschluss des Geräts, auf dem CUBE OS läuft.

**Für Nutzer virtueller Maschinen**: Nach dem Einstecken des Zigbee-Adapters fügen Sie ihn in den Einstellungen der virtuellen Maschine hinzu und starten Sie CUBE neu. Detaillierte Schritte finden Sie in der Anleitung zur virtuellen Maschine [Installationsanleitung](/german/erste-schritte/quickstart/virtuelle-maschine.md).

### **1.1 Kompatible Adapter**

CUBE ist mit verschiedenen Zigbee-Adaptern unterschiedlicher Hersteller kompatibel. Derzeit werden Protokoll-Stacks wie EZSP, Deconz, Zstack und Zigate unterstützt. Obwohl jeder Adapter verwendet werden kann, der diese Protokoll-Stacks unterstützt, werden die folgenden empfohlen:

## **2. Zigbee initialisieren**

{% stepper %}
{% step %}
Nachdem Sie Ihren Zigbee-Adapter eingesteckt haben, zeigt CUBE ein Pop-up an, z. B. `Dongle verbunden` wenn der Adapter erkannt wird.

<div align="left"><figure><img src="/files/a86d84d516b6e5e6a265946a2ab841f5c33fcfbf" alt="" width="277"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Bei Verwendung eines **SONOFF Zigbee-Dongles**, klicken Sie auf `Einrichtung starten`.

Wenn der Dongle bereits eine unterstützte Zigbee-Firmwareversion ausführt, schließt CUBE die Einrichtung automatisch ab. Wenn die Firmwareversion nicht unterstützt wird, bietet CUBE ein Flashen mit einem Klick auf die empfohlene stabile Version an.

<div align="left"><figure><img src="/files/3157deb5032528f75d755a7b0960708aad34d5ea" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Bei Verwendung eines **Nicht-SONOFF Zigbee-Adapter**, klicken Sie auf `Einrichtung starten`.

Wenn der Adapter bereits eine unterstützte Zigbee-Firmwareversion ausführt, schließt CUBE die Einrichtung automatisch ab. Wenn die Firmwareversion nicht unterstützt wird, verwenden Sie das Flash-Tool des Herstellers, um die empfohlene stabile Version zu installieren, bevor Sie fortfahren. **Andernfalls**, kann CUBE mit diesem Adapter keine Zigbee-Geräte steuern.
{% endstep %}

{% step %}
Sobald der Adapter sein Firmware-Upgrade und seine Konfiguration abgeschlossen hat, können Sie nun Zigbee-Geräte hinzufügen.

<div align="left"><figure><img src="/files/22b55fa5e33af889c051738546ee35f7f1cda490" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Wenn CUBE Ihren Zigbee-Adapter nicht erkennt, fügen Sie ihn manuell hinzu, indem Sie die erforderlichen Informationen eingeben:

<img src="/files/cea5e2c3991d582445a11f92edfb2576f7161547" alt="" data-size="original">

* **Serieller Pfad**: Prüfen Sie im Abschnitt „Alle Hardware“ auf der Einstellungsseite den seriellen Portpfad des eingesteckten Zigbee-Adapters.

<img src="/files/9dbf1cb24d556afae0507c93404b406e37134337" alt="" data-size="original">

* **Typ des Protokoll-Stacks**: CUBE unterstützt derzeit EZSP, Deconz, ZStack und Zigate. Prüfen Sie die Dokumentation des Adapters oder die Kaufseite, um den richtigen Typ zu ermitteln.
* **Übertragungsgeschwindigkeit**: Optional. Nicht für alle Zigbee-Adapter erforderlich.
* **Datenfluss**: Optional. Nicht für alle Zigbee-Adapter erforderlich.

Klicken Sie auf `Bestätigen` um die Konfiguration zu speichern. Wenn die Einrichtung erfolgreich ist, können Sie mit dem Hinzufügen von Zigbee-Geräten beginnen. Wenn sie fehlschlägt, prüfen Sie die Fehlermeldung und aktualisieren Sie die Konfiguration.

<img src="/files/b6ec82dcd36c47671b94837f7170ae7419e793c1" alt="" data-size="original">
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Da ein Zigbee-Netzwerk nur eine Adapterkonfiguration haben kann, werden mehrere Einrichtungsvarianten nicht unterstützt. Wenn ein konfigurierter Adapter entfernt und anschließend wieder eingesetzt wird, erkennt CUBE das Gerät automatisch und führt Sie durch die Wiederherstellung, ohne dass eine Neukonfiguration erforderlich ist.
{% endhint %}

## **3. Zigbee-Geräte hinzufügen**

{% stepper %}
{% step %}
Nach der Konfiguration klicken Sie auf der Seite „Gerät hinzufügen“ auf „Kopplung starten“, um Zigbee-Geräte im Kopplungsmodus automatisch hinzuzufügen.

{% hint style="info" %}
Wenn Ihr Zigbee-Gerät nicht gefunden wird, stellen Sie sicher, dass sich das Gerät im Netzwerkkonfigurationsmodus befindet, und prüfen Sie auf übermäßige Funkstörungen in der Umgebung.
{% endhint %}

<img src="/files/df5f125c691e2cad082edf5158195d97c5e271c6" alt="" data-size="original">
{% endstep %}

{% step %}
Gefundene Zigbee-Geräte werden dann zu Ihrem CUBE OS hinzugefügt und können einem Raum zugewiesen oder umbenannt werden.

<img src="/files/5e31ed6b1a2ad814bcd6468f3d4a402e4db531ab" alt="" data-size="original">
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Die Gesamtzahl der Zigbee-Geräte, die hinzugefügt werden können, ist begrenzt und hängt von der Hardware und Firmware des Adapters ab.

In bestimmten Fällen müssen Sie zusätzliche Router-Geräte hinzufügen (z. B. smarte Steckdosen, Lampen, Signalverstärker), um mehr batteriebetriebene Geräte wie Sensoren hinzufügen zu können.
{% endhint %}

## 4. Mögliche Kompatibilität

CUBE ist **mit Hunderten von Zigbee-Geräten kompatibel**. Allerdings gibt es aufgrund der Komplexität und der großen Bandbreite an Geräten erhebliche Unterschiede zwischen Produkten verschiedener Hersteller. Das bedeutet, dass die Kompatibilität mit allen Geräten nicht garantiert werden kann, Verbesserungen werden jedoch schrittweise vorgenommen.

Bitte prüfen Sie <https://cube-web.ewelink.cc/> die Kompatibilität.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cube.ewelink.cc/german/erste-schritte/gerate-hinzufugen/zigbee-gerate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.