Files

98 lines
5.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`。
需要哪个方向,说一声就接着做。