ich bin gerade mobilitätstechnisch etwas eingeschränkt und hab dadurch endlich Zeit für Sachen, die seit Jahren auf meiner Liste stehen. Ganz oben: die Config aufräumen.
Das hab ich jetzt mit Claude gemacht, und ich bin echt begeistert. Wir haben Loxone seit 2016, und seitdem will ich das eigentlich machen. In knapp zehn Jahren hab ich es nie so ordentlich hinbekommen wie jetzt. Die Config ist endlich so übersichtlich, wie ich mir das immer vorgestellt habe. Nebenbei haben wir noch ein paar Logikfehler gefunden.
Dabei ist einiges an Werkzeugen, Regeln und Wissen über Loxone Config zusammengekommen, das so in keiner Doku steht. Das will ich hier teilen. Ohne Anspruch darauf, dass es für jeden und überall funktioniert oder dass alles stimmt. Bei mir hat es geklappt.
Wie das aussieht, seht ihr im angehängten PDF: drei Seiten aus meiner Config, jeweils vorher und nachher. Ich finde, die sind jetzt viel besser lesbar.
Kurz zur Einordnung: Das ist eine Privatinstallation, ein Haus für eine kleine Familie. Ich bin nicht selbstständig und nicht im Loxone-Vertrieb tätig, ich mach das nur für mich. Für größere professionelle Installationen ist mein Ansatz wahrscheinlich nicht ausgereift.
Wie es abläuft
Die KI arbeitet nur an der Config-Datei, nicht am Miniserver. Sie baut eine neue Datei und prüft sie. Ihr macht die in Loxone Config auf, schaut sie euch an und ladet sie selbst hoch.
Danach ladet ihr die Config vom Miniserver zurück, speichert sie unter gleichem Namen und gebt sie der KI. Die schaut dann nach, ob genau das angekommen ist, was sie gebaut hat.
In der ganzen Zeit hat Config jede Datei ohne Fehlermeldung geöffnet, und der Miniserver hat jeden Upload ohne Absturz genommen. Keine Syntaxfehler, nichts. Die paar Logikfehler, die trotzdem durchgerutscht sind, hat die KI beim Vergleich mit der Rückladung selbst gefunden und direkt behoben.
Die KI zeichnet bei Bedarf die Seiten selbst nach, ohne Loxone Config, nur aus der Datei. So sieht sie schon vor der Abgabe, ob was übereinander liegt, eine Linie durch einen Baustein läuft oder eine Notiz verrutscht ist. Gebt ihr ab und zu einen PDF-Druck aus Config zurück, dann gleicht sie ihr Bild daran ab und bessert nach, wo es nicht passt. Wie gut das klappt, seht ihr an der Legende im Anhang: einmal als echter Druck aus Config und einmal so, wie die KI sie nur aus der Datei selbst zeichnet.
Was schon drinsteckt
Mit der Beta von Config 17.3 und ihrem MCP-Server haben wir alle Bausteine, die sich bei einem Miniserver Gen 1 setzen lassen (174 Stück), einzeln rausgezogen, mit allen Ein- und Ausgängen in verschiedenen Varianten, und alles ausgemessen. Daher weiß die KI, wie groß ein Baustein ist und wo welcher Anschluss sitzt. Das ist alles eingeflossen und liegt bei. Den MCP-Server braucht ihr dafür also nicht. Weil es auf der Beta beruht, kann es bei anderen Versionen kleine Abweichungen geben.
Am Anfang liest die KI den Installationsordner von Loxone Config ein und holt sich die Bausteindoku von loxone.com samt Bildern. Das liegt nicht bei, weil es Loxone gehört. Die Prüfungen laufen auch ohne, aber damit versteht die KI, was ein Eingang wirklich tut. Vorher lag sie da öfter mal daneben, weil die Namen in der Datei anders heißen als in Config.
Den MCP-Server aus Config 17.3 würde ich zum Arbeiten nicht nehmen. Der liefert kein Bild der Seite und nicht, wo die Anschlüsse liegen. Und an der Datei kann man jede Änderung nachvollziehen. Mehr dazu in der START.md.
Sicherheit
Die KI darf am Miniserver grundsätzlich nichts schalten und nichts hochladen, nur lesen. Das steht so im Starttext, den ihr ihr am Anfang gebt. Für Sicherheitsrelevantes wie Schlösser, Tore und Alarm steht es dort noch einmal extra: Das ändert sie nur, wenn ihr es ausdrücklich sagt, auch nicht nebenbei.
Was ihr braucht
Python und eine KI, die in einem Ordner arbeiten darf. Die START.md im Anhang führt durch die Einrichtung. Das ist die einzige Datei, die ihr lesen müsst.
Macht vorher eine Sicherung, und ladet nichts hoch, was ihr euch nicht angesehen habt.
So legt ihr los
- loxone-ki-aufraeumen.zip herunterladen und entpacken
- START.md lesen, da steht alles Weitere drin
Meine Regeln
ein Vorschlag: die KI stellt sie zu Beginn vor, ihr entscheidet
Seiten
- Seiten nach Themen, nummeriert (1.0, 1.1 …), mit Inhaltsverzeichnis
- vorn eine Einführung, eine Legende mit Beispielseite und eine Seite zu den Berechtigungen
- Tests und Protokolle auf eigenen Entwicklungsseiten, nicht auf den aufgeräumten Seiten
- Eingänge links, App-Bausteine und große Bausteine in der Mitte, Ausgänge rechts
- Bausteine auf dem Raster von Loxone Config, ganze Seitenhöhe nutzen, Luft zwischen Gruppen
- Linien möglichst wenig kreuzen, über die Anordnung; lieber eine Kreuzung als ein Umweg; nie durch Bausteine
Referenzen und Merker
- Linie, wo sie gerade und frei verläuft
- Eingangsreferenz (Kästchen am linken Rand), wo die Linie rückwärts oder durch Bausteine liefe oder von einer anderen Seite kommt
- dasselbe Signal für nahe Bausteine: eine Referenz mit verzweigter Linie, für weit auseinanderliegende eine Referenz je Ziel
- Eingangsreferenzen links untereinander, in der Reihenfolge ihrer Ziel-Eingänge, dann kreuzt sich nichts
- Merker nur für Signale mit eigener Bedeutung, die an mehreren Stellen gebraucht werden; sonst Referenzen
- Merker nach ihrer Bedeutung benennen, die Notiz sagt, wann er aktiv ist und wo er gelesen wird
Farben
- Bausteinfarbe zeigt die App: eigene Kachel, Kachel und verlinkt, nur verlinkt, nur in Config
- Eingang hellblau, Ausgang orange, Merker violett, Konstante dunkelgrau, Mitteilung schwarz, Protokoll weiß
- Bedeutung nie nur über den Farbton, auch über die Helligkeit (wegen meiner Rot-Grün-Schwäche)
- Fußzeile jeder Seite zeigt die Farben
Notizen
- über jedem Baustein, der in der App vorkommen könnte, eine Kopfzeile: wo er in der App erscheint
- darunter: was der Baustein tut und wozu, nicht womit er verbunden ist (das sieht man ja)
- technische Eingänge (MQTT u. ä.) bekommen eine Notiz: Gerät, Wert, Einheit
- sprechende Eingänge und Ausgänge brauchen keine eigene Notiz
- gleiche Ketten aus Bausteinen nur an der ersten Kette kommentieren
- offene Punkte als rosa To-do-Notiz
- längere Texte luftig: eine Aussage je Zeile
- Kästchen neben Eingängen, die in der App vorkommen: gelb = bedienbar, grau = nur Anzeige
Namen
- Taster und Schalter: Einbauort, Gerät, Taste (z. B. „Kellertür Taster oben“)
- Einbauort steht im Namen, der Raum sagt, wo etwas in der App erscheint
- Bezeichnung für Config (Technik, Einbauort), Beschreibung für die App
- MQTT-Eingänge nie umbenennen, der Absender kennt den Namen; deshalb die Notiz mit Gerät, Wert und Einheit
- keine Abkürzungen
Rechte
- Rechte nach Möglichkeit nur über Kategorien vergeben, nur im Ausnahmefall an einzelnen Bausteinen
- Dinge, die ich gerade baue, kommen in eine eigene Kategorie „In Erprobung“, die nur ich sehe, damit sie im Alltag niemanden verwirren
Überwachung
- zu jeder neuen Automation bietet die KI einen Melder an: woran merkt man, dass sie nicht mehr läuft? Die Melder landen gesammelt auf der Überwachungsseite
Was vor jeder Abgabe geprüft wird (27 Prüfungen, ein Befehl)
- keine Verbindung verloren
- keine Referenz ins Leere
- keine doppelten Kennungen
- Logik nur dort geändert, wo es beauftragt war
- Parameter nur dort geändert, wo es beauftragt war
- App-Sichtbarkeit nur dort geändert, wo es beauftragt war
- Rechte nur dort geändert, wo es beauftragt war
- Projektdatum neuer als der Stand auf dem Miniserver, sonst übernimmt Config beim Verbinden Teile vom Miniserver (bei mir z. B. die alten Namen umbenannter Bausteine)
- neu eingefügte Bausteine haben alle Anschlüsse und Einstellungen, die Config erwartet, sonst gehen beim Öffnen Leitungen verloren
- keine Leitungen, die Config gar nicht anzeigt (die wirken dann auch nicht)
- Formeln richtig geschrieben
- kein „%“ in Namen (Config macht beim Speichern „_“ daraus)
- Status-Bausteine nur mit belegten Eingängen
- Bausteine, die unter einem anderen verlinkt sind, tauchen dort in der App auch wirklich auf
- Symbole kommen in der App an
- Notizen passen zum Baustein
- genannte Namen und Seiten gibt es
- Inhaltsverzeichnis stimmt
- keine Bausteine, Referenzen oder Notizen übereinander
- keine Linie durch einen Baustein
- Bild jeder geänderten Seite zum Ansehen
- ...
Damit man sich auf die Prüfungen auch verlassen kann, gibt es einen Selbsttest, der die Prüfungen selbst prüft. Dafür legt er eine Kopie eurer Config an, baut dort testweise typische Fehler ein, die bei uns wirklich passiert sind, und schaut, ob jeder davon gemeldet wird. Eure eigentliche Config bleibt dabei unberührt. Baut die KI eine neue Prüfung, kommt der passende Test gleich mit dazu.
Anhang:
- loxone-ki-aufraeumen.zip: die Werkzeuge
- vorher_nachher.pdf: drei Seiten jeweils alt und neu (Wallbox, Solcast, Balkontür), dazu die Legende einmal als Druck aus Config und einmal so, wie die KI sie selbst zeichnet
Viel Spaß damit, und ich freue mich über Rückmeldungen!