5.5 KiB
Palladium Z2 仿真 Demo:寄存器型定时器外设(SA 模式)
一个可以真正跑通的最小完整 demo:一个带 APB 风格寄存器接口的定时器外设(DUT),配自检 testbench,走完 Palladium Z2 的标准流程——本地逻辑验证 → IXCOM 编译(SA 模式)→ xeDebug 下载运行 → 看检查结果。设计特意做得小而完整:有寄存器读写、有中断、有可观察的 GPIO 跑马灯模式,波形和日志都有的可看。
本地验证状态:RTL + TB 已在 Icarus Verilog 下实际跑过,8 项检查全部通过(日志在
sim_local/local_run.log)。Palladium 侧的编译/运行脚本按《Palladium Z2 Emulator》与《IXCOM 编译》教程的命令骨架编写,首次上机时请用目标机上对应 VXE release 的ixcom -help/ xeDebughelp核对参数拼写(脚本中已标注)。
1. Demo 里有什么
| 文件 | 说明 |
|---|---|
rtl/z2_demo_top.v |
DUT:寄存器映射定时器 + 比较器 + GPIO 图案发生器 + 中断 |
tb/tb_z2_demo.v |
自检 TB:APB 读写任务、8 项检查、打印 TEST PASSED/FAILED |
rtl.f / tb.f |
文件列表 |
scripts/run_local.sh |
无硬件验证(iverilog,或改用 xrun 纯仿真) |
scripts/env_z2.sh |
Z2 SA 模式环境变量模板(XE_HOST / XE_BOARDS / DBE_HOST) |
scripts/compile_sa.sh |
IXCOM 编译:ixcom -ua +dut+z2_demo_top ... |
scripts/run_xedebug.tcl |
xeDebug 运行脚本:host → xc on -run → 看 TB 输出 |
sim_local/ |
本地运行产物:日志、VCD 波形、vvp |
2. DUT 设计说明
总线是简化的 APB 风格(pready 恒 1,单周期完成),只译码低 8 位地址。寄存器表:
| 地址 | 名称 | 属性 | 说明 |
|---|---|---|---|
| 0x00 | CTRL | RW | [0]=enable [1]=irq_en [2]=pattern_en |
| 0x04 | LOAD | RW | 倒计数重装值;写 LOAD 同时预置 COUNT |
| 0x08 | COUNT | RO | 当前计数值 |
| 0x0C | CMP | RW | 比较值:COUNT==CMP 时置位 cmp 标志并脉冲 cmp_hit |
| 0x10 | STATUS | W1C | [0]=timeout 标志 [1]=cmp 标志,写 1 清除 |
| 0x14 | GPIO | RW | 8 位图案寄存器,直接驱动 gpio_out |
| 0x18 | ID | RO | 常量 0x5A32_0001,上机第一件事先读它验证总线通路 |
行为:enable 后 COUNT 每拍递减;减到 0 时置 timeout 标志、(irq_en 时)拉高 irq、从 LOAD 重装;若 pattern_en 开着,每次 timeout 时 GPIO 左旋一位——在波形/GUI 里就是一个跑马灯,是判断"设计在硬件上真的在跑"最直观的信号。
TB 的 8 项检查:ID 寄存器、LOAD 默认值(9)、LOAD 编程值(19)、timeout 中断产生、STATUS 双标志置位、GPIO 图案旋转(0x01→0x02)、W1C 清标志、关 enable 后 COUNT 冻结。
3. 第一步:本地验证(不需要硬件)
cd palladium_z2_demo
./scripts/run_local.sh
预期输出(节选,完整版在 sim_local/local_run.log):
CHECK OK : ID register = 0x5a320001
CHECK OK : irq raised on timeout = 0x00000001
CHECK OK : GPIO pattern rotated = 0x00000002
...
TEST PASSED (all checks)
== LOCAL RUN: PASS ==
波形在 sim_local/z2_demo.vcd,可用 GTKWave 打开看 reg_count 递减、irq 拉高的位置。
4. 第二步:在 Palladium Z2 上跑(SA 模式)
前提(按 Z2 教程):主机装有 VXE release;设计目录对 host 可见且路径与运行 xeDebug 的工作站一致;xeDebug 必须在 SA host 上运行。
# 1) 填好环境变量(env_z2.sh 里三处 <...> 改成你现场的值)
. ./scripts/env_z2.sh # XE_HOST / XE_BOARDS / VXE_HOME
# 2) IXCOM 编译:DUT 映射进 emulator,TB 留在 host 仿真器侧
./scripts/compile_sa.sh # 产物在 ixcom_db/,日志 compile_sa.log
# 3) 在 SA host 上、ixcom_db 目录里启动 xeDebug 运行
cd ixcom_db
xeDebug -f ../scripts/run_xedebug.tcl
run_xedebug.tcl 做的事:host <XE_HOST> 连接 emulator → xc on -run 下载并启动 → TB 在 host 侧驱动总线跑完 8 项检查。
判断成功:SA 模式下 xmsim 没有单独日志,TB 的打印合并在 xeDebug.log 里,查:
grep -n "CHECK\|TEST" xeDebug.log
grep -n -E '\*E,|\*F,|ERROR|FATAL' xeDebug.log # 有问题时先看这里
5. 上机排障提示(来自 Z1 实战经验)
- 运行像卡住时不要先杀进程:先确认
xc_top.simTime是否还在前进;再对 xmsim 主线程取两次gstack采样对比——主线程 R 状态满 CPU 通常是 TB 零时间循环,在睡则查别处。杀掉一个跑了很久的会话代价很大,先做无损检查。 - 下载前查资源:
XE_BOARDS填的 boards 要与现场分配一致;多人共用时可用XE_JOBID给作业打标签。 - 反复调试同一设计:可在 xeDebug 里
xeset keepHostAliveTimeout <秒数>保持连接复用,省掉每次重连+下载的时间(脚本里有注释行)。 - 先本地、后上机:改 RTL/TB 后先跑
run_local.sh复现,本地不过就不要占 emulator 时间。
6. 可以继续扩展的方向
- 把 CMP 中断也接出来,做双中断源 + 中断屏蔽寄存器;
- TB 换成 UVM/纯 SV 版本,练 IXCOM 下的 TB 划分(哪些类/任务能留在 host 侧);
- 同一 DUT 改走 ICE 模式:用
xeCompile+emulatorConfiguration编译,对比两种模式的流程差异; - 加一个简单的 UART TX,把 timeout 事件以串口字符输出,配合 SpeedBridge/target 连接练习
+targetTop。
需要哪个方向,说一声就接着做。