Konfigurationsoptionen

In Home Assistant wird jeder erfolgreich konfigurierte Saugroboter als eigener Integrations-Eintrag gespeichert. Ein entsprechendes Gerät wird automatisch erstellt und mit diesem Eintrag verknüpft, wodurch die Entitäten, Dienste und Kartendaten des Staubsaugers verfügbar gemacht werden. Konfigurationsoptionen bieten Zugriff auf gerätespezifische Einstellungen, sodass das Verhalten jedes Integrations-Eintrags unabhängig angepasst werden kann.

Diese Einstellungen können sofort während des ersten Einrichtungsprozesses als letzter Schritt nach Abschluss der Konfiguration für den ausgewählten Verbindungstyp (direkt bevor das Gerät zu Home Assistant hinzugefügt wird) aufgerufen werden. Sie können auch jederzeit später über die Home Assistant Integrationen-Seite geändert werden, indem Sie auf die Konfigurieren-Schaltfläche oben rechts auf der Gerätekachel klicken.

Dreame Vacuum Card Schlüssel

Ein optionales Feld für einen Dreame-Staubsauger-Karte-Lizenzschlüssel. Wenn ein gültiger Schlüssel eingegeben wird, aktiviert die Integration automatisch die eingebettete benutzerdefinierte Karte und macht sie unter den benutzerdefinierten Karten im Dashboard verfügbar. Wenn ein ungültiger Schlüssel eingegeben wird, bleibt die Karte im Dashboard im Vorschau-Modus.

DVC-Schlüssel holen

Einzelgeräteaktivierung

Jeder Lizenzschlüssel ist strikt auf ein einzelnes Gerät beschränkt. Sobald ein Schlüssel aktiviert wurde, ist er dauerhaft an dieses spezifische Gerät gebunden und kann nicht verwendet werden, um die Karte auf einem anderen Gerät zu aktivieren.

Hinweis

Dieses Feld ist völlig optional. Wenn es leer gelassen wird, kann die eingebettete benutzerdefinierte Karte weiterhin zu einem Dashboard hinzugefügt werden, arbeitet jedoch im Vorschau-Modus. Ein gültiger Schlüssel kann jederzeit später direkt über die Benutzeroberfläche der Karte im Vorschau-Modus erworben werden.

Benachrichtigungen

Wählen Sie aus, welche Kategorien von persistent notifications die Integration für dieses Gerät erstellen darf. Das Deaktivieren einer Kategorie deaktiviert sie vollständig, selbst wenn das zugrunde liegende Geräteereignis weiterhin auftritt.

• Bereinigung abgeschlossen (cleanup_completed): Wird jedes Mal erzeugt, wenn eine Reinigungsaufgabe erfolgreich abgeschlossen wird.
• Verbrauchsmaterial (consumable): Wird erzeugt, wenn die Lebensdauer eines Verbrauchsmaterials zur Neige geht oder wenn eine Komponente gewartet werden muss.
• Information (information): Wird für allgemeine Informationsereignisse und Statusaktualisierungen erzeugt.
• Warnung (warning): Wird erzeugt, wenn das Gerät auf leicht behebbaren Fehler oder kleinere Probleme stößt.
• Fehler (error): Wird erzeugt, wenn das Gerät einen kritischen Fehler oder Hardwarefehler erfährt.

Mehr über die Benachrichtigungsfunktion

Begleit-App

Standardmäßig werden persistente Benachrichtigungen nur innerhalb des Home Assistant-Dashboards angezeigt. Sie können nicht direkt an die Home Assistant Companion App auf einem mobilen Gerät gesendet werden, da eine spezifische Geräte-ID für Benachrichtigungen erforderlich ist. Um Push-Benachrichtigungen auf einem mobilen Gerät zu erhalten, muss ein benutzerdefinierte Automatisierung erstellt werden, der entweder auf die Ereignisse der Integration hört oder generierte persistente Benachrichtigungen überwacht und sie dann an das spezifische mobile Gerät weiterleitet.

Kartenanzeigeoptionen Kartenunterstützung

Die folgenden Einstellungen sind nur für Geräte verfügbar, die mit einem Cloud-Konto (DreameHome, MovaHome, TROUVER oder Xiaomi Home) konfiguriert sind, da sie alle von Kartendaten abhängen:

Dreame-Staubsauger-Karte

