Attribute eines Subnetzes aufrufen

Attribute eines Subnetzes aufrufen - 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

Attribute eines Subnetzes aufrufen

Voraussetzung

Die TIA Portal Openness-Anwendung ist mit dem TIA Portal verbunden.

Siehe Verbindung zum TIA Portal aufbauen
Ein Projekt ist geöffnet.

Siehe Projekt öffnen

Einleitung

Ein Subnetz bietet bestimmte obligatorische Attribute, die gelesen und/oder geschrieben werden können. Die Attribute sind nur verfügbar, wenn sie in der UI verfügbar sind. Der Schreibvorgang ist im Allgemeinen nur dann zulässig, wenn ein Attribut auch vom Benutzer in der UI geändert werden kann. Dies kann je nach Subnetztyp variieren. Der Benutzer kann DpCycleTime nur dann festlegen, wenn IsochronousMode wahr und DpCycleMinTimeAutoCalculation falsch ist.

Attribute von Subnetzen vom Typ ASI

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r/w	modelliert	Name des Subnetzes.
NetType	NetType	r	modelliert	Typ des Subnetzes
SubnetId	String	r	dynamisch	Eindeutige Kennung des Subnetzes. Die S7-Subnetz-ID setzt sich aus zwei Zahlen zusammen, die durch einen Bindestrich voneinander getrennt werden. Eine Zahl für das Projekt und eine Zahl für das Subnetz, z. B. 4493-1.

Attribute von Subnetzen vom Typ Ethernet

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r/w	modelliert	Name des Subnetzes.
NetType	NetType	r	modelliert	Typ des Subnetzes
SubnetId	String	r/w	dynamisch	Eindeutige Kennung des Subnetzes. Die S7-Subnetz-ID setzt sich aus zwei Zahlen zusammen, die durch einen Bindestrich voneinander getrennt werden. Eine Zahl für das Projekt und eine Zahl für das Subnetz, z. B. 4493-1.
DefaultSubnet	Bool	r/w	dynamisch	Wahr, wenn das Subnetz ein Standardsubnetz ist. In einem Projekt ist höchstens ein Standardsubnetz vorhanden.

Attribute von Subnetzen vom Typ MPI

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r/w	modelliert	Name des Subnetzes.
NetType	NetType	r	modelliert	Typ des Subnetzes
SubnetId	String	r/w	dynamisch	Eindeutige Kennung des Subnetzes. Die S7-Subnetz-ID setzt sich aus zwei Zahlen zusammen, die durch einen Bindestrich voneinander getrennt werden. Eine Zahl für das Projekt und eine Zahl für das Subnetz, z. B. 4493-1.
HighestAddress	Int	r/w	dynamisch	Höchste MPI-Adresse am Subnetz.
TransmissionSpeed	BaudRate	r/w	dynamisch	Wahr, wenn das Subnetz ein Standardsubnetz ist. In einem Projekt ist höchstens ein Standardsubnetz vorhanden.

Attribute von Subnetzen vom Typ PC internal

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r	modelliert	Name des Subnetzes.
NetType	NetType	r	modelliert	Typ des Subnetzes
SubnetId	String	r	dynamisch	Eindeutige Kennung des Subnetzes. Die S7-Subnetz-ID setzt sich aus zwei Zahlen zusammen, die durch einen Bindestrich voneinander getrennt werden. Eine Zahl für das Projekt und eine Zahl für das Subnetz, z. B. 4493-1.

