跳到主要内容

Linux RetroArch 使用指南

:::info 文档信息

文档标识：RK-KF-YF-367　·　发布版本：V1.0.0　·　发布日期：2020-06-12　·　页数：7　·　语言：中文

原始文档：Rockchip_Use_Guide_Linux_RetroArch_CN.pdf

:::

章节大纲​

  • Linux RetroArch 使用指南（P1）
    • RetroArch介绍（P4）
    • RetroArch源码模块介绍和自定义编译（P4）
      • RetroArch的源码模块介绍（P4）
      • 自定义编译RetroArch（P4）
    • 运行RetroArch（P5）
      • 使用命令行启动RetroArch（P5）
      • 使用鼠标设备启动RetroArch（P5）

在线预览​

若预览无法显示，请直接下载 PDF 后用本地阅读器打开。

1. RetroArch介绍​

RetroArch 是款功能强大的跨平台模拟器，不但能够模拟许多不同的游戏主机，并且提供开源代码，可以移植在Linux, Window, Android等主流操作平台上。RetroArch的API的实现包括视频游戏系统模拟器、媒体播放器、游戏引擎以及更通用的 3D 程序。程序实例化为动态库，称为“Libretro Core”。用 C 或 C++ 编写的 libretro core 可以在许多平台上无缝运行，几乎不需要移植。其中“Libretro Core”包含4do, 81, mane等主流的模拟器核心，完美运行gba等格式的游戏。

2. RetroArch源码模块介绍和自定义编译​

2.1 RetroArch的源码模块介绍​

RetroArch源码在SDK/buildroot/output/rockchip_rkxxxx/build/retroarch-xxxxxxx

RetroArch目录介绍(下面有选择性的介绍几个核心的模块)

audio                      音频模块代码
bootstrap                  bootstrap前端框架代码
camera                     摄像头模块代码
cores                      core中包含RetroArch自己支持的核心库，包含
ffmpeg,imageviewer,mpr库等等
menu                       RetroArch的菜单代码
network                    网络模块代码
wifi                       wifi模块代码

还有许多模块详细介绍在官方文档https://docs.libretro.com/, 如果有需要可以详细阅读。

2.2 自定义编译RetroArch​

make menuconfig

选择 Target packages -> Libretro cores and retroarch -> retroarch

您可以在 Target packages -> Libretro cores and retroarch -> Retroarch Cores中选择您需要的模拟器核心。

您也可以选择 Target packages -> Libretro cores and retroarch -> retroarch assets可以加载默认的UI资源。

选择完毕后退出menuconfig

make savedefconfig

编译：

make retroarch

请注意：当您使用自定义编译RetroArch时，包含RetroArch的rootfs所占的固件空间会变大，您需要修改SDK/device/rockchip/rkxxxx/parameter-buildroot.txt文件，（rkxxxx表示您使用的芯片型号）来扩大rootfs的分区，具体修改方法请参见docs/tools/《Rockchip-Parameter-File-Format- Version1.4.pdf》第三章“文件内容说明”。

3. 运行RetroArch​

3.1 使用命令行启动RetroArch​

进入目标板输入命令行：（启动RetroArch的主界面）

/usr/bin/retroarch -c /oem/retroarch.cfg

下面是RetroArch启动界面的截图：

我们将配置好的配置文件retroarch.cfg存放在/oem内，模拟器核心文件存放在 /usr/lib/libretro/中，当然，您也可以在启动的时候指定加载核心文件和游戏ROM：（直接开始游戏）

/usr/bin/retroarch -c /oem/retroarch.cfg` -L /usr/lib/libretro/*.so<emulator
core> <game_rom>

3.2 使用鼠标设备启动RetroArch​

连接目标板和鼠标，显示设备等外设。当系统启动后出现显示桌面，SDK会在桌面上自动生成RetroArch的图标，双击打开它即可。

在RetroArch启动界面里您需要先加载模拟器核心：之后可以选择您需要的核心：

在加载模拟器核心之后，您需要选择加载游戏内容：