[Erfahrungsbericht] [V4.5 IP4] Nutzung von KI (LLM) für Dokumentation und Custom-Logiken

[Franky]

ja, ich denke, eine "fehlerfreie" Software ist das Ziel und nicht jedes mal hoffen, dass die KI richtig arbeitet. Es findet ja noch häufiges Haluzinieren statt und von session zu session sehr unterschiedliche Qualität der Ausgabe. Aber ich denke wir meinen eigentlich das gleiche. Es kann ja auch eine recht umfangreiche Steuerung erstellt werden, die selbst ohne maschinellem Lernen zur Laufzeit auskommt. Das kann man ja mit den Daten jederzeit offline machen und beliebig viele Konsistenztests anwenden...

[eib-eg]

Neue Umfassende Referenz- & Lehrdatei für Timberwolf Custom Logic (V4.12)

Hallo liebe Timberwolf-Community,

ich freue mich, euch heute eine neue, umfassend überarbeitete Referenz- und Lehrdatei für Timberwolf Server Custom Logic in der Version V4.12 vorstellen zu können!

Diese Dokumentation wurde in enger Zusammenarbeit mit einer fortschrittlichen AI (Claude 3 Opus) und basierend auf unzähligen Tests, Community-Feedback und den Erkenntnissen aus der offiziellen TSKB sowie vielen praktischen Logik-Projekten erstellt. Unser Ziel war es, eine Ressource zu schaffen, die sowohl Einsteigern den Weg ebnet als auch erfahrenen Nutzern und sogar AI-Assistenten als verlässliche Wissensbasis dient. Perfektion und maximale Klarheit waren dabei oberste Gebote.

Was ist neu und was bietet V4.12?

Um die Handhabbarkeit und Speicherbarkeit zu optimieren, wurde die Dokumentation in zwei Teile aufgeteilt:

Timberwolf_Custom_Logic_Referenz_Anleitung_V4.12.txt

Timberwolf_Custom_Logic_Referenz_Anleitung_V4.12.txt

Das Herzstück: Diese Datei enthält die vollständige, detaillierte Anleitung.

Ultra-kritische Meta-Regeln für AI-Assistenten: Spezielle Anweisungen, um die Generierung von korrektem Code durch AIs zu optimieren (REGEL 0-5).

Wichtige Tipps & Häufige Fehler (Tipps 1-39): Eine tiefgehende Sammlung aller bekannten Fallstricke, Syntaxbesonderheiten und Best Practices, verfeinert durch die Erkenntnisse aus früheren Versionen (insbesondere V4.8.9). Inklusive präziser AI-Hinweise zu jedem Tipp.

Korrektur Tipp 35 (Clocksignal): Die Syntax wurde präzisiert und der zwingende $RunBool_Var Parameter hervorgehoben.

Bewährte Design Patterns (Tipps 40-42): Detaillierte Erklärungen und Prinzipskizzen für häufige Aufgaben wie Ausschaltverzögerung, minimale Ein-/Ausschaltdauer und Ein-Zyklus-Impulse.

Umfassender Abschnitt zur HTTP-API-Anbindung (Tipps 43-49): Eine detaillierte Anleitung zur Anbindung externer HTTP-APIs, inklusive OAuth2-Authentifizierung, dynamischer Header- und Body-Erstellung (mit Printf und Concat), Stringlängen-Management, JSON-Parsing mit Regex (und Erwähnung von JsonPathSelector) sowie Umgang mit Rate-Limits und Statuscodes. Dieser Teil wurde mit praktischen Erkenntnissen aus dem Forum validiert.

Lizenzinformationen.

Format: Eine reine Textdatei. Code-Beispiele sind direkt in die Tipps eingebettet oder als Prinzipskizzen formuliert und dienen der Illustration.

Timberwolf_Custom_Logic_Syntax_Demo_V4.12.2.txt (Speicherbare TWS Logikdatei)

4.12.2.txt

Die Praxis: Eine minimalistische, aber 100% syntaktisch korrekte und im Timberwolf Server speicherbare JSON-Datei.

Zweck: Demonstriert die korrekte Syntax der wichtigsten Module und einiger Kernkonzepte. Ideal zum direkten Ausprobieren und als Vorlage.

Inhalt:

Einleitender Header-Kommentar mit Verweis auf die Textreferenz.

Grundlegende Systemvariablen ($VAR<Inhibit?>, $Error?).

Minimalistische, aber korrekte Syntax-Beispiele für Kernmodule wie: Comparator, Latch, CalcFormula, Multiplexer, Limiter, Regex, Monoflop, Or (als Beispiel für Gatter), Triggered, Stringcompare, Polynomial und das korrigierte Clocksignal.

