System573_MiSTer

KO | EN

gitlite — search

#mysql #typescript #tensorflow #chatgpt #codex #gemini #deep-learning #devops #java #php

System573_MiSTer

(★ 9)

Konami System 573 arcade core for MiSTer (FPGA)

File Explorer

ZIP Download

- - agent-progress.py
  - session-start.sh
- settings.json
- - 2026-06-06-rtl-witness-audit.findings.json
  - 2026-06-06-rtl-witness-audit.md
  - 2026-06-10-glyph-upload-characterization.md
  - 2026-06-10-missing-layer-reframe.md
  - 2026-06-10-platform-constants-audit.md
  - 2026-06-10-sdram-capture-audit.md
  - 2026-06-10-vram-2mb-redgreen.md
  - 2026-06-11-nvram-saveback-gate0.md
  - 2026-06-12-ddr-feasibility.md
  - 2026-06-12-flash-persistence-gate0.md
  - 2026-06-12-resource-recovery-scope.md
  - 2026-06-23-io-board-coverage.md
- - 573.md
- 2026-06-07-testC-hypbbc2p-readiness.md
- 2026-06-12-game2-hypbbc2p-cd-install.md
- 2026-06-21-powyakex-flash-install-stall.md
- 2026-06-24-ddrsbm-bootcheck-handoff.md
- 2026-06-25-ddrsbm-identify-irq-race-handoff.md
- 2026-06-25-ddrsbm-SESSION-handoff.md
- 2026-06-27-board-variants-and-powyakex-audio-handoff.md
- 2026-06-27-powyakex-menu-launch-and-packaging.md
- 2026-06-29-arcade-cd-mount-upstream-plan.md
- 2026-06-30-ddrsbm-bootcheck-tracedig-handoff.md
- 2026-06-30-ddrsbm-bootcheck-tracedig.md
- 2026-06-30-ddrsbm-capx-verdict.md
- 2026-06-30-ddrsbm-drain-capture-finding.md
- 2026-06-30-ddrsbm-signaltap-drain-handoff.md
- 2026-07-01-ddrsbm-bootcheck-dio-verdict.md
- 2026-07-01-ddrsbm-capx-handoff.md
- 2026-07-01-ddrsbm-dio-i2c-result.md
- 2026-07-01-ddrsbm-dio-i2c-transactions.md
- 2026-07-01-k573dio-i2c-destub-plan.md
- 2026-07-02-ddrsbm-erase-strap-result.md
- 2026-07-02-gate5-cdrom-timeout-observation.md
- 2026-07-02-k573dio-ram-plan.md
- 2026-07-02-k573dio-ram-result.md
- 2026-07-03-gate5-fix-result.md
- 2026-07-03-gate5-red-bench.md
- 2026-07-03-p4-mp3-pacing-model.md
- 2026-07-03-p4b-mp3-transport-design.md
- 2026-07-29-dio-mp3-reload-race.md
- 2026-07-29-p4b-decision-b-spike-result.md
- 2026-07-30-ddrsbm-capture-false-alarm.md
- 2026-07-30-hdmi-timing-fitter-effort.md
- 2026-07-31-ddrsbm-flash-restore-root-cause.md
- 2026-07-31-mame-oracle-gc-trap.md
- 2026-07-31-mp3-audio-verdict-negative.md
- 2026-07-31-mp3-audio-WORKING.md
- 2026-08-02-mp3-stale-pcm-residue.md
- 2026-08-02-mp3-stop-cfg-epoch-truncation.md
- ARCHITECTURE.md
- DEPENDENCIES.md
- EXECUTION_PLAN.md
- FLASH_LOAD_PLAN.md
- MEMORY_MAP.md
- MISTER_DEV_NOTES.md
- PHASE1_PSX.md
- PHASE4_HARDWARE.md
- ROADMAP.md
- README.md
- - hypbbc2p.u1
  - hypbbc2p_kaa.u1
