Zum Inhalt

Programm-Editor: Überblick und erster Programmablauf

Mit dem Programm-Editor baust du die Logik des Wetterrelais grafisch auf. Ein Programm besteht aus Funktionsbausteinen, deren Ein- und Ausgänge miteinander verbunden werden. Datenquellen liefern Wetter-, Zeit-, Modbus- oder Gerätewerte. Nachfolgende Bausteine prüfen diese Werte, rechnen sie um oder verknüpfen sie logisch. Am Ende schaltet das Programm beispielsweise das Relais, stellt Werte unter Relais Ausgang und im Dashboard bereit oder übergibt Signale an Modbus beziehungsweise ein Shelly-Gerät.

Du öffnest den Editor unter Relais Ausgang mit der Schaltfläche Program Editor beim gewünschten Relais.

Programm Beschattung Terrasse im Wetterrelais Programmeditor mit verbundenen Funktionsbausteinen

Das Beispielprogramm im Bild fährt eine Markise aus, wenn es heute über 24 °C warm wird, die Sonne scheint und keine Sturmwarnung ansteht. Es ist in den Beispielprogrammen Schritt für Schritt erklärt.

Grundprinzip

Ein Programm wird üblicherweise von links nach rechts gelesen:

  1. Quelle auswählen – beispielsweise Wetterdaten, Zeitschaltuhr, Modbus Output oder Eingabekonstante.
  2. Daten verarbeiten – beispielsweise mit Statistik, Skalierung, Arithmetik oder Prüfen.
  3. Bedingungen verknüpfen – beispielsweise mit UND oder Invertierer.
  4. Ergebnis verwenden – beispielsweise am Ausgang des Relais, an einer Ausgabevariable, einem Modbus Input oder einem Shelly Aktor.
  5. Programm prüfen und übertragen – erst mit Übertragen wird das Programm auf dem Wetterrelais gespeichert und ausgeführt.

Signalrichtung beachten

Eine Verbindung läuft immer vom Ausgang eines Bausteins (rechte Seite) zum Eingang eines anderen Bausteins (linke Seite). Ein Ausgang kann dabei mehrere nachfolgende Bausteine versorgen. Welche Anschlüsse miteinander verbunden werden dürfen, bestimmt die Verknüpfungsart Logik, Wert oder Daten.

Ein erstes einfaches Programm

Ein typisches Beispiel ist eine wetterabhängige Schaltung:

Wetterdaten (Temperatur, heute)
        │ Daten
        ▼
      Prüfen (einmalig größer 30)
        │ Logik
        ▼
     Ausgang

So baust du es auf:

  1. In der Toolbox unter Wetter-Daten und Ereignisse auf Wetterdaten klicken. In den Eigenschaften Art auf Temperatur und Zeitraum auf heute stellen.
  2. Unter Datenoperationen auf Prüfen klicken. Datenwerte auf einmalig, den Vergleich auf größer und den Vergleichswert auf 30 stellen.
  3. Den Ausgang Daten der Wetterdaten mit dem Eingang von Prüfen verbinden.
  4. Den Ausgang Logik von Prüfen mit dem Eingang des Ausgangs verbinden.
  5. Übertragen wählen.

Der Wetterdatenbaustein liefert die Temperaturprognose für heute als Datenreihe. Prüfen bewertet diese Daten anhand der eingestellten Bedingung und erzeugt daraus ein Logiksignal, das das Relais schaltet.

Die drei Verknüpfungsarten

Der Editor unterscheidet drei Informationsarten:

Typ Bedeutung Beispiele Farbe
Logik ein binärer Zustand TRUE/FALSE, EIN/AUS, Bedingung erfüllt grün
Wert ein einzelner numerischer Wert 21.5, 1200, -3 grau
Daten eine Reihe zusammengehöriger Werte stündliche Wetterwerte, Messwertfolgen blau

Die Typen verhindern, dass fachlich nicht passende Bausteine miteinander verbunden werden. Eine ausführliche Beschreibung mit allen erlaubten Kombinationen findest du unter Verknüpfungsarten.

Bausteine und Textfelder einfügen

In der Toolbox befinden sich alle verfügbaren Funktionsbausteine. Ein Baustein kann entweder angeklickt oder per Drag & Drop auf das Programmfeld gezogen werden. Neu eingefügte Bausteine werden fortlaufend benannt, beispielsweise Prüfen 1, Prüfen 2 oder Code 1.

Zusätzlich kann ein Textfeld eingefügt werden. Textfelder haben keine Anschlüsse und beeinflussen die Programmausführung nicht. Sie dienen ausschließlich dazu, Abschnitte, Hinweise oder Funktionsgruppen im Programm zu dokumentieren.

Eigenschaften bearbeiten

Wird ein Baustein ausgewählt, zeigt der Editor rechts dessen Eigenschaften an. Dort lassen sich je nach Baustein beispielsweise Zeitraum, Grenzwert, Rechenart, Adresse oder Verzögerungszeit ändern. Auch der sichtbare Titel eines Bausteins kann angepasst werden.

Der Editor prüft jede Eingabe sofort. Liegt ein Wert außerhalb des erlaubten Bereichs, markiert er das Feld und den Baustein rot – siehe Ungültige Parameterwerte.

Änderungen an Eigenschaften werden im Editor unmittelbar übernommen. Auf dem Gerät werden sie jedoch erst wirksam, wenn das Programm übertragen wurde.

Entwurf und aktives Programm

Der Editor unterscheidet zwei wichtige Aktionen:

  • Übertragen prüft das Programm, speichert es auf dem Gerät und startet es.
  • Als Entwurf speichern speichert den aktuellen Bearbeitungsstand auf dem Gerät, führt ihn aber nicht aus. Ein bis dahin laufendes Programm wird dabei angehalten, der Programmzustand steht auf STOP.

Ein Entwurf darf deshalb auch noch offene oder fehlerhafte Verbindungen enthalten. Das aktive Programm muss dagegen vollständig und gültig sein. Details stehen unter Speichern, Entwurf, Import und Export.

Gute Vorgehensweise bei größeren Programmen

Bei umfangreicheren Programmen empfiehlt sich eine klare Struktur:

  • Signalfluss möglichst von links nach rechts aufbauen – Automatisch anordnen hilft dabei.
  • Quellen, Verarbeitung und Ausgänge räumlich gruppieren.
  • Eigene, sprechende Bausteintitel vergeben.
  • Textfelder als Überschriften oder Erklärungen einsetzen.
  • Teilfunktionen zuerst aufbauen und anschließend verbinden.
  • Wichtige Zwischenergebnisse auf Ausgabevariablen führen.
  • Vor größeren Änderungen das Programm als .wpgm exportieren.
  • Fertige Programme für die Anlagendokumentation drucken.

Weiterführende Kapitel

Für die tägliche Arbeit sind besonders diese Kapitel relevant: