Quelltext der Seite Zigbee

=Allgemeines=
Erst war ich skeptisch, ob Zigbee das Richtige als Ergaenzung fuer mein EIB/KNX ist. Es gab tatsaechlich in meinem Haus einen Fall, bei dem die vorhandene Elektroinstallation es nicht erlaubte eine Leuchte direkt (ohne Kernbohrungdurch die Stahlbetondecke) an den KNX anzuschlieszen. WLAN fuer 230V-Schalter war fuer mich OK. 
Die Datenerfassung von Temperatur, Praesenz, usw. per KNX war an vielen Stellen aber schlecht oder gar nicht moeglich. Neben WLAN habe ich jetzt noch ein Zigbee-Netz installiert.

=Vorabueberlegungen=
* Matter ist keine Alternative. Es ist einfach noch nicht soweit.
* Ich brauche keine App-Unterstuetzung.
* Die Integration in Home Assistant soll nur ueber MQTT laufen.

NB: HA zu einer Eierlegendenwollmilchsau zu machen halte ich fuer keine gute Idee. Das heiszt fuer mich so viel als geht in MQTT zentieren und in HA (oder FHEM) die Automation hinterlegen. ZHA ist ueberfluessig. Zigbee2MQTT im docker auf meinem Homeserver war die beste Wahl.

=Startschwierigkeiten=
Nach der Installation von Zigbee2MQTT auf dem Homeserver habe ich auch eine Zigbee-Coordinator Anbindung über LAN probiert. Ich habe aber der USB-Stick Anbindung den Vorzug gegeben.

Erst hatte ich den default Kanal 11 belassen, aber schnell festgestellt, dass die Zigbees gegen mein WLAN (6 APs im Haus verteilt) nicht angkommen (Verbindungsabbrueche).

 Zigbee unbedingt Kanal 25 einstellen.

Die zweite Huerde war, dass ich die notwendige Anzahl der Router unterschaetzt habe.

 Nur steckerbetriebene Devices besitzen Routerfunktionalitaet. 

Das fuehrte dazu, dass ich 10 weitere Smartplugs installiert habe, einfach nur um das Netz zu stabilieren.

 Der durchschnittliche Abstand fuer ein stabiles Netz ist beim mir etwa 5 Meter.

Was ich nervig finde ist, dass auf den Devices die IEEE-Address nicht abgedruckt ist. Ich habe schon nach den ersten 10 Devices (mittlerweile ueber 50) den Ueberblick verloren. Also alles auf Anfang und nach jedem Join direkt die IEEE-Address auf das Device geschrieben und gleich in Zigbee2MQTT den Installationsort in der Device-Beschreibung vermerkt.

=HA Automation=

HA ist zwar ganz nett, aber das unendliche Geklicke nur um einen Schalter mit einem Socket (Geraet) zu verbinden finde ich nervig.

Was ich brauche ist schnell und einfach eine Verknuepfung Zigbee -> MQTT -> Zigbee/KNX  oder KNX -> MQTT -> Zigbee

Um die Zigbee/MQTT Entitaeten anzusprechen benoetige ich zu Eintragung in die 'automation.yaml' nur den entsprechenden Topic. Bei KNX habe ich noch keine einfachere Loesung gefunden als den "Umweg" ueber eine entity_id zur gehen. Hier mein erstes Testbeipsiel.

<pre>
- id: '1774891422778'
  alias: Licht_indirekt
  description: ''
  triggers:
  - trigger: mqtt
    options:
      topic: zigbee2mqtt/0x00124b002919efa7
  conditions:
  - condition: template
    value_template: '{{ trigger.payload_json.action == ''single'' }}'
  actions:
  - action: light.toggle
    metadata: {}
    data: {}
    target:
      entity_id: light.ug_r8_hobby_licht_indirekt
  mode: single
</pre>

In dem Automationen-GUI wird der Eintrag in 3 Portionen angeboten.

