composants Home Assistant « Xiaomi Gateway"

6 minutes de lecture
Proconducteur: Home Assistant Communauté
Disponibilité: inclus dans leHUB
catégorie: logiciel
typologie: composants Home Assistant
Difficultés de mise en œuvre: petite
Révision de la carte: 2.3

Le composant "Xiaomi" Gateway" di Home Assistant il faut intégrer il BRIDGE/Gateway ZigBee↔︎TCP/IP de la ligne Xiaomi Mi Smart Home (Mijia).

Conte gateway a la fonction BRIDGE/Gateway (en pratique, de centralisateur) pour tous les appareils ZigBee de la ligne Xiaomi composée de capteurs, commutateurs, impulsions, dispositifs et plus ainsi que tous ceux compatibles (par exemple certaines des lignes IKEA TRÅDFRI, ou un peu d’Aqara).

Le nom complet du composant en fait ce serait "Xiaomi Gateway (Aqara)", Mais c'est un nom extrêmement trompeur. En fait, le composant permet SEULEMENT l'intégration de gateway Xiaomi Mi (Mijia) e PAS del gateway LUMI Aqara qui, bien que conceptuellement très similaire (c’est aussi BRIDGE/Gateway ZigBee↔︎TCP/IP), ne peuvent pas être intégrés.

La présence du nom "Aqara"Fait référence au fait que tout composants (capteurs, actionneurs, etc.) marqués Aqara compatible avec gateway Xiaomi, lorsque ce dernier est intégré à Home Assistant sont à leur tour intégrés. L’inverse n’est pas vrai: les composants Xiaomi compatibles avec un gateway Aqara PAS peut être intégré indirectement avec Home Assistant comme ci-dessus, comme ce dernier PAS peut être intégré avec Home Assistant.

Il gateway est initialement configuré (pour accéder à proavant Wi-Fi) à travers leapplished ici "Xiaomi Mi Home" (disponible pour Android e iOS) et, une fois cette configuration effectuée, toujours via leapp il est possible de s'y connecter des composants "satellites" qui lui sont connectés via proprotocole ZigBee. Les comportements (notifications, alarmes, réglages) de ces composants vis-à-vis de gateway (émission de signaux sonores, visuels ou de notifications àapp) sont administrés et gérés par Gateway à travers leapp "Xiaomi Mi Home".

