dl-breadcrumbs__homedl-breadcrumb-item__separatorKonfiguration und Programmierungdl-breadcrumb-item__separatorProgrammieren mit CODESYSdl-breadcrumb-item__separator...dl-breadcrumb-item__separatorCODESYS Development Systemdl-breadcrumb-item__separatorArbeiten mit Steuerungsnetzwerkendl-breadcrumb-item__separatorSymbolkonfiguration
dl-pagination__prev-inactivedl-pagination__prev-activedl-pagination__next-inactivedl-pagination__next-active
Symbolkonfigurationdl-permalink__symbolPermanentlink

Verwenden Sie die Symbolkonfiguration, um für Projektvariablen Symbole mit bestimmten Zugriffsrechten bereitzustellen. Über diese Symbole können Sie von extern auf die Variablen zugreifen, beispielsweise von einem OPC-Server aus. CODESYS erzeugt bei der Codegenerierung eine Symboldatei (xml-Datei), die die Beschreibung der Symbole enthält.

Die Symboldatei wird im Projektverzeichnis gespeichert. Der Name der Symboldatei setzt sich wie folgt zusammen: ‎<project name>.<device name>.<application name>.xml‎

Beispiel

‎proj_xy.PLC1.application.xml‎

Sie können die Symboldatei auch durch den Befehl „Code erzeugen“ erzeugen. Dies ist sehr hilfreich, wenn ein Download auf die SPS nicht möglich ist.

Die Variablen, die Sie als Symbole exportieren, können Sie entweder im Symbolkonfigurationseditor zusammenstellen, oder in der Variablendeklaration über das Pragmaattribut ‎{attribute 'symbol'}‎ definieren. Eine weitere Möglichkeit bietet der AS-Editor: Hier können Sie im Eigenschafteneditor eines Elements die implizit erzeugten Elementvariablen bestimmen, die in die Symbolkonfiguration exportiert werden.

Der Name eines Symbols wird in der Symbolkonfiguration gemäß folgender Syntax erzeugt: ‎<Applikationsname>.<POU-Name>.<Variablenname>‎. Beim Zugriff auf die Variable müssen Sie den Symbolnamen immer vollständig in dieser Syntax angeben.

Beispiel

‎MyApplication.PLC_PRG.a‎ oder ‎MyApplication.SymFB.a‎

Auf Symbole für Eingangsadressen beziehungsweise für Variablen, die auf Eingangskanäle abgebildet sind, kann grundsätzlich nur lesend zugegriffen werden. Nur im Simulationsbetrieb ist zu Testzwecken auch schreibender Zugriff möglich.

Die Symboldatei wird zusammen mit der Applikation auf die Steuerung geladen. Abhängig von der Gerätebeschreibung kann diese Datei als eine  zusätzliche (Kind)applikation erzeugt werden. Diese Applikation ist dann im Geräteeditor in der Registerkarte „Applikation“ aufgeführt. Syntax: ‎<application name>._Symbols‎. Die Symbolapplikation wird hinsichtlich der maximalen Anzahl an Applikationen auf einer Steuerung als  "normale" Applikation betrachtet.

Wenn die Steuerung eine Benutzerverwaltung hat, können Sie den einzelnen Benutzergruppen (Clients) ein unterschiedliches Zugriffsrecht auf ein Symbol geben. Dazu legen Sie dasselbe Symbol in verschiedene Symbolgruppen und gestatten den einzelnen Benutzergruppen (Clients) entweder den Zugriff auf eine Symbolgruppe oder nicht. So erhält beispielsweise ein Vorortbediener oder eine Betriebsdatenaufzeichnung mehr Information und Zugang zu denselben Symbolen wie eine Fernwartung.

Anlegen einer Symbolkonfiguration

Voraussetzung: Das Projekt kann fehlerfrei übersetzt werden

  1. Selektieren Sie im Gerätebaum das Objekt „Applikation“.

  2. Wählen Sie den Befehl „Projekt  Objekt hinzufügen  Symbolkonfiguration“.

    Das Objekt „Symbolkonfiguration“ wurde zum Gerätebaum hinzugefügt und der Editor des Objekts ist geöffnet.

  3. Öffnen Sie das Menü „Ansicht“ des Editors und aktivieren Sie die Kategorien von Variablen, die Sie im Konfigurationseditor angeboten haben möchten: Wählen Sie dann den Befehl „Erstellen“ im Symbolkonfigurationseditor.

    Alle Variablen gemäß der aktuell eingestellten Filter im Menü „Ansicht“ werden in einer Baumstruktur angezeigt.

  4. Wählen Sie einzelne Variablen durch Aktivieren der zugehörigen Checkbox aus.

    Hinweis: Beachten Sie die aktuellen Einstellungen; siehe Schaltfläche „Einstellungen“ in der Menüleiste des Editors.

    Im Feld unterhalb der Menüleiste des Editors erhalten Sie Informationen zur aktuellen Situation und eine passende Anleitung sowie Schaltflächen zur Durchführung von Korrekturen.

  5. Folgen Sie der Aufforderung im Feld unterhalb der Menüleiste. Im vorliegenden Fall sollte dies nur die Information sein, dass die geänderte Symbolkonfiguration mit dem nächsten Download oder Online-Change übertragen wird.

    Wählen Sie im CODESYS-Hauptmenü den Befehl „Erstellen  Code erzeugen“.

    Die Datei ‎<project name>.<device name>.<application name>.xml‎ wird im Projektverzeichnis erzeugt.

Beim Download der Applikation oder beim Online-Change überträgt CODESYS die Symbolkonfiguration auf die Steuerung.

Anlegen von Symbolgruppen mit unterschiedlichen Zugriffsrechten für verschiedene Steuerungsclients

