# 复古游戏机

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

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

# 开发资源汇总

## 开发配件清单

| <div style="text-align: center"><br><strong>配件名称</strong><br></div> | <div style="text-align: center"><br><strong>数量</strong><br></div> | <div style="text-align: center"><br><strong>规格参数</strong><br></div> |
| --- | --- | --- |
| <div style="text-align: center"><br>Quectel Pi M1智能主控板<br></div> | <div style="text-align: center"><br>1块<br></div> | <div style="text-align: center"><br>Quectel Pi M1智能主控板<br></div> |
| <div style="text-align: center"><br>USB-C电源适配器<br></div> | <div style="text-align: center"><br>1个<br></div> | <div style="text-align: center"><br><a href="https://www.waveshare.net/shop/PSU-27W-USB-C-CN-B.htm">27W USB Type-C接口充电器1.2米线长中规电源PD电源适用于树莓派5代</a><br></div> |
| <div style="text-align: center"><br>Xbox手柄<br></div> | <div style="text-align: center"><br>1个<br></div> | <div style="text-align: center"><br><a href="https://www.walmart.com/ip/Microsoft-Xbox-Wireless-Controller-Robot-White/1416533685?classType=REGULAR&from=/search">Xbox手柄</a><br></div> |
| <div style="text-align: center"><br>8寸IPS电容触控屏<br></div> | <div style="text-align: center"><br>1个<br></div> | <div style="text-align: center"><br><a href="https://www.waveshare.net/shop/8inch-DSI-LCD-C.htm">8寸IPS电容触控屏1280×800像素DSI通信</a><br></div> |
| <div style="text-align: center"><br>网线<br></div> | <div style="text-align: center"><br>1根<br></div> | <div style="text-align: center"><br>线长：1m；传输速率：千兆；<br></div> |

# 快速上手

## 硬件连接

### 屏幕连接

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

```{image} images/image_UJ5mb75V5oFu5dxg2OGcw5Funob.webp
:width: 1094px
:height: 778px
:align: center
```

```{image} images/image_KZ8QbxkbhojMR9xM4iicCvA0noh.webp
:width: 792px
:height: 537px
:align: center
```

1. 将屏幕的顶针与板子40Pin相扣，用铜柱拧紧，再将屏幕的MIPI接口与板子相接

2. 连接网线以及其他外设

3. 将电源接入，完成供电。

## 项目实现

### 环境准备

**1. 更新软件源**

```bash
sudo apt update 
```

**2. 安装必要工具**

```bash
# 安装 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的官方安装脚本仓库**

```bash
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配置菜单**

```bash
cd RetroPie-Setup

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

**5. 基础安装**

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

```{image} images/image_EGsmbZPejoZzwdxuGWpcGESkncc.webp
:width: 997px
:height: 584px
```

### 启动与配置

**6. 进入RetroPie**

方式1：在终端输入：

```bash
emulationstation
```

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

```{image} images/image_FbVGbXajVoWNxJxlsxmcOpSJnSc.webp
:width: 1255px
:height: 740px
```

**7. 手柄初始化**

首次打开模拟器时会出现Welcome界面，会让你配置手柄，具体参考 [RetroPie文档](<https://retropie.org.uk/docs/First-Installation/>)

```{image} images/image_N8bZbwjspoboh3xjOgFcgns6neh.webp
:width: 1366px
:height: 768px
```

手柄按键参考：

```{image} images/image_XwHFb5MU2oKu2QxGDawctLi7n2g.webp
:width: 717px
:height: 1024px
```

退出软件：

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

### 加载游戏ROM

**什么是游戏ROM？**

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

**如何获取游戏ROM？**

- 从你合法拥有的游戏卡带/光盘中提取

- 下载由开发者自愿公开的免费ROM

ROM文件放置位置：

```plaintext
/home/"$USER"/RetroPie/roms/
```

不同平台的ROM需放在对应的子文件夹中，详见 [RetroPie官方文档](<https://retropie.org.uk/docs/>)

**ROM文件传输**

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

**启动游戏**

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

```{image} images/image_ZjcPbK4DQoK2FAxe0occ27xtn3e.webp
:width: 1280px
:height: 800px
```

# 应用演示

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

具体步骤如下：

1. **进入RetroPie**。

2. **首次进入需要配置手柄按键**。

3. 进入主界面，主界面底部有按键操作说明。

```{image} images/image_KpM3bzT4wocu7PxYuhUcs9M3nub.webp
:width: 1280px
:height: 800px
```

4. 这里以进入GBA的游戏为例，将GBA **游戏ROM文件** 传输到智能主控板中。

5. 手柄左右按键选择到 ***GAME BOY ADVANCE*** 界面，按下 ***A*** 进入，进入后可以看到已经安装好的GBA游戏ROM，上下键选择到对应的游戏文件，按下 ***A*** 进入游戏。

```{image} images/image_Ry6SbgO3LoOZVuxGMggcTHuInYg.webp
:width: 1072px
:height: 672px
```

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

```{image} images/image_FSzhbi0ohof8ERxSfX1c7BJYnGL.webp
:width: 800px
:height: 800px
```

7. 退出游戏的方法：

- 通过手柄操作进入游戏设置菜单，使用游戏自带的退出选项。

- 组合键退出。同时按下 *Hot + Select*（具体按键对应之前手柄映射时设定的按键）。

# 技术支持与贡献

如在使用过程中遇到问题，欢迎在 [移远官方论坛](<https://forumschinese.quectel.com/c/quectel-pi/58>) 提交技术咨询，我们的技术支持团队将及时为您解答。