Port APPLICATION - Simulation¶

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Eigenschaften 🛈¶

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Gerätename		‚CCP:1‘		string	Name der Zugriffsschnittstelle
Gerätetyp		‚undefined‘		string	<System-Typ>.<Device-Typ> (z.B. „TS-Testsystem.ETK-Testdevice“). Punkte im Typ müssen mit Backslash geschützt werden. „undefined“ wenn ein schon vorhandenes Gerät mit dem angegebenen Namen verwendet werden soll.
A2L-Datei				string	Von diesem Port genutzte A2L-Datei. Wenn eine gleichnamige Datei mit der Endung .a2l.cod im selben Ordner existiert, wird sie gemeinsam mit der A2L-Datei an INCA übertragen.
Hex-Datei				string	Vom Port zu verwendende Hex-Datei
Automatisch aufzeichnen		☑		bool	Ist diese Option aktiviert, werden alle im Testfall gelesenen Messgrößen automatisch für die Aufnahme registriert.
Standardmessraster		‚Tool-Default‘		string	Angabe des Messrasters, das als Ausweichlösung verwendet wird, falls für den Testschritt kein Raster angegeben ist (‘*‘ und ‚?‘ können als Wildcard verwendet werden). „Tool-Default“führt zur Verwendung des Standardrasters des Tools
LAB-Datei				string	LAB-Datei, die dem INCA-Recorder hinzugefügt werden soll. Wenn die LAB-Datei bereits existiert, wird sie überschrieben.
Seitenaktualisierung		‚Auto (Ignition Off/On)‘	[‚Auto (Ignition Off/On)‘, ‚Full download‘, ‚Download differences‘, ‚Copy RP to WP‘, ‚No action‘]	string	Bestimmt das Verhalten wie die Seitenaktualisierung erfolgen soll.
Verstellwerte Setzen überprüfen		☑		bool	Rückgabewerte der INCA-API auswerten um das erfolgreiche Setzen zu prüfen. Ist die Option aktiviert und das Setzen war nicht erfolgreich wird ein Fehler erzeugt. Option deaktivieren falls z.B. bei Festkennfeldern Probleme auftreten
Verhalten bei vorhandenem Projekt		0	[0, 1, 2, 3, 4] Anzeigewerte: 0: Vorhandenen Datensatz mit gleichem Namen wie die HEX-Datei verwenden 1: Neuen Datensatz erstellen 2: Gesamtes ASAP2-Projekt ersetzen 3: Vorhandenen Datensatz ohne Überprüfung verwenden 4: Vorhandenes Projekt und Datensatz ohne Überprüfung verwenden	string	Legt fest, was verwendet wird, wenn ein Projekt oder Datensatz bereits vorhanden ist. Insbesondere relevant, wenn ein Projekt oder Datensatz den gleichen Namen wie die A2L- oder HEX-Datei hat, sich aber inhaltlich unterscheidet. Für mehr Informationen siehe Tools - ETAS: INCA - Hinweise zu „Verhalten bei vorhandenem Projekt“ .
A2L- und HEX-Datei nicht an INCA übertragen	Verhalten bei vorhandenem Projekt: ‚0‘	☐		bool	Falls ausgewählt, werden A2L- und HEX-Dateien nicht an INCA übertragen. Erfordert, dass Projekt und Datensatz in der INCA-Datenbank unter dem angegebenen Pfad und Dateinamen (ohne Erweiterung) vorhanden sind.
Harte Grenzen setzen		☑		bool	Dauerhaft anstelle der weichen Grenzen, harte Grenzen verwenden
Instanz des Transportlayers				string	Bezeichner der Transportlayer-Instanz (Optional).
Weitere Hardware-Optionen		‚{}‘		string	Expertenoption. Dictionary mit zusätzlichen Hardware-Optionen, z.B. {‚MeasureFailureBehavior‘: ‚2‘, ‚PageSwitch‘: ‚true‘, ‚ConnectionInterruptBehavior‘: ‚autoReinitializeAndDownload‘}. Erfordert INCA 7.2.6 oder neuer. Option ‚Instanz des Transportlayers‘ hat Vorrang vor Angabe ‚TransportLayer‘ hier. Siehe auch INCA API-Doku zu SetOption.
Verhalten beim Zurücksetzen		‚Wert bei Testbeginn‘	[‚Wert bei Testbeginn‘, ‚Wert von Referenzseite‘]	string	Legt fest, auf welchen Wert bei Aufruf des Testschritts „Zurücksetzen“ und bei automatischem Zurücksetzen zurückgesetzt wird.

