# 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 环境联调。