thejayman77
ba74bbd5aa
Per-vertex GS fog end-to-end (gs_stub emit incl. persp_emit5, gs_prim_list_feeder XYZ2->XYZF2 on PRIM.FGE, gs_make_sh3_scheduler_fixture.py F/FGE packing), new fog TBs, fidelity attribution tooling. Functional baseline before removing the dead bilinear lerp8 clamps (Codex: 161-node comb loop -> -0.042ns setup fail). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
329 lines
22 KiB
Bash
Executable File
329 lines
22 KiB
Bash
Executable File
#!/bin/sh
|
|
# select_de25_profile.sh — pick the DE25-Nano board build profile WITHOUT hand-editing
|
|
# the QSF. Rewrites the two managed marker blocks in the board QSF:
|
|
# # >>> DE25_PROFILE_FIXTURE >>> ... # <<< DE25_PROFILE_FIXTURE <<<
|
|
# # >>> DE25_PROFILE_SCENE >>> ... # <<< DE25_PROFILE_SCENE <<<
|
|
# Everything else in the QSF (EMIF macros GS_LPDDR4B_FB/GS_LPDDR_FB, pin/IP assignments)
|
|
# is profile-independent and untouched. After switching, re-fit in Quartus as usual.
|
|
#
|
|
# Usage:
|
|
# ./scripts/select_de25_profile.sh lpddr_tex # Ch322 LPDDR-backed texture demo (tritex)
|
|
# ./scripts/select_de25_profile.sh lpddr128_scanout # Ch321 128x128 LPDDR framebuffer scanout
|
|
# ./scripts/select_de25_profile.sh --list # list profiles + show the active one
|
|
#
|
|
# Add a profile by extending the case blocks below (fixture mems + scene VERILOG_MACROs).
|
|
|
|
set -u
|
|
QSF="${QSF:-synth/de25_nano/top_psmct32_raster_demo/de25_nano_psmct32_raster_demo_top.qsf}"
|
|
PROFILE="${1:-}"
|
|
MEMDIR="sim/data/top_psmct32_raster_demo"
|
|
|
|
[ -f "$QSF" ] || { echo "QSF not found: $QSF (run from repo root, or set QSF=)"; exit 2; }
|
|
|
|
mac() { printf 'set_global_assignment -name VERILOG_MACRO "%s"\n' "$1"; }
|
|
fix() { # $1=bios stem $2=payload stem
|
|
mac "TOP_PSMCT32_RASTER_DEMO_BIOS_IMAGE_FILE=\\\"$MEMDIR/$1.mem\\\""
|
|
mac "TOP_PSMCT32_RASTER_DEMO_PAYLOAD_IMAGE_FILE=\\\"$MEMDIR/$2.mem\\\""
|
|
}
|
|
|
|
case "$PROFILE" in
|
|
lpddr_tex)
|
|
FIXTURE="$(fix bios_tritex payload_tritex)"
|
|
SCENE="$(mac GS_LPDDR_TEX_DEMO=1)
|
|
$(mac GS_LPDDR_TEX=1)"
|
|
;;
|
|
lpddr128_scanout)
|
|
FIXTURE="$(fix bios_tile_lpddr128 payload_tile_lpddr128)"
|
|
SCENE="$(mac GS_TILE_LPDDR128_DEMO=1)"
|
|
;;
|
|
tile_spill)
|
|
# Ch324 — 4x4 MULTI-TILE COLOR+Z spill/reload two-batch depth proof (64x64 raster
|
|
# FB in LPDDR). GS_TILE_SPILL_DEMO selects the bram-top render config (PSMCT32,
|
|
# close_combined, TILE_LOCAL, TILE_COLS/ROWS=4); GS_TILE_SPILL enables the de25
|
|
# LPDDR spill writers + gs_tile_reload (per-tile reload base) + TILE_SPILL_ENABLE.
|
|
# Ch325 — scaled to 8x8 / 128x128 (bios_tile_spill8x8). Ch324 4x4 fixture retired here.
|
|
# Ch327b — scaled to 16x16 / 256x256 (bios_tile_spill16x16), line-buffer scanout.
|
|
FIXTURE="$(fix bios_tile_spill16x16 payload_tile_spill16x16)"
|
|
SCENE="$(mac GS_TILE_SPILL_DEMO=1)
|
|
$(mac GS_TILE_SPILL=1)"
|
|
;;
|
|
feeder)
|
|
# Ch330 — runtime command-list feeder. The setup-only bootlet uploads the texture
|
|
# (bios/payload_feeder_setup), the feeder draws list A, then the HPS streams list B
|
|
# into the staging RAM over the bridge (0x0D8/0x0DC/0x0E4) and retriggers (0x0E8) —
|
|
# the image changes with no RBF rebuild / reset. GS_FEEDER_DEMO selects the bram-top
|
|
# config (FEEDER_ENABLE=1, HEARTBEAT_SPLICE_ENABLE=0, 4x4 TILE_PRIM_COUNT=4).
|
|
FIXTURE="$(fix bios_feeder_setup payload_feeder_setup)"
|
|
# FEEDER_STG_INIT_FILE bitstream-inits the staging RAM with list A so the first
|
|
# auto-run draws a clean scene at power-up (sim never defines this; TBs $readmemh directly).
|
|
SCENE="$(mac GS_FEEDER_DEMO=1)
|
|
$(mac "FEEDER_STG_INIT_FILE=\\\"$MEMDIR/feeder_stg_cap4.mem\\\"")"
|
|
;;
|
|
feeder_persp)
|
|
# Ch342 — PERSPECTIVE-correct textured triangles through the feeder on the S1 path (tiling/
|
|
# combined OFF, PERSPECTIVE_CORRECT=1). The setup-only bootlet uploads a 16x16 checkerboard
|
|
# (bios/payload_persp_feeder_setup); FEEDER_STG_INIT renders the perspective checkerboard floor
|
|
# at boot (feeder_persp.mem, word0[32]=1 -> RGBAQ/ST/XYZ2). The HPS can then stream an authentic
|
|
# cube_persp scene over the bridge (ps2_feeder, ABE=0). Combined-TAZ perspective is a follow-on.
|
|
FIXTURE="$(fix bios_persp_feeder_setup payload_persp_feeder_setup)"
|
|
SCENE="$(mac GS_FEEDER_PERSP_DEMO=1)
|
|
$(mac "FEEDER_STG_INIT_FILE=\\\"$MEMDIR/feeder_persp.mem\\\"")"
|
|
;;
|
|
feeder_cube)
|
|
# Ch343 — the AUTHENTIC cube on silicon. Same GS_FEEDER_PERSP_DEMO bram-top config as
|
|
# feeder_persp (ABE=0 S1 perspective, .RAM_SIZE_BYTES=32 KiB), but the fixtures are the real
|
|
# cubes-dump content: the boot bootlet uploads the extracted 64x64 cube texture @ TBP=64
|
|
# (bios/payload_cube_setup, QWC=1030) and FEEDER_STG_INIT renders the 27 translated perspective
|
|
# triangles (feeder_cube_persp.mem). All three .mem are dump-derived/LOCAL (gitignored) — generate
|
|
# with `python3 tools/gs_make_cube_fixture.py`. Closes the GS dump -> extraction -> ST/Q -> pixels arc.
|
|
FIXTURE="$(fix bios_cube_setup payload_cube_setup)"
|
|
SCENE="$(mac GS_FEEDER_PERSP_DEMO=1)
|
|
$(mac "FEEDER_STG_INIT_FILE=\\\"$MEMDIR/feeder_cube_persp.mem\\\"")"
|
|
;;
|
|
texalpha)
|
|
# Ch344 — TEXTURED + source-over alpha SPRITE on silicon (boot payload, no feeder). SPRITE_TEX_ALPHA=1.
|
|
# bios/payload_texalpha upload an 8x8 alpha-checker texture + blue BG sprite + a textured-alpha overlay
|
|
# sprite. On HDMI: a gray/blue checkerboard (opaque texels gray, transparent texels reveal the BG).
|
|
FIXTURE="$(fix bios_texalpha payload_texalpha)"
|
|
SCENE="$(mac GS_TEXALPHA_DEMO=1)"
|
|
;;
|
|
feeder_sprite)
|
|
# Ch345a — RUNTIME FEEDER textured-alpha SPRITEs (sprite_mode staging). SPRITE_TEX_ALPHA=1 + FEEDER_ENABLE=1.
|
|
# bios/payload_sprite_setup uploads an 8x8 alpha texture + blue BG; FEEDER_STG_INIT=feeder_sprite streams
|
|
# 3 textured-alpha sprites over it. On HDMI: 3 gray/blue alpha-checker squares on blue (runtime ingestion).
|
|
FIXTURE="$(fix bios_sprite_setup payload_sprite_setup)"
|
|
SCENE="$(mac GS_FEEDER_SPRITE_DEMO=1)
|
|
$(mac "FEEDER_STG_INIT_FILE=\\\"$MEMDIR/feeder_sprite.mem\\\"")"
|
|
;;
|
|
sh3_clut)
|
|
# Ch347 — AUTHENTIC Silent Hill 3 64x64-crop PSMT8 texture + real CLUT, DECAL on silicon. The bootlet
|
|
# (bios/payload_sh3_clut) BITBLT-uploads the 256-entry CLUT + 64x64 PSMT8 indices, fires the VRAM->CLUT
|
|
# load (TEX0 CLD=1, CSM2-linear), draws a 64x64 DECAL sprite. HEARTBEAT_SPLICE off (set in the profile).
|
|
# Fixtures are SH3-derived -> LOCAL/gitignored: run `python3 tools/gs_extract_sh3_clut.py` then
|
|
# `python3 tools/gs_make_sh3_fixture.py` with the local SH3 dump BEFORE fitting.
|
|
FIXTURE="$(fix bios_sh3_clut payload_sh3_clut)"
|
|
SCENE="$(mac GS_SH3_CLUT_DEMO=1)"
|
|
;;
|
|
sh3_persp)
|
|
# Ch348 — AUTHENTIC SH3 PSMT8 texture + real CLUT through the PERSPECTIVE-triangle FEEDER path. The
|
|
# setup bootlet (bios/payload_sh3_persp) uploads the 64x64 PSMT8 texture + 256-entry CLUT; the feeder
|
|
# staging (feeder_sh3_persp) draws a perspective quad with TEX0(PSMT8,CLD=1) -> the feeder commit fires
|
|
# the VRAM->CLUT load. Fixtures are SH3-derived -> LOCAL/gitignored: run `python3 tools/gs_extract_sh3_clut.py`
|
|
# then `python3 tools/gs_make_sh3_persp_fixture.py` with the local SH3 dump BEFORE fitting.
|
|
FIXTURE="$(fix bios_sh3_persp payload_sh3_persp)"
|
|
SCENE="$(mac GS_SH3_PERSP_DEMO=1)
|
|
$(mac "FEEDER_STG_INIT_FILE=\\\"$MEMDIR/feeder_sh3_persp.mem\\\"")"
|
|
;;
|
|
sh3_real_draw)
|
|
# Ch350/351/352 — the ACTUAL Ch349 SH3 draw CROP on silicon (Codex board gate). Real draw geometry
|
|
# (idx89761 lamppost/bench, host-clipped to a 256x120 viewport) + the reconstructed 512x512 PSMT8 texture
|
|
# in LPDDR (GS_LPDDR_TEX cache @ 0x200000) + the real CSM1 CLUT (bootlet 256x1 BITBLT to CBP, grid bytes
|
|
# verbatim) + Ch351 widened perspective precision (PERSP_RECIP_IDX_BITS=11). 128 KiB crop VRAM (under the
|
|
# read2 tripwire). Golden oracle: tb_top_psmct32_sh3_real_draw_demo (ALL 96.2% <=1 texel, clut_bad=0).
|
|
# BOARD ORDER: (1) fit this profile, (2) HPS write-probe uploads sh3_real_tex_lpddr.mem to LPDDR @0x200000
|
|
# + checksum-verify via the read-probe, (3) feeder auto-runs the bitstream-init scene, (4) verify HDMI vs
|
|
# the crop reference (captures/.../recon/sh3_real_ref.png). Fixtures SH3-derived -> LOCAL/gitignored:
|
|
# run `python3 tools/gs_make_sh3_real_draw_fixture.py` FIRST.
|
|
FIXTURE="$(fix bios_sh3_real payload_sh3_real)"
|
|
SCENE="$(mac GS_SH3_REAL_DRAW_DEMO=1)
|
|
$(mac GS_LPDDR_TEX=1)
|
|
$(mac "FEEDER_STG_INIT_FILE=\\\"$MEMDIR/feeder_sh3_real.mem\\\"")"
|
|
;;
|
|
sh3_lpddr_fb)
|
|
# Ch353 — the SH3 real draw on an LPDDR-ONLY direct PSMCT32 framebuffer (the FULL 256x334 bounding box, NOT
|
|
# the Ch352 256x120 BRAM crop). Same feeder-driven SH3 config as sh3_real_draw (LPDDR texture cache @0x200000
|
|
# + real CSM1 CLUT + Ch351 widened perspective), but the bram-top runs with FB_LPDDR_ONLY (the PSMCT32 writer
|
|
# commits the frame to LPDDR @ base 0 instead of the BRAM mirror) and FEEDER_AUTOSTART=0 (no boot render). The
|
|
# line-buffer scanout serves the LPDDR FB, HARD-gated on the ordered frame_drained ack (no timeout). VRAM stays
|
|
# 128 KiB / CBP=480 (Codex option A). The static QSF EMIF/GS_LPDDR4B_FB/USE_QSYS_TOP already provide the EMIF +
|
|
# writer + line-buffer scanout. Proven end-to-end by tb_top_psmct32_sh3_lpddr_fb_seq (the mandatory fit gate).
|
|
# BOARD ORDER (Codex host sequence): (1) wait setup/CLUT + feeder ready (0x0D8[0]); (2) HPS PRECLEAR the LPDDR
|
|
# FB 0x000000..0x0537FF via the write-probe; (3) upload the 512x512 PSMT8 texture to LPDDR @0x200000; (4) fill +
|
|
# checksum-verify the texture cache (0x054/0x070=fbdeaa32); (5) set FB base 0 (0x01C=0), canary off, ARM the
|
|
# writer (0x018[0]); (6) pulse feeder GO (0x0E8); (7) confirm drain (poll LPDDR_STATUS 0x02C[0] idle + LPDDR_BYTES
|
|
# 0x030 != 0); (8) scanout auto-enables from frame_drained — raise video_src (0x018[2]=1); scanout_lb is forced.
|
|
# Fixtures SH3-derived -> LOCAL/gitignored: run `python3 tools/gs_make_sh3_real_draw_fixture.py --full-frame` FIRST.
|
|
FIXTURE="$(fix bios_sh3_full payload_sh3_full)"
|
|
SCENE="$(mac GS_SH3_LPDDR_FB=1)
|
|
$(mac GS_LPDDR_TEX=1)
|
|
$(mac "FEEDER_STG_INIT_FILE=\\\"$MEMDIR/feeder_sh3_full.mem\\\"")"
|
|
;;
|
|
sh3_lpddr_fb_multi)
|
|
# Ch354 Brick 1 — MULTI-DRAW: 3 authentic SH3 draws (idx89548/89761/89974) that SHARE one texture/CLUT,
|
|
# composited into ONE LPDDR PSMCT32 framebuffer (256x338, the union bbox). Same LPDDR-FB path as sh3_lpddr_fb
|
|
# (FEEDER_AUTOSTART=0 + render-epoch EOF + frame_drained hard gate + line-buffer scanout) but GS_SH3_LPDDR_FB_MULTI
|
|
# raises FEEDER_STG_WORDS 768->2048 (204-tri combined list) and SCANOUT_LB_NROWS 334->338. Accumulation is
|
|
# bit-exact (combined RTL == RTL-composed singles, 0/86528 px); per-draw <=1-texel fidelity is draw-dependent
|
|
# (97.5/95.6/93.2%, the existing perspective-sampling limit, NOT an acceptance gate). Proven by
|
|
# tb_top_psmct32_sh3_multidraw. GS_SH3_LPDDR_FB + GS_LPDDR4B_FB + GS_LPDDR_TEX all apply (the profile sets them).
|
|
# BOARD ORDER: identical to sh3_lpddr_fb, but preclear the LARGER FB range:
|
|
# sudo ./ps2_sh3_tex_upload sh3_real_tex_lpddr.mem --lpddr-fb --fb-rows 338 (preclears 0..0x54800).
|
|
# Fixtures SH3-derived -> LOCAL/gitignored: run `python3 tools/gs_make_sh3_multidraw_fixture.py <dump>
|
|
# --draw-list 89548,89761,89974 --tag multi --emit` FIRST.
|
|
FIXTURE="$(fix bios_sh3_multi payload_sh3_multi)"
|
|
SCENE="$(mac GS_SH3_LPDDR_FB=1)
|
|
$(mac GS_SH3_LPDDR_FB_MULTI=1)
|
|
$(mac GS_LPDDR_TEX=1)
|
|
$(mac "FEEDER_STG_INIT_FILE=\\\"$MEMDIR/feeder_sh3_multi.mem\\\"")"
|
|
;;
|
|
sh3_lpddr_fb_multitex)
|
|
# Ch355 Brick 1 — MULTI-TEXTURE: 2 SH3 draws with DIFFERENT textures/CLUTs (A=idx19562 tbp=11264/CBP_A,
|
|
# B=idx89761 tbp=9216/CBP_B) composited into ONE 320x381 LPDDR FB (FBW=5, stride 1280, 0x77100, 15240 beats/frame)
|
|
# via SCENE-LEVEL texture rebind + RUNTIME staged-list retriggering. GS_SH3_LPDDR_FB_MULTITEX raises
|
|
# FEEDER_STG_WORDS->2048 + SCANOUT_LB to 320x381. The bootlet (bios/payload_sh3_mt) uploads BOTH relocated CLUTs
|
|
# (CBP_A=480, CBP_B=484); the HOST streams each list at runtime (NO FEEDER_STG_INIT_FILE — feeder starts empty).
|
|
# Accumulation bit-exact + Q-canonicalized (feeder canonicalizes homogeneous coords to positive Q; NOT native
|
|
# signed-Q). Proven by tb_top_psmct32_sh3_multitex.
|
|
# BOARD RUN (runtime two-group flow, host streams the lists + rebinds the cache):
|
|
# sudo ./ps2_sh3_multitex sh3_mtA_tex_lpddr.mem sh3_mtB_tex_lpddr.mem feeder_sh3_mtA.mem feeder_sh3_mtB.mem
|
|
# Fixtures SH3-derived -> LOCAL/gitignored: run `python3 tools/gs_make_sh3_multitex_fixture.py <dump> --emit` FIRST.
|
|
FIXTURE="$(fix bios_sh3_mt payload_sh3_mt)"
|
|
SCENE="$(mac GS_SH3_LPDDR_FB=1)
|
|
$(mac GS_SH3_LPDDR_FB_MULTITEX=1)
|
|
$(mac GS_LPDDR_TEX=1)"
|
|
;;
|
|
sh3_lpddr_fb_sched)
|
|
# Ch356 — N-TEXTURE SCHEDULER: N (default 3) authentic SH3 draws with DIFFERENT textures/CLUTs
|
|
# (E0=idx11671 tbp=10240/CBP480, E1=idx19562 tbp=11264/CBP484, E2=idx89761 tbp=9216/CBP488) composited into ONE
|
|
# 384x381 LPDDR FB (FBW=6, stride 1536, 0x8ee00, 18288 beats/frame) via a DATA-DRIVEN scheduler over epoch
|
|
# descriptors (scene-level texture rebind + runtime staged-list retriggering). GS_SH3_LPDDR_FB_SCHED raises
|
|
# FEEDER_STG_WORDS->2048 + SCANOUT_LB to 384x381. The bootlet (bios/payload_sh3_sched) preloads ALL N relocated
|
|
# CLUTs; the HOST streams each list at runtime (NO FEEDER_STG_INIT_FILE). Accumulation proven 100% BIT-FOR-BIT
|
|
# (compose_sched.py) + Q-canonicalized; tb_top_psmct32_sh3_sched (+ _compose gate).
|
|
# BOARD RUN (data-driven; host reads the descriptor table + streams each list, rebinds the cache per epoch):
|
|
# sudo ./ps2_sh3_sched sh3_sched_epochs.txt (all fixtures in the cwd)
|
|
# Fixtures SH3-derived -> LOCAL/gitignored: run `python3 tools/gs_make_sh3_scheduler_fixture.py <dump> --emit` FIRST.
|
|
FIXTURE="$(fix bios_sh3_sched payload_sh3_sched)"
|
|
SCENE="$(mac GS_SH3_LPDDR_FB=1)
|
|
$(mac GS_SH3_LPDDR_FB_SCHED=1)
|
|
$(mac GS_LPDDR_TEX=1)"
|
|
;;
|
|
sh3_lpddr_fb_640)
|
|
# Ch357 — NATIVE 640x480 LPDDR framebuffer: the Ch356 N-texture scheduler on a full-frame 640x480 FB
|
|
# (FBW=10, stride 2560, size 0x12C000, 80 beats/row, 38400 beats/frame). Draws land at their AUTHENTIC screen
|
|
# coordinates (NO union-origin translation). Scheduler/host UNCHANGED from Ch356; only the FB geometry differs.
|
|
# GS_SH3_LPDDR_FB_640 sets SCANOUT_LB 640x480 + FEEDER_STG_WORDS=2048. Bootlet (bios/payload_sh3_s640) preloads
|
|
# all N relocated CLUTs; the HOST streams each list at runtime (NO FEEDER_STG_INIT_FILE). FB[0..0x12C000) disjoint
|
|
# from texture region [0x200000..). Composition proven 100% BIT-FOR-BIT (compose_sched.py); tb_top_psmct32_sh3_sched640.
|
|
# BOARD RUN (same data-driven host, different descriptor table):
|
|
# sudo ./ps2_sh3_sched sh3_s640_epochs.txt
|
|
# Fixtures SH3-derived -> LOCAL/gitignored: run `python3 tools/gs_make_sh3_scheduler_fixture.py <dump> --fb640 --emit` FIRST.
|
|
FIXTURE="$(fix bios_sh3_s640 payload_sh3_s640)"
|
|
SCENE="$(mac GS_SH3_LPDDR_FB=1)
|
|
$(mac GS_SH3_LPDDR_FB_640=1)
|
|
$(mac GS_LPDDR_TEX=1)"
|
|
;;
|
|
sh3_lpddr_fb_z)
|
|
# Ch357 — PERSISTENT AUTHENTIC Z: the N-texture scheduler with a REAL per-fragment PSMZ16S depth test on an
|
|
# LPDDR-persistent Z buffer. The plain color writer is replaced by gs_lpddr_zc_emit: per fragment it clamp16-reads
|
|
# /GEQUAL-compares/updates a packed-16b Z line in LPDDR (Z base 0x140000) and emits color ONLY on Z-pass. Z PERSISTS
|
|
# across the 3 scheduler epochs (precleared exactly once by clear_start at ARM; texture rebind does NOT clear it).
|
|
# The three AXI streams share the LPDDR through the existing arbiters (color->wr_arb s0, Z-write->wr_arb s2,
|
|
# Z-read->rd_arb s3). Strong-reject acceptance fixture (256x210, 18.31% reject: far-late fragments MUST be depth-
|
|
# rejected). GS_SH3_LPDDR_FB_Z sets SCANOUT_LB 256x210 (6720 beats/frame). Bootlet (bios/payload_sh3_zsched) preloads
|
|
# all 3 relocated CLUTs; the HOST streams each list at runtime (NO FEEDER_STG_INIT_FILE). ROP + arbitration + REAL-
|
|
# RASTER integration all sim-proven: tb_top_psmct32_sh3_zrop (ROP golden), tb_top_psmct32_sh3_zarb (arbitration),
|
|
# tb_top_psmct32_sh3_zint (real raster, ZERO fragment drops, Z+color bit-exact vs the clamp16 scoreboard).
|
|
# BOARD ORDER (Codex host sequence): (1) wait setup/CLUT + feeder ready; (2) HPS PRECLEAR color 0x000000..0x0347FF
|
|
# AND Z 0x140000..0x15A3FF via the write-probe; (3) per epoch upload the 512x512 PSMT8 texture @0x200000 + fill/verify
|
|
# the cache; (4) ARM the writer (0x018[0]) -> clear_start preclears the Z buffer; WAIT clear_done before the first GO;
|
|
# (5) per epoch stream the list + pulse GO (0x0E8) + confirm a FRESH frame_drained; Z persists across epochs; (6) after
|
|
# the LAST drain raise video_src (0x018[2]=1) — scanout_lb (256x210) is forced. Read zc_g_drops (must be 0).
|
|
# Fixtures SH3-derived -> LOCAL/gitignored: run `python3 tools/gs_make_sh3_scheduler_fixture.py <dump> --authz
|
|
# --tag zsched --emit` FIRST (strong-reject draw list, authentic per-vertex Z).
|
|
FIXTURE="$(fix bios_sh3_zsched payload_sh3_zsched)"
|
|
SCENE="$(mac GS_SH3_LPDDR_FB=1)
|
|
$(mac GS_SH3_LPDDR_FB_Z=1)
|
|
$(mac GS_LPDDR_TEX=1)"
|
|
;;
|
|
sh3_lpddr_fb_z640)
|
|
# Ch358 — PERSISTENT AUTHENTIC Z at NATIVE 640x480: the SAME strong-reject persistent-Z scene as sh3_lpddr_fb_z
|
|
# (draws 8634/12757/145742, gs_lpddr_zc_emit, clamp16/GEQUAL, Z persists across epochs) but on the full-frame
|
|
# native FB at AUTHENTIC screen coordinates (FBW=10, stride 2560, size 0x12C000, 38400 beats/frame; draws land at
|
|
# x[407..619] y[97..306]). GS_SH3_LPDDR_FB_Z + GS_SH3_LPDDR_FB_640 together select SCANOUT_LB 640x480 AND
|
|
# ZFB_PXW/H=640x480 (Z clear = 19200 beats). Map (gs_lpddr_map_pkg, disjoint by construction): color 0x0..0x12C000,
|
|
# Z 0x140000..0x1D6000, tex 0x200000. Bootlet (bios/payload_sh3_zs640) preloads all 3 relocated CLUTs; the HOST
|
|
# streams each list at runtime (NO FEEDER_STG_INIT_FILE). Sim gates: tb_top_psmct32_sh3_zs640_cap (capture +
|
|
# fidelity oracle) and tb_top_psmct32_sh3_zint640 (real raster -> zc_emit -> REAL arbiters -> shared LPDDR,
|
|
# ZERO drops, Z+color scoreboard-exact). Board proof = make -C sim sh3_zs640_board_compare (byte-for-byte vs
|
|
# zint640 + replay-color 100%).
|
|
# BOARD RUN (host unchanged — geometry comes from the epochs META):
|
|
# sudo ./ps2_sh3_sched --zbuf sh3_zs640_epochs.txt --dump-fb sh3_zs640_board_fb.mem
|
|
# Fixtures SH3-derived -> LOCAL/gitignored: run `make -C sim sh3_zs640_fixture` FIRST.
|
|
FIXTURE="$(fix bios_sh3_zs640 payload_sh3_zs640)"
|
|
SCENE="$(mac GS_SH3_LPDDR_FB=1)
|
|
$(mac GS_SH3_LPDDR_FB_Z=1)
|
|
$(mac GS_SH3_LPDDR_FB_640=1)
|
|
$(mac GS_LPDDR_TEX=1)"
|
|
;;
|
|
sh3_lpddr_fb_z640c6)
|
|
# Ch359 — shared-texture residency scene: six authentic SH3 draws grouped into two
|
|
# 204-triangle epochs at native 640x480 persistent Z. The bootlet preloads the C6
|
|
# relocated CLUT at CBP=13888; the host uploads/fills the shared texture once, then
|
|
# verifies it remains resident for the reuse epoch.
|
|
FIXTURE="$(fix bios_sh3_zs640c6 payload_sh3_zs640c6)"
|
|
SCENE="$(mac GS_SH3_LPDDR_FB=1)
|
|
$(mac GS_SH3_LPDDR_FB_Z=1)
|
|
$(mac GS_SH3_LPDDR_FB_640=1)
|
|
$(mac GS_LPDDR_TEX=1)"
|
|
;;
|
|
sh3_lpddr_fb_z640_runtime_clut)
|
|
# Ch367 -- runtime palette residency proof. Same native 640x480
|
|
# persistent-Z geometry as Ch358. Keep the proven nonempty C6 setup
|
|
# bootlet as a synthesis-retention anchor; the runtime test lists use
|
|
# TEX0.CLD=0 and the HPS stages/checks every palette before each GO.
|
|
# A zero-transfer bootlet lets Quartus prune the otherwise runtime-fed
|
|
# texture/raster RAMs, so it is not a valid hardware proof vehicle.
|
|
FIXTURE="$(fix bios_sh3_zs640c6 payload_sh3_zs640c6)"
|
|
SCENE="$(mac GS_SH3_LPDDR_FB=1)
|
|
$(mac GS_SH3_LPDDR_FB_Z=1)
|
|
$(mac GS_SH3_LPDDR_FB_640=1)
|
|
$(mac GS_LPDDR_TEX=1)"
|
|
;;
|
|
--list|"")
|
|
echo "Profiles: lpddr_tex (Ch322 texture) lpddr128_scanout (Ch321 scanout) tile_spill (Ch323 spill/reload) feeder (Ch330 command-list) feeder_persp (Ch342 perspective) feeder_cube (Ch343 authentic cube) texalpha (Ch344 textured-alpha sprite) feeder_sprite (Ch345a runtime sprite) sh3_clut (Ch347 authentic SH3 PSMT8+CLUT) sh3_persp (Ch348 SH3 PSMT8+CLUT perspective) sh3_real_draw (Ch350/351/352 SH3 real-draw crop, LPDDR tex + CSM1 + widened persp) sh3_lpddr_fb (Ch353 SH3 full 256x334 on an LPDDR-only PSMCT32 FB + line-buffer scanout, frame_drained-gated) sh3_lpddr_fb_multi (Ch354 3 SH3 draws -> 256x338) sh3_lpddr_fb_multitex (Ch355 2 DIFFERENT-texture draws -> 320x381, runtime-staged) sh3_lpddr_fb_sched (Ch356 N-texture data-driven scheduler -> 384x381) sh3_lpddr_fb_640 (Ch357 native 640x480 full-frame) sh3_lpddr_fb_z (Ch357 PERSISTENT PSMZ16S Z, 256x210 strong-reject) sh3_lpddr_fb_z640 (Ch358 PERSISTENT Z at NATIVE 640x480) sh3_lpddr_fb_z640c6 (Ch359 shared-texture residency) sh3_lpddr_fb_z640_runtime_clut (Ch367 runtime palette residency)"
|
|
echo "Active profile:"
|
|
sed -n '/DE25_PROFILE_SCENE/,/DE25_PROFILE_SCENE/p' "$QSF" | grep VERILOG_MACRO || echo " (no scene macros)"
|
|
sed -n '/DE25_PROFILE_FIXTURE/,/DE25_PROFILE_FIXTURE/p' "$QSF" | grep IMAGE_FILE
|
|
[ -z "$PROFILE" ] && exit 2 || exit 0
|
|
;;
|
|
*) echo "unknown profile: $PROFILE (try --list)"; exit 2 ;;
|
|
esac
|
|
|
|
# Replace the content between each marker pair. Read the replacement from a file
|
|
# rather than `awk -v`: awk consumes backslash-escaped quotes in Verilog macros.
|
|
swap_block() { # $1=tag $2=replacement-file (reads stdin QSF, writes stdout)
|
|
awk -v tag="$1" -v repl_file="$2" '
|
|
$0 ~ (">>> " tag " ") {
|
|
print
|
|
while ((getline line < repl_file) > 0) print line
|
|
close(repl_file)
|
|
inblk=1
|
|
next
|
|
}
|
|
$0 ~ ("<<< " tag " <<<") { inblk=0 }
|
|
!inblk { print }
|
|
'
|
|
}
|
|
|
|
fixture_tmp="$(mktemp)"
|
|
scene_tmp="$(mktemp)"
|
|
tmp="$(mktemp)"
|
|
trap 'rm -f "$fixture_tmp" "$scene_tmp" "$tmp"' EXIT HUP INT TERM
|
|
printf '%s\n' "$FIXTURE" > "$fixture_tmp"
|
|
printf '%s\n' "$SCENE" > "$scene_tmp"
|
|
swap_block DE25_PROFILE_FIXTURE "$fixture_tmp" < "$QSF" \
|
|
| swap_block DE25_PROFILE_SCENE "$scene_tmp" > "$tmp"
|
|
|
|
# sanity: both marker pairs must still be present (don't clobber the QSF on a bad run)
|
|
for tag in DE25_PROFILE_FIXTURE DE25_PROFILE_SCENE; do
|
|
[ "$(grep -c "$tag" "$tmp")" -eq 2 ] || { echo "ERROR: marker '$tag' missing after edit — QSF unchanged"; rm -f "$tmp"; exit 1; }
|
|
done
|
|
mv "$tmp" "$QSF"
|
|
trap - EXIT HUP INT TERM
|
|
rm -f "$fixture_tmp" "$scene_tmp"
|
|
echo "Selected profile: $PROFILE"
|
|
echo " fixture: $(echo "$FIXTURE" | grep -o '[a-z0-9_]*\.mem' | tr '\n' ' ')"
|
|
echo " scene : $(echo "$SCENE" | grep -o 'GS_[A-Z0-9_]*=1' | tr '\n' ' ')"
|
|
echo "Now re-fit in Quartus."
|