Interne Datenpunkte des S7Plus-Treibers

In diesem Kapitel werden die internen Datenpunkte des S7 Plus Treibers beschrieben.

Für jede Verbindung des S7Plus-Treibers wird ein interner Datenpunkt vom Typ _S7PlusConnection angelegt. Der Name der Datenpunkte entspricht dem Verbindungsnamen. Zusätzlich steht der interne Datenpunkt _S7PlusConfig zur Verfügung, auf dem Subscriptions sowie deren Konfiguration gespeichert werden.

_S7PlusConfig

Von diesem internen Datenpunkttyp existiert nur eine Instanz mit Namen "_S7PlusConfig". Dieser Datenpunkt gilt für alle Verbindungen aller S7Plus-Treiber und beinhaltet alle Subscriptions, die Einstellung der Subscriptions und den Subscriptions zugehörige Pollgruppen.


Datenpunktelement	Datentyp	Beschreibung
Subscriptions.Names	dyn_string	Namen der Subscriptions
Subscriptions.Pollgroups	dyn_string	Namen der Pollgruppen die den Subscriptions zugeordnet sind.
Subscriptions.Options	dyn_string	onlyChanges 0 /1
PublicKey	string	Beinhaltet den Public Key der beim Erstellen eines S7Plus-Zertifikates generiert wird. Hinweis Per Default können nur Benutzer mit Berechtigungsbit 4 auf diesen Datenpunkt schreiben.

_S7PlusConnection

Beim Erstellen jeder Verbindung wird automatisch ein interner Datenpunkt _<Verbindungsname> vom Typ _S7PlusConnection angelegt. Der Name der Verbindung muss im System daher eindeutig sein.


