AML-Datei mit IO-Link exportieren/importieren - 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
AML-Datei mit IO-Link exportieren/importieren

Voraussetzung

Einleitung

Sie können mit TIA Portal eine AML-Datei mit der IO-Link-Masterkonfiguration zusammen mit IO-Link-Geräten, die über S7-PCT (Port Configuration Tool) konfiguriert wurden, importieren und exportieren.

Nachfolgend ist ein Konfigurationsbeispiel mit einem IO-Link-Master dargestellt.

Nachfolgend ist ein Konfigurationsbeispiel für ein IO-Link-Gerät dargestellt, das am IO-Master-Port über PCT konfiguriert wurde:

Add-In aktivieren/deaktivieren

Für den Export/Import der IO-Link-Masterkonfiguration (mit PCT in TIA Portal konfiguriert) über eine AML-Datei muss Siemens.CaxPctAddIn.addin über die Benutzeroberfläche von TIA Portal aktiviert werden.

Das Add-In ist über die Benutzeroberfläche zu aktivieren/deaktivieren. Um das Add-in zu aktivieren, werden Sie aufgefordert, ihre allgemeinen und für den Workflow geltenden Berechtigungen anzugeben.

Hinweis

Die Datei 'Siemens.CaxPctAddIn.addin' muss aus "Setup\\Bundles\\WinCCCA_PRO_DVD_2\\DVD\\Support\\CAx\\Add-Ins" kopiert werden, um das Add-In zu aktivieren/deaktivieren.

AML-Datei mit IO-Link-Informationen exportieren

Sie können mit TIA Portal eine Projektkonfiguration mit IO-Link-Mastern zusammen mit den angeschlossenen IO-Link-Geräten, die über PCT konfiguriert wurden, exportieren. Nach einem erfolgreichen Export muss die gleiche Konfiguration in der AML-Datei angezeigt werden. Wird das Add-in nicht aktiviert, ist der Export immer noch erfolgreich möglich, aber die Konfiguration für IO-Link-Geräte wird nicht exportiert.

Bei Problemen mit dem Export PCT-relevanter Konfigurationen werden die Details als Fehler-/Warnmeldung in der PCT.log-Datei protokolliert. Unabhängig davon, ob der PCT-Export erfolgreich ist oder nicht, wird in Register Info der Benutzeroberfläche von TIA Portal eine allgemeine Meldung angezeigt.

Speicherort der PCT-Protokolldatei: Die PCT-Protokolldatei wird am gleichen Ort wie die CAX-Protokolldatei erstellt, d.h. <CAX log location>\<guid>\PCT.log.

  • Wird der IO-Link-Master ohne S7 PCT konfiguriert (Beispiel: Ports mit Konfiguration ohne S7-PCT = wahr im TIA Portal), weil die IO-Link-Ports über TIA Portal konfiguriert wurden, werden die Ports trotzdem von TIA Portal exportiert, jedoch mit Mindestattributen wie ConfigurationWithPDCT, Label und Name in der AML-Datei, und diese werden unverändert in die AML-Datei zurückimportiert.

  • Einige Konfigurationen (wie HW-Parameter/Attribute) im TIA Portal können die IO-Link-Portkonfiguration auf der PCT-Seite beeinflussen. Beispiel: Im Modul 6ES7 148-6JG00-0BB0 kann jeder Port mit einem "Porttyp" in TIA Portal, der den Typ der IO-Link-Geräte beeinflusst, konfiguriert und auf der PCT-Seite in diesen Port gesteckt werden. Dieser Parameter steuert die erforderliche Adressraumzuweisung für jeden Port auf der PCT-Seite für den Anschluss des erforderlichen IO-Link-Geräts. Beim AML-Austausch sollten Sie sicherstellen, dass eine derartige 'beeinflussende' Konfiguration in der AML-Datei eingeschlossen wird, damit der AML-Dateiaustausch erfolgreich ausgeführt werden kann. Fehlt eine solche 'beeinflussende' Konfiguration in der AML-Datei, schlägt der AML-Austausch fehl. Im Beispiel oben kann der Benutzer den Export benutzerdefinierter Attribute (über die CAx-Einstellungen im TIA Portal) einschließen, damit der Parameter 'Porttyp' beim Export aus dem TIA Portal in der AML enthalten ist.

  • Es wird grundsätzlich erwartet, dass der Benutzer Konfigurationsänderungen im IO-Link in TIA Portal manuell synchronisiert, indem er das S7-PCT-Tool explizit startet. Daher obliegt es dem Benutzer, auf die Aktualität der IO-Link-Konfiguration vor dem Exportieren der AML-Datei zu achten. Beispiel: Der Benutzer erstellt zuerst eine IO-Link-Konfiguration durch Auswählen der Standardparameter für die Ports im TIA Portal und konfiguriert dann die IO-Link-Geräte mit S7-PCT. Später entschließt er sich, Parameter für die Ports im TIA Portal zu ändern. Sobald er Änderungen vornimmt, muss der Benutzer sicherstellen, dass das S7-PCT-Tool gestartet wird, damit eventuelle Inkonsistenzen auf Grund der Parameteränderung (zum Beispiel dass gesteckte IO-Link-Geräte nicht mehr zum Port passen) mitgeteilt und vom Benutzer vor dem AML-Export beseitigt werden können. Andernfalls kann eine inkonsistente Konfiguration exportiert werden.

  • Es gibt Konfigurationen, bei denen die IO-Link-Master-Ports zunächst ohne S7-PCT konfiguriert werden können (z. B.: Einstellung Betriebsart = IO-Link manuell), die aber später im S7-PCT Tool geändert/überschrieben werden können. Diese Konfiguration wird vom AML-Austausch nicht unterstützt.

