# Home Assistant

Du hast Home Assistant aufgesetzt und deinen zigfred bereits über [Zigbee2MQTT ](/zigfred/extras/zigbee2mqtt.md)oder [Zigbee Home Automation](/zigfred/extras/zigbee_home_automation_for_home_assistant.md) eingebunden?

In der unglaublichen Fülle an Optionen kann man bei Home Assistant schnell mal die Übersicht verlieren. Hier präsentieren wir dir unsere persönlichen Tipps zum Einrichten und dem täglichen Gebrauch von Home Assistant.

### Standardnamen

zigfred uno und zigfred plus registrieren sich jeweils mit ihrem Standardnamen bei Home Assistant. Die erste Storen-Entität bei zigfred plus heisst zum Beispiel `cover.0xf4ce368a38be56a1_l6`, Das LED-Licht von zigfred uno `light.0xf4ce368a38be1337_l1`. Das mag zuerst kompliziert erscheinen, hat aber System, und kann das Setup beschleunigen:

* Der erste Teil, `cover`, gibt den Typ der Entität an als Storen, Markise oder Jalousie an.
* Der zweite Teil `0xf4ce368a38be56a1`, ist die global einzigartige Zigbee-Adresse des entsprechenden zigfreds.
* Der letzte Teil `l6` identifiziert den 6. Endpunkt von zigfred plus als Storen-Kanal (das `l` steht für *Load)*.

Die Namen sind jeweils fix. In der folgenden Tabelle findest du daher die Muster für zigfred uno und zigfred plus:

<table><thead><tr><th width="145">zigfred</th><th>Typ</th><th width="101">Load</th><th>Zigbee Endpunkt</th><th width="153">Funktion</th><th>Kanal</th></tr></thead><tbody><tr><td>zigfred uno</td><td><code>light</code></td><td><code>l1</code></td><td><code>0x05</code></td><td>RGB-LED an Tastenmodul</td><td></td></tr><tr><td>zigfred uno</td><td><code>switch</code></td><td><code>l2</code></td><td><code>0x06</code></td><td>Relais*</td><td>X1, X2</td></tr><tr><td>zigfred uno</td><td><code>light</code></td><td><code>l3</code></td><td><code>0x07</code></td><td>Dimmer**</td><td>D</td></tr><tr><td>zigfred plus</td><td><code>light</code></td><td><code>l1</code></td><td><code>0x05</code></td><td>RGB-LED an Tastenmodul</td><td></td></tr><tr><td>zigfred plus</td><td><code>light</code></td><td><code>l2</code></td><td><code>0x07</code></td><td>Dimmer 1**</td><td>D1 (D2***)</td></tr><tr><td>zigfred plus</td><td><code>light</code></td><td><code>l3</code></td><td><code>0x08</code></td><td>Dimmer 2**</td><td>D2</td></tr><tr><td>zigfred plus</td><td><code>light</code></td><td><code>l4</code></td><td><code>0x09</code></td><td>Dimmer 3**</td><td>D3 (D4***)</td></tr><tr><td>zigfred plus</td><td><code>light</code></td><td><code>l5</code></td><td><code>0x0a</code></td><td>Dimmer 4**</td><td>D4</td></tr><tr><td>zigfred plus</td><td><code>cover</code></td><td><code>l6</code></td><td><code>0x0b</code></td><td>Storen 1</td><td>D1 &#x26; D2</td></tr><tr><td>zigfred plus</td><td><code>cover</code></td><td><code>l7</code></td><td><code>0x0c</code></td><td>Storen 2</td><td>D3 &#x26; D4</td></tr></tbody></table>

\*Auch für Wechselschaltung, Schaltsteckdose

\*\*Auch für Ein/Aus-Konfiguration auf Dimmer, Schrittschaltung

\*\*\*Gekoppelter Kanal bei Wechselschaltung am zigfred plus

### Alles Unbenötigte deaktivieren

Home Assistant hat den Segen und Fluch, dass es von deinem zigfred in der Küche, bis zum Laserdrucker im Büro so ziemlich alles automatisch erkennt und anzeigt. Wenn du nun eine neue Kachel in deinem Dashboard, eine neue Automation, Szene oder Gruppe hinzufügst, tauchen auch  viele unbenötigte Geräte oder *Entitäten* als Option aus. Möchtest du, dass einzelne *Entitäten* nicht mehr eingeblendet werden, kannst du diese unter *Einstellungen -> Geräte und Dienste -> Entitäten* auswählen und deaktivieren. Möchtest du nur die Zigbee-Geräte aus Zigbee2MQTT in der Liste anzeigen, kannst du unter *Einstellungen -> Geräte und Dienste -> Integrationen* in der MQTT-Integration auf den Entitäten-Link klicken (z.B. "3 Entitäten").

### Bereiche zuweisen

