> For the complete documentation index, see [llms.txt](https://pekaway.gitbook.io/van-pi-dokumentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pekaway.gitbook.io/van-pi-dokumentation/integration/zigbee-community.md).

# Zigbee (Community)

Anleitung zur Einbindung von Zigbee-Geräten

#### 1. Zigbee-Stick verbinden

* **Schritt 1:** Verbinden Sie den Zigbee-Stick mit dem CORE. Verwenden Sie hierfür entsprechenden **USB-Port.**
* **VAN PI CORE** <sup>(RPI4)</sup>**: USB 2**
* **CORE PRO** <sup>(RPI5)</sup>**: USB 1**

#### 2. Webinterface aufrufen

* **Schritt 2:** Öffnen Sie das Webinterface des VanPi Core. Die Adresse lautet: `IP-Adresse:1880/ui`.
* **Schritt 3:** Navigieren Sie im Webinterface zu **Config > Wireless** und aktivieren Sie die Option **"Enable/Disable Zigbee2Mqtt"**.

<div align="left"><figure><img src="/files/hKnQv3KYKmalkj0w8rQz" alt=""><figcaption></figcaption></figure></div>

3\. Zigbee2MQTT Admin Panel aufrufen

* **Schritt 4:** Rufen Sie nun das **Zigbee2MQTT Admin Panel** auf.

#### 4. Geräte anlernen

* **Schritt 5:** Klicken Sie auf **"Anlernen aktivieren"**, um den Anlernmodus zu starten, und fügen Sie die entsprechenden Geräte hinzu.
* **Hinweis:** Die hinzugefügten Geräte erhalten eine ID, die später noch benötigt wird.

<figure><img src="/files/cdrtS68FkAKg8XAtU4Oh" alt=""><figcaption></figcaption></figure>

#### 5. Backend von VanPi OS öffnen

* **Schritt 6:** Öffnen Sie das Backend von **VanPi OS** über die Adresse: `IP-Adresse:1880`.
* **Schritt 7:** In der linken Spalte finden Sie die Kategorie **ZigBee2mqtt**. Fügen Sie hier die **"In" Node** hinzu.

![](/files/MLGC9jafQpYG1uS8HSG3)\
\
6\. Node mit MQTT-Server verbinden

* **Schritt 8:** Verbinden Sie die Node mit dem entsprechenden MQTT-Server. Öffnen Sie die Node per Doppelklick und editieren Sie den Punkt **"Server"**.
* **Schritt 9:** Tragen Sie unter **MQTT Host** den Wert **"localhost"** ein und übernehmen Sie die Einstellungen.
* **Schritt 10:** Um das hinzugefügte Gerät in der **Device-Liste** anzuzeigen, drücken Sie auf **Übernahme (Deploy)**.

<div align="left"><figure><img src="/files/Df2bPbVEW7gpggveGPhW" alt=""><figcaption></figcaption></figure></div>

7\. Gerät überprüfen

* **Schritt 11:** Öffnen Sie die hinzugefügte Node erneut und überprüfen Sie, ob die ID des Geräts unter **Device** angezeigt wird.

Damit ist Einbindung des Geräts im VanPi OS abgeschlossen, sie können nun entsprechende Nodes Hinzufügen und Aktionen ausführen.

Info: Beispiel Konfigurationen werden in Zukunft via Update nachgeliefert

**Empfohlener Stick**\
Hardware Chip: CC2652P\
Firmware: Z-Stack 3.x.0

{% embed url="<https://amzn.to/3QPLQS4>" %}

Geräte, die von Zigbee2MQTT unterstützt werden: <https://www.zigbee2mqtt.io/supported-devices/>