componentes Home Assistant (Apple) "HomeKit"

8 minutos de lectura
Proconductor: Home Assistant Comunidad
Disponibilidad: incluido en elHub personal Home Assistant
categoría: software
Tipología: componentes Home Assistant
Dificultades de implementación: bassa
Revisión de tarjeta: +1.1

El componente "HomeKit" (entendido como Appel HomeKit) de Home Assistant sirve para exponer el entidad presente en la configuración Home Assistant hacia elappIndicación de "casa" de Appel iOS /macOS.Appel logo

En la práctica, los usuarios Apple que no desear usa elapp móvil de Home Assistant y quiero usarlo en su lugar (o uno al lado del otro, ¿por qué no?) 'Sapp "Hogar" de Apple para comprobar el proprimera domótica basada en Home Assistant otros no deben hacer eso configurar este componente.

En la práctica, es como si Home Assistant convertirse en un BRIDGE/Gateway compatible con Applos HomeKits.

Automáticamente: después de un simple inicial procedura - laapp "Casa" heredará todas las entidades (luces, interruptores, sistemas climáticos, etc.) configurados en Home Assistant. Cualquier acción realizada por otros (o por automatismos en el ser) a los estados de estas entidades se reflejará en los estados en elapp "Inicio", y viceversa.
Si por ejemplo prendimos una luz medio Home Assistantese elemento appse encenderá inmediatamente también enapp "Inicio", y viceversa.

Las entidades exportables hacia Appla "casa" son diferentes: pueden ser enteros domini (por ejemplo, "todas las luces") o entidades singole (por ejemplo, "luz de cocina"). También es posible configurar selectivamente qué exhibir y qué no.

Questo componente es particularmente útil a quienes poseen un altavoz inteligente Applos HomePods y quiero comprobar el proprimera domótica basada en Home Assistant con el asistente de voz Siri (o dispositivo que todavía tiene este asistente, consulte iPhone / iPad o macOS últimas versiones). Una vez que las entidades han sido expuestas Home Assistant a Applos HomeKits, de hecho, Siri podrá automáticamente "verlos" y gobernarlos.
Hemos dedicado este tema específico un FOCUS específico.