Jobs 🛈¶

AutoDownloadWorkbase¶

AS/RS vom Datensatz automatisch ins Steuergerät laden

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
force		☐		bool	Herunterladen erzwingen (True/False)

CheckConnection¶

Gibt den aktuellen Verbindungsstatus zurück

ChecksumCodePage¶

Codeseite Prüfsummenabgleich

ChecksumDataPages¶

Arbeits- und Referenzseite Prüfsummenabgleich

CopyReferencePageToWorkingPage¶

Kopiere RS nach AS im Steuergerät

CreateDifferencesReport¶

Erstellt einen Report über die Unterschiede zwischen Arbeitsseite und Referenzseite im angegebenen Format unter dem angegebenen lokalen Pfad.

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
ignoreCdmErrors	☐		bool	Unkritische CDM-Toolbox-Fehler ignorieren und Reportdatei trotzdem erstellen.
reportFile			string	Lokaler Pfad der resultierenden Reportdatei.
reportFormat	‚HTML‘	[‚HTML‘, ‚ASCII‘]	string	Format, in dem die Reportdatei erstellt werden soll. Kann „HTML“ oder „ASCII“ sein.

DcmToHex¶

Erstellt aus der/den Dcm-Datei(en) ein neues DataSet für das Gerät und speichert dieses in der Hex-Datei. Achtung! Die Dateien dürfen NICHT im ToolLibTemp-Verzeichnis liegen.

Parameter

Name	Standardwert	Typ	Beschreibung
dcmFile		object	DCM-Datei(en) zur Verarbeitung
hexFile		string	Hex-Datei (Ausgabe)
ignoreCdmErrors	☐	bool	Gemeldete Fehler der CDM-Toolbox ignorieren und Hex trotzdem abholen.

DownloadDifferences¶

Kopiere Differenz AS/RS vom Datensatz ins Steuergerät

DownloadWorkbase¶

AS/RS vom Datensatz ins Steuergerät laden

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
force		☐		bool	Herunterladen erzwingen (True/False)

FlashHexFileWithControlFlow¶

Flasht das Steuergerät bei gestoppter Messung

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
ControlFlow			string	ControlFlow aus TGTSVR.log ohne Device und Hex-Datei
CopyFile	☐		bool	Falls „True“, wird die lokale Datei auf den Toolhost übertragen
FlashFile			uri	Optional: Dateiname und Pfad der zu flashenden Datei
FlashPort		[‚‘, ‚<online query>‘]	string	Optional: Alternativer Flash-Port

GetAquisitionRates¶

Liefert eine Liste aller Messraster

GetDeviceType¶

Gibt den Gerätetyp zurück

GetDifferencesCounter¶

Gibt die Anzahl der unterschiedlichen Einträge in den Datensätzen zurück.

GetEPKfromASAP2¶

Liest den EPROM-Identifier (EPK) aus dem zugewiesenen ASAP2-Projekt aus.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
EPK				string	String mit der ID

GetEPKfromDS¶

Liest den EPROM-Identifier (EPK) aus dem zugewiesenen Datensatz aus.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
EPK				string	String mit der ID

GetEPKfromECU¶

Liest den EPROM-Identifier (EPK) vom Steuergerät aus.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
EPK				string	String mit der ID

GetHwcState¶

Fragt einen Zustandswert aus dem Modul ‚HWC‘ ab

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
stateName			[‚BaudRate‘, ‚GetDifferencesCounter‘, ‚CheckOfState‘]	string	Name der abzufragenden Eigenschaft

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Zustandswert als String

GetLabels¶

Liefert eine Liste aller Größen

GetMemPageState¶

Fragt einen Zustandswert aus dem Modul ‚MEMORYPAGE‘ ab

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
stateName			[‚EPKfromDS‘, ‚EPKfromASAP2‘, ‚EPKfromECU‘, ‚CS_RP_Dataset‘, ‚CS_RP_ECU‘, ‚CS_WP_Dataset‘, ‚CS_WP_ECU‘]	string	Name der abzufragenden Eigenschaft

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				string	Zustandswert als String

GetSupportedFlashPortNames¶

Liefert die Namen unterstützter FlashPorts zurück

HexToHex¶

Erstellt auf Basis der HEX-Datei aus der Testkonfiguration ein neues DataSet mit dem Datensatz aus der angegebenen HEX-Datei. Die Dateien dürfen NICHT im ToolLibTemp-Verzeichnis liegen.Achtung, dieser Job funktioniert nicht mit INCA < 7.2.4!

Parameter

