aiohomematic¶

Moderne async Python-Bibliothek für Homematic- und HomematicIP-Geräte.

aiohomematic bildet die Grundlage der Homematic(IP) Local-Integration für Home Assistant und ermöglicht die lokale Steuerung von Homematic-Geräten ohne Cloud-Abhängigkeit.

Funktionen¶

• Async-first: Basiert auf asyncio für nicht-blockierende I/O-Operationen
• Typsicher: Vollständig typisiert mit strikter mypy-Durchsetzung
• Automatische Erkennung: Automatische Entity-Erstellung aus Geräte-Parametern
• Erweiterbar: Benutzerdefinierte Entity-Klassen für gerätespezifische Funktionen
• Schneller Start: Paramset-Caching für schnelle Initialisierung
• Multi-Backend: Unterstützt CCU3, CCU2, Homegear und RaspberryMatic

Schnellstart¶

Installation¶

pip install aiohomematic

Grundlegende Verwendung¶

import asyncio
from aiohomematic.central import CentralConfig
from aiohomematic.client import InterfaceConfig
from aiohomematic.const import Interface

async def main():
    # Configure the central unit
    config = CentralConfig(
        name="my-ccu",
        host="192.168.1.100",
        username="Admin",
        password="your-password",
        central_id="my-central",
        interface_configs={
            InterfaceConfig(
                central_name="my-ccu",
                interface=Interface.HMIP_RF,
                port=2010,
            ),
        },
    )

    # Create and start the central
    central = config.create_central()
    await central.start()

    # Access devices
    for address, device in central.devices.items():
        print(f"Device: {device.name} ({address})")

    # Stop the central
    await central.stop()

asyncio.run(main())

Dokumentationsübersicht¶

Für Benutzer (Home Assistant)¶

• Benutzerhandbuch - Vollständige Integrationsanleitung
• Funktionen:
• Action-Referenz - Verfügbare Home Assistant Actions
• CCU-Sicherung - Sicherungsagent und manuelle Sicherung
• Berechnete Klima-Sensoren - Abgeleitete Klimamesswerte
• Klimaplan-Karte - Klimaplan-UI-Karte
• Gerätekonfigurations-Panel - Gerätekonfiguration in HA
• Optimistische Aktualisierungen - Sofortiges UI-Feedback und Rollback
• Zeitplan-Karte - Zeitplan-Verwaltungs-UI-Karte
• Wochenprofil - Wochenplan-Verwaltung
• Fehlerbehebung - Häufige Probleme und Lösungen
• Häufige Fragen - Häufig gestellte Fragen
• Glossar - Begriffsübersicht

Für Entwickler (Bibliotheksnutzung)¶

• Schnellstart - In 5 Minuten einsatzbereit
• Erste Schritte - Detaillierte Einrichtungsanleitung
• Consumer API - API-Muster für Integrationen
• API-Referenz - Automatisch generierte API-Dokumentation
• Architektur - Übersicht über das Systemdesign
• Protokoll-Auswahlleitfaden - Auswahl der richtigen Protokoll-Schnittstelle

Für Mitwirkende¶

• Mitwirken - So kann man beitragen
• Coding-Standards - Namens- und Stilkonventionen
• ADRs - Architecture Decision Records
• Änderungsprotokoll - Versionshistorie

Unterstützte Geräte¶

aiohomematic unterstützt eine breite Palette von Homematic- und HomematicIP-Geräten:

Eine vollständige Liste ist in der Dokumentation der Erweiterungspunkte zu finden.

Zwei Projekte, ein Ökosystem¶

Diese Dokumentation umfasst zwei verwandte, aber separate Projekte:

Welche Dokumentation wird benötigt?¶

• Home Assistant-Benutzer? → Mit dem Benutzerhandbuch beginnen
• Eine Python-Anwendung erstellen? → Siehe Schnellstart und Consumer API
• Code beitragen? → Den Leitfaden für Mitwirkende lesen

Architekturübersicht¶

Home Assistant
     │
     ▼
Homematic(IP) Local Integration    ← HA-spezifisch: Entities, Services, UI
     │
     ▼
aiohomematic-Bibliothek            ← Eigenständig: Protokoll, Geräte, Ereignisse
     │
     ▼
CCU3 / OpenCCU / Homegear          ← Backend-Hardware/-Software
     │
     ▼
Homematic-Geräte                  ← Physische Geräte

Siehe Home Assistant Lebenszyklus für den detaillierten Integrationsablauf.

Links¶

• GitHub: sukramj/aiohomematic
• PyPI: aiohomematic
• Fehler melden: Einen Fehler melden
• Diskussionen: Fragen stellen
• HA-Integration: homematicip_local

Lizenz¶

MIT-Lizenz - siehe LICENSE für Details.