componentes Home Assistant "Xiaomi Gateway"

6 minutos de lectura
Proconductor: Home Assistant Comunidad
Disponibilidad: incluido en elHUB
categoría: software
Tipología: componentes Home Assistant
Dificultades de implementación: bajo
Revisión de tarjeta: +2.3

El componente "Xiaomi" Gateway" di Home Assistant es necesario integrar il BRIDGE/Gateway ZigBee↔︎TCP/IP de la línea Xiaomi Mi Smart Home (Mijia).

Cuento gateway tiene la función BRIDGE/Gateway (en la práctica, de centralizador) para todos los dispositivos ZigBee de la línea Xiaomi compuesta de sensores, interruptores, pulsos, dispositivos y más así como todos aquellos compatibles (por ejemplo, algunos de la línea IKEA TRÅDFRIo algo de Aqara).

El nombre completo del componente. en realidad sería "Xiaomi Gateway (Aqara)", Pero es un nombre extremadamente engañoso. De hecho, el componente permite SOLO la integración de gateway Xiaomi Mi (Mijia) e NO del gateway LUMI Aqara que, aunque conceptualmente es muy similar (también es un BRIDGE/Gateway ZigBee↔︎TCP/IP), no se puede integrar.

La presencia del nombre "Aqara"Se refiere al hecho de que cualquier componentes (sensores, actuadores, etc.) marcados como Aqara compatibles con gateway Xiaomi, cuando este último está integrado con Home Assistant están a su vez integrados. Lo contrario no es cierto: los componentes de Xiaomi son compatibles con un gateway Aqara NO se puede integrar indirectamente con Home Assistant como arriba, como este último NO se puede integrar con Home Assistant.

Il gateway está configurado inicialmente (para acceder a proantes de Wi-Fi) a través delapplicación "Xiaomi Mi Home" (disponible para Android e iOS) y, una vez realizada esta configuración, siempre a través deapp es posible conectar a él componentes "satelitales" conectados a él a través de proprotocolo ZigBee. Los comportamientos (es decir, notificaciones, alarmas, ajustes) de estos componentes con respecto a gateway (emisión de notificaciones audibles, visuales o hacia elapp) son administrados y gestionados por Gateway a través delapp "Xiaomi Mi Home".

Una vez configurado el gateway al proantes de Wi-Fi a través delapp "Xiaomi Mi Home", será posible integrarlo - a través del componente "Xiaomi Gateway"Descrito aquí, con el propetición para Home Assistant para:

  • integrar las mismas funciones que el gateway (emisión de efectos de sonido, iluminación - cromática - de su luz LED);
  • integrar los dispositivos / sensores / componentes posiblemente conectados al gateway mismo.
ATENCION: Para realizar esta integración es necesario que la versión de firmware del componente sea igual o menor que el 1.41.159. Un firmware superior no permite la integración descrita aquí, excepto la implementación de este orientar.

Una vez que se completa la integración il Gateway y cualquier componente satelital emergerá en Home Assistant cómo entidad de varios tipos, en función de su naturaleza (appsensores de grasa, botones, etc.).

Dispositivos compatibles
  • Gatewa Xiaomi (lumi.gateway.v2, lumi.gateway.v3)
  • LUMI Compañero de aire acondicionado Aqara (lumi.acpartner.v3)
  • LUMI Aqara Intelligent Door Lock (lock.aq1)
  • Temperatura y humedad Sensor (primera y segunda generación)
  • Movimiento Sensor (primera y segunda generación)
  • Puerta y ventana Sensor (primera y segunda generación)
  • Botón 1st generación (manejable: simple, doble, pulsación larga)
  • Botón 2nd generación (manejable: simple, doble pulsación)
  • Plug aka Socket (versión ZigBee: informa el consumo de energía, instantáneo, estado y si el dispositivo está en uso)
  • Enchufe de pared (muestra la potencia consumida, la instantánea, el estado)
  • LUMI Aqara Wall Switch (presión simple)
  • LUMI Aqara Wall Switch (doble presión)
  • LUMI Aqara Wall Switch LN (presión simple)
  • LUMI Aqara Wall Switch LN (doble pulsación)
  • LUMI Aqara inalámbrico Switch (presión simple)
  • LUMI Aqara inalámbrico Switch (doble presión)
  • LUMI/ Xiaomi Cube
  • Detector de fugas de gas (informes alarma y densidad)
  • Detector de humo (informes alarma y densidad)
  • Gateway (manejable: luz, sensor de luminosiness, riprosonidos de ducción)
  • Cortina inteligente
  • Gotera de agua Sensor
  • Vibración Sensor
  • Batería
