summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHeinrich Schuchardt <xypron.glpk@gmx.de>2021-05-28 19:22:14 +0300
committerAnup Patel <anup@brainfault.org>2021-06-02 14:34:07 +0300
commitd9ba6536d307f05a838e7c96cd20b0b7e43ec886 (patch)
tree25cab7b9d7ed024d31c1afcbea8cdc6550972711
parent54d7def6c254058f9458a0e26205b3c93a48bb42 (diff)
downloadopensbi-d9ba6536d307f05a838e7c96cd20b0b7e43ec886.tar.xz
docs: debugging OpenSBI
Describe how to debug OpenSBI on QEMU with GDB. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Reviewed-by: Atish Patra <atish.patra@wdc.com>
-rw-r--r--docs/platform/qemu_virt.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/platform/qemu_virt.md b/docs/platform/qemu_virt.md
index 2777148..0783be4 100644
--- a/docs/platform/qemu_virt.md
+++ b/docs/platform/qemu_virt.md
@@ -147,3 +147,27 @@ qemu-system-riscv32 -M virt -m 256M -nographic \
-device virtio-blk-device,drive=hd0 \
-append "root=/dev/vda rw console=ttyS0"
```
+
+Debugging with GDB
+------------------
+
+In a first console start OpenSBI with QEMU:
+
+```
+qemu-system-riscv64 -M virt -m 256M -nographic \
+ -bios build/platform/generic/firmware/fw_payload.bin \
+ -gdb tcp::1234 \
+ -S
+
+```
+
+Parameter *-gdb tcp::1234* specifies 1234 as the debug port.
+Parameter *-S* lets QEMU wait at the first instruction.
+
+In a second console start GDB:
+
+```
+gdb build/platform/generic/firmware/fw_payload.elf \
+ -ex 'target remote localhost:1234'
+
+```