FB_ShotScopeHmi

Implementiert die Handshake-Prozedur für das TF8550 ShotScope auf Seite der PLC.

	Erforderliche Installation auf dem Zielsystem Wenn Sie das ShotScope auf einem Zielsystem ohne Engineering ausführen möchten, müssen Sie zuvor die TF3300 Installation auf dem Zielsystem durchgeführt haben. Des Weiteren müssen sie auf Nicht-Beckhoff Geräten zusätzlich eine gültige TF3300 Scope Server Lizenz aktivieren. Eine Testlizenz funktioniert nur auf Beckhoff-Geräten mit einer gültigen BTN-Nummer.

Interne Funktionen:

Start und Stoppen einer Scope-Server Aufnahme auf dem Zielsystem.

Automatische Verwaltung der Dateierzeugung.

Kontrollierte Kommunikation mit dem HMI zur Absicherung gegen Datenverlust.
Selbstinitiierung, sofern die Klasse ohne FB_BaseRuntime zyklisch aufgerufen wird.

In diesem Betriebsfall ist auch ein Aufruf der CoreCyclic() nicht notwendig.

Syntax:

FUNCTION_BLOCK FB_ShotScopeHmi EXTENDS FB_HandshakeHmi

Handshake-Signal-Eigenschaften

Name	Typ	Zugriff	Initialwert	Beschreibung	PLC / HMI¹
Reset	BOOL	Get, Set	FALSE	Anfrage zur Reinitialisierung der Kommunikation.	HMI
FB_ShotScopeHmi
DataValidHmi	BOOL	Get, Set	FALSE	Rückmeldung vom HMI, dass die Server-Extension bereit ist.	HMI
DataValidPlc	BOOL	Get, Set	FALSE	Die Daten der PLC sind bereit verarbeitet zu werden.	PLC
HasNewRecord	BOOL	Get	FALSE	Eine Aufnahme wurde beendet und steht zur Verarbeitung durch die HMI bereit.	PLC
Lock	BOOL	Get, Set	FALSE	TRUE, während die HMI mit der Verarbeitung der letzten Aufnahme beschäftigt ist.	HMI
ShotNumber	ULINT	Get, Set	0	Schuss-Nr. (oder auch Produktionszyklus), der als Referenz für die Datenbank verwendet werden soll.	PLC
FB_HandshakeHmi
CompanionID	UINT	Get, Set	0	ID des aktuell verbundenen HMI-Companions.	HMI
LiveSignHMI	UINT	Get, Set	0	Wechselnder Wert des HMI-Clients zur Signalisierung einer aktiven Verbindung.	HMI

¹Die Spalte PLC/HMI beschreibt die Zuordnung des Schreibzugriffs.

Eigenschaften

Name	Typ	Zugriff	Initialwert	Beschreibung
Name	STRING	Get, Set	<SourceName>	Gibt den Namen der Klasseninstanz an.
FB_ShotScopeHmi
Analysis	I_ShotScopeAnalysis	Get	<Local>	Einstellungen für die Schuss-Analyse.
Busy	BOOL	Get	FALSE	Das Scope führt gerade einen Befehl aus und hat noch nicht angehalten.
ConfigFilePath	T_MaxString	Get, Set	FALSE	Pfad der .tcscopex-Konfigurationsdatei auf dem Zielsystem. Der Basispfad wird ebenfalls verwendet, um die Datenbank und die erzeugten Dateien abzulegen.
Done	BOOL	Get	FALSE	Die Scope-Aufnahme wurde erfolgreich gestoppt.
Error	BOOL	Get, (Set)	FALSE	Das Scope ist im Fehlerzustand.
ErrorID	UDINT	Get, (Set)	0	Fehlercode des letzten aufgetretenen Fehlers.
LogDetails	I_ShotScopeLogDetails	Get	<Local>	Zusätzliche Informationen, aufgezeichnet durch das HMI für jeden Schuss.
NetId	AMSNETID	Get, Set	[0,0,0,0,0,0]	AMS (ADS) Netzerkkennung des Systems, das den Scope-Server ausführt.
NetIdString	T_AmsNetID	Get, Set	‘‘	AMS (ADS) Netzwerkkennung des Systems, das den Scope-Server ausführt.
QualityMonitoring	I_ShotScopeQM	Get	<Local>	Überwachte Qualitätsparameter und potenziell angeforderte SPS-Eingriffe.
RecordFileName	T_MaxString	Get, Set	‘{ShotNumber}_Beckhoff‘	Stellt den Namen des aufgenommenen Schusses zur Verfügung. Nach erstmaliger Zuweisung kann und muss die Bezeichnung in der Applikation gebildet werden.
Recording	BOOL	Get	FALSE	Wenn TRUE, zeichnet das Scope zurzeit aktiv auf und ist bereit für die Aufnahme.
TimeLimit	LREAL	Get, Set	30.0 [s]	Die maximale Zeit, die eine Aufnahme andauert, bevor sie automatisch beendet wird.
[`PROTECTED`] _Name_	STRING	Get	<SourceName>	`_Name` ohne nachgestelltes ‚Hmi‘
FB_HandshakeHmi
CompanionTimeout	LREAL	Get, Set	5.0	Zeit nach der bei ausbleibendem Lebenzeichen der Companion als getrennt (nicht mehr verbunden) gewertet wird.
Disconnected	BOOL	Get	FALSE	Die Verbindung zum Companion ist getrennt.
FB_Base
BaseState	E_BaseState	Get	eNotHandled	Initialisierungszustand der Klasseninstanz.
Error	BOOL	Get	FALSE	Klasse befindet sich in einem Fehlerzustand.
ResultMessage	I_AppMessage	Get	-	Zugriff auf den Klassen-internen EventLogger.
[`PROTECTED`] _Name	STRING	Get	<SourceName>	`.Name` ohne führendes ‚fb‘.

