# Home Assistant

> Die DeckConnector-Integration für Home Assistant. Tastendrücke als Auslöser, Helligkeit, Bildschirm aus, Quelle, Deck-Bild und Updates.

Source: https://deckconnector.com/de/docs/home-assistant/

Die DeckConnector-Integration holt den Connector und jedes Deck daran in [Home Assistant](https://www.home-assistant.io/). Jeder Druck, jedes Loslassen, jede Drehung und jede Berührung kommt sofort an und kann eine Automation starten. Du stellst die Helligkeit ein, schaltest die Bildschirme aus, wählst die Quelle und siehst, was jedes Deck zeigt.

<img loading="lazy" src="/docs/ha-live-de.gif" alt="Ein Dashboard in Home Assistant: zwei Tastendrücke erscheinen im Bild des Decks und als Ereignis, dann geht die Helligkeit runter" width={860} height={297} />

<table>
<tbody>
  <tr>
    <td width="50%" valign="top"><Shot src="ha-deck-de" alt="Ein Deck in Home Assistant: Bild, Quelle und Ereignis Bedienung" width={392} height={343} /></td>
    <td width="50%" valign="top"><Shot src="ha-dashboard-de" alt="Ein Dashboard mit dem Bild des Decks, Helligkeit, Bildschirm, Quelle und Bedienung" width={532} height={622} /></td>
  </tr>
</tbody>
</table>

## Installieren

- [Mit HACS installieren](https://my.home-assistant.io/redirect/hacs_repository/?owner=FusselTV&repository=DeckConnector&category=integration)
- [Zu Home Assistant hinzufügen](https://my.home-assistant.io/redirect/config_flow_start/?domain=deckconnector)

1. **Mit HACS installieren** öffnet das Repository in deinem Home Assistant. Lade **DeckConnector** herunter und starte Home Assistant neu.
2. Home Assistant findet den Connector von selbst und bietet ihn unter **Einstellungen › Geräte & Dienste** an. Sonst nimm **Zu Home Assistant hinzufügen** und gib die Adresse des Connectors ein.

Ohne HACS öffnest du **Einstellungen › Marketplace**, wählst **Über Link hinzufügen** und fügst die Adresse des Repositorys ein.

```text
https://github.com/FusselTV/DeckConnector
```

Home Assistant legt danach seinen eigenen [API-Schlüssel](https://deckconnector.com/de/docs/security/#api-schlüssel) auf dem Connector an. **Neu konfigurieren** an der Integration ändert die Adresse des Connectors und behält den Schlüssel.

## Was du bekommst

Der Connector ist ein Gerät, jedes Deck ein Gerät dahinter. Ein Deck, das du später ansteckst, erscheint sofort.

Diese sind zuerst deaktiviert. Schalte sie am Gerät ein, wenn du sie brauchst:

- **WLAN-Signal**, **WLAN-Netz** und **Letzter Neustart** des Connectors.
- Das Update **Firmware**. Damit fragt der Connector alle 6 Stunden bei GitHub nach neuen Versionen.
- **PIN-Sperre** eines Decks. Sie zeigt, ob Companion das Deck mit seiner PIN gesperrt hat.
- **Neu verbinden** eines Decks. Es schaltet den USB-Anschluss aus und wieder ein, für ein Deck, das hängt.

**Finden** und den Mediaplayer **Lautsprecher** gibt es nur, solange **Lautsprecher angeschlossen** in der Weboberfläche an ist. Ändert sich das, kommen und gehen sie von selbst. **Bildschirm aus nach** ist in Minuten, 0 heißt nie. **Bildschirmschoner-Helligkeit** ist die Stufe, auf die die Decks nach dieser Zeit dimmen. 0 schaltet sie aus.

Der **Lautsprecher** spielt Sprachausgabe und Audiodateien aus dem Medienbrowser. Home Assistant wandelt sie mit ffmpeg um, also geht jedes Format, das ffmpeg liest. Der Ton ist mono mit 16 kHz. Webradio und Music Assistant gehen auch und spielen, bis du sie stoppst. Ein neues Stück oder **Finden** beendet das laufende.

Der Connector schickt jede Änderung sofort. Signal und Temperatur kommen einmal pro Minute.

## Automationen

Wähl im Automationseditor **Gerät**, dann das Deck, dann einen Auslöser wie **Taste 3 gedrückt**, **Drehregler 1 nach rechts gedreht**, **Touchfeld 2 angetippt** oder **Touchleiste nach links gewischt**.

Jedes Deck hat außerdem eine Ereignis-Entität **Bedienung** für YAML und Templates. Ihr `event_type` sagt, was passiert ist, zum Beispiel `key_3_press`. Eine Drehung bringt `ticks` mit, eine Berührung `x` und `y`. Tippen und langes Berühren bringen auch das Feld als `zone` mit.

```yaml
triggers:
  - trigger: state
    entity_id: event.stream_deck_bedienung
    not_from: unavailable
    not_to: [unavailable, unknown]
conditions:
  - condition: state
    entity_id: event.stream_deck_bedienung
    attribute: event_type
    state: key_3_press
actions:
  - action: light.toggle
    target:
      entity_id: light.desk
```

Home Assistant zeichnet die Tasten nicht. Das macht die aktive [Quelle](https://deckconnector.com/de/docs/hosts/). Ohne Quelle zeigt das Deck seinen Startbildschirm, auf dem einige Tasten Quellen wechseln oder das Menü öffnen. Jeder Tastendruck kommt trotzdem bei Home Assistant an, und eine Taste, die auch eine Quelle nutzt, löst beide Aktionen aus.

### Blueprint

[Blueprint in Home Assistant importieren](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgithub.com%2FFusselTV%2FDeckConnector%2Fblob%2Fmain%2Fblueprints%2Fautomation%2Fdeckconnector%2Fdial_light.yaml)

**Drehregler dimmt ein Licht.** Nach rechts heller, nach links dunkler. Ein Druck auf den Drehregler schaltet das Licht ein oder aus.

## Apple Home

Die [HomeKit Bridge](https://www.home-assistant.io/integrations/homekit/) zeigt ein Deck in der Home-App als Reihe von Tasten. Öffne die Optionen der HomeKit Bridge im Bridge-Modus und wähl das Deck unter **Geräte (Trigger)**. Jeder Tastendruck, jeder Druck und jede Drehung eines Drehreglers und jede Berührung ist eine Taste.

## Gut zu wissen

- Home Assistant spricht mit dem Connector über HTTP auf Port 80.
- Tastendrücke vom Live-Deck der Weboberfläche kommen bei Home Assistant an. Tastendrücke aus Skripten nur mit `"real": true`. Home Assistant drückt nie etwas am Deck.
- Nach einem Firmware-Update lädt sich die Integration selbst neu, neue Entitäten erscheinen dann.
- Der Logger heißt `custom_components.deckconnector`.

## Fehlersuche

Probleme, die Home Assistant beheben kann, stehen unter **Einstellungen › Reparaturen**.

Sind alle Entitäten nicht verfügbar, erreicht Home Assistant den Connector nicht. Öffne die Adresse des Connectors im Browser. Hat sich die Adresse geändert, nimm **Neu konfigurieren**.

Für einen Fehlerbericht nimm **Diagnosedaten herunterladen** am Gerät des Connectors. Schlüssel, Adressen und Seriennummern fehlen darin.

Next: [API](https://deckconnector.com/de/docs/api/), [Zugang und Sicherheit](https://deckconnector.com/de/docs/security/)
