Developer Guide

Bizmuth is built for development — it fills the same role as CSpect for ZX Spectrum Next work: source-level debugging, a live inspector, and scripting. Start with the Overview.

• Overview — how Bizmuth’s development tooling fits together.
• DeZog & DZRP (VS Code) — source-level debugging from VS Code over DZRP.
• The ADP debugger — the plain-text TCP protocol: every command and its reply.
• Conditional breakpoints — the full condition language, plus memory watchpoints.
• Rhai scripting — react to hardware events and read live state; every on_* handler and host function.
• Headless & automation — scripted, windowless runs for capture, input and regression checks.
• The debugger window — the built-in GUI debugger.
• Inspecting hardware — sprites, layers, DMA, copper and paging.
• Save states for debugging — capture and restore state to reproduce a bug deterministically.

• Overview — How Bizmuth's development tooling fits together.
• DeZog & DZRP (VS Code) — Source-level debugging of Next software from VS Code, over DZRP.
• The ADP debugger — Complete reference for the Advanced Debugging Protocol — every command and its reply, over TCP port 11001.
• Conditional breakpoints — The full condition language for PC breakpoints, plus memory watchpoints.
• Rhai scripting — React to hardware events and read live state from a Rhai script — every on_* handler and host function.
• Headless & automation — Run scripted, windowless sessions — capture screenshots/video, drive input, dump state, and gate regressions in CI.
• The debugger window — The built-in GUI debugger — registers, disassembly, memory, breakpoints and a command bar.
• Inspecting hardware — Visualise and dump Next hardware state — sprites, layers, DMA, copper and paging.
• Save states for debugging — Capture and restore machine state to reproduce a bug deterministically.