Golden-model conformance suite (C1-C4 CONFORMANT) + GPU-compute retarget plan
igc_conformance.py pins the reference behaviour any port (RTL/GPU/C) must reproduce: the DUMP packet parse, a synthetic raster, the bars pipeline (texu==x+2 from the real cap7 tile programs), and the fxtest effect primitives (coverage + z pinned) -- fixtures committed under conformance/. GPU-RETARGET.md maps the DOSBox-renderer path: EMC tile as compute shader (pixel=thread), 4 milestones, conformance-gated. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Claude Opus 4.8
@@ -0,0 +1,136 @@
|
||||
"""igc_conformance.py -- the golden-model conformance suite.
|
||||
|
||||
Any port of the IGC/EMC model (RTL, GPU compute, C) must reproduce these
|
||||
outputs bit-for-bit (where pinned) from the committed fixtures in
|
||||
conformance/. The fixtures are REAL captured data from the firmware running
|
||||
on emu860 (see IGC-ENCODING-DERIVATION.md for provenance).
|
||||
|
||||
Cases:
|
||||
C1 DUMP reference packet parses to the exact named instruction sequence.
|
||||
C2 Synthetic triangle rasterizes to the exact lit-pixel count.
|
||||
C3 Bars pipeline: the cap7 bench per-tile programs (sends_cap7.pkl), with
|
||||
the documented texz seed, compute texu == global x (+2) per pixel.
|
||||
C4 fxtest effect primitives (fx_program.pkl) rasterize: 9 primitives drawn,
|
||||
pinned z-buffer coverage + centroid.
|
||||
Run: python igc_conformance.py (exit 0 = conformant)
|
||||
"""
|
||||
import os, sys, pickle, struct
|
||||
|
||||
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
||||
import igc_exec
|
||||
|
||||
HERE = os.path.dirname(os.path.abspath(__file__))
|
||||
FIX = os.path.join(HERE, 'conformance')
|
||||
|
||||
|
||||
def f32(w):
|
||||
return struct.unpack('<f', struct.pack('<I', w & 0xffffffff))[0]
|
||||
|
||||
|
||||
def c1_dump_reference():
|
||||
ref = [0x100,
|
||||
0x3ae94200, 0xc1900000, 0x41200000, 0xc4840000,
|
||||
0x3ae94200, 0xc1400000, 0x41200000, 0xc34c0000,
|
||||
0x3ae94200, 0x41f00000, 0xc1a00000, 0x44a50000,
|
||||
0x44ea2120, 0x80000000, 0x80000000, 0x3f7fffff,
|
||||
0x438a4320,
|
||||
0x3daa4352, 0x3e849bae, 0xbdd70a3b, 0xc1976c7f,
|
||||
0x3daa435a, 0xbea24ddd, 0x3d4ccccc, 0x421a3788,
|
||||
0x41aa4362, 0x80000000, 0x80000000, 0x3f7fffff]
|
||||
ins, unk = igc_exec.parse(ref)
|
||||
names = [x[0] for x in ins]
|
||||
assert names == ['SETENABS', 'TREEltZERO_L3', 'TREEltZERO_L3', 'TREEltZERO_L3',
|
||||
'MEMltTREE_L3', 'TREEintoMEM_L0', 'TREEintoMEM_L3',
|
||||
'TREEintoMEM_L3', 'TREEintoMEM_L3'], names
|
||||
assert not unk
|
||||
return 'C1 dump-reference parse: PASS (%d instrs)' % len(ins)
|
||||
|
||||
|
||||
def c2_synthetic_triangle():
|
||||
tri = [('SETENABS',),
|
||||
('TREEgeZERO_L3', 0, 2, 1.0, 0.0, -8.0),
|
||||
('TREEgeZERO_L3', 0, 2, -1.0, 0.0, 40.0),
|
||||
('TREEgeZERO_L3', 0, 2, 0.0, 1.0, -20.0)]
|
||||
t = igc_exec.Tile()
|
||||
t.run(tri)
|
||||
lit = sum(t.enab)
|
||||
assert lit == 3564, lit
|
||||
return 'C2 synthetic triangle: PASS (%d enabled)' % lit
|
||||
|
||||
|
||||
def c3_bars_pipeline():
|
||||
d = pickle.load(open(os.path.join(FIX, 'sends_cap7.pkl'), 'rb'))
|
||||
pls = {(a, sz): list(w) for h, (a, sz, w) in d['payloads'].items()}
|
||||
order = [(0x8015000, 4), (0x8015020, 69), (0x8015260, 33), (0x8015380, 41)]
|
||||
t = igc_exec.Tile(ox=256, oy=0)
|
||||
for y in range(igc_exec.TILE_H):
|
||||
for x in range(igc_exec.TILE_W):
|
||||
t._wr(t.mem[x + y * igc_exec.TILE_W], 32, 20, (x + 256) & 0xfffff)
|
||||
for key in order:
|
||||
ins, unk = igc_exec.parse(pls[key])
|
||||
t.run(ins)
|
||||
# texu must equal global x + 2 (the sweep's constant offset) at sampled cols
|
||||
for x in (0, 16, 32, 48):
|
||||
u = t._rd(t.mem[x], 57, 20)
|
||||
assert u == 256 + x + 2, (x, u)
|
||||
return 'C3 bars pipeline: PASS (texu == x+2 across the tile)'
|
||||
|
||||
|
||||
def c4_fxtest_primitives():
|
||||
d = pickle.load(open(os.path.join(FIX, 'fx_program.pkl'), 'rb'))
|
||||
prog = d['prog']
|
||||
def rd(a): return prog.get(a, 0)
|
||||
setups = [a for a in sorted(prog)
|
||||
if rd(a) == 0x100 and ((rd(a + 4) >> 8) & 0xff) == 0x2c]
|
||||
assert len(setups) == 10, len(setups)
|
||||
# rasterize coarsely on a 104x64 grid (1/8 scale) and pin coverage
|
||||
W, H = 104, 64
|
||||
drawn = 0
|
||||
covered = 0
|
||||
zwins = 0
|
||||
zbuf = [[-1e30] * W for _ in range(H)]
|
||||
for a in setups:
|
||||
edges = []
|
||||
p = a + 4
|
||||
while ((rd(p) >> 8) & 0xff) == 0x2c and len(edges) < 6:
|
||||
edges.append((f32(rd(p+4)), f32(rd(p+8)), f32(rd(p+12))))
|
||||
p += 16
|
||||
zp = None
|
||||
q = p
|
||||
for _ in range(40):
|
||||
w = rd(q)
|
||||
if ((w >> 8) & 0xff) == 0x21:
|
||||
zp = (f32(rd(q+4)), f32(rd(q+8)), f32(rd(q+12)))
|
||||
break
|
||||
q += 4
|
||||
if zp is None:
|
||||
continue
|
||||
any_px = False
|
||||
for gy in range(H):
|
||||
for gx in range(W):
|
||||
x, y = gx * 8, gy * 8
|
||||
vs = [A * x + B * y + C for A, B, C in edges]
|
||||
inside = all(v >= 0 for v in vs) or all(v < 0 for v in vs)
|
||||
if not inside:
|
||||
continue
|
||||
any_px = True
|
||||
covered += 1
|
||||
z = zp[0] * x + zp[1] * y + zp[2]
|
||||
if z > zbuf[gy][gx]:
|
||||
zbuf[gy][gx] = z
|
||||
zwins += 1
|
||||
if any_px:
|
||||
drawn += 1
|
||||
assert drawn == 10, drawn
|
||||
assert covered == 5706, covered
|
||||
assert zwins == 5119, zwins
|
||||
return 'C4 fxtest primitives: PASS (10 drawn, coverage %d, zwins %d)' % (covered, zwins)
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
results = []
|
||||
for case in (c1_dump_reference, c2_synthetic_triangle, c3_bars_pipeline,
|
||||
c4_fxtest_primitives):
|
||||
results.append(case())
|
||||
print('\n'.join(results))
|
||||
print('CONFORMANT')
|
||||
Reference in New Issue
Block a user