Port DEBUGGER - DEFAULT

Stimulation

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Core

string

Index oder Name des Cores, auf den zugegriffen werden soll. Falls nicht angegeben, wird automatisch der Mastercore geladen.

ELF-Datei

uri

Lokaler Pfad zu der zu ladenden ELF-Datei (relativ zum Workspace). Wird bei <auto> aus der Testkonfiguration übernommen

HEX-Datei

uri

Lokaler Pfad zu der zu ladenden HEX-Datei (relativ zum Workspace). Wird bei <auto> aus der Testkonfiguration übernommen

HSM-Core flashen

☐

bool

Gibt an ob beim Flashen ein vorhandener HSM-Core ebenfalls geflasht werden soll.

Break

Unterbricht die Ausführung

DumpMemoryToHex

Schreibt einen Speicherbereich in eine Hex-Datei und überträgt sie auf den ecu.test-Rechner

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Address

int

Anfangsadresse des zu lesenden Bereichs

Count

int

Anzahl der zu lesenden Bytes

Filename

uri

Pfad der zu speichernden Hex-Datei auf dem ecu.test-Rechner

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

Speichervorgang erfolgreich

EraseChip

Führt die Erase-Funktion des Chips aus

EraseConfig

Löscht die Konfiguration auf dem Target

EraseSector

Löscht einen Sektor

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

sectorIndex

int

Dieser Sektor (Zählung beginnend mit 0) wird gelöscht

FlashProgramFile

Flashen eines Programms auf das Target

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

ElfFile

string

Lokaler Pfad zu der zu ladenden Elf-Datei (relativ zum Workspace). Falls diese Option leer ist, muss eine Hex-Datei angegeben werden.

ForceFlash

☐

bool

Programmdatei wird ohne vorherige Verifizierung direkt geflasht.

HexFile

string

Lokaler Pfad zu der zu ladenden Hex-Datei (relativ zum Workspace). Falls diese Option leer ist, muss eine Elf-Datei angegeben werden.

VerifyAfterFlash

☐

bool

Nach dem Flashvorgang wird das Programm auf dem Target verifiziert

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

Verifizierung erfolgreich

GenerateCoverageReport

Startet die Coverage-Analyse des aufgezeichneten Trace Streams und speichert die Ergebnisse in einem HTML-Report. Es wird eine Trace Configuration im UDE Workspace benötigt. Nach Fertigstellung ist der generierte HTML-Report im Reportverzeichnis zu finden.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

reportFileName

string

Name der Trace Report HTML-Datei (Optional)

traceStreamNumber

0

int

Nummer des Trace Stream Items

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

reportFileName

string

Dateiname des übertragenen Coverage-Reports im Reportverzeichnis

GetCallStack

Gibt den aktuellen Callstack zurück.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

Liste von Frames bestehend aus Program Counter und Funktionsname.

GetCoreFamily

Gibt die Family-Info des referenzierten Cores zurück.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

familyInfo

string

GetCoreName

Gibt den Namen des übergebenen Cores zurück

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

string

GetCurrentFunctionName

Gibt den Namen der Funktion zurück innerhalb der sich der Instruction-Pointer befindet.

Die Ausführung auf dem Target muss dazu angehalten werden.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

functionName

string

GetDataType

Gibt den Datentyp einer Variablen zurück

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Variable

string

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

string

GetMasterCoreIndex

Gibt den Index des Master-Cores des Targets zurück

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Core

int

GetNumberOfCores

Gibt die Anzahl der Cores auf dem Target zurück

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

int

IsConnected

Gibt zurück ob das Target verbunden ist

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

IsInBreakpoint

Gibt True zurück, wenn das Programm zum Zeitpunkt des Aufrufs in einem Breakpoint hällt. Andernfalls wird False zurückgegeben.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

IsRunning

Gibt zurück, ob der angegebene Core läuft. Ohne Angabe eines speziellen Cores wird der Mastercore verwendet.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

ReadMemory

Lesen eines Speicherbereichs

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Address

int

Anfangsadresse des zu lesenden Bereichs

Count

int

Anzahl der zu lesenden Bytes

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Data

ByteStream

ReadRegister