Name	Standardwert	Typ	Beschreibung
ignoreCdmErrors	☐	bool	Gemeldete Fehler der CDM-Toolbox ignorieren und Hex trotzdem abholen.
InputHexFile		string	HEX-Datei mit kompatiblen Datenstand
OutputHexFile		string	Hex-Datei (Ausgabe)

IsCalibrationPossible¶

Prüft ober der Kalibrierzugriff momentan möglich ist

IsTargetEcuOff¶

Gibt zurück, ob das Steuergerät ausgeschaltet ist (ab INCA 7.2.11)

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Off		☐		bool	True wenn ausgeschaltet, sonst False

ReadAllCalibrationsFromFile¶

Wendet alle in der angegebenen Datei enthaltenen Kalibrierwerte auf das Gerät an. Voraussetzungen: INCA 7.2.6 oder neuer, Messung gestoppt, Arbeitsseite aktiv.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
dcmFile				object	DCM-Datei (oder anderes unterstütztes Format), aus der die Kalibrierwerte gelesen werden sollen

ReadCalibration¶

Liest eine Kalibriergröße

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Name				string	Name der auszulesenden Größe. Verwendung: <Name>_[Index] für Array-Elemente und <Name>_[Zeile][Spalte] für Matrix-Elemente.
TypeInfo		‚SCALAR‘	[‚SCALAR‘, ‚VECTOR‘, ‚MATRIX‘, ‚CURVE‘, ‚MAP‘, ‚ARRAY_ELEMENT‘, ‚MATRIX_ELEMENT‘]	string	Variablentyp der Größe

ReadFromDataPage¶

Auslesen der Daten eines Speicherbereichs.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Length				int	Länge des zu lesenden Bereichs
StartAddress				int	Startadresse des zu lesenden Speicherbereichs

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result				object	Ausgelesene Daten als Tupel von vorzeichenbehafteten Integer-Werten

ReadMeasurement¶

Fügt die Messgröße dem Experiment hinzu und liest sie

Parameter

Name	Standardwert	Typ	Beschreibung
Name		string	Name der zu lesenden Größe
Raster		string	Name des Messrasters
SuppressErrors	☐	bool	Wenn True, führen Laufzeitfehler nicht zu einem ERROR im Report sondern es wird ~Not Present~ zurückgegeben.

ResetToReferencePage¶

Setzt die angegebenen Kalibriergrößen auf den Wert der Referenzseite zurück

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
Labels				object	Liste der zurückzusetzenden Labels

ResumeCyclicCommands¶

Nimmt das Senden von zyklischen Befehlen zum XCP-Slave wieder auf

SetAsyncBuffersToInvalid¶

Invalidiert asynchrone Messdatenpuffer für das Steuergerät (ab INCA 7.2.11)

SetStoreBit¶

Speicherbit setzen

StartTargetOS¶

Startet das SimulationOS

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result			[False, True]	bool	Bool

StopTargetOS¶

Stoppt das SimulationOS

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
result			[False, True]	bool	Bool

SuppressCyclicCommands¶

Unterdrückt das Senden von zyklischen Befehlen zum XCP-Slave

SwitchToReferencePage¶

Wechsel zur Referenzseite

SwitchToWorkingPage¶

Wechsel zur Arbeitsseite

UploadWorkbase¶

Arbeitsseite und Referenzseite hochladen

WriteCalibration¶

Ändert den Wert einer Kalibriergröße

Parameter

Name	Standardwert	Gültige Werte	Typ	Beschreibung
Data			string	zu schreibende Daten
Name			string	Name des zu schreibenden Werts. Verwendung: <Name>_[Index] für Array-Elemente und <Name>_[Zeile][Spalte] für Matrix-Elemente.
TypeInfo	‚SCALAR‘	[‚SCALAR‘, ‚VECTOR‘, ‚MATRIX‘, ‚CURVE‘, ‚MAP‘, ‚ARRAY_ELEMENT‘, ‚MATRIX_ELEMENT‘]	string	Variablentyp der Größe

WriteToDataPage¶

Schreiben von Daten in den angegebenen Speicherbereich.

Parameter

Name	Typ	Beschreibung
Length	int	Menge der zu schreibenden Bytes
StartAddress	int	Startadresse, an die geschrieben wird
Values	ByteStream	Zu schreibende Daten als ByteStream

WriteWorkpageToFile¶

Erstellt aus der aktuellen Arbeitsseite eine Hex-Datei. Achtung! Die Zieldatei darf NICHT im ToollibTemp-Verzeichnis liegen.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
hexFile				string	Hex-Datei zur Verarbeitung