{"type":"doc","content":[{"type":"paragraph","content":[{"text":"In diesem Kapitel wird anhand eines Beispiels kurz ein Überblick über Aufbau, Funktion und Visualisierung gegeben. Auf den folgenden Kapiteln wird auf die weiteren Details eingegangen:","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"children","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"e0c584a7858dfcd9880d2610f8b938bc"},"schemaVersion":{"value":"2"},"title":"Untergeordnete Seiten (Anzeige untergeordneter Seiten)"}},"localId":"cee65ce0-24ec-45c1-b9ef-cbbffa363c30"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Kurzleitfaden","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Aufgabenstellung","type":"text"}]},{"type":"paragraph","content":[{"text":"Folgende Schaltung soll mittels Custom Logik abgebildet werden:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In, dt_ON und dT_OFF sind Eingangsvariablen (mit einem Eingang verbunden)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Limit_ON, Delayed_ON und Extend_ON sind interne Variablen","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Out ist die Ausgangsvariable (mit dem Ausgang verbunden)","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":748,"id":"5ae85338-8eac-45d5-b103-df5cb6ac8397","collection":"contentId-1943633921","type":"file","height":242}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Custom Logikzelle anlegen und editieren","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Zum erstmaligen Anlegen einer Custom Logik wählt man \"Add Logic\" im Logik Manager.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"Benutzerdefiniert Logik\" anklicken und im Texteditor den Code eintragen/einfügen und mit OK abschließen. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Um diesen nachträglich anzupassen oder zu ändern, muss die Logikzelle zunächst aufgeklappt werden und anschließend klickt man neben dem Zellennamen auf editieren.","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"Level\":[\n [\"$In\",\"bool\",false],\n [\"$dT_ON\",\"float\",0],\n [\"$dT_OFF\",\"float\",0],\n [\"$Out\",\"bool\",false],\n [\"$Limit_ON\",\"bool\",false],\n [\"$Delayed_ON\",\"bool\",false],\n [\"$Extend_ON\",\"bool\",false],\n [\"$VAR\",\"bool\",false]\n ],\n \"Module\":[\n [\"Break\",[\"$VAR\"]],\n [\"Monoflop\",\"$In\",\"-$In\",\"$Limit_ON\",\"$dT_ON\",2],\n [\"And\",[\"$In\",\"-$Limit_ON\"],\"$Delayed_ON\"],\n [\"Monoflop\",\"$Delayed_ON\",\"$Delayed_ON\",\"$Extend_ON\",\"$dT_OFF\",4],\n [\"Or\",[\"$Delayed_ON\",\"$Extend_ON\"],\"$Out\"]\n ],\n \"Input\":[\n [\"In\",\"Eingang\",\"$In\",\"c\"],\n [\"dT_Ein\",\"Einschaltverzögerung[s]\",\"$dT_ON\",\"c\"],\n [\"dT_Aus\",\"Ausschaltverzögerung[s]\",\"$dT_OFF\",\"c\"],\n [\"Inhibit\",\"INHIBIT\",\"$VAR\",\"u\"]\n ],\n \"Output\":[\n [\"Out\",\"Ausgang\",\"$Out\",\"c\"]\n ]\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Logik-Zelle mit Objekten verknüpfen:","type":"text"}]},{"type":"paragraph","content":[{"text":"Damit erhält man folgende Logikzelle, deren Ein- und Ausgänge noch mit Objekten verbunden werden müssen:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1316,"id":"865b90c3-a128-4ce9-8e5b-21121728731f","collection":"contentId-1943633921","type":"file","height":590}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Erklärungen zur Custom Logik:","type":"text"}]},{"type":"paragraph","content":[{"text":"Das Grundgerüst jeder Logik-Definition sind die Abschnitte Level, Module, Input und Output mit jeweils einem Array als Wert: { \"Level\": [] , \"Module\": [], \"Input\": [], \"Output\": [] }","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Level-Array:","type":"text"}]},{"type":"paragraph","content":[{"text":"Der Level-Abschnitt ist die Deklaration von Variablen, über die Informationen zwischen Modulen, In- und Outputs ausgetauscht werden können.","type":"text"}]},{"type":"paragraph","content":[{"text":"Es gilt folgende Syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"Level\": [ [, , ], ... ]","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Der Variablenname ist ein String, beginnend mit einem \"$\". Darauf kann man sich später in Module, Input und Output beziehen.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mögliche ","type":"text"},{"text":"Typen","type":"text","marks":[{"type":"underline"},{"type":"em"}]},{"text":": \"bool\", \"float\", \"integer\" oder \"string\". Mit dem ","type":"text"},{"text":"Init value","type":"text","marks":[{"type":"underline"},{"type":"em"}]},{"text":" kann für die Variable ein Default-Wert gesetzt werden, der bis zum ersten Beschreiben der Variable gültig ist. Der Wert muss dabei zum passen!","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Modul-Array:","type":"text"}]},{"type":"paragraph","content":[{"text":"Im Modul-Abschnitt werden die Variablen mit den Ein-und Ausgängen der Logik-Modulbausteine verknüpft.","type":"text"}]},{"type":"paragraph","content":[{"text":"Es gilt folgende Syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"Modul\": [ [, ], ... ]","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Die Basis-Module sind vorgegebene (kompilierte) Funktionen . Die Auswähl hängt von der Software Version des TWS ab. Die genaue Beschreibung jedes einzelnen Basis-Moduls und dessen Parameter erfolgen im Abschnitt ","type":"text"},{"text":"Modulbausteine für Custom Logiken","type":"text","marks":[{"type":"link","attrs":{"href":"https://elabnet.atlassian.net/l/cp/DsqtiKGD"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Variablen können vorangestellten Minus bei der Übergabe in ein Modul direkt ","type":"text"},{"text":"invertiert","type":"text","marks":[{"type":"underline"}]},{"text":" werden. Beim Typ boolean verhält sich das Minuszeichen wie ein NOT, und bei float und integer wie ein *(-1).","type":"text"},{"type":"hardBreak"},{"text":"Achtung:","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"da127dcd-28d7-4d29-9951-1fbe695f2a5c"}},{"type":"underline"},{"type":"em"}]},{"text":" Diese Syntax ist nur bei den Referenzen im \"Modul\"-Block erlaubt (nicht bei \"Input\" oder \"Output)!","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"da127dcd-28d7-4d29-9951-1fbe695f2a5c"}}]},{"type":"hardBreak"}]}]}]},{"type":"codeBlock","content":[{"text":" \"Module\":[ \n [\"And\",[\"$In\",\"-$Limit_ON\"],\"$Delayed_ON\"], \n ],","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Hinweis: ","type":"text","marks":[{"type":"underline"}]},{"text":"In den Funktionen sind aktuell nur Variablen, die im Abschnitt Level definiert wurden erlaubt. Es können ","type":"text"},{"text":"keine Parameter als Zahl","type":"text","marks":[{"type":"underline"}]},{"text":" eingeben werden! ","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Input-Array:","type":"text"}]},{"type":"paragraph","content":[{"text":"Im Abschnitt Input werden die Variablen mit den Eingängen der Custom-Logikzelle verknüpft.","type":"text"}]},{"type":"paragraph","content":[{"text":"Es gilt folgende Syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"Input\": [ [, , , ], ... ]","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Der Name ist ein String, mit dem der Eingang in der GUI angezeigt wird. Die Beschreibung wird bei \"Mouse over\" angezeigt.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Der Variablenname bestimmt, welche Variable mit den Eingang verknüpft ist.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Die ","type":"text"},{"text":"Trigger-Optionen","type":"text","marks":[{"type":"link","attrs":{"href":"https://elabnet.atlassian.net/l/cp/qu7mYrZP"}}]},{"text":" bestimmen analog den Standardlogiken, wann ein Signal am Eingang die Berechnung der Logikzelle anstößt. Mögliche Optionen:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"a\": jedesmal (","type":"text"},{"text":"a","type":"text","marks":[{"type":"underline"}]},{"text":"lways)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"c\": nur bei Wertänderung (on ","type":"text"},{"text":"c","type":"text","marks":[{"type":"underline"}]},{"text":"hange)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"u\": kein Trigger, nur Wertübernahme (","type":"text"},{"text":"u","type":"text","marks":[{"type":"underline"}]},{"text":"pdate only)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"ai\": jedesmal (","type":"text"},{"text":"a","type":"text","marks":[{"type":"underline"}]},{"text":"lways), Logik bis zur ersten Wertaktualisierung gesperrt ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"ci\": nur bei Wertänderung (on ","type":"text"},{"text":"c","type":"text","marks":[{"type":"underline"}]},{"text":"hange), Logik bis zur ersten Wertaktualisierung gesperrt ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"ui\": kein Trigger, nur Wertübernahme (","type":"text"},{"text":"u","type":"text","marks":[{"type":"underline"}]},{"text":"pdate only), Logik bis zur ersten Wertaktualisierung gesperrt ","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Output-Array:","type":"text"}]},{"type":"paragraph","content":[{"text":"Im Abschnitt Output werden die Variablen mit den Ausgängen der Custom-Logikzelle verknüft.","type":"text"}]},{"type":"paragraph","content":[{"text":"Es gilt folgende Syntax:","type":"text","marks":[{"type":"underline"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"Output\": [ [, , , ], ... ]","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Der Name ist ein String, mit dem der Ausgang in der GUI angzeigt wird. Die Beschreibung wird bei \"Mouse over\" angezeigt. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Der Variablenname bestimmt, welcher Variable mit den Ausgang verknüpft ist. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Die Sende-Optionen bestimmen analog den Standardlogiken, wann ein Wert am Ausgang gesendet wird. Mögliche Optionen:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"a\": jedesmal (","type":"text"},{"text":"a","type":"text","marks":[{"type":"underline"}]},{"text":"lways)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"c\": nur bei Wertänderung (on ","type":"text"},{"text":"c","type":"text","marks":[{"type":"underline"}]},{"text":"hange)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"t\": wenn ein Timer abgelaufen ist (on ","type":"text"},{"text":"t","type":"text","marks":[{"type":"underline"}]},{"text":"imer)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"“ct”: timer abgelaufen oder Wert geändert","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"“x”: send explict (innerhalb der Logik festgelegtes Sendeverhalten)","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Visualisierung der Variablen in Grafana (DokMode) - Fehlersuche","type":"text"}]},{"type":"paragraph","content":[{"text":"Für den Funktionstest und Fehlersuche von Custom Logiken ist der Doktormodus unerlässlich. Durch klick auf das Grafana-Symbol (rechts unten, oberhalb des Speichern Buttons) können alle Variablen im zeitlichen Verlauf angezeigt werden. Dies ist insbesondere für interne Variablen, Timer etc. hilfreich. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1282,"id":"4238fbea-cd01-41fa-a2d9-c26dadf58c65","collection":"contentId-1943633921","type":"file","height":823}}]},{"type":"paragraph"}],"version":1}