FAQ

Cette page rassemble les questions qui reviennent fréquemment sur le Suivi des problèmes GitHub. Vérifier ici avant d’ouvrir un nouveau problème permet de gagner du temps, car la plupart ne sont pas des bugs mais des comportements attendus avec une cause documentée.

Rechercher les problèmes existants

Aucun de ceux-ci ? Assurez-vous de rechercher le problèmes fermés sur GitHub avant d’en ouvrir un nouveau. Si le problème persiste, la page Signalement de problème explique comment recueillir les journaux de débogage et soumettre correctement un rapport de bug ou une demande de fonctionnalité.

Les notifications peuvent-elles être envoyées sur un téléphone ?

Afficher la réponse

Pas directement. Par défaut, l'intégration ne crée que des notifications persistantes à l'intérieur du tableau de bord Home Assistant ; elles ne sont pas automatiquement transmises à l'application Home Assistant Companion sur un appareil mobile, car cela nécessite une cible de notification spécifique par appareil que l'intégration ne possède pas.

Pour les recevoir sur un téléphone, un automatisation personnalisée doit être créé qui écoute les événements de l'intégration (ou les notifications persistantes générées) et les redirige vers la cible notify pour l'appareil mobile.

En savoir plus sur la configuration des notifications générées

Les photos de détection d'obstacles / d'IA ne s'affichent pas Support de la carte

Afficher la réponse

Si les images d'obstacles restent vides même avec Téléversement des images d'obstacles IA activé dans l'application, et que le compte connecté à Home Assistant est un compte partagé/familial plutôt que le compte qui a initialement ajouté et possède l'appareil, l'API cloud du fabricant peut bloquer silencieusement l'accès aux images d'obstacles pour ce compte partagé. L'utilisation du compte propriétaire réel, ou la vérification que l'accès à la caméra a été explicitement accordé au compte partagé dans l'application, résout le problème dans la plupart des cas.

La caméra de la carte peut-elle être diffusée vers HomeKit / Apple Home ? Support de la carte

Afficher la réponse

Pas de manière fiable comme une vue en direct. La caméra de la carte diffuse en MJPEG authentique, la même méthode que celle utilisée par la plateforme de caméra de Home Assistant, donc l'image d'aperçu statique dans Apple Home s'affiche correctement. Un nouveau cadre n'est généré que lorsque la carte change réellement, et le flux ne produit rien lorsque l'aspirateur est inactif. La vue en direct de HomeKit a besoin d'une source se rafraîchissant constamment pour rester connectée, et Home Assistant doit convertir le flux MJPEG à travers une couche supplémentaire avant que HomeKit puisse l'afficher, puisque HomeKit n'accepte pas directement le MJPEG. Lorsque le flux de la carte devient silencieux, cette couche de conversion considère la connexion comme perdue, et Home Assistant indique que la caméra n'a pas de source de flux ou affiche un flux vide au lieu d'une image en direct.

Cela a été signalé plusieurs fois. Les tentatives avec la plateforme de caméra ffmpeg, go2rtc, et l'intégration Caméra Générique produisent toutes le même résultat : l'aperçu statique fonctionne, mais un flux en direct mis à jour en continu dans HomeKit ne fonctionne pas. Aucun réglage pleinement fonctionnel n'a été confirmé pour cette intégration ou pour des flux de cartes d'aspirateur similaires ailleurs.

Home Assistant plante, redémarre ou utilise beaucoup de mémoire Support de la carte

Afficher la réponse

L'intégration rend des images de carte zoomables en pleine résolution similaires à l'application officielle, ce qui peut utiliser une quantité significative de mémoire. Sur des systèmes avec une RAM limitée, comme un Raspberry Pi, une petite machine virtuelle ou un conteneur limité à environ 2-3 Go, cela peut épuiser la mémoire disponible et provoquer le gel, le redémarrage ou l'échec complet du démarrage de Home Assistant, généralement juste après l'ajout d'un appareil avec support de carte ou à l'ouverture de sa page d'appareil ou de sa caméra de carte.

Solution

Activez Image de Carte à Basse Résolution depuis les options de configuration de l'appareil. Cela résout la grande majorité de ces cas.

Si l'application plante toujours après avoir activé cette option, les données de la carte elles-mêmes peuvent avoir été corrompues ou devenues anormalement volumineuses au fil du temps, ce qui peut également augmenter l'utilisation de la mémoire pendant le rendu. Restaurer une carte plus ancienne et saine depuis Sauvegarde et récupération peut résoudre ce problème. Si aucune des solutions ne fonctionne, collecter les journaux de débogage et ouvrez un rapport de bug, car cela indique une cause sous-jacente différente.

L'intégration ne se charge pas après une mise à jour de Home Assistant, mentionnant py_mini_racer Support de la carte

Afficher la réponse

L'intégration dépend de py-mini-racer, un moteur JavaScript utilisé pour optimiser et rendre les cartes afin qu'elles correspondent à l'application officielle. Cette dépendance est installée par Home Assistant lui-même, et non par l'intégration, et elle échoue parfois à s'installer ou échoue à charger son binaire natif après une mise à jour de Home Assistant Core, en particulier sur les systèmes basés sur musl (comme HAOS sur certaines plateformes) ou juste après une mise à niveau.

Problème d'environnement

Il s'agit d'un problème d'installation de l'environnement/dépendances, et non de quelque chose que le code de l'intégration peut détecter ou contourner. Il apparaît de manière répétée à travers différentes versions et types d'installation de Home Assistant.

Redémarrer Home Assistant (pour lui permettre de réessayer l'installation des dépendances) résout le problème dans certains cas. Si le problème persiste, vérifiez le journal de Home Assistant au démarrage pour l'erreur réelle pip/dépendance d'installation ; c'est cette erreur qui doit être résolue (y compris en tant que problème de Home Assistant Core, si cela ressemble à un échec d'installation au niveau de la plateforme).

Un appareil exécutant Valetudo peut-il être utilisé avec cette intégration ?

Afficher la réponse

Oui et non. Techniquement, il n’y a aucune restriction empêchant l’intégration de fonctionner aux côtés de Valetudo. Valetudo ne désactive pas l’API locale miIO, donc l’appareil peut être contrôlé via Connexion locale tant que le jeton peut être acquis. Cependant, les données de la carte ne peuvent pas être récupérées via l’API locale, et Valetudo n’expose pas les données brutes de la carte via un service. Par conséquent, l’intégration ne peut fonctionner qu’en l’absence de support pour la carte.

Sans support pour la carte, les fonctionnalités fournies par cette intégration deviennent largement redondantes, car toutes les autres fonctionnalités peuvent déjà être utilisées via la native Intégration Valetudo Home Assistant MQTT.