FAQ

Auf dieser Seite werden die Fragen gesammelt, die auf dem GitHub-Issue-Tracker immer wieder auftauchen. Es spart Zeit, hier nachzusehen, bevor man ein neues Issue öffnet, da die meisten davon keine Fehler, sondern erwartete Verhaltensweisen mit dokumentierter Ursache sind.

Vorhandene Issues durchsuchen

Keines davon? Achten Sie darauf, das Geschlossene Issues auf GitHub zu durchsuchen, bevor Sie ein neues eröffnen. Wenn das Problem weiterhin besteht, erklärt die Fehlerbericht-Seite, wie man Debug-Logs sammelt und einen korrekten Bug-Report oder Feature-Antrag eröffnet.

Können Benachrichtigungen auf ein Telefon gesendet werden?

Antwort anzeigen

Nicht direkt. Standardmäßig erstellt die Integration nur persistent notifications innerhalb des Home Assistant Dashboards; sie werden nicht automatisch an die Home Assistant Companion App auf einem mobilen Gerät weitergeleitet, da dies ein spezifisches, gerätebezogenes Benachrichtigungsziel erfordert, das die Integration nicht hat.

Um sie auf einem Telefon zu empfangen, muss ein benutzerdefinierte Automatisierung erstellt werden, der auf die Ereignisse der Integration (oder die generierten persistenten Benachrichtigungen) hört und sie an das notify-Ziel für das mobile Gerät weiterleitet.

Mehr über die Konfiguration, welche Benachrichtigungen generiert werden

Hindernis- / KI-Erkennungsfotos werden nicht angezeigt Kartenunterstützung

Antwort anzeigen

Wenn Hindernisbilder leer bleiben, selbst wenn KI-Hindernisbilder-Upload in der App aktiviert ist und das mit Home Assistant verbundene Konto ein geteiltes/Familienkonto und nicht das Konto ist, das ursprünglich das Gerät hinzugefügt hat und besitzt, kann die Cloud-API des Herstellers den Zugriff auf Hindernisbilder für dieses geteilte Konto stillschweigend blockieren. Die Verwendung des tatsächlich besitzenden Kontos oder die Überprüfung, dass dem geteilten Konto innerhalb der App explizit Kamerazugriff gewährt wurde, löst dies in den meisten Fällen.

Kann die Kartenkamera zu HomeKit / Apple Home gestreamt werden? Kartenunterstützung

Antwort anzeigen

Nicht zuverlässig als Live-Ansicht. Die Kartenkamera streamt als echtes MJPEG, die gleiche Methode, die auch die eigene Kamera-Plattform von Home Assistant verwendet, sodass das statische Vorschaubild in Apple Home korrekt angezeigt wird. Ein neuer Frame wird nur erzeugt, wenn sich die Karte tatsächlich ändert, und der Stream liefert nichts, während der Staubsauger untätig ist. HomeKit benötigt für die Live-Ansicht eine kontinuierlich aktualisierte Quelle, um verbunden zu bleiben, und Home Assistant muss den MJPEG-Stream durch eine zusätzliche Schicht konvertieren, bevor HomeKit ihn überhaupt anzeigen kann, da HomeKit MJPEG nicht direkt akzeptiert. Wenn der Karten-Stream still wird, behandelt diese Konvertierungsschicht die Verbindung als verloren, und Home Assistant meldet, dass die Kamera keine Stream-Quelle hat oder zeigt anstelle eines Live-Bildes einen leeren Feed.

Dies wurde mehrfach gemeldet. Versuche mit der ffmpeg-Kameraplattform, go2rtc und der Generic Camera-Integration führen alle zum gleichen Ergebnis: Die statische Vorschau funktioniert, aber ein kontinuierlich aktualisierender Live-Feed innerhalb von HomeKit funktioniert nicht. Kein vollständig funktionierendes Setup wurde für diese Integration oder für ähnliche Staubsaugermappen-Streams an anderer Stelle bestätigt.

