From 1cc994fac4bd702be1e80480465069c5ee7642ea Mon Sep 17 00:00:00 2001 From: "xuejin.wang" Date: Tue, 20 Oct 2026 19:01:16 +0800 Subject: [PATCH] feat: complete Palladium Z3 demo (SA & ICE dual-mode) and 24.05 hardware compilation fix --- .gitignore | 13 ++ README.md | 175 ++++++++++++++++++ docs/PALLADIUM_Z3_24.05_SOLUTION.md | 269 ++++++++++++++++++++++++++++ ice/rtl/z3_demo_ice_top.v | 190 ++++++++++++++++++++ ice/rtl/z3_demo_top.v | 108 +++++++++++ ice/scripts/compile_ice.sh | 42 +++++ ice/scripts/run_local_ice.sh | 40 +++++ ice/scripts/run_xedebug_ice.tcl | 43 +++++ ice/tb/tb_z3_demo_ice.v | 71 ++++++++ rtl.f | 1 + rtl/z3_demo_top.v | 134 ++++++++++++++ scripts/check_z3_server.sh | 23 +++ scripts/compile_sa.sh | 58 ++++++ scripts/env_z3.sh | 27 +++ scripts/run_local.sh | 37 ++++ scripts/run_xedebug.tcl | 21 +++ tb.f | 1 + tb/tb_z3_demo.v | 192 ++++++++++++++++++++ 18 files changed, 1445 insertions(+) create mode 100644 .gitignore create mode 100644 README.md create mode 100644 docs/PALLADIUM_Z3_24.05_SOLUTION.md create mode 100644 ice/rtl/z3_demo_ice_top.v create mode 100644 ice/rtl/z3_demo_top.v create mode 100644 ice/scripts/compile_ice.sh create mode 100644 ice/scripts/run_local_ice.sh create mode 100644 ice/scripts/run_xedebug_ice.tcl create mode 100644 ice/tb/tb_z3_demo_ice.v create mode 100644 rtl.f create mode 100644 rtl/z3_demo_top.v create mode 100644 scripts/check_z3_server.sh create mode 100644 scripts/compile_sa.sh create mode 100644 scripts/env_z3.sh create mode 100644 scripts/run_local.sh create mode 100644 scripts/run_xedebug.tcl create mode 100644 tb.f create mode 100644 tb/tb_z3_demo.v diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..ebd1a8b --- /dev/null +++ b/.gitignore @@ -0,0 +1,13 @@ +# Palladium Z3 编译数据库与仿真临时文件 +ixcom_db/ +AxisWork/ +xc_work/ +sim_local/ +*.log +*.key +*.vcd +*.fsdb +*.shm +.simvision/ +INCA_libs/ +xcelium.d/ diff --git a/README.md b/README.md new file mode 100644 index 0000000..be26876 --- /dev/null +++ b/README.md @@ -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`)
`[1]` 中断使能 (`irq_en`)
`[2]` 跑马灯使能 (`pattern_en`) | +| `0x04` | **LOAD** | RW | `0x09` | 计数器重载值 (写入时直接同步预置当前计数) | +| `0x08` | **COUNT** | RO | `0x09` | 当前实时倒计数值 | +| `0x0C` | **CMP** | RW | `0x03` | 比较匹配值 | +| `0x10` | **STATUS** | W1C | `0x00` | `[0]` 超时中断标志
`[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`)。 diff --git a/docs/PALLADIUM_Z3_24.05_SOLUTION.md b/docs/PALLADIUM_Z3_24.05_SOLUTION.md new file mode 100644 index 0000000..fb506a1 --- /dev/null +++ b/docs/PALLADIUM_Z3_24.05_SOLUTION.md @@ -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 +``` diff --git a/ice/rtl/z3_demo_ice_top.v b/ice/rtl/z3_demo_ice_top.v new file mode 100644 index 0000000..7012085 --- /dev/null +++ b/ice/rtl/z3_demo_ice_top.v @@ -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 diff --git a/ice/rtl/z3_demo_top.v b/ice/rtl/z3_demo_top.v new file mode 100644 index 0000000..58c6fef --- /dev/null +++ b/ice/rtl/z3_demo_top.v @@ -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 diff --git a/ice/scripts/compile_ice.sh b/ice/scripts/compile_ice.sh new file mode 100644 index 0000000..3ad880e --- /dev/null +++ b/ice/scripts/compile_ice.sh @@ -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 "======================================================================" diff --git a/ice/scripts/run_local_ice.sh b/ice/scripts/run_local_ice.sh new file mode 100644 index 0000000..d5bf6ce --- /dev/null +++ b/ice/scripts/run_local_ice.sh @@ -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 diff --git a/ice/scripts/run_xedebug_ice.tcl b/ice/scripts/run_xedebug_ice.tcl new file mode 100644 index 0000000..1bc6308 --- /dev/null +++ b/ice/scripts/run_xedebug_ice.tcl @@ -0,0 +1,43 @@ +# ============================================================================= +# run_xedebug_ice.tcl -- Palladium Z3 ICE 标准上机运行脚本 +# +# 官方标准流程: +# 1. debug . -- 进入调试上下文 +# 2. 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 "==========================================================" diff --git a/ice/tb/tb_z3_demo_ice.v b/ice/tb/tb_z3_demo_ice.v new file mode 100644 index 0000000..5252243 --- /dev/null +++ b/ice/tb/tb_z3_demo_ice.v @@ -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 diff --git a/rtl.f b/rtl.f new file mode 100644 index 0000000..92e63f6 --- /dev/null +++ b/rtl.f @@ -0,0 +1 @@ +rtl/z3_demo_top.v diff --git a/rtl/z3_demo_top.v b/rtl/z3_demo_top.v new file mode 100644 index 0000000..92cc5b1 --- /dev/null +++ b/rtl/z3_demo_top.v @@ -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 diff --git a/scripts/check_z3_server.sh b/scripts/check_z3_server.sh new file mode 100644 index 0000000..e82bcf6 --- /dev/null +++ b/scripts/check_z3_server.sh @@ -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 "==========================================================" diff --git a/scripts/compile_sa.sh b/scripts/compile_sa.sh new file mode 100644 index 0000000..1bcfa68 --- /dev/null +++ b/scripts/compile_sa.sh @@ -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 "======================================================================" diff --git a/scripts/env_z3.sh b/scripts/env_z3.sh new file mode 100644 index 0000000..f3ddd17 --- /dev/null +++ b/scripts/env_z3.sh @@ -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 "==========================================================" diff --git a/scripts/run_local.sh b/scripts/run_local.sh new file mode 100644 index 0000000..1899861 --- /dev/null +++ b/scripts/run_local.sh @@ -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 diff --git a/scripts/run_xedebug.tcl b/scripts/run_xedebug.tcl new file mode 100644 index 0000000..648c138 --- /dev/null +++ b/scripts/run_xedebug.tcl @@ -0,0 +1,21 @@ +# ============================================================================= +# run_xedebug.tcl -- Palladium Z3 SA 模式标准运行脚本 +# +# 官方标准流程: +# 1. debug . -- 进入调试上下文 +# 2. 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 diff --git a/tb.f b/tb.f new file mode 100644 index 0000000..bc7dae7 --- /dev/null +++ b/tb.f @@ -0,0 +1 @@ +tb/tb_z3_demo.v diff --git a/tb/tb_z3_demo.v b/tb/tb_z3_demo.v new file mode 100644 index 0000000..17af962 --- /dev/null +++ b/tb/tb_z3_demo.v @@ -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