Das folgende Snippet entspricht einer AML, die nach dem Export der Konfiguration über CAx-Export erstellt wurde:

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

<?xml version="1.0" encoding="utf-8"?>

<CAEXFile xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xsi:noNamespaceSchemaLocation="CAEX_ClassModel_V2.15.xsd" FileName="Project2_.aml" SchemaVersion="2.15">

..

</AdditionalInformation>

<InstanceHierarchy Name="APC Sample Instance Hierarchy">

<InternalElement ID="02afa376-7fbd-46d8-9659-b82959617326" Name="Project24">

..

<InternalElement ID="41fec27b-a0fa-4df6-a604-d60008e34d81" Name="Ungrouped devices">

<InternalElement ID="968336bc-bda8-4da6-b3fa-2cc8e8493806" Name="ET 200eco station_1">

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

<Value>System:Device.ET200eco</Value>

</Attribute>

<InternalElement ID="41196a85-aaae-42e0-994f-4a46e773af0f" Name="Rack_0">

...

<InternalElement ID="165b1850-bba5-4509-af92-acafd8f4f1d1" Name="IO device_1">

...

<InternalElement ID="555d1dd7-ec4d-40e6-b34d-06443a255741" Name="IOLink">

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

<Value>IO-Link</Value>

</Attribute>

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

<Value>IO-Link</Value>

</Attribute>

<Attribute Name="BuiltIn" AttributeDataType="xs:boolean">

<Value>true</Value>

</Attribute>

<InternalElement ID="4670a2aa-f441-458d-8dcc-e31b7712e325" Name="IOLink Port 1">

<Attribute Name="PositionNumber" AttributeDataType="xs:int">

<Value>1</Value>

</Attribute>

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

<Value>Port 1</Value>

</Attribute>

<Attribute Name="BuiltIn" AttributeDataType="xs:boolean">

<Value>true</Value>

</Attribute><Attribute Name="ConfigurationWithPDCT" AttributeDataType="xs:boolean">
<Value>true</Value>

</Attribute>
..

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/CommunicationPort" /><SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationIOLinkRoleClassLib/CommunicationPortIOLink" />

</InternalElement>

..

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/CommunicationInterface" </InternalElement>

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/DeviceItem">

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationIOLinkRoleClassLib/DeviceItemIOLinkMaster" />

</InternalElement>

..

</InternalElement>

<InternalElement ID="73292b01-7f22-44c8-98b1-2a007580cea0" Name="SIRIUS 3RR2441 3ph Current Monitoring Relay for IO-Link">

..

<InternalElement ID="d55d0b10-0d2f-44e6-9b96-72725a88ca41" Name="SIRIUS 3RR2441 3ph Current Monitoring Relay for IO-Link">

..

<InternalElement ID="ab97d538-5e44-4a97-bab1-d228c1af8c0b" Name="IOLink">

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

<Value>IO-Link</Value>

</Attribute>

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

<Value>IO-Link</Value>

</Attribute>

<Attribute Name="BuiltIn" AttributeDataType="xs:boolean">

<Value>true</Value>

</Attribute>

<InternalElement ID="f6ff4404-58fb-43ce-bf5d-e365e55c17b5" Name="IOLink Port 1">