Dispositivos no compatibles
  • Gateway LUMI Aqara
  • Gateway Radio
  • Gateway Botón
  • Compañero de aire acondicionado Xiaomi Mi (lumi.acpartner.v2)
  • LUMI Controlador inteligente de aire acondicionado Aqara Hub (lumi.acpartner.v1)
  • Modo desacoplado del Muro de Aqara Switches (simple y doble pulsación)
  • Eventos de alarma adicionales del detector de gas y humo: alarma analógica, alarma de falla de batería, alarma de falla de sensibilidad, falla de comunicación I2C

NB La lista evoluciona constantemente en la página oficial del componente.

guiar

La guía detallada para la integración es la siguiente:

Integrar el Gateway Xiaomi Mi Smart Home a Home Assistant

Configuración

El bloque de código que se ingresará en la configuración de Home Assistant lo que permite integrar el gateway es la siguiente:

xiaomi_aqara:
  discovery_retry: 5
  gateways:
    - key: xxxxxxxxxxxxxxxx

Por si hay más presentes gateway, la sintaxis es la siguiente:

xiaomi_aqara:
  gateways:
    - mac: xxxxxxxxxxxx
      key: xxxxxxxxxxxxxxxx
    - mac: xxxxxxxxxxxx
      key: xxxxxxxxxxxxxxxx

Las variables disponible para personalizar la configuración son los siguientes:

interface(cadena, opcional): la interfaz de red desde la que buscar la presencia de gateway.
discovery_retry(interno, opcional): el número de veces que Home Assistant vuelva a intentar la conexión a gateway en caso de quiebra Predeterminado: 3
gateway(mapa, requerido) - La lista de gateway para ser integrado

mac(cadena) - Il MAC Dirección del gateway. Opcional en caso de que solo haya uno gateway.
clave(cadena, solicitud): la clave de acceso LAN para gateway (explicado en guía dedicada a la integración de Gateway su Home Assistant).
host(cadena, opcional): la dirección IP del gateway. Se utiliza en caso de que no desee utilizar el descubrimiento automático de multidifusión.
inhabilitar(Booleano, opcional): deshabilite gateway. Se utiliza para no integrar un determinado gateway en el caso de más copresencia gateway.

Servicio

La integración de este componente incluye cuatro servicios:

xiaomi_aqara.play_ringtoneRiproda un efecto de sonido específico
xiaomi_aqara.stop_ringtoneDetener el reproducción de un efecto de sonido
xiaomi_aqara.add_deviceActive el modo de agregar dispositivos satelitales al gateway. Es lo mismo que hacerlo a través deapp "Mi hogar"
xiaomi_aqara.remove_deviceRequiere al gateway para eliminar cualquier dispositivo satelital en el gateway. Es lo mismo que hacerlo a través deapp "Mi hogar"

Servicio "Xiaomi_aqara.play_ringtone"

Si se evoca, requiere el gateway de riproDuce un sonido específico entre los disponibles en la fábrica. Este servicio solo funciona en gateway con firmware a partir de la versión 1.4.1_145. Esta es una función útil, por ejemplo, como una notificación acústica en nuestras automatizaciones Home Assistant.

Atributos de datos de servicioOpcionalDescripción
gw_macnoMAC dirección de gateway
ringtone_idnoLa identificación del sonido a reproDuce
ringtone_volEl volumen en porcentaje