Une fois configuré le gateway le proavant Wi-Fi à travers leapp "Xiaomi Mi Home", il sera possible de l'intégrer - à travers le composant "Xiaomi Gateway"Décrit ici - avec le propétition pour Home Assistant pour:

  • intégrer les mêmes fonctions que le gateway (émission d'effets sonores, éclairage - chromatique - de sa lumière LED);
  • intégrer les dispositifs / capteurs / composants éventuellement connectés au gateway même.
ATTENTION: Pour effectuer cette intégration, il est nécessaire que la version du micrologiciel du composant soit égal ou inférieur au 1.41.159. Un micrologiciel supérieur ne permet pas l’intégration décrite ici, sauf la mise en œuvre de cette guide.

Une fois l'intégration terminée il Gateway et toutes les composantes du satellite émergeront sur Home Assistant comment entité de divers types, en fonction de leur nature (appcapteurs de graisse, boutons, etc.).

Appareils pris en charge
  • Gatewa Xiaomi (lumi.gateway.v2, lumi.gateway.v3)
  • LUMI Compagnon de climatisation Aqara (lumi.acpartner.v3)
  • LUMI Serrure de porte intelligente Aqara (lock.aq1)
  • Température et humidité Sensor (première et deuxième génération)
  • Mouvement Sensor (première et deuxième génération)
  • Porte et fenêtre Sensor (première et deuxième génération)
  • Button 1st generation (administrable: simple, double, appui long)
  • Button 2nd generation (administrable: simple, double pression)
  • Plug aka Socket (version ZigBee: signale l’énergie consommée, instantanée, l’état et si le périphérique est en cours d’utilisation)
  • Prise murale (montre la consommation électrique, l'instantané et l'état)
  • LUMI Mur d'Aqara Switch (pression unique)
  • LUMI Mur d'Aqara Switch (double pression)
  • LUMI Mur d'Aqara Switch LN (pression unique)
  • LUMI Mur d'Aqara Switch LN (double presse)
  • LUMI Aqara Wireless Switch (pression unique)
  • LUMI Aqara Wireless Switch (double pression)
  • LUMI/ Cube Xiaomi
  • Détecteur de fuite de gaz (rapports alarme et densité)
  • Détecteur de fumée (rapports alarme et densité)
  • Gateway (gérable: lumière, capteur de lumila curiosité, riprosons duction)
  • Rideau intelligent
  • Fuite d'eau Sensor
  • vibration Sensor
  • Batteries
Périphériques non supportés
  • Gateway LUMI Aqara
  • Gateway Radio
  • Gateway Bouton
  • Compagnon de climatisation Xiaomi Mi (lumi.acpartner.v2)
  • LUMI Contrôleur de climatiseur intelligent Aqara Hub (lumi.acpartner.v1)
  • Mode découplé du mur d'Aqara Switches (simple et double presse)
  • Autres événements d’alarme du détecteur de gaz et de fumée: alarme analogique, alarme de panne de batterie, alarme de sensibilité, défaillance de la communication I2C

Nb La liste évolue constamment à la page officielle du composant.

guide

Le guide détaillé de l'intégration est le suivant:

Intégrer le Gateway Xiaomi Mi Smart Home a Home Assistant

Configuration

Le bloc de code à saisir à la configuration de Home Assistant ce qui permet d'intégrer le gateway est la suivante:

xiaomi_aqara:
  discovery_retry: 5
  gateways:
    - key: xxxxxxxxxxxxxxxx

Au cas où plus sont présents gateway, la syntaxe est la suivante:

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

Les variables disponible pour la personnalisation de la configuration Elles sont les suivantes:

interface(chaîne, facultatif) - Interface réseau à partir de laquelle rechercher la présence de gateway.
discovery_retry(interne, facultatif) - Le nombre de fois pour lequel Home Assistant réessayez la connexion à gateway en cas de faillite. Par défaut: 3
gateway(carte, obligatoire) - La liste des gateway être intégré.

mac(chaîne) - Il MAC Adresse du gateway. Facultatif s'il n'y en a qu'un gateway.
clé(chaîne, demande) - La clé d'accès au réseau local à gateway (expliqué dans guide dédié à l'intégration de Gateway su Home Assistant).
host(chaîne, facultatif) - L'adresse IP du gateway. Utilisé au cas où vous ne souhaitez pas utiliser la découverte par multidiffusion automatique.
désactiver(Booléen, facultatif) - Désactiver le gateway. Utilisé pour ne pas intégrer une donnée gateway en cas de plus de co-présence gateway.

Service

L'intégration de cette composante comprend quatre services:

xiaomi_aqara.play_ringtoneRiprodonne un effet sonore spécifique
xiaomi_aqara.stop_ringtoneArrêtez le reproduction d'un effet sonore
xiaomi_aqara.add_deviceActiver le mode d’ajout d’appareils satellites au gateway. C’est la même chose que de le faire à travers leapp "Mi Maison"
xiaomi_aqara.remove_deviceNécessite al gateway pour supprimer tous les appareils satellites sur le gateway. C’est la même chose que de le faire à travers leapp "Mi Maison"

Service "Xiaomi_aqara.play_ringtone"

Si évoqué, il impose à la gateway de riproDuce un son spécifique parmi ceux disponibles à l'usine. Ce service ne fonctionne que sur gateway avec firmware à partir de la version 1.4.1_145. Ceci est une fonction utile, par exemple, comme notification acoustique dans nos automatisations Home Assistant.

Attributs de données de serviceEn optiondescription
gw_macaucuneMAC adresse de gateway
ringtone_idaucuneL'identifiant du son à reproDuce
ringtone_volOuiLe volume en pourcentage

