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

c64-sid-audit

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.

インストール方法を見る

含まれるファイル(3)

  • SKILL.md2.5 KB
  • agents/openai.yaml213 B
  • references/sid.md4.8 KB

SKILL.md(原文)

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

C64 SID Audit

Core Workflow

Use this skill to audit SID behavior while respecting that a large part of the chip is mixed-signal and model-dependent.

  1. Read references/sid.md before making claims or edits.
  2. Inspect the local implementation paths first:
    • include/COMMODORE/SID/SID.hpp, src/COMMODORE/SID/SID.cpp
    • include/COMMODORE/SID/SIDRegisters.hpp, src/COMMODORE/SID/SIDRegisters.cpp
    • include/COMMODORE/SID/SIDLibWrapper.hpp, src/COMMODORE/SID/SIDLibWrapper.cpp
    • include/C64/Sound.hpp, src/C64/Sound.cpp
    • thirdparties/resid/*
  3. When changing C++ code, also use $emulators-framework-cpp-style.
  4. Distinguish digital register semantics from analog sound character. Register behavior can be tested exactly; filter tone, distortion, and DAC nonlinearity are fidelity targets.
  5. Prefer delegating low-level waveform/envelope/filter generation to reSID unless the existing architecture intentionally wraps or constrains it.

Audit Priorities

Prioritize correctness in this order:

  • Address decoding and mirrors across $D400-$D7FF.
  • Voice register layout for all three voices and correct write-only/read-only behavior.
  • Control register side effects: gate, sync, ring modulation, test, and waveform selection.
  • ADSR state transitions, envelope readback, and known envelope corner cases.
  • 24-bit oscillator phase, noise LFSR behavior, pulse width, combined waveforms, and voice 3 oscillator readback.
  • Filter cutoff/resonance/routing, $D418 mode/volume, 6581 versus 8580 differences, and sample-click/digifix behavior.
  • Paddle reads through $D419/$D41A and interaction with CIA/control port selection.

Validation Hints

For register-level bugs, create small write/read tests. For audible fidelity, compare generated samples against reSID behavior or a known-good C64 emulator with the same SID model and sample rate.

Useful local anchors:

  • thirdparties/resid/sid.cc
  • thirdparties/resid/voice.cc
  • thirdparties/resid/wave.cc
  • thirdparties/resid/envelope.cc
  • thirdparties/resid/filter.cc

レビュー

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

同じリポジトリのスキル

概要と使いどころ

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 VIC-II emulation in EMULATORS, including $D000-$D3FF register behavior, PAL/NTSC timing, raster counters, badlines, BA/AEC bus stealing, video matrix and bitmap fetches, sprites, collisions, borders, IRQs, color RAM usage, and display modes. Use when Codex reviews or edits VICII, Screen, Memory/PLA, raster, sprite, video, or cycle-level behavior for C64 classes.

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

Commnets/EMULATORS102026年10月9日 更新

Commnets のスキルをすべて見る

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