SpinalHDL/VexiiRiscv
46.8
Weak · 6 November 2026
28.4k
lines of production code
Scala
primary language
4
measurements over time
What this system is
Features
Add ELF file parsing and memory initialization utilities
A new \Elf.scala\ component has been added to \spinal.lib.misc\ to provide utilities for parsing ELF files and initializing hardware memory models. This allows users to load program data from ELF binaries into simulation DRAMs or initialize RAMs with binary content, and includes a tool (\ElfMapper\) for mapping CPU program counters to function symbols for performance analysis.
src/main/scala/spinal/lib/misc · high confidence
Add Litex Buildroot external tree with VexRiscv Linux support and benchmark packages
This change introduces a new Buildroot external tree for LiteX-based SoCs, providing complete board support for the VexRiscv processor. It includes a detailed tutorial (README.md) for generating images on the Digilent Nexys Video board, along with board-specific configurations (linux.config, defconfig) for both a basic setup and a USB-host variant. The tree also adds a custom \dhrystone-opt\ benchmark package and patches for \chocolate-doom\ to enable performance optimizations and FPS display on the target hardware.
doc/litex/buildroot · high confidence
Add MMU, PMP, and Shadow MMU memory subsystem plugins
This change introduces the core memory management hardware for the VexiiRiscv processor, adding the MmuPlugin (supporting Sv32 and Sv39 address translation with TLB, ASID, and guest checks), the PmpPlugin (Physical Memory Protection with NAPOT/TOR granularity), and the ShadowMmuPlugin (second-stage translation for virtualization). It also includes supporting infrastructure such as PmaLogic for physical memory attribute checking, a StaticTranslationPlugin for MMU-less configurations, and a TranslatedDBusAccessPlugin to handle bus transactions through the MMU/Shadow MMU pipeline.
src/main/scala/vexiiriscv/memory · high confidence
Added Mill build support and updated SBT configuration
The project now includes a Mill build system alongside the existing SBT setup. New files \project/Version.mill\ and \project/package.mill\ define the Mill build structure, while \project/Version.scala\ and \project/plugins.sbt\ configure SBT with version 1.10.0, the \sbt-assembly\ plugin, and the \sourcecode\ library. The \project/version.conf\ file explicitly lists Scala 2.12.18 and 2.13.12 as supported compilers, aligning with the commit message to add Scala 2.13 support.
project · high confidence
Added documentation and configuration for building Debian on Litex/VexiiRiscv
Added a new README guide and a Linux kernel configuration file to help users build and run Debian on the VexiiRiscv CPU within the Litex framework. The documentation provides step-by-step instructions for setting up the build environment, installing dependencies (including RISC-V toolchains and SBT), creating a Debian root filesystem, compiling the Linux kernel, and generating the hardware bitstream for the Digilent Nexys Video board.
doc/litex/debian · high confidence
Added sandbox examples for SpinalHDL FiberPlugin and database integration
A new Play.scala file was added to the sandbox directory containing experimental code demonstrating the use of SpinalHDL's FiberPlugin architecture. This includes an EventCounterPlugin and EventSourcePlugin example showing how to coordinate plugin elaboration phases and share event data, as well as AlphaPlugin and BetaPlugin examples illustrating the use of the Database mechanism for passing configuration parameters between plugins during setup.
src/main/scala/vexiiriscv/sandbox · high confidence
Expanded RISC-V ISA support with Hypervisor, Crypto, and Bitmanip extensions
The RISC-V CPU core now supports a significantly broader set of ISA extensions, enabling more complex workloads and security features. This update adds the Hypervisor extension (RVH) with guest translation, HLV/HSV instructions, and AIA interrupt controller support, alongside the Smcntrpmf and Sstc extensions for performance monitoring. Cryptographic capabilities are expanded with the Zkn (AES), Zkb (bitmanip), SM3/SM4, and SHA2/SHA512 extensions. Additionally, the core now supports the Zfa floating-point extension, RVC compressed instructions, and refined atomic operations (separating Zaamo and Zalrsc). These changes are implemented through new instruction definitions, privilege mode handling, and micro-op specifications in the core's Scala source files.
src/main/scala/vexiiriscv/riscv · high confidence
Initial Docker environment for RISC-V simulation and development
Adds a Dockerfile and supporting scripts to build a containerized development environment based on a RISC-V toolchain. The image installs OpenJDK 21, SBT, Node.js, and Verilator, and provisions a desktop environment (XFCE, VNC) with pre-configured shortcuts for IntelliJ IDEA and the Konata viewer. It includes setup scripts to clone the VexiiRiscv repository, apply a patch to fesvr, build the RISC-V ISA simulator, and configure user permissions for the workspace.
docker · high confidence
Initial project scaffolding and build system migration
This change introduces the foundational structure for the VexiiRiscv project, including a new README with documentation and getting-started instructions, a .gitignore file to exclude build artifacts and IDE files, and a .gitmodules file to manage external dependencies like SpinalHDL and NaxSoftware. It also adds a new Mill-based build configuration (build.mill) alongside JVM options and a Docker helper script, establishing the tooling required to build and run the RISC-V core.
(repo-wide) · high confidence
Introduce MicroSoc configurable SoC with SPI flash and debug support
This change introduces the MicroSoc, a configurable System-on-Chip built on the TilelinkVexiiRiscv fiber. It provides a complete hardware definition including a VexiiRiscv CPU, RAM, CLINT, PLIC, UART, and an optional SPI flash controller with XIP support. The SoC is highly configurable via command-line options, allowing users to enable or disable features such as SPI flash, SPI PHY, and a debug system bus. It also supports multiple debug transports, including JTAG and a custom SWD transport, and includes a BSP generator to automatically create header files for software development based on the generated hardware layout.
src/main/scala/vexiiriscv/soc/micro · high confidence
Introduction of CFU (Custom Functional Unit) plugin and bus interface
This change introduces a new CFU plugin and associated bus definitions (CfuBus, CfuCmd, CfuRsp) that allow users to implement custom instruction hardware outside the CPU via a stream-based interface. The plugin registers custom decoding logic, manages register file inputs (RS1/RS2) and immediate values, and exposes CSR offsets for state indexing and status flags, enabling extensibility for custom functional units within the VexRiscv pipeline.
src/main/scala/vexiiriscv/execute/cfu · high confidence
Introduction of a structured RISC-V extension management system
The VexiiRiscv generator now uses a dedicated \ExtensionManager\ and \Extensions.scala\ to define, validate, and track RISC-V ISA extensions (such as M, A, F, D, C, and various Z\* extensions) with explicit versioning, dependencies, and implications. This replaces ad-hoc configuration, ensuring that enabling a base extension (like 'A') automatically handles its required sub-extensions (like 'zaamo' and 'zalrsc') and that the generator correctly reports or ignores extensions based on their defined relationships. Users benefit from more robust configuration validation and clearer support for complex extension combinations.
src/main/scala/vexiiriscv · high confidence
New CtrlLaneApi and NodeLaneApi for pipeline lane abstraction
Added CtrlLaneApi and NodeLaneApi traits to provide a structured API for managing execution lanes within pipeline CtrlLinks and Nodes. These new components allow users to define and access specific lanes (e.g., lane 0, lane 1) with built-in support for valid, ready, and cancel signals, as well as implicit conversions for data staging and bundling.
src/main/scala/spinal/lib/misc/pipeline · high confidence
New FPU execution unit with full RISC-V floating-point instruction support
The FPU execution stage now includes a complete set of plugins implementing RISC-V floating-point operations, including addition, subtraction, multiplication, fused multiply-add (FMA), division, square root, and conversions between floating-point and integer formats. The implementation supports standard formats (single, double, half, and quad precision) and includes the Zfh and Zfa extensions for half-precision and additional min/max/compare operations. A shared adder architecture allows time-sharing of the floating-point adder hardware between FADD and FMA instructions, while dedicated plugins handle classifying numbers, moving data between integer and float registers, and managing FPU flags and CSR access. The pipeline includes proper handling of subnormals, rounding modes, and exception flags (NV, DZ, OF, UF, NX).
src/main/scala/vexiiriscv/execute/fpu · high confidence
New L1 data cache and cacheless LSU implementations with hardware prefetching
The memory subsystem now offers two distinct LSU implementations: a new L1 data cache (LsuL1Plugin) supporting configurable associativity, line sizes, and memory coherency (TileLink), and a cacheless LSU (LsuCachelessPlugin) for uncached/IO accesses. Both implementations bridge to standard bus protocols including TileLink, AXI4, and Wishbone. A new hardware prefetcher (PrefetcherRptPlugin) using a stride-based predictor is also introduced to improve performance on cache misses, alongside a simple next-line prefetcher.
src/main/scala/vexiiriscv/execute/lsu · high confidence
New LiteX SoC simulation infrastructure with debug and video support
The LiteX SoC integration now includes a dedicated simulation testbench (SocSim) that supports running ELF binaries and booting Linux with JTAG debugging. Users can now utilize command-line options to enable SWD debug transport, configure device memory mappings, and enable dual-sim verification. Additionally, a VGA display simulation monitor has been added to visualize video output in a GUI during simulation, and the SoC configuration now supports multiple cores, L2 cache self-flush, and AXI3 interfaces.
src/main/scala/vexiiriscv/soc/litex · high confidence
New OpenOCD configuration scripts for VexiiRiscv development and simulation
Added a suite of OpenOCD Tcl configuration scripts in src/main/tcl/openocd to support VexiiRiscv hardware and simulation workflows. These include dev.tcl, dev\_rv64gc.tcl, and dev\_rv64gc\_opensbi.tcl for loading Linux images and managing multi-core (HART\_COUNT) resume operations; vexiiriscv\_jtag.tcl and vexiiriscv\_jtag\_tunneled.tcl for JTAG target creation with BSCAN tunneling support; vexiiriscv\_sim.tcl and vexiiriscv\_sim\_tunneled.tcl for remote\_bitbang simulation environments; and helper scripts prefetch\_enable.tcl, prefetch\_disable.tcl, and trace.tcl for debugging prefetch behavior and instruction traces. Hardware-specific configs for Digilent Nexys Video and FT2232H breakout adapters are also included.
src/main/tcl · high confidence
New Tilelink integration layer for VexiiRiscv in SoC designs
A new \TilelinkVexiiRiscvFiber\ class has been added to the SoC package, providing a concrete integration bridge that connects the VexiiRiscv CPU core to a Tilelink bus via a fiber-based architecture. This component automatically instantiates and configures Tilelink-specific plugins for instruction and data caches (such as \FetchL1TileLinkPlugin\ and \LsuL1TileLinkPlugin\) based on the selected CPU plugins, and establishes connections for interrupt controllers including the CLINT, APLIC, and IMSIC. It also handles the mapping of privilege modes and guest interrupt files, enabling users to build complex SoCs with standard Tilelink peripherals and advanced interrupt handling capabilities.
src/main/scala/vexiiriscv/soc · high confidence
New branch prediction plugins (BTB, GShare, History, Learn)
Added new hardware branch prediction components to the fetch pipeline: BtbPlugin implements a Branch Target Buffer and Return Address Stack (RAS) to predict jump targets; GSharePlugin provides conditional branch prediction using a gshare-indexed counter table with configurable banking; HistoryPlugin manages the global branch history register used by gshare indexing; and LearnPlugin aggregates learning signals from execution to update the BTB and GShare tables. These plugins introduce new configuration parameters (e.g., sets, chunks, rasDepth, historyWidth, banksCount) and integrate with the existing fetch/decode pipeline via the FiberPlugin architecture to improve instruction fetch accuracy.
src/main/scala/vexiiriscv/prediction · high confidence
New hardware acceleration plugins for AES, Bitmanip, and Shift instructions
The execute stage now includes dedicated plugins for several RISC-V extensions. AesZknPlugin implements the Zkn AES instructions (including AES64KS1I and CLMUL) for both 32-bit and 64-bit modes. Bitmanip.scala aggregates support for the Zba, Zbb, Zbc, Zbs, and Zbkb extensions, adding logic, count, min/max, byte-reverse, and bit-manipulation operations. BarrelShifterPlugin provides a unified hardware shifter that supports standard shifts as well as the new SLLI\_UW (unsigned word shift left immediate) instruction. These plugins integrate into the existing execute pipeline to accelerate cryptographic and bit-level operations.
src/main/scala/vexiiriscv/execute · high confidence
New hardware division units and debug infrastructure added to the CPU core
This change introduces new hardware components to the VexiiRiscv core, specifically adding radix-2 and radix-4 unsigned division units (DivRadix2, DivRadix4) to replace or supplement existing division logic, and integrating an Embedded RISC-V JTAG plugin that supports both standard JTAG and optional SWD transport for on-chip debugging. Additionally, it adds support for the AIA (Advanced Interrupt Architecture) via the IMSIC plugin, implements indirect CSR access via IndirectCsrPlugin, and provides a comprehensive PerformanceCounterPlugin for hardware performance monitoring, along with a TesterPlugin for simulation stress-testing.
src/main/scala/vexiiriscv/misc · high confidence
New modular instruction fetch subsystem with L1 cache and cacheless bridge support
The instruction fetch logic has been restructured into a plugin-based architecture, introducing a configurable L1 instruction cache (FetchL1Plugin) and a cacheless fetch path (FetchCachelessPlugin). Both paths support out-of-order memory responses and integrate with address translation (MMU) and physical memory protection (PMP). To enable integration with various system buses, new bridge plugins allow the fetch interface to connect via Tilelink, AXI4, Wishbone, or BMB protocols, providing flexibility for different SoC interconnects.
src/main/scala/vexiiriscv/fetch · high confidence
New multi-port RAM implementations added to the compatibility layer
A new file, MultiportRam.scala, has been added to the vexiiriscv.compat package, introducing several hardware components for implementing multi-port RAMs (multiple read/write ports) using simple dual-port RAM primitives. This includes asynchronous and synchronous variants using XOR-based data merging (RamAsyncMwXor, RamSyncMwXor), register-based merging (RamAsyncMwReg), and mux-based selection (RamAsyncMwMux, RamSyncMwMux). These components allow users to construct memory structures with multiple concurrent access ports within the RISC-V core compatibility layer.
src/main/scala/vexiiriscv/compat · high confidence
New test infrastructure and simulation server for VexiiRiscv
The test suite in the \tester\ package has been restructured with new components to improve simulation usability and performance. A fluent \TestArgs\ builder is introduced to simplify the construction of testbench command-line arguments. The main \TestBench\ now supports multi-core (multi-hart) simulations and integrates Tilelink-based peripherals (CLINT, PLIC) via the new \TilelinkTestBench\. Additionally, a \TestBenchServer\ is added, allowing users to start a pre-compiled simulation server that accepts remote connections to run tests, significantly reducing startup overhead for repeated benchmarking.
src/main/scala/vexiiriscv/tester · high confidence
Behavioural changes
Introduce register-file backend with mask-read-during-write support
The register file now supports a configurable backend that can mask reads during write cycles (controlled by the \maskReadDuringWrite\ parameter). This behavioral change ensures that read data is suppressed when a concurrent write targets the same address, preventing stale or undefined values from being observed by the CPU. The implementation includes a new \RegFileMem\ component and a \RegFilePlugin\ that manages read/write port arbitration and initialization, allowing users to select between different register file topologies (e.g., RAM-based vs. register-based) while adhering to this safety mechanism.
src/main/scala/vexiiriscv/regfile · high confidence
Introduce structured decode pipeline with RVC alignment and plugin-based decoding
The decode stage is restructured into a composable pipeline using \DecodePipelinePlugin\ to manage lane control and flushing, alongside \AlignerPlugin\ to handle RVC instruction deserialization and fetch-word alignment (with optional buffering). \DecoderPlugin\ now exposes a service API allowing other components to register micro-op decoding rules, illegal instruction checks, and virtual instruction checks, while centralizing register file access key generation and interrupt buffering within the decode stage.
src/main/scala/vexiiriscv/decode · high confidence
New dispatch and rescheduling infrastructure for instruction scheduling
The \vexiiriscv/schedule\ module now includes new \DispatchPlugin\, \ReschedulePlugin\, and \Service\ components that implement the core logic for collecting decoded instructions, determining execution lane eligibility based on dependencies and hazards, and issuing instructions to execution units. This change introduces a new reservation system allowing static scheduling of operations (such as floating-point) that share resources at different pipeline stages, and adds precise flush hazard tracking to prevent false positives and ensure correct pipeline behavior during speculative execution and branch mispredictions.
src/main/scala/vexiiriscv/schedule · high confidence
Test coverage
Added Konata trace backend for simulation visualization; Added MultithreadedFunSuite test base class; Added documentation examples for VexiiRiscv plugin system; Added hardware stability and synthesis benchmark test utilities; Added tests for SpinalHDL Fiber plugin synchronization patterns; Automated regression testing framework for VexiiRiscv; New simulation infrastructure for IMSIC, I/O, and CPU probing.
Dependencies
Initial SBT build configuration for VexiiRiscv
The project now uses an SBT build file (build.sbt) to manage dependencies and compilation. This configuration sets the project version to 2.0.0, defines Scala cross-compilation versions, and includes specific libraries such as ScalaTest 3.2.17, SnakeYAML 1.8, jelf 0.7.0, and jssc 2.8.0. It also supports building SpinalHDL from source via environment variables and configures JNI bindings for RISC-V simulation.
(dependencies) · high confidence
Initialize external repository submodules
The project now includes external dependencies as Git submodules, specifically NaxSoftware, SpinalHDL, riscv-isa-sim, and rvls, along with a Mill package definition for the ext directory. This establishes the baseline versions for the software simulation environment, the hardware description framework, and the RISC-V instruction set simulator used by the core.
ext · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 43 → 47 (+3.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 57 → 57 (+0.0)
- Architecture 89 → 87 (-1.3)
- Maturity 35 → 52 (+17.0)
- Readiness 34 → 32 (-2.5)
- Security 72 → 80 (+7.5)
Resolved (13)
- Banned license: org.scream3r:jssc
- Change coupling: LsuCachelessPlugin.scala ↔ StaticTranslationPlugin.scala (src/main/scala/vexiiriscv/execute/lsu/LsuCachelessPlugin.scala)
- Documentation: no installation or build instructions (README.md)
- Documentation: no licence statement (README.md)
- Documentation: no usage examples (README.md)
- No SBOM
- No artifact signing
- No build provenance
- Off-boarding risk: anonymized user #1
- Off-boarding risk: anonymized user #2
- Outdated: net.fornwall:jelf
- Outdated: org.yaml:snakeyaml
- Unpinned build actions
New (6)
- Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
- Off-boarding risk: anonymized user #2
- Off-boarding risk: anonymized user #1
- Repeated repair: src/main/scala/vexiiriscv/execute/lsu/LsuPlugin.scala (src/main/scala/vexiiriscv/execute/lsu/LsuPlugin.scala)
- Repeated repair: src/main/scala/vexiiriscv/memory/MmuPlugin.scala (src/main/scala/vexiiriscv/memory/MmuPlugin.scala)
- Repeated repair: src/main/scala/vexiiriscv/misc/TrapPlugin.scala (src/main/scala/vexiiriscv/misc/TrapPlugin.scala)
Changes since last survey
- 27 commits — 11 feature/other, 16 fixes
By area
- src/main — 15 commits
- (repo) — 5 commits
- ext/riscv-isa-sim — 2 commits
- src/test — 2 commits
- (root) — 1 commit
- .github/workflows — 1 commit
- ext/SpinalHDL — 1 commit
Notable commits
- fix: Fix *PC process check.
- fix: Fix AES64 wrong timing when reading ROM
- fix: Fix AMO creating an LR reservation (#200)
- fix: Fix Branch check on the PC
- fix: Fix TDATA2 match address for width PC
- fix: Fix cached fetch duplicate write problem
- fix: Fix debug trigger match on non valid addresss
- fix: Fix integer result extend through the full output width
- fix: Merge pull request #193 from inochisa/fix/epc
- fix: Merge pull request #201 from AllinLeeYL/fix-issue-200-sc-succeeds-without-lr
- fix: Merge pull request #202 from inochisa/fix/fetch-duplicate
- fix: Merge pull request #204 from inochisa/fix/sim/regfile
- fix: Merge pull request #205 from inochisa/fix/int-extend
- fix: Only run regression when the code is changed
- fix: Revert "prevent regression issue on config with buildroot"
- fix: prevent regression issue on config with buildroot
- change: Add PC address check for cacheless LSU
- change: Add bspScriptIgnore parameters to ignore any bad taget in VexiiRiscv
- change: Add full simulation for all support backend of the RegFileMem
- change: Bump Spike and SpinalHDL
- …and 7 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
SpinalHDL/VexiiRiscv was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 9f70315deb3390b283995c5b8f1bd38215ecf52b — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-410a2463fa58.