This commit is contained in:
Your Name
2026-10-31 15:16:37 +08:00
commit 0eb79b43c8
16 changed files with 1491 additions and 0 deletions
+117
View File
@@ -0,0 +1,117 @@
# ZeBu Server 4 PCIe Gen5 Virtual Host 仿真 Demo
基于 Synopsys ZeBu Server 4 的 PCIe 5.0 仿真示例工程:DUT 是一个 PCIe Gen5
Endpoint 示例设计(配置空间 + BAR 寄存器 + 片上 RAM + 简单 DMA 引擎),
主机侧不使用真实 Root Complex 硬件,而是通过 **Virtual Host(vhost)** 方式:
运行在工作站上的 C++ 测试程序经 SCE-MI transactor 把 PCIe 事务(Config /
Memory TLP)送入仿真中的 DUT,完成枚举、BAR 访问、DMA 搬运和 MSI 中断验证。
链路在 vhost 模型中协商为 **Gen5(32.0 GT/s)x16**:DUT 配置空间的 PCIe
Capability 中 Link Capabilities.Max Link Speed = 6(32 GT/s),Link Status
回读协商速率/宽度,测试程序会校验这一点。
> 说明:硬件仿真中 PCIe 链路是事务级虚拟链路,不存在真实 32GT/s 串行信号,
> Gen5 体现在协议能力(配置空间、TLP、链路能力协商)层面,这是 vhost 方式的
> 标准做法。
## 架构
```
工作站 (csh) ZeBu Server 4
┌────────────────────────────┐ SCE-MI ┌──────────────────────────────┐
│ sw/vhost/main.cpp │ Message │ tb/pcie_vhost_xtor.sv │
│ - 枚举/配置空间读写 │ In/Out Port │ - 消息 <-> TLP 转换 │
│ - BAR scratch 测试 │◄────────────►│ - 时钟控制 (ClockControl) │
│ - DMA H2D / D2H + 数据比对 │ │ │ TLP │
│ - MSI 中断等待 │ │ ▼ │
│ pcie_vhost_api (SCE-MI C++)│ │ rtl/pcie5_ep_core.sv (DUT) │
└────────────────────────────┘ │ - PCIe 配置空间 (Gen5 Cap) │
│ - BAR0 寄存器 / BAR2 RAM │
│ - DMA 引擎 / MSI │
└──────────────────────────────┘
```
## 目录结构
```
zebu_pcie5_vhost_demo/
├── README.md
├── scripts/ # 全部 csh 脚本
│ ├── env.csh # 环境变量(ZEBU_ROOT / license / 路径,按站点修改)
│ ├── compile.csh # zCui 编译 DUT + transactor
│ ├── run.csh # 编译并运行 vhost C++ 测试程序
│ └── clean.csh
├── cfg/
│ ├── zebu_compile.utf # zCui 编译入口(UTF,与站点 ZeBu IP 示例同构)
│ └── scemi.parameters # SCE-MI 运行时参数
├── rtl/
│ ├── filelist.f
│ ├── pcie_pkg.sv # TLP 类型/参数定义
│ ├── pcie5_ep_core.sv # DUT:PCIe Gen5 Endpoint 示例核
│ └── pcie5_demo_top.sv # 仿真顶层
├── tb/
│ └── pcie_vhost_xtor.sv # SCE-MI transactor(vhost 桥)
└── sw/vhost/
├── pcie_vhost_api.h # vhost 高层 C++ API
├── pcie_vhost_zebu.cpp # SCE-MI 后端实现
├── main.cpp # 测试主程序
└── Makefile
```
## 前置条件
- ZeBu Server 4 硬件及对应版本的 zCui / 运行时(`ZEBU_ROOT`)
- ZeBu 编译与运行时 license;如使用 Synopsys 官方 PCIe Virtual Device
许可包,可用其替换本 demo 的通用 transactor(接口对齐方式见 tb/ 注释)
- 工作站装有 GCC(编译 C++ vhost 程序)、csh/tcsh
## 使用步骤(csh)
```csh
cd zebu_pcie5_vhost_demo
source scripts/env.csh # 先按本机环境改 ZEBU_ROOT 和 license
./scripts/compile.csh # zCui 编译,产物在 zebu.work/
./scripts/run.csh # 运行 vhost 测试,输出 PASS/FAIL
./scripts/clean.csh # 清理
```
## 测试内容(sw/vhost/main.cpp)
1. **链路校验**:读 PCIe Link Status,期望 Speed = 6(Gen5 32 GT/s)、Width = x16
2. **枚举**:读配置空间 0x00,期望 VID/DID = 0x16C3 / 0x5805;读 Class Code、BAR
3. **BAR0 寄存器测试**:ID 寄存器只读校验、SCRATCH 寄存器多组 pattern 读写
4. **BAR2 RAM 测试**:经 Memory Write/Read TLP 写入 4KB 数据并回读比对
5. **DMA 测试**:主机内存 -> 设备 RAM(H2D)、设备 RAM -> 主机内存(D2H),
全量数据比对;DMA 完成后等待 MSI 中断并校验 IRQ 状态寄存器
全部通过时结尾打印 `TEST PASSED`。
## DUT 寄存器表(BAR0)
| 偏移 | 名称 | 说明 |
|------|------|------|
| 0x00 | ID | 只读,固定 0x50354531("PE51") |
| 0x04 | VERSION | 只读,0x00010000 |
| 0x08 | CTRL | bit0 DMA 启动(自清零),bit1 中断使能,bit2 DMA 方向(0=H2D,1=D2H) |
| 0x0C | STATUS | bit0 DMA busy,bit1 DMA done,bit2 link up |
| 0x10 | SCRATCH | 读写 scratch |
| 0x14 | IRQ_STATUS | bit0 DMA 完成中断,写 1 清除 |
| 0x18 | DMA_HOST_ADDR_LO | 主机内存地址低 32 位 |
| 0x1C | DMA_HOST_ADDR_HI | 主机内存地址高 32 位 |
| 0x20 | DMA_LEN | 搬运字节数(4 的倍数) |
| 0x24 | DMA_DEV_OFFSET | 设备 RAM 内偏移 |
BAR2:64KB 设备 RAM(Memory 空间)。
## 注意事项
- 编译入口 `cfg/zebu_compile.utf` 按站点 ZeBu IP 示例(example_wrapper.utf)
的结构编写,compile.csh 以 `zCui -c -n -u cfg/zebu_compile.utf -w $ZEBU_WORK`
方式调用。UTF 里用到的 `FILE_CONF`(板卡架构文件)和 `REMOTECMD`(grid
提交命令)需在 `scripts/env.csh` 中按站点环境填好。
- 若 VCS 前端报 SceMi* 模块未定义,需要把 $ZEBU_ROOT 下的 SCE-MI
SystemVerilog 库路径补进 zebu_compile.utf 的 vcs_exec_command(.utf 里有注释)。
- vhost 侧的"主机内存地址"是 vhost 模型维护的虚拟主机地址空间,DMA 测试
数据由 C++ 程序在该地址空间内准备和校验,不涉及工作站真实物理内存 DMA。
- 本 demo 在普通工作站上无法独立运行(需要 ZeBu 硬件与 license),RTL /
transactor / C++ 均按可综合、可编译标准编写,交付后请在 ZeBu 环境联调。