myGEKKO DDF-Handbuch
Dieses Handbuch beschreibt das DDF-Konzept (Device Definition Files) von myGEKKO auf Referenzniveau. Es richtet sich an
- Techniker, die neue Geräte an ein myGEKKO-System anbinden oder grafische Oberflächen (Widgets) bauen wollen, und
- KI-Agenten, die ausschließlich mit diesem Handbuch korrekte DDF-Dateien erzeugen sollen.
Grundlage
Alle Aussagen stammen aus dem Quellcode der DeviceLib (Loader ioDeviceDB, Protokolltreiber, Formelinterpreter, SVG-Renderer) und aus realen Beispiel-DDF. Wo das Verhalten nicht eindeutig belegt ist, steht der Hinweis „zu klären“. Alle offenen Punkte sind in Offene Punkte gesammelt.
Aufbau
| Teil | Inhalt |
|---|---|
| Einführung | Was ist DDF, Architektur, Mehrwerte |
| Teil A – Protokoll-DDF | Gemeinsame Grundlagen (Dateiname, ID, CSV-Blöcke, Spalten, Variablen, Formeln, Signatur, Debugging) und ein Kapitel je Protokoll: MODBUS TCP, MODBUS RTU, REST, MQTT, OCPP, SERCOM, DMX512, WebSocket |
| Teil B – GUI-DDF (SVG) | *OBJECT-Block, SVG-Untermenge, GUI-Zeichen-API, Variablen und Mausereignisse, Bibliotheken, Walkthrough mit DEMO_DDF.csv |
| Anhang | Formelreferenz, Keyword-/Spaltenreferenz, Quick Spec für KI-Agenten, FAQ, Glossar |
Schnellstart
- Lies Was ist DDF? und Architektur.
- Für eine Geräteanbindung: CSV-Struktur, danach das Kapitel deines Protokolls.
- Für ein Widget: GUI-Konzept und DEMO_DDF-Walkthrough.
- KI-Agenten beginnen mit der Quick Spec.
Datenschutz
In allen Auszügen sind IP-Adressen, Tokens, Passwörter, Signaturen, Seriennummern und Personennamen durch Platzhalter wie <DEVICE_IP>, <API_KEY> oder <SIGNATURE_BASE64> ersetzt.