Die unten stehenden Einstellungen gelten nur für die generierte Karten-Kamera-Entität. Die Dreame-Staubsauger-Karte zeigt nativ ihre eigene Karte an und kann unabhängig das Farbschema und das Symbolset über ihr erweiterte Konfiguration überschreiben. Die Optionen Quadratische Kartenabbildung und Niedrigauflösende Kartenabbildung haben keine Auswirkungen auf die benutzerdefinierte Karte, daher wird empfohlen, Niedrigauflösende Kartenabbildung zu aktivieren, um Speicher zu sparen.

Farbschema

Wählt die Farbpalette aus, die bei der Erstellung des Kartenbildes verwendet wird.

• Dreame Light (dreame_light): Offizielles Theme der Dreame-App.
• Dreame Dark (dreame_dark): Dunkles Theme, exklusiv für die dreame_vacuum-Integration.
• Mijia Light (mijia_light): Helles Theme der offiziellen Xiaomi Mi Home App.
• Mijia Dark (mijia_dark): Dunkles Theme der offiziellen Xiaomi Mi Home App.
• Graustufen (grayscale): Ein farbloses, monochromatisches Karten-Theme.
• Transparent (transparent): Erzeugt Boden, Wände und Raumausfüllungen vollständig transparent, nützlich, um die Karte über einem benutzerdefinierten Hintergrund zu überlagern.

Siehe verfügbare Farbschemata in der Kartenunterstützung

Ionenset

Wählt den Symbolstil, der für Kartenmarker wie Roboter, Ladegerät und Möbel verwendet wird, passend zu den Symbolsets der offiziellen Apps.

• Dreame (dreame): Offizielles Symbolset der Dreame-App.
• Dreame Old (dreame_old): Symbolset der älteren Dreame-App.
• Mijia (mijia): Offizielles Symbolset der Xiaomi Mi Home App.
• Material (material): Eingebaute Material Design-Symbole von Home Assistant.

Versteckte Kartenobjekte

Wählt aus, welche Kartelemente von dem generierten Kartenbild ausgeschlossen werden. Dies ist nützlich, um die Karte zu vereinfachen oder Informationen zu verbergen, die für ein bestimmtes Dashboard nicht benötigt werden.

Verfügbare Objekte

• Raumfarben (color): Die unterschiedliche Farbfüllung für jeden Raum.
• Raumsymbole (icon): Das Raumsymbol basierend auf seinem Typ.
• Raum Namen (name): Die Textbeschriftungen für Raumnamen.
• Raumnamen Hintergrund (name_background): Der pillenförmige Hintergrund hinter Raumnamen mit seiner zugehörigen Farbe.
• Raumreihenfolge (order): Die nummerierten Abzeichen, die die Reinigungsreihenfolge anzeigen.
• Raumsaugstufe (suction_level): Das Symbol, das die konfigurierte Saugleistung des Raums anzeigt.
• Raumwassermenge (water_volume): Das Symbol, das die konfigurierte Wassermenge des Raums anzeigt.
• Raumreinigungszeiten (cleaning_times): Das Abzeichen, das angibt, wie oft der Raum gereinigt wird.
• Raumreinigungsmodus (cleaning_mode): Das Symbol, das den konfigurierten Reinigungsmodus des Raums anzeigt (Fegen, Wischen oder beides). (Nur bei unterstützten Geräten)
• Raumwischmodus (mopping_mode): Das Symbol, das den konfigurierten Wischpad-Typ des Raums anzeigt. (Nur bei unterstützten Geräten)
• Pfad (path): Der Pfad, der zeigt, wo der Roboter gereinigt hat.
• Keine-Go-Zonen (no_go): Eingeschränkte Zonen.
• Keine-Wisch-Zonen (no_mop): Eingeschränkte Wischzonen.
• Virtuelle Wände (virtual_wall): Eine virtuelle Wand, die hinzugefügt wurde, um zu verhindern, dass der Roboter darüber hinausfährt.
• Virtuelle Schwellen (pathway): Definierte Schwellen, die der Roboter vorsichtig überschreiten muss. (Nur auf unterstützten Geräten)
• Aktive Bereiche (active_area): Das während der Zonenreinigung gezeichnete Begrenzungsfeld.
• Aktive Punkte (active_point): Punkte für die Fleckenreinigung, die eine Fläche von 1,5 m² anzeigen.
• Ladegerät-Symbol (charger): Das Symbol der Basisstation.
• Roboter-Symbol (robot): Das Symbol, das den Roboter selbst darstellt.
• Reinigungsrichtung (cleaning_direction): Der Pfeil, der die Richtung anzeigt, in der der Roboter derzeit reinigt.
• KI-Hindernis (obstacle): Von der KI erkannte Hindernissymbole wie Schuhe und Kabel. (Nur auf unterstützten Geräten)
• Haustier (pet): Hindernisse, die als Haustier erkannt wurden. (Nur auf unterstützten Geräten)
• Teppichbereich (carpet): Teppichstruktur. (Nur auf unterstützten Geräten)
• Bodenmaterial (material): Die Bodenmaterialstruktur des Raumes, wie Holz oder Fliesen. (Nur auf unterstützten Geräten)
• Tiefliegende Bereiche (low_lying_area): Tiefe Bereiche, in die der Roboter eintritt, indem er seinen LiDAR-Scanner absenkt. (Nur auf unterstützten Geräten)
• Möbel (furniture): 3D- oder 2D-Möbel. (Nur auf unterstützten Geräten)
• Rampe (ramp): Rampen, die in der Umgebung platziert sind. (Nur auf unterstützten Geräten)
• Vorhang (curtain): Vorhänge. (Nur auf unterstützten Geräten)
• Cruise-Punkte (cruise_point): Gehe zu Operationspunkten. (Nur auf unterstützten Geräten)

