c64-cia-audit

Étoiles9

Forks0

Mis à jour20 juin 2026 à 09:18

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.

Installation

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Source

Commnets

Commnets/EMULATORS

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Métiers associésSOC

Basé sur la classification professionnelle SOC

Développeurs de logicielsProfessions informatiques et mathématiques·SOC 15-1252

Explorateur de fichiers

3 fichiers

SKILL.md

readonly

name

c64-cia-audit

description

C64 CIA Audit

Core Workflow

Use this skill to audit whether the two C64 CIA chips behave like 6526 devices in their C64 wiring context.

Read references/cia.md before making claims or edits.
Inspect the local implementation paths first:
- include/COMMODORE/CIA/CIA.hpp, src/COMMODORE/CIA/CIA.cpp
- include/COMMODORE/CIA/CIARegisters.hpp, src/COMMODORE/CIA/CIARegisters.cpp
- include/COMMODORE/CIA/CIATimer.hpp, src/COMMODORE/CIA/CIATimer.cpp
- include/COMMODORE/CIA/CIAClock.hpp, src/COMMODORE/CIA/CIAClock.cpp
- include/COMMODORE/CIA/CIASerialPort.hpp, src/COMMODORE/CIA/CIASerialPort.cpp
- include/C64/CIA1*, src/C64/CIA1*, include/C64/CIA2*, src/C64/CIA2*
- include/C64/SerialPort.hpp, src/C64/SerialPort.cpp
When changing C++ code, also use $emulators-framework-cpp-style.
Separate generic 6526 behavior from C64-specific wiring. CIA1 and CIA2 are the same chip but expose different system effects.
For each finding, identify the exact register, bit, read/write side effect, interrupt line, and expected cycle/timer consequence.

Audit Priorities

Prioritize correctness in this order:

Port read/write and DDR behavior, including active-low keyboard/joystick/IEC lines.
CIA1 wiring: keyboard matrix, joystick ports, paddles/control port selection, datasette FLAG, and IRQ output.
CIA2 wiring: VIC bank selection on PA0/PA1, IEC/user-port/RS-232 lines, and NMI output.
Timer A/B latch/counter load behavior, underflow reload, one-shot/continuous mode, force-load, CNT counting, and Timer B count sources.
ICR read-clear behavior and bit 7 set/clear mask semantics.
TOD BCD clock, alarm selection, 50/60 Hz selection, halt/latch behavior, and AM/PM bit.
Serial shift register and FLAG edge semantics.

Validation Hints

Useful local assets:

docs/C64Data/CIA1Logic.xlsx
emulators/C64Programs/Code/Macros/MCIAS.asm
emulators/C64Programs/Code/Tests/TESTCIA1.asm
emulators/C64Programs/Code/Tests/TESTCIA1IRQ.asm
emulators/C64Programs/Code/Tests/TESTCIA2NMI.asm
emulators/C64Programs/Code/Tests/TESTKEYBOARD.asm
emulators/C64Programs/Code/Tests/TESTKEYBOARDIRQ.asm

Timer regressions are easiest to catch with minimal assembly programs that count IRQ/NMI firings or observe PB6/PB7 transitions.

Plus depuis ce dépôt

même dépôt

emulators-debug-log-audit

Commnets/EMULATORS

Parse and interpret execution debug logs generated by the EMULATORS framework, correlating each CPU instruction block with its VIC-II, CIA, SID, interrupt, stop, raster, badline, and memory-access cycles. Use for .LOG traces from EMULATORS when diagnosing cycle timing, raster effects, CPU stalls, IRQ/NMI entry, instruction/chip synchronization, or when reconstructing execution around a PC or mapped register.

2026-07-249

emulators-fmt-audit

Commnets/EMULATORS

Build, audit, and modify EMULATORS runtime `.fmt` formatter files and keep them synchronized with C++ `getInfoStructure()` producers and their `.hpp` field documentation. Use when adding, renaming, or removing `InfoStructure` attributes or nested structures; diagnosing missing console fields; reviewing formatter includes, formatter names, placeholders, arrays, nested invocations, or table parameters; or changing namespace-specific `.fmt` files under `projects`.

2026-07-249

emulators-framework-cpp-style

Commnets/EMULATORS

Apply the local C++ coding conventions of the EMULATORS framework. Use when Codex adds, edits, reviews, or scaffolds C++ code in this repository, especially new classes, headers, cpp files, CORE/COMMODORE module code, emulator components, registers, chips, memory, sound, IO, commands, or InfoClass-derived objects.

2026-07-049

c64-mps801-printer-audit

Commnets/EMULATORS

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.

2026-07-049

c64-mps802-printer-audit

Commnets/EMULATORS

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.

2026-07-049

c64-1541-audit

Commnets/EMULATORS

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.

2026-06-289

name

c64-cia-audit

description

C64 CIA Audit

Core Workflow

Use this skill to audit whether the two C64 CIA chips behave like 6526 devices in their C64 wiring context.

Read references/cia.md before making claims or edits.
Inspect the local implementation paths first:
- include/COMMODORE/CIA/CIA.hpp, src/COMMODORE/CIA/CIA.cpp
- include/COMMODORE/CIA/CIARegisters.hpp, src/COMMODORE/CIA/CIARegisters.cpp
- include/COMMODORE/CIA/CIATimer.hpp, src/COMMODORE/CIA/CIATimer.cpp
- include/COMMODORE/CIA/CIAClock.hpp, src/COMMODORE/CIA/CIAClock.cpp
- include/COMMODORE/CIA/CIASerialPort.hpp, src/COMMODORE/CIA/CIASerialPort.cpp
- include/C64/CIA1*, src/C64/CIA1*, include/C64/CIA2*, src/C64/CIA2*
- include/C64/SerialPort.hpp, src/C64/SerialPort.cpp
When changing C++ code, also use $emulators-framework-cpp-style.
Separate generic 6526 behavior from C64-specific wiring. CIA1 and CIA2 are the same chip but expose different system effects.
For each finding, identify the exact register, bit, read/write side effect, interrupt line, and expected cycle/timer consequence.

Audit Priorities

Prioritize correctness in this order:

Port read/write and DDR behavior, including active-low keyboard/joystick/IEC lines.
CIA1 wiring: keyboard matrix, joystick ports, paddles/control port selection, datasette FLAG, and IRQ output.
CIA2 wiring: VIC bank selection on PA0/PA1, IEC/user-port/RS-232 lines, and NMI output.
Timer A/B latch/counter load behavior, underflow reload, one-shot/continuous mode, force-load, CNT counting, and Timer B count sources.
ICR read-clear behavior and bit 7 set/clear mask semantics.
TOD BCD clock, alarm selection, 50/60 Hz selection, halt/latch behavior, and AM/PM bit.
Serial shift register and FLAG edge semantics.

Validation Hints

Useful local assets:

docs/C64Data/CIA1Logic.xlsx
emulators/C64Programs/Code/Macros/MCIAS.asm
emulators/C64Programs/Code/Tests/TESTCIA1.asm
emulators/C64Programs/Code/Tests/TESTCIA1IRQ.asm
emulators/C64Programs/Code/Tests/TESTCIA2NMI.asm
emulators/C64Programs/Code/Tests/TESTKEYBOARD.asm
emulators/C64Programs/Code/Tests/TESTKEYBOARDIRQ.asm

Timer regressions are easiest to catch with minimal assembly programs that count IRQ/NMI firings or observe PB6/PB7 transitions.