Anwendungshinweis CODESYS V3.

Gebäude

Automation

WAGO I/O SYSTEM 750

Modulbibliotheken unter einer CODESYS-V3.x-
Soft-SPS
Version 1.0.1
2 Anwendungshinweis CODESYS V3.x – Modulbibliotheken unter einer CODESYS-V3.x-Soft-SPS
WAGO I/O SYSTEM 750

© 2020 by WAGO Kontakttechnik GmbH & Co. KG

Alle Rechte vorbehalten.

WAGO Kontakttechnik GmbH & Co. KG

Hansastraße 27
D-32423 Minden

Tel.: +49 (0) 571/8 87 – 0

Fax: +49 (0) 571/8 87 – 844 1 69

E-Mail: info@wago.com

Web: http://www.wago.com

Technischer Support

Tel.: +49 (0) 571/8 87 – 4 45 55

Fax: +49 (0) 571/8 87 – 84 45 55

E-Mail: support@wago.com

Es wurden alle erdenklichen Maßnahmen getroffen, um die Richtigkeit und

Vollständigkeit der vorliegenden Dokumentation zu gewährleisten. Da sich
Fehler, trotz aller Sorgfalt, nie vollständig vermeiden lassen, sind wir für
Hinweise und Anregungen jederzeit dankbar.

Wir weisen darauf hin, dass die in diesem Dokument verwendeten Soft- und
Hardwarebezeichnungen und Markennamen der jeweiligen Firmen im
Allgemeinen einem Warenzeichenschutz, Markenzeichenschutz oder
patentrechtlichem Schutz unterliegen.

Version 1.0.1
Anwendungshinweis CODESYS V3.x – Modulbibliotheken unter einer CODESYS-V3.x-Soft-SPS 3
WAGO I/O SYSTEM 750 Beschreibung

Hinweise zu dieser Dokumentation

Urheberschutz
Diese Dokumentation, einschließlich aller darin befindlichen Abbildungen, ist
urheberrechtlich geschützt. Jede Weiterverwendung dieser Dokumentation, die
von den urheberrechtlichen Bestimmungen abweicht, ist nicht gestattet. Die
Reproduktion, Übersetzung in andere Sprachen sowie die elektronische und
fototechnische Archivierung und Veränderung bedarf der schriftlichen
Genehmigung der WAGO Kontakttechnik GmbH & Co. KG, Minden.
Zuwiderhandlungen ziehen einen Schadenersatzanspruch nach sich.
WAGO ist eine eingetragene Marke der WAGO Verwaltungsgesellschaft mbH.

Darstellung der Zahlensysteme

Tabelle 1: Darstellungen der Zahlensysteme
Zahlensystem Beispiel Bemerkung
Dezimal 100 Normale Schreibweise
Hexadezimal 0x64 C-Notation
Binär '100' In Hochkomma,
'0110.0100' Nibble durch Punkt getrennt

Schriftkonventionen
Tabelle 2: Schriftkonventionen
Schriftart Bedeutung
kursiv Namen von Pfaden und Dateien werden kursiv dargestellt z. B.:
C:\Programme\WAGO-I/O-CHECK
Menü Menüpunkte werden fett dargestellt z. B.:
Speichern
> Ein „Größer als“- Zeichen zwischen zwei Namen bedeutet die
Auswahl eines Menüpunktes aus einem Menü z. B.:
Datei > Neu
Eingabe Bezeichnungen von Eingabe- oder Auswahlfeldern werden fett
dargestellt z. B.:
Messbereichsanfang
„Wert“ Eingabe- oder Auswahlwerte werden in Anführungszeichen
dargestellt z. B.:
Geben Sie unter Messbereichsanfang den Wert „4 mA“ ein.
[Button] Schaltflächenbeschriftungen in Dialogen werden fett dargestellt und
in eckige Klammern eingefasst z. B.:
[Eingabe]
[Taste] Tastenbeschriftungen auf der Tastatur werden fett dargestellt und in
eckige Klammern eingefasst z. B.:
[F5]

Version 1.0.1
Symbole

GEFAHR Warnung vor Personenschäden!

Kennzeichnet eine unmittelbare Gefährdung mit hohem Risiko, die Tod
oder schwere Körperverletzung zur Folge haben wird, wenn sie nicht
vermieden wird.

GEFAHR Warnung vor Personenschäden durch elektrischen Strom!

