Export/Import von GSD/GSDML-basierten Geräten und Geräteelementen - 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
Export/Import von GSD/GSDML-basierten Geräten und Geräteelementen

Voraussetzung

Verwendung

Der CAx-Import/Export von GSD/GSDML-basierten Geräten und Geräteelementen ist mit dem Import/Export von Standardgeräten vergleichbar.

Bei GSD/GSDML-basierten Geräten und Geräteelementen weichen die exportierbaren Attribute voneinander ab, z. B. bei GSD/GSDML ist das Attribut "Label" vorhanden.

Generischer Import von Geräten und Baugruppenträgern ist möglich. Verwenden Sie für den Import die gleiche Kennung wie für Standardgeräte:

  • Generische Geräte importieren: TypeIdentifier = System:Device.Generic

  • Generische Baugruppenträger importieren: TypeIdentifier = System:Rack.Generic

Sind die Geräte generisch, definiert das Attribut BuiltIn die Art:

  • Physisch: BuiltIn = True

  • Generisch: BuiltIn = False

Attribute für ein Gerät

Die folgende Tabelle zeigt die zugehörigen Attribute von Geräten von CAx-Import- und -Exportdateien:

Attribut

Handhabung von Attribut

Kommentar

Name

Obligatorisch für Export und Import

TypeIdentifier

Obligatorisch für Export und optional für Import ab AR APC V1.1

 

Comment

Optional für Import

Attribute für ein Geräteelement

Die folgende Tabelle zeigt die zugehörigen Attribute eines Geräteelements von CAx-Import- und -Exportdateien:

Attribut

Handhabung von Attribut

Integriert = FALSCH

Generische Geräteelemente

Handhabung von Attribut

Integriert = WAHR

Physische Geräteelemente

Kommentar

Name

Obligatorisch

Nur Exportieren

TypeName

Nur Exportieren

-/-

DeviceItemType

Nur Exportieren

Nur Exportieren

Nur für PLC-Geräteelemenete (zentrale Geräte) und Kopfmodul-Geräteelemente (dezentrale Geräte)

Optional beim Import, doch jedes Geräteelement außer Basiseinheiten mit DeviceItemType als Zubehör wird ignoriert.

PositionNumber

Obligatorisch

Obligatorisch für Export

Ausnahmefälle:

Geräteelemente vom Typ Schnittstelle: Optional für Import

Geräteelemente vom Typ Port: Optional

BuiltIn

Optional

 

Standardeinstellung: FALSE

TypeIdentifier

Obligatorisch für „BuiltIn“ = FALSE

Ignoriert für „BuiltIn“ = TRUE

Bei integrierten Geräteelementen wird dieses Attribut mit der Typkennung seines steckbaren übergeordneten Elements exportiert.

Das Attribut hat beim Import keine Relevanz und ist somit optional.

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

Comment

Optional

-

Label

-

-

Geräteelemente vom Typ Schnittstelle: Obligatorisch

Geräteelemente vom Typ Port: Obligatorisch

Beispiel: Exportiertes GSD-/GSDML-Gerät

AML-Struktur der Exportdatei

Die folgende Abbildung zeigt die Struktur der exportierten AML-Datei.

Generischer und nicht-generischer Baugruppenträger mit und ohne TypeIdentifier

Der CAx-Import muss in der Lage sein, Geräte ohne Typkennung oder mit generischen Typkennungen, d. h. 'System:Device.Generic'‚ und Baugruppenträger mit generischen Typkennungen, d. h. 'System:Rack.Generic‘, zu verarbeiten.

Während des Importierens kann es möglich sein, dass die AML-Datei Gerätetypen ohne Typkennung oder mit generischer Typkennung, d. h. 'System:Device.Generic', und Baugruppenträger-Geräteelemente mit generischer Typkennung, d. h. 'System:Rack.Generic‘, enthält. Aber mit dem CAx-Import können diese bearbeitet sowie Geräte und Baugruppenträger-Geräteelemente korrekt erstellt werden.

Die folgenden Geräte unterstützen den Ersatz generischer Geräte, von Geräten ohne Typkennung und generischer Baugruppenträger:

  • GSD- und GSDML-Geräte - Alle GSD- und GSDML-Geräte mit GSD/GSDML-Baugruppenträgern.

  • MDD-basierte Geräte (keine GSD/GSDML-Geräte) - Geräte mit Systembaugruppenträger-Typkennungen.

