Port APPLICATION - DEFAULT 🛈¶

Applikationszugriff

Stimulation¶

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Besonderheiten¶

Erstkonfiguration

Es ist darauf zu achten, dass die Eigenschaften ECUCPort-Konfigurationsdatei und ECUMPort-Konfigurationsdatei gesetzt sind. Alle weiteren Optionen sind optional. Normalerweise werden die verfügbaren Signale per API direkt vom Tool abgefragt, sodass es ausreicht, nur eine ECU in der Testkonfiguration einzurichten, ohne eine *.a2l oder *.hex Datei anzugeben.

Eigenschaften 🛈¶

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
ECUCPort-Konfigurationsdatei				string	Pfad zur Konfigurationsdatei des XIL-API-ECUC-Ports auf dem Toolhost. Entweder als absolute Pfadangabe oder relativ zum Modellverzeichnis anzugeben.
ECUCPort Konfigurationsparameter überschreiben		‚<keine>‘		string	Ermöglicht das Überschreiben von Konfigurationsparametern des Ports in der angegebenen Konfigurationsdatei. Der Parameterpfade, inkl. der neue Werte müssen im JSON-Format angegeben werden., z.B. \‘{„sample.path“: value}\‘. Die zu überschreibenden Parameterpfade müssen bereits in der Konfigurationsdatei des Ports definiert sein.
ECUMPort-Konfigurationsdatei				string	Pfad zur Konfigurationsdatei des XIL-API-ECUM-Ports auf dem Toolhost. Entweder als absolute Pfadangabe oder relativ zum Modellverzeichnis anzugeben.
ECUMPort Konfigurationsparameter überschreiben		‚<keine>‘		string	Ermöglicht das Überschreiben von Konfigurationsparametern des Ports in der angegebenen Konfigurationsdatei. Der Parameterpfade, inkl. der neue Werte müssen im JSON-Format angegeben werden., z.B. \‘{„sample.path“: value}\‘. Die zu überschreibenden Parameterpfade müssen bereits in der Konfigurationsdatei des Ports definiert sein.
A2L-Datei				string	Zu verwendende A2L-Datei. A2L-Dateien, die möglicherweise in den Portkonfigurationsdateien referenziert sind, werden ignoriert. Die Datei wird automatisch an den Toolhost übertragen.
HEX-Datei				string	Zur A2L-Datei zugehörige Image-Datei. HEX-Dateien, die möglicherweise in den Portkonfigurationsdateien referenziert sind, werden ignoriert. Die Datei wird automatisch an den Toolhost übertragen.
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
Standardmessraster für Aufnahme erzwingen		☐		bool	Das als Standardmessraster hinterlegte Raster wird bei der Aufnahme für alle Größen erzwungen.
Aufnahmeformat		MF4	[CSV, MDF, MF4]	string	Dateiformat der Aufzeichnung
Trennzeichen	Aufnahmeformat: ‚CSV‘	‚;‘	[‚;‘, ‚,‘]	string	Trennzeichen der CSV-Datei
Aufnahme-Downsampling-Rate		<default>		int	Definiert nach wie vielen Samples der Signalwert in der Aufzeichung persistiert wird. Ist „<default>“ gewählt, wird die Downsamplig-Rate nicht explizit gesetzt - Standardeinstellung des Herstellers wird verwendet.
Timeout beim Aufnahmestart ❲s❳		30		int	Maximal zulässige Zeit nach dem manuellen Starten der Aufnahme, bis das Tool die Aufnahme tatsächlich gestartet hat.
Kalibrierzugriff		‚Automatic‘	[‚Automatic‘, ‚Manual‘]	string	Automatic: Aktiviert den Kalibrierzugriff automatisch bei Konfigurationsstart. Manual: Kalibrierzugriff muss über ToolJobs aktiviert und deaktiviert werden.
Richtung des Datentransfers		‚Download‘	[‚Download‘, ‚Upload‘]	string	Gibt die Richtung des Datentransfers bei der Aktivierung des Kalibrierzugriffs an. Download: Schreibt den Inhalt der aktuellen Speicherseite auf das Steuergerät. Upload: Liest den den Inhalt der aktuellen Speicherseite von dem Steuergerät.
Messungsstart		‚Automatic‘	[‚Automatic‘, ‚Manual‘]	string	Automatic: Messungsstart automatisch bei Teststart. Manual: Messungsstart /-stop über ToolJobs
Online-a2l-Abfrage-Unterstützung		☑		bool	(De-)Aktiviert die Schnittstelle zur Online-Abfrage von a2l-Informationen durch die Testkonfiguration.
Matrix-Layout anpassen	Online-a2l-Abfrage-Unterstützung	☐		bool	Konvertierung von Matrizen vom Zeilenlayout (XIL) in das Spaltenlayout (ecu.test). Im Gegensatz zu ASAM XIL, welches das zeilenbasierte Layout zur Speicherung von Matrizen implementiert, verwendet ecu.test das Spaltenlayout. Bei gesetzter Option werden Matrizen beim Einlesen und vor der Nutzung in ecu.test an das interne Spaltenlayout angepasst. Dies hat zur Folge, dass Matrizen korrekt dargestellt werden und Indizierungen konsistent nach dem Schema [Spalte][Zeile] erfolgen. Bei nicht gesetzter Option bewirkt die fehlende Anpassung des Layouts, dass mit der transponierten Matrix gearbeitet wird (siehe z.B. Darstellung im Report). Eine Indizierung der transponierten Matrix gemäß dem obigen Schema in ecu.test ist damit äquivalent zur Indizierung der (nicht transponierten) Originalmatrix mittels des Schemas [Zeile][Spalte] aus Sicht des Tools. Eine nicht gesetzte Option entspricht dem Bestandsverhalten. Es wird empfohlen diese für neue Testfälle zu setzen.

