📄️ SHDB Overview
SHDB (Simple Hardware Debugger) is an interactive debugger for SHDL circuits, inspired by GDB. It allows you to step through simulations, inspect any signal including internal gates, set breakpoints, record waveforms, and navigate component hierarchies.
📄️ Getting Started with SHDB
This guide walks you through your first debugging session with SHDB.
📄️ Commands Reference
Complete reference for all SHDB commands.
📄️ Signal Inspection
SHDB provides powerful signal inspection capabilities, from simple value reads to complex expressions and internal gate access.
📄️ Breakpoints and Watchpoints
SHDB uses signal-based breakpoints instead of line-based breakpoints. This matches the nature of hardware simulation where you care about signal values, not source lines.
📄️ Hierarchy Navigation
SHDL circuits are hierarchical - components instantiate other components. SHDB lets you navigate this hierarchy to debug at any level of abstraction.
📄️ Waveform Recording
SHDB can record signal values over time and export them for visualization in waveform viewers like GTKWave.
📄️ Scripting
SHDB supports scripting for automated testing, regression suites, and complex debug scenarios.
📄️ Python API
SHDB provides a Python API for programmatic debugging, test automation, and integration with other tools.
📄️ Debug Build Reference
Technical reference for SHDB debug builds, including compiler flags, generated code, and the .shdb file format.
📄️ Common Problems
This page covers common issues you may encounter when using SHDB and SHDL, along with their causes and solutions.