Systembeschreibung | System description | Description du système
Descrizione del sistema | Descripción de sistema | Systembeskrivning
AVENTICS™ AES OPC-UA
R412028203-BAL-001-AA
2022-03; Replaces: -
DE/EN/FR/IT/ES/SV
Inhaltsverzeichnis
1 Zu dieser Dokumentation ..................................................................................................................................................................................................3
1.1Gültigkeit der Dokumentation ..........................................................................................................................................................................................3
1.2Erforderliche und ergänzende Dokumentationen .............................................................................................................................................................3
1.3Darstellung von Informationen .........................................................................................................................................................................................3
2.1Zu diesem Kapitel .............................................................................................................................................................................................................3
2.4Qualifikation des Personals ...............................................................................................................................................................................................4
2.6Beschädigung durch Störung des Steuerungsnetzwerks ...................................................................................................................................................4
3 Zu diesem Produkt ............................................................................................................................................................................................................4
4.1Eine OPC-UA-Verbindung mit dem AES-Modul aufbauen ..................................................................................................................................................4
4.2.3Reihenfolge der Module .....................................................................................................................................................................................5
5 Fehlersuche und Fehlerbehebung ......................................................................................................................................................................................7
Diese Dokumentation gilt für das OPC-UA-Protokoll der folgenden AES-Module:
• R412088223, Buskoppler AES 2 für PROFINET IO
• R412088222, Buskoppler AES 2 für EtherNet/IP
Diese Dokumentation richtet sich an Programmierer, Elektroplaner, Serviceper-
sonal und Anlagenbetreiber.
Diese Dokumentation enthält wichtige Informationen, um das Produkt sicher
und sachgerecht in Betrieb zu nehmen, zu bedienen und einfache Störungen
selbst zu beseitigen.
Die Systembeschreibung für Buskoppler finden Sie auf der mitgelieferten CD R412018133. Je nach dem von Ihnen verwendeten Feldbusprotokoll müssen Sie die entsprechende Dokumentation auswählen.
1.2 Erforderliche und ergänzende Dokumentationen
u Nehmen Sie das Produkt erst in Betrieb, wenn Ihnen folgende Dokumentatio-
nen vorliegen und Sie diese beachtet und verstanden haben.
Tab.1: Erforderliche und ergänzende Dokumentationen
DokumentationDokumentartBemerkung
AnlagendokumentationBetriebsanleitungwird vom Anlagenbe-
Dokumentation des SPS-Konfigurationstools SoftwareanleitungBestandteil der Soft-
Montageanleitungen aller vorhandenen
Komponenten und des gesamten Ventilsystems AV
Systembeschreibungen zum elektrischen Anschließen der E/A-Module und der Buskoppler
Dokumentation der AV-EP-Druckregelventile
R414007537
Alle Montageanleitungen und Systembeschreibungen der Serien AES
und AV sowie die SPS-Konfigurationsdateien finden Sie auf der CD
R412018133.
MontageanleitungPapierdokumentation
Systembeschreibung pdf-Datei auf CD
Betriebsanleitung
treiber erstellt
ware
VORSICHT
Möglicherweise gefährliche Situation.
Das Nichtbeachten dieser Hinweise kann leichte Verletzungen zur Folge haben
oder zu Sachbeschädigungen führen.
ACHTUNG
Möglichkeit von Sachbeschädigungen oder Funktionsstörungen.
Das Nichtbeachten dieser Hinweise kann Sachbeschädigungen oder Funktions-
störungen zur Folge haben, jedoch keine Personenschäden.
1.3.2 Symbole
Empfehlung für den optimalen Einsatz unserer Produkte.
Beachten Sie diese Informationen, um einen möglichst reibungslosen
Betriebsablauf zu gewährleisten.
1.4 Abkürzungen
In dieser Dokumentation werden folgende Abkürzungen verwendet:
Tab.2: Abkürzungen
AbkürzungBedeutung
AESAdvanced Electronic System
AVAdvanced Valve
BoolBoolean (Datentyp für Angabe der Werte „True“ oder „False“)
EnumEnumeration (Aufzählung)
EtherNet/IPEtherNet Industrial Protocol
INTInteger
JSONJavaScript Object Notation
PROFINET IOProcess Field Network Input Output
SPSSpeicherprogrammierbare Steuerung oder PC, der Steuerungsfunk-
tionen übernimmt
UAAktorspannung (Spannungsversorgung der Ventile und Ausgänge)
UINTUnsigned Integer
ULLogikspannung (Spannungsversorgung der Elektronik und Sensoren)
1.3 Darstellung von Informationen
1.3.1 Warnhinweise
In dieser Dokumentation stehen Warnhinweise vor einer Handlungsabfolge, bei
der die Gefahr von Personen- oder Sachschäden besteht. Die beschriebenen
Maßnahmen zur Gefahrenabwehr müssen eingehalten werden.
Aufbau von Warnhinweisen
SIGNALWORT
Art und Quelle der Gefahr
Folgen bei Nichtbeachtung
u Maßnahmen zur Gefahrenabwehr
Bedeutung der Signalwörter
GEFAHR
Unmittelbar drohende Gefahr für das Leben und die Gesundheit von Personen.
Das Nichtbeachten dieser Hinweise hat schwere gesundheitliche Auswirkun-
gen zur Folge, bis hin zum Tod.
WARNUNG
Möglicherweise drohende Gefahr für das Leben und die Gesundheit von Personen.
Das Nichtbeachten dieser Hinweise kann schwere gesundheitliche Auswirkungen zur Folge haben, bis hin zum Tod.
2 Sicherheitshinweise
2.1 Zu diesem Kapitel
Das Produkt wurde gemäß den allgemein anerkannten Regeln der Technik hergestellt. Trotzdem besteht die Gefahr von Personen- und Sachschäden, wenn Sie
dieses Kapitel und die Sicherheitshinweise in dieser Dokumentation nicht beachten.
1. Lesen Sie diese Dokumentation gründlich und vollständig, bevor Sie mit dem
Produkt arbeiten.
2. Bewahren Sie die Dokumentation so auf, dass sie jederzeit für alle Benutzer
zugänglich ist.
3. Geben Sie das Produkt an Dritte stets zusammen mit den erforderlichen Do-
kumentationen weiter.
2.2 Bestimmungsgemäße Verwendung
Das in dieser Dokumentation beschriebene OPC-UA-Protokoll ist Teil einer Elektronikkomponente und wurde für den Einsatz in der Industrie für den Bereich Automatisierungstechnik entwickelt.
Alle AES-Module sind für den professionellen Gebrauch und nicht für die private
Verwendung bestimmt. Sie dürfen die Module nur im industriellen Bereich einsetzen (Klasse A). Für den Einsatz im Wohnbereich (Wohn-, Geschäfts- und Gewerbebereich) ist eine Einzelgenehmigung bei einer Behörde oder Prüfstelle einzuholen. In Deutschland werden solche Einzelgenehmigungen von der Regulierungsbehörde für Telekommunikation und Post (RegTP) erteilt.
Die OPC-UA-Verbindung im AES-Modul ist dafür bestimmt, Daten aus dem AESModul auszulesen. Es ist nicht möglich, Ausgänge oder Ventile zu steuern. Die
Steuerung der Ausgänge und Ventile ist dem angeschlossenen Feldbus vorbehalten. Siehe g4.2.1Datenbeschreibung.
Jeder andere Gebrauch als in der bestimmungsgemäßen Verwendung beschrieben ist nicht bestimmungsgemäß und deshalb unzulässig.
Die Schnittstelle dient zum Auslesen von Daten. Sie dient nicht zum Steuern von
Ein- oder Ausgängen.
ACHTUNG
Sicherheitsrisiko durch direkte Verbindung mit Internet oder Firmennetzwerk!
Das AES-Modul ist nicht für den Anschluss an das Internet oder an ein Firmennetzwerk entwickelt und nicht angemessen gegen unbefugten Zugriff geschützt.
Geräte, die an das Internet oder an ein Firmennetzwerk angeschlossen werden, müssen gegen unbefugten Zugriff angemessen geschützt sein, z.B.
durch die Verwendung von Firewalls und Netzwerksegmentierung. Das AESModul ist nur dafür entwickelt, in einem Ethernet-basierten Feldbus-Netzwerk
betrieben zu werden.
u Verbinden Sie das AES-Modul nicht direkt mit dem Internet oder einem Fir-
mennetzwerk.
Für Schäden bei nicht bestimmungsgemäßer Verwendung übernimmt die
AVENTICS GmbH keine Haftung. Die Risiken bei nicht bestimmungsgemäßer
Verwendung liegen allein beim Benutzer.
2.4 Qualifikation des Personals
Die in dieser Dokumentation beschriebenen Tätigkeiten erfordern grundlegende
Kenntnisse der Elektrik und Pneumatik sowie Kenntnisse der zugehörigen Fachbegriffe. Um die sichere Verwendung zu gewährleisten, dürfen diese Tätigkeiten
daher nur von einer entsprechenden Fachkraft oder einer unterwiesenen Person
unter Leitung einer Fachkraft durchgeführt werden.
Eine Fachkraft ist, wer aufgrund seiner fachlichen Ausbildung, seiner Kenntnisse
und Erfahrungen sowie seiner Kenntnisse der einschlägigen Bestimmungen die
ihm übertragenen Arbeiten beurteilen, mögliche Gefahren erkennen und geeignete Sicherheitsmaßnahmen treffen kann. Eine Fachkraft muss die einschlägigen
fachspezifischen Regeln einhalten.
2.5 Allgemeine Sicherheitshinweise
• Beachten Sie die Sicherheitshinweise in der Systembeschreibung Ihres Buskopplers.
2.6 Beschädigung durch Störung des Steuerungsnetzwerks
Produkte mit Ethernet-Anschluss sind für den Einsatz in speziellen industriellen
Steuerungsnetzwerken ausgelegt. Folgende Sicherheitsmaßnahmen einhalten:
• Immer bewährte branchenübliche Vorgehensweisen zur Netzwerksegmentierung befolgen.
• Direkte Anbindung von Produkten mit Ethernet-Anschluss an das Internet verhindern.
• Sicherstellen, dass Gefährdungen durch das Internet und das Unternehmensnetzwerk für alle Steuerungssystemgeräte und/oder Steuerungssysteme minimiert werden.
• Sicherstellen, dass Produkte, Steuerungssystemgeräte und/oder Steuerungssysteme nicht über das Internet zugänglich sind.
• Steuerungsnetzwerke und Remotegeräte hinter Firewalls verlegen und vom
Unternehmensnetzwerk isolieren.
• Wenn ein Remotezugriff erforderlich ist, ausschließlich sichere Methoden wie
virtuelle private Netzwerke (VPNs) verwenden.
ACHTUNG! VPNs, Firewalls und andere softwarebasierte Produkte können Sicherheitslücken aufweisen. Die Sicherheit der VPN-Nutzung kann nur so hoch
sein wie die Sicherheit der angeschlossenen Geräte. Daher immer die aktuelle
Version des VPNs, der Firewall und anderer softwarebasierter Produkte verwenden.
• Sicherstellen, dass die neueste freigegebene Software- und Firmware-Version
auf allen mit dem Netz verbundenen Produkten installiert sind.
3 Zu diesem Produkt
OPC-UA ist der Interoperabilitätsstandard für den sicheren und zuverlässigen Datenaustausch im Bereich der industriellen Automatisierung und in anderen Branchen. OPC-UA ist ein Protokoll mit einer semantischen Komponente, die jeden
Datenpunkt genauer beschreibt. OPC-UA beschreibt z.B., ob die Datenpunkte
mit einer Einheit oder einem Bereich versehen sind. Das OPC-UA-Protokoll erfüllt
die Funktionen des Micro Embedded Device Server Profiles.
4 OPC-UA-Verbindung
4.1 Eine OPC-UA-Verbindung mit dem AES-Modul aufbauen
Die AES-Gen2-Module mit den Protokollen Profinet und EtherNet/IP stellen zusätzlich zu den Feldbussen auf dem Port 4840 einen OPC-UA-Server zur Verfügung. Auf den OPC-UA-Server im AES-Modul können sich die OPC-UA-Clients verbinden.
Voraussetzung:
Damit eine Verbindung aufgebaut werden kann, muss sich das Gerät, das sich
über OPC-UA mit dem AES-Modul verbinden soll, im gleichen Subnetz befinden.
Alternativ muss ein Gateway vorhanden sein, das die Subnetze der beiden Geräte
miteinander verbindet. Dann kann auf dem Port 4840 eine Verbindung über
OPC-UA mit dem AES-Modul aufgebaut werden.
1. Um die IP-Adresse des AES-Moduls zu finden, nutzen Sie die protokollspezifi-
schen Tools oder das Ethernet „Device Configuration Tool“.
2. OPC-UA-Verbindung mit dem AES-Modul aufbauen.
4.2 OPC-UA-Struktur
4.2.1 Datenbeschreibung
Strukturdaten/-elementeSpezifikation/Wertebe-
SystemInfoMAC_Address1Erste MAC Adresse des AES-
MAC_Address2Zweite MAC Adresse des AES-
MAC_Address3Dritte MAC Adresse des AES-
ManufacturerHersteller der EinheitLocalized-
ModelModellbezeichnungLocalized-
HardwareRevisionHardware-Version des ModulsString
SoftwareRevisionSoftware-Version des ModulsString
DeviceRevisionModul-RevisionString
DeviceManualLink zum Modul ManualString
SerialNumberEindeutige Buchstaben- und
RevisionCounterRevisionscounter als ZahlInt32
ProductCodeModul NameString
NameplatePhysicalAddressHersteller-Angaben
CountryCodeLänderkennungString
StreetStraße und HausnummerString
ZIPPostleitzahlString
CityTownStadtString
StateCountyBundeslandString
NumberOfConfiguredModulesAnzahl der erkannten ModuleByte
IO_ModulesIO_Module01IO Module 1
ValuesAktueller Zustand der Ein- und
MaterialNumberMaterialnummer von IO Mo-
TypeModul Name, codiert in einem
IO_Module02
…
IO_Module10
ValuesAktueller Zustand der Ein- und
MaterialNumberMaterialnummer von IO Mo-
TypeModul Name Codiert in einem
NumberOfConfiguredIO_Modules
ValveModules ValveModule01Ventil Modul 1
ValuesAktueller Zustand der Ein- und
MaterialNumberMaterialnummer von Ventil
TypeModul Name, codiert in einem
ValveModule02
…
ValveModule32
ValuesAktueller Zustand der Ein- und
MaterialNumberMaterialnummer von Ventil
TypeModul Name, codiert in einem
NumberOfConfiguredValveModules
RawValuesAktuelle Ein- und Ausgangda-
schreibung
Elektronikspannung ist niedriger als 18VDC
Elektronikspannung ist niedriger als 10VDC
tes
Modul Name, codiert in einem
Enum
Ausgänge des Moduls als
JSON Object (siehe auch Wertebeschreibung)
dul 1
Enum
IO Module 2-10
Ausgänge des Moduls als
JSON Object
dul 10
Enum
Anzahl an angeschlossenen IO
Modulen
Ausgänge des Moduls als
JSON Object (siehe auch Wertebeschreibung)
Modul 1
Enum
Ventil Modul 2-32
Ausgänge des Moduls als
JSON Object (siehe auch Wertebeschreibung)
Modul 32
Enum
Anzahl an angeschlossenen
Ventilmodulen
ten mit Zeitstempel, an dem
die Daten gesampelt wurden,
als Komma-separierter String
Datentyp
Bool
Bool
UInt32
Enum
String
String
Enum
String
String
Enum
Byte
String
String
Enum
String
String
Enum
Byte
String
4.2.2 Wertebeschreibung
Value
Pro Modul wird in den Eintrag „Value“ ein JSON-String generiert, in dem die Ausgangsdaten und Eingangsdaten zum Aktualisierungszeitpunkt ausgegeben werden. Bei großen Systemen kann es vorkommen, dass diese nicht mit der minimalen Samplingrate (50ms) aktualisiert werden. Wenn bei diesen Systemen ein Aktualisierungsintervall von 50ms benötigt wird, kann auf den RawValue zurückgegriffen werden. Dieser wird bevorzugt aktualisiert und wird dadurch auch bei
großen Systemen mit einem Samplingintervall von ca. 50ms aktualisiert.
Aufbau des JSON-Strings:
Der String setzt sich wie folgt zusammen:
1. Öffnende geschweifte Klammer: {.
2. Wenn Eingangsdaten vorhanden sind: “i“:[ mit entsprechenden Werten.
Wenn Ausgangsdaten vorhanden sind, ein “o“:[ mit entsprechenden Werten.
3. Jeder Wert wird mit einem führendem “0x“ hex-codiert ausgegeben.
4. Für analoge Module wird der zusammengefasste Hex-Wert der Bitlänge eingefügt.
Für digitale Module werden die Bits in Byte-Blöcken eingefügt. Ein Byte wird
mit führenden Nullen vervollständigt, wenn es nicht vollständig genutzt wird.
5. Einzelne Werte werden durch Komma voneinander getrennt.
6. Schließende eckige Klammer: „]“.
7. Schließende geschweifte Klammer: „}“.
Die folgenden Beispiele veranschaulichen den Aufbau des Strings für verschiedene Module:
Die RawValue-Ausgabe wurde für eine möglichst performante Datenübertragung
erstellt. Daher werden hier die Daten nicht modulspezifisch aufgearbeitet. Der
Empfänger muss die Daten den Modulen selbst zuordnen (siehe g4.2.3Reihen-
folge der Module). Die Daten in diesem String werden im Big-Endian-Format
übertragen und sind hex-codiert. Nur der Zeitstempel ist dezimalcodiert.
Das folgende Beispiel veranschaulicht den Aufbau des Strings für das Modul
M44,2AI2AO2M12-AE.
Berechnung der Ausgangs- und Eingangswerte: siehe g4.2.3Reihenfolge der
Module.
ModulEingangsda-
VentilseiteEP (M)16 Bit Integer 500 (dezimal) 16 Bit Integer 500 (dezimal)
4-fach-Ventilmodul (4)
4-fach-Ventilmodul (4)
IO-SeiteAnaloges
Kombimodul
(2AI2AO2M12
-AE)
tentyp
------8 Bit Einzelbit 0x55 (hex)
------8 Bit Einzelbit 0xAA (hex)
2x 16 Bit Integer
Eingangsdaten
2000 (dezimal)
10000 (dezimal)
Ausgangsdatentyp
2x 16Bit Integer
Ausgangsdaten
500 (dezimal)
15000 (dezi-
mal)
Zeitstempel: 1h, 26min, 4 Sekunden und 608ms seit ModulStart (5164608ms)
Die Inhalte der Spalten werden mit Komma voneinander getrennt. Es ergibt sich
in diesem Beispiel folgender String:
„5164608,01F4,01F455AA,07D02710,01F43A98“.
Zeitstempel in
ms seit Startup
(dezimalcodiert)
516460801F401F455AA07D0271001F43A98
Eingangsdaten
Ventilseite (hexcodiert)
Ausgangsdaten
Ventilseite (hexcodiert)
Eingangsdaten
IO-Seite (hexcodiert)
Ausgangsdaten
IO-Seite (hexcodiert
4.2.3 Reihenfolge der Module
Die Eingangs- und Ausgangsdaten, mit denen die Module mit der Steuerung
kommunizieren, bestehen aus einer Bytekette. Die Länge der Eingangs- und Ausgangsdaten des Ventilsystems berechnet sich aus der Modulanzahl und der Datenbreite des jeweiligen Moduls. Dabei werden die Daten nur byteweise gezählt.
Besitzt ein Modul weniger als 1 Byte Ausgangs- bzw. Eingangsdaten, dann werden die übrigen Bits bis zur Bytegrenze mit sogenannten Stuffbits aufgefüllt.
Beispiel: Eine 2-fach-Ventiltreiberplatine mit 4 Bit Nutzdaten belegt in der Bytekette 1 Byte Daten, da die restlichen 4 Bit mit Stuffbits gefüllt werden. Dadurch
fangen die Daten des nächsten Moduls ebenfalls nach einer Bytegrenze an.
Die Nummerierung der Module beginnt rechts neben dem Buskoppler im Ventilbereich mit der ersten Ventiltreiberplatine (Modul1) und geht bis zur letzten
Ventiltreiberplatine am rechten Ende der Ventileinheit (Modul9). Siehe gAbb.1.
Überbrückungsplatinen bleiben unberücksichtigt. Einspeiseplatinen und UA-OFFÜberwachungsplatinen belegen ein Modul. Siehe gAbb.1 (Modul7). Einspeiseplatinen und UA-OFF-Überwachungsplatinen steuern kein Byte zu den Eingangsund Ausgangsdaten bei. Sie werden aber mitgezählt, da sie eine Diagnose besit-
In der Tabelle finden Sie eine Übersicht über Störungen, mögliche Ursachen und
deren Abhilfe.
Falls Sie den aufgetretenen Fehler nicht beheben konnten, wenden Sie
sich an die AVENTICS GmbH. Die Adresse finden Sie auf der Rückseite
der Anleitung.
Tab.6: Störungstabelle
Störungmögliche UrsacheAbhilfe
OPC-UA-Verbindung kann
nicht aufgebaut werden
Softwareversion von AES
Gen2 nicht kompatibel
Port 4840 blockiertPrüfen Sie die Firewall-Einstel-
Die maximale Anzahl an Clients ist überschritten
Softwareversion prüfen. OPCUA wird nur von AES-Gen2Modulen mit dem Protokoll
Profinet oder Ethernet IP ab
der Softwareversion V1.05
unterstützt.
lungen an Ihrem OPC-UA-Client.
Es können sich maximal 5
OPC-UA-Clients gleichzeitig
mit dem AES verbinden.
1 About this documentation.................................................................................................................................................................................................9
1.2Required and supplementary documentation ...................................................................................................................................................................9
1.3Presentation of information ..............................................................................................................................................................................................9
2.1About this chapter ............................................................................................................................................................................................................9
2.2Intended use .....................................................................................................................................................................................................................9
2.3Improper use ....................................................................................................................................................................................................................9
2.6Damage due to control network malfunction.................................................................................................................................................................... 10
3 About this product ............................................................................................................................................................................................................ 10
4.1Establishing an OPC-UA connection with the AES module ................................................................................................................................................. 10
5.1Table of malfunctions ....................................................................................................................................................................................................... 12
6 Key technical data ............................................................................................................................................................................................................. 13
This documentation applies to the OPC-UA protocol for the following AES modules:
• R412088223, AES 2 bus coupler for PROFINET IO
• R412088222, AES 2 bus coupler for EtherNet/IP
This documentation is geared toward programmers, electrical engineers, service
personnel, and system owners.
This documentation contains important information on the safe and proper com-
missioning and operation of the product and how to remedy simple malfunctions
yourself.
The system description for bus couplers can be found on the CD
R412018133, included on delivery. Select the appropriate documentation based on your fieldbus protocol.
1.2 Required and supplementary documentation
u Only commission the product once you have obtained the following docu-
mentation and understood and complied with its contents.
Table1: Required and supplementary documentation
DocumentationDocument typeComment
System documentationOperating instruc-
Documentation for PLC configuration toolSoftware manualIncluded with soft-
Assembly instructions for all current components and the entire AV valve system
System descriptions for connecting the I/O
modules and bus couplers electrically
Documentation for the AV-EP pressure regulators, R414007537
All assembly instructions and system descriptions for the AES and AV
series, as well as the PLC configuration files, can be found on the CD
R412018133.
tions
Assembly instructions Printed documenta-
System descriptionPDF file on CD
Operating instructions
To be created by system owner
ware
tion
1.3 Presentation of information
1.3.1 Warnings
In this documentation, there are warning notes before the steps whenever there
is a risk of personal injury or damage to equipment. The measures described to
avoid these hazards must be followed.
Structure of warnings
SIGNAL WORD
Hazard type and source
Consequences of non-observance
u Precautions
Meaning of the signal words
DANGER
Immediate danger to the life and health of persons.
Failure to observe these notices will result in serious health consequences, in-
cluding death.
WARNING
Possible danger to the life and health of persons.
Failure to observe these notices can result in serious health consequences, in-
cluding death.
CAUTION
Possible dangerous situation.
Failure to observe these notices may result in minor injuries or damage to
property.
NOTICE
Possibility of damage to property or malfunction.
Failure to observe these notices may result in damage to property or malfunc-
tions, but not in personal injury.
1.3.2 Symbols
Recommendation for the optimum use of our products.
Observe this information to ensure the smoothest possible operation.
1.4 Abbreviations
This documentation uses the following abbreviations:
Table2: Abbreviations
AbbreviationMeaning
AESAdvanced Electronic System
AVAdvanced Valve
BoolBoolean (data type indicating the values “True” or “False”)
EnumEnumeration (list)
EtherNet/IPEtherNet Industrial Protocol
INTInteger
JSONJavaScript Object Notation
PROFINET IOProcess Field Network Input Output
PLCProgrammable logic controller or PC, which assumes the control
functions
UAActuator voltage (power supply for valves and outputs)
UINTUnsigned integer
ULLogic voltage (power supply for electronic components and sensors)
2 Safety instructions
2.1 About this chapter
The product has been manufactured according to the accepted rules of current
technology. Even so, there is danger of injury and damage to equipment if the
following chapter and safety instructions of this documentation are not followed.
1. Read these instructions completely before working with the product.
2. Keep this documentation in a location where it is accessible to all users at all
times.
3. Always include the documentation when you pass the product on to third par-
ties.
2.2 Intended use
The OPC-UA protocol described in this documentation is part of an electronic
component and was developed for use in industrial applications in the area of automation technology.
All AES modules are intended for professional use only and not for private use.
The modules may only be used for industrial applications (classA). An individual
license must be obtained from the authorities or an inspection center for systems
that are to be used in a residential area (residential, business, and commercial areas). In Germany, these individual licenses are issued by the Regulating Agency
for Telecommunications and Post (Regulierungsbehörde für Telekommunikation
und Post, Reg TP).
The OPC-UA connection in the AES module is designed to read data from the AES
module. It is not possible to control outputs or valves. Control of the outputs and
valves is reserved for the connected fieldbus. See g4.2.1Data description.
2.3 Improper use
Any use other than that described in the section “Intended use” is considered improper and is not permitted.
The interface is designed to read data. It is not designed to control inputs or outputs.
Safety risk due to direct connection to the Internet or the company network!
The AES module has not been designed for connection to the Internet or a
company network and is not adequately protected against unauthorized access.
Devices that are connected to the Internet or a company network, have to be
adequately protected against unauthorized access, e.g. by using a firewall and
network segmentation. The AES module has only been designed for operation
in an Ethernet-based fieldbus network.
u Do not connect the AES module directly to the Internet or a company net-
work.
AVENTICS GmbH is not liable for any damages resulting from improper use. The
user alone bears the risks of improper use of the product.
2.4 Personnel qualifications
The work described in this documentation requires basic electrical and pneumatic knowledge, as well as knowledge of the appropriate technical terms. In order to ensure safe use, these activities may therefore only be carried out by qualified technical personnel or an instructed person under the direction and supervision of qualified personnel.
Qualified personnel are those who can recognize possible dangers and institute
the appropriate safety measures, due to their professional training, knowledge,
and experience, as well as their understanding of the relevant regulations pertaining to the work to be done. Qualified personnel must observe the rules relevant to the subject area.
2.5 General safety instructions
• Observe the safety notes found in your bus coupler’s system description.
2.6 Damage due to control network malfunction
Products with Ethernet connection are designed to be used on specific industrial
control networks. Observe the following safety measures:
• Always follow industry best practices for network segmentation.
• Avoid exposing products with Ethernet connection directly to the Internet.
• Minimize internet and business network exposure for all control system devices and/or control systems.
• Ensure that products, control system devices and/or control systems are not
accessible from the Internet.
• Locate control networks and remote devices behind firewalls and isolate them
from the business network.
• If remote access is required, only use secure methods such as Virtual Private
Networks (VPNs).
NOTICE! Recognize that VPNs and other software-based products may have
vulnerabilities. A VPN is only as secure as the connected devices it serves. Always use the current version of the VPN, the firewall and other software-based
products.
• Ensure that the latest released software and firmware versions are installed on
all products connected to the network.
3 About this product
OPC-UA is the interoperability standard for secure and reliable data exchange in
industrial automation and other industries. OPC-UA is a protocol with a semantic
component, which describes each data point in more detail. For example, OPCUA describes if the data points are provided with a unit or a range. The OPC-UA
protocol fulfills the functions of the Micro Embedded Device Server Profiles.
4 OPC-UA connection
4.1 Establishing an OPC-UA connection with the AES module
In addition to the fieldbuses, the AES Gen2 modules with the Profinet and EtherNet/IP protocols provide an OPC-UA server on port 4840. The OPC-UA clients can
connect to the OPC-UA server in the AES module.
Requirement:
In order to establish a connection, the device that is supposed to connect to the
AES module via OPC-UA must be located in the same subnet. Alternatively, a
gateway has to exist that connects the subnets of the two devices to each other.
It is then possible to establish a connection to the AES module on port 4840 via
OPC-UA.
1. To find the IP address of the AES module, use the protocol-specific tools or the
Ethernet “Device Configuration Tool”.
2. Establish OPC-UA connection with the AES module.
4.2 OPC-UA structure
4.2.1 Data description
Structural data/elementsSpecifications/value de-
SystemInfoMAC_Address1First MAC address of the AES
MAC_Address2Second MAC address of the
MAC_Address3Third MAC address of the AES
ManufacturerManufacturer of the unitLocalized-
ModelModel designationLocalized-
HardwareRevisionHardware version of the mod-
SoftwareRevisionSoftware version of the mod-
DeviceRevisionModule revisionString
DeviceManualLink to the module manualString
SerialNumberUnique combination of letters
RevisionCounterRevision counter as a numberInt32
ProductCodeModule nameString
The RawValue output was set up for high-performance data transfer. Therefore,
data is not processed on a module-specific basis here. Instead, the receiver must
assign the data to the modules (see g4.2.3Module sequence). The data in this
string is transmitted in big-endian format and is hex-encoded. Only the timestamp is in decimal code.
The following example illustrates the string structure for the module
M44,2AI2AO2M12-AE.
For calculation of the output and input values: see g4.2.3Module sequence.
Timestamp: 1h, 26min, 4seconds and 608ms since module start (5164608ms)
The contents of the columns are separated by commas. In this example, this re-
sults in the following string: “5164608,01F4,01F455AA,07D02710,01F43A98”.
Timestamp in
ms since startup (decimal
code)
516460801F401F455AA07D0271001F43A98
Input data,
valve side (hexencoded)
Output data,
valve side (hexencoded)
Input data, I/O
side (hex-encoded)
Output data, I/O
side (hex-encoded)
4.2.3 Module sequence
The input and output data used by the modules to communicate with the controller consist of a byte string. The lengths of the valve system input and output
data are calculated from the number of modules and the data width of the indi-
4.2.2 Value description
Value
Per module, a JSON string is generated in the “Value” entry, where output and input data are output at the update time. In large systems these are not always updated with the minimum sampling rate (50ms). If an update interval of 50ms is
required for these systems, the RawValue can be used. This is updated preferentially with a sampling interval of approx. 50ms even in large systems.
Structure of the JSON string:
The string is structured as follows:
1. Opening brace: {.
2. If input data is available: “i“:[ with the respective values.
If output data is available: “o“:[ with the respective values.
3. Each value is output as a hex-encoded value with a leading “0x“.
4. For analog modules, the summarized hex value of the bit length is inserted.
For digital modules, the bits are inserted in byte blocks. Leading zeros are
vidual module. The data is only counted in bytes. If a module has less than 1 byte
of input or output data, the left-over bits are “stuffed” to the byte boundary using non-information bits.
Example: A 2x valve driver board with 4 bits of payload data occupies 1byte in the
byte string, since the remaining 4 bits are stuffed with non-information bits. The
data of the next module therefore starts after a byte boundary.
The modules are numbered to the right of the bus coupler in the valve zone,
starting with the first valve driver board (module1) and continuing to the last
valve driver board on the right end of the valve unit (module9). See gFig.1.
Bridge cards are not taken into account. Supply boards and UA-OFF monitoring
boards occupy one module. See gFig.1 (module7). The supply boards and UAOFF monitoring boards do not add any bytes to the input and output data. However, they are also counted, since they have diagnostic data. The data length for
pressure regulators can be found in the operating instructions for AV-EP pressure
regulators.
The numbering is continued in the I/O zone. There, numbering is continued starting from the bus coupler to the left end.
added to a byte if it is not used in full.
5. Individual values are separated by commas.
6. Closing bracket: “]”.
7. Closing brace: “}”.
The following examples illustrate the string structure for various modules:
The PLC configuration key for the entire unit is thus:
• 423–4M4U43
• 8DI8M8
• 8DI8M8
• 8DO8M8
Calculation of the valve system data lengths
The data lengths of the bus coupler and the modules are shown in the following
table.
Table3: Calculation of the valve system data lengths
Module
number
The total length of the output data in the example configuration is 10bytes.
The total length of the input data in the example configuration is 4bytes.
ModuleOutput dataInput data
1Valve driver board, 4x1 byte of payload data –
2Valve driver board, 2x 1 byte
3Valve driver board, 3x1 byte
4Valve driver board, 4x1 byte of payload data –
5Pressure regulator2 bytes of payload data 2 bytes of payload
6Valve driver board, 4x1 byte of payload data –
7Electrical supply––
8Valve driver board, 4x1 byte of payload data –
9Valve driver board, 3x1 byte
10Input module (1byte of pay-
load data)
11Input module (1byte of pay-
load data)
12Output module (1byte of
payload data)
(4bits of payload data
plus 4non-information
bits)
(6bits of payload data
plus 2non-information
bits)
(6bits of payload data
plus 2non-information
bits)
–1 byte of payload
–1 byte of payload
1 byte of payload data –
Total length of output
data: 10 bytes
–
–
data
–
data
data
Total length of input
data: 4 bytes
The valve system always sends the input and output data bytes in the same physical sequence. This cannot be changed.
Assignment of output bytes
After the PLC configuration, the output bytes are assigned as shown in the following table.