Quadratisches Kartenbild

Erzwingt, dass das generierte Karten-Kamerabild ein 1:1-Quadrat-Seitenverhältnis hat, anstatt der natürlichen Begrenzung der Karte, was für Dashboard-Layouts nützlich sein kann, die ein quadratisches Bild erwarten.

Karte in niedriger Auflösung

Generiert das Karten-Kamerabild in reduzierter Auflösung, um den Speicherverbrauch zu senken und Updates zu beschleunigen.

Speicherbeschränkungen

Das Erstellen großer Karten kann eine erhebliche Menge an Speicher erfordern. Wenn Home Assistant abstürzt und neu startet, wenn Sie zur Geräte-Seite navigieren oder auf die Map-Kamera-Entität zugreifen, liegt dies höchstwahrscheinlich an unzureichendem Speicher. Das Aktivieren dieser Option löst das Problem in der Regel.

Hinweis

Das Aktivieren dieser Option deaktiviert außerdem die Gespeicherte WiFi-Karte-Kameraentität, da sie in niedriger Auflösung nicht verfügbar ist.

Cloud bevorzugen

Nur verfügbar für Geräte, die mit einem Xiaomi Home-Konto konfiguriert sind. Diese Einstellung ermöglicht es, die während des initialen Konfigurationsschritts ursprünglich gewählte Präferenz zu aktualisieren.

• Wenn aktiviert: Erzwingt die gesamte Kommunikation über die Cloud. Dies ist erforderlich für neuere Geräte, bei denen Xiaomi den lokalen Zugriff deaktiviert hat, oder wenn sich das Gerät und Home Assistant in unterschiedlichen Subnetzen befinden.
• Wenn deaktiviert (Empfohlen für unterstützte Setups): Die Integration stellt eine direkte lokale Verbindung mit dem Gerät her (während weiterhin automatisch Token- und IP-Erneuerungen über die Cloud erfolgen). Dies hält alle Kommunikationen (außer Kartendaten) vollständig lokal.

Testen der lokalen API-Verfügbarkeit

Diese Option bietet eine sehr nützliche Möglichkeit, die lokale Konnektivität zu testen. Um sicherzustellen, dass die anfängliche Geräteeinrichtung fehlerfrei gelingt, kann Cloud bevorzugen während des Konfigurationsvorgangs aktiviert bleiben. Sobald das Gerät erfolgreich zu Home Assistant hinzugefügt wurde, kann diese Option hier deaktiviert werden, um zu prüfen, ob das Gerät die lokale API tatsächlich unterstützt. Wenn das Gerät nach der Deaktivierung nicht verfügbar wird, aktivieren Sie es einfach erneut, um wieder zur Cloud-Verbindung zurückzukehren.

YAML Zum Nachschlagen

dreame_vacuum:
  # Local connection
  host: 192.168.1.100
  token: b2a1c3d4e5f6a7b8c9d0e1f2a3b4c5d6

  # Cloud connection
  username: your@email.com
  password: your_password
  country: de
  prefer_cloud: true # Only available on Xiaomi Home

  # Options available regardless of connection type
  dvc_key: 123e4567-e89b-42d3-a456-426614174000
  notify:
    - information
    - warning
    - error

  # Options available only with map support (Cloud)
  color_scheme: dreame_dark
  icon_set: dreame_old
  hidden_map_objects:
    - name_background
    - name
    - order
  square: true
  low_resolution: true