Port DEBUGGER - DEFAULT

Stimulation

Dieser Port besitzt keine Stimulus-Fähigkeiten.

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

Portnummer

20000

int

UDP-Port der Remote API, über den Trace32 angesprochen wird (siehe *.t32-Konfigurationsdatei)

Arbeitsverzeichnis

‚C:\T32‘

string

Pfad zum Arbeitsverzeichnis (Absolut oder relativ zum Basispfad des Hostknoten)

Konfigurationsdatei ❲*.t32❳

‚config.t32‘

string

Pfad zur Konfigurationsdatei. Optional können Argumente angegeben werden. Platzhalter für ELF- oder HEX-Dateien können als ${elf} oder ${hex} angegeben werden. Wenn mehr als eine ELF-Datei definiert wurde, werden sie dem Startskript als separate Argumente übergeben.

Startup-Script ❲*.cmm❳

string

Pfad zum PRACTICE-Startscript. Dieses wird beim Start von TRACE32 ausgeführt. Optional können Argumente angegeben werden. Als Platzhalter für die ELF-Datei oder die HEX-Datei werden ${elf} bzw. ${hex} akzeptiert. Wurden mehrere ELF-Dateien angegeben, werden diese als jeweils ein Argument an das Startscript übergeben.

ELF-Datei

uri

Lokaler Pfad zu der zu ladenden ELF-Datei (relativ zum Workspace). Wird bei <auto> aus der Testkonfiguration übernommen. Mehrere ELF-Dateien können mit | getrennt angegeben werden.

HEX-Datei

uri

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

ELF-Ladeparameter

‚/NoClear /NOCODE /ForceLines /GlobTypes‘

string

Parameter die beim Laden der ELF-Datei angegeben werden (TRACE32-Befehl Data.LOAD.Elf)

Steuergerätebezeichner

string

Steuergerätebezeichner dieses Ports in der Testkonfiguration (wird automatisch ausgefüllt)

Nutze ‚Run-time Memory Access‘

☐

bool

Erlaubt das Lesen und Schreiben von Variablen während das Target läuft. (Verwendet die Option „%e“ beim VAR-Befehl. Funktioniert nur bei Targets, die diese Option unterstützen.)

Attach

Stellt die Verbindung zum TRACE32-Gerät her

Break

Hält die Ausführung des Targets bzw. der Simulation an.

Cmd

Startet einen beliebigen PRACTICE-Befehl, bspw. ‚DO script.cmm‘, aber wartet nicht auf dessen Beendigung. Fehlermeldungen des PRACTICE-Befehls werden von diesem Job nicht ausgewertet(siehe Job ‚GetMessage‘ bzw. ‚CmdWithReturn‘)

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

command

string

PRACTICE-Befehl der ausgeführt werden soll

CmdWithReturn

Führt einen PRACTICE-Befehl aus, z.B. ‚DO script.cmm‘. Es wird gewartet bis der Befehl abgearbeitet wurde und das Ergebnis zurückgegeben.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

command

string

PRACTICE-Befehl der ausgeführt werden soll

timeout

float

Timeout beim Warten auf den Rückgabewert (in Sekunden)

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnValue

string

Rückgabewert des ausgeführten Befehls

CoreSelect

Sendet den PRACTICE Befehl CORE.select

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

coreNumber

0

int

Nummer des Cores der selektiert wird

EvalGet

Liefert den Wert der globalen Variable zurück, welche von manchen PRACTICE-Befehlen (z.B.: ‚EVAL‘) verwendet wird.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnValue

int

Numerische Repräsentation des Rückgabewertes

EvalGetString

Liefert den Wert der globalen Variable zurück, welche von manchen PRACTICE-Befehlen (z.B.: ‚EVAL‘) verwendet wird.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnString

string

Textuelle Repräsentation des Rückgabewertes

GetApiRevision

Liefert die Revision der Remote-API zurück, welche ecu.test verwendet um mit TRACE32 zu kommunizieren. Nicht die Version von TRACE32

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnValue

int

Revisionsnummer

GetBreakpointList

Liest Breakpoint-Informationen

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

maxBreakpoints

0

int

Max. Anzahl der zu lesenden Breakpoints

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

