# 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. 工程代码结构 ```text 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 硬件时,可先离线验证硬件自检状态机逻辑: ```bash ./ice/scripts/run_local_ice.sh ``` *预期输出:`== ICE LOCAL RUN: PASS ==`,日志保存在 `ice/sim_local/ice_run.log`。* ### 4.2 步骤 2:Palladium 硬件全编译 指定目标机台的主机名和板卡编号,执行一键编译脚本: ```bash 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` 并加载执行脚本: ```bash xeDebug -f ice/scripts/run_xedebug_ice.tcl ``` *(也可以启动交互模式 `xeDebug`,在 `XE>` 提示符下执行 `source ice/scripts/run_xedebug_ice.tcl`)* #### 运行流程自动化说明: 1. **`debug .`**:绑定当前工程的硬件特征签名; 2. **`host scz2_emu`**:建立到 Emulator 的 InfiniBand 高速链路并载入数据库; 3. **`xc on` / `download`**:将综合网表下载烧入物理机台; 4. **复位释放序列**:通过 `force z2_demo_ice_top.rst_n_in 0` $\to$ `run 20` $\to$ `force 1` 注入上电复位; 5. **运行时钟推进**:执行 `run 1000` 时钟周期,内置激励 FSM 会自动执行寄存器配置、中断比对、跑马灯移位验证并锁定状态; 6. **自动读取结果并判定**: ```text ======================================================= Palladium Z2 ICE 运行测试结果 ======================================================= led_done : 1 (测试序列是否完成,预期: 1) led_pass : 1 (全硬件检查是否通过,预期: 1) led_fail : 0 (是否有硬件检查失败,预期: 0) led_gpio : 0x02 (跑马灯寄存器旋转值,预期: 0x02) ------------------------------------------------------- >>> [SUCCESS] ICE DEMO 全部硬件自检测试通过! <<< ======================================================= ``` --- ## 5. SA 模式上机简要指南 1. **设置环境变量**: ```bash . ./scripts/env_z2.sh # 填入 XE_HOST, XE_BOARDS ``` 2. **IXCOM 协同编译**: ```bash ./scripts/compile_sa.sh # 产物生成在 ixcom_db/ ``` 3. **运行协同仿真**: ```bash cd ixcom_db xeDebug -f ../scripts/run_xedebug.tcl ``` 4. **查验日志**: ```bash grep -n "TEST PASSED" xeDebug.log ``` --- ## 6. 核心排障与踩坑经验总结 在本次 Demo 的调通调试中,总结了以下 4 个关键工程经验,供后续项目参考: 1. **纯硬件编译必须声明 DUT 边界**: - *问题现象*:仅传 `ixcom +top+z2_demo_ice_top`,编译虽然显示 SUCCESS 但只跑了 `nc elaborate`,运行 `xeDebug` 报 `no signature`,且找不到硬件数据库文件。 - *解决原因*:IXCOM 必须带 `-ua +dut+` 才会调用 AVS/xeCompile 生成真实的硬件比特流和特征签名。 2. **`xeDebug` 下 `host` 命令的前置依赖**: - *问题现象*:直接输入 `host scz2_emu` 报错 `the 'host' command is available only after debug command`。 - *解决原因*:在你的工具版本中,必须先执行 `debug .` 载入本地工程的特征签名上下文,然后才能调用 `host` 连入 Emulator 物理机。 3. **编译参数与脚本语法隔离**: - *问题现象*:命令行乱传 `-qel` 报 `Illegal option`;或在 Tcl 大括号内加双引号导致底层当作带引号文件名寻找失败。 - *解决原因*:IXCOM 原生通过环境变量接收机台与板卡资源;Tcl 脚本中路径统一使用绝对路径 `$ROOT/...` 并且无需加内部引号。 4. **ICE 模式的时钟与复位注入**: - *问题现象*:ICE 模式没有软件 Testbench 产生时钟或释放复位。 - *解决原因*:在无真实物理板卡输入时,可通过 `xeDebug` 脚本在下载后通过 `force rst_n_in 0` $\to$ `run` $\to$ `force rst_n_in 1` 注入上电脉冲,确保状态机正常跳出复位进入执行态。