免费在 GitHub 公开

msx-memory-map-audit

Validate MSX memory mapping in EMULATORS, including 16 KB pages, primary slot selection through PPI port

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

Commnets/EMULATORS

查看安装方法

包含的文件（3）

SKILL.md2.8 KB
agents/openai.yaml239 B
references/memory-map.md6.8 KB

SKILL.md（原文）

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

MSX Memory Map Audit

Core Workflow

Use this skill to audit whether EMULATORS presents the same CPU-visible memory as a real MSX slot system.

Read references/memory-map.md before making claims or edits.
Inspect the relevant implementation paths first:
- include/MSX/Memory.hpp, src/MSX/Memory.cpp
- include/MSX/Model.hpp, src/MSX/Model.cpp
- include/MSX/PPI8255.hpp, src/MSX/PPI8255.cpp
- include/MSX/PPI8255Registers.hpp, src/MSX/PPI8255Registers.cpp
- include/MSX/PortManager.hpp, src/MSX/PortManager.cpp
- include/MSX/MSX.hpp, src/MSX/MSX.cpp
- emulators/MSXEmulator*/bios/*.rom
When changing C++ code, also use $emulators-framework-cpp-style.
Separate primary slot selection, secondary slot selection, and mapper segment selection. They are related but not interchangeable.
For findings, cite the address page, selected primary slot, selected secondary slot if expanded, expected storage, and the class or method that violates it.

Audit Priorities

Prioritize correctness in this order:

#A8 primary slot register bit-pair decode for all four 16 KB pages.
Expanded slot support: per-primary-slot subslot registers, #FFFF access only through selected page 3, and inverted readback.
BIOS slot ID handling for RDSLT, WRSLT, CALSLT, ENASLT, RSLREG, and WSLREG compatibility.
Correct placement of BIOS, BASIC, cartridges, RAM, and empty slots by model.
Preservation/restoration of page 3 when code accesses a secondary slot register.
Memory mapper ports #FC-#FF, write-only/unreliable read behavior, and per-mapper segment copies.
Empty/open slot behavior documented and consistent across read/write paths.

Validation Hints

Prefer narrow address-decoder tests:

Write/read #A8 and verify each page maps the intended primary slot.
For each expanded slot, select its primary in page 3, write #FFFF, read back the complemented value, and verify all four pages use the right subslot.
Verify BIOS slot routines keep interrupts/page selection safe enough for the boot ROM.
If mapper RAM exists, write distinct bytes into segments through #FC-#FF and check aliasing/repetition.

For emulator-level checks, compare with the BIOS ROMs in emulators/MSXEmulator*/bios and use small Z80 programs before relying on large cartridges.

评价

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

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

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

同一仓库的技能

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.

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