MeinesmarteWelt: 1 Version importiert

2026-10-23T09:17:37Z

1 Version importiert

← Nächstältere Version

Version vom 23. Oktober 2026, 11:17 Uhr

import>Meine smarte Welt: Import Handbuch 2.0.0

2026-10-23T09:00:00Z

Import Handbuch 2.0.0

Neue Seite

__TOC__

Bei jedem Problem helfen zwei Dinge: der '''Diagnose-Download''' (Einstellungen → Geräte & Dienste → FRITZ!Box Netzwerk → ⋮ → Diagnose herunterladen) und das Debug-Protokoll (Stufe ''debug'' für <code><nowiki>custom_components.fritzbox_netzwerk</nowiki></code>). Beides gehört in ein GitHub-Issue.

=== Home Assistant verlangt wiederholt „Neu authentifizieren“. ===

Seit 1.7.1 wird die erneute Anmeldung erst nach drei abgelehnten Anmeldungen in Folge verlangt. Tritt es trotzdem auf, prüfe in der Box unter System → Ereignisse, ob zur selben Zeit Anmeldungen fehlschlugen, und verwende ein eigenes Konto nur für die Integration.

=== Einrichtung: „Das Konto hat keinen Zugriff auf die FRITZ!Box-Einstellungen“. ===

Beim Konto unter System → FRITZ!Box-Benutzer die Berechtigung ''FRITZ!Box Einstellungen'' setzen.

=== Einrichtung: Der Dienst „Hosts“ fehle. ===

Unter Heimnetz → Netzwerk → Netzwerkeinstellungen ''Zugriff für Anwendungen zulassen'' aktivieren.

=== Einrichtung: „Unknown error“ trotz richtiger Daten. ===

Bis 1.6.1 scheiterte die Einrichtung an Modellen, die die Seriennummer-Abfrage mit HTTP 401 ablehnen (beobachtet: FRITZ!Box 5690 Pro). Seit 1.6.2 wird der Fehler abgefangen.

=== HACS zeigt neue Versionen erst nach „Informationen aktualisieren“. ===

Das entscheidet HACS. Beim Repository ⋮ → ''Informationen aktualisieren'' bzw. ''Erneut herunterladen''. Unabhängig davon zeigt die Integration selbst eine neue Version an.

=== HACS meldet „Repository structure … is not compliant“. ===

Das Repository wurde als ''Dashboard'' statt als ''Integration'' hinzugefügt. Eintrag entfernen, als '''Integration''' neu hinzufügen und eine versehentlich angelegte Dashboard-Ressource (<code><nowiki>/hacsfiles/fritzbox_netzwerk/…</nowiki></code>) löschen.

=== Die Karte wird nicht gefunden („Custom element doesn't exist“). ===

1) Browser hart neu laden (Strg/Cmd+Shift+R), in der Companion-App den Zwischenspeicher leeren. 2) Unter Einstellungen → Dashboards → ⋮ → Ressourcen prüfen, ob <code><nowiki>/fritzbox_netzwerk/fritzbox-netzwerk-card.js</nowiki></code> (JavaScript-Modul) eingetragen ist. 3) Sonst manuell hinzufügen und neu laden. Im YAML-Dashboard-Modus den Eintrag in der <code><nowiki>lovelace:</nowiki></code>-Konfiguration ergänzen.

=== Die Karte zeigt „Keine Geräte gefunden“. ===

Ist der richtige Sensor gewählt (<code><nowiki>sensor.<name>_gerate</nowiki></code> mit dem Attribut <code><nowiki>hosts</nowiki></code>)? Ist ein Filter oder Suchbegriff aktiv, der nichts trifft? Ist der Sensor „nicht verfügbar“, liegt es an der Integration – Protokoll prüfen.

