Recalbox OS 开源项目使用教程

1. 项目目录结构及介绍

Recalbox OS 是一个开源的复古游戏模拟器系统，其项目目录结构如下：

recalbox-os/
├── recalbox-buildroot/
├── recalbox-configgen/
├── recalbox-emulationstation/
├── recalbox-rescue/
├── wiki/
├── gitmodules
├── LICENCE.md
├── README-DE.md
├── README-ES.md
├── README-FR.md
├── README-IT.md
├── README-PT.md
├── README-TR.md
└── README.md

目录介绍

• recalbox-buildroot/：包含构建 Recalbox OS 所需的 Buildroot 配置文件。
• recalbox-configgen/：包含用于生成系统配置的脚本和文件。
• recalbox-emulationstation/：包含 EmulationStation 模拟器的前端代码。
• recalbox-rescue/：包含用于系统恢复的脚本和文件。
• wiki/：包含项目的维基页面。
• gitmodules：Git 子模块配置文件。
• LICENCE.md：项目许可证文件。
• README-*.md：不同语言的 README 文件。
• README.md：项目的默认 README 文件。

2. 项目启动文件介绍

Recalbox OS 的启动过程主要依赖于 Buildroot 生成的系统镜像和 EmulationStation 模拟器。以下是启动过程中涉及的关键文件：

关键文件

• recalbox-buildroot/configs/recalbox_defconfig：Buildroot 的默认配置文件，定义了系统的基本配置。
• recalbox-emulationstation/emulationstation：EmulationStation 模拟器的主程序，负责启动和管理游戏模拟器。
• recalbox-configgen/configgen：配置生成脚本，用于生成系统配置文件。

启动流程

1. 系统启动：系统从 Buildroot 生成的镜像启动。
2. EmulationStation 启动：系统启动后，EmulationStation 作为前端界面启动，用户可以通过它选择和启动游戏。
3. 配置生成：系统启动时，configgen 脚本会根据用户配置生成相应的系统配置文件。

3. 项目的配置文件介绍

Recalbox OS 的配置文件主要位于 /etc/recalbox/ 目录下，以下是一些关键的配置文件：

关键配置文件

• recalbox.conf：系统的主配置文件，包含系统设置、网络配置、游戏控制器配置等。
• es_systems.cfg：EmulationStation 的系统配置文件，定义了支持的游戏平台和模拟器。
• es_input.cfg：EmulationStation 的输入配置文件，定义了游戏控制器的映射。

配置文件示例

# recalbox.conf 示例
[global]
system.language=en_US
system.timezone=Europe/Paris

[network]
wifi.enabled=1
wifi.ssid=MyWiFiNetwork
wifi.key=MyWiFiPassword

[controllers]
controller1.type=xbox360
controller1.player=1

通过编辑这些配置文件，用户可以自定义 Recalbox OS 的行为和设置。

---

以上是 Recalbox OS 开源项目的使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用 Recalbox OS。