Eine Symbolgruppe ist ein definierter Satz von Symbolen. Wenn es vom Zielgerät unterstützt wird, können Sie im Symbolkonfigurationseditor aus den Symbolen der Applikation verschiedene Symbolgruppen zusammenstellen. Die Information über die Symbolgruppen wird mit einem Download auf die Steuerung übertragen. Dann können Sie dort für jede Symbolgruppe festlegen, welche Benutzergruppe Zugriff darauf erhält. Diese Rechtevergabe erfolgt im Geräteeditor auf der Registerkarte „Symbolrechte“.

Symbolgruppen ermöglichen somit clientspezifisch unterschiedliches Zugriffsrecht auf ein Symbol in der Steuerung.

Änderungen an einer Symbolgruppendefinition können Sie über Online-Change auf die Steuerung übertragen. Beim Löschen der Applikation auf der Steuerung werden die Symbolgruppen mit gelöscht. Beim Übersetzen der Applikation können Sie pro Symbolgruppe eine Symboldatei im xml-Format erzeugen und ablegen.

Im Folgenden sehen Sie an einem Beispiel die Schritte zum Anlegen von Symbolgruppen und der Rechtevergabe auf der Steuerung:

Voraussetzungen: Die Applikation hat eine definierte Symbolkonfiguration im Projekt. In den Einstellungen der Symbolkonfiguration ist die Option „Symbolgruppen aktivieren“ aktiviert. Die Steuerung hat eine Benutzerverwaltung. Für das Beispiel hier sollte es eine Benutzergruppe geben, die die nötigen Rechte für das Warten der Anlage hat. Standardmäßig ist eine solche Benutzergruppe mit Namen "Service" bereits angelegt.

  1. Definieren Sie in den „Kommunikationseinstellungen“ des Geräteeditors die Verbindung zur Steuerung.

  2. Klicken Sie im Editor der „Symbolkonfiguration“ auf die Schaltfläche _cds_icon_add_symbol_group, um eine neue Symbolgruppe anzulegen. Geben Sie im Dialog „Hinzufügen einer neuen Symbolgruppe“ einen Namen für die Gruppe ein: "startup".

  3. Klicken Sie in der Werkzeugleiste des Dialogs auf die Schaltfläche _cds_icon_symbolconfiguration_build („Erstellen“), um alle im Projekt verfügbaren Symbole angezeigt zu bekommen. Wählen Sie diejenigen aus, die der Gruppe angehören sollen. Speichern Sie das Projekt.

  4. Klicken Sie auf die Schaltfläche „Symbolgruppenrechte konfigurieren“.

    Die Registerkarte „Symbolrechte“ des Geräteditors öffnet sich.

  5. Klicken Sie auf die Schaltfläche _cds_icon_synchronization („Synchronisierung“) um die Darstellung der Symbolgruppen mit dem Gerät zu synchronisieren.

    Wenn Sie zuvor die Benutzerverwaltung auf der Steuerung noch nicht aktiviert hatten, erhalten Sie nun eine Dialogbox mit der Aufforderung, dies auf der Registerkarte „Benutzer und Gruppen“ zu tun.

  6. Bestätigen Sie die Dialogbox mit „OK“ und wechseln Sie zur Registerkarte „Benutzer und Gruppen“.

    Klicken Sie auf die Schaltfläche _cds_icon_synchronization („Synchronisierung“). Bestätigen Sie die Anfrage, ob die Benutzerverwaltung aktiviert werden soll, mit „Ja“.

    Der Dialog „Gerätebenutzeranmeldung“ öffnet sich.

  7. Melden Sie sich an. Im Fall der Erstanmeldung verwenden Sie Benutzernamen und Passwort "Administrator" und vergeben im darauffolgenden Dialog ein neues Passwort.

    Nach Schließen des Dialogs erscheinen nun auf den Registerkarten „Benutzer und Gruppen“ sowie „Zugriffsrechte“ die Konfigurationen der Gerätebenutzerverwaltung.

  8. Loggen Sie mit Befehl „Online  Einloggen“ auf der Steuerung ein. Bestätigen Sie dabei die Abfrage, ob die Applikation auf das Gerät geladen werden soll, mit „Ja“.

  9. Nach erfolgreichem Einloggen wechseln Sie auf die Registerkarte „Symbolrechte“. Klicken Sie auf die Schaltfläche „Synchronisierung“.

    Unter „Symbolgruppen“ sehen Sie alle Gruppen, die aktuell für die Applikation geladen wurden, für dieses Beispiel hier also mindestens "startup". Unter „Rechte“ sehen Sie in einer Tabelle die Benutzergruppen, die in der Benutzerverwaltung der Steuerung angelegt sind. Wir gehen für das Beispiel davon aus, dass die Standardgruppen „Administrator“ und „Service“ angelegt sind. Wenn links eine Symbolgruppe selektiert ist, sehen Sie rechts jeweils das Zugriffsrecht der einzelnen Benutzergruppen auf diese Symbolgruppe: _cds_icon_right_granted: Zugriff erlaubt, _cds_icon_right_denied: Zugriff nicht erlaubt. Die mögliche Art des Zugriffs ist pro Symbol bereits in der Symbolkonfiguration festgelegt (Lesen, Schreiben, Ausführen).

  10. Selektieren Sie links die Symbolgruppe „Startup“ und doppelklicken Sie auf das voreingestellte Minussymbol bei Administrator, ebenso bei Service.

    Das Symbol verwandelt sich jeweils in ein Plussymbol. Die Gruppen "Administrator" und "Service" haben nun Zugriff auf die Symbole der Symbolgruppe „Startup“.