Components Home Assistant (Apple) "HomeKit"

8 Minuten des Lesens
ProLeiter: Home Assistant Community
Verfügbarkeit: enthalten in derHUB Personal Home Assistant
Kategorie: Software
Typologie: Komponenten Home Assistant
Implementierungsschwierigkeiten: bassa
Kartenrevision: 1

Die Komponente "HomeKit" (verstanden als Appdas HomeKit) von Home Assistant dient zum Freilegen der Wesen in der Konfiguration vorhanden Home Assistant in Richtung derapp"Haus" -Anzeige von Appdas iOS /macOS.Appdas Logo

In der Praxis Benutzer Apple dass keine wollen benutze dieapp Handy von Home Assistant und möchte es stattdessen verwenden (oder nebeneinander, warum nicht) 'Sapp "Heimat" von Apple um das zu überprüfen proerste Hausautomation basierend auf Home Assistant andere dürfen das nicht tun Konfigurieren Sie diese Komponente.

In der Praxis es ist als ob Home Assistant werde ein BRIDGE/Gateway kompatibel mit Appdie HomeKits.

Automatisch - nach einer ersten, einfachen procedura - dieapp "House" erbt alle Entitäten (Lichter, Schalter, Klimasysteme usw.) konfiguriert bei Home Assistant. Jede Handlung, die von anderen (oder von Automatismen im Sein) für die Zustände dieser Entitäten ausgeführt wird wird reflektiert auf die Staaten an derapp "Zuhause" und umgekehrt.
Wenn zum Beispiel Wir machten ein Licht an Mittel Home Assistant, dieses Element appes leuchtet sofort auf auch aufapp "Zuhause" und umgekehrt.

Die exportierbaren Einheiten in Richtung Appdas "Haus" Sie sind anders: kann ganze Zahlen sein domini (zB "alle Lichter") oder Entitäten singole (zB "Küchenlicht"). Es ist auch möglich, selektiv zu konfigurieren was auszustellen und was nicht.

Questo componente es ist besonders nützlich für diejenigen, die einen intelligenten Lautsprecher besitzen Appdie HomePods und wollen das überprüfen proerste Hausautomation basierend auf Home Assistant mit dem sprachassistenten Siri (oder ein Gerät mit diesem Assistenten, siehe iPhone / iPad oder macOS neueste Versionen). Sobald die Entitäten ausgesetzt wurden Home Assistant zu Appdie HomeKits, in der Tat, Siri wird sie automatisch "sehen" und regieren können.
Wir haben dieses spezielle Thema gewidmet un FOCUS spezifisch.

VORSICHT. Diese Komponente es ist nicht zu verwechseln mit der Komponente "iOS", Die einem ganz anderen Zweck dient, nämlich dafür zu sorgen, dass dieappHome Assistant"Für Appdas iOS es schaffen, richtig zu verbinden unsere Home Assistant und biete ihm die proIhre Funktionalität (definieren Sie ein "Device Tracker, Benachrichtigungen push etc.).

VORSICHT. Diese Komponente es ist nicht zu verwechseln nicht einmal mit der Komponente "HomeKit-Controller-Unterstützung", Was dazu dient, das zu gewährleisten Home Assistant automatisch erkennen alle kompatiblen Geräte Appdie HomeKits und „hol sie dir propri ”, so dass sie sich registrieren und überprüfen können.

INDEX

Grundlegende Anforderungen

Für Benutzer von Home Assistant auf Raspberry im Modus installiert Raspbian +Home Assistant o HASSBIAN Möglicherweise ist eine zusätzliche Installation der Bibliothek erforderlich avahi für die Kompatibilität mit dem Dienst Apple Bonjour.

Für die Installation, Führen Sie den Befehl aus:

sudo apt-get install libavahi-compat-libdnssd-dev

Distributionsbenutzer HASSIO Sie benötigen keine zusätzliche Installation.

Konfiguration

Aktivieren die Funktionen der Komponente "HomeKit"Es reicht aus, in der configurazione di Home Assistant, der folgende minimale Block:

homekit:

Nach dem Neustart Home Assistantam Web-Frontend appeine Box mit der PIN für Appdie HomeKits:

Home Assistant - HomeKit-Code

Jetzt öffne dieapp"Home" iOS und drücken Sie "Zubehör hinzufügen".
Dann drücke auf “Ich habe keinen Code"Und danach"Code eingeben".

Sie werden aufgefordert, den obigen Code einzugeben. Legen Sie es ein und warten Sie: am Ende des procedura, le Wesen (zumindest die förderfähigen) von Home Assistant appsie werden gelistet und kontrolliert beiHaus".