Für die Verarbeitung generischer Baugruppenträger ist der CAx-Export nicht relevant. CAx exportiert immer Typkennungen für nicht-generische Baugruppenträger.

Für generische Geräte oder Geräte ohne Typkennung und mit generischem Baugruppenträger und Ersatz der Typkennung muss das Kopfmodul (bei dezentralen Geräten) oder der PLC (bei zentralen Geräten) in dem in der AML-Datei beschriebenen Baugruppenträger vorhanden sein, sonst werden Geräte ohne Typkennungen oder der Ersatz der Typkennung für generische Geräte und generische Baugruppenträger nicht verarbeitet.

Die folgende XML-Struktur zeigt eine GSDML-Gerätekonfiguration mit Gerät (mit Typkennung) und Baugruppenträger (mit Typkennung):

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

<InternalElement ID="bc3b50fa-5cfa-4bf3-a496-8e46080d4f86" Name="GSD device_1">

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

<Value>GSD:GSDML-V2.32-SIEMENS-SINAMICS_DCMASTER-20160531.XML/D</Value>

</Attribute>

<InternalElement ID="c80f2d97-66c9-4f31-bf6b-17e3e0de0509" Name="Rack">

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

<Value>Rack</Value>

</Attribute>

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

<Value>0</Value>

</Attribute>

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

<Value>false</Value>

</Attribute>

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

<Value>GSD:GSDML-V2.32-SIEMENS-SINAMICS_DCMASTER-20160531.XML/R/IDD_14</Value>

</Attribute>

<InternalElement ID="f519b4b9-b1f7-4011-bed2-25be85c8c2a8" Name="SINAMICS-DCMaster-CBE20">

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

<Value>SINAMICS DC MASTER CBE20 V1.1</Value>

</Attribute>

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

<Value>HeadModule</Value>

</Attribute>

Die folgende XML-Struktur zeigt eine GSDML-Gerätekonfiguration mit Gerät (ohne Typkennung) und Baugruppenträger (generische Typkennung):

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

<InternalElement ID="bc3b50fa-5cfa-4bf3-a496-8e46080d4f86" Name="GSD device_1">

<InternalElement ID="c80f2d97-66c9-4f31-bf6b-17e3e0de0509" Name="Rack">

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

<Value>Rack</Value>

</Attribute> 

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

<Value>0</Value>

</Attribute>

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

<Value>false</Value>

</Attribute>

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

<Value>System:Rack.Generic</Value>

</Attribute>

<InternalElement ID="f519b4b9-b1f7-4011-bed2-25be85c8c2a8" Name="SINAMICS-DCMaster-CBE20">

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

<Value>SINAMICS DC MASTER CBE20 V1.1</Value>

</Attribute>

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

<Value>HeadModule</Value>

</Attribute>

Die folgende XML-Struktur zeigt eine GSDML-Gerätekonfiguration mit Gerät (generische Typkennung) und Baugruppenträger (generische Typkennung):

Kopiert den nachfolgenden Programmcode in die Zwischenablage.

<InternalElement ID="bc3b50fa-5cfa-4bf3-a496-8e46080d4f86" Name="GSD device_1">

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

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

</Attribute>

<InternalElement ID="c80f2d97-66c9-4f31-bf6b-17e3e0de0509" Name="Rack">

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

<Value>Rack</Value>

</Attribute>

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

<Value>0</Value>

</Attribute>

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

<Value>false</Value>

</Attribute>

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

<Value>System:Rack.Generic</Value>

</Attribute>

<InternalElement ID="f519b4b9-b1f7-4011-bed2-25be85c8c2a8" Name="SINAMICS-DCMaster-CBE20">

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

<Value>SINAMICS DC MASTER CBE20 V1.1</Value>

</Attribute>

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

<Value>HeadModule</Value>

</Attribute>

</Attribute>

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

<Value>GSD:GSDML-V2.32-SIEMENS-SINAMICS_DCMASTER-20160531.XML/DAP/IDD_14</Value>

</Attribute>