复古游戏机¶

复古游戏机系统基于Quectel Pi M1智能主控板搭建，依托RetroPie模拟器平台支持多种经典游戏运行，配合Xbox手柄与触控屏幕提供流畅操控体验，实现怀旧游戏的即插即玩，为游戏爱好者打造便携的复古游戏娱乐终端。

开发资源汇总¶

开发配件清单¶

配件名称	数量	规格参数
Quectel Pi M1智能主控板	1块	Quectel Pi M1智能主控板
USB-C电源适配器	1个	27W USB Type-C接口充电器1.2米线长中规电源PD电源适用于树莓派5代
Xbox手柄	1个	Xbox手柄
8寸IPS电容触控屏	1个	8寸IPS电容触控屏1280×800像素DSI通信
网线	1根	线长：1m；传输速率：千兆；

配件名称

数量

规格参数

Quectel Pi M1智能主控板

1块

Quectel Pi M1智能主控板

USB-C电源适配器

1个

27W USB Type-C接口充电器1.2米线长中规电源PD电源适用于树莓派5代

Xbox手柄

1个

Xbox手柄

8寸IPS电容触控屏

1个

8寸IPS电容触控屏1280×800像素DSI通信

网线

1根

线长：1m；传输速率：千兆；

快速上手¶

硬件连接¶

屏幕连接¶

屏幕选择8寸IPS电容触控屏（也可使用HDMI屏）。

../../../_images/image_UJ5mb75V5oFu5dxg2OGcw5Funob.webp

../../../_images/image_KZ8QbxkbhojMR9xM4iicCvA0noh.webp

将屏幕的顶针与板子40Pin相扣，用铜柱拧紧，再将屏幕的MIPI接口与板子相接
连接网线以及其他外设
将电源接入，完成供电。

项目实现¶

环境准备¶

1. 更新软件源

sudo apt update 

2. 安装必要工具

# 安装 git、vim 等工具
sudo apt install git neovim

# 修复 Mesa 版本冲突
sudo apt install -t trixie-backports libgbm-dev

# 安装 RetroArch / EmulationStation 所需依赖
sudo apt install -t trixie-backports \
  libsdl2-dev libudev-dev libxkbcommon-dev libasound2-dev \
  libusb-1.0-0-dev libx11-xcb-dev libpulse-dev libvulkan-dev \
  libavcodec-dev libavformat-dev libavdevice-dev

安装RetroPie¶

3. 下载RetroPie的官方安装脚本仓库

git clone --depth=1 https://github.com/RetroPie/RetroPie-Setup.git

# 安装两个核心前端（需显式指定平台，以ssh连接 M1 为例，需额外配置环境 DISPLAY=:0）
cd /home/pi/RetroPie-Setup
sudo env __platform=aarch64 DISPLAY=:0 XDG_SESSION_TYPE=x11 \
  ./retropie_packages.sh retroarch

sudo env __platform=aarch64 DISPLAY=:0 XDG_SESSION_TYPE=x11 \
  ./retropie_packages.sh emulationstation

4. 启动RetroPie配置菜单

cd RetroPie-Setup

sudo env __platform=aarch64 DISPLAY=:0 XDG_SESSION_TYPE=x11 \
  ./retropie_setup.sh

5. 基础安装

菜单中点 Basic install 开始安装，整个过程约需1h。

../../../_images/image_EGsmbZPejoZzwdxuGWpcGESkncc.webp

启动与配置¶

6. 进入RetroPie

方式1：在终端输入：

emulationstation

方式2：在桌面环境中找到 rpie 图标，双击启动：

../../../_images/image_FbVGbXajVoWNxJxlsxmcOpSJnSc.webp

7. 手柄初始化

首次打开模拟器时会出现Welcome界面，会让你配置手柄，具体参考 RetroPie文档

../../../_images/image_N8bZbwjspoboh3xjOgFcgns6neh.webp

手柄按键参考：

../../../_images/image_XwHFb5MU2oKu2QxGDawctLi7n2g.webp

退出软件：

正常退出：按 Start→ 出现菜单 → 选择：Quit → Quit EmulationStation

加载游戏ROM¶

什么是游戏ROM？

ROM是游戏卡带或光盘的数字化版本，在模拟器中加载ROM就如同将实体卡带插入游戏机。

如何获取游戏ROM？

从你合法拥有的游戏卡带/光盘中提取
下载由开发者自愿公开的免费ROM

ROM文件放置位置：

/home/"$USER"/RetroPie/roms/

不同平台的ROM需放在对应的子文件夹中，详见 RetroPie官方文档

ROM文件传输

在PC端使用MobaXterm通过SSH连接到设备后，可直接将ROM文件拖拽到目标目录，实现快速传输。

启动游戏

游戏ROM放置好后，打开RetroPie，可以看到识别到了对应的游戏平台和游戏。

../../../_images/image_ZjcPbK4DQoK2FAxe0occ27xtn3e.webp

应用演示¶

完成上述安装后，您就可以开始游玩游戏了。

具体步骤如下：

进入RetroPie。
首次进入需要配置手柄按键。
进入主界面，主界面底部有按键操作说明。

../../../_images/image_KpM3bzT4wocu7PxYuhUcs9M3nub.webp

这里以进入GBA的游戏为例，将GBA 游戏ROM文件 传输到智能主控板中。
手柄左右按键选择到 GAME BOY ADVANCE 界面，按下 A 进入，进入后可以看到已经安装好的GBA游戏ROM，上下键选择到对应的游戏文件，按下 A 进入游戏。

../../../_images/image_Ry6SbgO3LoOZVuxGMggcTHuInYg.webp

下图是游戏实际运行画面。请注意：不同游戏的按键操作不尽相同。

../../../_images/image_FSzhbi0ohof8ERxSfX1c7BJYnGL.webp

退出游戏的方法：

通过手柄操作进入游戏设置菜单，使用游戏自带的退出选项。
组合键退出。同时按下 Hot + Select（具体按键对应之前手柄映射时设定的按键）。

技术支持与贡献¶

如在使用过程中遇到问题，欢迎在移远官方论坛提交技术咨询，我们的技术支持团队将及时为您解答。