Neuer ioBroker-Blog online: Monatsrückblick März/April 2026

[fuzzy1955]

fuzzy1955 sagte:

teilautomatische Generierung der Dokumentation würde mir auch gefallen

Ich habe gerade den KI-Copiloten mit der Frage konfrontiert:

Erstelle von meiner Hausautomation mit IOBroker eine Dokumentation mit den Inhalten:

• Hauptansicht
• PV-Anlage
Module
Wechselrichter
Hausakkus
Wallbox
• Klimatisierung
• Wetter
• Außenanlagen (Garage und Garten)
• Diagramme
• Gerätestatus

Ergebnis:

Hauptansicht
Zweck: Kurzüberblick über Systemzustand, Energieflüsse und kritische Werte.
Empfohlene Elemente:

Übersichts-Kacheln für: Hausstrom, PV-Leistung, Hausakku-SoC, Wallbox-Status, Notstrom, Klimatisierung.

Schnellindikatoren: Autarkie-Status, heutiger PV-Ertrag, aktuelle Netzbezug/Überschuss.
Beispielwerte aus der aktuellen Ansicht: PV-Leistung 260 W, PV-Ertrag heute 8,6 kWh, Hausakku 26,7 kWh (89%), Hausstrom 1.928 W, Autark seit 44 Tagen. 

PV-Anlage
Module
Beschreibung: Anzeige der Modulgruppen, Einzelmodul-Leistung und Temperaturüberwachung.

Wichtige Felder: Momentanleistung pro Modulgruppe; Temperatur M01 / S02; Fehler- oder Abschaltmeldungen.

Empfehlung: Einzelmodule als aufklappbare Liste darstellen, mit Farbcode für Leistung (grün = OK, gelb = reduziert, rot = Fehler).

Wechselrichter
Beschreibung: Status und Leistungsdaten der Wechselrichter (z. B. Anzahl und Nennleistung).

Wichtige Felder: WR-Leistung 2 x 10 kW, WR-Verlustleistung 97 W, AC- und DC-Leistung. 

Alarmbedingungen: Kommunikationsverlust, Übertemperatur, hoher Verlustleistung (> definierter Schwellenwert).

Hausakkus
Beschreibung: Kapazität, Ladezustand, Lade-/Entladeleistung, Temperatur.

Wichtige Felder: Kapazität 26,7 kWh, SoC 89%, aktueller Lade-/Entladestrom (z. B. entlädt 100 W). 

Betriebsmodi: Laden bei Überschuss, Entladen bei Netzbezug, Notstrommodus.

Empfehlung: Historische SoC-Kurven, Ladezyklen-Log und Warnung bei Temperatur > 60°C.

Wallbox
Beschreibung: Ladeleistung, Status (verbunden/gesperrt), Fehlerhinweise.

Wichtige Felder: Aktuelle Wallbox-Leistung (z. B. 0 W wenn inaktiv), Statusmeldungen wie Pause: Kabel ist gesperrt. 

Sicherheitsregeln: Freigabe nur bei korrekter Erdung und wenn Notstrom-/Prioritätsregeln erfüllt sind.

Klimatisierung
Zweck: Überwachung und Steuerung von Heizung/Kühlung, Innen- und Außentemperaturen.
Wichtige Felder: Innenraumtemperatur (z. B. Innen 22.9°C), Betriebszustand (z. B. Standby).   
Funktionen in der Dokumentation:

Modi: Automatik, Komfort, Eco, Standby.

Szenen: Abwesenheit, Nacht, Komfort.

Alarme: Abweichung > X °C vom Sollwert, Ausfall der Regelung.
Empfehlung: Verknüpfung mit PV/ Akku-Logik (z. B. Heizen bei PV-Überschuss).

Wetter
Zweck: Lokale Wetterdaten zur Optimierung von PV-Ertrag, Bewässerung und Außenbeleuchtung.
Anzeigen: Aktuelle Außentemperatur, Wind, Niederschlag, Prognose für 24–72 Stunden.
Integration: Automatische Anpassung von Rollläden, Gartenbewässerung und Heiz-/Kühlplänen basierend auf Prognosen.
Hinweis zur Visualisierung: Kombinierte Anzeige von PV-Leistung und Sonneneinstrahlung zur Plausibilitätsprüfung.

Außenanlagen Garage und Garten
Garage

Zwecke: Torstatus, Beleuchtung, Steckdosen, Wallbox-Integration.

Wichtige Felder: Tor offen/geschlossen, Bewegungsmelder, Beleuchtungszeitpläne.