Jobs 🛈¶

CalculateReferencePageCRC¶

Gibt die Prüfsumme der Referenzseite als Zahlenwert zurück.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
WorkPageChecksum				string	Prüfsumme der Referenzseite

CalculateWorkPageCRC¶

Gibt die Prüfsumme der Arbeitsseite als Zahlenwert zurück.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
RefPageChecksum				string	Prüfsumme der Arbeitsseite

GetCalibrationConfigState¶

Gibt den aktuellen Zustand des angegebenen Konfigurationsparameters zurück. Der Parameter muss als vollständiger Pfad angegeben werden.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
configParam				string	Pfad des Konfigurationsparameters innerhalb der Konfigurationsdatei des Ports, z.B. „sample.path.value“.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
return				string	Wert des Konfigurationsparameters

GetMeasurementConfigState¶

Gibt den aktuellen Zustand des angegebenen Konfigurationsparameters zurück. Der Parameter muss als vollständiger Pfad angegeben werden.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
configParam				string	Pfad des Konfigurationsparameters innerhalb der Konfigurationsdatei des Ports, z.B. „sample.path.value“.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
return				string	Wert des Konfigurationsparameters

GetNumberOfPages¶

Gibt die Anzahl der Seiten zurück, die vom MC-System unterstützt werden.

Rückgabewert

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
NumberOfPages				string	Anzahl der Seiten, die vom MC-System unterstützt werden.

StartMeasurement¶

Startet die Messung.

StartOnlineCalibration¶

Aktiviert den Kalibrierzugriff.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
LoadingDirection		‚Download‘	[‚Download‘, ‚Upload‘]	string	Gibt die Richtung des Datentransfers bei der Aktivierung des Kalibrierzugriffs an. Download: Schreibt den Inhalt der aktuellen Speicherseite auf das Steuergerät. Upload: Liest den den Inhalt der aktuellen Speicherseite von dem Steuergerät.

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

LoadingDirection

‚Download‘

[‚Download‘, ‚Upload‘]

string

Gibt die Richtung des Datentransfers bei der Aktivierung des Kalibrierzugriffs an.

Download: Schreibt den Inhalt der aktuellen Speicherseite auf das Steuergerät.

Upload: Liest den den Inhalt der aktuellen Speicherseite von dem Steuergerät.

StopMeasurement¶

Stoppt die Messung.

StopOnlineCalibration¶

Deaktiviert den Kalibrierzugriff.

SwitchToRefPage¶

Wechselt zur Referenzseite.

SwitchToWorkPage¶

Wechselt zur Arbeitsseite.

TriggerClientEvent¶

Fügt ein Ereignis in alle laufenden Aufzeichnungen des Ports ein.

Parameter

Name	Verfügbar wenn	Standardwert	Gültige Werte	Typ	Beschreibung
description				string	Beschreibung des Ereignisses (frei wählbar).
eventId		0		int	ID des Ereignisses (frei wählbar). Bereich gültiger Werte: 0-18446744073709551615.