Arcade-Guardians_MiSTer

KO | EN

gitlite — search

#pdf #ios #json #command-line #codex #windows #macos #ruby #nextjs #python

Arcade-Guardians_MiSTer

(★ 9)

Hardware-validated Guardians / Denjin Makai II arcade core for MiSTer FPGA

파일 탐색기

ZIP 다운로드

- HARDWARE.md
- Guardians (Denjin Makai II).mra
- Arcade-Guardians.rbf
- Guardians (Denjin Makai II).mra
- - LICENSE
  - README.md
- - pll_0002.qip
  - pll_0002.v
  - pll_0002_q13.qip
- crt_adjust.sv
- crt_vsize.sv
- gd_analog_to_digital.sv
- gd_core.sv
- gd_cpu_subsystem.sv
- gd_ddr_memory.sv
- gd_dx101_video.sv
- gd_gfx_arbiter.sv
- gd_mra_cheat_engine.sv
- gd_pause_toggle.sv
- gd_raster_irq.sv
- gd_rom_loader.sv
- gd_rowscroll_history.sv
- gd_sdram.sv
- gd_sprite_ram.sv
- gd_tmp68301.sv
- gd_video_timing.sv
- gd_word_ram.sv
- gd_x1_010.sv
- pll.qip
- pll.v
- check_mra_cheats.ps1
- run_unit_tests.ps1
- tb_gd_analog_to_digital.sv
- tb_gd_ddr_memory.sv
- tb_gd_dx101_video.sv
- tb_gd_gfx_arbiter.sv
- tb_gd_mra_cheat_engine.sv
- tb_gd_pause_toggle.sv
- tb_gd_raster_irq.sv
- tb_gd_rom_loader.sv
- tb_gd_rowscroll_history.sv
- tb_gd_sdram_dma.sv
- tb_gd_sprite_ram.sv
- tb_gd_tmp68301.sv
- tb_gd_video_timing.sv
- - 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
- 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
.gitattributes
.gitignore
Arcade-Guardians.qpf
Arcade-Guardians.qsf
Arcade-Guardians.sdc
Arcade-Guardians.srf
Arcade-Guardians.sv
CHANGELOG.md
clean.bat
CREDITS.md
files.qip
LICENSE
README.md
RELEASE_NOTES.md
SHA256SUMS.txt
TESTING.md
timing_report.tcl
UPSTREAM.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Version 1.2.1 is a native FPGA implementation of
Winkysoft's 1995 arcade game,
licensed to Banpresto,
*Guardians / Denjin Makai II* for the MiSTer DE10-Nano platform.

The core loads an original `grdians.zip` set directly through its MRA. It does
not need a Linux helper, a preprocessing script, or modified ROM files. No
copyrighted game ROMs are included in this repository or its releases.

## Install

1. Copy `Arcade-Guardians.rbf` to `/media/fat/_Arcade/cores/`.
2. Copy `Guardians (Denjin Makai II).mra` to `/media/fat/_Arcade/`.
3. Put a legally obtained, unmodified `grdians.zip` in
   `/media/fat/games/mame/`.
4. Launch **Guardians / Denjin Makai II** from MiSTer's Arcade menu.

The MRA identifies every required ROM by filename and CRC. MiSTer will report a
missing or mismatched file instead of silently loading an incompatible set.

## Controls and service mode

The default mappings are:

| Game control | MiSTer default |
|---|---|
| Attack | A |
| Jump | B |
| Special | X |
| Pause | Y |
| Start | Start |
| Coin | Select |
| Service | R |

Player 1 and Player 2 controls are supported. The core OSD also exposes the
game's DIP switches and a **Test / service mode** switch. The MRA's original
Service Mode DIP remains available as well. Directional input accepts both the
mapped D-pad and each player's left analog stick, with a signed dead zone.
The mappable **Pause** control freezes the CPU, board timers, and X1-010 sound
state while keeping the video raster and MiSTer OSD alive. Press Pause again
to resume exactly where the game stopped.

The **Scandoubler Fx** menu leaves the original 15-kHz analog RGB timing intact
when set to **None**. MiSTer's `forced_scandoubler=1` setting and the menu's
HQ2x/CRT choices produce 31-kHz output for computer CRTs and VGA displays. CRT
Geometry is automatically bypassed while one of these digital line effects or
forced scandoubling is active so the MiSTer scandoubler always receives the
native uniform pixel stream.

The **CRT Geometry** OSD page provides independent **H Size**, **H Shift**
(up to 32 pixels in either direction),
**V Size**, and **V Shift** controls, plus normal/180-degree rotation. All
geometry is disabled by default, so the native raster is unchanged unless the
option is explicitly enabled. Cabinet mode is the default and retains native
sync timing while using a photometric vertical resize for broad CRT
compatibility. The optional PVM mode retimes the line cadence for unique-line
vertical sizing and is intended only for monitors with a sufficiently wide
horizontal-lock range.
The vertical range is approximately +/-3.5%, deliberately kept within a useful
15-kHz adjustment envelope while fitting beside the core's full M10K usage.

