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)
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)
- 链路校验:读 PCIe Link Status,期望 Speed = 6(Gen5 32 GT/s)、Width = x16
- 枚举:读配置空间 0x00,期望 VID/DID = 0x16C3 / 0x5805;读 Class Code、BAR
- BAR0 寄存器测试:ID 寄存器只读校验、SCRATCH 寄存器多组 pattern 读写
- BAR2 RAM 测试:经 Memory Write/Read TLP 写入 4KB 数据并回读比对
- 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 环境联调。