将红白机（NES）《超级马力欧兄弟》（Super Mario Bros）移植到 UEFI Shell 环境下运行。图形输出使用 UEFI GOP（Graphics Output Protocol），纯软件渲染，无音频依赖。可在 QEMU + OVMF 或真机 UEFI Shell 下运行。

本项目基于 nukep/smb-vanilla-port 的 C/C++ 反编译代码进行移植。原始项目将 NES 6502 汇编反编译为现代 C 代码，保留原始游戏逻辑的精确行为（包括 Bug）。

1. ROM 数据与代码分离：从 iNES 格式 ROM 中剥离出 prg.bin（32KB 游戏数据表）和 chr.bin（8KB 图形 tile），去除有版权的 16 字节 iNES 头。两个纯数据文件编译时嵌入，代码仓库不含任何任天堂版权数据。

2. UEFI 协议驱动：基于最小化 UEFI 类型定义（不依赖 EDK2/gnu-efi SDK），使用 GOP 帧缓冲直接渲染、SimpleTextIn 轮询键盘、定时器事件驱动帧率。

3. 双缓冲渲染：256×240 像素先绘制到后台缓冲区，帧结束时通过 nearest-neighbor 整数缩放到 GOP 帧缓冲，消除画面撕裂。

4. 关键 Bug 修复：修复了 DrawSpriteObject 中的水平翻转实现——原反编译代码的 tile 数据索引使用了翻转后的坐标（导致像素顺序未真正镜像），现已与 NES PPU 行为一致。

• QEMU（已包含 OVMF 固件于 share/edk2-x86_64-code.fd）
• Visual Studio 2019/2022 含 C++ 桌面开发工具

cd uefi
build.bat

产物：build/smb.efi（同步到 uefi/smb.efi）

qemu-system-x86_64 \
  -drive if=pflash,format=raw,file=/path/to/edk2-x86_64-code.fd \
  -drive file=fat:rw:uefi,format=raw \
  -m 256 -net none -serial stdio -display sdl

UEFI Shell 启动后自动执行 startup.nsh 进入游戏。

uefi/
├── uefi_types.h        # UEFI 类型定义（GOP/File/Input/Boot Services）
├── uefi_compat.h/.c    # C 标准库兼容层（memset/printf/sscanf 等）
├── uefi_render.h/.c    # GOP 软件渲染器（双缓冲 + 整数缩放）
├── uefi_input.h/.c     # 键盘输入（定时器 + WaitForEvent 非阻塞）
├── uefi_rom.h/.c       # ROM 数据访问（内存嵌入 + 文件回退）
├── uefi_debug.h/.c     # 串口调试输出（COM1 0x3F8）
├── uefi_main.c         # 入口 + 游戏主循环
├── embedded_rom.c      # prg.bin + chr.bin 编译时嵌入
├── build.bat           # MSVC 构建脚本
├── Makefile            # clang 构建规则
├── startup.nsh         # UEFI Shell 自动启动脚本
├── prg.bin             # PRG-ROM 数据表（32KB）
└── chr.bin             # CHR-ROM 图案表（8KB）

• 本项目游戏逻辑代码继承自 nukep/smb-vanilla-port
• 本仓库不包含任天堂的版权数据（ROM 文件）。构建需要用户自行提供合法的 smb.nes，工具链从中提取无版权的纯数据表（PRG/CHR .bin 文件）
• UEFI 前端代码为原创实现，欢迎自由使用和修改

A port of the NES classic "Super Mario Bros" to the UEFI Shell environment. Uses UEFI GOP for graphics, pure software rendering, no audio. Runs on QEMU + OVMF or bare-metal UEFI systems.

Based on the C/C++ decompilation from nukep/smb-vanilla-port, which reverse-engineered the NES 6502 assembly into modern C code while preserving exact game behavior (bugs included).

• IP-safe ROM handling: PRG-ROM and CHR-ROM extracted as bare .bin files without the copyrighted iNES header. No Nintendo data in this repository.
• UEFI-native: Zero-dependency UEFI type definitions — no EDK2 or gnu-efi SDK required
• Double buffering: Eliminates screen tearing via back-buffer → GOP framebuffer flush with integer nearest-neighbor scaling
• Bug fix: Corrected horizontal sprite flipping in the rendering pipeline (tile data now indexed by original coordinates, matching NES PPU behavior)
• Serial debug: COM1 port output for QEMU -serial stdio debugging

cd uefi
build.bat          # MSVC build → build/smb.efi

qemu-system-x86_64 -drive if=pflash,format=raw,file=OVMF.fd \
  -drive file=fat:rw:uefi,format=raw -m 256 -serial stdio -display sdl

Game logic derived from nukep/smb-vanilla-port. UEFI frontend is original. No copyrighted ROM data is included in this repository.