Wertet ein Register auf einem bestimmten Core aus

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Register

string

Zu lesendes Register

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

int

ReadVariable

Wertet eine Variable auf einem bestimmten Core aus

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Variable

string

Zu lesende Variable

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

object

RemoveBreakpoint

Entfernt einen Breakpoint an der angegebenen Stelle.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Identifier

string

Ein String, durch welchen die Stelle identifiziert wird, an welcher der Breakpoint gesetzt werden soll. Möglichkeiten sind: Der Name einer Funktion, eine hex-Adresse oder Name und Zeile in der jeweiligen Datei (z.B. „hellopcp.c 175“)

Reset

Setzt ein Target zurück

SetBreakpoint

Setzt einen Breakpoint an der angegebenen Stelle.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Identifier

string

Ein String, durch welchen die Stelle identifiziert wird, an welcher der Breakpoint gesetzt werden soll. Möglichkeiten sind: Der Name einer Funktion, eine hex-Adresse oder Name und Zeile in der jeweiligen Datei (z.B. „hellopcp.c 175“)

SetBreakpointWithCondition

Setzt einen Breakpoint an der angegebenen Stelle mit der angegebenen Bedingung.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Condition

string

Ein C-Ausdruck, der entscheidet ob der Breakpoint auslöst: Wenn dieser Ausdruck 0 ergibt, läuft das Programm weiter, ansonsten wird es angehalten.

Identifier

string

Ein String, durch welchen die Stelle identifiziert wird, an welcher der Breakpoint gesetzt werden soll. Möglichkeiten sind: Der Name einer Funktion, eine hex-Adresse oder Name und Zeile in der jeweiligen Datei (z.B. „hellopcp.c 175“)

SetConnectState

Verbindet oder trennt das Target vom Debugger.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

State

☐

bool

True: Target verbinden. False: Target trennen.

StartCyclicWriteVariable

Schreibt so lange einen Wert in eine Variable bis StopCyclicWriteVariable aufgerufen wird

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Value

string

Der Wert mit dem die Variable zyklisch überschrieben werden soll

Variable

string

Zu schreibende Variable

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

StartProgram

Startet das geladene Programm

StartTraceRecording

Startet die Aufzeichnung des konfigurierten Trace Streams. Es wird eine Trace Configuration im UDE Workspace benötigt.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

traceStreamNumber

0

int

Nummer des Trace Stream Items

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

traceStreamName

string

Name des gewählten Trace Stream (Aufzeichnung)

StepInto

Einzelner Schritt. Betritt die Subroutine, falls auf einem Aufruf ausgeführt.

StepOut

Einzelner Schritt. Verlässt die Subroutine, falls möglich.

StepOver

Einzelner Schritt. Überspringt die Subroutine, falls auf einem Aufruf ausgeführt.

StopAllCyclicWriteVariables

Beendet alle zyklischen Schreib-Operationen

StopCyclicWriteVariable

Stoppt das zyklische Schreiben einer Variablen

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Variable

string

Zu schreibende Variable

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

StopProgram

Stoppt den Debugger

StopTraceRecording

Beende Aufzeichnung des gewählten Trace Streams. Es wird eine Trace Configuration im UDE Workspace benötigt.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

traceStreamNumber

0

int

Nummer des Trace Stream Items

WriteMemory

Schreiben eines Speicherbereichs

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Address

int

Anfangsadresse des zu schreibenden Bereichs

Data

ByteStream

Zu schreibende Daten als Bytestream

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

WriteRegister

Schreibt den Wert in ein Register auf einem bestimmten Core

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Register

string

Zu schreibendes Register

Value

int

Der Wert mit dem das Register überschrieben werden soll

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool

WriteVariable

Schreibt den Wert in eine Variable auf einem bestimmten Core

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Value

object

Der Wert mit dem die Variable überschrieben werden soll. Wenn „Variable“ ein Array-Typ ist, muss eine Liste übergeben werden, deren Länge dem Array entspricht. Bei 2-dimensionalen Arrays entsprechend verschachtelte Listen.

Elemente, die nicht geschrieben werden sollen, müssen auf None gesetzt werden.

Variable

string

Zu schreibende Variable

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

result

[False, True]

bool