Exportieren/Importieren von Subnetzen - TIAPortal

TIA Portal Openness: API für die Automatisierung von Engineering-Workflows

ft:publication_title
TIA Portal Openness: API für die Automatisierung von Engineering-Workflows
Product
TIAPortal
Version
V20
Publication date
01/2025
Language
de-DE
Exportieren/Importieren von Subnetzen

Voraussetzung

AML-Struktur

Subnetze beschreiben ein physisches Netzwerk, insbesondere, welche Geräte an dem gleichen Netzwerk vom Typ PROFIBUS, PROFINET, MPI oder ASI angeschlossen sind.

Die Verbindungen zwischen einem Netzwerk und den Geräteelementen werden als Referenz für das Netzwerkobjekt abgebildet. Es gibt keine Referenz von den Netzwerkobjekten zu den verbundenen Geräteelementen. Die Netzwerkparameter werden im Netzwerkobjekt gespeichert. Die Parameter, die eine Netzwerkschnittstelle eines bestimmten Geräteelements betreffen, das mit einem Netzwerk verbunden ist, werden in einem Netzwerkknotenobjekt in diesem Geräteelement gespeichert. Die Kommunikation wird oft mit „Kanälen“, „Ports“ und „Schnittstellen“ geregelt.

Subnetze werden als interne Elemente mit der Rollenklassifizierung „Subnetz“ in der Instanzhierarchie in der AML-Datei exportiert.

Ein Subnetz hat folgende verbundene Elemente in der AML-Struktur:

  • Internes Element mit der Rollenklassifizierung „Knoten“

    Legt die Schnittstelle auf einem Geräteelement fest.

  • <InternalLink>

    Legt die verbundenen Partner des Subnetzes fest. Der <InternalLink> Variablenname ist einzigartig und wird immer unter dem internen Element des Projekts in der AML-Datei hinzugefügt.

  • <ExternalInterface>

    Stellt in internen Elementen von Knoten und Subnetzen fest, dass Knoten und Subnetze verbunden sind. Wenn die Knoten oder Subnetze nicht verbunden sind, existieren die <ExternalInterface> Elemente für Knoten und Subnetz nicht.

Verwendung

In TIA Portal V16 unterstützt der CAx-Import Ethernet und Profinet und der Export erfolgt für die Attribute "Subnetztyp" und die "Knotentyp" immer über Ethernet.

Das rechnergestützte Importieren/Exportieren unterstützt folgende Arten von Subnetzen:

  • Ethernet

  • PROFIBUS

  • MPI

  • ASi

Attribute eines „Subnetz“-Elements

Die folgende Tabelle zeigt die zugehörigen Attribute der Objekte von rechnergestützten Import- und Exportdateien:

Attribut

Handhabung

Kommentar

Name

Obligatorisch

 

Type

Obligatorisch

Ethernet oder PROFIBUS oder MPI oder ASi

Attribute von Elementen "CommunicationInterface"

Die folgende Tabelle zeigt die zugehörigen Attribute der Objekte für CAx-Import- und -Exportdateien:

Attribut

Verarbeitung

Kommentar

Name

Obligatorisch

Label

Obligatorisch

Beschriftung fehlt möglicherweise, wenn "BuiltIn" = TRUE und "PositionNumber" für das zugehörige Objekt "DeviceItem" angegeben sind.

TypeIdentifier

Obligatorisch

Für integrierte Geräteelemente muss dieses Attribut mit der Typkennung seines steckbaren übergeordneten Elements exportiert werden. Während des Imports ist dieses Attribut nicht relevant.

Bei nicht integrierten Geräteelementen hat dieses Attribut keine Relevanz.

FirmwareVersion

Obligatorisch

 

TypeName

Nur Export

Keine Relevanz bei "integrierten" Geräteelementen.

DeviceItemType

Nur Export

Nur für CPU und Kopfmodul

Dieses Attribut ist beim Import optional, doch jedes Geräteelement außer Basiseinheiten mit DeviceItemType als Zubehör wird stillschweigend ignoriert.

PositionNumber

Obligatorisch

Keine Relevanz beim Import von "integrierten" Geräteelementen.

BuiltIn

Obligatorisch für Export

