riscv-playground-manual/debugging.md

Debugging mit RiscEmu

Der Debugger des Emulators kann mit dem ebreak Breakpoint-Befehl gestartet werden.

Verfügbare Objekte und Funktionen

In dem interaktiven Debugger sind folgende Variablen definiert:

• cpu Die CPU, die den ebreak gelesen hat
• mem und mmu ermöglichen Zugriff auf den Arbeisspeicher
• regs repräsentiert die Register der CPU

Des weiteren sind ein paar Hilfsfunktionen verfügbar:

• run_ins('name', 'arg1', 'arg2', 'arg3') führt den Befehl name arg1, arg2, arg3 an der aktuellen Stelle im Programm aus.
• step() führt den nächsten Befehl aus
• cont() beendet den Debugger
• dump(address) gibt den Inhalt des Arbeitsspeichers an der Adresse address aus. Das Verhalten der Funktion ist durch einige Parameter anpassbar, die später weiter erklärt werden.

Die dump() Funktion

Mit hilfe dieser Funktion kann der Inhalt des Arbeitsspeichers angezeigt werden. Die Signatur der Funktion ist etwas komplexer:

dump(start, [end], [fmt], [bytes_per_row], [rows], [group], [highlight])

Es ist möglich einen festgelegten Bereich anzuzeigen, indem start und end angegeben werden. Es ist auch möglich nur start zu verwenden, dann werden rows (standardmäßig 10) Zeilen um die Adresse start herum ausgegeben, und die Werte an der Adresse hervorgehoben. Eine andere Stelle zum Hervorheben kann mit highlight bestimmt werden.

Mit bytes_per_row kann angegeben werden, wie viele Bytes pro Zeile ausgegeben werden, und group gibt an, wie viele Bytes zusammen zu einem Wert gruppiert werden (z.B. praktisch um 32bit Integers anzuschauen).

Das Ausgabeformat kann mit dem fmt Argument angegeben werden, standardmäßig ist das hex. Andere Möglichkeiten sind int, uint für positive Ganzzahlen und char für ASCII-Text.