0BAB1/HOLY_CORE_COURSE
0BAB1/HOLY_CORE_COURSE has 526 GitHub stars and 47 forks. GitHot measured 0 stars in 24 hours and +1 in 7 days. Last checked 2026-11-22 07:09 UTC. Last push 2026-10-28.
측정된 스타 증가
- in 24h
- 0
- in 7 days
- +1
- in 15 days
- 기록 수집 중
- in 1 month
- 기록 수집 중
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
소개
Learn how to build our own RV32I(M) core, verify it and actually use it FOR FREE (.md tutorials). From scratch & with more than 200 pages of detailed tutorial with schemes & explanation.
학습README.md
OriginalHOLY CORE PROJECT

Build your own 32-bit RISC-V CPU from scratch. An FREE and open-source core with detailed tutorials. Some advanced material are indeed only accessible by paying (advanced verification, debug specs, traps, ...) but frankly, you have a loooot to dig and learn before getting there ;)
Wheteher you want to learn how to build your core using REAL HANDWRITTEN material or just have a simple and straightforward RV core to use in you projects, you are at the right place.
[!NOTE] The HOLY CORE is a handwritten project.I'd say more than 90-95% of the code was written by hand. This is important as this is NOT antoher linkedin slop project or education slop. So hop on an adventure to learn from real people how to build your own CPU! And yes, the HOLY CORE runs DOOM ;)
🧙♂️ Choose Your Path
📚 I want to LEARNFollow the tutorials step-by-step Perfect if you want to understand how CPUs work by building the HOLY CORE yourself. Start here → Setup Guide Then follow the course: |
🚀 I want to USEGet the core running quickly Perfect if you already know what you're doing and just want to test/extend the core. Start here → Quickstart Full reference docs: |
🎓 What You'll Build
By the end of this course, you'll have:
| Feature | Description |
|---|---|
| RV32I Zicsr Core | Full integer instruction set + CSR support |
| Interrupts & Exceptions | Privileged specs compliant |
| Cache System | Learn advanced state machines and AXI protocols by building configurable instruction & data caches |
| Complete SoC | UART, GPIO, etc Running on your FPGA, advanced tutorials even make you run DOOM ! |
| Real Software | C programs and bare-metal assembly thanks to the RISC-V open specs ! |
📖 Course Overview
🟢 Single Cycle Edition
[!TIP] Learn the fundamentals
Build the full RV32I instruction set from scratch in SystemVerilog. Test everything with cocotb.
You'll learn: ALU design, register files, control logic, instruction decoding, (very) basic verification.
🟢 FPGA Edition
[!TIP] Meet the real world
Add memory interfaces (AXI), design a cache system, and deploy on actual FPGA hardware.
You'll learn: basic bug bug packed caches, bus protocols, FPGA implementation challenges.
[!WARNING] Note : caches in this edition are pretty bad. I added them back then to have a basic interface woth the SoC that also explores cache and AXI basic but it is packed with bugs and extremely unefficient. You may skip it or explore your own solution there.
🟡 SoC & Software Edition (Contributors Only)
[!TIP] Make it useful
Pass RISC-V compliance tests, add interrupts, write C code, build driver libraries.
Note that for now, it's only available here for the early supporters of the project or advanced people looking to take it a step further verification wise. See ## Support the Project section.
You'll learn: Core verification, privileged architecture, interrupt handling, embedded C development, debug support.
🟡 Performance Edition (Contributors Only)
[!TIP] Maximise DOOM fps and overall perfs
This edition is out for contributors. See ## Support the Project section.
Note it may recieve further improvements later, especially if I need to pipeline the core.
🔴 Tapeout Edition (Coming Soon + I'm too broke)
Tapeout the HOLYCORE, one day maybe...
But before doing that, I really need to better the core architecture to make the most of each piece of hardware, right now, it's not really efficient.
A 2-3 stage pipeline with some double issue capabilities + some OoO execution while performing memory operations (which can cost time, especially on uncached / caches misses) would not hurt. If not, simplifying the design to use less
📊 Status
| Edition | Status |
|---|---|
| Single Cycle : base core | ✅ Complete |
| FPGA : implement and run on FPGA (but with lots of bugs) | ✅ Complete |
| SoC & Software : less bugs, full SoC, CSR and privileges support, traps, verification and C programs ! | ✅ Complete |
| Performance : Improve caches performances, fix caches bugs (lots of them lol) | ✅ Complete but can be improved |
Support the Project
The code is 100% open-source and always will be.
If you want to support the project and get nicely formatted PDF versions of the tutorials:
🤝 Contributing
Contributions are welcome! Typo fixes, documentation improvements, bug reports are all appreciated.
[!WARNING] Large architectural PRs have low chances of being merged. Open an issue first to discuss.
💪 Community Spotlight
- Check out VERY HOLY CORE by @jbeaurivage: a Veryl rewrite of the HOLY_CORE! Impressive, Very nice.
- The HOLY CORE has been used and cited in a research paper ! link. Its simple yet verified design is useful to reasearchers looking to better isolate problems in complex systems !
📜 A Note on AI & Content
Please don't scrape this content to train AI models or rebrand it for LinkedIn clout. Thanks. 🙏
Happy learning! 🎓
관련 프로젝트 살펴보기
불러오는 중…