Bereiche kannst du unter *Einstellungen -> Bereiche & Zonen* erstellen. Anschliessend kannst du diese jeder einzelnen Entität unter *Einstellungen -> Geräte und Dienste -> Entitäten* zuweisen. Bereiche sind vor allem nützlich um im bei der Suche nach Geräten oder beim automatischen Hinzufügen von Entitäten im Dashboard die Übersicht zu behalten.

### Gruppen

Gruppen ermöglichen es, mehrere physische Entitäten als eine einzelne logische Entität  zusammenzufassen. So können zum Beispiel alle Storen im Wohnzimmer über eine einzelne Kachel zusammen gesteuert, oder alle Leuchten im Bad per Sprachbefehl gedimmt werden.

Um Gruppen zu erstellen, musst du dazu aber zuerst die Gruppen-Integration aktivieren. Gehe dazu unter *Einstellungen -> Geräte und Dienste -> Integrationen* und drück *Integration hinzufügen* (blauer Knopf unten rechts). Suche nach *group (helper)* und bestätige. Anschliessend kannst du gleich deine erste Gruppe erstellen. Unter *Einstellungen -> Geräte und Dienste -> Helfer* und Druck auf *Helfer erstellen* kannst du weiter Gruppen zusammenstellen.

### Ein/Aus Lichter

Lichter am Relais des zigfred uno werden standardmässig als *switch* registriert. Damit das Relais mit einer Lichtgruppe zusammenspielen kann, kannst du unter *Einstellungen -> Geräte und Dienste -> Integrationen* den Typ von *switch* auf *light* umkonfigurieren.

### Ein schöneres Dashboard

Die standarmässig integrierten Dashboard-Karten für Home Assistant entsprechen nicht immer dem eigenen Geschmack oder lassen die Geräte nicht immer nach Wunsch steuern.

Persönlich setzen wir auf die Erweiterung [Mushroom](https://github.com/piitaya/lovelace-mushroom) die zusätzliche moderne und schöne Dashboard-Karten in Home Assistant hinzufügt. Unsere eigene Version von Mushroom bietet ausserdem die Möglichkeit, die Storen-Neigung gleich auch mitzusteuern (diese Erweiterung wird in Zukunft auch in der offiziellen Version von Mushroom erhältlich sein).

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

Um das Setup zu vereinfachen haben wir seitens zigfred ein eigenes [Addon ](https://github.com/Siglis-AG/zigfred-hassio-addons)entwickelt, dass die Mushroom-Karten (inklusive Unterstützung für die Storenneigung) einspielt.

Unter *Einstellungen -> Add-ons -> Add-on Store* klickst du oben rechts im 3-Punkte-Menü auf *Repositories* und fügst folgenden Link hinzu:&#x20;

```
https://github.com/Siglis-AG/zigfred-hassio-addons
```

Nach einem Neuladen sollte unter *Home Assistant Add-ons for zigfred* die Erweiterung *Mushroom* auftauchen. Diese kannst du nun installieren und starten. Du solltest ausserdem den *Start beim Boot* aktivieren.

Nun aktivierst du unten links unter deinem Profil noch die Option *Erweiterter Modus*. Im Menü *Einstellungen -> Dashboards* kannst du im 3-Punkte-Menü oben rechts *Ressourcen* anklicken. Nach dem Klick auf *Ressource hinzufügen* trägst du `/local/mushroom.js` als URL ein und wählst den Typ Javascript-Modul.

Nun kannst du beim Editieren die Mushroom-Karten hinzufügen.

#### CSS Styling

Mushroom lässt sich dank CSS-Variablen nach Belieben umstylen. Dazu musst du in Home Assistant im Ordner `/www/` eine neue Datei `style.css` anlegen (z.B. mit dem Editor-Addon *Studio Code Server*) mit folgendem Beispiel-Inhalt:

```css
html {
  --mush-control-height: 24px; /*
}
```

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

Anschliessend musst du noch die *Stylesheet-*&#x52;essource `/local/style.css` im Dashboard-Menü hinzufügen. Das Stylesheet wird nun mitgeladen. Die Slieder sollten nun deutlich schmaler angezeigt werden:

![](/files/heCEQHBUJIuVszwwkpP6)

Eine Liste aller CSS-Variablen findest du [hier](https://github.com/piitaya/lovelace-mushroom/blob/main/src/utils/theme.ts).

### Google Home & Cloud

Um dein auch via Internet oder Google Sprachassistent zu bedienen, empfehlen wir dir die Anbindung an die Cloud-Dienste von Nabu Casa, der Firma hinter Home Assistant. Unter <https://www.nabucasa.com/> findest du weitere Hilfe.

### Hilfe benötigt?

Du hast ein Projekt im Sinne, hast aber Probleme beim Einrichten? Wir helfen dir beim Setup und der Programmierung auf Stundenbasis sehr gerne weiter. Schicke uns einfach eine Anfrage an <support@zigfred.ch>


---

# 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://docs.zigfred.ch/zigfred/extras/home-assistant.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.