feat: complete Palladium Z3 demo (SA & ICE dual-mode) and 24.05 hardware compilation fix
This commit is contained in:
+13
@@ -0,0 +1,13 @@
|
|||||||
|
# Palladium Z3 编译数据库与仿真临时文件
|
||||||
|
ixcom_db/
|
||||||
|
AxisWork/
|
||||||
|
xc_work/
|
||||||
|
sim_local/
|
||||||
|
*.log
|
||||||
|
*.key
|
||||||
|
*.vcd
|
||||||
|
*.fsdb
|
||||||
|
*.shm
|
||||||
|
.simvision/
|
||||||
|
INCA_libs/
|
||||||
|
xcelium.d/
|
||||||
@@ -0,0 +1,175 @@
|
|||||||
|
# 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 -f ice/scripts/run_xedebug_ice.tcl
|
||||||
|
```
|
||||||
|
脚本将硬件引脚读回终端:
|
||||||
|
- `led_done = 1`:自检执行完毕;
|
||||||
|
- `led_pass = 1`,`led_fail = 0`:所有硬件级断言均通过;
|
||||||
|
- `led_gpio = 0x02`:跑马灯正常移位。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 本地离线免硬件验证(Smoke Test)
|
||||||
|
|
||||||
|
如果当前没有连接到 Palladium Z3 硬件,可随时在工作站上离线验证逻辑:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 验证 SA 模式逻辑:
|
||||||
|
./scripts/run_local.sh
|
||||||
|
|
||||||
|
# 验证 ICE 模式硬件状态机逻辑:
|
||||||
|
./ice/scripts/run_local_ice.sh
|
||||||
|
```
|
||||||
|
两者均支持 Icarus Verilog (`iverilog`) 或 Cadence Xcelium (`xrun`)。
|
||||||
@@ -0,0 +1,269 @@
|
|||||||
|
# Palladium Z3 (24.05 Release) 硬件编译全套问题排查与解决全景文档
|
||||||
|
|
||||||
|
## 1. 项目与环境概述
|
||||||
|
|
||||||
|
- **项目名称**:Palladium Z3 Demo (Dual Mode: ICE & SA)
|
||||||
|
- **硬件目标**:Palladium Z3 硬件平台(Domain 授权:`Palladium_Z3_Domain`,服务器:`z7f1x8c-5k9p3m`)
|
||||||
|
- **工具版本**:
|
||||||
|
- WXE: `WXE24.05.000`(内部内核版本:`24H1_WXE(Z3), V24.05.338.s005`)
|
||||||
|
- IXCOM: `IXCOM24.05.000`(`24H1_HDLICE, V24.05.338.s005`)
|
||||||
|
- XCELIUM: `XCELIUM24.09.013`
|
||||||
|
- **Git 仓库**:`https://git.cnbugs.com/demo/Palladium-Z3-demo_ice_top.git`
|
||||||
|
- **发布分支**:`24.05`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 踩坑与完整根因复盘(五大核心问题)
|
||||||
|
|
||||||
|
### 2.1 问题一:`hdl2qtdb: symbol lookup error: libimport.so: undefined symbol: ASSERT_RESET`
|
||||||
|
|
||||||
|
#### 【现象】
|
||||||
|
在 HDL-ICE 阶段,`vavlog` 启动 QTDB 服务端 `hdl2qtdb` 时抛出动态链接错误:
|
||||||
|
```text
|
||||||
|
/home/software/WXE.../hdl2qtdb: symbol lookup error: .../libimport.so: undefined symbol: ASSERT_RESET
|
||||||
|
QTDB server failed.
|
||||||
|
ERROR: failed to start QTDB server.
|
||||||
|
ERROR: cannot find qtref cell 'Q_EV_WOR' in QTDB.
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 【深度根因】
|
||||||
|
1. 通过 `readelf -d` 和符号排查发现:`ASSERT_RESET` 符号仅存在于 `$WXE/tools.lnx86/lib/z3/64bit/libdb.so` 中;而 `$WXE/tools.lnx86/lib/64bit/libdb.so`(旧版通用库)中**没有**该符号。
|
||||||
|
2. 查看 `vavlog` 实际调用的 Cadence 底层包装脚本 `xeWrapper`(第 282 行与 436-464 行),其动态库组装顺序为:
|
||||||
|
```bash
|
||||||
|
export LD_LIBRARY_PATH=
|
||||||
|
add_libpath $RQT_LIBRARY_PATH # (1) 最先被插入
|
||||||
|
add_libpath $MY_HOME/lib${HW_DIR}/64bit
|
||||||
|
add_libpath $QTHOME/lib/64bit # (2) 插入了不含 ASSERT_RESET 的通用 libdb.so
|
||||||
|
add_libpath $USERLIBPATH # (3) 用户的 LD_LIBRARY_PATH 被追加到最后!
|
||||||
|
```
|
||||||
|
3. 无论外部如何设置 `LD_LIBRARY_PATH`,`xeWrapper` 都会清空并把用户路径追加在最后,通用 `lib/64bit/libdb.so` 永远被优先载入,导致符号缺失崩溃。
|
||||||
|
|
||||||
|
#### 【解决办法】
|
||||||
|
`xeWrapper` 在清空库后,最先读取并插入的环境变量是 **`RQT_LIBRARY_PATH`**!
|
||||||
|
只需在环境或 module 文件中导出:
|
||||||
|
```tcl
|
||||||
|
setenv RQT_LIBRARY_PATH $prefix/tools.lnx86/lib/z3/64bit
|
||||||
|
```
|
||||||
|
即可确保 Z3 专用的 `libdb.so` 处于动态库搜索首位,彻底根治。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.2 问题二:`ERROR (vavlog): Cannot determine the path to hdlice executable because environment variable 'HDLICE_HOME' is not set.`
|
||||||
|
|
||||||
|
#### 【现象】
|
||||||
|
`vavlog` 编译时直接退出,提示 `HDLICE_HOME` 未设置。
|
||||||
|
|
||||||
|
#### 【深度根因】
|
||||||
|
1. `IXCOM24.05.000` modulefile 中缺少 `setenv HDLICE_HOME $prefix`。
|
||||||
|
2. 同时 `IXCOM24.05.000` 中的 `prepend-path PATH` 将 `$prefix/tools.lnx86/bin/64bit`(四层深度的底层裸可执行程序)排在了最前面,绕过了 `$prefix/bin` 官方包装入口,导致 `xeWrapper` 内部使用 `xeroot` 向上计算安装根目录失败。
|
||||||
|
|
||||||
|
#### 【解决办法】
|
||||||
|
在 `IXCOM24.05.000` modulefile 中补齐环境变量并保证 `$prefix/bin` 在 PATH 最前:
|
||||||
|
```tcl
|
||||||
|
setenv HDLICE_HOME $prefix
|
||||||
|
prepend-path PATH $prefix/bin
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.3 问题三:`Forking xeCompile -z3 ... Error: unknown option '-z3'`
|
||||||
|
|
||||||
|
#### 【现象】
|
||||||
|
`ixcom` 进入综合阶段,fork 调用 `xeCompile -z3` 时报错:
|
||||||
|
```text
|
||||||
|
xeCompile - 24H1_WXE(Z3), V24.05.138.s000
|
||||||
|
Error: unknown option '-z3'.
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 【深度根因】
|
||||||
|
1. Cadence WXE 的工具体系严格分为两层:
|
||||||
|
- **包装器入口(Wrapper)**:`$WXE/tools.lnx86/bin/xeCompile`(链接到 `../../share/bin/xeWrapper`),官方文档明确说明其负责接收 `-z3`,解析后自动配置环境变量与架构路由。
|
||||||
|
- **底层裸二进制(Bare Binary)**:`$WXE/tools.lnx86/bin/z3/64bit/xeCompile`,它本身已经是 Z3 专用内核,参数中没有 `-z3` 这个开关,且缺少包装器自动注入的 `libjsoncpp` 等依赖。
|
||||||
|
2. 之前的 modulefile 中将 `tools.lnx86/bin/z3/64bit` 放在最前,导致系统优先调到了底层裸二进制。
|
||||||
|
3. 此外发现服务器上存在两个安装目录:`/home/software/WXE/WXE24.05.000`(早期不完整解压残留)和 `/home/software/WXE24.05.000`(官方完整安装目录,内含完整 `tools.lnx86/bin/xeCompile` 包装器)。
|
||||||
|
|
||||||
|
#### 【解决办法】
|
||||||
|
将 WXE modulefile 的 prefix 修正为 `/home/software/WXE24.05.000`,并将 `$prefix/tools.lnx86/bin` 置于 PATH 优先位置。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.4 问题四:`ERROR: Fail to invoke RTL Verilog analyzer` (`ver2hdl: No such file or directory`)
|
||||||
|
|
||||||
|
#### 【现象】
|
||||||
|
`HDL-ICE` 运行 `vavlog` 时报错:
|
||||||
|
```text
|
||||||
|
WARNING: "./xc_work/xc_vawork/xc_vawork" is not an HDL-ICE library, ignored.
|
||||||
|
ERROR: Fail to invoke RTL Verilog analyzer.
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 【深度根因】
|
||||||
|
通过 `strace -f -e trace=execve` 抓取底层系统调用,发现致命报错行:
|
||||||
|
```text
|
||||||
|
execve("/home/software/WXE24.05.000/tools.lnx86/bin/64bit/ver2hdl", ...) = -1 ENOENT (没有那个文件或目录)
|
||||||
|
```
|
||||||
|
1. `ver2hdl` 是 Verilog 前端分析器,属于 **IXCOM** 组件,路径为 `/home/software/IXCOM24.05/tools.lnx86/bin/64bit/ver2hdl`。
|
||||||
|
2. `hdlice_nse` 在调用 `ver2hdl` 时,根据传入的 `$QTHOME` 拼装路径。
|
||||||
|
3. 早期有人曾将 `IXCOM` 的 `hdlice` 软链接到了 `WXE24.05.000/tools.lnx86/bin/64bit/hdlice`,导致 `hdlice` 以为同级的 `ver2hdl` 也在 WXE 目录下,从而报找不到。
|
||||||
|
|
||||||
|
#### 【解决办法】
|
||||||
|
补齐对齐软链接,让 WXE 具备完整的工具链查找支持:
|
||||||
|
```bash
|
||||||
|
ln -sf /home/software/IXCOM24.05/tools.lnx86/bin/64bit/ver2hdl /home/software/WXE24.05.000/tools.lnx86/bin/64bit/ver2hdl
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.5 问题五:`ERROR (legacy-42598): Error: The Z3 software cannot be used with Z1/Z2 config file. Please fix the config file.`
|
||||||
|
|
||||||
|
#### 【现象】
|
||||||
|
`xeCompile` 执行了 41 秒后退出,提示 Z3 软件不能使用 Z1/Z2 配置文件:
|
||||||
|
```text
|
||||||
|
ERROR (legacy-42598): Error: The Z3 software cannot be used with Z1/Z2 config file. Please fix the config file.
|
||||||
|
ERROR (legacy-43702): Failed to add emulator configuration.
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 【深度根因】
|
||||||
|
查看 `/home/software/WXE24.05.000/tools.lnx86/etc/qel/ixcom.qel` 源码:
|
||||||
|
```tcl
|
||||||
|
if { $::isLsystem } {
|
||||||
|
set defaultConfg [ file join $env(QTHOME) etc et3 lsys_default.et3confg]
|
||||||
|
} elseif { [xeset etxBuild] eq "ET8" } {
|
||||||
|
set defaultConfg [ file join $env(QTHOME) etc et3 z3_default.et3confg ]
|
||||||
|
} else {
|
||||||
|
set defaultConfg [ file join $env(QTHOME) etc et3 ua_default.et3confg ]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
1. Cadence Z3 对应的核心架构代号为 **`ET8`**,对应配置文件为 `z3_default.et3confg`。
|
||||||
|
2. 之前为规避问题四在 `compile_ice.sh` 中去掉了 `-z3`,导致 `ixcom` 未向 `xeCompile` 传递 `-z3` 开关。
|
||||||
|
3. `xeCompile` 默认未开启 `ET8`,走入了 `else` 分支去加载 `ua_default.et3confg`(Z1/Z2 配置),与当前 Z3 软件发生冲突。
|
||||||
|
|
||||||
|
#### 【解决办法】
|
||||||
|
在 `compile_ice.sh` 中保留 `-z3` 参数(官方包装器完全支持并识别):
|
||||||
|
```bash
|
||||||
|
ixcom -clean -ua +dut+z3_demo_ice_top \
|
||||||
|
-z3 \
|
||||||
|
-ignoreSimSetupCheck \
|
||||||
|
-ignoreHWPlatformSetupCheck \
|
||||||
|
-ignoreVersionCheck \
|
||||||
|
"$ROOT/ice/rtl/z3_demo_top.v" \
|
||||||
|
"$ROOT/ice/rtl/z3_demo_ice_top.v"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 标准规范的 Module 配置文件
|
||||||
|
|
||||||
|
### 3.1 `/home/software/module/WXE24.05.000`
|
||||||
|
```tcl
|
||||||
|
#%Module1.0
|
||||||
|
##
|
||||||
|
## WXE24.05.000 Module for Palladium Z3
|
||||||
|
##
|
||||||
|
proc ModulesHelp { } {
|
||||||
|
global version prefix
|
||||||
|
puts stderr "\tLoads WXE24.05.000 for Palladium Z3"
|
||||||
|
}
|
||||||
|
|
||||||
|
module-whatis "loads Palladium Z3 WXE environment"
|
||||||
|
|
||||||
|
set version WXE24.05.000
|
||||||
|
set prefix /home/software/WXE24.05.000
|
||||||
|
|
||||||
|
# 1. 导出关键环境变量
|
||||||
|
setenv QTHOME $prefix
|
||||||
|
setenv WXE_HOME $prefix
|
||||||
|
setenv XE_HOME $prefix
|
||||||
|
setenv RQT_LIBRARY_PATH $prefix/tools.lnx86/lib/z3/64bit
|
||||||
|
|
||||||
|
# 2. 执行命令路径 (确保 tools.lnx86/bin 优先使用官方包装器)
|
||||||
|
prepend-path PATH $prefix/tools.lnx86/bin
|
||||||
|
prepend-path PATH $prefix/share/bin
|
||||||
|
|
||||||
|
# 3. 动态库与通信库
|
||||||
|
prepend-path LD_LIBRARY_PATH $prefix/tools.lnx86/lib/z3/64bit
|
||||||
|
prepend-path LD_LIBRARY_PATH $prefix/tools.lnx86/lib/z3/64bit/et3lib
|
||||||
|
prepend-path LD_LIBRARY_PATH $prefix/tools.lnx86/lib/64bit
|
||||||
|
prepend-path DBIN $prefix/tools.lnx86/lib/z3/64bit
|
||||||
|
|
||||||
|
# 4. License 服务器
|
||||||
|
prepend-path LM_LICENSE_FILE 5280@10.33.11.107
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3.2 `/home/software/module/IXCOM24.05.000`
|
||||||
|
```tcl
|
||||||
|
#%Module1.0
|
||||||
|
##
|
||||||
|
## IXCOM24.05.000 Module
|
||||||
|
##
|
||||||
|
proc ModulesHelp { } {
|
||||||
|
global version prefix
|
||||||
|
puts stderr "\tLoads IXCOM24.05.000"
|
||||||
|
}
|
||||||
|
|
||||||
|
module-whatis "loads IXCOM environment"
|
||||||
|
|
||||||
|
set version IXCOM24.05.000
|
||||||
|
set prefix /home/software/IXCOM24.05
|
||||||
|
|
||||||
|
# 导出环境变量
|
||||||
|
setenv IXCOM_HOME $prefix
|
||||||
|
setenv HDLICE_HOME $prefix
|
||||||
|
setenv AXIS_HOME $prefix/tools.lnx86
|
||||||
|
|
||||||
|
# 工具路径与库 (确保 $prefix/bin 在最前面)
|
||||||
|
prepend-path PATH $prefix/tools.lnx86/bin/64bit
|
||||||
|
prepend-path PATH $prefix/tools.lnx86/bin
|
||||||
|
prepend-path PATH $prefix/bin
|
||||||
|
|
||||||
|
prepend-path LD_LIBRARY_PATH $prefix/tools.lnx86/lib/64bit
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 标准编译与运行指南
|
||||||
|
|
||||||
|
### 4.1 环境加载
|
||||||
|
```bash
|
||||||
|
module purge
|
||||||
|
module load /home/software/module/WXE24.05.000
|
||||||
|
module load /home/software/module/IXCOM24.05.000
|
||||||
|
module load /home/software/module/XCELIUM24.09.013
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.2 ICE 模式硬件全逻辑编译
|
||||||
|
```bash
|
||||||
|
cd palladium_z3_demo
|
||||||
|
./ice/scripts/compile_ice.sh
|
||||||
|
```
|
||||||
|
成功标志:
|
||||||
|
```text
|
||||||
|
Info [FLOW_SUCCESS]
|
||||||
|
Successfully built target (xeCompile)
|
||||||
|
Info [FLOW_SUCCESS]
|
||||||
|
Successfully built target (nc elaborate)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.3 ICE 模式 Palladium Z3 上机运行
|
||||||
|
```bash
|
||||||
|
# 启动 Z3 交互调试器
|
||||||
|
xeDebug -tcl -play ice/scripts/run_xedebug_ice.tcl
|
||||||
|
```
|
||||||
|
脚本自动连接硬件:
|
||||||
|
```tcl
|
||||||
|
debug .
|
||||||
|
host z7f1x8c-5k9p3m
|
||||||
|
xc on -run
|
||||||
|
run 2000
|
||||||
|
get z3_demo_ice_top.check_state
|
||||||
|
get z3_demo_ice_top.check_pass
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4.4 SA 模式硬件编译与运行
|
||||||
|
```bash
|
||||||
|
# 编译
|
||||||
|
./scripts/compile_sa.sh
|
||||||
|
|
||||||
|
# 调试与仿真协同运行
|
||||||
|
cd ixcom_db
|
||||||
|
xeDebug -tcl -play ../scripts/run_xedebug.tcl
|
||||||
|
```
|
||||||
@@ -0,0 +1,190 @@
|
|||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
// z3_demo_ice_top.v -- Palladium Z3 ICE-mode demo top
|
||||||
|
//
|
||||||
|
// ICE (In-Circuit Emulation) has NO software testbench: everything that runs
|
||||||
|
// in the emulator must be synthesizable hardware.
|
||||||
|
//
|
||||||
|
// This top-level module wraps z3_demo_top with an on-chip hardware self-checking
|
||||||
|
// FSM that autonomously stimulates and verifies the DUT:
|
||||||
|
// reset -> program LOAD/CMP -> verify Z3 ID -> start timer
|
||||||
|
// -> wait for irq -> verify STATUS flags -> verify GPIO rotation
|
||||||
|
// -> disable, clear W1C flags -> assert led_pass/led_fail
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
`timescale 1ns/1ps
|
||||||
|
|
||||||
|
module z3_demo_ice_top (
|
||||||
|
input wire clk_in,
|
||||||
|
input wire rst_n_in,
|
||||||
|
output wire [7:0] led_gpio,
|
||||||
|
output wire led_irq,
|
||||||
|
output reg led_done,
|
||||||
|
output reg led_pass,
|
||||||
|
output reg led_fail
|
||||||
|
);
|
||||||
|
|
||||||
|
// ------------------------------------------------------------ DUT signals
|
||||||
|
reg [7:0] paddr;
|
||||||
|
reg psel;
|
||||||
|
reg penable;
|
||||||
|
reg pwrite;
|
||||||
|
reg [31:0] pwdata;
|
||||||
|
wire [31:0] prdata;
|
||||||
|
wire pready;
|
||||||
|
wire [7:0] gpio_out;
|
||||||
|
wire irq;
|
||||||
|
wire cmp_hit;
|
||||||
|
|
||||||
|
z3_demo_top dut (
|
||||||
|
.clk (clk_in),
|
||||||
|
.rst_n (rst_n_in),
|
||||||
|
.paddr (paddr),
|
||||||
|
.psel (psel),
|
||||||
|
.penable (penable),
|
||||||
|
.pwrite (pwrite),
|
||||||
|
.pwdata (pwdata),
|
||||||
|
.prdata (prdata),
|
||||||
|
.pready (pready),
|
||||||
|
.gpio_out (gpio_out),
|
||||||
|
.irq (irq),
|
||||||
|
.cmp_hit (cmp_hit)
|
||||||
|
);
|
||||||
|
|
||||||
|
assign led_gpio = gpio_out;
|
||||||
|
assign led_irq = irq;
|
||||||
|
|
||||||
|
// ------------------------------------------------------------ FSM
|
||||||
|
localparam ST_WAIT = 5'd0;
|
||||||
|
localparam ST_WR_LOAD = 5'd1;
|
||||||
|
localparam ST_WR_CMP = 5'd2;
|
||||||
|
localparam ST_RD_ID = 5'd3;
|
||||||
|
localparam ST_CHK_ID = 5'd4;
|
||||||
|
localparam ST_WR_CTRL = 5'd5;
|
||||||
|
localparam ST_WAIT_IRQ = 5'd6;
|
||||||
|
localparam ST_RD_STAT = 5'd7;
|
||||||
|
localparam ST_CHK_STAT = 5'd8;
|
||||||
|
localparam ST_RD_GPIO = 5'd9;
|
||||||
|
localparam ST_CHK_GPIO = 5'd10;
|
||||||
|
localparam ST_WR_CTRL0 = 5'd11;
|
||||||
|
localparam ST_WR_W1C = 5'd12;
|
||||||
|
localparam ST_RD_STAT2 = 5'd13;
|
||||||
|
localparam ST_CHK_STAT2 = 5'd14;
|
||||||
|
localparam ST_PASS = 5'd15;
|
||||||
|
localparam ST_FAIL = 5'd16;
|
||||||
|
|
||||||
|
reg [4:0] state;
|
||||||
|
reg [15:0] wait_cnt;
|
||||||
|
reg [31:0] rd_latched;
|
||||||
|
|
||||||
|
always @(*) begin
|
||||||
|
paddr = 8'd0;
|
||||||
|
pwdata = 32'd0;
|
||||||
|
pwrite = 1'b0;
|
||||||
|
psel = 1'b0;
|
||||||
|
penable = 1'b0;
|
||||||
|
case (state)
|
||||||
|
ST_WR_LOAD: begin psel=1; penable=1; pwrite=1; paddr=8'h04; pwdata=32'd19; end
|
||||||
|
ST_WR_CMP: begin psel=1; penable=1; pwrite=1; paddr=8'h0C; pwdata=32'd5; end
|
||||||
|
ST_RD_ID: begin psel=1; penable=1; pwrite=0; paddr=8'h18; end
|
||||||
|
ST_WR_CTRL: begin psel=1; penable=1; pwrite=1; paddr=8'h00; pwdata=32'd7; end
|
||||||
|
ST_RD_STAT: begin psel=1; penable=1; pwrite=0; paddr=8'h10; end
|
||||||
|
ST_RD_GPIO: begin psel=1; penable=1; pwrite=0; paddr=8'h14; end
|
||||||
|
ST_WR_CTRL0: begin psel=1; penable=1; pwrite=1; paddr=8'h00; pwdata=32'd0; end
|
||||||
|
ST_WR_W1C: begin psel=1; penable=1; pwrite=1; paddr=8'h10; pwdata=32'd3; end
|
||||||
|
ST_RD_STAT2: begin psel=1; penable=1; pwrite=0; paddr=8'h10; end
|
||||||
|
default: ;
|
||||||
|
endcase
|
||||||
|
end
|
||||||
|
|
||||||
|
always @(posedge clk_in or negedge rst_n_in) begin
|
||||||
|
if (!rst_n_in) begin
|
||||||
|
state <= ST_WAIT;
|
||||||
|
wait_cnt <= 16'd0;
|
||||||
|
rd_latched <= 32'd0;
|
||||||
|
led_done <= 1'b0;
|
||||||
|
led_pass <= 1'b0;
|
||||||
|
led_fail <= 1'b0;
|
||||||
|
end else begin
|
||||||
|
case (state)
|
||||||
|
ST_WAIT: begin
|
||||||
|
if (wait_cnt == 16'd10) begin
|
||||||
|
wait_cnt <= 16'd0;
|
||||||
|
state <= ST_WR_LOAD;
|
||||||
|
end else begin
|
||||||
|
wait_cnt <= wait_cnt + 16'd1;
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
ST_WR_LOAD: state <= ST_WR_CMP;
|
||||||
|
ST_WR_CMP: state <= ST_RD_ID;
|
||||||
|
ST_RD_ID: begin rd_latched <= prdata; state <= ST_CHK_ID; end
|
||||||
|
|
||||||
|
ST_CHK_ID: begin
|
||||||
|
// Verify Palladium Z3 signature
|
||||||
|
if (rd_latched == 32'h5A33_0001)
|
||||||
|
state <= ST_WR_CTRL;
|
||||||
|
else
|
||||||
|
state <= ST_FAIL;
|
||||||
|
end
|
||||||
|
|
||||||
|
ST_WR_CTRL: begin
|
||||||
|
wait_cnt <= 16'd0;
|
||||||
|
state <= ST_WAIT_IRQ;
|
||||||
|
end
|
||||||
|
|
||||||
|
ST_WAIT_IRQ: begin
|
||||||
|
if (irq) begin
|
||||||
|
state <= ST_RD_STAT;
|
||||||
|
end else if (wait_cnt >= 16'd1000) begin
|
||||||
|
state <= ST_FAIL; // watchdog timeout
|
||||||
|
end else begin
|
||||||
|
wait_cnt <= wait_cnt + 16'd1;
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
ST_RD_STAT: begin rd_latched <= prdata; state <= ST_CHK_STAT; end
|
||||||
|
|
||||||
|
ST_CHK_STAT: begin
|
||||||
|
if ((rd_latched & 32'd3) == 32'd3)
|
||||||
|
state <= ST_RD_GPIO;
|
||||||
|
else
|
||||||
|
state <= ST_FAIL;
|
||||||
|
end
|
||||||
|
|
||||||
|
ST_RD_GPIO: begin rd_latched <= prdata; state <= ST_CHK_GPIO; end
|
||||||
|
|
||||||
|
ST_CHK_GPIO: begin
|
||||||
|
if (rd_latched[7:0] == 8'h02)
|
||||||
|
state <= ST_WR_CTRL0;
|
||||||
|
else
|
||||||
|
state <= ST_FAIL;
|
||||||
|
end
|
||||||
|
|
||||||
|
ST_WR_CTRL0: state <= ST_WR_W1C;
|
||||||
|
ST_WR_W1C: state <= ST_RD_STAT2;
|
||||||
|
ST_RD_STAT2: begin rd_latched <= prdata; state <= ST_CHK_STAT2; end
|
||||||
|
|
||||||
|
ST_CHK_STAT2: begin
|
||||||
|
if ((rd_latched & 32'd3) == 32'd0)
|
||||||
|
state <= ST_PASS;
|
||||||
|
else
|
||||||
|
state <= ST_FAIL;
|
||||||
|
end
|
||||||
|
|
||||||
|
ST_PASS: begin
|
||||||
|
led_done <= 1'b1;
|
||||||
|
led_pass <= 1'b1;
|
||||||
|
led_fail <= 1'b0;
|
||||||
|
end
|
||||||
|
|
||||||
|
ST_FAIL: begin
|
||||||
|
led_done <= 1'b1;
|
||||||
|
led_pass <= 1'b0;
|
||||||
|
led_fail <= 1'b1;
|
||||||
|
end
|
||||||
|
|
||||||
|
default: state <= ST_FAIL;
|
||||||
|
endcase
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
endmodule
|
||||||
@@ -0,0 +1,108 @@
|
|||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
// z3_demo_top.v -- Palladium Z3 emulation demo DUT
|
||||||
|
// (Identical to root rtl/z3_demo_top.v)
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
`timescale 1ns/1ps
|
||||||
|
|
||||||
|
module z3_demo_top (
|
||||||
|
input wire clk,
|
||||||
|
input wire rst_n,
|
||||||
|
// APB-like slave bus
|
||||||
|
input wire [7:0] paddr,
|
||||||
|
input wire psel,
|
||||||
|
input wire penable,
|
||||||
|
input wire pwrite,
|
||||||
|
input wire [31:0] pwdata,
|
||||||
|
output reg [31:0] prdata,
|
||||||
|
output wire pready,
|
||||||
|
// Observable outputs
|
||||||
|
output wire [7:0] gpio_out,
|
||||||
|
output wire irq,
|
||||||
|
output wire cmp_hit
|
||||||
|
);
|
||||||
|
|
||||||
|
reg ctrl_enable;
|
||||||
|
reg ctrl_irq_en;
|
||||||
|
reg ctrl_pattern_en;
|
||||||
|
reg [31:0] reg_load;
|
||||||
|
reg [31:0] reg_count;
|
||||||
|
reg [31:0] reg_cmp;
|
||||||
|
reg status_timeout;
|
||||||
|
reg status_cmp;
|
||||||
|
reg [7:0] reg_gpio;
|
||||||
|
|
||||||
|
assign pready = 1'b1;
|
||||||
|
assign gpio_out = reg_gpio;
|
||||||
|
assign irq = status_timeout & ctrl_irq_en;
|
||||||
|
|
||||||
|
wire bus_write = psel & penable & pwrite;
|
||||||
|
wire bus_read = psel & penable & ~pwrite;
|
||||||
|
|
||||||
|
wire timeout_now = ctrl_enable & (reg_count == 32'd0);
|
||||||
|
assign cmp_hit = ctrl_enable & (reg_count == reg_cmp);
|
||||||
|
|
||||||
|
always @(posedge clk or negedge rst_n) begin
|
||||||
|
if (!rst_n) begin
|
||||||
|
ctrl_enable <= 1'b0;
|
||||||
|
ctrl_irq_en <= 1'b0;
|
||||||
|
ctrl_pattern_en <= 1'b0;
|
||||||
|
reg_load <= 32'd9;
|
||||||
|
reg_cmp <= 32'd3;
|
||||||
|
reg_gpio <= 8'h01;
|
||||||
|
status_timeout <= 1'b0;
|
||||||
|
status_cmp <= 1'b0;
|
||||||
|
end else begin
|
||||||
|
if (timeout_now)
|
||||||
|
status_timeout <= 1'b1;
|
||||||
|
if (cmp_hit)
|
||||||
|
status_cmp <= 1'b1;
|
||||||
|
|
||||||
|
if (bus_write) begin
|
||||||
|
case (paddr[7:0])
|
||||||
|
8'h00: begin
|
||||||
|
ctrl_enable <= pwdata[0];
|
||||||
|
ctrl_irq_en <= pwdata[1];
|
||||||
|
ctrl_pattern_en <= pwdata[2];
|
||||||
|
end
|
||||||
|
8'h04: begin
|
||||||
|
reg_load <= pwdata;
|
||||||
|
reg_count <= pwdata;
|
||||||
|
end
|
||||||
|
8'h0C: reg_cmp <= pwdata;
|
||||||
|
8'h10: begin
|
||||||
|
if (pwdata[0]) status_timeout <= 1'b0;
|
||||||
|
if (pwdata[1]) status_cmp <= 1'b0;
|
||||||
|
end
|
||||||
|
8'h14: reg_gpio <= pwdata[7:0];
|
||||||
|
default: ;
|
||||||
|
endcase
|
||||||
|
end else if (ctrl_enable) begin
|
||||||
|
if (reg_count == 32'd0) begin
|
||||||
|
reg_count <= reg_load;
|
||||||
|
if (ctrl_pattern_en)
|
||||||
|
reg_gpio <= {reg_gpio[6:0], reg_gpio[7]};
|
||||||
|
end else begin
|
||||||
|
reg_count <= reg_count - 32'd1;
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
always @(*) begin
|
||||||
|
if (bus_read) begin
|
||||||
|
case (paddr[7:0])
|
||||||
|
8'h00: prdata = {29'b0, ctrl_pattern_en, ctrl_irq_en, ctrl_enable};
|
||||||
|
8'h04: prdata = reg_load;
|
||||||
|
8'h08: prdata = reg_count;
|
||||||
|
8'h0C: prdata = reg_cmp;
|
||||||
|
8'h10: prdata = {30'b0, status_cmp, status_timeout};
|
||||||
|
8'h14: prdata = {24'b0, reg_gpio};
|
||||||
|
8'h18: prdata = 32'h5A33_0001; // Z3 ID
|
||||||
|
default: prdata = 32'hDEAD_BEEF;
|
||||||
|
endcase
|
||||||
|
end else begin
|
||||||
|
prdata = 32'h0;
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
endmodule
|
||||||
@@ -0,0 +1,42 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# =============================================================================
|
||||||
|
# compile_ice.sh -- Palladium Z3 ICE 模式硬件编译脚本
|
||||||
|
# =============================================================================
|
||||||
|
set -e
|
||||||
|
cd "$(dirname "$0")/../.."
|
||||||
|
ROOT="$(pwd)"
|
||||||
|
|
||||||
|
export XE_HOST="${XE_HOST:-z7f1x8c-5k9p3m}"
|
||||||
|
|
||||||
|
echo "======================================================================"
|
||||||
|
echo " [Palladium Z3 ICE] 开始硬件全逻辑编译"
|
||||||
|
echo " Target Host : $XE_HOST"
|
||||||
|
echo " Top Module : z3_demo_ice_top"
|
||||||
|
echo " 当前使用 ixcom : $(which ixcom 2>/dev/null || echo '未检测到')"
|
||||||
|
echo " 当前使用 xeCompile : $(which xeCompile 2>/dev/null || echo '未检测到,请 export PATH')"
|
||||||
|
echo "======================================================================"
|
||||||
|
|
||||||
|
set +e
|
||||||
|
ixcom -clean -ua +dut+z3_demo_ice_top \
|
||||||
|
-z3 \
|
||||||
|
-ignoreSimSetupCheck \
|
||||||
|
-ignoreHWPlatformSetupCheck \
|
||||||
|
-ignoreVersionCheck \
|
||||||
|
"$ROOT/ice/rtl/z3_demo_top.v" \
|
||||||
|
"$ROOT/ice/rtl/z3_demo_ice_top.v" \
|
||||||
|
> compile_ice.log 2>&1
|
||||||
|
rc=$?
|
||||||
|
set -e
|
||||||
|
cat compile_ice.log
|
||||||
|
|
||||||
|
if [ $rc -ne 0 ] || grep -q -E '\*E,|ERROR|FATAL|FLOW_FAILED' compile_ice.log; then
|
||||||
|
echo "======================================================================"
|
||||||
|
echo " [FAIL] IXCOM ICE 编译失败 (rc=$rc)!请查看日志: compile_ice.log"
|
||||||
|
echo "======================================================================"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "======================================================================"
|
||||||
|
echo " [SUCCESS] Palladium Z3 ICE 硬件编译成功!"
|
||||||
|
echo " 下一步: 执行 xeDebug 进行上机运行与状态机自检"
|
||||||
|
echo "======================================================================"
|
||||||
@@ -0,0 +1,40 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# =============================================================================
|
||||||
|
# run_local_ice.sh -- 本地免硬件验证 ICE 自检状态机逻辑
|
||||||
|
# =============================================================================
|
||||||
|
set -e
|
||||||
|
cd "$(dirname "$0")/../.."
|
||||||
|
|
||||||
|
mkdir -p ice/sim_local
|
||||||
|
|
||||||
|
echo "=========================================================="
|
||||||
|
echo " 本地离线验证 ICE 自检状态机 (z3_demo_ice_top) "
|
||||||
|
echo "=========================================================="
|
||||||
|
|
||||||
|
if command -v iverilog >/dev/null 2>&1; then
|
||||||
|
echo "使用 Icarus Verilog 进行本地编译与仿真..."
|
||||||
|
iverilog -g2005 -DLOCAL_SIM -o ice/sim_local/z3_demo_ice.vvp \
|
||||||
|
ice/rtl/z3_demo_top.v \
|
||||||
|
ice/rtl/z3_demo_ice_top.v \
|
||||||
|
ice/tb/tb_z3_demo_ice.v
|
||||||
|
vvp ice/sim_local/z3_demo_ice.vvp | tee ice/sim_local/ice_run.log
|
||||||
|
[ -f ice/sim_local/z3_demo_ice.vcd ] || [ -f z3_demo_ice.vcd ] && mv -f z3_demo_ice.vcd ice/sim_local/ 2>/dev/null || true
|
||||||
|
elif command -v xrun >/dev/null 2>&1; then
|
||||||
|
echo "使用 Cadence xrun 进行本地仿真..."
|
||||||
|
xrun -64bit -define LOCAL_SIM -access +rwc \
|
||||||
|
ice/rtl/z3_demo_top.v \
|
||||||
|
ice/rtl/z3_demo_ice_top.v \
|
||||||
|
ice/tb/tb_z3_demo_ice.v \
|
||||||
|
-logfile ice/sim_local/ice_run.log
|
||||||
|
else
|
||||||
|
echo "未检测到 iverilog 或 xrun!"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
if grep -q "ICE Self-Check FSM Passed Successfully" ice/sim_local/ice_run.log; then
|
||||||
|
echo "===> [SUCCESS] ICE 状态机本地验证全部通过!"
|
||||||
|
else
|
||||||
|
echo "===> [FAIL] ICE 验证未通过,请查看日志: ice/sim_local/ice_run.log"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
@@ -0,0 +1,43 @@
|
|||||||
|
# =============================================================================
|
||||||
|
# run_xedebug_ice.tcl -- Palladium Z3 ICE 标准上机运行脚本
|
||||||
|
#
|
||||||
|
# 官方标准流程:
|
||||||
|
# 1. debug . -- 进入调试上下文
|
||||||
|
# 2. host <XE_HOST> -- 连接 Palladium Z3 物理机台
|
||||||
|
# 3. xc on -run -- 下载网表到硬件并启动运行
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# 1. 进入调试上下文
|
||||||
|
debug .
|
||||||
|
|
||||||
|
# 2. 连接 Palladium Z3 物理机台
|
||||||
|
if {[info exists env(XE_HOST)]} {
|
||||||
|
host $env(XE_HOST)
|
||||||
|
} else {
|
||||||
|
host z7f1x8c-5k9p3m
|
||||||
|
}
|
||||||
|
|
||||||
|
# 3. 下载设计到硬件并启动
|
||||||
|
xc on -run
|
||||||
|
|
||||||
|
# 4. 运行 2000 个时钟周期供自检 FSM 判定
|
||||||
|
run 2000
|
||||||
|
|
||||||
|
# 5. 读取硬件引脚判定结果
|
||||||
|
set done_val [value /z3_demo_ice_top/led_done]
|
||||||
|
set pass_val [value /z3_demo_ice_top/led_pass]
|
||||||
|
set fail_val [value /z3_demo_ice_top/led_fail]
|
||||||
|
set gpio_val [value /z3_demo_ice_top/led_gpio]
|
||||||
|
|
||||||
|
puts "=========================================================="
|
||||||
|
puts " led_done : $done_val"
|
||||||
|
puts " led_pass : $pass_val"
|
||||||
|
puts " led_fail : $fail_val"
|
||||||
|
puts " led_gpio : $gpio_val"
|
||||||
|
|
||||||
|
if {$pass_val == 1 && $fail_val == 0} {
|
||||||
|
puts "===> [TEST PASSED] Palladium Z3 ICE 全硬件测试通过!"
|
||||||
|
} else {
|
||||||
|
puts "===> [TEST FAILED] ICE 硬件自检未通过"
|
||||||
|
}
|
||||||
|
puts "=========================================================="
|
||||||
@@ -0,0 +1,71 @@
|
|||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
// tb_z3_demo_ice.v -- Local testbench for z3_demo_ice_top
|
||||||
|
//
|
||||||
|
// Used to verify that the hardware self-checking FSM inside z3_demo_ice_top
|
||||||
|
// runs correctly to completion and asserts led_pass BEFORE downloading into
|
||||||
|
// Palladium Z3 hardware.
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
`timescale 1ns/1ps
|
||||||
|
|
||||||
|
module tb_z3_demo_ice;
|
||||||
|
|
||||||
|
reg clk;
|
||||||
|
reg rst_n;
|
||||||
|
wire [7:0] led_gpio;
|
||||||
|
wire led_irq;
|
||||||
|
wire led_done;
|
||||||
|
wire led_pass;
|
||||||
|
wire led_fail;
|
||||||
|
|
||||||
|
z3_demo_ice_top u_ice_top (
|
||||||
|
.clk_in (clk),
|
||||||
|
.rst_n_in (rst_n),
|
||||||
|
.led_gpio (led_gpio),
|
||||||
|
.led_irq (led_irq),
|
||||||
|
.led_done (led_done),
|
||||||
|
.led_pass (led_pass),
|
||||||
|
.led_fail (led_fail)
|
||||||
|
);
|
||||||
|
|
||||||
|
always #5 clk = ~clk;
|
||||||
|
|
||||||
|
initial begin
|
||||||
|
clk = 0;
|
||||||
|
rst_n = 0;
|
||||||
|
|
||||||
|
`ifdef LOCAL_SIM
|
||||||
|
$dumpfile("ice/sim_local/z3_demo_ice.vcd");
|
||||||
|
$dumpvars(0, tb_z3_demo_ice);
|
||||||
|
`endif
|
||||||
|
|
||||||
|
$display("==========================================================");
|
||||||
|
$display(" Palladium Z3 ICE Self-Check FSM Verification Start ");
|
||||||
|
$display("==========================================================");
|
||||||
|
|
||||||
|
#100;
|
||||||
|
rst_n = 1;
|
||||||
|
|
||||||
|
// Wait for FSM completion
|
||||||
|
@(posedge led_done);
|
||||||
|
#50;
|
||||||
|
|
||||||
|
$display("==========================================================");
|
||||||
|
$display(" [ICE Status] led_done=%b, led_pass=%b, led_fail=%b", led_done, led_pass, led_fail);
|
||||||
|
$display(" [ICE Status] led_gpio=0x%02X, led_irq=%b", led_gpio, led_irq);
|
||||||
|
if (led_pass && !led_fail) begin
|
||||||
|
$display("===> [PASS] ICE Self-Check FSM Passed Successfully!");
|
||||||
|
end else begin
|
||||||
|
$display("===> [FAIL] ICE Self-Check FSM Reported Failure!");
|
||||||
|
end
|
||||||
|
$display("==========================================================");
|
||||||
|
|
||||||
|
$finish;
|
||||||
|
end
|
||||||
|
|
||||||
|
initial begin
|
||||||
|
#50000;
|
||||||
|
$display("[TIMEOUT] ICE Simulation watchdog expired!");
|
||||||
|
$finish;
|
||||||
|
end
|
||||||
|
|
||||||
|
endmodule
|
||||||
@@ -0,0 +1,134 @@
|
|||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
// z3_demo_top.v -- Palladium Z3 emulation demo DUT
|
||||||
|
//
|
||||||
|
// A small, fully synthesizable, register-mapped timer peripheral used to
|
||||||
|
// demonstrate the Cadence Palladium Z3 flow end to end:
|
||||||
|
// IXCOM compile (SA mode) -> download with xeDebug -> run -> check results
|
||||||
|
//
|
||||||
|
// Bus: APB-like (single-cycle ready). Low 8 address bits decoded.
|
||||||
|
//
|
||||||
|
// Register map (byte addresses):
|
||||||
|
// 0x00 CTRL [0]=enable [1]=irq_en [2]=pattern_en (RW)
|
||||||
|
// 0x04 LOAD reload value of the down counter (RW)
|
||||||
|
// 0x08 COUNT current counter value (RO)
|
||||||
|
// 0x0C CMP compare value: pulse cmp_hit when COUNT==CMP (RW)
|
||||||
|
// 0x10 STATUS [0]=timeout flag (W1C) [1]=cmp flag (W1C) (RW/RO)
|
||||||
|
// 0x14 GPIO 8-bit rotating pattern output register (RW)
|
||||||
|
// 0x18 ID constant 0x5A33_0001 (Z3 Signature) (RO)
|
||||||
|
//
|
||||||
|
// Behaviour:
|
||||||
|
// * When CTRL.enable=1, COUNT decrements every clock. When it reaches 0 it
|
||||||
|
// sets STATUS.timeout, raises irq (if irq_en), and reloads from LOAD.
|
||||||
|
// * When COUNT==CMP, STATUS.cmp is set and cmp_hit pulses for one cycle.
|
||||||
|
// * When CTRL.pattern_en=1, GPIO rotates left by one bit on every timeout,
|
||||||
|
// giving a visible "running light" to observe in xeDebug / waveforms.
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
`timescale 1ns/1ps
|
||||||
|
|
||||||
|
module z3_demo_top (
|
||||||
|
input wire clk,
|
||||||
|
input wire rst_n,
|
||||||
|
// APB-like slave bus
|
||||||
|
input wire [7:0] paddr,
|
||||||
|
input wire psel,
|
||||||
|
input wire penable,
|
||||||
|
input wire pwrite,
|
||||||
|
input wire [31:0] pwdata,
|
||||||
|
output reg [31:0] prdata,
|
||||||
|
output wire pready,
|
||||||
|
// Observable outputs
|
||||||
|
output wire [7:0] gpio_out,
|
||||||
|
output wire irq,
|
||||||
|
output wire cmp_hit
|
||||||
|
);
|
||||||
|
|
||||||
|
// ------------------------------------------------------------------ regs
|
||||||
|
reg ctrl_enable;
|
||||||
|
reg ctrl_irq_en;
|
||||||
|
reg ctrl_pattern_en;
|
||||||
|
reg [31:0] reg_load;
|
||||||
|
reg [31:0] reg_count;
|
||||||
|
reg [31:0] reg_cmp;
|
||||||
|
reg status_timeout;
|
||||||
|
reg status_cmp;
|
||||||
|
reg [7:0] reg_gpio;
|
||||||
|
|
||||||
|
assign pready = 1'b1;
|
||||||
|
assign gpio_out = reg_gpio;
|
||||||
|
assign irq = status_timeout & ctrl_irq_en;
|
||||||
|
|
||||||
|
wire bus_write = psel & penable & pwrite;
|
||||||
|
wire bus_read = psel & penable & ~pwrite;
|
||||||
|
|
||||||
|
wire timeout_now = ctrl_enable & (reg_count == 32'd0);
|
||||||
|
assign cmp_hit = ctrl_enable & (reg_count == reg_cmp);
|
||||||
|
|
||||||
|
// ------------------------------------------------------------- write path
|
||||||
|
always @(posedge clk or negedge rst_n) begin
|
||||||
|
if (!rst_n) begin
|
||||||
|
ctrl_enable <= 1'b0;
|
||||||
|
ctrl_irq_en <= 1'b0;
|
||||||
|
ctrl_pattern_en <= 1'b0;
|
||||||
|
reg_load <= 32'd9; // default period: 10 cycles
|
||||||
|
reg_cmp <= 32'd3;
|
||||||
|
reg_gpio <= 8'h01;
|
||||||
|
status_timeout <= 1'b0;
|
||||||
|
status_cmp <= 1'b0;
|
||||||
|
end else begin
|
||||||
|
// sticky flags: set by hardware events, cleared by W1C writes
|
||||||
|
if (timeout_now)
|
||||||
|
status_timeout <= 1'b1;
|
||||||
|
if (cmp_hit)
|
||||||
|
status_cmp <= 1'b1;
|
||||||
|
|
||||||
|
if (bus_write) begin
|
||||||
|
case (paddr[7:0])
|
||||||
|
8'h00: begin
|
||||||
|
ctrl_enable <= pwdata[0];
|
||||||
|
ctrl_irq_en <= pwdata[1];
|
||||||
|
ctrl_pattern_en <= pwdata[2];
|
||||||
|
end
|
||||||
|
8'h04: begin
|
||||||
|
reg_load <= pwdata;
|
||||||
|
reg_count <= pwdata; // direct reload on LOAD write
|
||||||
|
end
|
||||||
|
8'h0C: reg_cmp <= pwdata;
|
||||||
|
8'h10: begin
|
||||||
|
if (pwdata[0]) status_timeout <= 1'b0; // W1C
|
||||||
|
if (pwdata[1]) status_cmp <= 1'b0; // W1C
|
||||||
|
end
|
||||||
|
8'h14: reg_gpio <= pwdata[7:0];
|
||||||
|
default: ;
|
||||||
|
endcase
|
||||||
|
end else if (ctrl_enable) begin
|
||||||
|
// down counter operation
|
||||||
|
if (reg_count == 32'd0) begin
|
||||||
|
reg_count <= reg_load;
|
||||||
|
if (ctrl_pattern_en)
|
||||||
|
reg_gpio <= {reg_gpio[6:0], reg_gpio[7]}; // barrel roll
|
||||||
|
end else begin
|
||||||
|
reg_count <= reg_count - 32'd1;
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
// -------------------------------------------------------------- read path
|
||||||
|
always @(*) begin
|
||||||
|
if (bus_read) begin
|
||||||
|
case (paddr[7:0])
|
||||||
|
8'h00: prdata = {29'b0, ctrl_pattern_en, ctrl_irq_en, ctrl_enable};
|
||||||
|
8'h04: prdata = reg_load;
|
||||||
|
8'h08: prdata = reg_count;
|
||||||
|
8'h0C: prdata = reg_cmp;
|
||||||
|
8'h10: prdata = {30'b0, status_cmp, status_timeout};
|
||||||
|
8'h14: prdata = {24'b0, reg_gpio};
|
||||||
|
8'h18: prdata = 32'h5A33_0001; // Z3 signature
|
||||||
|
default: prdata = 32'hDEAD_BEEF;
|
||||||
|
endcase
|
||||||
|
end else begin
|
||||||
|
prdata = 32'h0;
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
endmodule
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# =============================================================================
|
||||||
|
# check_z3_server.sh -- Palladium Z3 连通性测试脚本
|
||||||
|
#
|
||||||
|
# 完全基于当前终端已加载的 module 环境直接测试 test_server
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "=========================================================="
|
||||||
|
echo " Palladium Z3 硬件连通性测试 (test_server) "
|
||||||
|
echo " 当前使用: $(which test_server 2>/dev/null || echo '未检测到 test_server,请先 module load')"
|
||||||
|
echo "=========================================================="
|
||||||
|
|
||||||
|
test_server
|
||||||
|
RET_CODE=$?
|
||||||
|
|
||||||
|
echo "----------------------------------------------------------"
|
||||||
|
if [ $RET_CODE -eq 0 ]; then
|
||||||
|
echo "===> [SUCCESS] test_server 测试通过!Palladium Z3 通信正常!"
|
||||||
|
else
|
||||||
|
echo "===> [FAILED] test_server 退出码: $RET_CODE"
|
||||||
|
fi
|
||||||
|
echo "=========================================================="
|
||||||
@@ -0,0 +1,58 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# =============================================================================
|
||||||
|
# compile_sa.sh -- Palladium Z3 SA 模式统一编译脚本
|
||||||
|
# =============================================================================
|
||||||
|
set -e
|
||||||
|
cd "$(dirname "$0")/.."
|
||||||
|
ROOT="$PWD"
|
||||||
|
|
||||||
|
export XE_HOST="${XE_HOST:-z7f1x8c-5k9p3m}"
|
||||||
|
|
||||||
|
echo "======================================================================"
|
||||||
|
echo " [Palladium Z3 SA] 开始硬件与仿真加速统一编译"
|
||||||
|
echo " Target Host : $XE_HOST"
|
||||||
|
echo " DUT Module : z3_demo_top"
|
||||||
|
echo " 当前使用 ixcom : $(which ixcom 2>/dev/null || echo '未检测到')"
|
||||||
|
echo " 当前使用 xeCompile : $(which xeCompile 2>/dev/null || echo '未检测到,请 export PATH')"
|
||||||
|
echo "======================================================================"
|
||||||
|
|
||||||
|
mkdir -p ixcom_db
|
||||||
|
|
||||||
|
# 转换绝对路径
|
||||||
|
for f in rtl tb; do
|
||||||
|
out="ixcom_db/${f}_abs.f"
|
||||||
|
: > "$out"
|
||||||
|
while IFS= read -r line || [ -n "$line" ]; do
|
||||||
|
case "$line" in
|
||||||
|
/*) echo "$line" >> "$out" ;;
|
||||||
|
""|\#*) [ -n "$line" ] && echo "$line" >> "$out" ;;
|
||||||
|
*) echo "$ROOT/$line" >> "$out" ;;
|
||||||
|
esac
|
||||||
|
done < "${f}.f"
|
||||||
|
done
|
||||||
|
|
||||||
|
cd ixcom_db
|
||||||
|
|
||||||
|
set +e
|
||||||
|
ixcom -clean -ua +dut+z3_demo_top \
|
||||||
|
-z3 \
|
||||||
|
-ignoreSimSetupCheck \
|
||||||
|
-ignoreHWPlatformSetupCheck \
|
||||||
|
-ignoreVersionCheck \
|
||||||
|
-f ./rtl_abs.f -f ./tb_abs.f \
|
||||||
|
> compile_sa.log 2>&1
|
||||||
|
rc=$?
|
||||||
|
set -e
|
||||||
|
cat compile_sa.log
|
||||||
|
|
||||||
|
if [ "$rc" -ne 0 ] || grep -q -E '\*E,|ERROR|FLOW_FAILED' compile_sa.log; then
|
||||||
|
echo "======================================================================"
|
||||||
|
echo "== [FAIL] IXCOM 编译失败 (rc=$rc)!请查看日志: ixcom_db/compile_sa.log =="
|
||||||
|
echo "======================================================================"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo "======================================================================"
|
||||||
|
echo "== [SUCCESS] IXCOM SA 编译成功!日志: ixcom_db/compile_sa.log =="
|
||||||
|
echo " 下一步: 进入 ixcom_db 目录并执行 xeDebug"
|
||||||
|
echo "======================================================================"
|
||||||
@@ -0,0 +1,27 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# =============================================================================
|
||||||
|
# env_z3.sh -- Palladium Z3 纯净环境配置脚本 (全面锁定 24.05 版本)
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# 1. 彻底卸载任何已有的 25 版本 module,防止串味
|
||||||
|
module unload /home/software/module/WXE25.08.S003 2>/dev/null || true
|
||||||
|
module unload /home/software/module/IXCOM25.08.s003 2>/dev/null || true
|
||||||
|
|
||||||
|
# 2. 加载机房官方 24.05 / 24.09 标准环境模块
|
||||||
|
module load /home/software/module/WXE24.05.000
|
||||||
|
module load /home/software/module/IXCOM24.05.000
|
||||||
|
module load /home/software/module/XCELIUM24.09.013
|
||||||
|
|
||||||
|
# 3. 显式前置 24.05 的 Z3 专用二进制工具路径
|
||||||
|
export PATH=/home/software/WXE/WXE24.05.000/tools.lnx86/bin/z3/64bit:/home/software/WXE/WXE24.05.000/bin:$PATH
|
||||||
|
|
||||||
|
# 4. 机台连接参数
|
||||||
|
export XE_HOST="${XE_HOST:-z7f1x8c-5k9p3m}"
|
||||||
|
|
||||||
|
echo "=========================================================="
|
||||||
|
echo " [OK] 24.05 Module 加载完成 (官方纯净 24 系列生态)"
|
||||||
|
echo " - WXE : WXE24.05.000"
|
||||||
|
echo " - IXCOM : IXCOM24.05.000"
|
||||||
|
echo " - Xcelium : XCELIUM24.09.013"
|
||||||
|
echo " - XE_HOST : $XE_HOST"
|
||||||
|
echo "=========================================================="
|
||||||
@@ -0,0 +1,37 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# =============================================================================
|
||||||
|
# run_local.sh -- 在没有 Palladium Z3 物理机台时,本地免硬件验证 RTL 与 Testbench 逻辑
|
||||||
|
#
|
||||||
|
# 支持工具:
|
||||||
|
# - 默认:Icarus Verilog (iverilog + vvp)
|
||||||
|
# - 或 Cadence Xcelium (xrun)
|
||||||
|
# =============================================================================
|
||||||
|
set -e
|
||||||
|
cd "$(dirname "$0")/.."
|
||||||
|
|
||||||
|
mkdir -p sim_local
|
||||||
|
|
||||||
|
echo "=========================================================="
|
||||||
|
echo " 本地离线功能仿真验证 (z3_demo_top) "
|
||||||
|
echo "=========================================================="
|
||||||
|
|
||||||
|
if command -v iverilog >/dev/null 2>&1; then
|
||||||
|
echo "使用 Icarus Verilog 进行本地编译与仿真..."
|
||||||
|
iverilog -g2005 -DLOCAL_SIM -o sim_local/z3_demo.vvp -f rtl.f -f tb.f
|
||||||
|
vvp sim_local/z3_demo.vvp | tee sim_local/local_run.log
|
||||||
|
[ -f sim_local/z3_demo.vcd ] || [ -f z3_demo.vcd ] && mv -f z3_demo.vcd sim_local/ 2>/dev/null || true
|
||||||
|
elif command -v xrun >/dev/null 2>&1; then
|
||||||
|
echo "使用 Cadence xrun 进行本地仿真..."
|
||||||
|
xrun -64bit -define LOCAL_SIM -access +rwc -f rtl.f -f tb.f -logfile sim_local/local_run.log
|
||||||
|
else
|
||||||
|
echo "未检测到 iverilog 或 xrun,请先配置仿真器环境!"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
if grep -q "TEST PASSED" sim_local/local_run.log; then
|
||||||
|
echo "===> [SUCCESS] 本地验证测试通过 (PASS)!逻辑无误,可随时上机编译!"
|
||||||
|
else
|
||||||
|
echo "===> [FAIL] 本地仿真未通过,请检查日志: sim_local/local_run.log"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
# =============================================================================
|
||||||
|
# run_xedebug.tcl -- Palladium Z3 SA 模式标准运行脚本
|
||||||
|
#
|
||||||
|
# 官方标准流程:
|
||||||
|
# 1. debug . -- 进入调试上下文
|
||||||
|
# 2. host <XE_HOST> -- 连接 Palladium Z3 物理机台
|
||||||
|
# 3. xc on -run -- 下载 DUT 到硬件并协同运行 Host 端 Xcelium
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# 1. 进入调试上下文
|
||||||
|
debug .
|
||||||
|
|
||||||
|
# 2. 连接 Palladium Z3 物理机台
|
||||||
|
if {[info exists env(XE_HOST)]} {
|
||||||
|
host $env(XE_HOST)
|
||||||
|
} else {
|
||||||
|
host z7f1x8c-5k9p3m
|
||||||
|
}
|
||||||
|
|
||||||
|
# 3. 下载 DUT 到硬件并启动协同仿真
|
||||||
|
xc on -run
|
||||||
+192
@@ -0,0 +1,192 @@
|
|||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
// tb_z3_demo.v -- Simulation Acceleration testbench for z3_demo_top
|
||||||
|
//
|
||||||
|
// When compiled for Palladium SA mode:
|
||||||
|
// ixcom -ua +dut+z3_demo_top -f rtl.f -f tb.f
|
||||||
|
// this module runs on the host (Xcelium), driving transactions across the
|
||||||
|
// Palladium InfiniBand/PCIe link to z3_demo_top which runs inside Palladium Z3.
|
||||||
|
//
|
||||||
|
// The testbench can also be run locally on a workstation (iverilog / xrun)
|
||||||
|
// via scripts/run_local.sh without Palladium hardware.
|
||||||
|
// -----------------------------------------------------------------------------
|
||||||
|
`timescale 1ns/1ps
|
||||||
|
|
||||||
|
module tb_z3_demo;
|
||||||
|
|
||||||
|
reg clk;
|
||||||
|
reg rst_n;
|
||||||
|
reg [7:0] paddr;
|
||||||
|
reg psel;
|
||||||
|
reg penable;
|
||||||
|
reg pwrite;
|
||||||
|
reg [31:0] pwdata;
|
||||||
|
wire [31:0] prdata;
|
||||||
|
wire pready;
|
||||||
|
wire [7:0] gpio_out;
|
||||||
|
wire irq;
|
||||||
|
wire cmp_hit;
|
||||||
|
|
||||||
|
// Instantiate DUT
|
||||||
|
z3_demo_top dut (
|
||||||
|
.clk (clk),
|
||||||
|
.rst_n (rst_n),
|
||||||
|
.paddr (paddr),
|
||||||
|
.psel (psel),
|
||||||
|
.penable (penable),
|
||||||
|
.pwrite (pwrite),
|
||||||
|
.pwdata (pwdata),
|
||||||
|
.prdata (prdata),
|
||||||
|
.pready (pready),
|
||||||
|
.gpio_out (gpio_out),
|
||||||
|
.irq (irq),
|
||||||
|
.cmp_hit (cmp_hit)
|
||||||
|
);
|
||||||
|
|
||||||
|
// 100 MHz clock
|
||||||
|
always #5 clk = ~clk;
|
||||||
|
|
||||||
|
// APB write task
|
||||||
|
task apb_write(input [7:0] addr, input [31:0] data);
|
||||||
|
begin
|
||||||
|
@(posedge clk);
|
||||||
|
paddr <= addr;
|
||||||
|
pwrite <= 1'b1;
|
||||||
|
psel <= 1'b1;
|
||||||
|
pwdata <= data;
|
||||||
|
@(posedge clk);
|
||||||
|
penable <= 1'b1;
|
||||||
|
@(posedge clk);
|
||||||
|
while (!pready) @(posedge clk);
|
||||||
|
psel <= 1'b0;
|
||||||
|
penable <= 1'b0;
|
||||||
|
pwrite <= 1'b0;
|
||||||
|
end
|
||||||
|
endtask
|
||||||
|
|
||||||
|
// APB read task
|
||||||
|
task apb_read(input [7:0] addr, output [31:0] data);
|
||||||
|
begin
|
||||||
|
@(posedge clk);
|
||||||
|
paddr <= addr;
|
||||||
|
pwrite <= 1'b0;
|
||||||
|
psel <= 1'b1;
|
||||||
|
@(posedge clk);
|
||||||
|
penable <= 1'b1;
|
||||||
|
@(posedge clk);
|
||||||
|
while (!pready) @(posedge clk);
|
||||||
|
data = prdata;
|
||||||
|
psel <= 1'b0;
|
||||||
|
penable <= 1'b0;
|
||||||
|
end
|
||||||
|
endtask
|
||||||
|
|
||||||
|
reg [31:0] rdata;
|
||||||
|
integer pass_count;
|
||||||
|
integer fail_count;
|
||||||
|
|
||||||
|
initial begin
|
||||||
|
pass_count = 0;
|
||||||
|
fail_count = 0;
|
||||||
|
clk = 0;
|
||||||
|
rst_n = 0;
|
||||||
|
paddr = 0;
|
||||||
|
psel = 0;
|
||||||
|
penable = 0;
|
||||||
|
pwrite = 0;
|
||||||
|
pwdata = 0;
|
||||||
|
|
||||||
|
`ifdef LOCAL_SIM
|
||||||
|
$dumpfile("sim_local/z3_demo.vcd");
|
||||||
|
$dumpvars(0, tb_z3_demo);
|
||||||
|
`endif
|
||||||
|
|
||||||
|
$display("==========================================================");
|
||||||
|
$display(" Palladium Z3 SA-Mode Verification Start (z3_demo_top) ");
|
||||||
|
$display("==========================================================");
|
||||||
|
|
||||||
|
// Reset DUT
|
||||||
|
#100;
|
||||||
|
rst_n = 1;
|
||||||
|
#20;
|
||||||
|
|
||||||
|
// Check 1: ID Register Verification (Z3 signature 0x5A33_0001)
|
||||||
|
apb_read(8'h18, rdata);
|
||||||
|
if (rdata == 32'h5A33_0001) begin
|
||||||
|
$display("[PASS] Check 1: Z3 ID register match (0x%08X)", rdata);
|
||||||
|
pass_count = pass_count + 1;
|
||||||
|
end else begin
|
||||||
|
$display("[FAIL] Check 1: Z3 ID mismatch! Expected 0x5A330001, got 0x%08X", rdata);
|
||||||
|
fail_count = fail_count + 1;
|
||||||
|
end
|
||||||
|
|
||||||
|
// Check 2: Default LOAD and COUNT value
|
||||||
|
apb_read(8'h08, rdata);
|
||||||
|
if (rdata == 32'd9) begin
|
||||||
|
$display("[PASS] Check 2: Default COUNT is 9");
|
||||||
|
pass_count = pass_count + 1;
|
||||||
|
end else begin
|
||||||
|
$display("[FAIL] Check 2: Default COUNT error: 0x%08X", rdata);
|
||||||
|
fail_count = fail_count + 1;
|
||||||
|
end
|
||||||
|
|
||||||
|
// Check 3: Configure Timer: LOAD=5, CMP=2, CTRL=(enable|irq_en|pattern_en)
|
||||||
|
apb_write(8'h04, 32'd5); // LOAD = 5
|
||||||
|
apb_write(8'h0C, 32'd2); // CMP = 2
|
||||||
|
apb_write(8'h00, 32'h07); // CTRL: enable=1, irq_en=1, pattern_en=1
|
||||||
|
|
||||||
|
// Wait for timer interrupt
|
||||||
|
@(posedge irq);
|
||||||
|
$display("[PASS] Check 3: Timer interrupt (irq) asserted!");
|
||||||
|
pass_count = pass_count + 1;
|
||||||
|
|
||||||
|
// Check 4: Status Register (timeout and cmp flags should be set)
|
||||||
|
apb_read(8'h10, rdata);
|
||||||
|
if ((rdata & 32'h03) == 32'h03) begin
|
||||||
|
$display("[PASS] Check 4: STATUS register bits set (timeout & cmp: 0x%08X)", rdata);
|
||||||
|
pass_count = pass_count + 1;
|
||||||
|
end else begin
|
||||||
|
$display("[FAIL] Check 4: STATUS register error: 0x%08X", rdata);
|
||||||
|
fail_count = fail_count + 1;
|
||||||
|
end
|
||||||
|
|
||||||
|
// Check 5: Clear status (W1C)
|
||||||
|
apb_write(8'h10, 32'h03);
|
||||||
|
apb_read(8'h10, rdata);
|
||||||
|
if ((rdata & 32'h03) == 32'h00) begin
|
||||||
|
$display("[PASS] Check 5: STATUS cleared via W1C");
|
||||||
|
pass_count = pass_count + 1;
|
||||||
|
end else begin
|
||||||
|
$display("[FAIL] Check 5: STATUS W1C failed: 0x%08X", rdata);
|
||||||
|
fail_count = fail_count + 1;
|
||||||
|
end
|
||||||
|
|
||||||
|
// Check 6: GPIO Rotating Pattern (0x01 -> 0x02 on first timeout)
|
||||||
|
apb_read(8'h14, rdata);
|
||||||
|
if (rdata[7:0] == 8'h02) begin
|
||||||
|
$display("[PASS] Check 6: GPIO pattern rotated to 0x02");
|
||||||
|
pass_count = pass_count + 1;
|
||||||
|
end else begin
|
||||||
|
$display("[FAIL] Check 6: GPIO pattern error: 0x%02X", rdata[7:0]);
|
||||||
|
fail_count = fail_count + 1;
|
||||||
|
end
|
||||||
|
|
||||||
|
#200;
|
||||||
|
$display("==========================================================");
|
||||||
|
if (fail_count == 0) begin
|
||||||
|
$display(" TEST PASSED: ALL %0d CHECKS COMPLETED ON Z3 ! ", pass_count);
|
||||||
|
end else begin
|
||||||
|
$display(" TEST FAILED: %0d PASSED, %0d FAILED ", pass_count, fail_count);
|
||||||
|
end
|
||||||
|
$display("==========================================================");
|
||||||
|
|
||||||
|
$finish;
|
||||||
|
end
|
||||||
|
|
||||||
|
// Safety timeout
|
||||||
|
initial begin
|
||||||
|
#100000;
|
||||||
|
$display("[TIMEOUT] Simulation reached max time limit (watchdog)!");
|
||||||
|
$finish;
|
||||||
|
end
|
||||||
|
|
||||||
|
endmodule
|
||||||
Reference in New Issue
Block a user