Kennzeichnet eine unmittelbare Gefährdung mit hohem Risiko, die Tod
oder schwere Körperverletzung zur Folge haben wird, wenn sie nicht
vermieden wird.

WARNUNG Warnung vor Personenschäden!

Kennzeichnet eine mögliche Gefährdung mit mittlerem Risiko, die Tod oder
(schwere) Körperverletzung zur Folge haben kann, wenn sie nicht
vermieden wird.

VORSICHT Warnung vor Personenschäden!

Kennzeichnet eine mögliche Gefährdung mit geringem Risiko, die leichte
oder mittlere Körperverletzung zur Folge haben könnte, wenn sie nicht
vermieden wird.

ACHTUNG Warnung vor Sachschäden!

Kennzeichnet eine mögliche Gefährdung, die Sachschaden zur Folge haben
könnte, wenn sie nicht vermieden wird.

ESD Warnung vor Sachschäden durch elektrostatische Aufladung!

Kennzeichnet eine mögliche Gefährdung, die Sachschaden zur Folge haben
könnte, wenn sie nicht vermieden wird.

Hinweis Wichtiger Hinweis!

Kennzeichnet eine mögliche Fehlfunktion, die aber keinen Sachschaden zur
Folge hat, wenn sie nicht vermieden wird.

Information Weitere Information

Weist auf weitere Informationen hin, die kein wesentlicher Bestandteil
dieser Dokumentation sind (z. B. Internet).
Anwendungshinweis CODESYS V3.x – Modulbibliotheken unter einer CODESYS-V3.x-Soft-SPS 5
WAGO I/O SYSTEM 750 Beschreibung

Rechtliche Grundlagen

Änderungsvorbehalt
Die WAGO Kontakttechnik GmbH & Co. KG behält sich Änderungen, die dem
technischen Fortschritt dienen, vor. Alle Rechte für den Fall der Patenterteilung
oder des Gebrauchmusterschutzes sind der WAGO Kontakttechnik GmbH & Co.
KG vorbehalten. Fremdprodukte werden stets ohne Vermerk auf Patentrechte
genannt. Die Existenz solcher Rechte ist daher nicht auszuschließen.

Personalqualifikation
Der in diesem Dokument beschriebene Produktgebrauch richtet sich
ausschließlich an Fachkräfte mit einer Ausbildung in der SPS-Programmierung,
Elektrofachkräfte oder von Elektrofachkräften unterwiesene Personen, die
außerdem mit den geltenden Normen vertraut sind.

Ferner müssen genannte Personen mit allen in diesem Dokument genannten

Produkten und deren Gebrauchsanleitungen vertraut sein. Sie müssen in der Lage
sein, auch solche Gefährdungen richtig abschätzen zu können, die sich erst durch
die Kombination der Produkte ergeben.

Für Fehlhandlungen und Schäden, die an WAGO-Produkten und Fremdprodukten

durch Missachtung der Informationen dieses Dokumentes entstehen, übernimmt
die WAGO Kontakttechnik GmbH & Co. KG keine Haftung.

Haftungsbeschränkung
Diese Dokumentation beschreibt den Einsatz diverser Hardware- und
Softwarekomponenten in spezifischen Beispielanwendungen. Die Komponenten
können Produkte oder Teile von Produkten unterschiedlicher Hersteller darstellen.
Hinsichtlich bestimmungsgemäßer und sicherer Verwendung der Produkte gelten
ausschließlich die jeweiligen Gebrauchsanleitungen der Hersteller. Für deren
Inhalte sind ausschließlich die jeweiligen Hersteller der Produkte verantwortlich.

Die in dieser Dokumentation beschriebenen Beispielanwendungen stellen

Konzepte, also technisch mögliche Anwendungen dar. Ob diese Konzepte im
konkreten Einzelfall realisiert werden können, hängt von diversen
Randbedingungen ab. Beispielsweise können andere Versionen der Hardware-
oder Softwarekomponenten eine andere als die beschriebene Handhabung
erfordern. Aus den hier enthaltenen Beschreibungen leitet sich daher kein
Anspruch auf eine bestimmte Beschaffenheit der Produkte ab.

Die Verantwortung für die sichere Verwendung einer konkreten Software- oder
Hardwarekonfiguration liegt bei demjenigen, der sie erstellt bzw. betreibt. Dies
gilt auch dann, wenn bei der Realisierung eines der in diesem Dokument
beschriebenen Konzepte umgesetzt wurde.

