跳到主要内容

键盘主机配置

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

XInput

用途:此插件旨在允许用户将键盘与 GP2040-CE 配合使用,并与 GP2040-CE 支持的系统兼容。

GP2040-CE 配置器 - 键盘主机配置

网页配置器选项

GPIO 引脚分配

USB 主机端口的 Data、5V Enable 和 Pin Orientation 选项现在在 功能配置 > 外围设备映射 - USB 主机 中配置。

默认按键绑定

GP2040键盘按键
上箭头
下箭头
左箭头
右箭头
A左 Shift
BZ
X左 Control
Y左 Alt
LBC
RB空格
LTV
RTX
Back5
Start1
LS等号
RS减号
Home9
(A2)F2
Function

硬件

要求

此插件需要设备上有一个 USB 主机端口,并且该端口连接到 RP2040 板上的 GPIO 引脚。实现此功能有多种方法。

请参阅 USB 主机端口安装 了解有关将 USB 主机端口添加到控制器的详细要求。

安装

示例接线

备注

虽然此示例接线指南使用的是树莓派 Pico,但该原则适用于所有基于 RP2040 的板子。

USB 主机接线图

  • VCC - 连接到 5V 电源(示例:树莓派 Pico 的 VBUS)
  • D+ - 连接到上面网页配置器中设置的 D+ GPIO 引脚。(示例:树莓派 Pico 的 GPIO0)
  • D- - 连接到上面网页配置器中基于 D+ 自动设置的 D- GPIO 引脚。(示例:树莓派 Pico 的 GPIO1)
  • GND - 连接到任意接地引脚(GND 引脚)。(示例:树莓派 Pico 的 GND)

备注

对于 D+D-,RP2040 上的任意 GPIO 引脚都可以使用。但有一个要求,即 D- GPIO 必须紧接在 D+ 之前或之后(即 D+ = GPIO 引脚 X -> D- 必须是 X+1 或 X-1)。

其他说明

只要键盘带有 USB 插头,任何键盘都可以与此插件配合使用,包括无线 USB 键盘。

由于当前 Pico-PIO-USB 和插件系统的实现方式,存在以下限制:

  • 键盘仅限于上述列出的输入数量。键盘上的其他按键将无法使用,并且不会向系统发送任何输入信号。
  • 键盘受限于 6 键无冲(6 key rollover),这意味着最多只能同时激活 6 个键盘按键。即使所使用的键盘通常支持全键无冲(NKRO),此限制仍然适用。
  • 键盘无法在启动时影响输入模式。输入模式必须通过 Web Configurator > Settings 或 GP2040-CE 设备上的额外开关进行设置。