<Attribute Name="PositionNumber" AttributeDataType="xs:int">

<Value>1</Value>

</Attribute>

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

<Value>Port 1</Value>

</Attribute>

<ExternalInterface ID="065e309d-01cc-410e-951d-0fa7cac979d0" Name="CommunicationPortInterface" RefBaseClassPath="AutomationProjectConfigurationInterfaceClassLib/CommunicationPortInterface" />

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/CommunicationPort" /

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationIOLinkRoleClassLib/CommunicationPortIOLink" />

</InternalElement>

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/CommunicationInterface" />

</InternalElement>

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/DeviceItem" /

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationIOLinkRoleClassLib/DeviceItemIOLinkDevice" />

</InternalElement>

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/Device" />

</InternalElement>

<SupportedRoleClass RefRoleClassPath="AutomationProjectConfigurationRoleClassLib/AutomationProject" />

..

<InternalLink Name="IOLink Port 1" RefPartnerSideA="f6ff4404-58fb-43ce-bf5d-e365e55c17b5:CommunicationPortInterface" RefPartnerSideB="4670a2aa-f441-458d-8dcc-e31b7712e325:CommunicationPortInterface" />

</InternalElement>

</InstanceHierarchy>

</CAEXFile>

AML-Datei mit IO-Link-Informationen importieren

Sie können die AML-Datei mit IO-Link-Master und der IO-Link-Gerätekonfiguration, die über PCT konfiguriert werden kann, importieren. Nach dem erfolgreichen Import sehen Sie die mit den IO-Link-Masterports verbundenen IO-Link-Geräte, nachdem das Tool PCT geöffnet wurde. Wird das Add-in nicht aktiviert, ist der Import immer noch erfolgreich möglich, aber die Konfiguration für IO-Link-Geräte wird nicht importiert.

Bei Problemen mit dem Import PCT-relevanter Konfigurationen werden die Details als Fehler-/Warnmeldung in der PCT.log-Datei protokolliert. Unabhängig davon, ob der PCT-Import erfolgreich ist oder nicht, wird in Register Info der Benutzeroberfläche von TIA Portal eine allgemeine Meldung angezeigt.

Whitelist

Die folgenden Module unterstützen den Export/Import der IO-Link-Masterkonfiguration.

 

IO-Link-Master

Firmware-Version

ET 200SP

6ES7-137-6BD00-0BA0

2.2

ET 200AL

6ES7-147-5JD00-0BA0

1.2

6ES7-147-5JD00-0BA0

1.1

ET 200pro

6ES7-147-4JD00-0AB0

1.1

ET 200MP

6ES7-547-1JF00-0AB0

1.0

ET 200eco PN

6ES7-148-6JD00-0AB0

1.1

6ES7-148-6JD00-0AB0

1.0

6ES7-148-6JG00-0BB0

5.1

6ES7-148-6JG00-0BB0

1.1

6ES7-148-6JG00-0BB0

1.0

6ES7 148-6JE00-0BB0

5.1

6ES7 148-6JJ00-0BB0

5.1

SIPLUS ET 200SP

6AG1-137-6BD00-2BA0

2.2

6AG2-137-6BD00-1BA0

2.2

Blacklist

Die folgenden Module unterstützen den Export/Import der IO-Link-Masterkonfiguration nicht.

 

IO-Link-Master

Firmware-Version

ET 200S

6ES7-138-4GA50-0AB0

 

3RK1-005-0LB00-0AA0

1.0

ET 200SP

6ES7-137-6BD00-0BA0

2.1

6ES7-137-6BD00-0BA0

2.0

6ES7-137-6BD00-0BA0

1.0

ET 200AL

6ES7-147-5JD00-0BA0

1.0

ET 200pro

6ES7-147-4JD00-0AB0

1.0

ET 200eco PN

6ES7-148-6JA00-0AB0

7.0

6ES7-148-6JA00-0AB0

6.1

S7-1200

6ES7-278-4BD32-0XB0

2.1

6ES7-278-4BD32-0XB0

2.0

SIPLUS S7-1200

6AG1-278-4BD32-2XB0

2.1

6AG1-278-4BD32-2XB0

2.0

6AG1-278-4BD32-4XB0

2.1

6AG1-278-4BD32-4XB0

2.0

SIPLUS ET 200SP

6AG1-137-6BD00-2BA0

2.1

6AG2-137-6BD00-1BA0

2.1

Siehe auch

Projekt öffnen