跳到主要内容

GP2040-CE 使用指南

选择要在使用指南中显示的按键标签:

XInput

警告

v0.5+ 版本对除树莓派 Pico 以外的其他电路板有重大更改。如果您使用的是这些电路板,请勿从旧版本更新,除非您有已知正常版本的 .uf2 备份,或您清楚自己在做什么。

按键

GP2040-CE 使用通用按键标记来表示游戏手柄状态,然后在发送前转换为适当的输入类型。下表提供了 GP2040-CE 按键与支持的输入类型和布局的映射:

GP2040-CEXInput
Xbox One
SwitchPS4PS3DirectInputArcadeRP2040 Advanced Breakout Board
B1AB交叉交叉2K1K1
B2BA圆圈圆圈3K2K2
B3XY四方四方1P1P1
B4YX三角三角4P2P2
L1LBLL1L15P4P4
R1RBRR1R16P3P3
L2LTZLL2L27K4K4
R2RTZRR2R28K3K3
S1Back减号分享Select9CoinS1
S2Start加号选项Start10StartS2
L3LSLSL3L311LSL3
R3RSRSR3R312RSR3
A1HomeHOMEPSPS13HomeA1
A2-截屏触摸板按下-14-A2

如果您的控制器缺少专用按键用于特定输入,请查看 快捷键页面,了解如何映射按键组合以模拟这些缺失的输入。

备注

与其他控制器不同,键盘的方向按键对应不同的键。您可以在 网页配置模式 > 配置 > 键盘映射 中更改键盘模式的键映射。

方向键盘
方向键上
方向键下
方向键左
方向键右

BOOTSEL 模式

Bootsel 模式是板进入可刷入固件的状态。每当进行更新或排查问题时,您都需要使用此模式。

您可以通过以下方式进入 BOOTSEL 模式:在插入控制器时按住 Back + Start + 上 按键,通过进入网页配置器并在 BOOTSEL 模式下重启,或在控制器插入状态下按住 Back + X + Y 五秒钟。激活后,除了刷入新固件或拔掉设备,没有其他方法可以离开 BOOTSEL 模式。

通常,板上会有一个 BOOTSEL 按钮。这个按钮往往是 PCB 上露出的按钮,或者在控制器内部,需要针状物按压或拆卸控制器才能按到。

备注

一些控制器选择不包含 BOOTSEL 按钮。在这种情况下,您需要找到按钮的位置,并在插入或启动控制器时使用导体连接触点或垫片的两侧。

网页配置模式

网页配置模式是板启动内置网页浏览器配置应用程序的状态。在此,您可以根据需要自定义和配置控制器。更多信息请点击 这里

您可以通过以下方式进入网页配置模式:在插入控制器时按住 Start 按键,或在控制器插入状态下按住 Start + X + Y 五秒钟。再次按住这个组合五秒钟,即可将设备切换回先前使用的控制器模式。

输入模式

GP2040-CE兼容多个系统和输入模式。可以在网页配置器中设置按住八个按键时分配的特定输入模式,配置路径为 设置

不过,预编译固件中有默认输入模式。要更改输入模式,在插入控制器时按住以下按键之一:

主要输入模式按住的按键
Nintendo SwitchA
XInputB
PS3/DirectInputX
PS5Y
Xbox OneRB
键盘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 功能。由于社区创建了大量插件,它们位于单独的文档页面。请导航到插件页面以获取更多信息。