object

Liste mit Debugger-Breakpoints bestehend aus (Start-Adresse, IsEnabled, Breakpoint-Type, AuxType)

GetCpuInfo

Liefert Informationen über CPU Typ und Familie zurück

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultTuple

object

Tupel mit CPU-Infos (cpu<string>, BigEndinan<bool>)

GetMessage

Liefert den Inhalt und Typ von Nachrichten des AREA-Fensters bzw. der Nachrichtenzeile zurück.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnObject

object

Tupel: Nachrichtentyp<string>(General Information/ Error/Status Information/Error Information/ Temporary Display/Temporary Information), Inhalt der Nachricht<string>).

GetPracticeState

Liefert den Status der PRACTICE-Befehlsausführung zurück

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnString

string

‚Not Running‘, ‚Running‘ oder ‚Dialog window open‘

GetRam

Abfragen von Memory-Mapping-Informationen.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

access

‚Data RAM‘

[‚Data RAM‘, ‚Program RAM‘, ‚Default‘]

string

RAM wählen

start

0

int

Startadresse

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnObject

object

Tupel mit Anfang und Endadresse des gefundenen Speicherbereiches(foundStartAddress<int>, foundEndAddress<int>). Wurde nichts gefunden: (-1,-1)

GetSource

Liefert den Dateinamen und die Zeilennummer zu einer Adresse zurück

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

address

0

int

Adresse des Dateinamens und der Zeilennummer

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnString

string

String im Format Dateiname:Zeilennummer

GetState

Liefert den ICD-Status zurück

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnString

string

‚Debug system is down‘, ‚Debug system is halted‘, ‚Target execution is stopped‘ oder ‚Target execution is running‘.

GetSymbol

Liefert die Informationen des Symbols mit dem angegebenen Namen. Im Namen wird eine automatische Ersetzung des ELF-Dateinamens vorgenommen, falls darin der ELF-Bezeichner aus der Testkonfiguration in eckigen Klammern vorkommt (z.B. [ELF-KEY-1])

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

symbolName

string

