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
SG-Projekt laden		0	[0, 1, 2] Anzeigewerte: 0: Vorhandenen Datensatz beibehalten 1: Immer neuen Datensatz verwenden 2: Gesamtes ASAP2-Projekt ersetzen	string	Legt fest, wie mit existierenden ASAP2-Projekten umgegangen werden soll. Diese Option ist relevant, wenn sich der Inhalt der Hex- oder A2L-Datei ändert, aber die Dateinamen gleich bleiben.
A2L- und HEX-Datei nicht an INCA übertragen	SG-Projekt laden: ‚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¶

Gibt die EPROM Id(EPK) der zugewiesenen ASAP2 zurück.

Rückgabewert

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

GetEPKfromDS¶

Gibt die EPROM Id(EPK) vom zugewiesenen Datensatz zurück.

Rückgabewert

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

GetEPKfromECU¶

Gibt die EPROM Id(EPK) der ECU zurück.

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 zu lesenden Größe
TypeInfo		‚SCALAR‘	[‚SCALAR‘, ‚VECTOR‘, ‚MATRIX‘, ‚CURVE‘, ‚MAP‘]	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 der zu schreibenden Größe
TypeInfo	‚SCALAR‘	[‚SCALAR‘, ‚VECTOR‘, ‚MATRIX‘, ‚CURVE‘, ‚MAP‘]	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	Die zu schreibenden 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