尧图网页设计 
简介一款用C语言编写的NES任天堂红白机模拟器源码项目面向对模拟器原理、C语言底层开发以及经典游戏机硬件模拟感兴趣的中级开发者。项目模块划分清晰源码以10个头文件和5个C文件为核心覆盖总线、NES类型定义、启动入口等关键部分并提供include/nes.h与lib/libnes.a形式的简洁API方便外部程序调用。工程已在GNU/Linux下通过GCC与Clang两种编译器测试允许release/debug两种构建模式依赖SDL2库完成音视频输出配套3个makefile便于不同场景下构建。压缩包共23个文件除核心代码外还包含说明文档、许可证及GitHub Actions工作流文件整体体积仅28KB轻量精炼非常适合用于教学演示或作为入门级模拟器的自学素材。目前已有850人浏览学习适合想通过实战阅读理解CPU指令执行、内存映射等模拟器关键技术的开发者。 把“超级马里奥兄弟”的标题画面真正跑起来那一刻我盯着窗口愣了好几秒。一个用C语言从零写出来的NES模拟器从6502 CPU取指、PPU渲染到手柄输入全是我自己一行行敲出来的那种成就感比小时候打通关还上头。这个项目一句话概括就是用C语言实现一个能在现代设备上运行的NES模拟器。它不只是“能玩”而是把整台红白机里的CPU、PPU图像处理器、APU音频、卡带映射器全部模拟一遍最终在普通电脑窗口里稳定跑游戏后续还移植到了ESP32单片机上。如果你熟悉C语言基础但不知道它能往哪用如果你一直好奇“游戏主机是怎么把画面跑出来的”或者你想给嵌入式开发板找个有分量的练手项目这篇笔记会给你一条完整路线还有我从坑里爬出来的全过程。1. 为什么我会用纯C去碰这个“老古董”1.1 这件事解决的不只是“能玩”说实话网上现成的NES模拟器一堆直接下载就能玩根本不用自己写。我坚持写一个是因为模拟器几乎是系统编程的终极练习题——设备规模不大但五脏俱全CPU、内存映射、中断、DMA、输入、画面、声音一台机器把计算机组成原理里的东西全占了。NES的主频只有1.79MHz内存只有2KB可就是因为简单它的每一个细节都值得亲手扣一遍。写完这个项目你再去看Linux的设备树、驱动或者单片机固件会觉得这些“复杂家伙”也没那么神秘了因为它们底层的套路都是从这类简单机器演化来的。1.2 C语言在这个场景里占尽了便宜选C不是因为别的语言不行而是这个项目里C几乎是为NES量身定做的指针和数组天然对应地址总线读写某个内存地址就是一次函数调用思路完全不用绕弯。位运算在解析PPU寄存器、mapper状态、手柄数据时是无价的C的 | 用起来没有任何运行时开销。C没有运行时依赖写出来的核心模块可以直接交叉编译到ESP32、STM32这类单片机。大量现成的模拟器参考源码都是C写的遇到瓶颈时可以对照查思路语言同构意味着没有“翻译损耗”。相比C的模板和Rust的所有权检查C反而让这个项目回到了最本质的层面你只需要关心地址、字节和周期。1.3 项目适合谁照着搞一遍我是认真的这个项目比刷一百道算法题更能训练工程能力。适合的人群大概是已经学完C语言指针、结构体、位运算但缺一个“真正拿得出手”项目的人想理解模拟器原理、甚至未来想写GBA或街机模拟器的爱好者嵌入式开发人员想找一个能榨干开发板性能的图形密集型任务纯粹想怀旧想亲手“复刻”童年的人——这层动力千万别小看它能支撑你熬过最枯燥的调试阶段。2. 拆开一台红白机6502、PPU和总线的三角关系2.1 6502 CPU按地址取指按周期执行NES的CPU是Ricoh 2A03本质是一颗6502的定制版。它有几个特点8位累加器A、两个8位变址寄存器X和Y、一个16位程序计数器PC、一个栈指针SP外加N、V、Z、C等状态标志。6502的寻址方式非常多从隐含寻址、立即数到绝对变址间接寻址都有一条指令往往对应好几条不同寻址方式的变体。6502的十进制模式在2A03上被砍了ADC和SBC根本不做BCD调整这点写模拟器时可以省事。但真正麻烦的是周期计数每条指令执行需要2到7个CPU周期不等而PPU时钟又是CPU的三倍。如果你周期算错整个游戏的运行速度、音乐节奏全都会歪掉。我当时的核心执行函数长这样int exec6502(uint8_t opcode) { switch (opcode) { case 0xA9: // LDA #imm A bus_read(pc); set_flag(N, A 0x80); set_flag(Z, A 0); return 2; case 0x8D: // STA addr bus_write(fetch16(), A); return 4; // ... 其余指令 } return 0; }用switch而不是查函数指针表刚开始调试时最直观。等指令全部跑通再考虑性能优化也不迟。2.2 PPU真正的像素工程师PPU在NES里是独立于CPU的芯片专门管画面。它能显示256x240的画面内部有自己的一套显存由$2000到$2007这几个寄存器控制。PPU的渲染管线可以拆成三层名称表Name Table决定屏幕上每个格子显示哪个“图块”。属性表Attribute Table决定每4x4个图块整体用哪个调色板。图案表Pattern Table真正存储每个8x8图块的像素数据黑白两套位平面拼出2位颜色索引再配合调色板变成具体颜色。PPU一帧有262条扫描线第0到239行是可见画面之后进入VBlank垂直消隐期这是游戏代码更新精灵和滚动的重要时间段。240到260行时CPU没事干游戏全在等NMI中断模拟器也得把这个时序模拟出来否则游戏逻辑会乱。2.3 内存映射为什么0x2000到0x2007反复出现新手最容易懵的是明明只有几个PPU寄存器为什么$2000到$3FFF到处都是它们因为NES的总线没有完整解码地址高位地址线被偷懒了导致寄存器每8个字节就镜像一次。模拟器不需要处理得跟硬件一模一样但至少要让读写这些镜像地址时行为一致。CPU侧的内存映射大概是这样的地址范围内容$0000 - $07FF2KB内部RAM含零页和栈区$0800 - $1FFF内部RAM镜像每2KB重复$2000 - $3FFFPPU寄存器每8字节重复$4000 - $401FAPU音频、手柄、DMA$4020 - $5FFF扩展ROM区$6000 - $7FFF卡带里的SRAM存档数据所在$8000 - $FFFF卡带PRG ROM游戏代码本体写模拟器时总线就是一个switch分支函数uint8_t bus_read(uint16_t addr) { if (addr 0x2000) return ram[addr 0x07FF]; if (addr 0x4000) return ppu_read_register(0x2000 (addr 0x0007)); if (addr 0x4016 addr 0x4017) return controller_read(addr - 0x4016); if (addr 0x8000) return mapper_read_prg(addr); // ... }这句话值得记住“读一个地址可能触发副作用。”比如读$2002会清除VBlank标志写$2006会切换PPU地址高低字节。所以内存不是数组是一组有行为的寄存器堆。3. 选型与工程化先把模拟器“立”起来3.1 构建工具链和工程目录我的开发环境是VSCode加GCC加Makefile跑在Linux/WSL里。Windows用户记得先把MinGW-w64装好再把VSCode的C/C插件配好否则编译到一半报缺头文件非常打击热情。工程目录分得越清楚后面越不会乱nes/ ├── main.c # 程序入口SDL2窗口循环 ├── bus.c/h # CPU总线读写内存映射 ├── cpu.c/h # 6502核心 ├── ppu.c/h # PPU渲染 ├── mapper.c/h # 卡带映射器NROM/MMC1/MMC3 ├── input.c/h # 手柄 ├── apu.c/h # 音频后期加 └── rom.c/h # iNES文件解析Makefile也很简单OBJS main.o bus.o cpu.o ppu.o mapper.o input.o rom.o apu.o TARGET nes $(TARGET): $(OBJS) cc -o $ $^ sdl2-config --cflags --libs %.o: %.c cc -O2 -g -Wall -stdc11 -c $ -o $ clean: rm -f $(TARGET) *.o编译选项里-g建议保留后面调试会用GDB直接看变量比到处写printf高效得多。3.2 为什么我一开始不上SDL2很多初学者第一步就是想“显示画面”但我建议反过来先把CPU和总线搭起来用日志验证正确性最后再加图形层。我最终的架构是“核心与前端分离”cpu、ppu、mapper这些模块完全不含SDL2的东西全部是纯C逻辑只有main.c负责SDL2窗口、渲染纹理和手柄事件。这样的好处是核心代码后面几乎原封不动地编译到了ESP32上只是把前端从SDL2换成了VGA输出这波“白嫖”全靠在最开始忍住没把SDL2到处乱塞。SDL2的角色只是一个“显示器”——每帧给我一块256x240的像素缓冲我往里填颜色就行。它顺便还能处理手柄和音频省掉我另写一套输入输出的功夫。3.3 第一个能跑的骨架先让CPU通过测试再说我的实现顺序是先写bus_read/bus_write和6502全部指令加载一个叫nestest.nes的CPU测试ROM把每条指令执行后的寄存器状态、栈指针、周期数输出到文件和网上公开的标准日志逐行对比直到完全一致通过后再开始碰PPU渲染不然画面歪了都不知道是CPU的锅还是PPU的锅。这个阶段没有任何画面只有滚动的日志。但当我看到PC寄存器从0xC000一路跑下去、和参考日志完全对齐时心里踏实得不行CPU这块地基稳了后面往上盖楼才敢用劲。4. 核心实现iNES解析、PPU渲染和手柄输入的落地点4.1 iNES头部16个字节里有半个宇宙现在市面上的ROM绝大多数是iNES格式头部固定16字节。我最开始只拿到了一个结构体就往前冲结果在mapper识别上翻了车typedef struct { uint8_t magic[4]; // NES\x1A uint8_t prg_banks; // PRG ROM16KB为单位 uint8_t chr_banks; // CHR ROM8KB为单位 uint8_t flags6; // bit0镜像bit1-SRAMbit2-训练器bit4-7 mapper低4位 uint8_t flags7; // bit4-7 mapper高4位 uint8_t flags8; // PRG-RAM大小等 uint8_t flags9; // 电视制式等 uint8_t flags10; // 保留 uint8_t pad[5]; } ines_header;这里必须要说清楚mapper编号是flags6的高4位加上flags7的高4位拼出来的一个8位数字不是直接读哪个字节。很多刚入门的人就在这里开始Debug结果加载魂斗罗直接花屏。我的建议是先从NROMmapper 0开始它是纯线性地址映射不需要切换bank可以先跑通一整条渲染链路再上MMC1和MMC3。4.2 名称表、属性表和调色板的地址游戏PPU渲染最考验地址计算能力。一个背景图块在屏幕上的位置是(tile本文还有配套的精品资源点击获取 用C语言从零写出NES模拟器：6502 CPU与PPU渲染如何协同工作
简介一款用C语言编写的NES任天堂红白机模拟器源码项目面向对模拟器原理、C语言底层开发以及经典游戏机硬件模拟感兴趣的中级开发者。项目模块划分清晰源码以10个头文件和5个C文件为核心覆盖总线、NES类型定义、启动入口等关键部分并提供include/nes.h与lib/libnes.a形式的简洁API方便外部程序调用。工程已在GNU/Linux下通过GCC与Clang两种编译器测试允许release/debug两种构建模式依赖SDL2库完成音视频输出配套3个makefile便于不同场景下构建。压缩包共23个文件除核心代码外还包含说明文档、许可证及GitHub Actions工作流文件整体体积仅28KB轻量精炼非常适合用于教学演示或作为入门级模拟器的自学素材。目前已有850人浏览学习适合想通过实战阅读理解CPU指令执行、内存映射等模拟器关键技术的开发者。 把“超级马里奥兄弟”的标题画面真正跑起来那一刻我盯着窗口愣了好几秒。一个用C语言从零写出来的NES模拟器从6502 CPU取指、PPU渲染到手柄输入全是我自己一行行敲出来的那种成就感比小时候打通关还上头。这个项目一句话概括就是用C语言实现一个能在现代设备上运行的NES模拟器。它不只是“能玩”而是把整台红白机里的CPU、PPU图像处理器、APU音频、卡带映射器全部模拟一遍最终在普通电脑窗口里稳定跑游戏后续还移植到了ESP32单片机上。如果你熟悉C语言基础但不知道它能往哪用如果你一直好奇“游戏主机是怎么把画面跑出来的”或者你想给嵌入式开发板找个有分量的练手项目这篇笔记会给你一条完整路线还有我从坑里爬出来的全过程。1. 为什么我会用纯C去碰这个“老古董”1.1 这件事解决的不只是“能玩”说实话网上现成的NES模拟器一堆直接下载就能玩根本不用自己写。我坚持写一个是因为模拟器几乎是系统编程的终极练习题——设备规模不大但五脏俱全CPU、内存映射、中断、DMA、输入、画面、声音一台机器把计算机组成原理里的东西全占了。NES的主频只有1.79MHz内存只有2KB可就是因为简单它的每一个细节都值得亲手扣一遍。写完这个项目你再去看Linux的设备树、驱动或者单片机固件会觉得这些“复杂家伙”也没那么神秘了因为它们底层的套路都是从这类简单机器演化来的。1.2 C语言在这个场景里占尽了便宜选C不是因为别的语言不行而是这个项目里C几乎是为NES量身定做的指针和数组天然对应地址总线读写某个内存地址就是一次函数调用思路完全不用绕弯。位运算在解析PPU寄存器、mapper状态、手柄数据时是无价的C的 | 用起来没有任何运行时开销。C没有运行时依赖写出来的核心模块可以直接交叉编译到ESP32、STM32这类单片机。大量现成的模拟器参考源码都是C写的遇到瓶颈时可以对照查思路语言同构意味着没有“翻译损耗”。相比C的模板和Rust的所有权检查C反而让这个项目回到了最本质的层面你只需要关心地址、字节和周期。1.3 项目适合谁照着搞一遍我是认真的这个项目比刷一百道算法题更能训练工程能力。适合的人群大概是已经学完C语言指针、结构体、位运算但缺一个“真正拿得出手”项目的人想理解模拟器原理、甚至未来想写GBA或街机模拟器的爱好者嵌入式开发人员想找一个能榨干开发板性能的图形密集型任务纯粹想怀旧想亲手“复刻”童年的人——这层动力千万别小看它能支撑你熬过最枯燥的调试阶段。2. 拆开一台红白机6502、PPU和总线的三角关系2.1 6502 CPU按地址取指按周期执行NES的CPU是Ricoh 2A03本质是一颗6502的定制版。它有几个特点8位累加器A、两个8位变址寄存器X和Y、一个16位程序计数器PC、一个栈指针SP外加N、V、Z、C等状态标志。6502的寻址方式非常多从隐含寻址、立即数到绝对变址间接寻址都有一条指令往往对应好几条不同寻址方式的变体。6502的十进制模式在2A03上被砍了ADC和SBC根本不做BCD调整这点写模拟器时可以省事。但真正麻烦的是周期计数每条指令执行需要2到7个CPU周期不等而PPU时钟又是CPU的三倍。如果你周期算错整个游戏的运行速度、音乐节奏全都会歪掉。我当时的核心执行函数长这样int exec6502(uint8_t opcode) { switch (opcode) { case 0xA9: // LDA #imm A bus_read(pc); set_flag(N, A 0x80); set_flag(Z, A 0); return 2; case 0x8D: // STA addr bus_write(fetch16(), A); return 4; // ... 其余指令 } return 0; }用switch而不是查函数指针表刚开始调试时最直观。等指令全部跑通再考虑性能优化也不迟。2.2 PPU真正的像素工程师PPU在NES里是独立于CPU的芯片专门管画面。它能显示256x240的画面内部有自己的一套显存由$2000到$2007这几个寄存器控制。PPU的渲染管线可以拆成三层名称表Name Table决定屏幕上每个格子显示哪个“图块”。属性表Attribute Table决定每4x4个图块整体用哪个调色板。图案表Pattern Table真正存储每个8x8图块的像素数据黑白两套位平面拼出2位颜色索引再配合调色板变成具体颜色。PPU一帧有262条扫描线第0到239行是可见画面之后进入VBlank垂直消隐期这是游戏代码更新精灵和滚动的重要时间段。240到260行时CPU没事干游戏全在等NMI中断模拟器也得把这个时序模拟出来否则游戏逻辑会乱。2.3 内存映射为什么0x2000到0x2007反复出现新手最容易懵的是明明只有几个PPU寄存器为什么$2000到$3FFF到处都是它们因为NES的总线没有完整解码地址高位地址线被偷懒了导致寄存器每8个字节就镜像一次。模拟器不需要处理得跟硬件一模一样但至少要让读写这些镜像地址时行为一致。CPU侧的内存映射大概是这样的地址范围内容$0000 - $07FF2KB内部RAM含零页和栈区$0800 - $1FFF内部RAM镜像每2KB重复$2000 - $3FFFPPU寄存器每8字节重复$4000 - $401FAPU音频、手柄、DMA$4020 - $5FFF扩展ROM区$6000 - $7FFF卡带里的SRAM存档数据所在$8000 - $FFFF卡带PRG ROM游戏代码本体写模拟器时总线就是一个switch分支函数uint8_t bus_read(uint16_t addr) { if (addr 0x2000) return ram[addr 0x07FF]; if (addr 0x4000) return ppu_read_register(0x2000 (addr 0x0007)); if (addr 0x4016 addr 0x4017) return controller_read(addr - 0x4016); if (addr 0x8000) return mapper_read_prg(addr); // ... }这句话值得记住“读一个地址可能触发副作用。”比如读$2002会清除VBlank标志写$2006会切换PPU地址高低字节。所以内存不是数组是一组有行为的寄存器堆。3. 选型与工程化先把模拟器“立”起来3.1 构建工具链和工程目录我的开发环境是VSCode加GCC加Makefile跑在Linux/WSL里。Windows用户记得先把MinGW-w64装好再把VSCode的C/C插件配好否则编译到一半报缺头文件非常打击热情。工程目录分得越清楚后面越不会乱nes/ ├── main.c # 程序入口SDL2窗口循环 ├── bus.c/h # CPU总线读写内存映射 ├── cpu.c/h # 6502核心 ├── ppu.c/h # PPU渲染 ├── mapper.c/h # 卡带映射器NROM/MMC1/MMC3 ├── input.c/h # 手柄 ├── apu.c/h # 音频后期加 └── rom.c/h # iNES文件解析Makefile也很简单OBJS main.o bus.o cpu.o ppu.o mapper.o input.o rom.o apu.o TARGET nes $(TARGET): $(OBJS) cc -o $ $^ sdl2-config --cflags --libs %.o: %.c cc -O2 -g -Wall -stdc11 -c $ -o $ clean: rm -f $(TARGET) *.o编译选项里-g建议保留后面调试会用GDB直接看变量比到处写printf高效得多。3.2 为什么我一开始不上SDL2很多初学者第一步就是想“显示画面”但我建议反过来先把CPU和总线搭起来用日志验证正确性最后再加图形层。我最终的架构是“核心与前端分离”cpu、ppu、mapper这些模块完全不含SDL2的东西全部是纯C逻辑只有main.c负责SDL2窗口、渲染纹理和手柄事件。这样的好处是核心代码后面几乎原封不动地编译到了ESP32上只是把前端从SDL2换成了VGA输出这波“白嫖”全靠在最开始忍住没把SDL2到处乱塞。SDL2的角色只是一个“显示器”——每帧给我一块256x240的像素缓冲我往里填颜色就行。它顺便还能处理手柄和音频省掉我另写一套输入输出的功夫。3.3 第一个能跑的骨架先让CPU通过测试再说我的实现顺序是先写bus_read/bus_write和6502全部指令加载一个叫nestest.nes的CPU测试ROM把每条指令执行后的寄存器状态、栈指针、周期数输出到文件和网上公开的标准日志逐行对比直到完全一致通过后再开始碰PPU渲染不然画面歪了都不知道是CPU的锅还是PPU的锅。这个阶段没有任何画面只有滚动的日志。但当我看到PC寄存器从0xC000一路跑下去、和参考日志完全对齐时心里踏实得不行CPU这块地基稳了后面往上盖楼才敢用劲。4. 核心实现iNES解析、PPU渲染和手柄输入的落地点4.1 iNES头部16个字节里有半个宇宙现在市面上的ROM绝大多数是iNES格式头部固定16字节。我最开始只拿到了一个结构体就往前冲结果在mapper识别上翻了车typedef struct { uint8_t magic[4]; // NES\x1A uint8_t prg_banks; // PRG ROM16KB为单位 uint8_t chr_banks; // CHR ROM8KB为单位 uint8_t flags6; // bit0镜像bit1-SRAMbit2-训练器bit4-7 mapper低4位 uint8_t flags7; // bit4-7 mapper高4位 uint8_t flags8; // PRG-RAM大小等 uint8_t flags9; // 电视制式等 uint8_t flags10; // 保留 uint8_t pad[5]; } ines_header;这里必须要说清楚mapper编号是flags6的高4位加上flags7的高4位拼出来的一个8位数字不是直接读哪个字节。很多刚入门的人就在这里开始Debug结果加载魂斗罗直接花屏。我的建议是先从NROMmapper 0开始它是纯线性地址映射不需要切换bank可以先跑通一整条渲染链路再上MMC1和MMC3。4.2 名称表、属性表和调色板的地址游戏PPU渲染最考验地址计算能力。一个背景图块在屏幕上的位置是(tile本文还有配套的精品资源点击获取