8.5 KiB
Cadence Palladium Z3 硬件仿真 Demo:定时器外设(SA & ICE 双模式)
本仓库提供了一个可在 Cadence Palladium Z3 硬件仿真器上真正跑通的完整工程 Demo。设计以一个带 APB 风格总线的定时器外设(DUT)为核心,完整演示了 Palladium Z3 在 SA(Simulation Acceleration,仿真加速) 与 ICE(In-Circuit Emulation,在线硬件仿真) 两种核心工作模式下的编译、下载、时序驱动与调试全流程。
📘 特别推荐:针对 WXE24.05.000 / IXCOM24.05.000 版本下出现的
ASSERT_RESET缺失、HDLICE_HOME未设、xeCompile -z3识别异常、ver2hdl找不到以及 Z3 硬件配置文件冲突等系列疑难杂症,请查阅完整复盘方案: 👉 docs/PALLADIUM_Z3_24.05_SOLUTION.md
1. Palladium Z3 与 Z2 的关键区别与避坑指南
1.1 软件版本与底层动态库架构
- Z2 架构:工具链多基于早期的 VXE/WXE 版本,底层依赖位于
tools.lnx86/lib/z2/64bit/。 - Z3 架构:必须使用 25H1/WXE25.08+(例如
WXE25.08.s003),其针对 Z3 的底层通信与数据库核心库位于:$WXE_HOME/tools.lnx86/lib/z3/64bit/
1.2 避坑:解决 Cannot find 'et3lib' library in DBIN path
在 Palladium Z3 上运行 test_server 或启动编译调试时,若仅按 Z2 配置,常会遇到以下严重报错:
40 DATABASE | Cannot find 'et3lib' library in DBIN path
Critical Error: Severe error in db2, TERMINATING PROCESS.
Possible reasons - the configmgr is not running or has an incorrect IP address.
- wrong version of test_server. WXE sw is Palladium Z2 compatible only.
Error: BEDB SEVERE ERROR
原因与解决方案:
- 动态库路径缺失:系统动态链接器和后端数据库(DB2/BEDB)在
DBIN路径下未找到et3lib。 在环境变量中必须加入:export LD_LIBRARY_PATH=/home/software/WXE25.08.s003/tools.lnx86/lib/z3/64bit:$LD_LIBRARY_PATH export DBIN=/home/software/WXE25.08.s003/tools.lnx86/lib/z3/64bit:$DBIN - 硬件代际声明:明确设置环境变量声明当前目标机型为 Z3:
export XE_TARGET="z3" export PALLADIUM_TARGET="z3" export CDS_PALLADIUM_SERIES="z3" - 后台管理进程
configmgr:test_server依赖后台的 Config Manager 进程,需确认configmgr监听正常且与机箱管理网口通信正常。
本工程提供了一键自检脚本
scripts/check_z3_server.sh,可全自动排查上述问题!
2. 工程目录结构
palladium_z3_demo/
├── .gitignore # 过滤编译与仿真生成的中间库
├── README.md # 本说明文档
├── rtl.f / tb.f # SA 模式文件列表清单
│
├── rtl/ # 【DUT 硬件源码】
│ └── z3_demo_top.v # 定时器外设 RTL (ID: 0x5A33_0001)
├── tb/ # 【SA 模式 Testbench】
│ └── tb_z3_demo.v # 宿主机端软件 TB (APB 激励、中断等待与判读)
├── scripts/ # 【工程与上机脚本】
│ ├── env_z3.sh # ★ 核心环境配置文件 (集成 Z3 动态库与 DBIN)
│ ├── check_z3_server.sh # ★ test_server / configmgr 连通性一键体检脚本
│ ├── compile_sa.sh # SA 模式 IXCOM 硬件加速编译脚本
│ ├── run_xedebug.tcl # SA 模式 xeDebug 上机加载与运行脚本
│ └── run_local.sh # SA 本地免硬件验证脚本 (iverilog/xrun)
│
└── ice/ # 【ICE 全硬件仿真模式】
├── rtl/
│ ├── z3_demo_top.v # DUT 副本
│ └── z3_demo_ice_top.v # ICE 顶层 (集成硬件自检 FSM 与状态 LED 输出)
├── tb/
│ └── tb_z3_demo_ice.v # 本地验证 ICE 自检状态机的仿真测试平台
└── scripts/
├── compile_ice.sh # ★ ICE 模式硬件全逻辑编译脚本
├── run_xedebug_ice.tcl # ★ ICE 模式上机下载与状态读取判断脚本
└── run_local_ice.sh # ICE 本地离线免硬件验证脚本
3. 硬件 DUT 规格(z3_demo_top)
DUT 是一个可综合的标准 APB 从设备,具备丰富的交互特性:
- 基地址偏移 8 位;
- 只读特征码:
0x18偏移处的 ID 寄存器为0x5A33_0001(Z3 专属 Signature); - 倒计数器与重载:
CTRL[0]使能计数,从LOAD(0x04)递减至 0 并自动重载; - 中断与比较:
COUNT == CMP触发cmp_hit脉冲并置位标志;计数归零触发irq中断; - 状态写 1 清零(W1C):
STATUS(0x10)超时标志与比较标志支持写 1 清除; - 跑马灯(GPIO 旋转):
CTRL[2]=1时,每次倒计数超时将自动左移 8 位图案,便于在波形/引脚上直观监测。
寄存器映射表
| 偏移地址 | 寄存器名称 | 读写属性 | 复位值 | 详细说明 |
|---|---|---|---|---|
0x00 |
CTRL | RW | 0x00 |
[0] 计数使能 (enable)[1] 中断使能 (irq_en)[2] 跑马灯使能 (pattern_en) |
0x04 |
LOAD | RW | 0x09 |
计数器重载值 (写入时直接同步预置当前计数) |
0x08 |
COUNT | RO | 0x09 |
当前实时倒计数值 |
0x0C |
CMP | RW | 0x03 |
比较匹配值 |
0x10 |
STATUS | W1C | 0x00 |
[0] 超时中断标志[1] 比较匹配标志 |
0x14 |
GPIO | RW | 0x01 |
8 位输出图案寄存器 (超时自动循环移位) |
0x18 |
ID | RO | 0x5A33_0001 |
Palladium Z3 硬件签名 |
4. 模式一:SA 模式(仿真加速)快速上手
在 SA 模式下,DUT 运行在 Palladium Z3 物理硬件中,而Testbench 运行在 Host 主机端(Xcelium),两者通过高速通道协同交互。
第一步:排查并确保硬件服务连通
# 1. 导入 Z3 专用环境变量
source scripts/env_z3.sh
# 2. 运行一键体检脚本,确保 test_server 与 configmgr 正常
./scripts/check_z3_server.sh
第二步:编译硬件与软件协同工程
./scripts/compile_sa.sh
该脚本将生成 ixcom_db/ 目录以及映射进 Z3 的硬件网表和 Host 端仿真数据库。
第三步:上机下载与测试
cd ixcom_db
xeDebug -f ../scripts/run_xedebug.tcl
运行输出将显示在终端和 xeDebug.log 中:
[PASS] Check 1: Z3 ID register match (0x5A330001)
[PASS] Check 2: Default COUNT is 9
[PASS] Check 3: Timer interrupt (irq) asserted!
[PASS] Check 4: STATUS register bits set (timeout & cmp: 0x00000003)
[PASS] Check 5: STATUS cleared via W1C
[PASS] Check 6: GPIO pattern rotated to 0x02
==========================================================
TEST PASSED: ALL 6 CHECKS COMPLETED ON Z3 !
==========================================================
5. 模式二:ICE 模式(在线硬件仿真)快速上手
在 ICE 模式下,没有 Host 端的软件 Testbench。激励生成、总线访问与断言判读由纯硬件状态机(z3_demo_ice_top.v)在机台内部全速自主完成。
第一步:编译 ICE 顶层全硬件网表
source scripts/env_z3.sh
./ice/scripts/compile_ice.sh
第二步:下载进 Palladium Z3 并自动判读
xeDebug -input ice/scripts/run_xedebug_ice.tcl
脚本将硬件引脚读回终端:
led_done = 1:自检执行完毕;led_pass = 1,led_fail = 0:所有硬件级断言均通过;led_gpio = 0x02:跑马灯正常移位;- 打印:
===> [TEST PASSED] Palladium Z3 ICE 全硬件测试通过!。
6. 上机实测通过日志(Palladium Z3 Hardware Verification)
XEin> debug .
XEin> host z7f1x8c-5k9p3m
XEin> xc on -run
XEin> after 2000
==========================================================
led_done : 1'b1
led_pass : 1'b1
led_fail : 1'b0
led_gpio : 8'b00000010
===> [TEST PASSED] Palladium Z3 ICE 全硬件测试通过!
==========================================================
7. 本地离线免硬件验证(Smoke Test)
如果当前没有连接到 Palladium Z3 硬件,可随时在工作站上离线验证逻辑:
# 验证 SA 模式逻辑:
./scripts/run_local.sh
# 验证 ICE 模式硬件状态机逻辑:
./ice/scripts/run_local_ice.sh
两者均支持 Icarus Verilog (iverilog) 或 Cadence Xcelium (xrun)。