# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-03-04

HANDLER-NAME
============
smarthome - Smart Home Integration (FritzBox TR-064)


BESCHREIBUNG
============
Stellt Verbindungs- und Geräteninformationen von einer FritzBox zur Verfügung.
Nutzt die TR-064 SOAP-API für sichere UPnP-Kommunikation über HTTP auf
fritz.box:49000. Keine Authentifizierung oder externe Abhängigkeiten erforderlich.


OPERATIONEN
===========
status       Zeige Verbindungsstatus, Uptime, externe IP und Geräteanzahl
devices      Auflisten aller verbundenen Geräte mit IP, MAC und Status (online/offline)
wifi         WLAN-Informationen: SSID, Status, Kanal
bandwidth    Maximale Download- und Upload-Raten (Mbit/s)
reconnect    Erzwinge Neuverbindung zum Internet (dry-run unterstützt)
info         FritzBox-Informationen: Modell, Firmware, Seriennummer, Uptime
help         Diese Hilfe anzeigen


BEISPIELE
=========
bach smarthome status
  -> Zeige Verbindungsstatus und Geräteanzahl

bach smarthome devices
  -> Alle verbundenen Geräte mit IP, MAC und Online-Status
  -> Limit: max. 30 Geräte pro Abruf

bach smarthome wifi
  -> WLAN-SSID, Aktivitaetsstatus und Kanal

bach smarthome bandwidth
  -> Download- und Upload-Maximalen in Mbit/s

bach smarthome reconnect
  -> Internet-Verbindung trennen und neu aufbauen
  -> Neue IP innerhalb ~10 Sekunden verfügbar
  -> Mit --dry-run: Simulation ohne Ausführung

bach smarthome info
  -> Gerätedetails (Modell, Firmware-Version, Serial)


DATEIEN
=======
hub/smarthome.py     Handler-Implementierung (SmartHomeHandler-Klasse)
data/bach.db         Zieldatenbank für Profil "smarthome"


SIEHE AUCH
==========
hub/base.py          BaseHandler-Basisklasse
FritzBox Dokumentation: https://avm.de (TR-064 SOAP-API)
Erreichbarkeit: fritz.box muss im lokalen Netzwerk aufgeloest werden