PRECAUCIÓN. Este componente no debe confundirse con el componente "iOS", Que cumple un propósito completamente diferente, a saber, garantizar que elapp "Home Assistant"Para Appel iOS logran conectarse correctamente en nuestro Home Assistant y ofrecerle el prosu funcionalidad (defina un "Device Trackernotificaciones push etc.).

PRECAUCIÓN. Este componente no debe confundirse ni siquiera con el componente "Soporte de controlador HomeKit", Que sirve para garantizar que Home Assistant reconocer automáticamente cualquier dispositivo compatible Applos HomeKits y "consíguelos propri ”, lo que les permite registrarse y verificarlos.

ÍNDICE

Requisitos básicos

Para usuarios de Home Assistant instalado en Raspberry en modo Raspbian +Home Assistant o HASSBIAN puede ser necesaria la instalación de una biblioteca adicional avahi para compatibilidad con el servicio AppLe Bonjour.

Para la instalación, ejecutar el comando:

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

Usuarios de distribución HASSIO No necesitan ninguna instalación adicional.

Configuración

Para habilitar las funciones del componente "HomeKit"Es suficiente agregar, en el configurazione di Home Assistant, el siguiente bloque mínimo:

homekit:

Después de reiniciar Home Assistant, en la interfaz web appuna caja que contiene el PIN dedicado a Applos HomeKits:

Home Assistant - Código de HomeKit

Ahora abra elapp"Inicio" iOS y presione "Añadir accesorio".
Luego presione "No tengo codigo"Y posteriormente"Ingrese el código".

Se le pedirá que ingrese el código anterior; insértelo, luego espere: al final de la procedura, le entidad (al menos, aquellos elegibles) de Home Assistant appserán listados y controlados en "casa".

Personalización de componentes

El componente proporciona varios campos para personalizar la exposición (así como el filtrado) de las entidades a HomeKit.

homekit:
inicio automático(Booleano, opcional) Configure la integración con HomeKit como automática al iniciar Home Assistant (predeterminado: verdadero)
port(entero, opcional) Define el puerto tcp/ip en el cual operar el BRIDGE a HomeKit (predeterminado: 51827)
name(cadena, opcional) Define el nombre del BRIDGE Presso l 'app Appla "Casa" (por defecto: "Home Assistant Bridge"). El número mínimo de caracteres es 3, el máximo 25.
ip_address(cadena, opcional) Especifica qué IP usar (en caso de que el dispositivo que aloja Home Assistant tener múltiples interfaces / IP) para la integración
safe_mode(booleano, opcional) Establecer en "verdadero" en caso de proproblemas durante el emparejamiento con elapp Appla "Casa" (por defecto: falso)
filter(mappa, opcional) Define qué entidades y / o dominios incluir / excluir de la exposición a HomeKit. En ausencia de este bloque, Home Assistant expone todo lo que es elegible.

include_domains(lista, opcional) Lista los dominios que se incluirán
include_entities(lista, opcional) Lista las entidades que se incluirán
exclude_domains(lista, opcional) Lista los dominios que se excluirán
excude_entites(lista, opcional) Lista las entidades que se excluirán
entity_config(mappa, opcional) Define las personalizaciones de entidades individuales para HomeKit. cada nome_entità permite uno propersonalización de pria (p. ej. light.cucina)

nome_entità
name(cadena, opcional) El nombre de la entidad en elapp Appla "casa"
code(cadena, opcional) El código para armar / desarmar un alarma o abrir / cerrar una cerradura. Appsolo es elegible para las entidades de tipo "Panel de control de alarma" y "Bloqueo" (predeterminado: sin código)
feature_list(lista, opcional) Válido solo para entidades de tipo "Media Player". La lista puede contener solo elementos proporcionados en la plataforma en uso (por ejemplo, "Broalink IR Media Player"Utilizado para domotizar TV, sistemas de alta fidelidad, etc.)

característica(cadena, solicitud) Nombre de la función disponible para la entidad que se está personalizando. Los ejemplos válidos son "on_off","play_pause"Etc.
type(cadena, opcional) Especifica el tipo de accesorio a enviar Appla "Casa" en caso de que la entidad inicial sea de tipo "Switch". Los tipos válidos son "grifo", "salida", "ducha", "rociador", "interruptor" y "válvula".

HomeKit almacena esto en caché propropiedad, por lo que si se cambia esta configuración, para que surta efecto en Applas "Casas" es necesario eliminar la integración (las BRIDGE) y volver a colocarlo.

Varias consideraciones

ID DE ACCESORIO

El componente usa la ID entidad en Home Assistant para generar un ID de accesorio correspondiente en HomeKit al que se puedan asociar todas las personalizaciones. No hace falta decir que un cambio en la identificación de la entidad te hará perder a Home Assistant las personalizaciones previamente asignadas a él por apppara ir a HomeKit.

LÍMITE DE ACCESORIOS

HomeKit acepta hasta accesorios 100 para BRIDGE. Algo importante a tener en cuenta cuando lo haces proconsulte para configurar las inclusiones y exclusiones de los dominios / entidades en la configuración.

ALMACENAMIENTO PERSISTENTE

Lamentablemente, HomeKit no presenta almacenamiento persistente, lo que significa que si al inicio Home Assistant ciertas entidades aún no son propara usar (quizás una integración dada todavía está comenzando / haciendo balance de los componentes), las entidades correspondientes en Appla "casa" desaparecer.

Para evitar esto, se recomienda desactivar el inicio automático y configurar las automatizaciones para iniciar el componente "HomeKit" solo cuando sea realmente el momento.

Desactiva el inicio automático

Como se explicó, podría ser útil deshabilitar el inicio automático de este componente:

homekit:
  auto_start: False

Para iniciar el componente más tarde, puede usar el servicio "homekit.start".

Tomemos el ejemplo de tener algunos entidad basado en la integración Z-Wave que, mientras la integración no funcione realmente, nos obliga a no iniciar "HomeKit".

Una automatización útil para este propósito podría ser la siguiente:

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

Como se puede ver, se espera que todos los eventos relacionados con el lanzamiento de Z-Ware se completen para comenzar, posteriormente, "HomeKit".

También podría ser útil iniciarlo después de un tiempo establecido:

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

Configuración de filtro

Como se anticipó, en ausencia de filtros Home Assistant (en caso de activación de este componente) no establece ningún límite y expone entidad hacia HomeKit.

Un ejemplo de un tipo de configuración:

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

En este caso están incluidos todos los posibles "Panel de control de alarma" (alarma) y todas las luces; esta excluido en cambio una sola luz, la de la cocina.

Dominios / entidades compatibles son los siguientes:

componentesTipologíaDescripción
alarm_control_panelSistemas de seguridadTodos los sistemas de seguridad.
automation / input_boolean / remote / scene / scriptinterruptoresTodos los componentes rapphecho como interruptores de encendido / apagado.
binary_sensorSensoriSoporta dispositivos tipo "co2","door","garage_door","gas","moisture","motion","occupancy","opening","smoke"Y"window". Cualquier otra cosa cae en el tipo "occupancy".
climatetermostatosTodas las entidades de tipo climático.
coverPuerta de garaje de aperturaTodos los cierres que apoyan "open"Y"close"Y tener"garage"Eso"device_class"Asociado.
Darks finestraTodos los ejes que soportan "set_cover_position".
Todos los ejes que soportan "open_cover"Y"close_cover"A través de mapping de valores (abierto> = 50, cerrado <50).
Todos los ejes que soportan "open_cover","stop_cover"Y"close_cover"A través de mapping de valores (abierto> 70, cerrado <30, detiene cualquier valor en el intervalo).
device_trackerSensoriApoyo para i device de tipo "occupancy".
fanVentiladores /Soporte para "on/off","direction"Y"oscillating".
lightbrilloSoporte para "on/off","brightness"Y"rgb_color".
lockcabellosSoporte para "lock"Y"unlock".
media_playerReproductor multimediaRappse muestra como una serie de interruptores que admiten "on/off","play/pause","play/stop","mute"Basado en"supported_features"Y las listas"mode”Proporcionado para la entidad específica.
sensorSensori de temperaturaTodos los sensores térmicos que tienen Celsius y / o Fahrenheit como una unidad de medida.
Sensori de humedadTodos los sensores de humedad que tienen el porcentaje como unidad de medida.
Sensori de calidad del aireTodos los sensores que tienen "pm25"¿Qué elemento de la procaracterísticas
Sensori de monóxido de carbonoTodos los sensores que tienen "co"¿Qué elemento de la procaracterísticas
Sensori de dióxido de carbonoTodos los sensores que tienen "co2"¿Qué elemento de la procaracterísticas
Sensoryo lumide la brillantezTodos los sensores que tienen "lm"O"lx"Qué elementos de la procaracterísticas
switchinterruptoresRapphecho como interruptores. Se pueden cambiar como tipo utilizando el campo de personalización "type".
water_heaterCalentadores de aguaTodos los calentadores de agua.

Resolución de proproblemas

Eliminar el archivo .HOMEKIT.STATE

En el caso de los proproblemas con la integración es posible volver al punto cero simplemente:

  1. luego se detienen Home Assistant
  2. eliminar el archivo .HOMEKIT.STATE
  3. reiniciar Home Assistant

Errores durante el emparejamiento

En el caso de los proproblemas durante el emparejamiento entre Home Assistant y L 'applicación Appla "casa", prover de la siguiente manera:

  1. detener Home Assistant
  2. eliminar el archivo .HOMEKIT.STATE
  3. cambiar la configuración de Home Assistant (ver abajo)
  4. reanudar Home Assistant

Propara ser modificado la configuración de la siguiente manera:

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

homekit:
  filter:
    include_entities:
      - demo.demo
PIN para emparejamiento no appson

Es posible que ya haya utilizado el emparejamiento. Eliminar el archivo .homekit.state.

Home Assistant no appson como BRIDGE su Apple Casa

Suele ser un proproblema de red Verifique que está en la misma red local que Home Assistant.
Provare también cambiando el default_port.

Home Assistant (en Docker) no appson como BRIDGE su Apple Casa

set network_mode: host

Home Assistant (en VirtualBox) no appson como BRIDGE su Apple Casa

Configure el modo de red como redbridge. De lo contrario, el BRIDGE no estará expuesto a la red (y, por lo tanto, no funcionará).

El emparejamiento falla - error zeroconf

Si el emparejamiento falla, debería appcometer un error NonUniqueNameException. Establecer el modo "safe_mode".

El emparejamiento falla: solo funciona con la configuración de depuración

Solo funciona si incluye la entidad demo.demo, pero falla en las condiciones de configuración reales.
Desafortunadamente, algunas entidades (raras) simplemente no funcionan. Para resolverlo es necesario discriminar las entidades una a la vez hasta que comprenda cuál crea proproblemas, tal vez usando dominios para simplificar la tarea.

El emparejamiento falla pero sin errores

Verifique que no haya excedido el límite de accesorios 100.

ID duplicados encontrados al agregar un accesorio

Dos entidades comparten la misma ID. Resuelve el proproblema o para excluir uno de los dos.

Errores en el uso ordinario

Algunos accesorios no appaiono, por ejemplo yo Z-Wave

Ver arriba en "deshabilitar el inicio automático".

Una nueva entidad Home Assistant no appestán arriba Appla "casa"

Compruebe que no ha excluido en la configuración el dominio al que appartiene. Verifique que, si se incluye explícitamente, esté bien escrito.

Una entidad está presente pero no funciona.

Desafortunadamente, algunas entidades (raras) simplemente no funcionan. Para resolverlo es necesario discriminar las entidades una a la vez hasta que comprenda cuál crea proproblemas, tal vez usando dominios para simplificar la tarea.

Todos los accesorios en Applas "casas" "no responden"

Verifique que no haya excedido el límite de accesorios 100.

El accesorio no responde: después de reiniciar o update

Verifique que no haya excedido el límite de accesorios 100.

Algunos accesorios no funcionan de vez en cuando

Lamentablemente sucede. Hay poco que hacer Por lo general, comienzan a trabajar solos.


Home Assistant Logo oficialATTENZIONE: recuerda que hay en nuestra comunidad FORO una sección ad hoc dedicada a Home Assistant, para cualquier duda, pregunta, información en el mérito específico de estos componentes.


Por favor comente abajo