'''Sobald''' (triggers)
<pre>
trigger: mqtt
options:
  topic: zigbee2mqtt/0x00124b002919efa7
</pre>

'''Und wenn''' (conditions)
<pre>
condition: template
value_template: "{{ trigger.payload_json.action == 'single' }}"
</pre>

'''Dann'''
<pre>
action: light.toggle
metadata: {}
data: {}
target:
  entity_id: light.ug_r8_hobby_licht_indirekt <- KNX.Entity
</pre>


Eine Unique_ID kann man nicht selbst vergeben! [https://www.home-assistant.io/faq/unique_id]

Um eine KNX-Gruppenadresse anzusprechen muss/sollte eine Entitaet (in der KNX YAML) angelegt sein.
Dann kann sie ueber die entity_id angesprochen werden.

Beispiel Licht:

<syntaxhighlight lang="yaml">knx:
  light:
    - name: Wohnzimmer Licht
      address: "1/2/3"</syntaxhighlight>

danach existiert die Entity:

<pre>light.wohnzimmer_licht</pre>

D.h. der Entity-Name ergibt sich aus dem Namen in LowerCase und Unterstrichen.

Eine schnelle Loesung zum Testen geht auch mit:

= Alternative: KNX direkt per Service ansprechen =

ohne vorher eine Entity anzulegen:

<syntaxhighlight lang="yaml">action:
  - service: knx.send
    data:
      address: "1/2/3"
      payload: true</syntaxhighlight>
oder:

<syntaxhighlight lang="yaml">action:
  - service: knx.send
    data:
      address: "1/2/3"
      payload: 1</syntaxhighlight>

<span id="beispiel-dimmwert-senden"></span>
= Beispiel Dimmwert senden =

<syntaxhighlight lang="yaml">action:
  - service: knx.send
    data:
      address: "1/2/5"
      payload: 50</syntaxhighlight>

=HA "Programmierung"=

Bei **Home Assistant** kannst du die `configuration.yaml` **nicht komplett per CLI neu laden**, aber du kannst:

* die Konfiguration prüfen
* Home Assistant neu starten
* einzelne YAML-Bereiche neu laden

Hier sind die relevanten Befehle.

---

# 1. Konfiguration prüfen (ohne Neustart)

```bash
ha core check
```

prüft die `configuration.yaml` auf Fehler.

---

# 2. komplette Konfiguration neu laden (Neustart)

```bash
ha core restart
```

lädt die gesamte YAML neu.

---

# 3. nur YAML neu laden (ohne Neustart)

nicht alles kann hot-reload, aber viele Bereiche schon:

```bash
ha core reload
```

lädt unterstützte YAML-Komponenten neu.

---

# 4. nur MQTT neu laden

wenn du MQTT Entities geändert hast:

```bash
ha mqtt reload
```

---

# 5. Alternative über Service Call

```bash
ha service call homeassistant.reload_core_config
```

oder z. B.:

```bash
ha service call mqtt.reload
```

---

# 6. wenn du Home Assistant Container nutzt

```bash
docker restart homeassistant
```

---

# typische Nutzung

nach Änderung:

```bash
ha core check
ha core restart
```

---

# Übersicht

| Zweck             | Befehl          |
| ----------------- | --------------- |
| config prüfen     | ha core check   |
| alles neu laden   | ha core restart |
| teilweises reload | ha core reload  |
| mqtt reload       | ha mqtt reload  |

---

wenn du möchtest, kann ich dir auch zeigen:

* welche YAML Teile ohne Neustart reloadbar sind
* wie man YAML Fehler schneller findet
* wie man config automatisch prüfen lässt

=KNX Geraete Verwirrung=

In Home Assistant bilden '''Integration, Gerät und Entität''' eine Hierarchie. Der Unterschied ist wichtig, weil viele Einstellungen davon abhängen.

Kurz gesagt:

<syntaxhighlight lang="text">Integration → Gerät → Entität</syntaxhighlight>

-----

<span id="integration"></span>
=1 Integration =

Die '''Integration''' ist die Schnittstelle zu einem System oder Protokoll.

Beispiele:

* MQTT
* KNX
* Zigbee
* Zigbee2MQTT
* ZHA
* Philips Hue

Eine Integration:

* stellt Verbindung her
* organisiert Kommunikation
* erzeugt Geräte und Entitäten


-----

<span id="gerät-device"></span>
=2 Geraet (Device) =

Ein '''Gerät''' ist ein physisches oder logisches Gerät im System.

Beispiele:

* Zigbee Temperatursensor
* KNX Aktor
* WLAN Steckdose
* Kamera

Ein Gerät kann mehrere Funktionen haben.

Beispiel Zigbee Sensor:

<syntaxhighlight lang="text">Gerät:
Temperatursensor Wohnzimmer</syntaxhighlight>
Eigenschaften:

* Hersteller
* Modell
* Firmware
* Verbindung (z. B. Zigbee Router)


-----

<span id="entität-entity"></span>
=3 Entität (Entity) =

Die '''Entität''' ist der einzelne messbare oder steuerbare Wert.

Beispiele:

<syntaxhighlight lang="text">sensor.wohnzimmer_temperatur
sensor.wohnzimmer_luftfeuchte
sensor.wohnzimmer_batterie</syntaxhighlight>
Alle gehören zum selben Gerät.

Eine Entität hat:

* Zustand (state)
* Attribute
* Einheit
* device_class


-----

<span id="beispiel-komplett"></span>
= Beispiel komplett =

<span id="zigbee-multisensor"></span>
== Zigbee Multisensor ==

<span id="integration-1"></span>
=== Integration ===

Zigbee2MQTT

<span id="gerät"></span>
=== Gerät ===

Multisensor Wohnzimmer

<span id="entitäten"></span>
=== Entitäten ===

<syntaxhighlight lang="text">sensor.wohnzimmer_temperatur
sensor.wohnzimmer_luftfeuchte
sensor.wohnzimmer_batterie
binary_sensor.wohnzimmer_bewegung</syntaxhighlight>

-----

<span id="beispiel-knx-aktor"></span>
= Beispiel KNX Aktor =

<span id="integration-2"></span>
=== Integration ===

KNX

<span id="gerät-1"></span>
=== Gerät ===

Schaltaktor Flur

<span id="entitäten-1"></span>
=== Entitäten ===

<syntaxhighlight lang="text">switch.flur_licht
sensor.flur_strom</syntaxhighlight>

-----

<span id="darstellung-im-home-assistant-ui"></span>
= Darstellung im Home Assistant UI =

<span id="integration-3"></span>
== Integration ==

<syntaxhighlight lang="text">Einstellungen → Geräte & Dienste</syntaxhighlight>
<span id="geräte"></span>
== Geräte ==

<syntaxhighlight lang="text">Geräteseite mit Eigenschaften</syntaxhighlight>
<span id="entitäten-2"></span>
== Entitäten ==

<syntaxhighlight lang="text">einzelne steuerbare Objekte</syntaxhighlight>

-----

<span id="merksatz"></span>
= Merksatz =

'''Integration''' = Verbindung zum System

'''Gerät''' = physisches Objekt

'''Entität''' = einzelne Funktion oder Messwert


-----

<span id="typische-verwechslung"></span>
= Typische Verwechslung =

Viele denken:

<syntaxhighlight lang="text">Gerät = Entität</syntaxhighlight>
Das stimmt nicht.

Ein Gerät enthält meist mehrere Entitäten.


-----

<span id="beispiel-aus-der-praxis"></span>
= Beispiel aus der Praxis =

Steckdose mit Messfunktion:

Gerät:

<syntaxhighlight lang="text">Zigbee Steckdose Küche</syntaxhighlight>
Entitäten:

<syntaxhighlight lang="text">switch.steckdose_kueche
sensor.stromverbrauch_kueche
sensor.spannung_kueche
sensor.energie_kueche</syntaxhighlight>

-----

<span id="warum-das-wichtig-ist"></span>
= Warum das wichtig ist =

Unterschied relevant für:

* Automationen
* Dashboard
* Geräteverwaltung
* Diagnose
* Gruppierung

Automationen arbeiten meist mit:

<syntaxhighlight lang="text">Entitäten</syntaxhighlight>

-----

Wenn du möchtest, kann ich dir auch zeigen:

* wie Entitäten intern aufgebaut sind
* wie entity_id entsteht
* wann Home Assistant kein Gerät erzeugt
* warum MQTT oft nur Entitäten ohne Gerät erzeugt

Bei '''KNX''' und '''Home Assistant''' treffen zwei unterschiedliche Konzepte aufeinander:

* KNX ist '''telegramm- und funktionsorientiert'''
* Home Assistant ist '''geräte- und entitätsorientiert'''

Dadurch entsteht oft Verwirrung.

<span id="gesamtübersicht"></span>
= Gesamtübersicht =

<syntaxhighlight lang="text">KNX Welt                         Home Assistant Welt
------------------------------------------------------------
physikalische Adresse  →        Gerät (Device)
Gruppenadresse         →        Entität (Entity)
Funktion im Aktor      →        Entität (Entity)
KNX Busgerät           →        Gerät (Device)</syntaxhighlight>

-----

<span id="physikalische-adresse-knx"></span>
= Physikalische Adresse (KNX) =

Die physikalische Adresse identifiziert ein '''konkretes KNX-Gerät im Bus'''.

Format:

<syntaxhighlight lang="text">Bereich.Linie.Teilnehmer
z. B.
1.1.15</syntaxhighlight>
Eigenschaften:

* eindeutig im KNX Bus
* gehört zu einem realen Gerät
* wird für Programmierung und Diagnose verwendet
* wird normalerweise '''nicht direkt in Home Assistant genutzt'''

Beispiel:

<syntaxhighlight lang="text">1.1.20 = KNX Schaltaktor im Schaltschrank</syntaxhighlight>

-----

<span id="gruppenadresse-knx"></span>
= Gruppenadresse (KNX) =

Die Gruppenadresse ist die wichtigste Adresse für die Funktion.

Format:

<syntaxhighlight lang="text">Hauptgruppe/Mittelgruppe/Untergruppe
z. B.
1/2/10</syntaxhighlight>
Sie beschreibt:

<syntaxhighlight lang="text">Funktion</syntaxhighlight>
<ol start="26" style="list-style-type: lower-alpha;">
<li>B.:</li></ol>

<syntaxhighlight lang="text">1/2/10 = Licht Wohnzimmer EIN/AUS</syntaxhighlight>
KNX arbeitet primär über Gruppenadressen.

Mehrere Geräte können dieselbe Gruppenadresse verwenden:

Beispiel:

* Taster sendet
* Aktor empfängt


-----

<span id="gerät-home-assistant"></span>
= Geraet (Home Assistant) =

Ein Geraet ist die Zusammenfassung von Funktionen eines realen Geräts.

Beispiel:

<syntaxhighlight lang="text">KNX Schaltaktor 8-fach</syntaxhighlight>
enthält mehrere Kanäle:

* Kanal A
* Kanal B
* Kanal C

In HA:

<syntaxhighlight lang="text">Gerät = KNX Aktor</syntaxhighlight>

-----

<span id="entität-home-assistant"></span>
= 4️⃣ Entitaet (Home Assistant) =

Jede Funktion eines KNX-Geräts wird eine Entität.

Beispiel:

<syntaxhighlight lang="text">switch.licht_wohnzimmer
light.kueche
cover.rollladen_buero
sensor.temperatur_bad</syntaxhighlight>
Jede Entität verwendet eine oder mehrere Gruppenadressen.


-----

<span id="beispiel-knx-schaltaktor-4-fach"></span>
= Beispiel KNX Schaltaktor 4-fach =

KNX:

physikalische Adresse:

<syntaxhighlight lang="text">1.1.20</syntaxhighlight>
Gruppenadressen:

<syntaxhighlight lang="text">1/1/1  Licht Küche
1/1/2  Licht Flur
1/1/3  Licht Bad
1/1/4  Licht Büro</syntaxhighlight>
Home Assistant:

Gerät:

<syntaxhighlight lang="text">KNX Aktor 4fach</syntaxhighlight>
Entitäten:

<syntaxhighlight lang="text">switch.licht_kueche
switch.licht_flur
switch.licht_bad
switch.licht_buero</syntaxhighlight>

-----

<span id="beispiel-configuration.yaml"></span>
= Beispiel configuration.yaml =

<syntaxhighlight lang="yaml">knx:
  switch:
    - name: licht_kueche
      address: "1/1/1"
      state_address: "1/1/101"

    - name: licht_flur
      address: "1/1/2"
      state_address: "1/1/102"</syntaxhighlight>

-----

<span id="beziehung-im-detail"></span>
= Beziehung im Detail =

<span id="physikalische-adresse"></span>
== physikalische Adresse ==

identifiziert:

<syntaxhighlight lang="text">Hardware-Gerät im KNX Bus</syntaxhighlight>
wird hauptsächlich genutzt für:

* ETS Programmierung
* Diagnose
* Busmanagement


-----

<span id="gruppenadresse"></span>
== Gruppenadresse ==

definiert:

<syntaxhighlight lang="text">Funktion im Gebäude</syntaxhighlight>
<ol start="26" style="list-style-type: lower-alpha;">
<li>B.:</li></ol>

* Licht schalten
* Dimmen
* Temperatur messen
* Jalousie fahren


-----

<span id="entität"></span>
== Entität ==

repräsentiert:

<syntaxhighlight lang="text">eine Funktion als Objekt in Home Assistant</syntaxhighlight>

-----

<span id="wichtig-zu-verstehen"></span>
= Wichtig zu verstehen =

Home Assistant kennt normalerweise:

<syntaxhighlight lang="text">Gruppenadresse</syntaxhighlight>
aber nicht zwingend:

<syntaxhighlight lang="text">physikalische Adresse</syntaxhighlight>
HA arbeitet funktionsorientiert.


-----

<span id="beispiel-taster"></span>
= Beispiel Taster =

KNX:

physikalische Adresse:

<syntaxhighlight lang="text">1.1.10</syntaxhighlight>
sendet Gruppenadresse:

<syntaxhighlight lang="text">1/1/1</syntaxhighlight>
Home Assistant:

keine eigene Entität notwendig, da der Aktor reagiert.

Optional:

<syntaxhighlight lang="text">binary_sensor.taster_wohnzimmer</syntaxhighlight>
wenn Status gewünscht.


-----

<span id="sonderfall-mehrere-gruppenadressen-pro-entität"></span>
= Sonderfall: mehrere Gruppenadressen pro Entität =

Dimmer:

<syntaxhighlight lang="yaml">knx:
  light:
    - name: wohnzimmer
      address: "1/2/1"
      state_address: "1/2/2"
      brightness_address: "1/2/3"
      brightness_state_address: "1/2/4"</syntaxhighlight>
Eine Entität nutzt mehrere Gruppenadressen.


-----

<span id="merkschema"></span>
= Merkschema =

<syntaxhighlight lang="text">physikalische Adresse
= KNX Hardware Adresse

Gruppenadresse
= KNX Funktion

Gerät
= KNX Gerät logisch zusammengefasst

Entität
= einzelne Funktion eines Geräts</syntaxhighlight>

-----

<span id="praxisregel"></span>
= Praxisregel =

Wenn du in Home Assistant arbeitest:

→ du brauchst meist nur die Gruppenadresse

die physikalische Adresse ist nur relevant für:

* ETS
* Diagnose
* Busstruktur