feat(tb): add Vivado XSIM Verilog testbenches for all 10 sync modules

Add file-based vector testbenches ( + ) for:
- mod_add_sync, rng_sync, poly_arith_sync, comp_decomp_sync
- s_bram/sd_bram, sha3_chain_top
- ntt_core, poly_mul_sync
- sample_cbd_sync, sample_ntt_sync

Each module includes:
- tb_<module>_xsim.v: Vivado XSIM testbench
- gen_vectors.py: Python vector generator (stdlib only)
- vectors/<module>_input.hex: test input vectors
- xsim_run.tcl: compile + elaborate + simulate script
This commit is contained in:
2026-06-25 20:48:38 +08:00
parent ae5f0ca048
commit d4c3fc86fc
42 changed files with 7745 additions and 0 deletions

View File

@@ -0,0 +1,69 @@
# xsim_run.tcl - Vivado xsim compilation and simulation script for PolyMul
#
# Compiles all PolyMul RTL sources plus dependencies, then testbench,
# and runs simulation.
# Run from the project root: ~/Dev/mlkem/
#
# Prerequisites:
# source /opt/Xilinx/Vivado/2019.2/settings64.sh
#
# Usage examples:
# # Run poly_mul_sync testbench
# xsim poly_mul_sim -R
#
# # Step-by-step:
# vivado -mode batch -source xsim_run.tcl
# ================================================================
# Configuration
# ================================================================
set NTT_DIR sync_rtl/ntt
set PM_DIR sync_rtl/poly_mul
set TB_DIR sync_rtl/poly_mul/TB
# ================================================================
# Step 1: Compile dependency sources (ntt/barrett_mul)
# ================================================================
puts "=== Compiling RTL dependencies ==="
# Barrett modular multiplier (shared dependency from ntt/)
xvlog -sv ${NTT_DIR}/barrett_mul.v
# ================================================================
# Step 2: Compile PolyMul sources
# ================================================================
puts "=== Compiling PolyMul RTL sources ==="
# Basecase multiplier (instantiates barrett_mul)
xvlog -sv ${PM_DIR}/basecase_mul.v
# PolyMul zeta ROM
xvlog -sv ${PM_DIR}/poly_mul_zeta_rom.v
# PolyMul sync top (instantiates basecase_mul + poly_mul_zeta_rom)
xvlog -sv ${PM_DIR}/poly_mul_sync.v
# ================================================================
# Step 3: Compile testbench
# ================================================================
puts "=== Compiling testbench ==="
# File-based vector testbench for poly_mul_sync
xvlog -sv ${TB_DIR}/tb_poly_mul_xsim.v
# ================================================================
# Step 4: Elaborate (xelab)
# ================================================================
puts "=== Elaborating snapshot ==="
xelab tb_poly_mul_xsim -s poly_mul_sim
# ================================================================
# Step 5: Run simulation
# ================================================================
puts ""
puts "=== Running poly_mul_sync test ==="
xsim poly_mul_sim -R
puts ""
puts "=== Simulation complete ==="