教程:VENTUNO Q/安装 RetroArch
简介
本教程说明如何在 Arduino® VENTUNO™ Q 上安装 RetroArch，使其成为独立的游戏主机。通过控制台命令轻松安装所需全部软件，使用 RetroArch 作为运行游戏以及配置游戏、输入和视频设置的主要软件。利用开发板上内置的连接器，连接所需的一切：屏幕、键盘和鼠标。如果需要输出声音，可使用 USB 或蓝牙扬声器。
你将完成的内容
在本教程中你将：
- 为 VENTUNO Q 完成硬件设置。
- 安装并配置 RetroArch。
- 使用连接到 VENTUNO Q 的键盘和鼠标控制游戏。
- 为 VENTUNO Q 连接扬声器。
硬件要求
- Arduino® VENTUNO™ Q
- Arduino® USB-C Power Supply (65W)（或其他 12–24 V 电源）
- HDMI 显示器和线缆
- USB 键盘和鼠标
- USB 或蓝牙扬声器（可选）
硬件设置
接下来的步骤需要将显示器、键盘和鼠标连接到 VENTUNO Q。
- 将显示器、鼠标和键盘直接连接到 VENTUNO Q。
- 将电源连接到圆口连接器即可为 VENTUNO Q 上电。
- 确保显示器有自己的电源。
说明：
圆口支持 7–24 V，最大 5 A。推荐目标为 12 V / 5 A 或 24 V / 3 A。请确保你的电源满足这些要求。
开发板设置
VENTUNO Q 启动且显示器已连接后，完成初始开发板设置。
- 将开发板连接到你的网络。
- 为开发板创建密码。稍后软件安装时需要此密码。
- 打开命令行终端。
RetroArch 的安装
RetroArch 是一个开源前端，为运行称为 cores 的软件组件提供统一界面。这样你可以一次性配置控制器、视频设置、存档状态和其他功能，并在不同游戏平台上复用。
典型的 RetroArch 设置包括：
- RetroArch — 提供用户界面并管理输入、音频、视频和存档状态的前端应用。
- Cores — 为特定游戏平台添加支持的软件组件。
- ROMs — 由 core 加载的游戏文件。它们包含原始卡带、磁盘或游戏介质中的数据。
在本教程中，我们将安装以下开源组件：
- RetroArch（GPLv3）
- RetroArch Assets — 菜单主题、图标和图形资源
- libretro-core-info — RetroArch 用于识别和列出 cores 的元数据文件
- Beetle PSX（GPL-2+）— PlayStation 1 core
说明：
重要：RetroArch 及其 cores 不包含游戏。在下载或使用任何 ROM 之前，请确认你拥有合法使用权，且其许可允许你的预期用途。许多商业游戏即使原始硬件已不再销售，仍受版权保护。
运行以下命令安装 RetroArch 及所选组件：
sudo apt install -y retroarch retroarch-assets libretro-core-info libretro-beetle-psx
这将提供一个支持 Playstation 1 游戏的 core。
设置 RetroArch
现在 RetroArch 已安装，是时候进行配置以使其正常工作！你可以关闭终端，然后点击：Show Apps -> RetroArch
首次打开 RetroArch 时，你会看到类似以下界面：
你需要使用鼠标和键盘在菜单中移动！
向右移动到 Settings，向下到 Input 并进入菜单：
点击 RetroPad Binds，选择 Port 1 Controls：
在菜单中，确保将控制绑定到你想用来控制游戏的键盘按键。
现在你的控制器应该可以完美工作了！对玩家 2 以及任何其他控制器重复此过程！
设置视频驱动
RetroArch 使用的视频驱动可以轻松通过 RetroArch UI 更改，也可以直接在配置文件中更改。视频驱动的不同选项包括：
- Vulkan
- GL
- SDL2
对 VENTUNO Q 效果最好的驱动是 Vulkan。请确保已选择该驱动。转到 “Settings” 选项卡，它位于 RetroArch 启动时主菜单右侧一步。在 “Settings” 选项卡中向下滚动到 “Drivers”
进入 drivers 后找到 “Video” 选项，在此可以更改视频驱动。如果尚未设置为 “vulkan”，请进行设置。
设置 Core 与游戏
要使用 RetroArch 玩任何游戏，需要 “Core” 和 BIOS 文件。Core 已通过我们之前使用的 RetroArch 安装命令安装。但 BIOS 文件需要单独下载，你可以在网上找到这些文件。
说明：
重要：所需的 BIOS 文件取决于游戏的制作地区，不同地区有不同的 BIOS 文件。请确保你拥有与要运行的游戏匹配的正确 BIOS 文件。
BIOS 文件应放在 RetroArch 文件夹内的 “System” 文件夹中。该文件夹可在 “Home” 文件夹中找到，按 CTRL + H 显示隐藏文件夹，然后进入 “.config” 文件夹。
在这里找到 “RetroArch” 文件夹。
最后在 RetroArch 文件夹中找到 “System” 文件夹。你可以将所有 BIOS 文件放在这里，“System” 内不需要子文件夹。
现在我们可以加载 core。通过转到最左侧菜单中的 “Load Core” 选项来加载，如下所示：
加载 Core 后，左下角会显示已加载 Core 的信息。现在你已准备好下载并游玩 playstation 1 游戏！
你可以在这里找到为 playstation 1 模拟器创建的免费独立游戏：http://itch.io/。
找到并下载你想玩的游戏！游戏下载后，转到 “Load Content”，找到包含你下载游戏的文件夹，并运行 *.cue 文件。
如果游戏卡顿，若在 RetroArch 安装后尚未重启，请尝试重启开发板。
配置声音
要从游戏输出声音，最简单的方式是将蓝牙扬声器连接到 VENTUNO Q！
首先点击 VENTUNO Q 桌面右上角栏（显示 wifi 符号的位置）。然后点击 Bluetooth 选项。打开 “Advanced settings” 并配对你的蓝牙扬声器。确保扬声器处于配对模式，它应会出现在 “Devices” 下。
然后，为确保从正确的设备输出，前往 “Sound” 设置，可在左侧菜单的 “Bluetooth” 选项下找到。
确保 “Output Device” 设置为你要使用的蓝牙扬声器。现在 RetroArch 上运行的游戏的所有声音都将从你的蓝牙扬声器播放。
结论
本教程展示了如何设置硬件，以便在 VENTUNO Q 上运行并下载带资源的 RetroArch。然后我们介绍了如何配置在 RetroArch 上运行的游戏控制。本教程还展示了如何配置视频驱动和 core，以便游戏能在开发板上完美运行。作为可选步骤，你还可以设置蓝牙扬声器来播放游戏声音。既然你已了解一切如何运作，就可以尝试不同的游戏和主机了！
原文：https://docs.arduino.cc/tutorials/ventuno-q/retroarch/ 本页为 Arduino 官方教程的中文翻译，供内部查阅。命令与代码保持原文。
