CERES RISC-V Dokümantasyon¶
GitHub Repository
Kaynak Kod: github.com/kerimturak/level-v
Dokümantasyon: kerimturak.github.io/level-v
-
:material-rocket-launch:{ .lg .middle } Hızlı Başlangıç
Projeyi kurun ve ilk simülasyonunuzu çalıştırın
-
:material-cpu-64-bit:{ .lg .middle } Mimari
5 aşamalı pipeline, branch predictor, cache sistemi
-
:material-chip:{ .lg .middle } Core Modülleri
CPU, Fetch, Decode, Execute, Memory, Writeback
-
:material-memory:{ .lg .middle } Peripheral Modülleri
UART, SPI, I2C, GPIO, Timer, PWM, DMA, VGA
🎯 Proje Özellikleri¶
| Özellik | Değer |
|---|---|
| ISA | RV32IMC (Base Integer + Multiply + Compressed) |
| Pipeline | 5-aşamalı (IF → ID → EX → MEM → WB) |
| Cache | 8-way set associative, 8KB I-Cache, 8KB D-Cache |
| Branch Predictor | GShare (512-entry PHT, 256-entry BTB, 16-deep RAS) |
| Bus | Wishbone B4 pipelined |
| Clock | 50 MHz hedef |
| Dil | SystemVerilog (IEEE 1800-2017) |
📂 Dokümantasyon Yapısı¶
docs/
├── index.md # Bu sayfa
├── getting-started.md # Kurulum rehberi
├── architecture.md # Mimari dokümantasyonu
├── tools.md # Araç kurulumu
│
├── core/ # Core modül dokümantasyonu
│ ├── index.md # Core genel bakış
│ ├── cpu.md # CPU top-level
│ ├── hazard-unit.md # Hazard detection
│ ├── stage01_fetch/ # Fetch stage
│ ├── stage02_decode/ # Decode stage
│ ├── stage03_execute/ # Execute stage
│ ├── stage04_memory/ # Memory stage
│ ├── stage05_writeback/ # Writeback stage
│ ├── mmu/ # Memory management
│ └── pmp_pma/ # Physical memory protection
│
├── periph/ # Peripheral dokümantasyonu
│ ├── index.md # Peripheral genel bakış
│ ├── uart.md # UART controller
│ ├── spi.md # SPI master
│ ├── i2c.md # I2C master
│ ├── gpio.md # GPIO controller
│ ├── timer.md # General purpose timer
│ ├── plic.md # Platform-level interrupt controller
│ ├── pwm.md # PWM controller
│ ├── dma.md # DMA controller
│ ├── wdt.md # Watchdog timer
│ └── vga.md # VGA controller
│
├── include/ # Include files
├── pkg/ # Packages
├── ram/ # Memory modules
├── tracer/ # Instruction tracer
├── util/ # Utility modules
├── wrapper/ # Top-level wrappers
│
├── script/ # Build system
├── sim/ # Simulation
└── env/ # Test environments
🚀 Hızlı Komutlar¶
# Verilator ile derleme
make verilate
# Tek test çalıştırma
make t T=rv32ui-p-add
# CoreMark benchmark
make cm SIM_UART_MONITOR=1
# Tüm ISA testleri
make isa
# Lint kontrolü
make lint
📖 Referanslar¶
📞 İletişim¶
- GitHub: kerimturak/level-v
- Issues: GitHub Issues