Home Assistant stürzt ab, startet neu oder verwendet viel Speicher Kartenunterstützung

Antwort anzeigen

Die Integration rendert zoombare Kartenbilder in voller Auflösung, ähnlich der offiziellen App, was eine erhebliche Menge an Speicher verwenden kann. Auf Systemen mit begrenztem RAM, wie einem Raspberry Pi, einer kleinen VM oder einem Container, der auf etwa 2-3 GB begrenzt ist, kann dies den verfügbaren Speicher erschöpfen und dazu führen, dass Home Assistant einfriert, neu startet oder überhaupt nicht startet, typischerweise direkt nach dem Hinzufügen eines Geräts mit Kartenunterstützung oder beim Öffnen seiner Geräte-Seite oder der Kamerakarte.

Lösung

Aktivieren Sie Karte in niedriger Auflösung in den Konfigurationsoptionen des Geräts. Dies löst die große Mehrheit dieser Fälle.

Wenn es auch nach Aktivierung dieser Option weiterhin abstürzt, könnten die Kartendaten selbst beschädigt oder im Laufe der Zeit ungewöhnlich groß geworden sein, was ebenfalls den Speicherverbrauch während des Renderns erhöhen kann. Das Wiederherstellen einer älteren, funktionierenden Karte von Backup und Wiederherstellung kann dieses Problem lösen. Wenn beides nicht hilft, Debug-Protokolle sammeln und einen Fehlerbericht öffnen, da dies auf eine andere zugrunde liegende Ursache hinweist.

Integration lädt nach einem Home Assistant Update nicht und verweist auf py_mini_racer Kartenunterstützung

Antwort anzeigen

Die Integration hängt von py-mini-racer ab, einer JavaScript-Engine, die zum Optimieren und Rendern von Karten verwendet wird, sodass diese der offiziellen App entsprechen. Diese Abhängigkeit wird von Home Assistant selbst installiert, nicht von der Integration, und sie schlägt gelegentlich bei der Installation fehl oder kann nach einem Home Assistant Core Update ihre native Binärdatei nicht laden, insbesondere auf musl-basierten Systemen (wie HAOS auf einigen Plattformen) oder direkt nach einem Upgrade.

Umgebungsproblem

Dies ist ein Problem bei der Installation von Umgebung/Abhängigkeiten, nicht etwas, das der Code der Integration erkennen oder umgehen kann. Es tritt wiederholt in verschiedenen, nicht zusammenhängenden Home Assistant-Versionen und Installationstypen auf.

Ein Neustart von Home Assistant (um ihm zu ermöglichen, das Installieren der Abhängigkeiten erneut zu versuchen) löst es in einigen Fällen. Wenn es weiterhin besteht, überprüfen Sie das Home Assistant-Protokoll beim Start auf den tatsächlichen pip/Abhängigkeitsinstallationsfehler; dieser Fehler muss behoben werden (einschließlich als Home Assistant Core-Problem, wenn es wie ein installationsfehler auf Plattformebene aussieht).

Kann ein mit Valetudo betriebenes Gerät mit dieser Integration verwendet werden?

Antwort anzeigen

Ja und nein. Technisch gesehen gibt es keine Einschränkung, die verhindert, dass die Integration neben Valetudo betrieben wird. Valetudo deaktiviert die lokale miIO-API nicht, sodass das Gerät über Lokale Verbindung gesteuert werden kann, solange das Token erworben werden kann. Karteninformationen können jedoch nicht über die lokale API abgerufen werden, und Valetudo stellt keine rohen Kartendaten über einen Dienst bereit. Daher kann die Integration nur ohne Kartenunterstützung funktionieren.

Ohne Kartenunterstützung wird die von dieser Integration bereitgestellte Funktionalität weitgehend überflüssig, da alle verbleibenden Funktionen bereits über die native Nutzung verfügbar sind Valetudo Home Assistant MQTT-Integration.