Symbolname (‚[ELF-Bezeichner]‘ für automatische Ersetzung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

object

Tupel (address<int>, size<int>, access<int>)

GetSymbolAccess

Liefert den Access-Parameter des Symbols mit dem angegebenen Namen. Im Namen wird eine automatische Ersetzung des ELF-Dateinamens vorgenommen, falls darin der ELF-Bezeichner aus der Testkonfiguration in eckigen Klammern vorkommt (z.B. [ELF-KEY-1])

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

symbolName

string

Symbolname (‚[ELF-Bezeichner]‘ für automatische Ersetzung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

int

access<int>

GetSymbolAddress

Liefert die Adresse des Symbols mit dem angegebenen Namen. Im Namen wird eine automatische Ersetzung des ELF-Dateinamens vorgenommen, falls darin der ELF-Bezeichner aus der Testkonfiguration in eckigen Klammern vorkommt (z.B. [ELF-KEY-1])

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

symbolName

string

Symbolname (‚[ELF-Bezeichner]‘ für automatische Ersetzung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

int

address<int>

GetSymbolFromAddress

Liefert den Symbolnamen zur angegebenen Adresse

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

symbolAddress

0

int

Symboladresse

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

string

Symbolname

GetSymbolSize

Liefert die Größe des Symbols mit dem angegebenen Namen. Im Namen wird eine automatische Ersetzung des ELF-Dateinamens vorgenommen, falls darin der ELF-Bezeichner aus der Testkonfiguration in eckigen Klammern vorkommt (z.B. [ELF-KEY-1])

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

symbolName

string

Symbolname (‚[ELF-Bezeichner]‘ für automatische Ersetzung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

int

size<int>

GetTraceInfo

Liefert die Buffergröße und die minimale/maximale Aufzeichnungsnummer des ausgewählten Traces zurück.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

tracetype

‚Trace‘

[‚Trace‘, ‚Trace (raw data)‘, ‚Trace (funneled data)‘, ‚PowerIntegrator‘, ‚PowerProbe‘, ‚Snooper‘, ‚DTM‘]

string

Selektierung des Traces

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

object

Tupel (buffersize<int>, minNumber<int>, maxNumber<int>)

GetTraceState

Liefert den Status des ausgewählten Traces zurück.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

tracetype

‚Trace‘

[‚Trace‘, ‚Trace (raw data)‘, ‚Trace (funneled data)‘, ‚PowerIntegrator‘, ‚PowerProbe‘, ‚Snooper‘, ‚DTM‘]

string

Selektierung des Traces

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultString

object

‚analyzer is switched off‘, ‚analyzer is armed‘, ‚analyzer triggered‘ oder ‚analyzer recording breaked‘

GetTriggerMessage

Liefert die Trigger-Nachricht, welche beim Stoppen eines Breakpoints ausgegeben wird.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnString

string

Trigger-Nachricht

GetWindowContent

Liefert den Inhalt eines TRACE32-Fensters

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

command

string

PRACTICE-Befehl zum Öffnen des Fensters, z.B. ‚List‘

encoding

‚utf-8‘

[‚ascii‘, ‚iso-8859-1‘, ‚cp1252‘, ‚utf-8‘]

string

Auf das Ergebnis anzuwendendes Encoding

format

‚XML‘

[‚ASCII‘, ‚ASCIIP‘, ‚ASCIIE‘, ‚CSV‘, ‚XML‘]

string

Zielformat

Go

Startet die Ausführung auf dem Target bzw. der Simulation.

Nop

Sendet eine leere Nachricht

Ping

Sendet eine Ping-Nachricht

QueryBreakpointObjCount

Liefert die Anzahl von Breakpoints zurück

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

int

Anzahl der in TRACE32 definierten Breakpoints

ReadBreakpoint

Liest Breakpoint-Informationen

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

access

‚Data access‘

[‚Data access‘, ‚Program access‘, ‚CP0‘, ‚ICEbreaker‘, ‚ETM‘, ‚CP14‘, ‚CP15‘, ‚ARM logical‘, ‚THUMB logical‘, ‚ARM physical‘, ‚THUMB physical‘, ‚ETB‘, ‚AD:‘, ‚AP:‘, ‚DAP:‘, ‚USR:‘, ‚VM:‘, ‚Default‘]

string

Speicherbereich wählen

address

0

int

size

0

int

Anzahl der zu lesenden Adressen

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

BitStream

Bitstream mit Breakpoint-Daten (siehe RemoteApi-Doku - „T32_ReadBreakpoint“)

ReadMemory

Lesen vom Speicher

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

access

‚Data access‘

[‚Data access‘, ‚Program access‘, ‚CP0‘, ‚ICEbreaker‘, ‚ETM‘, ‚CP14‘, ‚CP15‘, ‚ARM logical‘, ‚THUMB logical‘, ‚ARM physical‘, ‚THUMB physical‘, ‚ETB‘, ‚AD:‘, ‚AP:‘, ‚DAP:‘, ‚USR:‘, ‚VM:‘, ‚Default‘]

string

Speicherbereich wählen

byteAddress

0

int

Startadresse

byteSize

0

int

Anzahl zu lesender Bytes

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnObject

ByteStream

Der Inhalt des gelesenen Speicherbereichs

ReadPP

Liefert die aktuelle Adresse des Programmzeigers zurück Ausführung nur bei angehaltener Ausführung möglich.

Parametrierung

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

returnValue

int

Adresse des Programmzeigers

ReadRegister

Liest die Werte von Registern unter Angabe der Masken

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

mask1

0

int

Register address mask 1

mask2

0

int

Register address mask 2

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

object

Liste mit 64 32-Bit Registerwerten

ReadRegisterByName

Liest die Werte eines Registers unter Angabe des Namens

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

registerName

string

Rückgabewert

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

resultObject

object

Tupel aus niederwertigem und höherwertigem 32-Bit Registerwert

ResetCPU

Versucht das Target über die PRACTICE commands SYStem.UP und Register.RESet zurückzusetzen

SetMemoryAccessClass

Setzt die Klasse für nachfolgende Speicherzugriffe (z.B. via ReadMemory), deren access-Parameter dann ignoriert werden.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

access

‚Default‘

[‚Program Space‘, ‚Data Space‘, ‚Access by the CPU‘, ‚Direct access to emulation memory‘, ‚Direct access to program memory‘, ‚Direct access to data memory‘, ‚Absolute, physical addressing‘, ‚Absolute Data‘, ‚Absolute Program‘, ‚User Specific Access Mode‘, ‚EEPROM Write Access‘, ‚Default‘]

string

Klasse für Speicherzugriff. ‚Default‘ reaktiviert die funktionsspezifischen access-Parameter.

SetMode

Setzt den Anzeigemodus für das Data.List Fenster.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

mode

‚ASM‘

[‚ASM‘, ‚HLL‘, ‚Mixed‘]

string

Den zu setzenden Displaymodus

Step

Führt einen Einzelschritt im aktuellen Modus aus

StepMode

Führt einen Schritt auf dem Emulator oder Target, in Abhängigkeit vom gewählten Modus, aus. Beim ‚Mixed Step‘ wird ein Assemblerschritt im Anzeigemodus HLL ausgeführt.

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

mode

‚Assembler step‘

[‚Assembler step‘, ‚HLL step‘, ‚Mixed step‘]

string

type

‚Step into function call‘

[‚Step into function call‘, ‚Step over function call‘]

string

Stop

Stoppt die Ausführung eines PRACTICE-Scriptes.Zum Stoppen des Targets oder der Simulation den Job ‚Break‘ benutzen

WriteBreakpoint

Schreibt einen Breakpoint

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

access

‚Data access‘

[‚Data access‘, ‚Program access‘, ‚CP0‘, ‚ICEbreaker‘, ‚ETM‘, ‚CP14‘, ‚CP15‘, ‚ARM logical‘, ‚THUMB logical‘, ‚ARM physical‘, ‚THUMB physical‘, ‚ETB‘, ‚AD:‘, ‚AP:‘, ‚DAP:‘, ‚USR:‘, ‚VM:‘, ‚Default‘]

string

Speicherbereich wählen

address

0

int

breakpoint

BitStream(0x0, 0)

BitStream

Zu setzender Breakpoint (siehe RemoteApi-Doku - „T32_WriteBreakpoint“)

size

0

int

Anzahl der zu schreibenden Adressen

WriteMemory

Schreiben in den Speicher ab der angegebenen Adresse

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

access

‚Data access‘

[‚Data access‘, ‚Program access‘, ‚CP0‘, ‚ICEbreaker‘, ‚ETM‘, ‚CP14‘, ‚CP15‘, ‚ARM logical‘, ‚THUMB logical‘, ‚ARM physical‘, ‚THUMB physical‘, ‚ETB‘, ‚AD:‘, ‚AP:‘, ‚DAP:‘, ‚USR:‘, ‚VM:‘, ‚Default‘]

string

Speicherbereich wählen

byteAddress

0

int

Startadresse

data

ByteStream()

ByteStream

Zu schreibende Bytes

WriteMemoryPipe

Paralleles Schreiben in den Speicher ab der angegebenen Adresse

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

access

‚Data access‘

[‚Data access‘, ‚Program access‘, ‚CP0‘, ‚ICEbreaker‘, ‚ETM‘, ‚CP14‘, ‚CP15‘, ‚ARM logical‘, ‚THUMB logical‘, ‚ARM physical‘, ‚THUMB physical‘, ‚ETB‘, ‚AD:‘, ‚AP:‘, ‚DAP:‘, ‚USR:‘, ‚VM:‘, ‚Default‘]

string

Speicherbereich wählen

byteAddress

0

int

Startadresse

data

ByteStream()

ByteStream

Zu schreibende Bytes

WriteRegister

Beschreibt die Werte von Registern unter Angabe der Masken

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

mask1

0

int

Register address mask 1

mask2

0

int

Register address mask 2

registerData

[]

object

Liste mit 64 32-Bit Registerwerten

WriteRegisterByName

Beschreibt die Werte eines Registers unter Angabe des Registernamens

Parametrierung

Parameter

Name

Verfügbar wenn

Standardwert

Gültige Werte

Typ

Beschreibung

hvalue

0

int

32-Bit Wert des höherwertigen Registers

registerName

string

value

0

int

32-Bit Wert des niederwertigen Registers