Optional für Import

Keine Relevanz für den Import von "nicht integrierten" Geräteelementen.

Für den Import standardmäßig "False".

Comment

Optional

Wird immer exportiert/importiert, wenn der Wert nicht leer ist.

Attribute von Elementen "CommunicationPort"

Die folgende Tabelle zeigt die zugehörigen Attribute der Objekte für CAx-Import- und -Exportdateien:

Attribut

Handhabung

Kommentar

Name

Obligatorisch

Label

Obligatorisch

Das Attribut 'Label' besitzt keine Relevanz für nicht integrierte Port-Geräteelemente und wird daher nicht exportiert.

Ab TIA Portal V19 enthält der Wert von 'Label‘ beim Exportieren der Port-Konfiguration kein Leerzeichen (Beispiel: P1R).

Beim Importieren des Werts für ein Port-Label wird beim Vergleich des Label-Werts nicht nach Groß- und Kleinschreibung unterschieden (z. B.: P1R, P1, p1).

Bei Ports, die für eine Ringtopologie freigegeben und mit Suffix "R" gekennzeichnet sind, ist der Import "gleichwertig" mit Ports zu behandeln, deren Label-Werte kein Suffix enthalten.

Beispiel: Die folgenden Port-Label werden als gleich behandelt:

  • P1 ist gleich P1

  • P1 ist gleich P1R

  • P1R ist gleich P1

  • P1R ist gleich P1R

TypeIdentifier

Obligatorisch

Das Attribut ist für den Export und Import von nicht integrierten Geräteelementen obligatorisch. Beispiel: Geräteelemente mit Integriert = False

Für integrierte Geräteelemente muss dieses Attribut mit der Typkennung seines steckbaren übergeordneten Elements exportiert werden. Während des Imports ist dieses Attribut nicht relevant.

Für nicht integrierte Geräteelemente ist dieses Attribut nicht relevant.

FirmwareVersion

Obligatorisch

Dies ist ein obligatorisches Attribut für den Export und Import dann und nur dann, wenn das Geräteelement nicht integriert ist und die Firmwareversion unterstützt.

Das Attribut ist nicht anwendbar, wenn das Geräteelement integriert ist.

TypeName

Obligatorisch für Export

Optional beim Import

Keine Relevanz bei "integrierten" Geräteelementen.

PositionNumber

Obligatorisch

Das Attribut ist für den Export und Import aller Typen von Port-Geräteelementen obligatorisch.

Beim Import ist das Attribut obligatorisch für nicht integrierte Port-Geräteelemente, besitzt aber keine Relevanz für integrierte Port-Geräteelemente

BuiltIn

Obligatorisch für Export

Optional für Import

Keine Relevanz für den Import von "nicht integrierten" Geräteelementen.

Für den Import standardmäßig "False".

Comment

Optional

Wird immer exportiert/importiert, wenn der Wert nicht leer ist.

Attribute eines „Knoten“-Elements

Die folgende Tabelle zeigt die zugehörigen Attribute der Objekte von rechnergestützten Import- und Exportdateien:

Attribut

Handhabung

Kommentar

Name

Nur Export

MPI, PROFIBUS, PROFINET

Type

Nur Exportieren

Ethernet oder PROFIBUS oder MPI oder ASi

NetworkAddress

Obligatorisch

 

SubnetMask

Optional

PROFINET

Beim Import wird der Standardwert beibehalten, wenn kein Wert festgelegt ist.

RouterAddress

Optional

PROFINET

Beim Import wird der Standardwert beibehalten, wenn kein Wert festgelegt ist.

DhcpClientId

Optional

PROFINET

Beim Import wird der Standardwert beibehalten, wenn kein Wert festgelegt ist.

IpProtocolSelection

Optional

PROFINET

Beim Import wird der Standardwert beibehalten, wenn kein Wert festgelegt ist.

Werte: Project, Dhcp, UserProgram, OtherPath, Address Tailoring