¹Obsolete

Lokale HMI-Variablen

Name	Datentyp	Beschreibung
aCustomSettings	ARRAY[1..20] OF FB_ParameterHmi	Liste der konfigurierten benutzerspezifischen Einstellungen.
aCustomValues	ARRAY[1..20] OF FB_ParameterHmi	Liste der konfigurierten benutzerspezifischen Werte zur Qualitätsüberwachung.
fbAnalysis	FB_ShotScopeAnalysis	Einstellungen für die Schuss-Analyse.
fbLogDetails	FB_ShotScopeLogDetails	Zusätzliche Informationen für jeden Schuss.
fbQualityMonitoring	FB_ShotScopeQM	Überwachte Qualitätsparameter und potenziell angeforderte SPS-Eingriffe.

Methoden

Name	Beschreibung
Reset()	Setzt den Fehlerzustand der Klasse zurück.
FB_ShotScopeHmi
CoreCyclic()	Schnelle Zyklusmethode zur beschleunigten Reaktion auf die Kommandos innerhalb einer Sequenz.
Start(`bCommand`)	Startet die Aufzeichnung einer ShotScope-Aufnahme. Das Kommando war erfolgreich, sobald `Recording = TRUE` ist.
Stop(`bCommand`)	Stoppt die Aufzeichnung einer ShotScope-Aufnahme. Das Kommando war erfolgreich, sobald `Done = TRUE` ist.
FB_HandshakeHmi
Cyclic()	Zyklusmethode
FB_Base
GetHMI()	Gibt das zugewiesene HMI-Objekt zurück. In der FB_Base-Klasse ist die Methode nicht implementiert. Wird die Methode nicht durch Vererbung überschrieben, wird immer eine Pseudovariable zurückgegeben.
SetHMI(`ipBase`)	Allgemeine Zuweisungsmethode für eine `FB_BaseHmi` erweiternde Klasse als lokale HMI-Schnittselle. In der FB_Base-Klasse ist die Methode nicht implementiert. Wird die Methode nicht durch Vererbung überschrieben, schlägt diese immer fehl.
[`PROTECTED`] _IsMyself(`iCmp`)	Identifiziert, ob das übergebene Objekt der eigenen Instanz entspricht.
[`PROTECTED`] _QueryNamespace()	Extrahiert den ersten Teil des Instanz-Pfades als Objektnamensraum.
[`PROTECTED`] _QueryObjectName()	Extrahiert den letzten Teil des Instanz-Pfades als Objektnamen.

¹Ist obsolet

Schnittstellen

Typ	Beschreibung
I_Base	Standardschnittstelle auf FB_Base.
I_ShotScopeHmi	Standardschnittstelle auf FB_ShotScopeHmi.
I_TwoTaskInterface	Runtime Schnittstelle für zwei PLC-Tasks.
I_HandshakeHmi	Standardschnittstelle auf FB_HandshakeHmi
I_BaseDev	Deckt alle Methoden und Properties der Basisklasse ab.
I_Comparable	Ermöglicht Vergleiche per `_IsMyself()` oder F_IsSameInstance().

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken
TwinCAT 4026 >= v3.1.4026.19 TwinCAT 4024 >= v3.1.4024.71	PC oder CX (x64, x86)	Tc3_PlasticBaseApplication (>= v12.16.0.0)

Weiterführende Informationen