Valores aceptados para el campo.ringtone_id son:

  • alarmas
    • 0 - Coche de policía 1
    • 1 - Coche de policía 2
    • 2 - Accidente
    • 3 - Cuenta atrás
    • 4 - Ghost
    • 5 - Rifle de francotirador
    • 6 - Batalla
    • 7 - Ataque aéreo
    • 8 - Corteza
  • Campanelli
    • 10 - Timbre
    • 11 - Llama a una puerta
    • 12 - Divertido
    • 13 - Despertador
  • Wake
    • 20 - MiMix
    • 21 - Entusiasta
    • 22 - GuitarClassic
    • 23 - IceWorldPiano
    • 24 - Tiempo libre
    • 25 - ChildHood
    • 26 - MorningStreamLiet
    • 27 - MusicBox
    • 28 - Naranja
    • 29 - Pensador
  • Sonidos personalizados (agregados a través deapp "Mi Home") a partir de la ID 10001, para crecer.

Servicio "Xiaomi_aqara.stop_ringtone"

Si se evoca, requiere el gateway para interrumpir el riproproducción de cualquier sonido en el curso de reproducción.

Atributos de datos de servicioOpcionalDescripción
gw_macnoMAC dirección de gateway

Servicio "xiaomi_aqara.add_device"

Si se evoca, requiere el gateway para activar el modo de agregar dispositivos satelitales al gateway. Es lo mismo que hacerlo a través deapp "Mi hogar"

Atributos de datos de servicioOpcionalDescripción
gw_macnoMAC dirección de gateway

Servicio "xiaomi_aqara.remove_device"

Si se evoca, requiere el gateway para eliminar cualquier dispositivo satelital en el gateway. Es lo mismo que hacerlo a través deapp "Mi hogar"

Atributos de datos de servicioOpcionalDescripción
gw_macnoMAC dirección de gateway
device_id
noDirección de hardware del dispositivo satelital que se eliminará

Ejemplos de uso en automatización

Veamos un ejemplo:

- alias: Doppio click
  trigger:
    platform: event
    event_type: xiaomi_aqara.click
    event_data:
      entity_id: binary_sensor.switch_158d000xxxxxc2
      click_type: double
  action:
    service: light.toggle
    data:
      entity_id: light.living_room_lamp

En este ejemplo, el doble clic de un botón Aqara (entidad por nombre "binary_sensor.switch_158d000xxxxxc2") Integrado a través de Gateway y el componente actual "Xiaomi Gateway (Aqara) "causa una lámpara (entidad de nombre"light.living_room_lamp") Activar / desactivar.

Proproblemas

Puede encontrar en los registros de Home Assistant voces de este tipo:

2017-08-20 16:51:19 ERROR (SyncWorker_0) [homeassistant.components.xiaomi] No gateway discovered
2017-08-20 16:51:20 ERROR (MainThread) [homeassistant.setup] Setup failed for xiaomi: Component failed to initialize.

Esto significa que el gateway no fue reconocido por Home Assistant.

Para tratar de resolver appinstar a los siguientes aspectos:

  • Asegúrese de haber habilitado el acceso LAN en el gateway (Ver orientar a la integración en Home Assistant).
  • Deshabilite el firewall en el dispositivo donde se está ejecutando Home Assistant.
  • Asegúrese de que el enrutador Wi-Fi admite (y ha activado) el servicio de multidifusión (mDNS).
  • Propara establecer el campo "mac"Vacío.
  • Propara establecer el campo "discovery_retry"A 10.
  • Propara deshabilitar y volver a habilitar el acceso LAN en el gateway.
  • Realice un restablecimiento completo de gateway: presione su botón durante 30 segundos y realice el proemparejamiento en elapp "Xiaomi Mi Home".
  • En caso Home Assistant se está ejecutando en Docker, asegúrese de usar el "–net=host"(Debe agregarse al archivo"/boot/cmdline.txt").
  • En el caso de que se intente verificar la luz de la luz gateway, el error{ "error" : "Clave inválida" }, regenerar la clave (sujeto de la guía de integración en Home Assistant) utilizando un teléfono inteligente Android (algunas instancias tienen proproblemas con las claves generadas por iOS) o, alternativamente, un emulador como pilas azules.
  • En caso de que la biblioteca solicitada "PyXiaomiGateway"No se puede instalar, algunas dependencias necesarias deberán instalarse primero, comopython3-dev,libssl-dev,libffi-dev en modo manual (p. ej., $ sudo apt-get install python3-dev libssl-dev libffi-dev).


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.