feat: complete Palladium Z2 demo for both SA and ICE emulation flows

This commit is contained in:
xuejin.wang
2026-10-19 21:35:38 +08:00
commit 398729ec51
18 changed files with 1347 additions and 0 deletions
+46
View File
@@ -0,0 +1,46 @@
#!/bin/sh
# =============================================================================
# compile_ice.sh -- Palladium Z2 ICE 模式硬件编译脚本
#
# 原理说明:
# 通过 Cadence IXCOM 统一前端调用 -ua +dut+z2_demo_ice_top,触发后端 AVS / xeCompile
# 对顶层模块进行全硬件逻辑综合、关键路径分析,并将网表映射进 Palladium Z2 物理机台。
#
# 使用方式:
# XE_HOST=scz2_emu XE_BOARDS=18.0 ./ice/scripts/compile_ice.sh
# =============================================================================
set -e
cd "$(dirname "$0")/../.." # 切到工程根目录
ROOT="$(pwd)"
export XE_HOST="${XE_HOST:-scz2_emu}"
export XE_BOARDS="${XE_BOARDS:-18.0}"
echo "======================================================================"
echo " [Palladium Z2 ICE] 开始编译硬件设计"
echo " Target Host : $XE_HOST"
echo " Target Boards : $XE_BOARDS"
echo " Top Module : z2_demo_ice_top"
echo "======================================================================"
set +e
ixcom -clean -ua +dut+z2_demo_ice_top \
"$ROOT/ice/rtl/z2_demo_top.v" \
"$ROOT/ice/rtl/z2_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 Z2 ICE 硬件编译成功!"
echo " 编译产物已生成: AxisWork / xc_work (含 xeCompile 网表与 Signature)"
echo " 下一步: 执行 xeDebug 进行上机运行与状态机自检"
echo "======================================================================"
+11
View File
@@ -0,0 +1,11 @@
#!/bin/sh
# run_local_ice.sh -- Verify the ICE top (stimulus FSM + DUT) without hardware.
# Expected: sequence finishes, led_pass=1, led_gpio=0x02, "ICE LOCAL TEST PASSED".
set -e
cd "$(dirname "$0")/../.."
mkdir -p ice/sim_local
iverilog -g2005 -o ice/sim_local/z2_demo_ice.vvp \
ice/rtl/z2_demo_top.v ice/rtl/z2_demo_ice_top.v ice/tb/tb_z2_demo_ice.v
vvp ice/sim_local/z2_demo_ice.vvp | tee ice/sim_local/ice_run.log
grep -q "ICE LOCAL TEST PASSED" ice/sim_local/ice_run.log \
&& echo "== ICE LOCAL RUN: PASS ==" || { echo "== ICE LOCAL RUN: FAIL =="; exit 1; }
+74
View File
@@ -0,0 +1,74 @@
# =============================================================================
# run_xedebug_ice.tcl -- Palladium Z2 ICE 模式上机下载与调试运行脚本
#
# 使用方式:
# 在工程根目录下执行:
# xeDebug -f ice/scripts/run_xedebug_ice.tcl
# 或者启动交互界面后手动执行:
# xeDebug
# XE> source ice/scripts/run_xedebug_ice.tcl
# =============================================================================
# 1) 载入当前硬件设计签名并连接目标 Palladium Z2 Emulator
debug .
if {[info exists env(XE_HOST)]} {
host $env(XE_HOST)
} elseif {[info exists env(XE_HOSTNAME)]} {
host $env(XE_HOSTNAME)
} else {
host scz2_emu
}
# 2) 下载比特流到硬件机台 (xc on / download 兼容处理)
if {[catch {xc on} err]} {
catch {download}
}
# 3) 复位激励时序:拉低复位 -> 跑 20 个时钟周期 -> 释放复位
catch {force z2_demo_ice_top.rst_n_in 0}
run 20
catch {force z2_demo_ice_top.rst_n_in 1}
# 4) 运行时钟推進激励(自检状态机大约在 45 个周期内完成检查并挂起)
run 1000
# 5) 提取并展示 LED 输出判读结果
puts ""
puts "======================================================="
puts " Palladium Z2 ICE 运行测试结果 "
puts "======================================================="
set done 0
set pass 0
set fail 0
set gpio "??"
# 兼容 get 与 value 命令
if {![catch {get -radix bin z2_demo_ice_top.led_done} val]} {
set done $val
set pass [get -radix bin z2_demo_ice_top.led_pass]
set fail [get -radix bin z2_demo_ice_top.led_fail]
set gpio [get -radix hex z2_demo_ice_top.led_gpio]
} elseif {![catch {value z2_demo_ice_top.led_done} val]} {
set done $val
catch {set pass [value z2_demo_ice_top.led_pass]}
catch {set fail [value z2_demo_ice_top.led_fail]}
catch {set gpio [value z2_demo_ice_top.led_gpio]}
}
puts " led_done : $done (测试序列是否完成,预期: 1)"
puts " led_pass : $pass (全硬件检查是否通过,预期: 1)"
puts " led_fail : $fail (是否有硬件检查失败,预期: 0)"
puts " led_gpio : 0x$gpio (跑马灯寄存器旋转值,预期: 0x02)"
puts "-------------------------------------------------------"
if {$pass == 1 && $fail == 0} {
puts " >>> [SUCCESS] ICE DEMO 全部硬件自检测试通过! <<<"
} else {
puts " >>> [FAIL] ICE DEMO 硬件检查未通过,请排查状态机停滞位置 <<<"
catch {puts " FSM State : [get -radix dec z2_demo_ice_top.state]"}
catch {puts " Last Latched: 0x[get -radix hex z2_demo_ice_top.rd_latched]"}
}
puts "======================================================="
puts ""