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

[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 ;-)

[fuzzy1955]

@UlliJ sagte:

autodoc Adapter

Muss ich mir dringend ansehen. Den kenne ich noch nicht.

[fuzzy1955]

@David-G. sagte:

Denke die Doku muss auch verfügbar sein, wenn der ioBroker warum auch immer nicht läuft

Wenn der IOBroker steht, stünde mein ganzes Haus. Wenn da bei mir nicht ein 1:1 Testgerät einspringen würde.

[OliverIO]

@fuzzy1955

Was meinst du mit "das kenne ich"?
Beide sind keine Applikationen im Internet (evtl schon wenn jemand das anbietet).
Ich habe die rausgesucht, weil man sie beide auf node basieren und lokal betreibbar sind.
Aber schau dir mal autodoc an.
Wenn es das nicht ist, dann müssen wir noch ein wenig die groben Anforderungen feststellen, bevor man da weiter ins Detail geht

[fuzzy1955]

@OliverIO sagte:

schau dir mal autodoc an

Ja, das mache ich.

Beide sind keine Applikationen im Internet

Pardon, das wusste ich nicht.

[fuzzy1955]

@UlliJ sagte:

autodoc Adapter?

Wird dieser weiter entwickelt? [EDIT] Pardon, das macht ja @crunchip.