Komponentenanpassung

Die Komponente bietet verschiedene Felder, um die Belichtung (sowie die Filterung) der Entitäten für HomeKit anzupassen.

homekit:
Auto-Start(Boolean, optional) Richten Sie die Integration mit HomeKit beim Start als automatisch ein Home Assistant (Standard: wahr)
port(Ganzzahl, optional) Definiert den Port tcp/ip auf dem das zu betreiben ist BRIDGE zu HomeKit (Standard: 51827)
name(Zeichenfolge, optional) Definiert den Namen der BRIDGE Presso l 'app Appdas "Haus" (default: "Home Assistant Bridge„). Die minimale Anzahl von Zeichen ist 3, die maximale 25.
ip_address(Zeichenfolge, optional) Gibt an, welche IP-Adresse verwendet werden soll (falls das Gerät gehostet wird) Home Assistant haben mehrere Schnittstellen / IPs) für die Integration
safe_mode(Boolescher Wert, optional) Wird im Fall von auf "true" gesetzt proProbleme beim Pairing mit demapp Appdas "Haus" (default: false)
filter(mappa, optional) Definiert, welche Entitäten und / oder Domänen von der Exposition gegenüber HomeKit einbezogen / ausgeschlossen werden sollen. In Abwesenheit dieses Blocks Home Assistant macht alles verfügbar, was in Frage kommt.

include_domains(Liste, optional) Listet die Domänen auf, die eingeschlossen werden sollen
include_entities(Liste, optional) Listet die Entitäten auf, die einbezogen werden sollen
exclude_domains(Liste, optional) Listet die auszuschließenden Domänen auf
excude_entites(Liste, optional) Listet die Objekte auf, die ausgeschlossen werden sollen
entity_config(mappa, optional) Definiert Anpassungen einzelner Entitäten in Richtung HomeKit. jeder nome_entità erlaubt eins proPria-Personalisierung (zB light.cucina)

nome_entità
name(Zeichenfolge, optional) Der Name der Entität amapp Appdas "Haus"
code(Zeichenfolge, optional) Der Code zum Aktivieren / Deaktivieren von a Alarm oder ein Schloss öffnen / schließen. AppNur für Entitäten vom Typ "Alarm Control Panel" und "Lock" geeignet (Standard: kein Code)
feature_list(Liste, optional) Nur gültig für Typentitäten "Media Player“. Die Liste darf nur Elemente enthalten, die auf der verwendeten Plattform bereitgestellt werden (z. B. "Broalink IR Media Player"Dient zum Domotisieren von Fernsehgeräten, HiFi-Systemen usw.)

Feature(Zeichenfolge, Anforderung) Name der Funktion, die für die angepasste Entität verfügbar ist. Gültige Beispiele sind "on_off","play_pause"Etc.
type(Zeichenfolge, optional) Gibt den Typ des Zubehörs an, an das gesendet werden soll Appdas "Casa", falls das Startobjekt vom Typ "" istSwitch“. Gültige Typen sind "Wasserhahn", "Auslauf", "Dusche", "Sprinkler", "Schalter" und "Ventil".

HomeKit speichert dies zwischen proEigenschaft, wenn also diese Konfiguration geändert wird, so dass sie bei wirksam wird Appden "Häusern" ist es notwendig, die Integration zu entfernen (die BRIDGE) und lege es zurück.

Verschiedene Überlegungen

ZUBEHÖR-ID

Die Komponente verwendet die ID Wesen bei Home Assistant um eine entsprechende Zubehör-ID bei HomeKit zu generieren, mit der alle Anpassungen verknüpft werden können. Das versteht sich von selbst eine Änderung der Entitäts-ID Du wirst verlieren gegen Home Assistant die Anpassungen, die ihm zuvor von zugewiesen wurden appzu HomeKit gehen.

ZUBEHÖRGRENZWERT

HomeKit akzeptiert bis zu 100 Zubehör für BRIDGE. Wichtiger Hinweis, wenn Sie dies tun proSiehe zum Konfigurieren der Einschlüsse und Ausschlüsse der Domänen / Entitäten in der Konfiguration.

DAUERHAFTE LAGERUNG

Leider bietet HomeKit keinen dauerhaften Speicher, was bedeutet, dass beim Start Home Assistant Bestimmte Einheiten sind noch nicht prozu verwenden (vielleicht startet eine bestimmte Integration noch / zieht eine Bestandsaufnahme der Komponenten), die entsprechenden Entitäten an Appdas "Haus" verschwinden.

