# 复古游戏机
***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***
---
复古游戏机系统基于Quectel Pi H1智能主控板搭建，依托RetroPie模拟器平台支持多种经典游戏运行，配合Xbox手柄与触控屏幕提供流畅操控体验，实现怀旧游戏的即插即玩，为游戏爱好者打造便携的复古游戏娱乐终端。
# 开发资源汇总
## 开发配件清单
|
配件名称
|
数量
|
规格参数
|
| --- | --- | --- |
|
Quectel Pi H1智能主控板
|
1块
| |
|
USB-C电源适配器
|
1个
| |
|
Xbox手柄
|
1个
| |
|
8寸IPS电容触控屏
|
1个
| |
|
网线
|
1根
|
线长：1m；传输速率：千兆；
|
|
CPU散热风扇（可选）
|
1个
| |
# 快速上手
## 硬件连接
### 散热风扇安装
先将散热风扇的排线插入Quectel Pi H1的FAN插槽中，然后将散热器上的两端固定在智能主控板预留的插孔中，如下：
```{image} images/image_CqgHb8QI1otEtJxj1NacwQ3Bnaf.webp
:width: 3070px
:height: 2224px
:align: center
```
### 屏幕连接
屏幕选择8寸IPS电容触控屏（也可使用HDMI屏）。
```{image} images/image_PFslbATWvo3Hu6xpOZscafbgnBt.webp
:width: 3264px
:height: 2324px
:align: center
```
将屏幕的顶针与板子40Pin相扣，用铜柱拧紧，再将屏幕的MIPI接口与板子相接，连接完成如下:
```{image} images/image_BFcvbRfxVoyzICxc57zc4Xv4nkg.webp
:width: 1602px
:height: 1006px
```
屏幕连接好后，接入网线，最后将电源Power In接入，完成上电。
```{image} images/image_CM2kbjY31oI01wx6HAJcFwD7nad.webp
:width: 570px
:height: 355px
```
## 项目实现
### 环境准备
**1.更新软件源**
```plaintext
sudo apt update
```
**2.安装并配置ssh**
```plaintext
sudo apt install openssh-server
```
**设置自启动**
```plaintext
sudo systemctl enable ssh
```
**重启服务**
```plaintext
sudo service ssh restart
```
**3.安装必要工具**
```plaintext
sudo apt install git
sudo apt install neovim
```
### 安装RetroPie
**4.下载RetroPie的官方安装脚本仓库**
```plaintext
git clone --depth=1 https://github.com/RetroPie/RetroPie-Setup.git
```
**5.启动RetroPie配置菜单**
```plaintext
cd RetroPie-Setup
sudo ./retropie_setup.sh
```
**6.基础安装**
菜单中点 **Basic install** 开始安装，整个过程约需1h。
```{image} images/image_PdcpbuMldovcjHxJN6yc39pqnWh.webp
:width: 997px
:height: 584px
```
### 启动与配置
**7.进入RetroPie**
方式1：在终端输入：
```plaintext
emulationstation
```
方式2：在桌面环境中找到 *rpie* 图标，双击启动：
```{image} images/image_HoxqbQfKPo0XPMxhMXAcUm3xnTg.webp
:width: 1255px
:height: 740px
```
**8.手柄初始化**
首次打开模拟器时打开Welcome界面，会让你配置手柄，具体参考 [RetroPie文档]()
```{image} images/image_UoiUbtbBrocUMWxSlgCczqVbnyh.webp
:width: 1366px
:height: 768px
```
手柄按键参考：
```{image} images/image_DG2Pb4M8Wo1EGxxeENnc4QyunZb.webp
:width: 717px
:height: 1024px
```
退出软件：
- 正常退出：按 **Start**→ 出现菜单 → 选择：**Quit → Quit EmulationStation**
### 系统设置
**9.禁用GPU渲染**
编辑环境变量文件：
```plaintext
sudo vim /etc/environment
```
输入 *i*，进入编辑模式，将以下内容注释：
```plaintext
__GLX_VENDOR_LIBRARY_NAME=mesa
MESA_LOADER_DRIVER_OVERRIDE=zink
GALLIUM_DRIVER=zink
VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/freedreno_icd.aarch64.json
```
编辑完成后，按 *Esc* 退出编辑模式，输入 *:wq* 保存并退出。
**10.重启系统**
```plaintext
sudo reboot
```
### 加载游戏ROM
**什么是游戏ROM？**
ROM是游戏卡带或光盘的数字化版本，在模拟器中加载ROM就如同将实体卡带插入游戏机。
**如何获取游戏ROM？**
- 从你合法拥有的游戏卡带/光盘中提取
- 下载由开发者自愿公开的免费ROM
ROM文件放置位置：
```plaintext
/home/pi/RetroPie/roms/
```
不同平台的ROM需放在对应的子文件夹中，详见 [RetroPie官方文档]()
**ROM文件传输**
在PC端使用MobaXterm通过SSH连接到设备后，可直接将ROM文件拖拽到目标目录，实现快速传输。
**启动游戏**
游戏ROM放置好后，打开RetroPie，可以看到识别到了对应的游戏平台和游戏。
```{image} images/image_XezvbEDqooBCAQx3mJXcEB5gnyh.webp
:width: 1280px
:height: 800px
```
# 应用演示
完成上述安装后，您就可以开始游玩游戏了。
具体步骤如下：
1.进入RetroPie，**进入方法**。
2.首次进入需要配置手柄按键，**手柄按键配置参考**。
3.配置手柄按键后，进入主界面，在主界面最下面有界面按键操作说明。
```{image} images/image_T4scbUVpQoPRDtxF2WycSuIknZe.webp
:width: 1280px
:height: 800px
```
4.这里以进入GBA的游戏为例，游戏ROM文件是已经传输好的，详情见 [ROM文件传输](#加载游戏rom)。
5.左右按键选择到 ***GAME BOY ADVANCE*** 界面，单击 ***A*** 进入，进入后可以看到已经安装好的GBA游戏ROM，上下键选择到对应的游戏文件，单击 ***A*** 进入游戏。
```{image} images/image_VXLobKWhVobuC5xpndWcrZphnEe.webp
:width: 1072px
:height: 672px
```
6.下图是游戏实际运行画面。请注意：不同游戏的按键操作不尽相同。
```{image} images/image_KymjbDKHVorIIhxNKtPcAGWrn3d.webp
:width: 800px
:height: 800px
```
7.退出游戏的方法：
- 通过手柄操作进入游戏设置菜单，使用游戏自带的退出选项。
- 组合键退出。同时按下 *Hot + Select*（具体按键对应之前手柄映射时设定的按键）。
# 技术支持与贡献
如在使用过程中遇到问题，欢迎在 [移远官方论坛]() 提交技术咨询，我们的技术支持团队将及时为您解答。