- mister.env.example
- ddrsbm_console.mgl
- hypbbc2p_console.mgl
- hyperbbc_console.mgl
- konam80s_console.mgl
- hyperbbc573.mra
- 0001-s573-exp1-widening.patch
- 0002-s573-nvc-cd-positionInIndex-init.patch
- 0003-s573-nvc-gpu-videoout-linemax-clamp.patch
- 0004-s573-cpu-icache-redirect-fix.patch
- 0005-s573-cpu-bios-uncached.patch
- 0006-s573-exp1-flash-wait.patch
- 0007-sdram-ch4-flash.patch
- 0008-s573-disable-cheats-engine.patch
- 0009-s573-exp1-byte-read-lane.patch
- 0010-s573-exp1-reqsize.patch
- 0011-s573-remove-cd-top.patch
- 0012-s573-debug-texmode-flagcolor.patch
- 0013-s573-clut-cache-coherency.patch
- 0014-s573-disable-clut-cache.patch
- 0015-s573-clut-stripe-probe.patch
- 0016-s573-clut-resident-interlock.patch
- 0017-s573-clut-rowdump-probe.patch
- 0018-s573-clut-rowlock.patch
- 0019-s573-clut-cache-restore.patch
- 0020-sdram-cas-latency-3.patch
- 0021-gpu-2mb-vram-10bit-y.patch
- 0022-s573-main-ram-4mb.patch
- 0023-s573-dma-ch5-atapi.patch
- 0024-s573-sio1-dsr-presence.patch
- 0025-s573-audio-iir-passthrough.patch
- 0026-s573-strip-psx-joypad-pad-lightgun.patch
- 0027-s573-strip-memcard2-snac.patch
- adc0834.v
- adc0838.v
- atapi.v
- crc16.v
- ds2401.v
- emu.sv
- flash_nor.v
- k573_mp3dec.v
- k573_mp3stream.v
- k573dio.v
- m48t58.v
- mas3507d_i2c.v
- s573_audio_mix.v
- s573_bus.v
- s573_cdimg.v
- s573_cdtoc.v
- s573_ch4_arb.v
- s573_ddram_arb.v
- s573_flash.v
- s573_flash_saver.v
- s573_hps_ext.v
- s573_io.v
- s573_mp3_credit.v
- s573_mp3_pcm.v
- s573_nvram_loader.v
- s573_nvram_saver.v
- s573_pcm_ring.v
- s573_seccart.v
- s573_seccart_loader.v
- system573_top.v
- watchdog.v
- x76f041.v
- x76f100.v
- zs01.v
- - attribute_tap8.py
  - check_vram2mb.py
  - cmd_bgpanel573.txt
  - cmd_clutrace.txt
  - cmd_clutrace_d1500.txt
  - cmd_clutrace_d2500.txt
  - cmd_clutrace_d800.txt
  - cmd_clutrace_min.txt
  - cmd_clutrace_repro.txt
  - cmd_clutrace_tight.txt
  - cmd_dc2_quads.txt
  - cmd_dc2_quads_gen_trunc.txt
  - cmd_dc2_quads_off.txt
  - cmd_dc2_quads_tight.txt
  - cmd_dc2_quads_tight2.txt
  - cmd_dc2_quads_tight2_trunc.txt
  - cmd_dma_quads573.txt
  - cmd_fill_demo.txt
  - cmd_fullframe573_quads.txt
  - cmd_fullframe573_rects.txt
  - cmd_garbleband.txt
  - cmd_menu491_offset.txt
  - cmd_node1.txt
  - cmd_quad74.txt
  - cmd_quads_only.txt
  - cmd_rects_then_quads.txt
  - cmd_texquad.txt
  - cmd_texrect.txt
  - cmd_texrect64.txt
  - cmd_wrongclut.txt
  - ddr_contention_shim.vhd
  - decode_clutrace.py
  - gen_stream.py
  - gen_vram2mb.py
  - ot_trace.py
  - README.md
  - run.sh
  - run_dma_ingest.sh
  - run_vram2mb.sh
  - tb_gpu_dma_ingest.vhd
  - tb_gpu_replay.vhd
- - altera_mf_stub.vhd
  - elaborate.sh
  - README.md
  - run_dma_ch5.sh
  - run_sio_dsr.sh
  - tb_dma_ch5.vhd
  - tb_irq10.vhd
  - tb_sio_dsr.vhd
- - run.sh
  - tb_sdram_dma.v
- - .gitignore
  - README.md
  - run_spike.py
  - s573_descramble.c
  - s573_descramble.h
  - spike_main.c
  - tb_spike_descramble.v
