Skip to content
CAI
Software that uses CAICheck a score

SpinalHDL/VexiiRiscv

46.8

Weak · 6 November 2026

28.4k

lines of production code

Scala

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

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

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.