Files

195 lines
8.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.
# 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](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 的底层通信与数据库核心库位于:
```bash
$WXE_HOME/tools.lnx86/lib/z3/64bit/
```
### 1.2 避坑:解决 `Cannot find 'et3lib' library in DBIN path`
在 Palladium Z3 上运行 `test_server` 或启动编译调试时,若仅按 Z2 配置,常会遇到以下严重报错:
```text
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
```
**原因与解决方案**:
1. **动态库路径缺失**:系统动态链接器和后端数据库(DB2/BEDB)在 `DBIN` 路径下未找到 `et3lib`。
在环境变量中必须加入:
```bash
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
```
2. **硬件代际声明**:明确设置环境变量声明当前目标机型为 Z3:
```bash
export XE_TARGET="z3"
export PALLADIUM_TARGET="z3"
export CDS_PALLADIUM_SERIES="z3"
```
3. **后台管理进程 `configmgr`**:`test_server` 依赖后台的 Config Manager 进程,需确认 `configmgr` 监听正常且与机箱管理网口通信正常。
> 本工程提供了一键自检脚本 `scripts/check_z3_server.sh`,可全自动排查上述问题!
---
## 2. 工程目录结构
```text
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`)<br>`[1]` 中断使能 (`irq_en`)<br>`[2]` 跑马灯使能 (`pattern_en`) |
| `0x04` | **LOAD** | RW | `0x09` | 计数器重载值 (写入时直接同步预置当前计数) |
| `0x08` | **COUNT** | RO | `0x09` | 当前实时倒计数值 |
| `0x0C` | **CMP** | RW | `0x03` | 比较匹配值 |
| `0x10` | **STATUS** | W1C | `0x00` | `[0]` 超时中断标志<br>`[1]` 比较匹配标志 |
| `0x14` | **GPIO** | RW | `0x01` | 8 位输出图案寄存器 (超时自动循环移位) |
| `0x18` | **ID** | RO | `0x5A33_0001` | **Palladium Z3 硬件签名** |
---
## 4. 模式一:SA 模式(仿真加速)快速上手
在 SA 模式下,**DUT 运行在 Palladium Z3 物理硬件中**,而**Testbench 运行在 Host 主机端(Xcelium)**,两者通过高速通道协同交互。
### 第一步:排查并确保硬件服务连通
```bash
# 1. 导入 Z3 专用环境变量
source scripts/env_z3.sh
# 2. 运行一键体检脚本,确保 test_server 与 configmgr 正常
./scripts/check_z3_server.sh
```
### 第二步:编译硬件与软件协同工程
```bash
./scripts/compile_sa.sh
```
该脚本将生成 `ixcom_db/` 目录以及映射进 Z3 的硬件网表和 Host 端仿真数据库。
### 第三步:上机下载与测试
```bash
cd ixcom_db
xeDebug -f ../scripts/run_xedebug.tcl
```
运行输出将显示在终端和 `xeDebug.log` 中:
```text
[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 顶层全硬件网表
```bash
source scripts/env_z3.sh
./ice/scripts/compile_ice.sh
```
### 第二步:下载进 Palladium Z3 并自动判读
```bash
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)
```text
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 硬件,可随时在工作站上离线验证逻辑:
```bash
# 验证 SA 模式逻辑:
./scripts/run_local.sh
# 验证 ICE 模式硬件状态机逻辑:
./ice/scripts/run_local_ice.sh
```
两者均支持 Icarus Verilog (`iverilog`) 或 Cadence Xcelium (`xrun`)。