Sicherheitsfeatures: Automatische Schließung nach X Minuten; Alarm bei unautorisiertem Zugriff.

Garten

Zwecke: Bewässerung, Beleuchtung, Wetterstation, Sensoren (Bodenfeuchte, Temperatur).

Funktionen: Zeitpläne, Feuchtigkeitsbasierte Bewässerung, Nachtbeleuchtung mit Präsenzsensor.
Empfehlung: Separate Ansicht für Außenanlagen mit Schnellzugriff auf manuelle Steuerung und Wartungsprotokoll.

Diagramme und Gerätestatus
Diagramme

Zweck: Langzeit- und Echtzeit-Visualisierung für Energieflüsse und Systemzustände.

Empfohlene Diagramme:

PV-Leistung vs. Hausverbrauch (Live und Tagesverlauf).

SoC Hausakku (Stunden/Tag/Woche).

Netzbezug / Einspeisung (kWh pro Tag).

Wallbox-Ladeleistung über Zeit.

Datenauflösung: Live (Sekunden/Minuten) für Dashboard; stündlich/täglich für Statistik.

Gerätestatus

Zweck: Detaillierte Liste aller Geräte mit Zustand, letzter Kontakt, Firmware-Version, Fehlercodes.

Wichtige Spalten: Gerätename; Status (OK/Fehler/Standby); Letzte Meldung; Letzte Messwerte; Priorität.

Beispielwerte aus Ansicht: AC-Leistung 213 W; DC-Leistung 100 W; Boiler-Ladestand 116% (Basis 46°C). 

Wartung: Protokoll für Firmware-Updates, geplante Inspektionen, und automatische Benachrichtigungen bei kritischen Fehlern.

Betrieb, Alarme und Wartung
Alarmprioritäten: Kritisch (Sicherheits-/Brandschutz, Notstromausfall), Hoch (Batterie-Temperatur, Wechselrichterfehler), Mittel (Kommunikationsstörung), Niedrig (Sensorabweichung).

Benachrichtigungen: Push, E‑Mail, SMS (konfigurierbar).

Wartungscheckliste: Monatlich (Logs prüfen), vierteljährlich (Firmware), jährlich (physische Inspektion PV-Module und Akkus).

Backup-Strategie: Regelmäßige Export-Backups der VIS-Ansichten und Datenbank (manuell/automatisiert).

Umsetzungshinweise für ioBroker VIS
Widgets: Verwende Kacheln für Schnellwerte, Liniencharts für Zeitreihen, Tabellen für Gerätestatus.

Datenquellen: Nutze vorhandene Datenpunkte für PV, WR, Akku, Wallbox, Klima, Wetter, Außenanlagen.

Performance: Lade-intensive Diagramme als on-demand Charts; Caching für historische Daten.

Zugriffsrechte: Rollenbasierte Ansicht (Admin, Haushalt, Gast) mit eingeschränktem Zugriff auf Steuerfunktionen.

Ist natürlich viel Blödsinn dabei. Aber vielleicht ein Grundgerüst.

[David G.]

Der größte Teil läuft ja über Scripte.
Du könntest ein Backup von der KI durchsuchen lassen was alle Scripte ausliest.

Falls die DPs ordentlich benannt sind, kommt da bestimmt was gutes bei raus wenn der Promt stimmt.

EDIT
Habs grad getestet.
Ist eine ganz ordentliche Doku geworden.
Natürlich noch Potenzial zur Erweiterung, aber eine solide Basis.

EDIT 2

Das ist das Inhaltsverzeichnis:

Inhaltsverzeichnis

1. Systemübersicht
2. Hardware & Geräte
3. Sicherheit & Alarmsystem
4. Lichtsteuerung
5. Heizung
6. Garage
7. Multimedia (BOSE, TV)
8. Netzwerk & IT-Infrastruktur
9. GPS & Anwesenheitserkennung
10. Benachrichtigungen & Kommunikation
11. Zähler (Wasser & Gas)
12. Haushalt & Alltagsautomationen
13. Sonstige Überwachungen
14. Visualisierung (VIS-Tabellen)
15. Finanzen
16. Skript-Übersicht (alle Ordner)

[crunchip]

@David-G. sagte:

Du könntest ein Backup von der KI durchsuchen lassen was alle Scripte ausliest.

und wie sieht es da mit Datenschutz bezogen auf IPs, Tokens, Passwörter...aus?

[maloross]

