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= OpState

  • 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
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.