12 KiB
12 KiB
Cadence Palladium Z2 硬件仿真 Demo:可编程定时器外设(SA & ICE 双模式)
本仓库提供了一个可在 Cadence Palladium Z2 硬件仿真器上真正跑通的完整工程 Demo。设计以一个带 APB 风格寄存器总线的定时器外设(DUT)为核心,完整演示了 Palladium Z2 在 SA(Simulation Acceleration,仿真加速) 与 ICE(In-Circuit Emulation,在线硬件仿真) 两种核心工作模式下的编译、下载、时序驱动与调试全流程。
1. 这个 Demo 可以干什么?
本 Demo 主要用于团队内 熟悉 Palladium Z2 流程、上机环境验证、自动化回归脚本基线以及 SA/ICE 选型对比。
1.1 DUT 核心功能
DUT 是一个完整可综合的定时器外设,具备丰富的可观察行为:
- 总线读写:标准的 APB 风格总线接口(
paddr,pwdata,prdata,pwrite,psel,penable,单拍快速响应); - 倒计数定时器:由使能位控制,从
LOAD预置值逐拍递减到 0; - 比较器与中断:计数器匹配到
CMP时产生单拍cmp_hit脉冲;计数递减到 0 触发中断irq并自动重载; - 状态标志与 W1C:超时标志与比较标志支持写 1 清零(Write-1-to-Clear);
- 动态跑马灯(GPIO 旋转):开启图案使能后,每次超时中断会自动将 8 位图案寄存器向左循环移位一次——在波形或引脚上呈现出跑马灯效果,用于最直观判断硬件是否真正走时;
- 身份标识寄存器:固定只读值
0x5A32_0001,用于验证总线通路完整性。
1.2 寄存器映射表(Base: 8-bit offset)
| 偏移地址 | 寄存器名称 | 读写属性 | 复位默认值 | 详细说明 |
|---|---|---|---|---|
0x00 |
CTRL | RW | 0x0000_0000 |
[0] 计数使能 (enable)[1] 中断使能 (irq_en)[2] 跑马灯使能 (pattern_en) |
0x04 |
LOAD | RW | 0x0000_0009 |
计数器重载值;写入该寄存器会同时同步预置当前计数器 |
0x08 |
COUNT | RO | 0x0000_0009 |
实时当前倒计数值 |
0x0C |
CMP | RW | 0x0000_0003 |
比较匹配值(当 COUNT == CMP 时置标志) |
0x10 |
STATUS | W1C | 0x0000_0000 |
[0] 超时中断标志位 (timeout)[1] 比较匹配标志位 (cmp),写 1 清除 |
0x14 |
GPIO | RW | 0x0000_0001 |
8 位输出图案寄存器,每次超时左移一位 |
0x18 |
ID | RO | 0x5A32_0001 |
外设硬件版本特征常量,用于快速确认通信通路 |
2. SA 模式 vs ICE 模式深度对比
本工程最大的特点是同一份 DUT 代码,实现 SA 与 ICE 双模式跑通:
[同一份硬件设计 DUT: z2_demo_top.v]
│
┌─────────────────────────┴─────────────────────────┐
▼ ▼
【SA 模式 (仿真加速)】 【ICE 模式 (硬件在线仿真)】
┌──────────────────────┐ ┌─────────────────────────────────┐
│ Host 侧 (Xcelium) │ │ Palladium 硬件内部 │
│ tb_z2_demo.v │ │ ┌─────────────────────────────┐ │
│ (时钟/复位/激励) │ │ │ 内置硬件自检 FSM (激励/检查)│ │
└──────────┬───────────┘ │ └──────────────┬──────────────┘ │
│ (InfiniBand 协同通信) │ (纯硬件内部总线互联) │
▼ ▼ │
┌──────────────────────┐ │ ┌─────────────────────────────┐ │
│ Palladium 硬件 │ │ │ z2_demo_top (DUT) │ │
│ z2_demo_top (DUT) │ │ └──────────────┬──────────────┘ │
└──────────────────────┘ │ │ 引脚输出 │
│ led_pass / led_fail / led_gpio │
└─────────────────────────────────┘
| 维度对比 | SA 模式(Simulation Acceleration) | ICE 模式(In-Circuit Emulation) |
|---|---|---|
| 代码位置 | 根目录(rtl/、tb/、scripts/) |
ice/ 目录(ice/rtl/、ice/scripts/) |
| Testbench 归属 | 留在 Host 工作站(Xcelium 仿真器),为软件 TB | 没有软件 TB,激励是硬件化的可综合 FSM,与 DUT 一同烧入硬件 |
| 时钟与复位 | TB 内部由软件时钟驱动(always #5 clk = ~clk) |
依赖机台时钟/外部 Target/脚本强制注入激励 |
| 编译命令 | ixcom -ua +dut+z2_demo_top -f rtl.f -f tb.f |
ixcom -clean -ua +dut+z2_demo_ice_top ... (触发 xeCompile) |
| 测试结果读取 | 在 xeDebug.log / 终端中打印 CHECK OK / TEST PASSED |
读取顶层引脚信号:led_pass=1, led_fail=0, led_gpio=0x02 |
| 适用工程场景 | 复杂软件驱动、UVM 测试平台、调试验证逻辑功能 | 接真实 Target 板、芯片全系统上电、长时运行跑马灯或操作系统引导 |
3. 工程代码结构
palladium_z2_demo/
├── .gitignore # 过滤所有 Palladium/Xcelium 编译数据库与波形文件
├── README.md # 本说明文档
├── README_中文教程.md # SA 模式中文教程
├── README_ICE对比_中文教程.md # ICE 模式对比教程
├── rtl.f / tb.f # SA 模式文件列表清单
│
├── rtl/ # 【DUT 源码】
│ └── z2_demo_top.v # 定时器外设 RTL
├── tb/ # 【SA 模式 Testbench】
│ └── tb_z2_demo.v # 软件 TB(发 APB 读写、等中断、自动判读)
├── scripts/ # 【SA 模式脚本】
│ ├── env_z2.sh # 环境变量模板(XE_HOST, XE_BOARDS)
│ ├── compile_sa.sh # SA 模式 IXCOM 编译脚本
│ ├── run_xedebug.tcl # SA 模式运行脚本(xc on -run)
│ └── run_local.sh # SA 本地免硬件验证(iverilog/xrun)
│
└── ice/ # 【ICE 模式专区】
├── rtl/
│ ├── z2_demo_top.v # DUT 副本(与根目录逐字节相同)
│ └── z2_demo_ice_top.v # ICE 顶层(集成硬件自检 FSM + 判读 LED)
├── tb/
│ └── tb_z2_demo_ice.v # 本地离线验证 ICE FSM 的脚手架
├── scripts/
│ ├── compile_ice.sh # ★ ICE 模式 Palladium 硬件编译主脚本(已调通)
│ ├── run_xedebug_ice.tcl # ★ ICE 模式 Palladium 上机下载与测试判读脚本(已调通)
│ └── run_local_ice.sh # ICE 本地离线功能验证脚本
└── sim_local/
└── ice_run.log # 本地验证参考通过日志
4. ICE 模式上机全操作指南(已实测跑通)
4.1 步骤 1:本地免硬件离线验证(可选)
在没有分配到 Emulator 硬件时,可先离线验证硬件自检状态机逻辑:
./ice/scripts/run_local_ice.sh
预期输出:== ICE LOCAL RUN: PASS ==,日志保存在 ice/sim_local/ice_run.log。
4.2 步骤 2:Palladium 硬件全编译
指定目标机台的主机名和板卡编号,执行一键编译脚本:
XE_HOST=scz2_emu XE_BOARDS=18.0 ./ice/scripts/compile_ice.sh
底层机制:脚本会自动调用 ixcom -clean -ua +dut+z2_demo_ice_top,拉起 AVS 与 xeCompile 进行芯片级映射,编译成功将显示 Successfully built target (xeCompile) 并生成 AxisWork 与 xc_work 硬件数据库。
4.3 步骤 3:上机下载与测试
在工程根目录下启动 xeDebug 并加载执行脚本:
xeDebug -f ice/scripts/run_xedebug_ice.tcl
(也可以启动交互模式 xeDebug,在 XE> 提示符下执行 source ice/scripts/run_xedebug_ice.tcl)
运行流程自动化说明:
debug .:绑定当前工程的硬件特征签名;host scz2_emu:建立到 Emulator 的 InfiniBand 高速链路并载入数据库;xc on/download:将综合网表下载烧入物理机台;- 复位释放序列:通过
force z2_demo_ice_top.rst_n_in 0\torun 20\toforce 1注入上电复位; - 运行时钟推进:执行
run 1000时钟周期,内置激励 FSM 会自动执行寄存器配置、中断比对、跑马灯移位验证并锁定状态; - 自动读取结果并判定:
=======================================================
Palladium Z2 ICE 运行测试结果
=======================================================
led_done : 1 (测试序列是否完成,预期: 1)
led_pass : 1 (全硬件检查是否通过,预期: 1)
led_fail : 0 (是否有硬件检查失败,预期: 0)
led_gpio : 0x02 (跑马灯寄存器旋转值,预期: 0x02)
-------------------------------------------------------
>>> [SUCCESS] ICE DEMO 全部硬件自检测试通过! <<<
=======================================================
5. SA 模式上机简要指南
- 设置环境变量:
. ./scripts/env_z2.sh # 填入 XE_HOST, XE_BOARDS - IXCOM 协同编译:
./scripts/compile_sa.sh # 产物生成在 ixcom_db/ - 运行协同仿真:
cd ixcom_db xeDebug -f ../scripts/run_xedebug.tcl - 查验日志:
grep -n "TEST PASSED" xeDebug.log
6. 核心排障与踩坑经验总结
在本次 Demo 的调通调试中,总结了以下 4 个关键工程经验,供后续项目参考:
- 纯硬件编译必须声明 DUT 边界:
- 问题现象:仅传
ixcom +top+z2_demo_ice_top,编译虽然显示 SUCCESS 但只跑了nc elaborate,运行xeDebug报no signature,且找不到硬件数据库文件。 - 解决原因:IXCOM 必须带
-ua +dut+<top>才会调用 AVS/xeCompile 生成真实的硬件比特流和特征签名。
- 问题现象:仅传
xeDebug下host命令的前置依赖:- 问题现象:直接输入
host scz2_emu报错the 'host' command is available only after debug command。 - 解决原因:在你的工具版本中,必须先执行
debug .载入本地工程的特征签名上下文,然后才能调用host连入 Emulator 物理机。
- 问题现象:直接输入
- 编译参数与脚本语法隔离:
- 问题现象:命令行乱传
-qel报Illegal option;或在 Tcl 大括号内加双引号导致底层当作带引号文件名寻找失败。 - 解决原因:IXCOM 原生通过环境变量接收机台与板卡资源;Tcl 脚本中路径统一使用绝对路径
$ROOT/...并且无需加内部引号。
- 问题现象:命令行乱传
- ICE 模式的时钟与复位注入:
- 问题现象:ICE 模式没有软件 Testbench 产生时钟或释放复位。
- 解决原因:在无真实物理板卡输入时,可通过
xeDebug脚本在下载后通过force rst_n_in 0\torun\toforce rst_n_in 1注入上电脉冲,确保状态机正常跳出复位进入执行态。