Valeurs acceptées pour le champringtone_id Ils sont les suivants:

  • Allarmi
    • 0 - Voiture de police 1
    • 1 - Voiture de police 2
    • 2 - Accident
    • 3 - Compte à rebours
    • 4 - Ghost
    • 5 - Fusil de sniper
    • 6 - Battle
    • 7 - raid aérien
    • 8 - Écorce
  • Campanelli
    • 10 - Sonnette
    • 11 - Frapper à une porte
    • 12 - Amuse
    • 13 - Réveil
  • Wake
    • 20 - MiMix
    • 21 - Enthousiaste
    • 22 - GuitarClassic
    • 23 - IceWorldPiano
    • 24 - LeisureTime
    • 25 - ChildHood
    • 26 - MorningStreamLiet
    • 27 - MusicBox
    • 28 - Orange
    • 29 - penseur
  • Sons personnalisés (ajoutés via leapp "Mi Home") à partir de l'ID 10001, pour se développer.

Service "Xiaomi_aqara.stop_ringtone"

Si évoqué, il impose à la gateway interrompre le riproproduction de tout son en cours de réproduction.

Attributs de données de serviceEn optiondescription
gw_macaucuneMAC adresse de gateway

Service "xiaomi_aqara.add_device"

Si évoqué, il impose à la gateway activer le mode d’ajout d’appareils satellites au gateway. C’est la même chose que de le faire à travers leapp "Mi Maison"

Attributs de données de serviceEn optiondescription
gw_macaucuneMAC adresse de gateway

Service "xiaomi_aqara.remove_device"

Si évoqué, il impose à la gateway pour supprimer tous les appareils satellites sur le gateway. C’est la même chose que de le faire à travers leapp "Mi Maison"

Attributs de données de serviceEn optiondescription
gw_macaucuneMAC adresse de gateway
device_id
aucuneAdresse matérielle du périphérique satellite à supprimer

Exemples d'utilisation en automatisation

Regardons un exemple:

- 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

Dans cet exemple, le double-clic d'un bouton Aqara (entité par nom "binary_sensor.switch_158d000xxxxxc2") Intégré par Gateway et le présent composant "Xiaomi Gateway (Aqara) "provoque une lampe (entité de nom"light.living_room_lamp") Activer / désactiver.

Proproblèmes

Vous pouvez trouver sur les journaux de Home Assistant voix de ce type:

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.

Cela signifie que le gateway n'a pas été reconnu par Home Assistant.

Pour essayer de résoudre, appexhorter les aspects suivants:

  • Assurez-vous d’avoir activé l’accès LAN sur le gateway (Voir guide à l'intégration sur Home Assistant).
  • Désactiver le pare-feu sur le périphérique sur lequel il s'exécute Home Assistant.
  • Assurez-vous que le routeur Wi-Fi prend en charge (et a activé) le service de multidiffusion (mDNS).
  • Propour définir le champ "mac"Vide.
  • Propour définir le champ "discovery_retry"Pour 10.
  • Prodésactiver et réactiver l'accès LAN sur le gateway.
  • Effectuer une réinitialisation matérielle du gateway: appuyez sur son bouton pendant 30 secondes et effectuez la proappariement sur leapp "Xiaomi Mi Home".
  • Au cas où Home Assistant fonctionne sur Docker, assurez-vous d'utiliser le "–net=host"(Doit être ajouté au fichier"/boot/cmdline.txt»).
  • En cas de tentative de vérification de la lumière de la lumière gateway, l'erreur{ "erreur" : "clé non valide" }, régénérer la clé (sujet du guide d'intégration sur Home Assistant) en utilisant un smartphone Android (certaines instances ont proproblèmes générés par les clés générées par iOS) ou un émulateur tel que bluestacks.
  • Au cas où la bibliothèque demandée “PyXiaomiGateway"Ne peut pas être installé, certaines dépendances nécessaires devront être installées en premier, telles quepython3-dev,libssl-dev,libffi-dev en mode manuel (par exemple, $ sudo apt-get installer python3-dev libssl-dev libffi-dev).


Home Assistant Logo officielATTENZIONE: rappelez-vous qu'il y a sur notre communauté FORUM une section ad hoc dédiée à Home Assistantpour tout doute, question, information sur le mérite spécifique de ces composants.