DDF-Handbuch / Anhang

Offene Punkte (zu klären)

Diese Punkte konnten aus Code und Beispielen nicht eindeutig belegt werden. Sie sollten mit der Firmware-Entwicklung geklärt werden.

# Thema Beobachtung
1 *INIT kommt in Beispielen vor, wird vom Loader nicht geparst
2 MANUFACTURER vs. MANUFATURER Der Export liest MANUFATURER. Welcher Key ist verbindlich?
3 SERCOM DATATYPE Enum im Code ASCCI (Tippfehler)
4 WebSocket (WS) nicht in initDevice verdrahtet, nur Gerüst bzw. Basis für OCPP
5 MOD() Code liefert den Bruchteil (modf), Doku und Nutzung erwarten den Rest
6 Operator AND in Beispielen genutzt (auch in der OCPP-GENERAL-DDF), im Parser nicht belegt
7 *OBJECT Bedeutung von VIEWTYPE, IOTYPE, OUTTYPE, ALARMTIME sowie TYPE 1xx vs. x. ENUM ist laut Beispielen die Anzahl der Aufzählungswerte (Keba: 6 Texte/6 Werte, Shelly: 2 bzw. 4); geklärt.
8 *GENERAL Wirkung von DEBUGPORT, DEV_DEBUG, DEFAULT_ALARMING, DEFDOMAIN, TIMESTAMP, FAILUREITEM, VERSION_*, AUTOR
9 SERCOM CRC wird gelesen, Verwendung unklar
10 OCPP _CMD_* interne Kommandos. Direkter Aufruf aus der DDF und dessen Syntax unklar. STATUSID ist inzwischen belegt (Kommentar der OCPP-GENERAL-DDF, siehe OCPP). Offen bleibt die Bedeutung der AUTHENTIFICATION-Optionen (0:NONE,1:PASSWORD,2:DEFPASSWORD,3:BASIC_AUTH;2:TOKEN).
11 ID-Aufbau Bytes aus Beispielen abgeleitet. SVG_CHARTS nutzt Code 09 bei PROTOCOL;SVG.
12 state/$COLOR in Bibliothekssymbolen Zustandsfarben sind im Zeichenpfad nicht verdrahtet
13 <g>-Attribute transform am <g> wird vermutlich ignoriert
14 GUI.setWindow x/y werden gelesen, aber nicht verwendet (unverändert in gSvg.cpp 04.11.2026)
15 GUI.fillPie mit 10 Parametern Farbreihenfolge im Code vertauscht
16 Winkelrichtung fillPie 0° rechts, gegen den Uhrzeigersinn (abgeleitet)
17 GUI.setTimer Minimum Code (auch gSvg.cpp 04.11.2026) 50 ms, Doku 0,2 s. Neu offen: Repaint bei Werten ≥ 1 s.
18 $.GUI.FONTVALUE geklärt 04.11.2026: liefert jetzt den Wert-Font
19 Funktionsaufrufe/Ausdrücke als GUI.*-Argumente Neu 04.11.2026: Formula.cpp löst jedes Argument als Literal, Zahl oder per Variablen-Callback auf. Ob Ausdrücke vorher berechnet werden, bleibt offen; die Bibliotheken nutzen WINKEL - 2 und PRINT(…) als Argument. Empfehlung: vorher Variablen zuweisen.
20 Kodierung ANSI vs. UTF-8 für DDF-Dateien
21 DeviceLib-Debugger Aktivierung und Bezug zu DEV_DEBUG/DEBUGPORT
22 SERCOM-Positionen laut Elsner-DDF ist Position 0 der Start-Delimiter (abgeleitet, nicht im Code bestätigt)
23 DMX-Index SETVALUE(S) ist laut LEDSTRIP-DDF 0-basiert (kanali:=KANAL-1;)
24 GETVALUE/SETVALUE genauer Aufbau der Variablennamen
25 *ARGS-Spalten Original-DDF nutzen ;*ARGS;METHOD;ALIAS;TYPE;… mit leerem ALIAS. Ordnet der Loader nach Kopfnamen oder nach Position zu?
26 ,, als Anweisungsende Der Tokenizer behandelt ,, wie ;. Nicht verwenden, Zweck unklar.

| 27 | GUI.showInputDialog | geklärt 09.11.2026 (Aussage Hartwig Weidacher): Parameter = varmap-Alias, muss bereits geladen sein; auch absolute Aliasnamen (Punktpfad) sind erlaubt. | | 28 | $.VARLOCAL / $.VARGLOBAL / $.VARMAIN | geklärt 09.11.2026 (Aussage Hartwig Weidacher): Entfernung ist beabsichtigt. Alte DDF müssen auf $.VAL/$.VAR bzw. $.CTRLVAR/$.CTRLROOTVAR/$.CTRLMAINVAR umgestellt werden. | | 29 | Typpräfix bei $.CTRLVAR | geklärt 09.11.2026 (Aussage Hartwig Weidacher): Präfixe d/i/r/s gelten nicht mehr. Auflösung direkt über getsetbyName relativ zu BASE/ROOT/MAIN. |

| 30 | $.GUI.LOGINLEVEL | geklärt 09.11.2026 (Aussage Hartwig Weidacher): 0 nicht angemeldet, 1 User, 2 Techniker für Parameterebene, 3 Installateur | | 31 | Formel-Parsefehler im Widget | teilweise geklärt 09.11.2026 (Aussage Hartwig Weidacher): Anzeige nur bei ungültigem SVGANIMATE, nicht bei SVGEVENT. Offen: Sprache und Format des Fehlertexts. |