Um dies zu vermeiden, wird empfohlen, den automatischen Start zu deaktivieren und die Automatisierungen so zu konfigurieren, dass die "HomeKit" -Komponente nur dann gestartet wird, wenn es tatsächlich Zeit ist.

Auto-Start ausschalten

Wie bereits erläutert, kann es hilfreich sein, den automatischen Start dieser Komponente zu deaktivieren:

homekit:
  auto_start: False

Um die Komponente später zu starten, können Sie den Dienst "homekit.start".

Nehmen wir das Beispiel von etwas Wesen basierend auf integration Z-Wave Solange die Integration nicht funktioniert, müssen wir "HomeKit" nicht starten.

Eine nützliche Automatisierung für diesen Zweck könnte sein:

automation:
  - alias: 'Avvio HomeKit al momento giusto'
    trigger:
      - platform: event
        event_type: zwave.network_ready
      - platform: event
        event_type: zwave.network_complete
      - platform: event
        event_type: zwave.network_complete_some_dead
    action:
      - service: homekit.start

Wie zu sehen ist, wird erwartet, dass alle Ereignisse im Zusammenhang mit der Einführung von Z-Ware abgeschlossen sein werden, um anschließend "HomeKit" zu starten.

Es kann auch nützlich sein, es nach einer festgelegten Zeit zu starten:

automation:
  - alias: 'Avvio temporizzato di HomeKit'
    trigger:
      - platform: homeassistant
        event: start
    action:
      - delay: 00:05  # Attende cinque minuti
      - service: homekit.start

Filterkonfiguration

Wie erwartet, in Abwesenheit von Filtern Home Assistant (im Falle der Aktivierung dieser Komponente) setzt es keine Grenzen und macht keine sichtbar Wesen in Richtung HomeKit.

Ein Beispiel für einen Konfigurationstyp:

homekit:
  filter:
    include_domains:
      - alarm_control_panel
      - light
    exclude_entities:
      - light.cucina

In diesem Fall sind enthalten alle möglichen "Alarm Control Panel" (Alarm) und alle Lichter; es ist ausgeschlossen stattdessen ein einziges Licht, das der Küche.

Unterstützte Domains / Entitäten sind die folgenden:

ComponentsTypologieBeschreibung
alarm_control_panelSicherheitssystemeAlle Sicherheitssysteme.
automation / input_boolean / remote / scene / scriptSchalterAlle Komponenten rappals Ein- / Ausschalter ausgeführt.
binary_sensorSensoriUnterstützt Geräte vom Typ "co2","door","garage_door","gas","moisture","motion","occupancy","opening","smoke"Und"window“. Alles andere fällt in den Typ "occupancy".
climateThermostateAlle Klimatypen.
coverGaragentoröffnungAlle Verschlüsse, die unterstützen "open"Und"close"Und haben"garage"Das"device_class"Assoziiert.
Darks finestraAlle Achsen, die unterstützen "set_cover_position".
Alle Achsen, die unterstützen "open_cover"Und"close_cover"Durch mappvon Werten (offen> = 50, geschlossen <50).
Alle Achsen, die unterstützen "open_cover","stop_cover"Und"close_cover"Durch mappWerteingabe (open> 70, closed <30, Stop eines beliebigen Wertes im Intervall).
device_trackerSensoriUnterstützung für i device vom Typ "occupancy".
fanLüfter / FansUnterstützung für "on/off","direction"Und"oscillating".
lightBeleuchtungUnterstützung für "on/off","brightness"Und"rgb_color".
lockSchlösserUnterstützung für "lock"Und"unlock".
media_playerMedia PlayerRappdargestellt als eine Reihe von Schaltern, die "on/off","play/pause","play/stop","mute"Basierend auf"supported_features"Und die Listen"mode”Wird für die jeweilige Entität bereitgestellt.
sensorSensorIch der TemperaturAlle thermischen Sensoren, die sie haben Celsius und / oder Fahrenheit als Maßeinheit.
Sensorich von LuftfeuchtigkeitAlle Feuchtesensoren, die den Prozentsatz als Maßeinheit haben.
Sensorich der LuftqualitätAlle Sensoren, die "pm25Welches Element der proEigenschaften.
Sensori von KohlenmonoxidAlle Sensoren, die "coWelches Element der proEigenschaften.
Sensorich von KohlendioxidAlle Sensoren, die "co2Welches Element der proEigenschaften.
Sensordes lumiBrillanzAlle Sensoren, die "lm"Oder"lxWelche Elemente der proEigenschaften.
switchSchalterRappals Schalter gemacht. Sie können über das Feld "Personalisierung" als Typ geändert werden.type".
water_heaterWarmwasserbereiterAlle Warmwasserbereiter.

Auflösung von proProbleme

