{"id":9327,"date":"2026-02-24T08:49:48","date_gmt":"2026-02-24T07:49:48","guid":{"rendered":"https:\/\/de.elv.com\/elvjournal\/?p=9327"},"modified":"2026-04-15T12:09:27","modified_gmt":"2026-04-15T10:09:27","slug":"vom-user-zum-entwickler-hcu-home-assistant-integration","status":"publish","type":"post","link":"https:\/\/de.elv.com\/elvjournal\/vom-user-zum-entwickler-hcu-home-assistant-integration\/","title":{"rendered":"Vom User zum Entwickler: Wie KI und Community die lokale HCU-Integration m\u00f6glich machten"},"content":{"rendered":"\n

Vom User zum Entwickler<\/strong><\/p>\n\n\n\n

Wie KI und Community die lokale HCU-Integration m\u00f6glich machten<\/h1>\n\n\n\n

Ein Blick hinter die Kulissen der Entwicklung der lokalen Home-Assistant-Integration f\u00fcr die Homematic IP Home Control Unit.<\/strong> Nachdem im ELVjournal bereits \u00fcber die technischen Aspekte der lokalen HCU-Anbindung<\/a> berichtet wurde, m\u00f6chte ich heute die Geschichte aus meiner ganz pers\u00f6nlichen Perspektive erz\u00e4hlen. Denn eigentlich war es nie mein Plan, eine der zentralen Integrationen f\u00fcr die neue Home Control Unit zu schreiben.<\/strong><\/p>\n\n\n\n

<\/div>\n\n\n\n

<\/a>Der Start: Ein neues Haus und ein \u201eBest of Breed\u201c-Ansatz<\/h2>\n\n\n\n

Alles begann Anfang 2025. Meine Frau und ich zogen in unser eigenes Haus, und wie es der Zufall wollte, fand ich dort bereits eine solide Basis an Homematic IP Ger\u00e4ten vor, die der Vorbesitzer installiert hatte. F\u00fcr mich stand schnell fest: Ich m\u00f6chte das Rad nicht neu erfinden. Die bestehende Hardware f\u00fcr die Heizungssteuerung war zuverl\u00e4ssig und sollte bleiben.<\/p>\n\n\n\n

Gleichzeitig wollte ich mein Smart Home modernisieren. Die alte CCU2 tauschte ich gegen die damals nagelneue Home Control Unit (HCU)<\/strong> aus. Doch mein Ansatz f\u00fcr das smarte Zuhause war schon immer „Best of Breed“ \u2013 ich wollte die jeweils besten Ger\u00e4te verschiedener Hersteller nutzen, aber alle unter einer Oberfl\u00e4che vereinen. Die Wahl f\u00fcr diese „Zentrale der Zentralen“ fiel daher logischerweise auf Home Assistant<\/strong>.<\/p>\n\n\n\n

<\/div>\n\n\n\n

<\/a>Die L\u00fccke: Warten auf die API<\/h2>\n\n\n\n

Da die HCU<\/span> noch sehr frisch auf dem Markt war, wusste ich, dass eine lokale Anbindung an Home Assistant nicht sofort verf\u00fcgbar sein w\u00fcrde. Zun\u00e4chst versuchte ich mein Gl\u00fcck \u00fcber die Cloud-Anbindung, doch diese funktionierte bei mir leider nicht zuverl\u00e4ssig.<\/p>\n\n\n\n

Zu diesem Zeitpunkt kursierten bereits Ger\u00fcchte \u00fcber eine kommende lokale API. Ich lehnte mich also entspannt zur\u00fcck. Meines Erachtens war es nur eine Frage der Zeit, bis „irgendjemand“ \u2013 ein erfahrener Entwickler aus der riesigen Community \u2013 die Integration bauen w\u00fcrde. Nicht im Traum h\u00e4tte ich gedacht, dass dieser „irgendjemand“ ich sein w\u00fcrde.<\/p>\n\n\n\n

<\/div>\n\n\n\n

<\/a>Der Urlaub und die Neugier<\/h2>\n\n\n\n

Im Mai wurde die Connect API<\/strong> von eQ-3 ver\u00f6ffentlicht. Da ich den Sommer \u00fcber l\u00e4ngere Zeit im Urlaub war, rechnete ich fest damit, bei meiner R\u00fcckkehr bereits erste Community-L\u00f6sungen vorzufinden. Doch als ich zur\u00fcckkam: Nichts.<\/p>\n\n\n\n

Aus reiner Neugier dachte ich mir: „Vielleicht probiere ich einfach mal, Kontakt mit der HCU aufzunehmen.“ Ich wollte nur sehen, was passiert. Zu meiner \u00dcberraschung konnte ich nach relativ kurzer Zeit eine Verbindung aufbauen. Das Ergebnis war eine output.json, die den Status aller meiner Ger\u00e4te enthielt. Das war der Moment, in dem es „Klick“ machte: Die Kommunikation mit der HCU war also machbar, und die Daten lagen quasi auf dem Silbertablett f\u00fcr mich bereit.<\/p>\n\n\n\n

<\/div>\n\n\n\n

<\/a>Programmieren mit dem Co-Piloten<\/h2>\n\n\n\n

Hier stand ich nun vor zwei Problemen:<\/p>\n\n\n\n

    \n
  1. Ich hatte keinerlei Erfahrung in der Entwicklung von Home Assistant Integrationen (Python, Asyncio, die Architektur von HA \u2013 alles war Neuland).<\/li>\n\n\n\n
  2. Mein Job spannt mich so sehr ein, dass ich schlicht keine Zeit hatte, mich wochenlang durch Dokumentationen zu w\u00fchlen.
    <\/li>\n<\/ol>\n\n\n\n

    Die L\u00f6sung f\u00fcr dieses Dilemma war moderne Technologie: K\u00fcnstliche Intelligenz<\/strong>.<\/p>\n\n\n\n

    Ich entschied mich, die Integration nicht Zeile f\u00fcr Zeile selbst zu schreiben, sondern die Programmierung ma\u00dfgeblich durch AI erledigen zu lassen. Ich fungierte eher als Architekt, der die Logik vorgibt und die Ergebnisse pr\u00fcft.<\/p>\n\n\n\n

    Das Ergebnis war verbl\u00fcffend. Bereits nach einem einzigen Abend<\/strong> hatte ich ein MVP (Minimum Viable Product), das stabil einen Handshake mit der HCU aufbaute und die ersten Ger\u00e4te in Home Assistant sichtbar machte. Einen Abend sp\u00e4ter konnte ich bereits alle meine Ger\u00e4te nicht nur sehen, sondern auch steuern.<\/p>\n\n\n\n

    <\/div>\n\n\n\n

    <\/a>Vom Experiment zum Community-Projekt<\/h2>\n\n\n\n

    Als ich sah, wie gut dieser „Schnellschuss“ funktionierte, dachte ich mir: „Wenn das f\u00fcr mich klappt, hilft es vielleicht auch anderen.“ Kurzerhand lud ich den Code auf GitHub hoch und meldete mich in zwei Foren an, um Bescheid zu geben: Es gibt da etwas zum Testen.<\/p>\n\n\n\n

    Die Resonanz war prompt, riesig und \u00fcberaus positiv. Das hat mich einerseits \u00fcberrascht, andererseits riesig gefreut. Doch schnell wurde klar: Der Teufel liegt im Detail.<\/p>\n\n\n\n

    Die Homematic IP Welt ist extrem vielf\u00e4ltig und mir fehlten schlicht die Ger\u00e4te, um alles zu testen. Nutzer meldeten fehlende Unterst\u00fctzung f\u00fcr Sensoren, Aktoren oder spezielle Funktionen. Die Komplexit\u00e4t der Integration stieg konstant an. Ich musste mehrmals strukturelle \u00c4nderungen am Code vornehmen (Refactoring), damit die Integration mit den wachsenden Anforderungen mithalten konnte.<\/p>\n\n\n\n

    Ich will ehrlich sein: Das f\u00fchrte auch einige Male zu Updates, die eher R\u00fcckschritte waren und Dinge kaputt machten. Aber genau hier zeigte sich die St\u00e4rke von Open Source.<\/p>\n\n\n\n

    <\/div>\n\n\n\n

    <\/a>Die Kraft der Gemeinschaft<\/h2>\n\n\n\n

    Es dauerte nicht lange, bis sich sehr f\u00e4hige Leute aus der Community meldeten. Sie warteten nicht nur auf Fixes, sondern nahmen Updates und Weiterentwicklungen in Eigenregie vor. Das war \u2013 und ist \u2013 gro\u00dfartig. Es nimmt mir eine riesige Last von den Schultern, da die Integration nun nicht mehr nur von meiner begrenzten Zeit abh\u00e4ngig ist.<\/p>\n\n\n\n

    <\/div>\n\n\n\n

    <\/a>Der aktuelle Stand in Zahlen<\/h2>\n\n\n\n

    Es ist erstaunlich, was wir in so kurzer Zeit erreicht haben. Ein Blick in den Code der Integration zeigt heute ein beeindruckendes Bild:<\/p>\n\n\n\n