Konfiguration von CCDX-Transferbereichen ändern

Konfiguration von CCDX-Transferbereichen ändern - 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

Konfiguration von CCDX-Transferbereichen ändern

Voraussetzung

TIA Portal ist mit TIA Portal Openness verbunden
Siehe Verbindung zum TIA Portal aufbauen.
Ein Projekt ist geöffnet.
Siehe Öffnen eines Projekts

Einleitung

Sie können mit TIA Portal Openness die Konfiguration von CCDX-Transferbereichen ändern. In Openness können Sie über NetworkInterface als TransferAreaMulticastableComposition-Objekte, die alle Transferbereiche derselben Schnittstelle derselben PLC enthalten, auf Transferbereiche zugreifen.

Hierbei bezieht sich "multicastable" bzw. Multicastfähigkeit auf eine Eins-zu-viele-Beziehung, bei der ein Sendetransferbereich Informationen an mehrere Partner-Empfangstransferbereiche übertragen kann. In der Gegenrichtung kann ein Empfangstransferbereich jedoch nur mit einem Sendepartner (z B. dem CCDX-Transferbereich) kommunizieren.

Eigenschaft

Name der Eigenschaft	Datentyp	Beschreibung	Zugriff
Address	AddressComposition	Ruft Adressinformationen wie Anfangsadresse, Länge, IoType usw. eines Transferbereichs vom Typ Siemens.Engineering.HW.Address ab	Lesen/Schreiben
Parent	IEngineeringObject	Ruft das übergeordnete EOM-Element eines Transferbereichs ab	Schreibgeschützt
Comment	String	Ruft die Eigenschaft Comment eines Transferbereichs ab	Lesen/Schreiben
Direction	TransferAreaDirection	Ruft die Eigenschaft Direction eines Transferbereichs vom Typ TransferAreaDirection ab. Gibt an, dass die Kommunikationsrichtung davon abhängt, ob der Transferbereich Sender oder Empfänger ist.	Schreibgeschützt
DataLength	Int	Ruft die Datenlänge (z.B. Adresslänge) eines Transferbereichs ab bzw. stellt diese ein	Lesen/Schreiben
Name	String	Ruft die Eigenschaft Name eines Transferbereichs ab	Lesen/Schreiben
PartnerTransferAreas	MulticastableTransferAreaAssociation	Ruft die Partner-Transferbereiche eines multicastfähigen Transferbereichs für zum Beispiel CCDX ab Beispielsweise enthält der Sendetransferbereich einen oder mehrere Empfangstransferbereiche auf einem oder mehreren Partnergeräten. Ein Sendetransferbereich kann mehrere Empfangspartner haben. Sowohl ein Sende- als auch ein Empfangstransferbereich müssen mindestens einen Partner haben; sie können nicht einzeln vorhanden sein. Daher müssen beim Löschen eines Sendetransferbereichs auch alle zugehörigen Empfangspartner gelöscht werden. Wenn weitere Empfangspartner vorhanden sind, hat das Löschen eines Empfangstransferbereichs dagegen nicht zwangsläufig die Löschung seines Sendepartners zur Folge.	Schreibgeschützt
Type	TransferAreaType	Ruft die Eigenschaft Type eines Transferbereichs vom Typ TransferAreaType ab. Ein multicastfähiger Transferbereich kann folgenden Enum-Wert aufweisen: TransferAreaType.DDX wobei sich DDX auf den Transferbereichstyp 'CCDX' für die Kommunikation über direkten Datenaustausch bezieht.	Schreibgeschützt
MulticastableTransferAreas	MulticastableTransferAreaComposition	Ruft die Eigenschaft MulticastableTransferAreas der Netzwerkschnittstelle ab. Enthält multicastfähige Transferbereiche (z. B für CCDX-Transferbereiche) einer Netzwerkschnittstelle. Dabei kann es sich sowohl um Sende- als auch um Empfangstransferbereiche handeln.	Schreibgeschützt

Attribut	Datentyp	Beschreibung	Zugriff
TransferUpdateTime	Int32	Aktualisierungszeit für die Übertragung des Providerelements (Sender)	Schreibgeschützt

Programmcode


private void ModifyingCCDXTransferArea() { // Given the selected NetworkInterface NetworkInterface networkInterface = ...; // Navigate to the desired MulticastableTransferArea string transferAreaName = "Example_CCDX_TA"; MulticastableTransferArea transferArea = networkInterface.MulticastableTransferAreas.FirstOrDefault(item => item.Name == transferAreaName); // Properties Propertis properties = transferArea.Properties; // Address Address address = transferArea.Address; // Parent IEngineeringObject parent = transferArea.Parent; // Comment string comment = transferArea.Comment; // Direction TransferAreaDirection direction = transferArea.Direction; // Name string name = transferArea.Name; // PartnerTransferAreas MulticastableTransferAreaAssociation partnerTransferAreas = transferArea.PartnerTransferAreas; // TransferUpdateTime int transferUpdateTime = (int)transferArea.GetAttribute("TransferUpdateTime"); // Type TransferAreaType type = transferArea.Type; // DataLength transferArea.DataLength = 12; }

private void ModifyingCCDXTransferArea()

{

// Given the selected NetworkInterface

NetworkInterface networkInterface = ...;

// Navigate to the desired MulticastableTransferArea

string transferAreaName = "Example_CCDX_TA";

MulticastableTransferArea transferArea = networkInterface.MulticastableTransferAreas.FirstOrDefault(item => item.Name ==

transferAreaName);

// Properties

Propertis properties = transferArea.Properties;

// Address

Address address = transferArea.Address;

// Parent

IEngineeringObject parent = transferArea.Parent;

// Comment

string comment = transferArea.Comment;

// Direction

TransferAreaDirection direction = transferArea.Direction;

// Name

string name = transferArea.Name;

// PartnerTransferAreas

MulticastableTransferAreaAssociation partnerTransferAreas = transferArea.PartnerTransferAreas;

// TransferUpdateTime

int transferUpdateTime = (int)transferArea.GetAttribute("TransferUpdateTime");

// Type

TransferAreaType type = transferArea.Type;

// DataLength

transferArea.DataLength = 12;

}