Files
2026-11-02 14:54:39 +08:00
..
2026-10-31 15:16:37 +08:00
2026-10-31 15:16:37 +08:00
2026-10-31 15:16:37 +08:00
2026-10-31 15:16:37 +08:00
2026-10-31 15:16:37 +08:00

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)

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