Attribute von Subnetzen vom Typ PROFIBUS

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r/w	modelliert	Name des Subnetzes.
NetType	NetType	r	modelliert	Typ des Subnetzes
SubnetId	String	r/w	dynamisch	Eindeutige Kennung des Subnetzes. Die S7-Subnetz-ID setzt sich aus zwei Zahlen zusammen, die durch einen Bindestrich voneinander getrennt werden. Eine Zahl für das Projekt und eine Zahl für das Subnetz, z. B. 4493-1.
HighestAddress	Int	r/w	dynamisch	Höchste PROFIBUS-Adresse am Subnetz.
TransmissionSpeed	BaudRate	r/w	dynamisch	Wahr, wenn das Subnetz ein Standardsubnetz ist. In einem Projekt ist höchstens ein Standardsubnetz vorhanden.
BusProfile	Busprofil	r/w	dynamisch	Das PROFIBUS-Profil.
PbCableConfiguration	Bool	r/w	dynamisch	Wahr, um zusätzliche PROFIBUS-Netzwerkeinstellungen zu aktivieren
PbRepeaterCount	Int	r/w	dynamisch	Anzahl der Repeater für Kupferleitung
PbCopperCableLength	double	r/w	dynamisch	Die Länge der Kupferleitung
PbOpticalComponentCount	Int	r/w	dynamisch	Anzahl der OLMs und OBTs von LWL-Leitung.
PbOpticalCableLength	double	r/w	dynamisch	Die Länge der LWL-Leitung für das PROFIBUS-Netzwerk in km.
PbOpticalRing	Bool	r/w	dynamisch	Wahr, wenn Busparameter für einen optischen Ring übernommen werden
PbOlmP12	Bool	r/w	dynamisch	Wahr, wenn OLM/P12 für die Berechnung des Busparameters aktiviert ist.
PbOlmG12	Bool	r/w	dynamisch	Wahr, wenn OLM/G12 für die Berechnung des Busparameters aktiviert ist.
PbOlmG12Eec	Bool	r/w	dynamisch	Wahr, wenn OLM/G12-EEC für die Berechnung des Busparameters aktiviert ist.
PbOlmG121300	Bool	r/w	dynamisch	Wahr, wenn OLM/G12-1300 für die Berechnung des Busparameters aktiviert ist.
PbAdditionalNetworkDevices	Bool	r/w	dynamisch	Wahr, wenn zusätzliche Busgeräte, die im Projekt nicht vorhanden sind, bei der Berechnung der Buszeiten berücksichtigt werden.
PbAdditionalDpMaster	Int	r/w	dynamisch	Anzahl der nicht konfigurierten DP-Master.
PbTotalDpMaster	Int	r	dynamisch	Gesamtanzahl der DP-Master
PbAdditionalPassiveDevice	Int	r/w	dynamisch	Anzahl der nicht konfigurierten DP-Slaves oder passiven Geräte.
PbTotalPassiveDevice	Int	r	dynamisch	Gesamtanzahl der DP-Slaves oder passiven Geräte.
PbAdditionalActiveDevice	Int	r/w	dynamisch	Anzahl der nicht konfigurierten aktiven Geräte mit FDL/FMS/S/-Kommunikationslast.
PbTotalActiveDevice	Int	r	dynamisch	Gesamtanzahl der aktiven Geräte mit FDL/FMS/S/-Kommunikationslast.
PbAdditionalCommunicationLoad	CommunicationLoad	r/w	dynamisch	Grobe Quantifizierung der Kommunikationslast
PbDirectDateExchange	Bool	r/w	dynamisch	Optimierung für direkten Datenaustausch.
PbMinimizeTslotForSlaveFailure	Bool	r/w	dynamisch	Minimierung für Zeitzuweisung für Slave-Fehler.
PbOptimizeCableConfiguration	Bool	r/w	dynamisch	Optimierung der Leitungskonfiguration.
PbCyclicDistribution	Bool	r/w	dynamisch	Wahr, wenn zyklische Verteilung der Busparameter aktiviert ist.
PbTslotInit	Int	r/w	dynamisch	Standardwert von Tslot.
PbTslot	Int	r	dynamisch	Warte-auf-Empfangszeit (slot time)
PbMinTsdr	Int	r/w	dynamisch	Minimale Dauer für die Protokollverarbeitung
PbMaxTsdr	Int	r/w	dynamisch	Maximale Dauer für die Protokollverarbeitung
PbTid1	Int	r	dynamisch	Leerlaufzeit 1
PbTid2	Int	r	dynamisch	Leerlaufzeit 2
PbTrdy	Int	r	dynamisch	Bereitschaftszeit
PbTset	Int	r/w	dynamisch	Einrichtungszeit
PbTqui	Int	r/w	dynamisch	Modulator-Ausklingzeit
PbTtr	int64	r/w	dynamisch	Der Ttr-Wert in t_Bit.
PbTtrTypical	int64	r	dynamisch	Mittlere Antwortzeit am Bus
PbWatchdog	int64	r/w	dynamisch	Ansprechüberwachung
PbGapFactor	Int	r/w	dynamisch	GAP-Aktualisierungsfaktor
PbRetryLimit	Int	r/w	dynamisch	Maximale Anzahl an Wiederholungen
IsochronousMode	Bool	r/w	dynamisch	Wahr, wenn konstante Buszykluszeit aktiviert ist.
PbAdditionalPassivDeviceForIsochronousMode	Int	r/w	dynamisch	Anzahl der zusätzlichen OPs/PGs/TDs usw., die in dieser Netzwerksicht nicht konfiguriert sind.
PbTotalPassivDeviceForIsochronousMode	Int	r	dynamisch	Summe der konfigurierten und nicht konfigurierten Geräte, z. B. OPs/PGs/TDs usw.
DpCycleMinTimeAutoCalculation	Bool	r/w	dynamisch	Wahr, wenn automatische Berechnung und Einstellung der kürzesten DP-Zykluszeit aktiviert sind.
DpCycleTime	double	r/w	dynamisch	Die DP-Zykluszeit.
IsochronousTiToAutoCalculation	Bool	r/w	dynamisch	Wahr, wenn automatische Berechnung und Einstellung der Werte IsochronousTi und IsochronousTo aktiviert sind.
IsochronousTi	double	r/w	dynamisch	Time Ti (Zeit zum Lesen von Prozesswerten)
IsochronousTo	double	r/w	dynamisch	Time To (Zeit zum Ausgeben von Prozesswerten)