Vereinfachte, aber syntaktisch korrekte Demos für die Design Patterns (Ausschaltverzögerung, Min/Max-Dauer, Ein-Zyklus-Impuls).

Wichtig: Die komplexen HTTP-API-Beispiele wurden aus dieser speicherbaren Demo-Datei entfernt, um die Speicherbarkeit nach jüngsten Tests zu gewährleisten. Die Anleitung zur HTTP-API-Anbindung ist vollständig in der Textdatei enthalten.

Fokus: Absolute syntaktische Korrektheit für direkte Verwendbarkeit im TWS.

Warum diese Aufteilung?

Die vorherige monolithische Datei (Text und umfangreicher JSON-Demo-Teil) stieß beim Speichern im Timberwolf Server an Grenzen (Fehler wie "logic_scope_db failed"). Durch die Trennung in eine detaillierte Textanleitung und eine schlanke, garantiert speicherbare JSON-Demo-Datei können wir das Beste aus beiden Welten bieten: umfassendes Wissen und praktische, funktionierende Syntaxbeispiele.

Wo finde ich die Dateien?

[Hier könnten Sie angeben, wo die Dateien zum Download bereitstehen, z.B. als Anhang, Link zu einem Repository oder einer Cloud-Ablage.]

Ein Aufruf zur Mitarbeit und zum Feedback!

Diese Dokumentation lebt vom Austausch und den Erfahrungen der Community.

Testet die JSON-Demo-Datei! Funktioniert sie bei euch?

Lest die Text-Referenz! Findet ihr die Erklärungen klar und hilfreich?

Habt ihr Ergänzungen, Korrekturen oder Wünsche für zukünftige Versionen?

Teilt eure eigenen "Aha!"-Momente oder Fallstricke, die wir aufnehmen sollten!

Ein besonderer Dank geht an alle, die im Forum aktiv sind und durch ihre Fragen und Lösungen zur Wissensbasis beitragen, sowie an die Entwickler des Timberwolf Servers für dieses mächtige Werkzeug.

Ich hoffe, diese neue Version der Referenz- und Lehrdatei hilft euch dabei, eure Custom Logic Projekte noch erfolgreicher umzusetzen!

Erstellt durch diesen link https://aistudio.google.com/prompts/new_chat

Timberwolf_Custom_Logic_Referenz_Anleitung_V4.12.txt

4.12.2.txt

@AndererStefan und mitwirkenden bitte testen

Viele Grüße,

Georg E. (eib-eg)
(und KI-Assistent Claude 3 Opus)

[AndererStefan]

Hi,

vielen Dank Georg für deine Mühe beim Entwicklen!
Ich habe die beiden Dokumente Gemini gegeben und Folgende Anforderung gestellt:

Ich benötige eine Custom Logic, die mir die Zugangsdaten für eine HTTP-API bereitstellt. Ich benötigte eine client_ID und app_secret.

Es kamen ein paar sinnvolle Rückfragen zu Variablen und zur Art wie ich Werte vorgeben möchte. M.E. sinnvoll.
Die ausgegebene Logik ließ sich aber nicht speichern.

► Text zeigen

Code: Alles auswählen

{
  // ==========================================================================
  // Timberwolf Custom Logic - API Zugangsdaten Bereitstellung
  // Zweck: Stellt Client ID und App Secret konfigurierbar über die UI bereit.
  // Version: 1.0
  // Autor: AI-Assistent (basierend auf Nutzeranforderung)
  // ==========================================================================

  "Level": [
    // --- Systemvariablen ---
    [ "$VAR<Inhibit?>", "bool", false ],
    [ "$Error?", "bool", false ],

    // --- Konfigurierbare Parameter für API-Zugangsdaten ---
    [ "$P_Api_ClientID", "string,512", "" ],
    [ "$P_Api_AppSecret", "string,512", "" ]
  ],

  "Module": [
    // 0. Logik sperren (Standardbaustein, siehe Tipp 16)
    [ "Break", [ "$VAR<Inhibit?>" ] ]

    // Keine weiteren Module notwendig, da die Werte direkt
    // von den Input-Parametern zu den Output-Variablen durchgereicht werden.
  ],

  "Input": [
    [ "SYSTEM: Logik sperren", "Logik anhalten wenn TRUE", "$VAR<Inhibit?>", "u" ],
    [ "API Konfig: Client ID", "Client ID für die HTTP-API", "$P_Api_ClientID", "c" ],
    [ "API Konfig: App Secret", "App Secret (oder API Key) für die HTTP-API", "$P_Api_AppSecret", "c" ]
  ],

  "Output": [
    [ "SYSTEM: Fehler in Logik?", "Laufzeitfehler in der Logik?", "$Error?", "ce" ],
    [ "API Wert: Client ID", "Bereitgestellte Client ID", "$P_Api_ClientID", "c" ],
    [ "API Wert: App Secret", "Bereitgestelltes App Secret", "$P_Api_AppSecret", "c" ]
  ]
}

