本文へ移動
cccskills
無料GitHub で公開

msx-vdp-audit

Validate MSX video emulation for the TMS9918A/TMS9928A/TMS9929A VDP family in EMULATORS, including ports

インストール方法を見る

含まれるファイル(3)

  • SKILL.md2.9 KB
  • agents/openai.yaml225 B
  • references/vdp.md7.5 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

MSX VDP Audit

Core Workflow

Use this skill to audit whether EMULATORS models the MSX1 VDP family as a port-driven video chip with separate VRAM and TMS9918A-compatible side effects.

  1. Read references/vdp.md before making claims or edits.
  2. Inspect the relevant implementation paths first:
    • include/MSX/VDP.hpp, src/MSX/VDP.cpp
    • include/MSX/Screen.hpp, src/MSX/Screen.cpp
    • include/MSX/PortManager.hpp, src/MSX/PortManager.cpp
    • include/MSX/Commands.hpp, src/MSX/Commands.cpp
    • include/TEXASINSTRUMENTS/TMS99xxFamily/TMS99xxFamily.hpp, src/TEXASINSTRUMENTS/TMS99xxFamily/TMS99xxFamily.cpp
    • include/TEXASINSTRUMENTS/TMS99xxFamily/TMS99xxFamilyRegisters.hpp, src/TEXASINSTRUMENTS/TMS99xxFamily/TMS99xxFamilyRegisters.cpp
  3. When changing C++ code, also use $emulators-framework-cpp-style.
  4. Confirm the intended chip/model first. TMS9918A/TMS9928A/TMS9929A behavior is not the same as V9938/V9958 behavior.
  5. Treat port protocol, register side effects, VRAM table addressing, and status reads as correctness requirements, not renderer details.

Audit Priorities

Prioritize correctness in this order:

  • Port #98/#99 protocol, including two-byte control writes, address latch, register writes, status reads, and VRAM auto-increment.
  • Status register flags and clear-on-read behavior for VBlank interrupt, fifth-sprite overflow, and sprite collision.
  • Register R0-R7 write masks, read/write exposure, and mode-bit combinations.
  • Pattern name, color, pattern generator, sprite attribute, and sprite pattern table base calculations, including Graphics II masking quirks.
  • Text, Graphics I, Graphics II, and Multicolor mode rendering rules.
  • Sprite evaluation: Y coordinate offset, terminator, size/magnification, priority, 4 sprites per scanline, overflow index, collision flag.
  • PAL/NTSC frame timing and VDP INT wiring to the Z80/BIOS.

Validation Hints

Useful local anchors:

  • emulators/MSXPrograms/KEY/GRAPHICS1.key
  • emulators/MSXPrograms/KEY/SPRITES1.key
  • emulators/MSXEmulator*/MSX.fmt
  • emulators/MSXEmulatorC/TexasInstruments.hlp
  • VDP monitor commands in src/MSX/Commands.cpp

For visual bugs, reduce to a small VRAM/register setup before comparing whole games. For port bugs, write Z80 tests that touch #98/#99 directly and also through BIOS routines such as WRTVDP, RDVRM, WRTVRM, SETRD, and SETWRT.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Validate Commodore 1540/1541/1541C/1541-II compatible disk-drive behavior in EMULATORS, including IEC serial bus protocol, device numbers, KERNAL traps, CBM DOS commands/status, D64 image parsing, BAM/directory/file chains, PETSCII filenames, 6502 drive CPU/ROM/RAM expectations, 6522 VIA wiring, GCR/track/sector geometry, motor/head timing, and compatibility boundaries for 1541-like devices. Use when Codex reviews or edits C64, VIC-20, C264, COMMODORE disk, serial I/O, D64, CBM DOS, IEC, VIA, GCR, or 1541 drive code.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore 64 CIA 6526 emulation in EMULATORS, including CIA1/CIA2 $DC00/$DD00 register behavior, ports, DDRs, keyboard/joystick matrix, IEC/user port, VIC bank selection, timers A/B, underflow timing, PB toggle/pulse output, TOD clock/alarm, serial shift register, FLAG, ICR masks and IRQ/NMI lines. Use when Codex reviews or edits C64 CIA, timers, ports, keyboard, joystick, serial bus, interrupts, TOD, or VIC bank control.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore 64 memory map, PLA/bank switching, 6510 port $0000/$0001 behavior, VIC bank selection, color RAM, ROM/RAM overlays, cartridge mapping, and mirrored I/O in the EMULATORS C64 namespace. Use when Codex reviews or edits C64 memory, PLA, CPU-visible address decoding, VIC-visible memory, color memory, char ROM, cartridge, expansion I/O, or mapped chip register behavior.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore MPS-801 serial dot matrix printer behavior in EMULATORS, including SerialPrinterMPS801 classes and their MatrixPrinterEmulation and SerialPrinterPeripheralSimulation hierarchy, IEC/KERNAL-trap printer routing, device numbers, secondary addresses, PETSCII/character sets, 6x7 glyphs, double width, graphics mode, reverse field, tab and dot positioning, line/page geometry, PostScript output, and fidelity boundaries. Use when Codex reviews or edits COMMODORE MPS801 printer code, generated printer output, PostScript printer templates, C64/VIC-20/C264 serial-printer behavior, or compares implementation against .codex/docs/MPS801.pdf and historical MPS-801 sources.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore MPS-802 and 1526 serial dot matrix printer behavior in EMULATORS, including SerialPrinterMPS802 classes and their MatrixPrinterEmulation and SerialPrinterPeripheralSimulation hierarchy, IEC/KERNAL-trap printer routing, device numbers, secondary-address functions, PETSCII/character sets, 8x8 glyphs, enhanced width, reverse and paging modes, formatter strings, programmable characters, line/page geometry, PostScript output, and fidelity boundaries. Use when Codex reviews or edits COMMODORE MPS802 printer code, generated printer output, PostScript printer templates, C64/VIC-20/C264 serial-printer behavior, or compares implementation against .codex/docs/MPS802.pdf, the MPS-802 user guide, and 1526/MPS-802/4023 service information.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Validate Commodore 64 SID 6581/8580 sound emulation in EMULATORS, including $D400-$D7FF register decoding, voices, frequency, pulse width, control bits, ADSR/envelope behavior, oscillator sync/ring/noise/test, filters, volume DAC/sample clicks, paddles, read-only registers, mirrors, and reSID integration. Use when Codex reviews or edits SID, Sound, audio wrapper, register, filter, waveform, envelope, or mapped SID behavior.

日本語の概要は準備中です。原文の説明を表示しています。

Commnets/EMULATORS102026年10月9日 更新

Commnets のスキルをすべて見る

このスキルの問題を報告する