Files

39 lines
1.8 KiB
Tcl

# =============================================================================
# run_xedebug.tcl -- Run the demo on Palladium Z2 (SA mode) from xeDebug.
#
# Launch (ON THE SA HOST, from the ixcom_db directory made by compile_sa.sh):
# xeDebug -f run_xedebug.tcl
# or start xeDebug interactively and `source run_xedebug.tcl`.
#
# SA-mode notes:
# * xeDebug MUST run on the SA host (not on an arbitrary workstation).
# * There is no separate xmsim log in SA mode: simulator output is merged
# into xeDebug.log -- grep it for "CHECK" / "TEST PASSED" / *E,*F errors.
# * Command spellings (host / xc on -run) follow the Z2 guide and field
# practice; confirm with xeDebug `help` on your VXE release if needed.
# =============================================================================
# 1) Connect to the emulation host (same value as $XE_HOST).
# Use `host .` instead if xeDebug is already running on that host.
host <XE_HOST_NAME>
# 2) Download the design into the emulator and start it (hot-swap download).
xc on -run
# 3) The testbench (host side) now drives the APB bus, waits for the timer
# interrupt, and prints its checks. A successful run ends with:
# CHECK OK : ID register = 0x5a320001
# ... (8 checks) ...
# TEST PASSED (all checks)
# Watch xeDebug.log, or in the GUI open the waveform on:
# tb_z2_demo.dut.reg_count / gpio_out / irq
#
# If the run appears stuck, do NOT kill it blindly: first check whether
# xc_top.simTime is still advancing and take two gstack samples of the
# xmsim main thread (a spinning main thread points to a zero-time loop
# in the TB, a blocked one points elsewhere).
# 4) Optional: keep the host connection warm for the next xeDebug session
# (default reuse window is 180 s):
# xeset keepHostAliveTimeout 600