跳到正文
cccskills
免费在 GitHub 公开

emulators-io-builder

Implement machine input/output, I/O port decoding, external buses, host input adapters, storage and media devices, and peripherals in EMULATORS. Use when adding keyboard matrices, joysticks, controllers, cassette, cartridge, disk, printer, serial or parallel interfaces, protocol state machines, PortManager behavior, or deterministic host-to-emulated-device integration.

中文简介正在准备中。当前显示原文说明。

Commnets/EMULATORS
查看安装方法

包含的文件（3）

  • SKILL.md2.6 KB
  • agents/openai.yaml219 B
  • references/io-contract.md1.1 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

Build EMULATORS I/O

When compiling, testing, or executing on Windows, use $emulators-windows-build-runtime.

Required Context

  1. Read references/io-contract.md.
  2. Read .codex/skills/emulators-new-machine/references/workspace-artifacts.md. Store completed I/O contracts, protocol plans, and other code-generation support in the active .codex/work/ scope, never in docs/.
  3. Inspect the nearest PortManager, input device, peripheral simulation, media handler, and host adapter independently.
  4. Read the active machine specification from $emulators-new-machine when working on a new system.
  5. Use $emulators-framework-cpp-style for C++ changes. Use matching disk, printer, CIA, PPI, or system audit skills when available.

Layering Model

Keep machine interface, deterministic device simulation, media format, and host adapter as separate layers. Do not let host events mutate CPU-visible state without passing through the emulated interface and its sampling rules.

Workflow

  1. Define addresses or selectors, line polarity, direction, pull-up/floating behavior, reset state, handshakes, sampling edges, clocks, interrupts, errors, and disconnect behavior.
  2. Determine whether the interface, device, protocol, or media format already exists. Reuse each layer independently; use adapters for different board wiring.
  3. Specify the protocol state machine and observable transitions before implementing it.
  4. Implement port decoding and device state with deterministic inputs. Queue or latch host input according to emulated sampling time.
  5. Validate contention, simultaneous drivers, absent devices, short transfers, aborts, timeouts, EOF, write protection, corrupt media, and hot-plug behavior when applicable.
  6. Keep file parsing and media mutation bounded against malformed sizes, chains, and counts.
  7. Add isolated tests for decoding and protocol transitions, then a machine-level program or command test.
  8. Verify that save/load, reset, and reconnection do not leave stale host or protocol state.

Completion Evidence

Report implemented layers, port or bus map, timing and polarity assumptions, supported devices/media, negative-path tests, host dependencies, and unsupported protocol behavior.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护，适用 Google 的隐私权政策和服务条款。

同一仓库的技能

c64-1541-audit

免费

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月18日 更新

c64-cia-audit

免费

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月18日 更新

c64-memory-map-audit

免费

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月18日 更新

c64-mps801-printer-audit

免费

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月18日 更新

c64-mps802-printer-audit

免费

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月18日 更新

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.

中文简介正在准备中。当前显示原文说明。

Commnets/EMULATORS102026年10月18日 更新

查看 Commnets 的全部技能

报告此技能的问题