Die WAGO Kontakttechnik GmbH & Co. KG übernimmt für Realisierungen

dieser Konzepte keine Haftung.

Version 1.0.1
Inhaltsverzeichnis
Inhaltsverzeichnis .................................................................................................. 6
1 Beschreibung ................................................................................................ 7
2 Verwendetes Material .................................................................................. 7
2.1 Erforderliche Bibliotheken ........................................................................ 7
2.2 Geräte ........................................................................................................ 7
2.3 Tools .......................................................................................................... 7
3 Aufbau........................................................................................................... 8
4 Bibliotheksinstallation ................................................................................. 9
5 Allgemeingültige Anpassungen ................................................................. 11
5.1 Deklarationsteil ....................................................................................... 11
5.2 Programmcode ........................................................................................ 11
6 Beispielprogramm ...................................................................................... 12
6.1 Beispiel WagoAppPowerMeasurement .................................................. 12
6.2 Beispiel General ...................................................................................... 13
Anwendungshinweis CODESYS V3.x – Modulbibliotheken unter einer CODESYS-V3.x-Soft-SPS 7
WAGO I/O SYSTEM 750 Beschreibung

1 Beschreibung
In diesem Anwendungshinweis wird auf die Nutzung der Bibliothek für spezielle
Module, z. B. Modul 750-494 und die Bibliothek
„WagoAppPowerMeasurement“, in Verbindung mit einer Soft-SPS der Firma 3S
eingegangen.
Eine Übertragung ist nach gleichem Schema auf alle weiteren Module und
Bibliotheken des Pakets möglich.

2 Verwendetes Material
2.1 Erforderliche Bibliotheken
Bibliothek Beschreibung

WagoAppPowerMeasurement Bibliothek für die Leistungsmessmodule

WagoAuxModbus_3S_SoftPLC Modbus®-Kommunikation

WagoSysModuleBase Systemdienste für I/O-Module

WagoSysModule_75x_yyy Systemdienste für das spezielle Modul

WagoTypesModule_75x_yyy Systemdienste für das spezielle Modul

WagoSysFieldbusModule Systemdienste für Module am Koppler

WagoSysFieldbusService Systemdienste für den Koppler

2.2 Geräte
Lieferant Anzahl Bezeichnung Bestnr.

1 PC
WAGO 1 Leistungsmessmodul 750-494
WAGO 1 Leistungsmessmodul 750-495
WAGO 1 Digitaler Ausgang 750-502
WAGO 1 Koppler 750-342
WAGO 2 Endmodul 750-600

2.3 Tools
Bezeichnung Bestnr.

CODESYS-V3.x-32-Bit-Soft-PLC

Version 1.0.1
3 Aufbau
Hinweis CODESYS-Version beachten!
Die Funktion ist nur mit CODESYS-3.x-32-Bit möglich.
Die 64-Bit-Version der Entwicklungsumgebung wird nicht unterstützt.

Koppler

PC

Feldbus
Abbildung 1: Hardwareaufbau (Modbus®)

Das Modul ist an einem Wago Koppler gesteckt.

Der Koppler ist über den Feldbus (z. B. Modbus®) mit der Soft-SPS verbunden.
Anwendungshinweis CODESYS V3.x – Modulbibliotheken unter einer CODESYS-V3.x-Soft-SPS 9
WAGO I/O SYSTEM 750 Bibliotheksinstallation

4 Bibliotheksinstallation
Das Bibliothekspaket ist in mehrere Unterordner gegliedert. Sie enthalten
Bibliotheken, welche zur Inbetriebnahme der zugehörigen WAGO Module
benötigt werden.

In jedem Fall ist der Inhalt des Unterordners 1_General ins CODESYS-
Bibliotheksrepository zu installieren.

Dieses ruft man unter dem Menüpunkt Tools > Bibliotheksrepository oder im
Bibliotheksverwalter > Bibliotheksrepository auf. Durch einen Klick auf
Installieren … ist zum Pfad des Ordners zu navigieren und alle „*.compiled-
library“-Dateien anzuwählen.

Abbildung 2: Aufruf Bibliotheksrepository

Zusätzlich sind die benötigten Anwendungsordner auf gleicher Art und Weise
einzubinden.

Version 1.0.1
Hinweis Internal Bibliotheken
„WagoSys*Internal“-Platzhalterbibliotheken können bei Gebrauch mit einer Soft-
SPS nicht vom Bibliotheksverwalter aufgelöst werden.
Ein Herunterladen und starten des SPS-Programms ist dennoch möglich.

