From ba58dcdc5ad6ca021c723d279f33e3f14e1184df Mon Sep 17 00:00:00 2001 From: Arthur Hanson Rasmusson Date: Fri, 2 Oct 2026 08:36:35 -0400 Subject: debug: add green-eye GSP/uproc RISC-V VM runtime analysis tooling Adds open-iov/debug/risc-v-gsp-rm-vm: a GDB-free instrumentation stack that boots uproc/GSP firmware in qemu-system-riscv64 and provides Frida-like hooks, breakpoints, watchpoints, memory dumps, structure decoding, snapshot diffs, recorded sessions, declarative probes, a plugin API and a Ghidra symbol/hit bridge. Verified: 25 tests green (including a live QEMU smoke test); the demo uproc boots with correct hook/leave/watch/schema/snapshot/fault evidence; the optional TCG trace plugin builds and recorded 15M trace lines in 3 s; the TU104 570.144 fwimage probe reports its first exception (load access fault at firmware vaddr 0x4009014 reading 0x2000000000000A00). Documentation: lean tool docs under debug/risc-v-gsp-rm-vm/docs/00-10, a new docs/05-operations/03-risc-v-gsp-rm-vm.md debugging document, and '# TOOL IN DEVELOPMENT - NOT READY YET!' markers in docs/README.md, the onboarding tooling table and the debugging workflows doc. Vendors qemu-plugin.h from QEMU v8.2.2 (GPL-2.0-or-later), with its license header intact, so the optional TCG plugin builds without a QEMU source tree. --- .../risc-v-gsp-rm-vm/firmware/uproc_demo/ge_uart.h | 38 ++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 debug/risc-v-gsp-rm-vm/firmware/uproc_demo/ge_uart.h (limited to 'debug/risc-v-gsp-rm-vm/firmware/uproc_demo/ge_uart.h') diff --git a/debug/risc-v-gsp-rm-vm/firmware/uproc_demo/ge_uart.h b/debug/risc-v-gsp-rm-vm/firmware/uproc_demo/ge_uart.h new file mode 100644 index 0000000..4bd2f53 --- /dev/null +++ b/debug/risc-v-gsp-rm-vm/firmware/uproc_demo/ge_uart.h @@ -0,0 +1,38 @@ +/* Minimal NS16550A UART helpers for the QEMU virt machine. */ +#ifndef GE_UART_H +#define GE_UART_H + +typedef unsigned char u8; +typedef unsigned int u32; +typedef unsigned long u64; +typedef long i64; + +#define UART0_BASE 0x10000000UL +#define UART_THR (UART0_BASE + 0x00) +#define UART_LSR (UART0_BASE + 0x05) + +static inline void uart_putc(char c) +{ + volatile u8 *lsr = (volatile u8 *)UART_LSR; + while ((*lsr & 0x20) == 0) { + /* wait for THR empty */ + } + *(volatile u8 *)UART_THR = (u8)c; +} + +static inline void uart_puts(const char *s) +{ + while (*s) { + uart_putc(*s++); + } +} + +static inline void uart_hex(u64 value, int digits) +{ + static const char hex[] = "0123456789abcdef"; + for (int i = (digits - 1) * 4; i >= 0; i -= 4) { + uart_putc(hex[(value >> i) & 0xf]); + } +} + +#endif /* GE_UART_H */ -- cgit v1.2.3