Initial commit: retroDE_ps2 — first-of-its-kind PS2 GS FPGA core (DE25-Nano / Agilex 5)

RTL (GS rasterizer, EE core stub, platform bridge, LPDDR4B path), sim regression
(272 TBs), docs, and tooling. Copyrighted PS2 content (BIOS, game code, GS dumps,
and all dump-derived textures/traces) is excluded via .gitignore and stays local.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

sim/data/top_psmct32_raster_demo/payload_swz32.mem

@@ -0,0 +1,259 @@
+// Ch300 SWIZZLED PSMCT32 demo GIF payload (236 qwords active at byte 0x100, padded to 256); BITBLT 16x48 SWIZZLED PSMCT32 texture + TEX0 + 16x48 sprite
+// Loaded via $readmemh into ee_ram_stub.mem (128-bit qword).
+// qw 0..15: zero; qw 16..N: SPRITE PACKED packets.
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+000000000000eeee4000000000000001
+00000000000000500001003000000000
+00000000000000510000000000000000
+00000000000000520000002800000016
+00000000000000530000000000000000
+000000000000000008000000000000dc
+ff0c0030ff080020ff040010ff000000
+ff1c0070ff180060ff140050ff100040
+ff2c00b0ff2800a0ff240090ff200080
+ff3c00f0ff3800e0ff3400d0ff3000c0
+ff4c0030ff480020ff440010ff400000
+ff080510ff040500ff540050ff500040
+ff180550ff140540ff100530ff0c0520
+ff280590ff240580ff200570ff1c0560
+ff3805d0ff3405c0ff3005b0ff2c05a0
+ff480510ff440500ff4005f0ff3c05e0
+ff580550ff540540ff500530ff4c0520
+ff140a30ff100a20ff0c0a10ff080a00
+ff240a70ff200a60ff1c0a50ff180a40
+ff340ab0ff300aa0ff2c0a90ff280a80
+ff440af0ff400ae0ff3c0ad0ff380ac0
+ff540a30ff500a20ff4c0a10ff480a00
+ff100f10ff0c0f00ff5c0a50ff580a40
+ff200f50ff1c0f40ff180f30ff140f20
+ff300f90ff2c0f80ff280f70ff240f60
+ff400fd0ff3c0fc0ff380fb0ff340fa0
+ff500f10ff4c0f00ff480ff0ff440fe0
+ff600f50ff5c0f40ff580f30ff540f20
+ff1c1430ff181420ff141410ff101400
+ff2c1470ff281460ff241450ff201440
+ff3c14b0ff3814a0ff341490ff301480
+ff4c14f0ff4814e0ff4414d0ff4014c0
+ff5c1430ff581420ff541410ff501400
+ff181910ff141900ff641450ff601440
+ff281950ff241940ff201930ff1c1920
+ff381990ff341980ff301970ff2c1960
+ff4819d0ff4419c0ff4019b0ff3c19a0
+ff581910ff541900ff5019f0ff4c19e0
+ff681950ff641940ff601930ff5c1920
+ff241e30ff201e20ff1c1e10ff181e00
+ff341e70ff301e60ff2c1e50ff281e40
+ff441eb0ff401ea0ff3c1e90ff381e80
+ff541ef0ff501ee0ff4c1ed0ff481ec0
+ff641e30ff601e20ff5c1e10ff581e00
+ff202310ff1c2300ff6c1e50ff681e40
+ff302350ff2c2340ff282330ff242320
+ff402390ff3c2380ff382370ff342360
+ff5023d0ff4c23c0ff4823b0ff4423a0
+ff602310ff5c2300ff5823f0ff5423e0
+ff702350ff6c2340ff682330ff642320
+ff2c2830ff282820ff242810ff202800
+ff3c2870ff382860ff342850ff302840
+ff4c28b0ff4828a0ff442890ff402880
+ff5c28f0ff5828e0ff5428d0ff5028c0
+ff6c2830ff682820ff642810ff602800
+ff282d10ff242d00ff742850ff702840
+ff382d50ff342d40ff302d30ff2c2d20
+ff482d90ff442d80ff402d70ff3c2d60
+ff582dd0ff542dc0ff502db0ff4c2da0
+ff682d10ff642d00ff602df0ff5c2de0
+ff782d50ff742d40ff702d30ff6c2d20
+ff343230ff303220ff2c3210ff283200
+ff443270ff403260ff3c3250ff383240
+ff5432b0ff5032a0ff4c3290ff483280
+ff6432f0ff6032e0ff5c32d0ff5832c0
+ff743230ff703220ff6c3210ff683200
+ff303710ff2c3700ff7c3250ff783240
+ff403750ff3c3740ff383730ff343720
+ff503790ff4c3780ff483770ff443760
+ff6037d0ff5c37c0ff5837b0ff5437a0
+ff703710ff6c3700ff6837f0ff6437e0
+ff803750ff7c3740ff783730ff743720
+ff3c3c30ff383c20ff343c10ff303c00
+ff4c3c70ff483c60ff443c50ff403c40
+ff5c3cb0ff583ca0ff543c90ff503c80
+ff6c3cf0ff683ce0ff643cd0ff603cc0
+ff7c3c30ff783c20ff743c10ff703c00
+ff384110ff344100ff843c50ff803c40
+ff484150ff444140ff404130ff3c4120
+ff584190ff544180ff504170ff4c4160
+ff6841d0ff6441c0ff6041b0ff5c41a0
+ff784110ff744100ff7041f0ff6c41e0
+ff884150ff844140ff804130ff7c4120
+ff444630ff404620ff3c4610ff384600
+ff544670ff504660ff4c4650ff484640
+ff6446b0ff6046a0ff5c4690ff584680
+ff7446f0ff7046e0ff6c46d0ff6846c0
+ff844630ff804620ff7c4610ff784600
+ff404b10ff3c4b00ff8c4650ff884640
+ff504b50ff4c4b40ff484b30ff444b20
+ff604b90ff5c4b80ff584b70ff544b60
+ff704bd0ff6c4bc0ff684bb0ff644ba0
+ff804b10ff7c4b00ff784bf0ff744be0
+ff904b50ff8c4b40ff884b30ff844b20
+ff4c5030ff485020ff445010ff405000
+ff5c5070ff585060ff545050ff505040
+ff6c50b0ff6850a0ff645090ff605080
+ff7c50f0ff7850e0ff7450d0ff7050c0
+ff8c5030ff885020ff845010ff805000
+ff485510ff445500ff945050ff905040
+ff585550ff545540ff505530ff4c5520
+ff685590ff645580ff605570ff5c5560
+ff7855d0ff7455c0ff7055b0ff6c55a0
+ff885510ff845500ff8055f0ff7c55e0
+ff985550ff945540ff905530ff8c5520
+ff545a30ff505a20ff4c5a10ff485a00
+ff645a70ff605a60ff5c5a50ff585a40
+ff745ab0ff705aa0ff6c5a90ff685a80
+ff845af0ff805ae0ff7c5ad0ff785ac0
+ff945a30ff905a20ff8c5a10ff885a00
+ff505f10ff4c5f00ff9c5a50ff985a40
+ff605f50ff5c5f40ff585f30ff545f20
+ff705f90ff6c5f80ff685f70ff645f60
+ff805fd0ff7c5fc0ff785fb0ff745fa0
+ff905f10ff8c5f00ff885ff0ff845fe0
+ffa05f50ff9c5f40ff985f30ff945f20
+ff5c6430ff586420ff546410ff506400
+ff6c6470ff686460ff646450ff606440
+ff7c64b0ff7864a0ff746490ff706480
+ff8c64f0ff8864e0ff8464d0ff8064c0
+ff9c6430ff986420ff946410ff906400
+ff586910ff546900ffa46450ffa06440
+ff686950ff646940ff606930ff5c6920
+ff786990ff746980ff706970ff6c6960
+ff8869d0ff8469c0ff8069b0ff7c69a0
+ff986910ff946900ff9069f0ff8c69e0
+ffa86950ffa46940ffa06930ff9c6920
+ff646e30ff606e20ff5c6e10ff586e00
+ff746e70ff706e60ff6c6e50ff686e40
+ff846eb0ff806ea0ff7c6e90ff786e80
+ff946ef0ff906ee0ff8c6ed0ff886ec0
+ffa46e30ffa06e20ff9c6e10ff986e00
+ff607310ff5c7300ffac6e50ffa86e40
+ff707350ff6c7340ff687330ff647320
+ff807390ff7c7380ff787370ff747360
+ff9073d0ff8c73c0ff8873b0ff8473a0
+ffa07310ff9c7300ff9873f0ff9473e0
+ffb07350ffac7340ffa87330ffa47320
+ff6c7830ff687820ff647810ff607800
+ff7c7870ff787860ff747850ff707840
+ff8c78b0ff8878a0ff847890ff807880
+ff9c78f0ff9878e0ff9478d0ff9078c0
+ffac7830ffa87820ffa47810ffa07800
+ff687d10ff647d00ffb47850ffb07840
+ff787d50ff747d40ff707d30ff6c7d20
+ff887d90ff847d80ff807d70ff7c7d60
+ff987dd0ff947dc0ff907db0ff8c7da0
+ffa87d10ffa47d00ffa07df0ff9c7de0
+ffb87d50ffb47d40ffb07d30ffac7d20
+ff748230ff708220ff6c8210ff688200
+ff848270ff808260ff7c8250ff788240
+ff9482b0ff9082a0ff8c8290ff888280
+ffa482f0ffa082e0ff9c82d0ff9882c0
+ffb48230ffb08220ffac8210ffa88200
+ff708710ff6c8700ffbc8250ffb88240
+ff808750ff7c8740ff788730ff748720
+ff908790ff8c8780ff888770ff848760
+ffa087d0ff9c87c0ff9887b0ff9487a0
+ffb08710ffac8700ffa887f0ffa487e0
+ffc08750ffbc8740ffb88730ffb48720
+ff7c8c30ff788c20ff748c10ff708c00
+ff8c8c70ff888c60ff848c50ff808c40
+ff9c8cb0ff988ca0ff948c90ff908c80
+ffac8cf0ffa88ce0ffa48cd0ffa08cc0
+ffbc8c30ffb88c20ffb48c10ffb08c00
+ff789110ff749100ffc48c50ffc08c40
+ff889150ff849140ff809130ff7c9120
+ff989190ff949180ff909170ff8c9160
+ffa891d0ffa491c0ffa091b0ff9c91a0
+ffb89110ffb49100ffb091f0ffac91e0
+ffc89150ffc49140ffc09130ffbc9120
+ff849630ff809620ff7c9610ff789600
+ff949670ff909660ff8c9650ff889640
+ffa496b0ffa096a0ff9c9690ff989680
+ffb496f0ffb096e0ffac96d0ffa896c0
+ffc49630ffc09620ffbc9610ffb89600
+ff809b10ff7c9b00ffcc9650ffc89640
+ff909b50ff8c9b40ff889b30ff849b20
+ffa09b90ff9c9b80ff989b70ff949b60
+ffb09bd0ffac9bc0ffa89bb0ffa49ba0
+ffc09b10ffbc9b00ffb89bf0ffb49be0
+ffd09b50ffcc9b40ffc89b30ffc49b20
+ff8ca030ff88a020ff84a010ff80a000
+ff9ca070ff98a060ff94a050ff90a040
+ffaca0b0ffa8a0a0ffa4a090ffa0a080
+ffbca0f0ffb8a0e0ffb4a0d0ffb0a0c0
+ffcca030ffc8a020ffc4a010ffc0a000
+ff88a510ff84a500ffd4a050ffd0a040
+ff98a550ff94a540ff90a530ff8ca520
+ffa8a590ffa4a580ffa0a570ff9ca560
+ffb8a5d0ffb4a5c0ffb0a5b0ffaca5a0
+ffc8a510ffc4a500ffc0a5f0ffbca5e0
+ffd8a550ffd4a540ffd0a530ffcca520
+ff94aa30ff90aa20ff8caa10ff88aa00
+ffa4aa70ffa0aa60ff9caa50ff98aa40
+ffb4aab0ffb0aaa0ffacaa90ffa8aa80
+ffc4aaf0ffc0aae0ffbcaad0ffb8aac0
+ffd4aa30ffd0aa20ffccaa10ffc8aa00
+ff90af10ff8caf00ffdcaa50ffd8aa40
+ffa0af50ff9caf40ff98af30ff94af20
+ffb0af90ffacaf80ffa8af70ffa4af60
+ffc0afd0ffbcafc0ffb8afb0ffb4afa0
+ffd0af10ffccaf00ffc8aff0ffc4afe0
+ffe0af50ffdcaf40ffd8af30ffd4af20
+ff9cb430ff98b420ff94b410ff90b400
+ffacb470ffa8b460ffa4b450ffa0b440
+ffbcb4b0ffb8b4a0ffb4b490ffb0b480
+ffccb4f0ffc8b4e0ffc4b4d0ffc0b4c0
+ffdcb430ffd8b420ffd4b410ffd0b400
+ff98b910ff94b900ffe4b450ffe0b440
+ffa8b950ffa4b940ffa0b930ff9cb920
+ffb8b990ffb4b980ffb0b970ffacb960
+ffc8b9d0ffc4b9c0ffc0b9b0ffbcb9a0
+ffd8b910ffd4b900ffd0b9f0ffccb9e0
+ffe8b950ffe4b940ffe0b930ffdcb920
+ffa4be30ffa0be20ff9cbe10ff98be00
+ffb4be70ffb0be60ffacbe50ffa8be40
+ffc4beb0ffc0bea0ffbcbe90ffb8be80
+ffd4bef0ffd0bee0ffccbed0ffc8bec0
+ffe4be30ffe0be20ffdcbe10ffd8be00
+ffa0c310ff9cc300ffecbe50ffe8be40
+ffb0c350ffacc340ffa8c330ffa4c320
+ffc0c390ffbcc380ffb8c370ffb4c360
+ffd0c3d0ffccc3c0ffc8c3b0ffc4c3a0
+ffe0c310ffdcc300ffd8c3f0ffd4c3e0
+fff0c350ffecc340ffe8c330ffe4c320
+0000000000eeeeee6000000000000001
+00000000000000000000000000000016
+000000000000004c0000000000010000
+00000000000000060000000994004030
+000000000000000100000000ff000000
+00000000000000030000000000000000
+00000000000000050000000000000000
+00000000000000ee2000000000008001
+000000000000000300000000009c00f0
+000000000000000500000000027000f0
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000
+00000000000000000000000000000000