=== Offline-Geräte fehlen in der Liste (Issue #24). ===

Prüfe „Getrennte Geräte ausblenden“ und den Standardfilter der Karte. Bis 1.9.1 leerte die Einstellung auch die Ansichten „Inaktiv“ und „Lange offline“; seit 2.0.0 nicht mehr (mögliche Ursache, nicht bei jedem Melder bestätigt). Der Diagnose-Download nennt unter <code><nowiki>box_hosts</nowiki></code> <code><nowiki>raw_total</nowiki></code>, <code><nowiki>raw_active</nowiki></code> und <code><nowiki>raw_without_mac</nowiki></code>.

=== Die Spalte „Home Assistant“ bleibt leer. ===

Zugeordnet wird ausschließlich über die MAC-Adresse in der Geräteregistrierung. Viele Integrationen hinterlegen dort keine MAC.

=== Ein Klick auf die MAC-Adresse kopiert nichts. ===

Die moderne Zwischenablage braucht HTTPS oder <code><nowiki>localhost</nowiki></code>. Alternativ im Popup markieren und mit Strg+C kopieren; nach einem Update Strg+F5.

=== Die Spalte *Funkband* zeigt nur „—“. ===

Prüfen: (1) ''WLAN-Band je Gerät erfassen'' an? (2) Gerät direkt per WLAN an der Box (LAN, Offline und ungeprüft Repeater-Geräte bekommen keine Angabe)? (3) Debug-Protokoll: „WLAN-Band … nicht ermittelbar“.

=== Die Spalte „IP-Typ“ zeigt nur „—“ oder „fest“ für DHCP-Geräte. ===

„—“: Erfassung ausgeschaltet oder seit dem Start noch nicht gelaufen. Seit 1.5.3 gilt ''dynamisch'', wenn die Box <code><nowiki>DHCP</nowiki></code> meldet; ''fest'' bei <code><nowiki>Static</nowiki></code> oder Adresse außerhalb des DHCP-Bereichs. Reservierungen innerhalb des Bereichs erscheinen als ''dynamisch'' (seit 2.0.0 zusätzlich Auslese der Weboberfläche, ungeprüft).

=== Der Filter *Feste IP* zeigt nicht alle Reservierungen. ===

Siehe Kapitel Dashboard-Karte, Abschnitt Feste IP: Reservierungen im DHCP-Bereich meldet die Box nicht. Hilfe: Popup „reserviert“, <code><nowiki>mark_devices_reserved</nowiki></code> oder feste Adressen außerhalb des DHCP-Bereichs vergeben.

=== Der QR-Code zeigt ein Hauptnetz statt des Gast-WLANs. ===

Option ''Gast-WLAN-Dienst'' auf die richtige Nummer (1–4) stellen. Der Diagnose-Download nennt unter <code><nowiki>wlan_service_bands</nowiki></code>, welches Band jeder Dienst meldet.

=== Der Button *Neu verbinden* meldet einen Fehler (z. B. errorCode: 606). ===

Seit 1.5.2 wird zuerst TR-064 versucht, UPnP nur als Rückfall. Prüfe die Berechtigung ''FRITZ!Box Einstellungen'' und ob die Box die Internetverbindung selbst aufbaut. Hinter einem vorgeschalteten Router oder bei Kabel-Modellen gibt es keine Einwahl, die neu aufgebaut werden könnte.

=== Umbenennen meldet errorCode: 402 Invalid Args. ===

Seit 1.6.1 wird die ''Bezeichnung'' geändert. Tritt der Fehler weiter auf, ist der Name länger als 64 Zeichen oder dem Konto fehlt das Recht ''App''.

=== „Alle neu starten“ meldet nicht startbare Repeater. ===

Die Box wurde trotzdem neu gestartet. Meist lehnt der Repeater die Anmeldung ab: Zugriff für Anwendungen am Repeater erlauben, Kennwort der Box übernehmen. Einzelne Repeater über ihren ''Neustart''-Button testen.

=== Mesh-Sensor und „Alle neu starten“ fehlen, oder ein zweiter FRITZ!-Router wird nicht als Repeater erkannt. ===

Beide entstehen erst mit mindestens einem erkannten Repeater und eingeschalteter Option ''Repeater als eigene Geräte anlegen''; der Button braucht die FRITZ!Box-Steuerung. Das Gerät muss als Mesh-Mitglied eingebunden sein.

=== MAC-Filter-Schalter und Pairing-Button fehlen / Pairing meldet „Filter ist ausgeschaltet“. ===

Beides nur mit FRITZ!Box-Steuerung und wenn die Box den Filter über TR-064 meldet. Pairing schaltet den Filter ''temporär aus'' – ist er schon aus, erst einschalten.

=== Externe IP, „Online seit“ oder „Internet verbunden“ bleiben „unbekannt“. ===

Die Box läuft im reinen Access-Point-Betrieb oder meldet den WAN-Dienst nicht.

=== Die Ereignisse „Neues Gerät“ / „Externe IP geändert“ lösen nicht aus. ===

Nach Einrichtung und Neustart wird zuerst nur der Ausgangszustand gemerkt (Absicht).

=== Nach einem Update meldet Home Assistant geänderte Einheiten. ===

Die Einheit der Zähler folgt seit 1.5.2 der Sprache. Unter Entwicklerwerkzeuge → Statistiken mit ''Problem beheben'' bereinigen; Werte bleiben unberührt.

=== Datenverbrauch: Es erscheinen keine Werte. ===

Zuerst den Sensor ''Datenverbrauch Status'' ansehen; er nennt den Grund. In der Box muss je Gerät „Internet-Datenraten speichern“ aktiv sein. Passen die Zahlen nicht, die Einheit auf Bit/s umstellen.

=== Das VPN-Gerät oder eine WireGuard-Gegenstelle fehlt. ===

Seit 2.0.0 bleiben als VPN gekennzeichnete Einträge mit IP als <code><nowiki>VPN:<IP></nowiki></code> erhalten. Ob die Box WireGuard-Gegenstellen so meldet, ist ungeprüft; der Diagnose-Download (<code><nowiki>box_hosts.without_mac_samples</nowiki></code>) zeigt die Kennzeichnung.

----
← [[FRITZ!Box Netzwerk/Blueprints|Blueprints]] | [[FRITZ!Box Netzwerk|Inhaltsübersicht]] | [[FRITZ!Box Netzwerk/Bekannte Einschränkungen und Teststand|Bekannte Einschränkungen und Teststand]] →

[[Kategorie:FRITZ!Box Netzwerk]]

FRITZ!Box Netzwerk/Fehlerbehebung - Versionsgeschichte

MeinesmarteWelt: 1 Version importiert

import>Meine smarte Welt: Import Handbuch 2.0.0