RomM 固件一次配好：GBA 游戏不再黑屏
【免费下载链接】rommA beautiful, powerful, self-hosted ROM manager and player.项目地址: https://gitcode.com/GitHub_Trending/rom/romm
点开 GBA 游戏，画面卡在黑屏，模拟器提示缺少 BIOS。多半是固件没放到 RomM 固件校验能认的位置。核对文件名与校验值，把文件归位并触发一次扫描，固件位就会变成就绪，游戏正常进标题画面。
为什么固件这一关绕不开
模拟器无法凭空模拟主机，必须有原厂 BIOS 才能启动游戏。RomM 扫描时会拿固件目录里的每个文件去对仓库内置的校验清单：文件名、大小、校验值全部命中，平台页才会标成就绪，否则一直挂着缺失标记。
动手前的固件文件核对清单
- 文件名必须与速查表逐字一致，RomM 区分大小写，
Gba_Bios.BIN这种写法不认。 - 文件大小先对照速查表确认，下载器把网页错误页存成二进制是最常见的翻车点。
- 落点默认在库根目录的
bios/{平台}/子目录；不用默认位置时，改 examples/config.example.yml 里filesystem.structure.firmware的模板指向即可。
校验命令、固件目录结构与关键配置
用校验命令确认文件没下坏
进入 BIOS 文件所在目录，执行：
md5sum gba_bios.bin此时应能看到与速查表 MD5 完全一致的一串十六进制。对不上就重新下载，别继续往下放文件。
把固件放进 RomM 能找到的目录
按这个结构落文件：
library/ └── bios/ ├── gba/ │ └── gba_bios.bin └── nds/ ├── bios7.bin └── bios9.bin这样就算做对了：对应平台子目录下的文件名与速查表逐字一致，没有多余空格或改过的后缀。NDS 有两个固件文件，缺一个都算没放齐。
非默认路径时改一行配置
编辑 examples/config.example.yml 中的filesystem.structure.firmware模板（默认值是bios/{platform}）：
filesystem: structure: firmware: 'bios/{platform}'保存后重启 RomM，配置生效。{platform}会被替换成实际平台目录名，例如bios/gba。
固件管理页状态验证方法
打开 RomM 前端，进管理页触发一次库扫描，等扫描结束。再进固件管理页：各平台固件位由缺失转为就绪，游戏封面不再带缺失标记。重进之前黑屏的 GBA 游戏，能正常进入标题画面，说明整条链路通了。
固件放错时的排查清单
- 固件页仍显示缺失 → 文件名大小写写错或用了自造名字 → 按速查表重命名为标准名，回管理页再扫一次。
- 扫描日志提示校验失败 → 下载文件损坏或被存成 HTML 错误页 → 先核对文件大小与速查表一致，不一致就重新下载。
- 放完文件页面毫无变化 → 没触发重新扫描，或配置模板指向的目录与实际目录不符 → 核对
firmware模板指向的真实路径，再回管理页触发扫描。 - 自定义平台文件夹识别不到 → 文件夹名不是 RomM 认的平台缩写 → 参照 examples/config.example.yml 的
system.platforms映射，把你的文件夹名对应到标准平台名。
固件文件名与校验值速查表
| 平台 | 标准文件名 | 大小（字节） | CRC32 | MD5 |
|---|---|---|---|---|
| GBA | gba_bios.bin | 16384 | 81977335 | a860e8c0b6d573d191e4ec7db1b1e4f6 |
| GBC | gbc_bios.bin | 2304 | 41884e46 | dbfce9db9deaa2567f6a84fde55f9680 |
| NDS | bios7.bin | 16384 | 1280f0d5 | df692a80a5b1bc90728bc3dfc76cd948 |
| NDS | bios9.bin | 4096 | 2ab23573 | a392174eb3e572fed6447e956bde4b25 |
| 64DD | 64DD_IPL.bin | 4194304 | 7f933ce2 | 8d3d9f294b6e174bc7b1d2fd1c727530 |
| FDS | disksys.rom | 8192 | 5e607dcf | ca30b50f880eb660a320674ed365ef7a |
CRC32 与 MD5 作用相同，都是确认文件没被改坏，命中其中一种即可通过 RomM 校验。完整清单见 backend/models/fixtures/known_bios_files.json，仓库内置的固件校验数据库，覆盖全部平台，其他平台照此文件对号入座。
收尾要点
- NDS 要放齐
bios7.bin与bios9.bin两个文件，别当成一个。 - 文件名区分大小写，逐字照速查表抄。
- 校验值放文件前先核一遍，比事后排查省事。
- 多平台共用的固件一份就够，放在共用平台目录里即可。
BIOS 属原厂版权内容，请仅使用你合法持有的固件文件。
【免费下载链接】rommA beautiful, powerful, self-hosted ROM manager and player.项目地址: https://gitcode.com/GitHub_Trending/rom/romm
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
