QBox is a SystemC/QEMU co-simulation framework for virtual-platform development. It integrates QEMU into SystemC through TLM-2.0 and combines processor and device models with SystemC components. Supported processor families include ARM, RISC-V, and Hexagon.
Featured: Qualcomm Dragonwing™ Virtual Platform · Competition
Browse the documentation hub for build, platform, configuration, component, library, monitor and debugging, networking, Python, plugin, and competition guides.
For the Ubuntu 22.04/24.04 CI-configured preset recipe, install dependencies, then configure, build, and test:
sudo scripts/install_dependencies.sh
cmake --preset gcc -DLIBQEMU_TARGETS="aarch64;hexagon"
cmake --build --preset gcc --parallel
ctest --preset gccThese commands match the CI configuration. GitHub Actions is currently disabled, so this recipe has not been run in CI. Preset commands require CMake 3.21 or newer.
Guest software runs on the modeled platform. QBox connects QEMU CPU/device models to SystemC TLM-2.0 models. Lua and CCI configure the components, parameters, and connections.
QEMU can use TCG or host-specific acceleration, depending on the build and host. The diagram is a high-level overview, not a tested support matrix; see the build guides and platform guides for configuration requirements.
See the Building QBox guide for platform prerequisites, support status, and configure, build, test, and install instructions.
QBox requires C++17 and is compatible with SystemC versions from SystemC 2.3.1a.
See CONTRIBUTING.md.
See LICENSE.