Bei dem Profinet-Knoten weicht die Verfügbarkeit von Attributen basierend auf bestimmten Vorbedingungen ab. Beispiel:

  • Wenn in der UI des TIA Portal als IP-Protokoll "Set IP address in the project" ausgewählt ist, dann sind "NetworkAddress" und "SubnetMask" verfügbar.

  • Das Attribut "RouterAddress" muss für den Export/Import verfügbar sein, wenn als IP-Protokoll "Set IP address in the project" und in der UI "Use router" ausgewählt sind.

  • Das Attribut "DhcpClientId" ist nur dann für den Export/Import verfügbar, wenn das Attribut 'IpProtocolSelection' 'Dhcp' ist.

Sonderfall CAx-Import, bei dem das Attribut 'Type' erforderlich ist - Profibus-Subnetzverbindung wird durch Ändern des Schnittstellentyps in der UI von 'MPI' in 'PROFIBUS' hergestellt.

  • Im TIA Portal ist für bestimmte Geräteelemente der Schnittstellentyp 'Mpi' voreingestellt. Dieser Typ muss jedoch in 'Profibus' geändert werden, um eine Profibus-Subnetzverbindung herzustellen. In diesem Fall muss als Typ der Wert 'Profibus' in der AML-Datei angegeben werden, um die Typkonvertierung beim Import zu zeigen.

Hinweis

  • Der CAx-Import unterstützt Ethernet und Profinet für die Attribute Subnetztyp und Knotentyp.

  • Der CAx-Import einer AML-Datei mit Stringwerten ohne Unterscheidung von Groß-/Kleinschreibung für die Attribute (Beispiel: Profinet, PROFINET, pROFINET, ProFINET usw.) wird unterstützt.

  • Der CAx-Export erfolgt immer über Ethernet.

Attribute eines „Kanal“-Elements

Die folgende Tabelle zeigt die zugehörigen Attribute der Objekte von rechnergestützten Import- und Exportdateien:

Attribut

Handhabung

Kommentar

Type

Obligatorisch

Digital oder analog

IoType

Obligatorisch

Eingang oder Ausgang

Number

Obligatorisch

 

Length

Nur Exportieren

 

Beispiel: Exportiertes Subnetz

AML-Struktur

Die folgenden Abbildungen zeigen die Struktur der exportierten AML-Datei.

Erweiterte Rolle für Profinet/Ethernet-Knoten

Im Rahmen der jüngsten Empfehlung von AR APC 1.2 müssen alle Profinet/Ethernet-Knoten gegen einen Knoten mit der zusätzlichen Rolle 'AutomationProjectConfigurationRoleClassLib/NodeEthernet' zusammen mit der vorhandenen Rolle 'AutomationProjectConfigurationRoleClassLib/Node' ausgetauscht werden, sofern erweiterte Attribute unterstützt werden.

Der Profinet/Ethernet-Knoten muss mit der zusätzlichen Rolle exportiert werden, sofern er erweiterte Attribute wie SubnetMask, RouterAddress, DhcpClientId, IpProtocolSelection unterstützt. Darüber hinaus muss es möglich sein, den Knoten mit oder ohne erweiterte Rolle zu importieren.

Der nachfolgende Auszug aus der XML-Datei zeigt die AML-Datei mit dem Knoten "Ethernet" mit erweiterter Rolle.

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

<InternalElement ID="9c4393a9-44d5-49b4-9314-02eb0f94b6c0" Name="IE1">

<Attribute Name="SubnetMask" AttributeDataType="xs:string">

<Value>255.255.255.0</Value>

</Attribute>

<Attribute Name="RouterAddress" AttributeDataType="xs:string">

<Value>192.168.0.1</Value>

</Attribute>

<Attribute Name="IpProtocolSelection" AttributeDataType="xs:string">

<Value>Project</Value>

</Attribute>

<Attribute Name="Type" AttributeDataType="xs:string">

<Value>Ethernet</Value>

</Attribute>

<Attribute Name="NetworkAddress" AttributeDataType="xs:string">

<Value>192.168.0.1</Value>

</Attribute>

<ExternalInterface ID="eea59d3c-3bc4-4d0d-9815-46b4b347369d" Name="LogicalEndPoint_Node" RefBaseClassPath="CommunicationInterfaceClassLib/LogicalEndPoint" />

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/Node" />

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationEthernetRoleClassLib/NodeEthernet" />

</InternalElement>