Datenpunktelement	Typ	Beschreibung
Config.Address	string	IP-Adresse der S7Plus-SPS
Config.Codepage	uint	Definiert wie String-Variablen vom Treiber kodiert werden sollen. Die Kodierung wird per Konfigurationspanel - Erweitert durchgeführt. Der hier angegebene Wert entspricht dem entsprechenden MIBenum von < wincc_oa_path >/nls/lang.dir.
Config.AccessPoint	string	Der für die Verbindung festgelegte Access Point: S7ONLINE ...
Config.PLCType	uint	Gibt den gewählten SPS-Typ für die Verbindung an. Folgende SPS-Typen sind verfügbar (die Zahlen in der Klammer entsprechen den intern verwendeten Konstanten): S7-1200 (=272) S7-1500 (=16) S7-1500 SoftCtrl (=528) PLCSim (768) Per Default ist der SPS-Typ S7-1200 eingestellt.
Config.Password	blob	Beinhaltet das Passwort, das bei bestimmten Schutzstufen benötigt wird, um die Verbindung zu legitimieren. Das Passwort muss über die Registerkarte "Erweitert" des Konfigurationspanels eingegeben werden! Hinweis Per Default können nur Benutzer mit Berechtigungsbit 4 auf diesen Datenpunkt schreiben.
LegitimationLevel	int
Config.ConnType	uint	Zeigt den Typ der Verbindung an: 0 = Single 1 = ReduLan
Config.KeepAliveTimeout	uint	Keep Alive Timeout in Sekunden. Defaultwert = 20
Config.ReconnectTimeout	uint	Reconnect-Intervall in Sekunden. Nach Verbindungsverlust versucht der Treiber in den definierten Zeitintervallen die Verbindung wiederherzustellen. Defaultwert = 20
Config.EstablishmentMode	uint	Legt fest ob die Verbindung hergestellt wird oder nicht. 0 = inactive 1 = AutomaticActive
Config.SetInvalidBit	bool	Definiert für alle Eingangs- bzw. Ein- und Ausgangsadressen ob das Invalid-Bit bei Verbindungsverlust gesetzt werden soll.
Config.TimeSyncMode	uint	Legt fest ob die SPS mit der Zeit des WinCC OA-Servers synchronisiert werden soll. 0 = Inactive 1 = Sync PLC to WinCC OA
Config.Timezone	int	Definiert den Timezone-Offset in Minuten, der zur Lokalzeit addiert werden soll. Default = 0
Config.TimeSyncInterval	uint	Intervall (in Sekunden) in dem die SPS-Zeit synchronisiert werden soll. Default = 86400
Config.UseUTC	bool	Gibt an ob die UTC verwendet werden soll. 0 = Local Time (Plus Timezone-Offset) 1 = UTC (Default)
Config.AcquireValuesOnConnect	bool	Definiert ob bei Verbindungsaufbau mit der SPS eine Generalabfrage durchgeführt wird. Default = TRUE
Config.EnableStatistics	bool	Aktiviert das Erfassen von statistischen Informationen. Default = TRUE
Config.ReadOpState	bool	Aktiviert das Auslesen des SPS Betriebszustands
Config.StationName	string	Beinhaltet den Stationsnamen des gebrowsten Projekts im Format <Projekt>\|<Station>
Config.DrvNumber	uint	Treibernummer im WinCC OA Projekt
Config.CheckConn	bool	Dieses Element wird intern zum Verbindungsaufbau verwendet.
Config.ReduConnection.Address	string	IP-Adresse der redundanten Verbindung
Config.ReduConnection.AccessPoint	string	Der, für die redundante Verbindung festgelegte, Access Point: S7ONLINE ...
Config.ReduConnection.SwitchCondition	uint	Legt fest, wann eine Verbindungsumschaltung durchgeführt wird. 0 = Disabled 1 = Reserved 2 = ConnState 3 = OpState & Connstate 4 = SwitchTag
Config.ReduConnection.SwitchTag	string	Symbolischer Tagname einer boolschen PLC-Variable zum Triggern einer Verbindungsumschaltung. Hinweis: Nur relevant, wenn "SwitchTag" als Umschaltkriterium festgelegt wurde.
Config.AlarmMode	uint
Config.FullTextAlarms	bool
DisplayClassFilter	string
Command.Enable	bool	Aktivieren/Deaktivieren der Verbindung.
Command.GQ	bool	Auslösen der General Query
Command.IGQ	bool	Auslösen einer inversen General Query, d.h. Schreiben aller Ausgangsadressen.
Command.DoSwitchover	bool	Manuelles Umschalten zur aktuell passiven Verbindung
Command.AlarmGQ	bool
Common.State.ConnState	int	Gibt den allgemeinen Verbindungsstatus zum Gerät an. Die Bedeutung der Werte finden Sie unter Allgemeiner Verbindungsstatus.
State.ConnState	uint	Zeigt den aktuellen Verbindungszustand. 0 = Inactive 1 = Disconnected 2 = Connecting 3 = Connected 4 = Disconnecting 5 = Failure
.Config.EnableDiagnostics	bool	Legt fest ob die S7 Channel Diagnostik verwendet werden soll.
.State.Diagnostics.Communication.Subscriptions	dyn_int	[0] .. free subscriptions [1] .. free subscription attributes (analogous to SystemLimits)
.State.Diagnostics.Communication.FreeConnections	uint	Freie HMI-Verbindungen.
.State.Diagnostics.Communication.LoadPct	uint	Kommunikationslast in Prozent.
.State.Diagnostics.ProgramExec.LoadPct	uint	Auslastung der SPS bei Programmausführung in Prozent.
.State.Diagnostics.ProgramExec.LastCycle	time	Letzte Zyklusdauer
.State.Diagnostics.ProgramExec.MaxCycle	time	Maximale Zyklusdauer
.State.Diagnostics.ProgramExec.MinCycle	time	Minimale Zyklusdauer
.State.Diagnostics.ProgramExec.MaxCycleConfig	time	Konfigurierte maximale Zyklusdauer
.State.Diagnostics.ProgramExec.MinCycleConfig	time	Konfigurierte minimale Zyklusdauer
State.DrvType	string	Zeigt den Treibertyp im Format <driver type>:<driver number> an. Z.B.: S7Plus:1
State.Disabled	bool	Zeigt den vom Treiber erkannten Aktivierungsstatus, z.B. Command.Enable = 1, State.Disabled = 0
State.ActiveConn	int	Index der aktuell aktiven Verbindung zur SPS. -1 = Keine aktive Verbindung 0 = Verbindung 1 1 = Verbindung 2
State.Connections.State	dyn_uint	Auf diesem Element wird der aktuelle Verbindungsstatus der einzelnen Verbindungen (1 und 2) angezeigt. 0 - Logged out 1 - Logging in 2 - Logged in 3 - Logging out
State.Connections.OpState	dyn_uint	Auf diesem Element wird der aktuelle SPS-Betriebszustand der einzelnen Verbindungen angezeigt. 4 - Stop 6 - Startup 8 - Run 9 - RunRedundant 18 - Run ODIS
State.Connections.PLCTime	dyn_time	Zeigt die aktuelle Zeit der SPS an.
State.Connections.LegitimationLevel	dyn_int	Dieses Element zeigt den Legitimation Level der jeweiligen Verbindung an. -1 = Invalid 0 = Failsafe 1 = Full 2 = Read/Write 3 = Read 4 = Inactive
State.Connections.AlarmState	dyn_uint
State.GeneralInfo.SystemVersion	string	Systemversion der verbundenen SPS.
State.GeneralInfo.SystemLimits	dyn_int	Durch die verbundene SPS vorgegebene Systemlimits.
State.Statistics.ReadsSent	float	Die Anzahl der angeforderten Werte seit dem Start des Treibers.
State.Statistics.ReadsRecv	float	Die Anzahl der Werte, empfangen auf Grund von Leseanforderungen, seit dem Start des Treibers.
State.Statistics.ReadsRej	float	Die Anzahl der abgelehnten Leseanforderungen seit dem Start des Treibers.
State.Statistics.WritesSent	float	Die Anzahl der Anforderungen, einen Wert zu schreiben, seit dem Start des Treibers.
State.Statistics.WritesRecv	float	Die Anzahl der bestätigten Schreibaufträge seit dem Start des Treibers.
State.Statistics.WriteRej	float	Die Anzahl der abgelehnten Schreibaufträge seit dem Start des Treibers.
State.Statistics.Unsolicited	float	Die Anzahl der spontan übertragenen Werte seit dem Start des Treibers.
State.Statistics.ReadsPerSec	float	Die Anzahl der pro Sekunde empfangenen Werte, gemessen im letzten statistischen Intervall. Der Wert bezieht sich auf Daten, welche aufgrund von Leseanforderungen empfangen wurden.
State.Statistics.WritesPerSec	float	Die Anzahl der Schreibaufträge pro Sekunde, gemessen im letzten statistischen Intervall.
State.Statistics.UnsolicitedPerSec	float	Die Anzahl der spontan übertragenen Werte, gemessen im letzten statistischen Intervall.
State.Statistics.AlarmsRecv	float
State.Statistics.AlarmsAckSent	float
State.Statistics.AlarmsPerSec	float
Browse.GetBranch	dyn_string	Startinformation zum Browsen des TIA-Projekts.
Browse.NodePaths	dyn_string	Browse-Ergebnis, welches folgendes beinhalten kann: Auflistung der S7DOS Access Points Auflistung des TIA-Projekt-Exports Auflistung der S7Plus-Stationen in einem TIA-Projekt-Export SPS-Typ der ausgewählten Station Auflistung von Datenbausteinen & Variablen in einer S7Plus-Station Auflistung von Datentypen & Variablen
Browse.NodeComments	dyn_langString	Mehrsprachige Kommentare im Browse-Ergebnis (z.B. von Variablen oder Bausteinen). Hinweis: Damit die Kommentare korrekt ausgelesen werden, müssen die Sprachen im TIA-Projekt und WinCC OA-Projekt übereinstimmen. Die Sprachen im TIA-Projekt können über "Tools - Project languages" definiert werden.
Browse.SystemTypes	dyn_string	Typ der Einträge vom Browse-Ergebnis Projekt Station Variable
Browse.ValueTypes	dyn_string	Detaillierte Variablentypen wenn der Systemtyp "Variable" ist.
Browse.ItemLengths	dyn_int	Zeigt -1 für alle Werttypen und die Anzahl der Elemente für Strings, Arrays und Strukturen.
Browse.RequestId	string	Request-ID vom Browse-Ergebnis. Wird benötigt, wenn von mehreren User Interfaces auf diesen internen Datenpunkt zugegriffen wird.