A platform-independent NES (Famicom) emulator core written in MoonBit
| 部分 | 内容 |
|---|---|
| 卡带 | iNES 解析、NES 2.0 头识别(12 位映射器号、子映射器、指数形式的 ROM 大小、RAM 大小字段)、trainer、兼容 "DiskDude!" 脏头;非法或截断的文件返回 RomError,不会崩溃 |
| CPU | 2A03(6502,无十进制模式):151 条官方指令和常见非官方指令(LAX、SAX、DCP、ISB、SLO、RLA、SRE、RRA、ANC、ALR、ARR、AXS、LAS、SHA/SHX/SHY/TAS、各类 NOP、JAM);每个周期一次总线访问,包括 dummy read/write;NMI 边沿检测、IRQ 电平触发、在倒数第二个周期采样中断、BRK/IRQ 被 NMI 劫持、同页跳转分支少采样一次 |
| PPU | 逐点推进(262 行 × 341 点);背景取数流水线和 16 位移位寄存器;loopy v/t/x/w 滚动;精灵求值(含溢出标志的斜向扫描 bug 和置位时刻);精灵 0 碰撞、优先级、左 8 像素裁剪、8×16 精灵;VBlank/NMI 时序及 $2002 读取抑制;奇数帧跳点;$2007 读缓冲;调色板镜像;开路总线衰减 |
| 映射器 | 0 NROM、1 MMC1(SxROM/SNROM/SUROM,5 位串行移位寄存器,忽略相邻周期的连续写,MMC1B 的 PRG RAM 禁用)、2 UxROM、3 CNROM |
| 其他 | 标准手柄($4016/$4017)、OAM DMA(513/514 周期)、APU 计时部分:帧计数器、帧 IRQ、四个长度计数器(不发声,见下文) |
| API | Nes::load_rom、run_frame、frame_buffer(256×240)、write_rgba、set_buttons、reset、frame_hash |
| 测试 ROM | 测什么 | 结果 |
|---|---|---|
| nestest.nes + nestest.log | 全部官方指令和非官方指令的结果、标志位、周期数;与参考日志的 8991 行逐行对比,包括内存注释和 PPU 位置 | ✅ 8991/8991 行一致 |
| instr_test-v5 01–16 | 每条指令在各寻址模式下的结果(含非官方指令) | ✅ 16/16 |
| instr_timing 1-instr_timing、2-branch_timing | 每条指令的周期数、分支的周期数 | ✅ 2/2 |
| instr_misc 01–04 | abs,X 环绕、分支环绕、dummy read(含 APU 寄存器) | ✅ 4/4 |
| cpu_dummy_reads | LDA/STA 各寻址模式产生的 dummy read 对 PPU 寄存器的副作用 | ✅ |
| cpu_interrupts_v2 1–5 | CLI 延迟、NMI 与 BRK、NMI 与 IRQ、IRQ 与 DMA、分支延迟 IRQ | ✅ 5/5 |
| 测试 ROM | 测什么 | 结果 |
|---|---|---|
| ppu_vbl_nmi 01–10 | VBL 置位/清除时刻、NMI 开关时序、$2002 抑制、奇偶帧跳点 | ✅ 10/10 |
| sprite_hit_tests_2005.10.05 01–11 | 精灵 0 碰撞:基础、对齐、角、翻转、左裁剪、右边缘、屏幕底部、8×16、时序 | ✅ 11/11 |
| sprite_overflow_tests 1–5 | 精灵溢出:基础、细节、时序、硬件 bug、模拟器常见错误 | ✅ 5/5 |
| blargg_ppu_tests_2005.09.15b palette_ram、power_up_palette、sprite_ram、vram_access | 调色板读写与镜像、上电调色板、OAM 读写、VRAM 读缓冲 | ✅ 4/4 |
| blargg_ppu_tests_2005.09.15b vbl_clear_time | VBL 在 NMI 之后约 2270 周期清除 | ❌ code 2(判定 VBL 清除得太早) |
| oam_read | $2004 读取 | ✅ |
| ppu_open_bus | PPU 开路总线及衰减 | ✅ |
| ROM | 板子 | 结果 |
|---|---|---|
| M0_P32K_C8K_V | NROM,CHR ROM | ✅ 0000 |
| M0_P32K_CR8K_V | NROM,CHR RAM | ✅ 0000 |
| M1_P128K_C32K | MMC1,CHR ROM | ✅ 0000 |
| M1_P128K_CR8K | MMC1 SNROM,CHR RAM | ✅ 0000 |
| M1_P512K_CR8K_S8K | MMC1 SUROM,512 KiB PRG | ✅ 0000 |
| M2_P128K_V、M2_P128K_CR8K_V | UxROM | ✅ 0000 ×2 |
| M3_P32K_C32K_H | CNROM | ✅ 0000 |
moon add sayoi7799/moon_nesimport {
"sayoi7799/moon_nes/nes",
"sayoi7799/moon_nes/demo",
}///|
fn main {
// Any iNES file works here, for example bytes read from disk with
// moonbitlang/x/fs. The demo ROM is built into the library.
let rom = @demo.demo_rom()
let nes = @nes.Nes::load_rom(rom) catch {
err => {
println("cannot load ROM: \{err.message()}")
return
}
}
// Player 1 holds Start during the next frame.
nes.set_buttons(0, @nes.BUTTON_START)
nes.run_frame()
// 256x240 pixels, each an NES color index; pixel_rgb turns it into 0xRRGGBB.
let frame = nes.frame_buffer()
let rgb = @nes.pixel_rgb(frame[0])
println("\{frame.length()} pixels, first pixel RGB \{rgb}")
}moon run src/examples/basic# 下载社区测试 ROM(不随仓库分发)
sh scripts/fetch-test-roms.sh
# 三个后端的测试
moon test --target js
moon test --target wasm-gc
moon test --target native
# 命令行示例:运行 nestest,与 nestest.log 逐行对照(加 -- --all 输出每一行)
moon run src/cmd/nestest
# 运行全部测试 ROM,输出 Markdown 结果表;可以加一个路径过滤词
moon run src/cmd/testroms --target native --release
moon run src/cmd/testroms --target native -- ppu_vbl
# 性能测试:无界面运行 600 帧
moon run src/cmd/bench --release --target js -- test-roms/holy-mapperel/M1_P128K_C32K.nes
# 打印某个 ROM 运行若干帧后的屏幕文字和帧哈希
moon run src/cmd/screen -- test-roms/holy-mapperel/M2_P128K_V.nes 600sh scripts/build-web.sh
python -m http.server -d web 8000src/cartridge iNES / NES 2.0 解析 → Cartridge
src/mapper Mapper trait + NROM / MMC1 / UxROM / CNROM
src/cpu CpuBus trait + 2A03 核心 + 反汇编和 nestest 格式跟踪
src/ppu 逐点 PPU
src/apu APU 计时部分(帧计数器、长度计数器)
src/bus CPU 地址空间:RAM、PPU/APU 寄存器、手柄、DMA,实现 CpuBus
src/nes 整机和对外 API、调色板、测试 ROM 判定
src/demo 迷你 6502 汇编器 + 自制演示 ROM
src/examples/basic README 里的最小使用示例
src/web 浏览器前端(只编译到 js)
src/cmd/* nestest、testroms、bench、screen 命令行工具
web/ 页面Install
Download zipA platform-independent NES (Famicom) emulator core written in MoonBit