- - README.md
  - run.sh
  - run_ram_mirror.sh
  - tb_system573.vhd
- - README.md
  - run.sh
  - tb_573_ssreplay.vhd
- gen_cddata.sh
- gen_secdata.sh
- Makefile
- tb_adc0834.v
- tb_adc0838.v
- tb_atapi.v
- tb_atapi_cdread.v
- tb_atapi_settle.v
- tb_cdboot.v
- tb_crc16.v
- tb_dio_i2c.v
- tb_dio_mp3_reload.v
- tb_drivecheck.v
- tb_ds2401.v
- tb_flash_nor.v
- tb_gate5_replay.v
- tb_irqdeliver.v
- tb_k573_mp3dec.v
- tb_k573_mp3stream.v
- tb_k573_mp3stream_engate.v
- tb_k573dio.v
- tb_k573dio_ram.v
- tb_m48t58.v
- tb_s573_audio_mix.v
- tb_s573_bus.v
- tb_s573_cdimg.v
- tb_s573_cdtoc.v
- tb_s573_ch4_arb.v
- tb_s573_ddram_arb.v
- tb_s573_dio_mux_seam.v
- tb_s573_flash.v
- tb_s573_flash_erase.v
- tb_s573_flash_image.v
- tb_s573_flash_saver.v
- tb_s573_flash_sdram.v
- tb_s573_hps_ext.v
- tb_s573_io.v
- tb_s573_mp3_credit.v
- tb_s573_mp3_path.v
- tb_s573_mp3_pcm.v
- tb_s573_nvram_loader.v
- tb_s573_nvram_saver.v
- tb_s573_pcm_ring.v
- tb_s573_seccart.v
- tb_s573_seccart_loader.v
- tb_system573_top.v
- tb_watchdog.v
- tb_x76f041.v
- tb_x76f100.v
- tb_x76f100_hypbbc2p.v
- tb_zs01.v
- - pll_audio_0002.qip
  - pll_audio_0002.v
- - altera_pll_reconfig_core.v
  - altera_pll_reconfig_top.v
  - pll_cfg.v
  - pll_cfg_hdmi.v
- - pll_hdmi_0002.qip
  - pll_hdmi_0002.v
- alsa.sv
- arcade_video.v
- ascal.vhd
- audio_out.sv
- build_id.tcl
- ddr_svc.sv
- emu_ports.vh
- f2sdram_safe_terminator.sv
- gamma_corr.sv
- hps_io.sv
- hq2x.sv
- i2c.v
- i2s.v
- iir_filter.v
- ltc2308.sv
- math.sv
- mcp23009.sv
- mt32pi.sv
- osd.v
- pll.13.qip
- pll_audio.13.qip
- pll_audio.qip
- pll_audio.v
- pll_cfg.qip
- pll_hdmi.13.qip
- pll_hdmi.qip
- pll_hdmi.v
- pll_hdmi_adj.vhd
- pll_q13.qip
- pll_q17.qip
- README.md
- scandoubler.v
- scanlines.v
- sd_card.sv
- shadowmask.sv
- sigma_delta_dac.v
- spdif.v
- sys.qip
- sys.tcl
- sys_analog.tcl
- sys_dual_sdram.tcl
- sys_top.sdc
- sys_top.v
- sysmem.sv
- vga_out.sv
- video_cleaner.sv
- video_freak.sv
- video_freezer.sv
- video_mixer.sv
- yc_out.sv
- - BUILD9_PLAN.md
  - capture.sh
  - capture_atapi.sh
  - capture_headless.tcl
  - clut_race.stp
  - clut_race_491.stp
  - clut_race_anydma.stp
  - clut_race_anystrobe.stp
  - clut_race_ctl.stp
  - clut_race_framedump.stp
  - clut_race_instrobe.stp
  - clut_race_rec491.stp
  - clut_race_recon.stp
  - clut_race_stp.tcl
  - clut_race_stream.stp
  - clut_race_true491.stp
  - clut_race_true491x.stp
  - clut_race_word_u1alt.stp
  - clut_race_word_u1early.stp
  - clut_race_word_u2anchor.stp
  - clut_race_word_u3tail.stp
  - FALLBACK.md
  - FIT.md
  - read_stp_csv.py
  - RUNBOOK.md
  - signaltap.qsf.snippet