**Turbo CPU (+50%)** raises the 68000-compatible CPU from 16.667 MHz to 25 MHz
to reduce computation-driven slowdown. Raster timing, hardware timers, video,
and X1-010 audio remain at PCB speed, so Turbo adds processing headroom rather
than globally fast-forwarding the game. Turbo is off by default.

The ordinary MiSTer OSD includes a standard **Cheats** menu populated from the
MRA's `<cheats>` block. It provides infinite credits and time plus per-player
lives, energy, power, invincibility, and an always-available special attack.
Every cheat is off by default. MiSTer downloads only the selected 16-byte codes
to a generic FPGA read-override engine, so disabling a cheat immediately
restores the underlying ROM or RAM value. No external cheat file, alternate
ROM, downloader, or helper script is required.

## Implemented hardware

- Toshiba TMP68301-compatible 68000 subsystem and interrupt/timer behavior
- NEC DX-101 / Allumer X1-020-compatible sprite and tile renderer
- Seta X1-010-compatible 16-voice PCM sound
- Direct MRA assembly of the 2 MiB program, 32 MiB graphics, and 1 MiB sample
  regions
- Four-word graphics-loader transactions using four standards-compliant SDRAM
  WRITE commands under one active row
- Board-programmed 410 x 258 raster with 304 x 232 visible pixels
  (15.244 kHz horizontal, 59.085 Hz vertical)
- MiSTer scaler, HDMI, analog video, audio, controller, DIP, reset, and OSD
  integration
- Atomic DX-101 display-list buffering with bounded descriptor traversal
- Raster-aware DX-101 background rendering with per-line packed-scroll replay,
  a 9-bit vertical coordinate ring for normal sprites and floating layers, and
  10-bit horizontal wrapping
- Held-line DX-101 raster-IRQ re-arming for the game's two-line rowscroll
  effects on the native 410-pixel raster
- A 68.75-MHz internal renderer, open-page graphics DMA, and thirteen-line
  completion reservoir for stable rowscroll-heavy scenes
- Packed-descriptor raster targeting that confines the Stage 1 heat effect to
  its floating background layer without distorting foreground actors

The memory design places the 32 MiB graphics bus in MiSTer's SDRAM and keeps
program ROM, samples, and selected writable storage in DDR3. See
[`docs/HARDWARE.md`](docs/HARDWARE.md) for the board map and implementation
notes.

## Build

The release was built with Quartus Prime Lite 17.0 for the Cyclone V
`5CSEBA6U23I7`:

```powershell
quartus_sh --flow compile Arcade-Guardians
```

The replacement 1.2.1 build closes every analyzed timing class with no
violations. Overall worst setup slack is +0.497 ns, worst hold slack is
+0.194 ns, worst recovery slack is +2.956 ns, and worst removal slack is
+0.760 ns.

## Tests

The focused RTL test suite uses Icarus Verilog 11 or newer:

```powershell
./sim/run_unit_tests.ps1
```

Set `IVERILOG` and `VVP` to full executable paths if they are not on `PATH`.
The suite covers CRT geometry syntax, analog-stick conversion, video timing,
DDR access, registered
SDRAM DMA capture, four-command loader writes, graphics-stream packing,
MRA cheat-code syntax and big-endian CPU byte lanes, graphics arbitration,
DX-101 rendering, loading-screen
global zoom and fixed-position bypass, sprite-list
buffering, native raster/prefetch wrap, 9-bit sprite and floating-layer Y
wrapping, per-line rowscroll replay, circular object spans, raster look-ahead
gating, and TMP68301 behavior.
The raster tests also cover ordinary line matches, held-line re-entry, and
rejection of re-arm writes for future lines. Renderer checks also cover the
normal and 180-degree coordinate origins without altering native sync timing.

The game hardware path was verified on a DE10-Nano with the MRA and an
unmodified ROM set. Validation included a cold MRA boot, successful ROM
checksum and RAM-access self-tests, correct intro graphics after four-word
SDRAM loading, the correctly scaled stage-map/loading screen, and the Stage 1
post-explosion sequence. The replacement build adds the MRA cheat interface;
its loader, code matching, big-endian byte lanes, and MRA format are covered by
focused simulation and a clean full Quartus build.

## Source and licensing

This repository intentionally contains only the buildable core, required MiSTer
framework files, focused tests, MRA, and documentation. Quartus databases,
captures, ROMs, diagnostic binaries, abandoned experiments, and local deployment
tools are excluded.

Core RTL is distributed under GPL-3.0-or-later. Bundled upstream components keep
their original notices and terms. See [`CREDITS.md`](CREDITS.md) and
[`UPSTREAM.md`](UPSTREAM.md) for exact source provenance, and [`LICENSE`](LICENSE).

## MiSTer-devel handoff

The repository follows the MiSTer arcade-core layout: the repository and
Quartus project use the `Arcade-Guardians` name, while `releases/` contains the
fixed-name `Arcade-Guardians.rbf` and its matching
`Guardians (Denjin Makai II).mra`. The MRA names the RBF without an extension.
Build databases, game ROMs, local packages, and diagnostic artifacts are
deliberately excluded from version control.

Arcade-Guardians_MiSTer

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Arcade-Guardians_MiSTer

오너의 다른 레포

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README