Port DEBUGGER - DEFAULT 🛈¶
Stimulation¶
Dieser Port besitzt keine Stimulus-Fähigkeiten.
Eigenschaften 🛈¶
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. |
Jobs 🛈¶
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 |