Compare commits

...

1 Commits

Author SHA1 Message Date
xuejin.wang d41d9823aa docs: record full resolution of 8 Z3 issues and hardware verification test pass results 2026-10-20 20:31:08 +08:00
2 changed files with 158 additions and 10 deletions
+22 -3
View File
@@ -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 硬件,可随时在工作站上离线验证逻辑:
+136 -7
View File
@@ -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+<module_name> if the always process represents a supported clock model in dut.
```
#### 【深度根因】
Cadence Palladium 硬件仿真器对 DUT 内的延迟有严格的综合语义检查。默认情况下,硬件综合器禁止在 DUT 中出现不带敏感列表的 `#delay`。
如果需要在 DUT 内部自建自由振荡时钟,必须通过 `+iscDelay+<module_name>` 告诉综合前端这是合法的时钟生成模型。
#### 【解决办法】
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 模式全硬件流程正式跑通闭环**。