das sind alles sehr gute Hinweise, wobei mir nicht klar war, wie viel im Laufe der Jahre zusammengekommen ist.
Meine Skripte muss ich sowieso alle einmal durchschauen, da ist so viel Überflüssiges oder Umständliches drin, halt das typische "ich kopier mal das Skript in mein ioB". Es funktioniert halt - irgendwie.
Ich glaube, am einfachsten ist der Lageplan: wo ist was eingebaut, angebracht oder untergebracht. Da taucht vielleicht auch das eine oder andere Gerät wiede auf, dessen Einsatzort ich vergessen habe und das ich auch nie aus dem System entfernt habe.

[David G.]

@crunchip

Da ist natürlich was dran.....
Ehrlich gesagt fällt mir zumindest nur 1 Skript ein was ftp Zugangsdaten hat.....

Hab es zumindest in Claude Code gemacht. Das ist Gedächtnislos und speichert Gespräche nicht ab wie die web Version.

[UlliJ]

@maloross

ungeliebt aber wichtig...
Stromlaufpläne sollten ohnehin vorhanden sein, umso mehr wenn Shelly und Co in die Dosen Einzug halten.

Habe in den letzten Tagen auch ein wenig mit Doku für das smarte Haus "gespielt". Als Aufhänger/Struktur letztlich die Visu gewählt und dann mit KI Unterstützung ein (manuell gepflegtes) HTML Dokument erstellt. Das ist als iframe in Vis eingebunden

Die Vis Seite mit Darstellung, grober Aufbau und abhängigen Skripten

Die Skripte selbst etwa so

Als Beispiel eine Skriptbeschreibung, weiter unten kommen dann noch Datenpunkte, Verwendung wo/wie/was und weitere Erklärungen.

Das bleibt aber immer noch ein ganzer Haufen Arbeit🫣, auch mit dem was man gerade noch weiß und über die Jahre nicht vergessen hat.

[maloross]

Mein Pool an physischen Geräten ist (noch) einigermaßen überschaubar im Vergleich zu den meisten hier aus dem Forum, aber da kommt doch schon eine ganze Menge zusammen. Stromfluss wär das letzte, an das ich gedacht hätte. Manche Dinge habe ich wohl einfach als "selbstverständlich" verinnerlicht...
Und welche KI-Unterstützung ist hier gemeint? Chatgpt & Co oder gibt es da schon spezifische Hilfen?

[OliverIO]

@David-G. sagte:

Hab es zumindest in Claude Code gemacht. Das ist Gedächtnislos und speichert Gespräche nicht ab wie die web Version.

das ist das was du siehst.
dennoch wird dein input zum training verwendet
https://code.claude.com/docs/de/data-usage#datentrainingsrichtlinie

kannst du ggfs deaktivieren.
https://claude.ai/settings/data-privacy-controls

Aber trotzdem
https://code.claude.com/docs/de/data-usage#datenspeicherung

Speicherung ohne Erlaubnis für Training 30 Tage
Speicherung mit Erlaubnis für Training 5 Jahre

Erst bei den Enterprisetarifen kann man das komplett deaktivieren.

[MartinP]

Die Technologie, mit der man die Doku ablegt ist sicherlich auch wichtig.

Ich nutze eine gitea-Instanz in einem Docker-Container auf meinem Proxmox-Server.
Alles, was ich Dokumentierenswert finde wird in Markdown gefasst, und dort abgelegt...

Lokale Replikation, Arbeiten von verschiedenen Rechnern aus - alles kein Problem, wenn man einigermaßen mit Git vertraut ist.

[maloross]

Über das Werkzeug, mit dem ich das erstellen werde, muss ich mir noch Gedanken machen. Es muss vor allem für die Nutzer leicht erreich- und gut lesbar sein. Mit allem anderen muss ich mich dann vertraut machen, aber das ist wohl die geringste Herausforderung.

[MartinP]

@ullij

3x1,5 mit 16 A LS abgesichert?

Das ist stark "auf Kante genäht".

Ist die Verlegeart entsprechend?

https://search.abb.com/library/download.aspx?documentid=2cdc401002d0106&languagecode=de&documentpartid=&action=launch

[Samson71]

@MartinP
Ich denke das gehört hier jetzt nicht wirklich zum Thema. Bei mir sind auch 3x0,75 mit 16A teilweise abgesichert aus der Historie.

Und NEIN, das artet jetzt hier bitte NICHT in Grundsatzdiskussionen aus, sonst müssen wir Mods den Mist wieder mühsam abspalten.

DANKE

[fuzzy1955]

@maloross sagte:

Daher plane ich, ein Handbuch mit den wichtigsten Informationen zusammenzustellen

An alle findigen Leute hier: @samson71 , @oliverio, @shadowhunter23 .......