Attribute von Subnetzen vom Typ PROFIBUS Integrated

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r/w	modelliert	Name des Subnetzes.
NetType	NetType	r	modelliert	Typ des Subnetzes
SubnetId	String	r/w	dynamisch	Eindeutige Kennung des Subnetzes. Die S7-Subnetz-ID setzt sich aus zwei Zahlen zusammen, die durch einen Bindestrich voneinander getrennt werden. Eine Zahl für das Projekt und eine Zahl für das Subnetz, z. B. 4493-1.
IsochronousMode	Bool	r	dynamisch	Konstante Buszykluszeit aktiviert.
DpCycleMinTimeAutoCalculation	Bool	r/w	dynamisch	Wahr, wenn automatische Berechnung und Einstellung der kürzesten DP-Zykluszeit aktiviert sind.
DpCycleTime	double	r/w	dynamisch	Die DP-Zykluszeit.
IsochronousTiToAutoCalculation	Bool	r/w	dynamisch	Wahr, wenn automatische Berechnung und Einstellung der Werte IsochronousTi und IsochronousTo aktiviert sind.
IsochronousTi	double	r/w	dynamisch	Time Ti (Zeit zum Lesen von Prozesswerten)
IsochronousTo	double	r/w	dynamisch	Time To (Zeit zum Ausgeben von Prozesswerten)

Attribute von Subnetzen vom Typ PROFIdrive Integrated