- - cass_outcome_tap.lua
  - cass_sda_tap.lua
  - cass_validate_tap.lua
  - ddrsbm_ata_full.lua
  - ddrsbm_desc_arm.lua
  - ddrsbm_dio_tap.lua
  - ddrsbm_dump_late.lua
  - dio_trace.lua
  - dump_code.lua
  - exp1_trace.lua
  - mame_pctrace.lua
  - psx_trace.lua
  - pwk_flash_tap.lua
  - sec_wd_tap.lua
  - sim_pctrace_to_format.py
- apply_psx_patches.sh
- audio_envelope.py
- check_boot.py
- dell_build.sh
- dell_timing.sh
- dio_log_summary.py
- gen_seccart_u1.py
- gra2png.py
- hw_display_frame.py
- mame573.sh
- mame_capture.sh
- mame_dio_regs.lua
- mame_flash_install.lua
- mame_gp0_replay.lua
- mame_inject.lua
- mame_main_menu.lua
- mame_render_ss.sh
- mame_screen_probe.lua
- mame_service_menu.lua
- mame_snap_milestones.lua
- mame_vnc_dell.sh
- mister_boot573.sh
- mister_capture_pair.sh
- mister_cd_install.sh
- mister_deploy_console.sh
- mister_filmstrip.sh
- mister_load.sh
- mister_menu_nav.md
- mister_menu_verify.sh
- mister_mra.sh
- mister_press.py
- mister_press.sh
- mister_shot.sh
- mister_ss_watch.sh
- mister_vram_dump.sh
- pack_gtrfrk5m.py
- pack_hyperbbc.py
- pack_pnchmn2.py
- play_ddrsbm_mac.sh
- ss_garble_probe.sh
- ss_gpu_dma_state.py
- ss_render_display.py
- ss_to_mame.py
- ss_vram_extract.py
- sta_hdmi.tcl
- timing_triage.tcl
- wf_cockpit_progress.sh
.gitignore
.gitmodules
CLAUDE.md
CONTRIBUTING.md
files.qip
Konami_System_573.qsf
Konami_System_573.sdc
LICENSE
PLATFORM.md
psx
README.md
sys_pins.tcl

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A work-in-progress MiSTer FPGA core for the **Konami System 573**, the
PlayStation-based arcade board behind *Dance Dance Revolution* and the rest of
Konami's BEMANI line (as well as games like *GunMania* and *Hyper Bishi Bashi
Champ*).

## What this board is

The System 573 is, at its core, a Sony PlayStation:

| Block        | Part                              | Notes                              |
|--------------|-----------------------------------|------------------------------------|
| CPU          | Sony CXD8530CQ (MIPS R3000A)      | 33.8688 MHz, same as retail PS1    |
| GPU          | Sony CXD8561Q                     | 2 MB VRAM (retail PS1 has 1 MB)    |
| SPU          | Sony CXD2925Q                     | 512 KB sound RAM                   |
| Main RAM     | 4 MB                              | retail PS1 has 2 MB                |
| BIOS         | 512 KB Konami BIOS                | boots from CD-ROM / flash          |

On top of the PS1 it adds 573-specific hardware on the EXP1 bus:

- **Konami ASIC I/O** (`0x1f400000`) — JAMMA inputs, coin counters, ADC & security
  cartridge bit-bang lines, audio control.
- **ATAPI CD-ROM** (`0x1f480000`) — game data, booted per title.
- **Bank-switched flash / PCMCIA** (`0x1f000000`, control at `0x1f500000`).
- **Security cartridge** (`0x1f6a0000` + status in the ASIC) — per-game DS2401
  silicon serial number plus an X76F041 / X76F100 / ZS01 secured EEPROM.
- **M48T58 timekeeper** (`0x1f620000`) — battery-backed NVRAM + RTC.
- **ADC0834** serial ADC (bit-banged through the ASIC control register).
- **Watchdog** (`0x1f5c0000`) — resets the board if not kicked.
- **Digital I/O board** (`0x1f640000`, DDR & later BEMANI) — FPGA + **MAS3507D**
  MP3 decoder streaming encrypted audio, plus light outputs and its own DS2401.

The full register map (transcribed from psx-spx) lives in
[`docs/MEMORY_MAP.md`](docs/MEMORY_MAP.md).

