98 lines
5.5 KiB
Markdown
98 lines
5.5 KiB
Markdown
# 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` / xeDebug `help` 核对参数拼写(脚本中已标注)。
|
||
|
||
## 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. 第一步:本地验证(不需要硬件)
|
||
|
||
```bash
|
||
cd palladium_z2_demo
|
||
./scripts/run_local.sh
|
||
```
|
||
|
||
预期输出(节选,完整版在 `sim_local/local_run.log`):
|
||
|
||
```text
|
||
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 上运行**。
|
||
|
||
```bash
|
||
# 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`** 里,查:
|
||
|
||
```bash
|
||
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`。
|
||
|
||
需要哪个方向,说一声就接着做。
|