Abbildung 3: Nicht auflösbare Platzhalterbibliotheken

Anwendungshinweis CODESYS V3.x – Modulbibliotheken unter einer CODESYS-V3.x-Soft-SPS 11
WAGO I/O SYSTEM 750 Allgemeingültige Anpassungen

5 Allgemeingültige Anpassungen
5.1 Deklarationsteil
Instanz deklarieren

Für jedes Modul ist eine Instanz des Funktionsbausteins FbModule_75x_yyy aus
der Bibliothek „WagoSysFieldbusModule“ zu deklarieren.

yyy steht dabei für den letzten Teil der Modulbezeichnung, z. B. 494 im Falle
eines Moduls 750-494.

Der Zugriff der Funktionsbausteine aus den verschiedenen Bibliotheken erfolgt

über den Eingang I_Port. Dieser Eingang ist mit der zuvor deklarierten Instanz zu
beschalten.

5.2 Programmcode
Innerhalb des Programmcodes sind zwei Methoden aus der Bibliothek
„WagoSysFieldbusModule“ aufzurufen:
FbModule_75x_yyy.setNewPaInputs
FbModule_75x_yyy.getNewPaOutputs

Version 1.0.1
6 Beispielprogramm
Hinweis Feldbus!
Im Beispielprojekt werden die Daten von einem Modbus®-Koppler mit Hilfe
des Bausteins ETHERNET_MODBUSMASTER_UDP geholt. Die
Feldbusanbindung unterscheidet sich, je nachdem welcher Feldbus zum
Einsatz kommt.

6.1 Beispiel WagoAppPowerMeasurement

Ein diesen Anwendungshinweis ergänzendes Beispielprogramm ist unter
11_WagoAppPowerMeasurement zu finden.

Modbus®-Anbindung unter Nutzung von WagoAuxModbus

Der physikalische Aufbau entspricht dem gemäß Kapitel 3.

Anpassungen im Bibliotheksverwalter:
1) „WagoSysFieldbusModule“ einfügen.
2) „WagoSysFieldbusService“ einfügen.

Anpassungen im Programmcode:
3) Instanz deklarieren. → F2: WagoSysFieldbusModule.FbModule_75x_494;

Wenn ein Modul hinter einem Feldbuskoppler gesteckt ist, ist eine Instanz des
Baustein „FbModule_75x_494“ bzw. „FbModule_75x_495“ aus der Bibliothek
„WagoSysFieldbusModule“ anzulegen. Diese Instanz, in diesem Beispiel F2, ist
mit den Ein- und Ausgangsdaten des entsprechenden Moduls zu versorgen. Dazu
werden die Methoden „SetNewPaInputs“ und „GetNewPaOutputs“ genutzt.
Anwendungshinweis CODESYS V3.x – Modulbibliotheken unter einer CODESYS-V3.x-Soft-SPS 13
WAGO I/O SYSTEM 750 Beispielprogramm

Abbildung 4: Methoden zur Verarbeitung der Ein- und Ausgangsdaten

Die Bausteine aus der Bibliothek „WagoAppPowerMeasurement“ können

anschließend mit diesem Instanznamen arbeiten.

Abbildung 5: Objektinstanz

6.2 Beispiel General

Hinweis Bibliotheken!
Im Beispielprojekt sind alle Bibliotheken voreingebunden. Es wird
empfohlen, alle Bibliotheken des Pakets zu installieren; andernfalls sind alle
nicht benötigten Bibliotheken im Bibliotheksverwalter zu löschen.

Das Projekt „General_example_3S_SoftSPS.project“ basiert auf dem Beispiel des

Moduls 750-494. Eine Übertragung ist nach gleichem Schema auf alle weiteren
Bibliotheken möglich.

Version 1.0.1
Anwendungshinweis CODESYS V3.x – Modulbibliotheken unter einer CODESYS-V3.x-Soft-SPS 15
WAGO I/O SYSTEM 750 Beispielprogramm

WAGO Kontakttechnik GmbH & Co. KG

Postfach 2880 • D-32385 Minden
Hansastraße 27 • D-32423 Minden
Telefon: +49 (0) 571/8 87 – 0
Telefax: +49 (0) 571/8 87 – 844 1 69
E-Mail: info@wago.com
Internet: http://www.wago.com

Version 1.0.1