## Status — honest accounting

**Latest milestone (2026-08-02): a DDR title boots, plays, and has working
streamed MP3 music on real hardware.** *Dance Dance Revolution Solo Bass Mix*
(`ddrsbm`) boots from restored onboard flash into attract, plays through a
credited stage, and streams its encrypted MP3 soundtrack — the BEMANI Digital
I/O board path end to end: board DRAM window → descrambler → MP3 decode → PCM
ring → mixed with the PSX SPU.

The decode itself runs on the **HPS (ARM) side, not in fabric**. An in-fabric
Huffman/IMDCT/synthesis decoder was costed at ~3,000–8,000 ALM plus DSP against a
device already at 100% DSP, and rejected on those numbers
([`docs/audits/2026-06-12-ddr-feasibility.md`](docs/audits/2026-06-12-ddr-feasibility.md)).
The fabric owns the descrambler, the streaming controller and the PCM ring; the
ARM owns the decoder.

Two audio defects were found and fixed on 2026-08-02, both firmware-side:

- **Music never stopped.** The service compared a full 16-bit config epoch against
  a field it filled from an 8-bit echo register, so past epoch 255 the two could
  never match, the config re-applied on every poll, and the game's stop was
  overwritten milliseconds later. Measured: 229/229 diverged heartbeats satisfied
  `adopted == fabric % 256`, divergence starting at the first heartbeat past 255.
- **~1.5 s of the previous song replayed at each song change.** Two causes: the
  ring's write pointer was masked to 15 bits while the fabric compares all 16
  including the wrap bit, and nothing discarded already-decoded PCM when a new
  window armed. Measured after the fix: 26 flushes across attract, 1.454–1.476 s
  discarded each, 0/747 epoch divergence, verified out to epoch 1412.

**Known limitation:** the Solo cabinet's song-wheel buttons (*Select L* / *Select
R* — a different register from the dance panels) are not yet wired, so menus
advance with START only. The fix is written and simulated but is deliberately not
in a shipped bitstream: the design sits at **97% ALM and 100% DSP**, and adding it
pushed an already-marginal MiSTer scaler path to −0.11 ns. It lands once resource
recovery buys headroom
([`docs/audits/2026-06-12-resource-recovery-scope.md`](docs/audits/2026-06-12-resource-recovery-scope.md)).

**Previous milestone (2026-06-12): two games boot and run on real hardware.**
Game #1 **hyperbbc** (flash-only) boots, runs, and has audio. Game #2
**hypbbc2p** (*Hyper Bishi Bashi Champ 2P*) — the first **CD-install** title —
now **boots and runs on real hardware** (de10): the authentic `gx908ja.u1`
security cassette clears the on-screen `-11N` BIOS signature wall, the CD/ATAPI
installer copies the disc to onboard flash (the **first hardware exercise of the
CD path**, previously sim-only), the flash programs, the in-game ROM check passes,
and the attract/demo loop runs. So the **security-cassette + CD-install path is
validated on hardware**. Note: hypbbc2p requires the real `gx908ja.u1` dump —
the BIOS reads a boot-time cassette **signature** (cassette block 1) that is
authentic-dump data, not synthesizable from game plaintext, so the real dump is a
required user-supplied artifact (treat it like a BIOS). The MAME-`BAD_DUMP`
`gx908ja.u1` (crc 8900eaff) is functionally complete and works.

The 573-specific hardware is **implemented and unit-tested**, the **PlayStation
core is integrated over EXP1**, the **Konami BIOS executes in full-system
simulation**, and — as of 2026-06-02 — **the core boots that BIOS and displays it
on real MiSTer hardware**: a built `.rbf` brings up the gchgchmp 573 BIOS; the color
bars (initially a CPU i-cache crash, fixed via `psx_patches/` 0004/0005) are now
passed and the BIOS reaches the GX700 power-on self-test (parked at CDR), with a
locked component signal on a CRT (Cyclone V, DE10-Nano-class; verified on a
SuperStation One). There's plenty
left — inputs, CD/security/flash, full game compatibility — but it is a real,
booting core now, not glue around a stub.

**Where it is right now (updated 2026-06-01):**