Wäre das eine Möglichkeit für einen neuen IOB-Adapter (evt. mit KI-Unterstützung), der unter WEB.0 läuft und mit dessen Hilfe eine hauseigene HTML-Dokumentation erstellt bzw. geplegt werden kann? Die Darstellung könnte im VIS-2 in einem Basic-IFrame erfolgen, ähnlich diesem Layout:

Ideal wäre eine Auswahlmöglichkeit an Datenpunkten-Strukturen, etwa:

Ich würde diesen Adapter schon entwickeln, aber mir fehlen dazu doch viele Skills. Aber ich wäre ein eifriger Tester.
Gruß, Fuzzy

[OliverIO]

@fuzzy1955

Wie wäre es mit sowas?

https://js.wiki/
Oder noch besser integrierbar
https://tiddlywiki.com/

Die Frage ist bei Applikationen immer muss es ein eigener Adapter sein, oder kann es parallel zum iobroker laufen.

Eine fertige Applikation hat den Vorteil, dass sie schon viele Features enthält.
Sowas in einen Adapter rein zu packen, hat den Nachteil, dass der mit der Applikation zusammen aktualisiert werden muss oder halt dann stehen bleibt.

[UlliJ]

@fuzzy1955 sagte:

Die Darstellung könnte im VIS-2 in einem Basic-IFrame erfolgen

habe das so gestartet, getriggert durch den autodoc Adapter von @crunchip
Nur sollen mehr Zusammenhänge und Übersicht rein, Funktionsbeschreibung für Skripte, Querverweise Vis <-> Skript <-> DP's... wenn möglich automatisch aktualisiert.
Ist kein Adapter sondern 3 Skripte (generiert mit KI). Ergebnis ist nach Einhaltung von Konventionen in der Vis und in Skripten aktuell so
Doku Übersichtsseite als iframe in Vis

Einzelne Vis Seiten werden über einen Kommentar auf der Seite in der Doku als Referenz angelegt

Skripte werden so dokumentiert

im Header des Skriptes

// ============================================================
// ScriptMappingGenerator.js
// Analysiert alle ioBroker-Skripte aus dem Spiegel-Verzeichnis
// Metadaten (enabled, type) per getObject nachladen
//
// Voraussetzung: JS-Adapter → "Spiegeln von Skripten" aktiviert
//
// ============================================================
// ScriptMappingGenerator
// @desc      Analysiert alle ioBroker-Skripte aus dem Spiegel-Verzeichnis
// @desc-long Liest alle .js/.ts Dateien und extrahiert Metadaten und IPO-Tags.
// @desc-long Ergebnis wird als HTML und JSON in userdata gespeichert.
// @ipo-input  Spiegel-Verzeichnis | getObject() Metadaten
// @ipo-input-sub /home/iobroker/skript
// @ipo-proc   collectFiles() | extractIPO() | findConflicts() | generateHTML()
// @ipo-proc-sub Skripte auslesen | Diagramm erzeugen | Schreibkonflikte | HTML Doku ausgeben
// @ipo-output ScriptMapping.html | ScriptMapping.json | lastUpdate
// @calc       Konflikt = setState() auf gleichem DP durch 2+ aktive Skripte
// ============================================================

ergibt in der Doku so etwas

Teile sind wären ok, andere passen noch nicht. Über die Jahre kommen da ganz schön viele "Leichen" zusammen 🤔

[David G.]

Ich habe die letzten Wochen angefangen es in einer selbst (mit Claude) geschriebenen Notes App zu dokumentieren.
https://forum.iobroker.net/topic/83978/lokal-notizen-verwalten

EDIT:
Das mit einem Adapter oder Script zu machen finde ich auch nicht Sinnig.
Denke die Doku muss auch verfügbar sein, wenn der ioBroker warum auch immer nicht läuft und man was nachschlagen muss.
Oder wenn man gesundheitlich wirklich nicht kann es so einfach wie möglich ist für den Ehepartner etc drauf zuzugreifen.

[crunchip]

@David-G. Ist es doch auch wenn iobroker nicht läuft, speicherbar extern, im weiteren Verlauf folgt noch pdf

[David G.]

@crunchip

Das ist dann natürlich was anderes

[fuzzy1955]

@OliverIO sagte:

Eine fertige Applikation hat den Vorteil, dass sie schon viele Features enthält

Das kenne ich. Ich vergaß zu erwähnen, dass ich nichts im Internet habe möchte.

[fuzzy1955]

@UlliJ sagte:

Ist kein Adapter sondern 3 Skripte (generiert mit KI).

Klar, das ginge auch mit Skript. Also wäre das doch was für mich zum Entwickeln ;-)