香山(XiangShan)是一款开源的高性能 RISC-V 处理器。
English Readme is here.
©2020-2022 中国科学院计算技术研究所版权所有
©2020-2022 鹏城实验室版权所有
XiangShan-doc 是我们的官方文档仓库,其中包含了设计文档、技术报告、使用教程等内容。
- 香山微结构文档已经发布,欢迎访问 https://xiangshan-doc.readthedocs.io
Wechat/微信:香山开源处理器
Zhihu/知乎:香山开源处理器
Weibo/微博:香山开源处理器
可以通过我们的邮件列表联系我们。列表中的所有邮件会存档到这里。
自 2020 年 6 月开始开发的雁栖湖为香山处理器的首个稳定的微架构。目前版本的香山(即南湖)正在 master 分支上不断开发中。
以下是一些关键目录:
.
├── src
│ └── main/scala # 设计文件
│ ├── device # 用于仿真的虚拟设备
│ ├── system # SoC 封装
│ ├── top # 顶层模块
│ ├── utils # 复用封装
│ ├── xiangshan # 主体设计代码
│ └── xstransforms # 一些实用的 firrtl 变换代码
├── scripts # 用于敏捷开发的脚本文件
├── fudian # 香山浮点子模块
├── huancun # 香山 L2/L3 缓存子模块
├── difftest # 香山协同仿真框架
└── read-to-run # 预建的仿真镜像文件
make bsp
make idea
- 运行
make verilog
以生成 verilog 代码。输出文件为build/XSTop.v
。 - 更多信息详见
Makefile
。
- 设定环境变量
NEMU_HOME
为香山 NEMU 在您机器上的绝对路径。 - 设定环境变量
NOOP_HOME
为香山工程文件夹的绝对路径。 - 设定环境变量
AM_HOME
为香山 AM 的绝对路径。 - 项目使用
mill
进行 scala 编译,因此需要安装mill
,详见 mill 手动安装指南(目前仅英文版本)。 - 克隆本项目,运行
make init
以初始化本项目引用的开源子模块。
- 安装开源 verilog 仿真器 Verilator。
- 运行
make emu
以利用 Verilator 构建 C++ 仿真器./build/emu
。 - 运行
./build/emu --help
可以获得仿真器的各种运行时参数。 - 更多细节详见
Makefile
与verilator.mk
。
运行示例:
make emu CONFIG=MinimalConfig EMU_THREADS=2 -j10
./build/emu -b 0 -e 0 -i ./ready-to-run/coremark-2-iteration.bin --diff ./ready-to-run/riscv64-nemu-interpreter-so
在香山的开发过程中,我们采用了来自开源社区的子模块。具体情况如下:
子模块 | 来源 | 详细用途 |
---|---|---|
L2 Cache/LLC | Sifive block-inclusivecache | 我们的新 L2/L3 缓存设计受到了 Sifive block-inclusivecache 的启发. |
Diplomacy/TileLink | Rocket-chip | 我们复用了来自 rocket-chip 的 Diplomacy 框架和 Tilelink 工具,来协商总线. |
我们深深地感谢来自开源社区的支持,我们也鼓励其他开源项目在木兰宽松许可证的范围下复用我们的代码。