- **Phases 1 & 2 complete** (merged via reviewed PRs). The MiSTer PSX core
  (`psx/`, vendored as a pinned submodule) is wired to this fabric over the
  PlayStation **EXP1** bus, widened to a full 16-bit master with IRQ10. Those core
  edits live as isolated patches in `psx_patches/`, re-applied by
  `tools/apply_psx_patches.sh` — the submodule pin never moves.
- A **full-system simulation harness** (`sim/system573/`) boots the **Konami
  BIOS** on the integrated core under [**NVC**](https://www.nickg.me.uk/nvc/) (the
  PSX core is VHDL-2008, which Verilator cannot consume — see
  [`docs/PHASE1_PSX.md`](docs/PHASE1_PSX.md)). Verified: the CPU runs from the
  reset vector through the 4 MB RAM test, BSS clear, **main init (`0x1FC05504`)**
  and **GPU init** (the GPUSTAT poll resolves), kicking the 573 watchdog over EXP1
  throughout. `tools/check_boot.py` gates these milestones.
- **Phase 3 — BIOS self-tests on hardware:** the color bars turned out to be a CPU
  i-cache *crash* (wrong instruction word on the cached KSEG0 BIOS mirror), now fixed
  by `psx_patches/` 0004 (i-cache redirect) + 0005 (run BIOS fetches uncached). With
  the 18E (H8/3644) I/O-MCU self-test answered (`rtl/s573_io.v`, PR #16), the BIOS boots
  past the color bars to the GX700 power-on self-test on real hardware. The self-test
  is a sequential gate, now parked at CDR (CD-ROM), the next check. Sim speed was the
  Phase-3 frontier earlier but is no longer the blocker.
- **Phase 4 (hardware) — boots on real hardware:** `rtl/emu.sv` is the real MiSTer
  top — a clone of the proven `psx/PSX.sv` with the 573 EXP1 deltas — and the design
  builds a `.rbf` (Quartus Prime Lite 17.0.x on x86-64 Linux; the `raetro/quartus:17.0`
  Docker image works — Quartus 17.0 is required for this Cyclone V part) that **boots
  the Konami BIOS past the color bars (an i-cache crash now fixed) to the GX700
  power-on self-test, parked at the CDR check**. Getting
  there fixed the Quartus-hostile RTL (`synthesis translate_off`
  guards, M10K NVRAM, constant-folded flash) **and** two build-config defects found
  by an adversarial review — a mis-pinned bitstream (no pin-location files →
  `sys_pins.tcl`) and unmet timing (unsourced `psx/PSX.sdc`). clk_1x/clk_vid now
  meet; clk_2x is ~3 ns short at the worst corner (a polish item). See
  [`docs/PHASE4_HARDWARE.md`](docs/PHASE4_HARDWARE.md).

A complete System 573 core has to sit on top of a full PlayStation 1 (the kind of
effort that took the MiSTer PSX core years); this repo implements and
**unit-tests** the 573-specific glue around that PS1 and integrates a mature PS1
core underneath it.

| Module                         | File                  | State                  |
|--------------------------------|-----------------------|------------------------|
| DS2401 1-Wire serial number    | `rtl/ds2401.v`        | ✅ implemented + tested |
| ADC0834 serial ADC             | `rtl/adc0834.v`       | ✅ implemented + tested |
| ADC0838 8-channel serial ADC   | `rtl/adc0838.v`       | ✅ implemented + tested |
| M48T58 RTC + NVRAM             | `rtl/m48t58.v`        | ✅ implemented + tested |
| Watchdog timer                 | `rtl/watchdog.v`      | ✅ implemented + tested |
| Konami ASIC I/O register block | `rtl/s573_io.v`       | ✅ implemented + tested |
| EXP1 address decoder           | `rtl/s573_bus.v`      | ✅ implemented + tested |
| X76F100 security EEPROM        | `rtl/x76f100.v`       | ✅ implemented + tested |
| X76F041 security EEPROM        | `rtl/x76f041.v`       | ✅ implemented + tested |
| CRC-16/CCITT engine (ZS01)     | `rtl/crc16.v`         | ✅ implemented + tested |
| ZS01 (NS2K001) security PIC    | `rtl/zs01.v`          | ✅ implemented + tested |
| Digital I/O board registers    | `rtl/k573dio.v`       | ✅ lamps/RAM/keys/DS2401 |
| MP3 audio descrambler          | `rtl/k573_mp3dec.v`   | ✅ implemented + tested |
| MP3 streaming controller       | `rtl/k573_mp3stream.v`| ✅ implemented + tested |
| ATAPI task-file + PACKET + READ | `rtl/atapi.v`        | ✅ subset impl + tested |
| Bank-switched flash (NOR-backed) | `rtl/s573_flash.v`  | ✅ banking impl + tested |
| NOR flash command engine       | `rtl/flash_nor.v`     | ✅ implemented + tested |
| Security-cartridge bus glue    | `rtl/s573_seccart.v`  | ✅ implemented + tested |
| PS1 CPU/GPU/SPU subsystem      | `psx/` submodule      | ✅ integrated in sim (EXP1) |
| MiSTer top level               | `rtl/emu.sv`          | ✅ PSX.sv clone + 573 deltas; **boots BIOS on real hardware** |
| MP3 PCM ring (fabric reader)   | `rtl/s573_pcm_ring.v` | ✅ implemented + tested |
| MP3 PCM drain + gain           | `rtl/s573_mp3_pcm.v`  | ✅ implemented + tested |
| MAS3507D I²C + gain matrix     | `rtl/mas3507d_i2c.v`  | ✅ implemented + tested |
| SPU + MP3 saturating mixer     | `rtl/s573_audio_mix.v`| ✅ implemented + tested |
| MP3 decode (HPS-side service)  | Main fork `support/s573/` | ✅ **plays on real hardware** |
| DDR Solo song-wheel inputs     | `rtl/s573_io.v`       | 🏗️ written + simulated, not in a shipped bitstream (no timing headroom) |

✅ = real RTL with a passing testbench (or, for `psx/`, executing the BIOS in the
full-system NVC sim). 🏗️ = real RTL that synthesizes but isn't hardware-verified
yet. 📋 = docs only.

See [`docs/ROADMAP.md`](docs/ROADMAP.md) for the phases and
[`docs/EXECUTION_PLAN.md`](docs/EXECUTION_PLAN.md) for the detailed plan from here
to full game compatibility (PSX integration, hardware bring-up on MiSTer, and the
ordered file/dump manifest in [`dumps/README.md`](dumps/README.md)).

## Building / testing

The 573-specific RTL is plain Verilog-2005 and is verified with
[Icarus Verilog](https://steveicarus.github.io/iverilog/):

```sh
cd sim
make            # run every testbench, report PASS/FAIL
make ds2401     # run a single module's testbench
```

On Ubuntu, `iverilog` comes from `apt-get install -y iverilog`. A Claude Code
`SessionStart` hook (`.claude/hooks/session-start.sh`, wired up in
`.claude/settings.json`) installs the toolchain and runs the suite automatically
at the start of each web session.

### Full-system boot simulation (NVC)

The PlayStation core is VHDL-2008 (Verilator can't consume it), so the
full-system boot runs under [NVC](https://www.nickg.me.uk/nvc/):

```sh
brew install nvc                          # one-time
sim/system573/run.sh [STOP_TIME] [RAM8MB] # e.g. sim/system573/run.sh 5ms 1
REUSE=1 sim/system573/run.sh 20ms         # re-run a built design at a new stop-time
```

It applies `psx_patches/`, builds the core under NVC, loads the Konami
game-in-BIOS image, runs, and writes traces + a framebuffer dump to the
git-ignored `sim/system573/build/`. Convert the framebuffer to PNG with
`tools/gra2png.py`, and check how far the boot got with:

```sh
tools/check_boot.py sim/system573/build   # report which boot milestones were reached
```

See [`sim/system573/README.md`](sim/system573/README.md) for the harness details
and the current furthest-verified point.

FPGA synthesis targets the standard MiSTer framework: the `sys/` directory is
where the [MiSTer-devel `Template_MiSTer`](https://github.com/MiSTer-devel/Template_MiSTer)
`sys` submodule belongs, and `rtl/emu.sv` is the `emu` top level it instantiates.

## License

RTL in this repository is released under the **GNU GPL v2** to match the MiSTer
framework it is intended to plug into. Hardware register details are transcribed
from the community [psx-spx](https://psx-spx.consoledev.net/konamisystem573/)
documentation and the MAME `ksys573` driver.

System573_MiSTer

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README