GP2040-CE 使用指南
选择要在使用指南中显示的按键标签：
v0.5+ 版本对除树莓派 Pico 以外的其他开发板有重大更改。如果您使用的是这些开发板，请勿从旧版本更新，除非您有已知正常版本的 .uf2 备份，或您清楚自己在做什么。
按键
GP2040-CE 使用通用按键标记来表示游戏控制器状态，然后在发送前转换为适当的输入类型。下表提供了 GP2040-CE 按键与支持的输入类型和布局的映射：
- 主要输入模式
- 迷你/经典主机模式
| GP2040-CE | XInput Xbox One | Switch | PS4 | PS3 | DirectInput | Arcade | RP2040 Advanced Breakout Board |
|---|---|---|---|---|---|---|---|
| B1 | A | B | 交叉 | 交叉 | 2 | K1 | K1 |
| B2 | B | A | 圆圈 | 圆圈 | 3 | K2 | K2 |
| B3 | X | Y | 四方 | 四方 | 1 | P1 | P1 |
| B4 | Y | X | 三角 | 三角 | 4 | P2 | P2 |
| L1 | LB | L | L1 | L1 | 5 | P4 | P4 |
| R1 | RB | R | R1 | R1 | 6 | P3 | P3 |
| L2 | LT | ZL | L2 | L2 | 7 | K4 | K4 |
| R2 | RT | ZR | R2 | R2 | 8 | K3 | K3 |
| S1 | Back | 减号 | 分享 | Select | 9 | Coin | S1 |
| S2 | Start | 加号 | 选项 | Start | 10 | Start | S2 |
| L3 | LS | LS | L3 | L3 | 11 | LS | L3 |
| R3 | RS | RS | R3 | R3 | 12 | RS | R3 |
| A1 | Home | HOME | PS | PS | 13 | Home | A1 |
| A2 | - | 截屏 | 触摸板按下 | - | 14 | - | A2 |
| GP2040-CE | Sega Genesis MegaDrive Mini | NEOGEO Mini | PC Engine Turbografx 16 Mini | EGRET II Mini | ASTROCITY Mini | Playstation Classic |
|---|---|---|---|---|---|---|
| B1 | A | B | 1 | A | A | Cross |
| B2 | B | D | 2 | B | B | Circle |
| B3 | X | A | - | D | D | Square |
| B4 | Y | C | - | E | E | Triangle |
| L1 | - | L1 | - | - | - | L1 |
| R1 | Z | R1 | - | F | F | R1 |
| L2 | - | L2 | - | - | - | L2 |
| R2 | C | R2 | - | C | C | R2 |
| S1 | Mode | Select | Start | Start | Credit | Start |
| S2 | Start | Start | Run | Credit | Start | Select |
| L3 | - | - | - | - | - | - |
| R3 | - | - | - | - | - | - |
| A1 | - | Options | - | Menu | - | - |
| A2 | - | - | - | - | - | - |
如果您的游戏控制器缺少专用按键用于特定输入，请查看 快捷键页面，了解如何映射按键组合以模拟这些缺失的输入。
与其他游戏控制器不同，键盘的方向按键对应不同的键。您可以在 网页配置器 > 系统设置 > 键盘映射 中更改键盘模式的键映射。
| 方向 | 键盘 |
|---|---|
| 上 | 方向键上 |
| 下 | 方向键下 |
| 左 | 方向键左 |
| 右 | 方向键右 |
BOOTSEL 模式
Bootsel 模式是板进入可刷入固件的状态。每当进行更新或排查问题时，您都需要使用此模式。
您可以通 过以下方式进入 BOOTSEL 模式：在插入游戏控制器时按住 Back + Start + 上 按键，通过进入网页配置器并在 BOOTSEL 模式下重启，或在游戏控制器插入状态下按住 Back + X + Y 五秒钟。激活后，除了刷入新固件或拔掉设备，没有其他方法可以离开 BOOTSEL 模式。
通常，板上会有一个 BOOTSEL 按钮。这个按钮往往是 PCB 上露出的按钮，或者在游戏控制器内部，需要针状物按压或拆卸游戏控制器才能按到。
一些游戏控制器选择不包含 BOOTSEL 按钮。在这种情况下，您需要找到按钮的位置，并在插入或启动游戏控制器时使用导体连接触点或垫片的两侧。
网页配置模式
网页配置模式是板启动内置网页浏览器配置应用程序的状态。在此，您可以根据需要自定义和配置游戏控制器。更多信息请点击 这里。
您可以通过以下方式进入网页配置模式：在插入游戏控制器时按住 Start 按键，或在游戏控制器插入状态下按住 Start + X + Y 五秒钟。再次按住这个组合五秒钟，即可将设备切换回先前使用的游戏控制器模式。
输入模式
GP2040-CE兼容多个系统和输入模式。可以在网页配置器中设置按住八个按键时分配的特定输入模式，配置路径为 设置。
不过，预编译固件中有默认输入模式。要更改输入模式，在插入游戏控制器时按住以下按键之一：
| 主要输入模式 | 按住的按键 |
|---|---|
| Nintendo Switch | A |
| XInput | B |
| PS3/DirectInput | X |
| PS5 | Y |
| Xbox One | RB |
| 键盘 | RT |
| Original XBox | 未分配 |
| 迷你/经典主机模式 | 按住的按键 |
|---|---|
| Sega Genesis/MegaDrive Mini | 未分配 |
| NEOGEO mini | 未分配 |
| PC Engine/Turbografx 16 Mini | 未分配 |
| EGRET II Mini | 未分配 |
| ASTROCITY Mini | 未分配 |
| Playstation Classic | 未分配 |
输入模式在重启后会被保留。
快捷键
GP2040设有多个快捷键，无需访问网页配置器即可更改功能。所有快捷键和快捷键绑 定可以在网页配置器的 快捷键设置 中更改或分配为不同的按键组合。
常用快捷键包括将方向更改为模拟数字DPad、左模拟摇杆、右模拟摇杆或更改 SOCD（同时相反方向） 覆盖模式。不同的 SOCD 覆盖模式将确保游戏控制器在发送输入时遵循特定的方向输入规则。
许多快捷键默认启用，如果游戏控制器出现意外行为，请确保未意外触发快捷键。
| 默认启用的快捷键 | 输入 |
|---|---|
| Home 键 | Back + Start + 上 |
| 十字键模式 | Back + Start + 下 |
| 左摇杆模式 | Back + Start + 左 |
| 右摇杆模式 | Back + Start + 右 |
| SOCD 上优先 | Start + Home + 上 |
| SOCD 回中 | Start + Home + 下 |
| SOCD 后输入优先 | Start + Home + 左 |
选定的方向模式和 SOCD 覆盖模式在重启后会被保留。
插件和额外功能
GP2040-CE有许多扩展功能的插件，例如 模拟摇杆 和 Turbo 功能。由于社区创建了大量插件，它们位于单独的文档页面。请导航到插件页面以获取更多信息。