Löschen der .HOMEKIT.STATE-Datei

Im Fall von proProbleme mit der Integration ist es möglich, einfach zum Nullpunkt zurückzukehren:

  1. dann stoppen Home Assistant
  2. Löschen der .HOMEKIT.STATE-Datei
  3. Neustart Home Assistant

Fehler beim Pairing

Im Fall von proProbleme beim Pairing zwischen Home Assistant und l 'applished hier Appdas "Haus", prosiehe wie folgt:

  1. stoppen Home Assistant
  2. Löschen Sie die Datei .HOMEKIT.STATE
  3. ändere die Konfiguration von Home Assistant (siehe unten)
  4. Wiederaufnahme Home Assistant

Promodifiziert werden die Konfiguration wie folgt:

logger:
  default: warning
  logs:
    homeassistant.components.homekit: debug
    pyhap: debug

homekit:
  filter:
    include_entities:
      - demo.demo
PIN zum Pairing nicht appsind

Möglicherweise haben Sie die Kopplung bereits verwendet. Löschen Sie die Datei .homekit.state.

Home Assistant keine appsind wie BRIDGE su Apple Casa

Es ist in der Regel ein proNetzwerkproblem. Stellen Sie sicher, dass Sie sich im selben lokalen Netzwerk wie befinden Home Assistant.
Provare ändern auch die default_port.

Home Assistant (im Docker) nicht appsind wie BRIDGE su Apple Casa

Set network_mode: host

Home Assistant (auf VirtualBox) nicht appsind wie BRIDGE su Apple Casa

Konfigurieren Sie den Netzwerkmodus als Netzwerkbridge. Ansonsten die BRIDGE wird nicht dem Netzwerk ausgesetzt (und wird daher nicht funktionieren).

Das Pairing schlägt fehl - ZeroConf-Fehler

Wenn die Kopplung fehlschlägt, sollte dies der Fall sein appeinen Fehler machen NonUniqueNameException. Stellen Sie den Modus "Sicherheitsmodus".

Das Pairing schlägt fehl - es funktioniert nur mit der Debug-Konfiguration

Dies funktioniert nur, wenn Sie die demo.demo-Entität einschließen, schlägt jedoch unter den tatsächlichen Konfigurationsbedingungen fehl.
Leider funktionieren einige (seltene) Entitäten einfach nicht. Um das Problem zu lösen, müssen Sie die Entitäten einzeln unterscheiden, bis Sie verstanden haben, welche sie erstellen proProbleme, vielleicht mit Domänen, um die Aufgabe zu vereinfachen.

Das Pairing schlägt fehl, aber ohne Fehler

Stellen Sie sicher, dass Sie das 100-Zubehörlimit nicht überschritten haben.

Beim Hinzufügen eines Zubehörs wurden doppelte IDs gefunden

Zwei Entitäten haben dieselbe ID. Löse das proProblem oder eines der beiden auszuschließen.

Fehler im normalen Gebrauch

Einige Zubehörteile nicht appaiono, zum beispiel i Z-Wave

Siehe oben unter "Deaktivieren Sie den automatischen Start".

Eine neue Einheit Home Assistant keine appsind auf Appdas "Haus"

Stellen Sie sicher, dass Sie in der Konfiguration die Domäne, zu der Sie gehören, nicht ausgeschlossen haben appartiene. Vergewissern Sie sich, dass es gut geschrieben ist, wenn es ausdrücklich angegeben wird.

Eine Entität ist vorhanden, funktioniert aber nicht

Leider funktionieren einige (seltene) Entitäten einfach nicht. Um das Problem zu lösen, müssen Sie die Entitäten einzeln unterscheiden, bis Sie verstanden haben, welche sie erstellen proProbleme, vielleicht mit Domänen, um die Aufgabe zu vereinfachen.

Alles Zubehör bei Appdie "Häuser" "reagieren nicht"

Stellen Sie sicher, dass Sie das 100-Zubehörlimit nicht überschritten haben.

Zubehör reagiert nicht - nach Neustart oder update

Stellen Sie sicher, dass Sie das 100-Zubehörlimit nicht überschritten haben.

Einige Zubehörteile funktionieren von Zeit zu Zeit nicht

Leider passiert es. Es gibt wenig zu tun. Normalerweise fangen sie von selbst an zu arbeiten.


Home Assistant Offizielles LogoATTENZIONE: Denken Sie daran, dass es in unserer FORUM-Community gibt ein Ad-hoc-Bereich für Home Assistantfür jeden Zweifel, Frage, Information auf dem spezifischen Verdienst dieser Komponenten.


Bitte kommentieren Sie unten