Attribut	Datentyp	Schreibbar	Zugriff	Beschreibung
Name	String	r/w	dynamisch	Name des Subnetzes
NetType	NetType	r	modelliert	Typ des Subnetzes
IsochronousMode	Bool	r	dynamisch	Konstante Buszykluszeit aktiviert
SourceCycleTime*	Int32	r/w	dynamisch	Die Zykluszeit der Busquelle
DpCycleTime	double	r/w	dynamisch	Die DP-Zykluszeit
IsochronousTiToAutoCalculation	Bool	r/w	dynamisch	Wahr, wenn automatische Berechnung und Einstellung der Werte Ti (Lesen von Prozesswerten) und To (Ausgeben von Prozesswerten) aktiviert sind.
IsochronousTi	double	r/w	dynamisch	Time Ti (Zeit zum Lesen von Prozesswerten)
IsochronousTo	double	r/w	dynamisch	Time To (Zeit zum Ausgeben von Prozesswerten)

*SourceCycleTime unterstützt die folgenden Enum-Werte:

Enum-Name	Wert
Manual	0
AutomaticMinimum	1
LocalSendClock	2
ProfinetSendClock	3

Programmcode

Um die Attribute eines Subnetzes abzurufen oder festzulegen, ändern Sie folgenden Programmcode:


SubnetOwner subnetOwner = ((IEngineeringServiceProvider)deviceItem).GetService<SubnetOwner>(); Subnet subnet = subnetOwner.Subnets[0]; string nameValue = subnet.Name; NetType nodeType = (NetType)subnet.NetType; string subnetId = ((IEngineeringObject)subnet).GetAttribute("SubnetId"); subnet.Name = "NewName"; subnet.SetAttribute("Name", "NewName"); bool isDefaultSubnet = ((IEngineeringObject)subnet).GetAttribute("DefaultSubnet");

SubnetOwner subnetOwner = ((IEngineeringServiceProvider)deviceItem).GetService<SubnetOwner>();

Subnet subnet = subnetOwner.Subnets[0];

string nameValue = subnet.Name;

NetType nodeType = (NetType)subnet.NetType;

string subnetId = ((IEngineeringObject)subnet).GetAttribute("SubnetId");

subnet.Name = "NewName";

subnet.SetAttribute("Name", "NewName");

bool isDefaultSubnet = ((IEngineeringObject)subnet).GetAttribute("DefaultSubnet");

Baud-Raten

Wert	Beschreibung
BaudRate.None	Die Baud-Rate ist unbekannt.
BaudRate.Baud9600	9,6 kBaud
BaudRate.Baud19200	19,2 kBaud
BaudRate.Baud45450	45,45 kBaud
BaudRate.Baud93700	93,75 kBaud
BaudRate.Baud187500	187,5 kBaud
BaudRate.Baud500000	500 kBaud
BaudRate.Baud1500000	1,5 MBaud
BaudRate.Baud3000000	3 MBaud
BaudRate.Baud6000000	6 MBaud
BaudRate.Baud12000000	12 MBaud

Busprofile

Wert	Beschreibung
BusProfile.None	Das Busprofil ist unbekannt.
BusProfile.DP	Der Typ des Netzwerks ist DP.
BusProfile.Standard	Der Typ des Netzwerks ist Standard.
BusProfile.Universal	Der Typ des Netzwerks ist Universal.
BusProfile.UserDefined	Der Typ des Netzwerks ist benutzerdefiniert.

Kommunikationslast

Wert	Beschreibung
CommunicationLoad.None	Keine gültige Kommunikationslast.
CommunicationLoad.Low	Typisch für DP, keine größere Datenkommunikation außer DP.
CommunicationLoad.Medium	Typisch für Mischbetrieb von DP und anderen Kommunikationsdiensten (z. B. S7-Kommunikation), wenn DP hohe Zeitanforderungen hat und bei mittlerem azyklischen Kommunikationsaufkommen.
CommunicationLoad.High	Für Mischbetrieb von DP und anderen Kommunikationsdiensten (z. B. S7-Kommunikation), wenn DP geringe Zeitanforderungen hat und bei hohem azyklischen Kommunikationsaufkommen.