open_agb_firm是一款专为Nintendo 3DS设计的开源固件应用，它能让你通过3DS内置的GBA硬件直接运行GBA自制程序和游戏，无需额外模拟器。这款工具由社区开发者精心打造，为复古游戏爱好者提供了简单高效的GBA游戏解决方案。
📌 为什么选择open_agb_firm？
✅ 原生硬件支持
利用3DS内置的GBA处理器和内存，实现接近原版GBA的游戏体验，告别模拟器的性能瓶颈。
✅ 简单易用
无需复杂设置，几步操作即可启动游戏，新手也能快速上手。
✅ 开源免费
完全开源的项目，代码托管在source/目录下，社区持续更新维护。
🛠️ 准备工作
在开始前，请确保你的3DS已满足以下条件：
已破解并安装自定义固件（CFW）
拥有至少100MB可用存储空间
准备一张Micro SD卡用于存放游戏文件
所需工具
电脑（Windows/macOS/Linux均可）
3DS主机及充电线
Micro SD卡读卡器
📥 安装步骤
1. 获取项目文件
首先克隆项目仓库到本地：
git clone https://gitcode.com/gh_mirrors/op/open_agb_firm.git
cd open_agb_firm
2. 编译固件（可选）
如果你需要最新版本，可以自行编译：
make clean
make
编译后的文件会生成在项目根目录下，具体名称可查看Makefile中的配置。
3. 复制文件到3DS
将编译好的固件文件复制到SD卡的对应目录：
将SD卡插入电脑
复制open_agb_firm.firm到sd:/luma/payloads/目录
创建sd:/gba/文件夹并放入你的GBA游戏ROM文件
🎮 开始使用
重启3DS，在开机时按住SELECT键进入Luma3DS配置
选择"Payloads"，然后选择"open_agb_firm"
系统会自动加载source/arm11/filebrowser.c实现的文件浏览器
选择你想玩的游戏，开始畅玩！
⚙️ 高级配置
游戏封面显示
项目工具目录中的tools/gba-db/提供了游戏数据库功能，可自动加载游戏封面和信息：
将gba.csv复制到sd:/gba/目录
重启open_agb_firm即可生效
视频设置
你可以通过include/arm11/oaf_video.h中定义的参数调整显示效果，支持多种屏幕缩放模式。
❗ 注意事项
请仅使用合法获得的游戏ROM
建议先备份SD卡中的数据
部分游戏可能存在兼容性问题，可查看项目issue了解最新兼容情况
更新3DS系统可能需要重新安装open_agb_firm
🤝 社区支持
如果你遇到问题，可以：
查看项目README.md获取更多帮助
提交issue到项目仓库
参与3DS homebrew社区讨论
📚 相关资源
游戏兼容性列表：tools/gba-db/gba.csv
视频缩放工具：tools/lgyFbScaler/
错误代码参考：include/oaf_error_codes.h
open_agb_firm为3DS用户打开了通往GBA游戏世界的大门，无论是怀旧玩家还是自制游戏开发者，都能从中获得出色的体验。现在就开始你的复古游戏之旅吧！