UARCHLABS::PACINO

Pacino Design Resources

Pacino specifications, waveforms and theory of operation

● pacino frontend RTL: complete
▶ specifications
▶ performance analysis: in progress
▶ physical design: in progress

// frontend specifications

release 01 · 2026-11

Detailed Specifications - Pacino Frontend

Planning documents and design decisions

// frontend operations

Pacino Frontend theory of operation and waveforms, immediate access from a browser.

FD Demo What it shows WaveformWave DescriptionDesc
FD-01 Reset and init Reset and SRAM initialization waveformwave ↗ descriptiondesc
FD-02 Steady state Steady-state prediction and fetch waveformwave ↗ descriptiondesc
FD-03 Two branches 2-slot Two branches in one prediction block waveformwave ↗ descriptiondesc
FD-04 p2 override An FTB hit at p2 corrects a uBTB miss waveformwave ↗ descriptiondesc
FD-05 p3 override The statistical corrector overrides at p3 waveformwave ↗ descriptiondesc
FD-06 Loop predictor Loop trip count learned and the exit predicted waveformwave ↗ descriptiondesc
FD-07 Calls and returns Return address stack push and pop waveformwave ↗ descriptiondesc
FD-08 Indirect jump ITTAGE predicts an indirect target waveformwave ↗ descriptiondesc
FD-09 TAGE Provider, allocation and use_alt_on_na waveformwave ↗ descriptiondesc
FD-10 Predecode redirect Predecode corrects the prediction waveformwave ↗ descriptiondesc
FD-11 Backend mispredict Redirect from the backend after a mispredict waveformwave ↗ descriptiondesc
FD-12 Predictor training Updates routed by branch type; the single-ported FTB waveformwave ↗ descriptiondesc
FD-13 L1I Hit, miss and MSHR merge waveformwave ↗ descriptiondesc
FD-14 Translation Sv39 walk, Sv39x4 nested walk and Svadu CAS waveformwave ↗ descriptiondesc
FD-15 Fetch faults Page, access and guest-page fetch faults waveformwave ↗ descriptiondesc
FD-16 Page crossing A prediction block crossing a page waveformwave ↗ descriptiondesc
FD-17 Compressed code Compressed and unaligned code waveformwave ↗ descriptiondesc
FD-18 Uncached fetch Fetch from an uncached region waveformwave ↗ descriptiondesc
FD-19 FENCE.I and cbo.inval Instruction cache maintenance waveformwave ↗ descriptiondesc
FD-20 Backpressure A decode stall propagating back to the p0 request waveformwave ↗ descriptiondesc
FD-21 Commit FTQ commit pointer and RAS commit stack waveformwave ↗ descriptiondesc
FD-22 SC on slot 1 2-slot SC reversing slot 1 waveformwave ↗ descriptiondesc
FD-23 Jump cut 2-slot A jump behind two conditionals waveformwave ↗ descriptiondesc
FD-24 Call in slot 1 2-slot A call in slot 1 waveformwave ↗ descriptiondesc

Waveforms open in Surfer in the browser. Showcase Index →

// quick start

~/pacinoubuntu 22.04
$ git clone --recurse-submodules https://github.com/uarchlabs/pacino
$ cd pacino && . tools/setup.sh
$ tools/build_tools.sh        # about 30 minutes, mostly unattended
$ make -C examples/fe_demo view S=fd09_tage
$ ./tools/regress.sh
  • build_tools.sh asks where to install the cross compiler
  • build_tools.sh stops if any system components are needed
  • the demo make builds and launches a Surfer window
  • the regression tests whether the development tools are ready, about 10 minutes
  • README.md

// projects and tools

pacino

active

8-issue out-of-order RISC-V core targeting RVA23S64. Frontend RTL complete: seven-predictor BPU, FTQ, IFU, I-cache, ITLB, page table walker, decode.

lang
SystemVerilog · Verilator
license
Apache-2.0 RTL · CC BY 4.0 docs

ticfinder

tool

Finds the recurring prose constructions that cluster in LLM-generated text, so a human can decide what to cut. Every uarchlabs post is run through it, waivers committed.

lang
Python · spaCy
license
Apache-2.0

cachegen

tool

Cache generator: parameterized RTL plus a C++ functional model and test generator. Reference example is a 1 MB 4-way cache with tree-PLRU.

lang
Verilog · C++
license
Apache-2.0

// demo releases

release 01 · 2026-11

Theory of operation - Pacino Frontend

Twenty-four test cases illustrating major frontend behavior. Waveforms, diagrams and walk-throughs.

// IA task browser

IA tasks include the prompt, results and run time stats. Tasks are grouped by unit. The task browser allows search and query. Discussions of results are found in the blog articles.

latest: DOC-007 · 2026-10-19
242IA tasks
226complete
12abandoned
Jun–Nov2026
open the IA task browser

// latest from the blog

all 27 posts →