diff --git a/README.md b/README.md index be26876..9a71d0c 100644 --- a/README.md +++ b/README.md @@ -152,16 +152,35 @@ source scripts/env_z3.sh ### 第二步:下载进 Palladium Z3 并自动判读 ```bash -xeDebug -f ice/scripts/run_xedebug_ice.tcl +xeDebug -input ice/scripts/run_xedebug_ice.tcl ``` 脚本将硬件引脚读回终端: - `led_done = 1`:自检执行完毕; - `led_pass = 1`,`led_fail = 0`:所有硬件级断言均通过; -- `led_gpio = 0x02`:跑马灯正常移位。 +- `led_gpio = 0x02`:跑马灯正常移位; +- 打印:`===> [TEST PASSED] Palladium Z3 ICE 全硬件测试通过!`。 --- -## 6. 本地离线免硬件验证(Smoke Test) +## 6. 上机实测通过日志(Palladium Z3 Hardware Verification) + +```text +XEin> debug . +XEin> host z7f1x8c-5k9p3m +XEin> xc on -run +XEin> after 2000 +========================================================== + led_done : 1'b1 + led_pass : 1'b1 + led_fail : 1'b0 + led_gpio : 8'b00000010 +===> [TEST PASSED] Palladium Z3 ICE 全硬件测试通过! +========================================================== +``` + +--- + +## 7. 本地离线免硬件验证(Smoke Test) 如果当前没有连接到 Palladium Z3 硬件,可随时在工作站上离线验证逻辑: diff --git a/docs/PALLADIUM_Z3_24.05_SOLUTION.md b/docs/PALLADIUM_Z3_24.05_SOLUTION.md index fb506a1..ede40b1 100644 --- a/docs/PALLADIUM_Z3_24.05_SOLUTION.md +++ b/docs/PALLADIUM_Z3_24.05_SOLUTION.md @@ -13,7 +13,7 @@ --- -## 2. 踩坑与完整根因复盘(五大核心问题) +## 2. 踩坑与完整根因复盘(八大核心问题) ### 2.1 问题一:`hdl2qtdb: symbol lookup error: libimport.so: undefined symbol: ASSERT_RESET` @@ -151,6 +151,70 @@ ixcom -clean -ua +dut+z3_demo_ice_top \ --- +### 2.6 问题六:`[DUT_DELAY_UNSUPPORTED] Delay statement within an always process without any sensitivity list is not allowed in dut` + +#### 【现象】 +在 ICE 纯硬件模式下,为了让设计脱离外部 Testbench 具备自主自振荡时钟,在 `z3_demo_ice_top.v` 中引入硬件时钟模型: +```verilog +always #10 clk_osc = ~clk_osc; +``` +`ixcom` 的 `vhelab` 阶段报错中断: +```text +Error! in file .../z3_demo_ice_top.v at line 41 in module z3_demo_ice_top [DUT_DELAY_UNSUPPORTED] +Delay statement within an always process without any sensitivity list is not allowed in dut. +Please use +iscDelay+ if the always process represents a supported clock model in dut. +``` + +#### 【深度根因】 +Cadence Palladium 硬件仿真器对 DUT 内的延迟有严格的综合语义检查。默认情况下,硬件综合器禁止在 DUT 中出现不带敏感列表的 `#delay`。 +如果需要在 DUT 内部自建自由振荡时钟,必须通过 `+iscDelay+` 告诉综合前端这是合法的时钟生成模型。 + +#### 【解决办法】 +1. 在 `compile_ice.sh` 的 `ixcom` 命令行中加入 `+iscDelay+z3_demo_ice_top` 开关。 +2. 综合器将其自动映射为专用的硬件时钟原语 `ixc_uClkGen`,实现板载无外部信号驱动下的硬件全自主运行。 + +--- + +### 2.7 问题七:`run: ucExecRunCmd failed: no simulator` 与信号全为 `1'bx` + +#### 【现象】 +在 `xeDebug`(`XEin>`)中执行 `run` 报错: +```text +run: ucExecRunCmd failed: no simulator +XEin> value z3_demo_ice_top.led_done +1'bx +``` + +#### 【深度根因】 +在后台重新执行 `compile_ice.sh` 编译并重新生成全新 `xc_work` 网表时,之前已经打开的 `xeDebug` 交互会话与底层仿真器/硬件的通信进程已断开或失效。继续在该僵死会话中查询引脚值,自然全部返回 `1'bx`。 + +#### 【解决办法】 +在当前僵死会话中执行 `quit` 退出,然后重新启动全新的 `xeDebug` 载入最新网表: +```bash +xeDebug -input ice/scripts/run_xedebug_ice.tcl +``` + +--- + +### 2.8 问题八:Windows CRLF 换行符导致 Linux 报错 `/bin/sh^M: 解释器错误` + +#### 【现象】 +从 Windows 检出脚本并在 Linux 下执行时报错: +```text +/bin/sh^M: 解释器错误: 没有那个文件或目录 +``` + +#### 【解决办法】 +在仓库根目录添加 `.gitattributes` 配置文件,全局强制所有平台均使用 Linux 风格的 LF 换行: +```gitattributes +* text=auto eol=lf +*.sh text eol=lf +*.v text eol=lf +*.tcl text eol=lf +``` + +--- + ## 3. 标准规范的 Module 配置文件 ### 3.1 `/home/software/module/WXE24.05.000` @@ -245,17 +309,19 @@ Info [FLOW_SUCCESS] ### 4.3 ICE 模式 Palladium Z3 上机运行 ```bash -# 启动 Z3 交互调试器 -xeDebug -tcl -play ice/scripts/run_xedebug_ice.tcl +# 启动 Z3 交互调试器并自动执行判读 +xeDebug -input 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 +after 2000 +value z3_demo_ice_top.led_done +value z3_demo_ice_top.led_pass +value z3_demo_ice_top.led_fail +value z3_demo_ice_top.led_gpio ``` ### 4.4 SA 模式硬件编译与运行 @@ -267,3 +333,66 @@ get z3_demo_ice_top.check_pass cd ixcom_db xeDebug -tcl -play ../scripts/run_xedebug.tcl ``` + +--- + +## 5. 【实测通过】Palladium Z3 上机实测完整记录 + +### 5.1 硬件综合与映射日志(compile_ice.log) +```text +INFO (legacy-0): 91827 smTrNets have been restored: elapsed time 0 sec +INFO (legacy-0): 89206 smTrPrims have been restored: elapsed time 0 sec +INFO (legacy-0): flat-conns have been restored: elapsed time 0 sec +INFO (legacy-0): 99159 synonyms have been setup: elapsed time 0 sec +INFO (legacy-0): smNetIDs have been setup: elapsed time 0 sec +INFO (legacy-0): CRT-FULL has been restored: elapsed time 0 sec +INFO (legacy-43368): Successfully getting critical path design net names. +0 -1 256 0 0 +XEC> puts "IXCOMQEL> running $compileScript took [expr [clock seconds] - $t]s" +IXCOMQEL> running compile -names_crit took 47s + +// xeCompile ended at : Tue Oct 20 08:15:54 2026 (total: 93 sec), heap memory used by IXCOM : 240.06M bytes + +Info [FLOW_SUCCESS] + Successfully built target (xeCompile) + +// nc elaborate started at : Tue Oct 20 08:14:19 2026 + Please refer to xc_work/xc_make.log for the AVS log. +// nc elaborate ended at : Tue Oct 20 08:14:20 2026 (total: 1 sec) +Info [FLOW_SUCCESS] + Successfully built target (nc elaborate) + +// ixcom ended at : Tue Oct 20 08:15:54 2026 (total: 99 sec), heap memory used by IXCOM : 207.29M bytes +// peak virtual memory size (VmPeak) used by IXCOM : 321.83M bytes, peak resident memory size (VmHWM) used by IXCOM : 27.37M bytes +``` + +### 5.2 硬件在线仿真执行与自动判读输出(xeDebug) +```text +XEin> debug . +XEin> host z7f1x8c-5k9p3m +XEin> xc on -run +XEin> after 2000 +XEin> puts "==========================================================" +========================================================== +XEin> puts " led_done : $done_val" + led_done : 1'b1 +XEin> puts " led_pass : $pass_val" + led_pass : 1'b1 +XEin> puts " led_fail : $fail_val" + led_fail : 1'b0 +XEin> puts " led_gpio : $gpio_val" + led_gpio : 8'b00000010 +XEin> +XEin> if {$pass_val == 1 && $fail_val == 0} { + puts "===> [TEST PASSED] Palladium Z3 ICE 全硬件测试通过!" +} else { + puts "===> [TEST FAILED] ICE 硬件自检未通过" +} +===> [TEST PASSED] Palladium Z3 ICE 全硬件测试通过! +========================================================== +``` +- **测试判定**: + 1. 状态机完成全部 6 项硬件自检(ID 校验、复位计数、定时器超时中断、W1C 清除、跑马灯循环移位),`led_done` 稳定拉高 (`1'b1`); + 2. 硬件断言全部符合预期,`led_pass` 为 `1'b1`,`led_fail` 为 `1'b0`; + 3. GPIO 图案成功循环左移一位至 `8'b00000010`; + 4. 验证结论:**Palladium Z3 硬件仿真平台 ICE 模式全硬件流程正式跑通闭环**。