Im Gegensatz zu meiner bestehenden KI Lösung sind hier keine Multiplexer verwendet worden. Meine Nachfrage welchen Sinn Multiplexer in diesem Kontext hätten, wurde für mich plausibel erklärt (Kurzfassung: explizites Kopieren von Input auf Output ist im komplexen Fällen sicherer, aber hier nicht nötig.). Gemini schlug dann trotzdem eine Lösung mit Multiplexer vor. Diese lies sich speichern und funktionierte.
Darüber hinausgehend kann ich die Qualität der Lösung leider nicht bewerten.

► Text zeigen

Code: Alles auswählen

{
  // ... Level unverändert mit zusätzlicher $Konst_0_int ...
  "Level": [
    [ "$VAR<Inhibit?>", "bool", false ],
    [ "$Error?", "bool", false ],
    [ "$P_Api_ClientID", "string,512", "" ],
    [ "$P_Api_AppSecret", "string,512", "" ],
    [ "$O_Api_ClientID_Out", "string,512", "" ],    // Separate Output-Variable
    [ "$O_Api_AppSecret_Out", "string,512", "" ],   // Separate Output-Variable
    [ "$Konst_0_int", "integer", 0 ]                // Konstante für Multiplexer-Selektor
  ],

  "Module": [
    [ "Break", [ "$VAR<Inhibit?>" ] ],
    [ "Multiplexer", ["$P_Api_ClientID"], "$O_Api_ClientID_Out", "$Konst_0_int" ],
    [ "Multiplexer", ["$P_Api_AppSecret"], "$O_Api_AppSecret_Out", "$Konst_0_int" ]
  ],

  "Input": [
    // ... unverändert ...
    [ "SYSTEM: Logik sperren", "Logik anhalten wenn TRUE", "$VAR<Inhibit?>", "u" ],
    [ "API Konfig: Client ID", "Client ID für die HTTP-API", "$P_Api_ClientID", "c" ],
    [ "API Konfig: App Secret", "App Secret (oder API Key) für die HTTP-API", "$P_Api_AppSecret", "c" ]
  ],

  "Output": [
    // ... angepasst auf die neuen Output-Variablen ...
    [ "SYSTEM: Fehler in Logik?", "Laufzeitfehler in der Logik?", "$Error?", "ce" ],
    [ "API Wert: Client ID", "Bereitgestellte Client ID", "$O_Api_ClientID_Out", "c" ],
    [ "API Wert: App Secret", "Bereitgestelltes App Secret", "$O_Api_AppSecret_Out", "c" ]
  ]
}

In Timberwolf_Custom_Logic_Referenz_Anleitung_V4.12.txt steht:

"Custom Logic kann verwendet werden, um externe HTTP-APIs anzusprechen."

Das ist doch nicht sooo ganz korrekt formuliert? - Es gibt kein Modul was HTTP-API ansprechen kann.
Falls diese Aussage aus meiner Verwendung der Logik im HTTP-API Kontext resultiert (viewtopic.php?f=82&t=5896):
Ich habe die Logik-Module nur als ganz "doofe" String-Speicherobjekte genutzt. Im weiteren Verlauf des Dokuments wird das auch korrekt beschrieben und mein Test oben zeigt, dass es (mit Einschränkungen) auch funktioniert hat.

Viele Grüße Stefan

[AndererStefan]

Nochmals hallo,

Im Dokument "Timberwolf_Custom_Logic_Referenz_Anleitung_V4.12.txt" steht etwas über ein Modeul "JsonPathSelector" - Das kenne ich gar nicht. Und die Aufgabe etwas aus einem json-String zu extrahieren steht mir eh noch bevor. Der betreffende json String ist leider "doof" strukturiert und hat durchnummerierte Elemente (Gardena Smart, siehe verlinkter Thread oben).
Ich will mich nicht darauf verlassen, dass die Reihenfolge konsistent ist und bleibt.

Die Aufgabe für Gemini war...:

Ich möchte den Wert "CLOSED" aus attributes.activity.value extrahieren, der zu dem Object gehört, dass die id d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3 hat

Das json habe ich mitgegeben. Da dort sensible Daten enthalten sind, hier das Beispiel aus der Doku:

► Text zeigen

Code: Alles auswählen

