195 lines
8.5 KiB
Markdown
195 lines
8.5 KiB
Markdown
# 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`)。
|