{
  "data": {
    "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
    "type": "LOCATION",
    "attributes": {
      "name": "My Garden."
    },
    "relationships": {
      "devices": {
        "data": [
          {
            "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
            "type": "DEVICE"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
      "type": "DEVICE",
      "relationships": {
        "location": {
          "data": {
            "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
            "type": "LOCATION"
          }
        },
        "services": {
          "data": [
            {
              "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
              "type": "COMMON"
            }
          ]
        }
      }
    },
    {
      "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
      "type": "COMMON",
      "attributes": {
        "name": {
          "value": "My precious"
        },
        "batteryLevel": {
          "value": 42,
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "batteryState": {
          "value": "OK",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "rfLinkLevel": {
          "value": 42,
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "serial": {
          "value": "12345"
        },
        "modelType": {
          "value": "Device market name."
        },
        "rfLinkState": {
          "value": "ONLINE",
          "timestamp": "2018-06-23T04:58:08Z"
        }
      },
      "relationships": {
        "device": {
          "data": {
            "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
            "type": "DEVICE"
          }
        }
      }
    },
    {
      "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
      "type": "MOWER",
      "attributes": {
        "state": {
          "value": "OK",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "activity": {
          "value": "PAUSED",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "lastErrorCode": {
          "value": "UNINITIALISED",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "operatingHours": {
          "value": 123
        }
      },
      "relationships": {
        "device": {
          "data": {
            "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
            "type": "DEVICE"
          }
        }
      }
    },
    {
      "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
      "type": "POWER_SOCKET",
      "attributes": {
        "activity": {
          "value": "OFF",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "state": {
          "value": "OK",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "lastErrorCode": {
          "value": "TIMER_CANCELLED",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "duration": {
          "value": 120,
          "timestamp": "2018-06-23T04:58:08Z"
        }
      },
      "relationships": {
        "device": {
          "data": {
            "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
            "type": "DEVICE"
          }
        }
      }
    },
    {
      "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
      "type": "VALVE",
      "attributes": {
        "name": {
          "value": "My precious"
        },
        "activity": {
          "value": "CLOSED",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "state": {
          "value": "OK",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "lastErrorCode": {
          "value": "NO_MESSAGE",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "duration": {
          "value": 120,
          "timestamp": "2018-06-23T04:58:08Z"
        }
      },
      "relationships": {
        "device": {
          "data": {
            "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
            "type": "DEVICE"
          }
        }
      }
    },
    {
      "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
      "type": "VALVE_SET",
      "attributes": {
        "state": {
          "value": "OK",
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "lastErrorCode": {
          "value": "NO_MESSAGE",
          "timestamp": "2018-06-23T04:58:08Z"
        }
      },
      "relationships": {
        "device": {
          "data": {
            "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
            "type": "DEVICE"
          }
        }
      }
    },
    {
      "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
      "type": "SENSOR",
      "attributes": {
        "soilHumidity": {
          "value": 42,
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "soilTemperature": {
          "value": 21,
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "ambientTemperature": {
          "value": 21,
          "timestamp": "2018-06-23T04:58:08Z"
        },
        "lightIntensity": {
          "value": 25560,
          "timestamp": "2018-06-23T04:58:08Z"
        }
      },
      "relationships": {
        "device": {
          "data": {
            "id": "d8a1faef-2ee3-421d-a3f8-f8ed577c2ad3",
            "type": "DEVICE"
          }
        }
      }
    }
  ]
}

Gemini erwähnte dann das Modul, sagte aber, das das nicht für alle Versionen verfügbar ist und dass Regex sicherer sei. Was hat es mit dem JsonPathSelector auf sich? Ist das Insider oder DEV oder eine Halluzination?

Der produzierte Code enthält dann leider ein ausgedachetes "IF" Modul:

► Text zeigen

Code: Alles auswählen

{
  // ==========================================================================
  // Timberwolf Custom Logic - Extrahiere Ventilstatus aus JSON
  // Zweck: Extrahiert den 'activity.value' eines spezifischen Ventils.
  // Version: 1.0
  // ==========================================================================

  "Level": [
    // --- Systemvariablen ---
    [ "$VAR<Inhibit?>", "bool", false ],
    [ "$Error?", "bool", false ],

    // --- Input: Der JSON-String von der HTTP-API ---
    // Annahme: Die maximale Länge des JSON-Strings. 4096 ist ein Startwert.
    // Ggf. erhöhen, wenn der tatsächliche JSON größer sein kann (bis 20480).
    [ "$I_Http_Json_Response", "string,4096", "" ],

    // --- Regex Pattern ---
    // Der Pattern muss alle relevanten Teile abdecken.
    // ACHTUNG: Backslashes für Regex-Sonderzeichen innerhalb des JSON-Strings
    // für Anführungszeichen (\") sind hier bereits im String-Literal.
    [ "$Pattern_VentilActivity", "string,256", "\"id\":\\s*\"58f2be0c-a13d-4da4-a5f3-33e54810ae62\"\\s*,\\s*\"type\":\\s*\"VALVE\"[\\s\\S]*?\"attributes\":\\s*\\{[\\s\\S]*?\"activity\":\\s*\\{\\s*\"value\":\\s*\"([^\"]+)\"" ],

    // --- Outputs des Regex-Moduls ---
    [ "$Lgc_Regex_HatMatch", "bool", false ],
    [ "$Lgc_Regex_FullMatch_Dummy", "string,1", "" ], // Dummy, da wir nur Gruppe 1 brauchen
    [ "$O_Ventil_Activity_Value", "string,32", "" ],  // Hier wird der extrahierte Wert ("CLOSED") landen
    [ "$Lgc_Regex_Grp2_Dummy", "string,1", "" ],
    [ "$Lgc_Regex_Grp3_Dummy", "string,1", "" ],
    [ "$Lgc_Regex_Grp4_Dummy", "string,1", "" ],
    [ "$Lgc_Regex_Grp5_Dummy", "string,1", "" ],

    // --- Hilfsvariablen für Test/Trigger ---
    [ "$P_Trigger_Extraction", "bool", false ] // Manueller Trigger für die Extraktion
  ],

  "Module": [
    // 0. Logik sperren
    [ "Break", [ "$VAR<Inhibit?>" ] ],

    // 1. Regex-Extraktion (siehe Tipp 23)
    // Wird nur ausgeführt, wenn $P_Trigger_Extraction TRUE ist (optional, für Testzwecke)
    // oder wenn $I_Http_Json_Response sich ändert und als 'a'-Input konfiguriert ist.
    // Für eine produktive Logik würde der Trigger vom HTTP-Request kommen.
    [ "If", ["$P_Trigger_Extraction"], [ // Bedingtes Ausführen des Regex
      [ "Regex",
        "$I_Http_Json_Response",
        "$Pattern_VentilActivity",
        "$Lgc_Regex_HatMatch",
        "$Lgc_Regex_FullMatch_Dummy",
        "$O_Ventil_Activity_Value",  // Gruppe 1
        "$Lgc_Regex_Grp2_Dummy",
        "$Lgc_Regex_Grp3_Dummy",
        "$Lgc_Regex_Grp4_Dummy",
        "$Lgc_Regex_Grp5_Dummy"
      ]
    ]]
  ],

  "Input": [
    [ "SYSTEM: Logik sperren", "Logik anhalten wenn TRUE", "$VAR<Inhibit?>", "u" ],
    [ "HTTP API: JSON Antwort", "Der vollständige JSON-String von der API", "$I_Http_Json_Response", "c" ], // Typ 'c' oder 'a', je nachdem, wie der HTTP-Request die Daten liefert
    [ "DEBUG: Extraktion Triggern", "Auf TRUE setzen, um die Regex-Extraktion manuell zu starten", "$P_Trigger_Extraction", "a" ]
  ],

  "Output": [
    [ "SYSTEM: Fehler in Logik?", "Laufzeitfehler in der Logik?", "$Error?", "ce" ],
    [ "Extraktion: Ventil Activity", "Extrahierter Wert von attributes.activity.value (z.B. CLOSED)", "$O_Ventil_Activity_Value", "c" ],
    [ "Extraktion: Match gefunden?", "Wurde ein Match für den Regex gefunden?", "$Lgc_Regex_HatMatch", "c" ]
  ]
}

Ich wieß auf den Fehler hin, Gemini entschuldigte sich und präsentierte eine neue Lösung mit einem Komma-Fehler (das letzte Element in einem Block vor einem langen Kommentar hatte ein überflüssiges Komma. Hab ich sogar selber gelöscht bekommen )

Das Ergebnis ist dies. - Funktioniert aber nicht. Ich habe dann nicht mehr weiter gesucht... der Abend war schon wieder mal viel zu schnell vorbei

► Text zeigen

{
// ==========================================================================
// Timberwolf Custom Logic - Extrahiere Ventilstatus aus JSON (Korrigiert)
// Zweck: Extrahiert den 'activity.value' eines spezifischen Ventils.
// Version: 1.1
// ==========================================================================

"Level": [
// --- Systemvariablen ---
[ "$VAR<Inhibit?>", "bool", false ],
[ "$Error?", "bool", false ],

// --- Input: Der JSON-String von der HTTP-API ---
// WICHTIG: Länge anpassen! Für Ihren Beispiel-JSON ist string,8192 besser.
[ "$I_Http_Json_Response", "string,8192", "" ], // Erhöhte Länge

// --- Regex Pattern ---
// Pattern aus dem vorherigen Beispiel
[ "$Pattern_VentilActivity", "string,256", "\"id\":\\s*\"58f2be0c-a13d-4da4-a5f3-33e54810ae62\"\\s*,\\s*\"type\":\\s*\"VALVE\"[\\s\\S]*?\"attributes\":\\s*\\{[\\s\\S]*?\"activity\":\\s*\\{\\s*\"value\":\\s*\"([^\"]+)\"" ],

// --- Outputs des Regex-Moduls ---
[ "$Lgc_Regex_HatMatch", "bool", false ],
[ "$Lgc_Regex_FullMatch_Dummy", "string,1", "" ],
[ "$O_Ventil_Activity_Value", "string,32", "" ],
[ "$Lgc_Regex_Grp2_Dummy", "string,1", "" ],
[ "$Lgc_Regex_Grp3_Dummy", "string,1", "" ],
[ "$Lgc_Regex_Grp4_Dummy", "string,1", "" ],
[ "$Lgc_Regex_Grp5_Dummy", "string,1", "" ],

// --- Trigger-Variable ---
// Kann durch einen Input vom Typ 'a' gesetzt werden, um die Regex-Aktion auszulösen.
// Wenn die Regex nur bei einer *Änderung* des JSON-Strings ausgeführt werden soll,
// könnte man den $I_Http_Json_Response Input als Typ 'a' konfigurieren.
[ "$P_Execute_Regex_Once", "bool", false ] // Für einen einmaligen Trigger-Impuls

],

"Module": [
// 0. Logik sperren
[ "Break", [ "$VAR<Inhibit?>" ] ],

// 1. Regex-Extraktion (siehe Tipp 23)
// Dieses Modul wird nun immer ausgeführt, wenn die Logik läuft.
// Um es bedingt auszuführen, muss die Logik selbst bedingt getriggert werden,
// oder der Input-String für Regex ($I_Http_Json_Response) wird nur
// bei Bedarf mit dem relevanten JSON befüllt.
//
// Alternative für bedingte Ausführung, wenn $P_Execute_Regex_Once einen Impuls liefert:
// Wenn $P_Execute_Regex_Once ein Impuls (nur einen Zyklus TRUE) ist, dann wird Regex nur dann aktiv neue Werte suchen.
// Jedoch wird der Regex-Baustein an sich bei jedem Logikdurchlauf ausgeführt.
// Um den Baustein selbst nur bei Bedarf zu triggern:
// - Möglichkeit 1: Die gesamte Logik nur bei Bedarf triggern (z.B. $I_Http_Json_Response als Input-Typ 'a').
// - Möglichkeit 2 (komplexer): Den $I_Http_Json_Response-String nur dann an eine interne Arbeitsvariable übergeben,
// die vom Regex-Modul gelesen wird, wenn die Bedingung erfüllt ist. Z.B. mit einem Multiplexer, dessen
// Selektor die Bedingung ist (true=JSON-String, false=leerer String). Das Regex-Modul arbeitet dann
// ggf. mit einem leeren String und findet nichts, was weniger Last erzeugt.
//
// Hier die einfache Variante: Regex wird ausgeführt.
[ "Regex",
"$I_Http_Json_Response",
"$Pattern_VentilActivity",
"$Lgc_Regex_HatMatch",
"$Lgc_Regex_FullMatch_Dummy",
"$O_Ventil_Activity_Value", // Gruppe 1
"$Lgc_Regex_Grp2_Dummy",
"$Lgc_Regex_Grp3_Dummy",
"$Lgc_Regex_Grp4_Dummy",
"$Lgc_Regex_Grp5_Dummy"
]

// Wenn $P_Execute_Regex_Once als Impuls verwendet werden soll, um $O_Ventil_Activity_Value
// nur dann zu aktualisieren, wenn der Impuls kommt:
// Hier fehlt dann noch eine Latch-Logik oder ähnliches, um den $O_Ventil_Activity_Value
// zu halten oder nur bei Impuls zu übernehmen.
// Die aktuelle Version aktualisiert $O_Ventil_Activity_Value bei jedem Durchlauf,
// basierend auf dem aktuellen $I_Http_Json_Response.
],

"Input": [
[ "SYSTEM: Logik sperren", "Logik anhalten wenn TRUE", "$VAR<Inhibit?>", "u" ],
// Wenn die Regex-Extraktion bei JEDER Änderung des JSON-Strings erfolgen soll:
[ "HTTP API: JSON Antwort", "Der vollständige JSON-String von der API", "$I_Http_Json_Response", "a" ], // Typ 'a'
// Wenn die Regex-Extraktion nur durch einen separaten Impuls gestartet werden soll,
// dann $I_Http_Json_Response auf "c" und einen separaten Trigger-Input für $P_Execute_Regex_Once.
// [ "HTTP API: JSON Antwort", "Der vollständige JSON-String von der API", "$I_Http_Json_Response", "c" ],
// [ "AKTION: Regex Ausführen Impuls", "Einmaliger Impuls (TRUE) startet Regex", "$P_Execute_Regex_Once", "a" ]
// Für dieses Beispiel nehme ich an, die Regex soll immer auf den aktuellen $I_Http_Json_Response angewendet werden,
// wenn die Logik getriggert wird (hier durch Änderung von $I_Http_Json_Response selbst).
],

"Output": [
[ "SYSTEM: Fehler in Logik?", "Laufzeitfehler in der Logik?", "$Error?", "ce" ],
[ "Extraktion: Ventil Activity", "Extrahierter Wert von attributes.activity.value (z.B. CLOSED)", "$O_Ventil_Activity_Value", "c" ],
[ "Extraktion: Match gefunden?", "Wurde ein Match für den Regex gefunden?", "$Lgc_Regex_HatMatch", "c" ]
]
}

Gute Nacht allerseits!
Stefan

[eib-eg]

Du hast dies gelesen ?@AndererStefan

Wichtig: Die komplexen HTTP-API-Beispiele wurden aus dieser speicherbaren Demo-Datei entfernt, um die Speicherbarkeit nach jüngsten Tests zu gewährleisten. Die Anleitung zur HTTP-API-Anbindung ist vollständig in der Textdatei enthalten.


Aktuell bin ich noch am testen wo es hakt.

Beim usertreffen zeigte Robert Mini eine Seite wo alle Logik Module enthalten sind, nur ich finde diese nicht mehr.

Die Nase des Trüffelschweins ist verstopft )

Tests laufen fast täglich sowie das Forum durchstöbern um die Datei zu verbessern.

Aber zu gewissen Infos hab ich leider keinen Zugang mehr und wird somit für mich immer zäher an neue Informationen zu kommen.

Ich hoffe das ich dir mit dieser Aussage weiterhelfen konnte auch wenn sie nicht positiv ist, sorry.

Wenn du was speicherbares Neues dazu hast dan gib der ai die Vorlage und sag ihr das sie dies mit einpflegen soll.

Dann probiere ob es zu speichern geht.

Wenn ja dann mach doch eine 4.13.1 daraus.

Wenn ich das weis das da noch mehr mitwirken dann werde ich immer bevor ich weitermache ins Forum schauen ob einer eine neue Version rausgebrachte hat.

Es sollte hald die aktuelle 4.12.2 als Grundlage sein für die nächste Erweiterung.

Ich weis wie ich mit sicheren Schritten vorankomme.

[Franky]

Beim usertreffen zeigte Robert Mini eine Seite wo alle Logik Module enthalten sind, nur ich finde diese nicht mehr.

Welche meinst Du
a) Stanndardlogiken, die per GUI im TWS konfiguriert werden oder
b) custom logik-Bausteine?
und wo
1) wiki oder
2) im Timberwolf-Server selbst?

Gruß

Franky

[eib-eg]

Es ist ein Beitrag
Ich weis aber nicht mehr genau von wem
Da waren glaube ich alle zur verfügungstehenden Bausteine enthalten
Dies nimmt Robert Mini immer als Vorlage her
b
3 Forum

[AndererStefan]

Guten Abend,

ich habe das Gefühl da ist insgsamt Syntax aus der Zukunft dabei? Oder hat das LLM die Syntax in das Dokument gepackt und dabei halluziniert?

In Timberwolf_Custom_Logic_Referenz_Anleitung_V4.12.txt steht diese Syntax für printf:

Code: Alles auswählen

["Printf", "$OutputStringVar", "$FormatStringVar", ["$Param1Var", "$Param2Var", ...]]

Im Wiki steht:

Code: Alles auswählen

["Printf","$In","$StringFormat", "$Out"]

Die Variante aus dem Wiki kann ich im Logik Editor speichern, die aus der Referenz nicht.

VG
Stefan

[eib-eg]

vermutlich morgen die nächste version

[eib-eg]

Hallo liebe Timberwolf Community,

wir freuen uns, euch ein weiteres großes Update unserer gemeinschaftlich erarbeiteten Ressourcen für die Timberwolf Server Custom Logic vorstellen zu können! Aufbauend auf der Version 4.15.0 (und früheren Versionen) haben wir durch intensive Tests und die Analyse von Praxisbeispielen (großer Dank an die Beiträge von @Robert_Mini und dem Feedback der Community!) unsere Dokumentationen erneut maßgeblich erweitert und verfeinert.

Das Ergebnis sind zwei aktualisierte Kernressourcen:

Timberwolf_Custom_Logic_Referenz_Anleitung_V4.16.1.txt (Textdatei)

Das umfassende Nachschlagewerk: Enthält detaillierte Erklärungen zu Modulen, bewährte Muster, häufige Fehler und Design Patterns.

Vollständig und aktuell: Dieses Dokument ist in sich abgeschlossen und ersetzt alle vorherigen Versionen der Anleitung.

Neue Erkenntnisse integriert:

Comparator (Tipp 11): Die elegante und validierte Methode zur direkten Negation des Output-Parameters (-$OutputVar) für <= und >= Vergleiche (mit der 4-Parameter-Variante A) ist jetzt detailliert beschrieben.

Cron (Tipp 27): Die praxiserprobte 4-Parameter-Syntax (Enable, Output, 0, CronString) ist als funktionierend dokumentiert.

Polynomial (Tipp 28): Die Anwendung für Summen-/Differenzbildung (X=1.0, Koeffizienten als Werte, Subtrahenden via -X1 CalcFormula negiert) ist validiert und erklärt.

SendExplicit (Tipp 32): Syntax, Zweck und die Notwendigkeit der "x"-Output-Option sind nun Teil der Referenz.

Selbst-resettender Ein-Zyklus-Impuls (Tipp 33): Ein robustes Pattern zur Erzeugung eines nur einen Zyklus langen Signals (basierend auf Multiplexer-Logik) wurde validiert und ist detailliert beschrieben.

Optimierte AI-Meta-Regeln: Für alle, die KI-Assistenten zur Code-Generierung nutzen.

Timberwolf_Custom_Logic_Syntax_Demo_V4.16.1.txt (Speicherbare TWS Logikdatei )

Der Goldstandard für speicherbare Syntax: Enthält minimalistische, aber im Timberwolf Server erfolgreich gespeicherte und funktional validierte Beispiele.

Alle neuen Konzepte als Demo:

Comparator-Beispiele mit direkter Output-Negation.

Cron-Demo mit 4-Parameter-Syntax und Impulsfang.

Polynomial-Demo für Summen/Differenzen.

Selbst-resettender Ein-Zyklus-Impuls-Demo mit Zähler zum Funktionsnachweis.

SendExplicit-Demo mit interner Testlogik zur (versuchten) Beobachtung des bedingten Sendens.

Automatisierte Testbeispiele: Viele der neuen Demos enthalten interne Clocksignal-Logiken, um die Funktionen automatisch durch verschiedene Zustände laufen zu lassen, was das Beobachten und Validieren erleichtert.

Beinhaltet weiterhin alle validierten Beispiele aus V4.15.0 (CalcFormula mit XN & Ternary, Latch, Monoflop, Logikgatter, Stringcompare, Limiter, bedingte Logik mit Latch/Multiplexer/Limiter-Kaskade etc.).

Warum diese Updates?
Unser Ziel ist es, eine möglichst präzise, verlässliche und umfassende Wissensbasis für die Timberwolf Custom Logic zu schaffen. Die enge Verzahnung von detaillierter textueller Erklärung (Referenz-Anleitung) und praktisch funktionierenden, speicherbaren Code-Beispielen (Syntax-Demo) soll euch helfen, Fehler zu vermeiden und eure Projekte effizienter umzusetzen.

Wo finde ich die Dateien?

Timberwolf Custom Logic - Referenz-Anleitung (V4.16.1).txt

Timberwolf Custom Logic - Syntax Demo (V4.16.1).txt

sowie der link

https://aistudio.google.com/prompts/new_chat

Wir brauchen euer Feedback!
Diese Dokumente leben und wachsen durch die Community:

Testet die Syntax-Demo V4.16.1 in euren Timberwolf Servern!

Gebt uns Rückmeldung zur Verständlichkeit der Referenz-Anleitung V4.16.1.

Teilt uns eure Erfahrungen, Korrekturen oder weitere "Aha!"-Momente mit!

Ein riesiges Dankeschön an alle, die aktiv im Forum mitdiskutieren, testen und ihr Wissen teilen. Nur so können wir diese wertvolle Ressource gemeinsam weiterentwickeln.

Viele Grüße,

eib-eg / Georg E.
(unterstützt durch eine lernfähige AI)