`。 + +
| + +**Markdown** + + | +
+
+```markdown
+This
+will
+all
+be
+on
+one
+line.
+
+The empty line above creates a new paragraph.
+
+This forces a soft return +rather than creating a new paragraph + +| Column1 | Column2 | +| ------- | ------------------------------------- | +| Row 1 | - Line 1 - Line 2 - Line3 | +``` + + |
+
| + +**显示** + + | +
+
+This
+will
+all
+be
+on
+one
+line.
+
+The empty line above creates a new paragraph.
+
+This forces a soft return +rather than creating a new paragraph + +| Column1 | Column2 | +| ------- | ------------------------------------- | +| Row 1 | - Line 1 - Line 2 - Line3 | + + |
+
| + +**Markdown** + + | ++ +```markdown + +``` + + | +
| + +**显示** + + | ++ + + + | +
| + +**Markdown** + + | +
+
+```markdown
+Select the button labels to be displayed in the usage guide:
+
+ + +Document Content +``` + + |
+
| + +**显示** + + | +
+
+Select the button labels to be displayed in the usage guide:
+
+ + +Document Content + + |
+
| + +**Markdown** + + | +
+
+```markdown
+ |
+
| + +**显示** + + | +
+
+ |
+
| + +**Markdown** + + | ++ +```markdown +This comment refers to the `GP2040-CE_X.X.X_Pico.uf2` file. +``` + + | +
| + +**显示** + + | ++ +This comment refers to the `GP2040-CE_X.X.X_Pico.uf2` file. + + | +
| + +**Markdown** + + | ++ + ```md title="Example Markdown Page" + --- + title: TITLE + # tags: + # - + pagination_next: null + pagination_prev: null + description: "PAGE DESCRIPTION" + --- + + # Document Title + + CONTENT + ``` + + | +
| + +**显示** + + | ++ +```md title="Example Markdown Page" +--- +title: TITLE +pagination_next: null +pagination_prev: null +description: "PAGE DESCRIPTION" +--- + +# Document Title + +CONTENT +``` + + | +
| + +**Markdown** + + | ++ +```markdown +:::note + +给您的相关信息。 + +::: + +:::tip + +您应该这样做。 + +::: + +:::caution + +您可能需要注意这些事。 + +::: + +:::warning + +您可能会进行危险操作。 + +::: +``` + + | +
| + +**显示** + + | ++ +:::note + +给您的相关信息。 + +::: + +:::tip + +您应该这样做。 + +::: + +:::caution + +您可能需要注意这些事。 + +::: + +:::warning + +您可能会进行危险操作。 + +::: + + | +
| + +**Markdown** + + | ++ +```markdown +:::note 这是一个标记 + +给您的相关信息。 + +::: +``` + + | +
| + +**显示** + + | ++ +:::note 这是一个标记 + +给您的相关信息。 + +::: + + | +
- 附加组件：文件名以 `gpc-add-ons-` 开头
- Web 配置页面：文件名以 `gpc-` 开头 | +| `wiring` | 包含在 `docs/controller-build/wiring.mdx` 中的微控制器板引脚图像 | \ No newline at end of file diff --git a/i18n/zh/docusaurus-plugin-content-docs-development/current/documentation-update-downloads.mdx b/i18n/zh/docusaurus-plugin-content-docs-development/current/documentation-update-downloads.mdx new file mode 100644 index 0000000..0e006dc --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs-development/current/documentation-update-downloads.mdx @@ -0,0 +1,46 @@ +--- +title: 更新下载页面 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "How to update the Downloads Page to add a new microcontroller board or controller" +--- + +# 更新下载页面 + +要将微控制器板或设备添加到 [下载](/downloads) 页面，需要更新 `src/config/boards.tsx` 文件。所需信息取决于您是添加微控制器板还是控制器。 + +| 键 | 值 | +| ------------ | ---------------------------------------------------------------------------------------------------------------- | +| `name` | 将在下载页面列出的设备名称 | +| `configName` | 用于生成 .uf2 文件并用于生成固件链接的设备名称 | +| `pinout` | 设备引脚图的链接 | +| `website` | 包含设备信息的网站链接 | +| `image` | 设备使用的资源的绝对链接，仅更改 `BoardName` 以匹配 `static/img/boards/` 中的文件名 | +| `supported` | （仅限微控制器板）设备当前是否被项目支持 | +| `category` | （仅限游戏控制器）遵循以下约定的类别分类 | +| `desc` | 设备和制造商的简短描述，将显示在下载页面上 | + +## 微控制器板 + +微控制器板的模板可以在 [模板 - 微控制器板](./templates.mdx#微控制器板) 找到。 + +要将微控制器板添加到下载列表中，请填写模板中的所有信息，并将其添加到数组 `boards['Microcontroller Boards']` 中。板列出的顺序决定了它们在页面上的显示顺序，因此请注意以下板的顺序。 + +- Raspberry Pi Pico +- Raspberry Pi Pico W +- 其他微控制器板按字母顺序排列 + +## 游戏控制器 + +游戏控制器的模板可以在 [模板 - 游戏控制器](./templates.mdx#游戏控制器) 找到。 + +要将游戏控制器添加到下载列表中，请填写模板中的所有信息，并将其添加到数组 `boards['Controllers']` 中。此数组中游戏控制器的顺序应按字母顺序排列。 + +类别的约定如下： + +- `official` - 项目的官方板 +- `open` - 开源设备 +- `closed` - 闭源设备 +- `legacy` - 不支持或不再受项目支持的设备 diff --git a/i18n/zh/docusaurus-plugin-content-docs-development/current/modifying-gamepad-state.mdx b/i18n/zh/docusaurus-plugin-content-docs-development/current/modifying-gamepad-state.mdx new file mode 100644 index 0000000..de798b8 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs-development/current/modifying-gamepad-state.mdx @@ -0,0 +1,127 @@ +--- +title: 修改游戏控制器状态 +# tags: +# - +pagination_next: null +pagination_prev: null +description: Documentation on how to modify gamepad state when developing firmware features and add-ons" +--- + +# 修改游戏控制器状态 + +在任何希望修改游戏控制器状态的函数中，都需要使用指向游戏控制器的指针。这是更改游戏控制器状态任何方面的绝对必要条件。 + +```cpp +Gamepad *gamepad = Storage::getInstance().GetGamepad(); +``` + +可以在 `headers/gamepad/GamepadState.h` 中找到合适的游戏控制器宏和按钮掩码。 + +## 方向键 + +要修改游戏控制器的方向键（DPad）状态，使用按位或赋值和相应的 `GAMEPAD_MASK` 枚举来激活输入。 + +```cpp +Gamepad *gamepad = Storage::getInstance().GetGamepad(); +gamepad->state.dpad |= GAMEPAD_MASK_UP; +gamepad->state.dpad |= GAMEPAD_MASK_DOWN; +gamepad->state.dpad |= GAMEPAD_MASK_LEFT; +gamepad->state.dpad |= GAMEPAD_MASK_RIGHT; +``` + +:::note 插件的 SOCD 覆盖 + +所有插件都需要在插件中处理相对的同时方向，因为它们在标准 GPIO 输入已经被 SOCD 覆盖之后才出现。 + +请考虑在 `src/gamepad/GamepadState.cpp` 中使用 `runSOCDCleaner(SOCDMode mode, uint8_t dpad)` 来接收方向键输入，然后在插件的 `process()` 函数中一次性解决它们。 + +::: + +## 按钮 + +要修改游戏控制器的按钮状态，使用按位或赋值和相应的 `GAMEPAD_MASK` 枚举来激活输入。 + +```cpp +Gamepad *gamepad = Storage::getInstance().GetGamepad(); +gamepad->state.buttons |= GAMEPAD_MASK_B1; +gamepad->state.buttons |= GAMEPAD_MASK_B2; +gamepad->state.buttons |= GAMEPAD_MASK_B3; +gamepad->state.buttons |= GAMEPAD_MASK_B4; +gamepad->state.buttons |= GAMEPAD_MASK_L1; +gamepad->state.buttons |= GAMEPAD_MASK_R1; +gamepad->state.buttons |= GAMEPAD_MASK_L2; +gamepad->state.buttons |= GAMEPAD_MASK_R2; +gamepad->state.buttons |= GAMEPAD_MASK_S1; +gamepad->state.buttons |= GAMEPAD_MASK_S2; +gamepad->state.buttons |= GAMEPAD_MASK_L3; +gamepad->state.buttons |= GAMEPAD_MASK_R3; +gamepad->state.buttons |= GAMEPAD_MASK_A1; +gamepad->state.buttons |= GAMEPAD_MASK_A2; +gamepad->state.buttons |= AUX_MASK_FUNCTION; +``` + +## 摇杆 + +要修改游戏控制器的模拟摇杆状态，每个摇杆的 X 轴和 Y 轴必须设置为 0 到 65535 之间的无符号整数。 + +```cpp +GAMEPAD_JOYSTICK_MIN = 0 +GAMEPAD_JOYSTICK_MID = 0x7FFF +GAMEPAD_JOYSTICK_MAX = 0xFFFF +``` + +| 轴 | 值范围 | 摇杆位置 | +| :----- | :------------- | :----------------------- | +| X轴 | 0 - 32767 | 方向左 100% - 0% | +| X轴 | 32767 | 居中 | +| X轴 | 32767 - 65535 | 方向右 0% - 100% | +| Y轴 | 0 - 32767 | 方向上 100% - 0% | +| Y轴 | 32767 | 居中 | +| Y轴 | 32767 - 65535 | 方向下 0% - 100% | + +```cpp +Gamepad *gamepad = Storage::getInstance().GetGamepad(); +gamepad->state.ly = value; +gamepad->state.lx = value; +gamepad->state.ry = value; +gamepad->state.rx = value; +``` + +:::note 模拟输入的 SOCD 覆盖 + +所有插件需要处理模拟摇杆上的相对同时方向，因为固件中没有现有机制来解决此类问题。 + +::: + +## 扳机 + +对于 L2 和 R2 扳机，有两种不同的方法来设置扳机的值。可以使用数字方式或模拟值设置它们。 + +### 数字扳机 + +与其他数字输入类似，使用按位或赋值和相应的 `GAMEPAD_MASK` 枚举来激活输入。 + +```cpp +Gamepad *gamepad = Storage::getInstance().GetGamepad(); +gamepad->state.buttons |= GAMEPAD_MASK_L2; +gamepad->state.buttons |= GAMEPAD_MASK_R2; +``` + +### 模拟扳机 + +要将 L2 和 R2 扳机设置为模拟值，首先必须将游戏控制器的 `hasAnalogTriggers` 标志设置为 `true`，以指示游戏控制器是否具有模拟扳机。默认情况下，此标志设置为 `false`，建议在操作模拟扳机值时设置此标志。 + +然后，应为每个模拟扳机设置适当的轴。模拟扳机的值范围为 0 到 255，其中 0 是完全释放，255 是完全按下。 + +```cpp +GAMEPAD_TRIGGER_MIN = 0; +GAMEPAD_TRIGGER_MID = 0x7F; +GAMEPAD_TRIGGER_MAX = 0xFF; +``` + +```cpp +Gamepad *gamepad = Storage::getInstance().GetGamepad(); +gamepad->hasAnalogTriggers = true; +gamepad->state.lt = value; +gamepad->state.rt = value; +``` diff --git a/i18n/zh/docusaurus-plugin-content-docs-development/current/templates.mdx b/i18n/zh/docusaurus-plugin-content-docs-development/current/templates.mdx new file mode 100644 index 0000000..150eb2b --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs-development/current/templates.mdx @@ -0,0 +1,156 @@ +--- +title: 模板 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "PAGE DESCRIPTION" +--- + +# 模板 + +## 配置模板 + +### README 模板 + +```md +# 板名 + + + +Basic description of the board + +(RP2040 Pinout as a markdown table) +| GPIO Pin | Input/Function | +|:--------:|:--------------:| +| 0 | | +| 1 | | +| 2 | | +| 3 | | +| 4 | | +| 5 | | +| 6 | | +| 7 | | +| 8 | | +| 9 | | +| 10 | | +| 11 | | +| 12 | | +| 13 | | +| 14 | | +| 15 | | +| 16 | | +| 17 | | +| 18 | | +| 19 | | +| 20 | | +| 21 | | +| 22 | | +| 23 | | +| 24 | | +| 25 | | +| 26 | | +| 27 | | +| 28 | | +| 29 | | + +Device Maintainer: [Name, Username, or Business Name](https://github.com/username) +Supported Hardware Variations: List versions/variations that share this configuration +Hardware Availability: List where one can purchase the boards that share this configuration +``` + +## 文档模板 + +### 页面模板 + +```md +--- +title: TITLE +# tags: +# - +pagination_next: null +pagination_prev: null +description: "PAGE DESCRIPTION" +--- + +# Document Title + +CONTENT +``` + +### 插件模板 + +```md +--- +title: ADD-ON NAME +# tags: +# - +pagination_next: null +pagination_prev: null +description: "PAGE DESCRIPTION" +--- + +# Add-On Name + +Purpose: The intended function and purpose of this add-on for an end user. + + + +## Web Configurator Options + +- Web Configurator Option 1 +- Web Configurator Option 2 +- Web Configurator Option 3 + +## Hardware + +### Requirements + +TODO: List any hardware that is required for the intended functioning of this add-on. + +### Installation + +TODO: List instructions on how to install the hardware for use with this add-on. + +## Miscellaneous Notes + +TODO: Provide any miscellaneous notes that an end user may want or need to know with regard to this add-on. +``` + +### 下载页面设置 + +#### 微控制器板 + +```tsx +{ + name: 'Microcontroller Board Name', + configName: 'ConfigName', + pinout: null, + website: 'http://www.example.com/index.html', + image: require('@site/docs/assets/gp2040-ce-placeholder.png').default, + supported: true, + desc: () => ( +
+ Description of Microcontroller board and manufacturer +
+ ), +}, + +``` + +#### 游戏控制器 + +```tsx +{ + name: 'Controller Name', + configName: 'ConfigName', + pinout: null, + website: 'http://www.example.com/index.html', + image: require('@site/docs/gp2040-ce-placeholder.png').default, + category: 'official/open/closed/legacy', + desc: () => ++ Description of the device and maker. +
, +}, +``` diff --git a/i18n/zh/docusaurus-plugin-content-docs/current.json b/i18n/zh/docusaurus-plugin-content-docs/current.json new file mode 100644 index 0000000..d92ba73 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current.json @@ -0,0 +1,30 @@ +{ + "version.label": { + "message": "Next", + "description": "The label for version current" + }, + "sidebar.docSidebar.category.General": { + "message": "通用", + "description": "The label for category General in sidebar docSidebar" + }, + "sidebar.docSidebar.category.FAQ": { + "message": "疑难解答", + "description": "The label for category FAQ in sidebar docSidebar" + }, + "sidebar.docSidebar.category.Controller Building": { + "message": "游戏控制器组装", + "description": "The label for category Controller Building in sidebar docSidebar" + }, + "sidebar.docSidebar.doc.Web Configurator": { + "message": "网页配置器", + "description": "The label for the doc item Web Configurator in sidebar docSidebar, linking to the doc web-configurator/web-configurator" + }, + "sidebar.webConfigSidebar.category.Web Configurator Menu": { + "message": "网页配置器菜单", + "description": "The label for category Web Configurator Menu in sidebar webConfigSidebar" + }, + "sidebar.webConfigSidebar.category.Add-Ons": { + "message": "插件", + "description": "The label for category Add-Ons in sidebar webConfigSidebar" + } +} diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/analog.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/analog.mdx new file mode 100644 index 0000000..4d0b20f --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/analog.mdx @@ -0,0 +1,74 @@ +--- +title: 模拟摇杆 (Analog) +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to use hardware analog joysticks with GP2040-CE" +--- + +# 模拟摇杆 (Analog) + +:::info + +此页面“模拟摇杆”指可以输出向量信号的摇杆硬件，又称类比摇杆，而非对摇杆的“模拟”。 + +::: + +用途：此插件旨在通过 GP2040-CE 使用硬件模拟摇杆，用于游戏控制器的左模拟摇杆和右模拟摇杆。 + + + +## 网页配置器选项 + +- `模拟摇杆 1 X 引脚` - 用于模拟摇杆 1 的 X 值的 GPIO 引脚。此处仅允许使用 ADC 引脚 26、27、28 和 29。 +- `模拟摇杆 1 Y 引脚` - 用于模拟摇杆 1 的 Y 值的 GPIO 引脚。此处仅允许使用 ADC 引脚 26、27、28 和 29。 +- `模拟摇杆 1 模式` - 选择模拟摇杆 1 用作左模拟摇杆或右模拟摇杆。 +- `模拟摇杆 1 反转` - 选择是否翻转模拟摇杆 1 的 X 或 Y 轴输入（或同时翻转）。 +- `模拟摇杆 2 X 引脚` - 用于模拟摇杆 2 的 X 值的 GPIO 引脚。此处仅允许使用 ADC 引脚 26、27、28 和 29。 +- `模拟摇杆 2 Y 引脚` - 用于模拟摇杆 2 的 Y 值的 GPIO 引脚。此处仅允许使用 ADC 引脚 26、27、28 和 29。 +- `模拟摇杆 2 模式` - 选择模拟摇杆 2 用作左模拟摇杆或右模拟摇杆（必须与模拟摇杆 1 不同）。 +- `模拟摇杆 2 反转` - 选择是否反转模拟摇杆 2 的 X 或 Y 轴输入（或同时反转）。 +- `内部死区范围 (%)` - 输入您希望在模拟摇杆上设置的内死区百分比值。 +- `外部死区范围 (%)` - 输入您希望在模拟摇杆上设置的外死区百分比值。 +- `强制圆形` - 强制将模拟摇杆限制在完美圆形内。这对某些游戏可能有益，但请注意，这可能会对某些允许摇杆超出圆形移动的游戏产生负面影响。 +- `自动校准` - 自动校准模拟摇杆。这通过在启动时读取中心偏移并在下次电源循环之前进行补偿来工作。这对存在漂移问题的模拟摇杆可能非常有用。 + +## 硬件 + +### 要求 + +至少需要一个硬件模拟摇杆才能使用此插件。每个摇杆至少有以下 4 个引脚： + +- 参考电压 (ADC_VREF/3.3V) +- X 轴输入电压 (Vx) +- Y 轴输入电压 (Vy) +- 接地 (GND) + +每个轴输入电压引脚都需要一个模拟到数字转换器 (ADC) 引脚来运行。因此，某些板可能对可用摇杆的最大数量有限制（例如，树莓派 Pico 只有 3 个 ADC 引脚可用，因此只能使用 1 个摇杆）。 + +:::note 摇杆按钮 + +模拟摇杆可能有一个额外的引脚用于摇杆按钮。此引脚可以连接到任何 GPIO 引脚，并作为常规按钮使用。 + +::: + +### 安装 + +将模拟摇杆的引脚连接到开发板，如下所示，然后在 `网页配置器 > 功能配置 > 插件配置 > 模拟摇杆` 中设置 GPIO 引脚值： + +- 参考电压 (ADC_VREF/3.3V) -> ADC_VREF/3.3V 引脚 +- X 轴输入电压 (Vx) -> 任意 ADC GPIO 引脚 +- Y 轴输入电压 (Vy) -> 任意 ADC GPIO 引脚 +- 接地 (GND) -> 任意 GND 引脚 + +开发板上的 ADC 引脚具体位置因设计和制造商而异，但在 RP2040 上始终为以下 GPIO 引脚之一： + +- GPIO 26 +- GPIO 27 +- GPIO 28 +- GPIO 29 + +## 其他注意事项 + +支持电位器和霍尔效应类型的摇杆，只要它们使用 3.0-3.3V 的参考电压并输出 0-3.3V 范围内的电压作为 RP2040 的输入即可。这是因为 RP2040 的 GPIO 引脚使用 3.3V 逻辑电平，不支持 5V 电平。 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/bootsel-button.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/bootsel-button.mdx new file mode 100644 index 0000000..d9d5cdd --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/bootsel-button.mdx @@ -0,0 +1,38 @@ +--- +title: BOOTSEL 键配置 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to use the BOOTSEL button as an additional button input" +--- + +# BOOTSEL 键配置 + +用途：此插件旨在允许将 BOOTSEL 键作为额外的按键输入使用。 + + + +## 网页配置器选项 + +- `BOOTSEL 键` - 选择一个输入映射到 BOOTSEL 键。 + +## 硬件 + +### 要求 + +此插件仅适用于具有 BOOTSEL 键的设备。 + +### 安装 + +此插件没有安装说明。 + +## 其他注意事项 + +如果设置了此键，OLED 可能会变得无响应。您可以取消设置以恢复 OLED 功能。 + +:::warning + +`BOOTSEL 键配置` 仅适合有经验的用户使用。 + +::: diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/buzzer-speaker.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/buzzer-speaker.mdx new file mode 100644 index 0000000..3071116 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/buzzer-speaker.mdx @@ -0,0 +1,37 @@ +--- +title: 蜂鸣器 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to add a buzzer to your controller" +--- + +# 蜂鸣器 + +用途：此插件旨在允许您为 GP2040-CE 设备添加蜂鸣器并播放声音。 + + + +## 网页配置器选项 + +- `Use buzzer` - 开启/关闭蜂鸣器模块。 +- `Buzzer Pin` - 用于蜂鸣器的 GPIO 引脚。 +- `Buzzer Volume` - 蜂鸣器的音量，范围为 0-100。 + +## 硬件 + +### 要求 + +- 3-3.3V 压电扬声器 + +扬声器只需要电源 (VCC) 和接地 (GND) 引脚。如果扬声器上有 I/O 引脚，可以将引脚跳线，只使用连接到 RP2040 GPIO 引脚的 VCC。 + +### 安装 + +- 将开发板上的 GPIO 引脚连接到扬声器的 VCC。 +- 在网页配置器中输入 GPIO 引脚。 + +## 其他注意事项 + +无 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/drv8833-rumble.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/drv8833-rumble.mdx new file mode 100644 index 0000000..35f6205 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/drv8833-rumble.mdx @@ -0,0 +1,27 @@ +--- +title: DRV8833 马达震动配置 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to use the DRV8833 Rumble in Xinput mode" +--- + +# DRV8833 马达震动配置 + +用途：此插件允许您在 Xinput 模式下使用 DRV8833 震动功能。 + + + +## 网页配置器选项 + +- `左马达引脚` - DRV8833 上左侧电机 `AIN1` 连接的 GPIO 引脚。 +- `右马达引脚` - DRV8833 上右侧电机 `AIN2` 连接的 GPIO 引脚。 +- `马达休眠引脚` - DRV8833 上 `SLP` 连接的 GPIO 引脚。 +- `PWM 频率` - 电机的 PWM 频率（建议从 10,000 开始，并根据需要调整）。 +- `最小占空比` - 0-255 震动值的最低范围百分比。 +- `最大占空比` - 0-255 震动值的最高范围百分比。 + +### 要求 + +此插件需要一个 DRV8833 电机驱动器或扩展板，以及一个或两个震动电机。 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/dual-direction-input.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/dual-direction-input.mdx new file mode 100644 index 0000000..8445cdb --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/dual-direction-input.mdx @@ -0,0 +1,58 @@ +--- +title: 双重方向输入 (DDI) +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to add more digital DPad, left analog stick, and right analog stick directional inputs to your controller" +--- + +# 双重方向输入 (DDI) + +用途：此插件旨在允许使用额外的数字按钮作为方向输入，支持 D-Pad 或左、右模拟摇杆的最大幅度的基本方向输入。 + + + +## 网页配置器选项 + +:::info GPIO 引脚映射已迁移 + +这些引脚现在可以在 [GPIO 引脚映射页面](../web-configurator/menu-pages/02-gpio-pin-mapping.mdx) 中配置，通过为选定引脚选择正确的选项。 + +- DDI 上 +- DDI 下 +- DDI 左 +- DDI 右 + +::: + +- `双十字键模式` - 选择此功能是否作为 D-Pad、左模拟摇杆或右模拟摇杆的附加实例。 +- `混合模式` - 选择这些方向输入与游戏控制器方向的组合方式。 +- `双重 4 向摇杆模式` - 在 DDI 摇杆上启用 4 向摇杆模式，此模式将阻止非基本方向的输入。当接收到第二个基本方向的输入时，游戏控制器方向将切换到最新的基本方向，类似于 [SOCD 后输入优先](../hotkeys.mdx#socd-后输入优先)。 + +### 双十字键模式 + +- `十字键` 用于十字键模式。 +- `左模拟摇杆` 用于左模拟摇杆模式。 +- `右模拟摇杆` 用于右模拟摇杆模式。 + +### 混合模式 + +- `混合` - 将游戏控制器方向与 DDI 方向结合，并允许使用所有 4 种 SOCD 模式。 +- `游戏控制器覆盖` - 游戏控制器方向优先，当按下时覆盖 DDI，否则游戏控制器和 DDI 独立运行。 +- `DDI 覆盖` - DDI 方向优先，当按下时覆盖游戏控制器方向，否则游戏控制器和 DDI 独立运行。 +- `无` - 游戏控制器方向和 DDI 方向相互独立运行。 + +## 硬件 + +### 要求 + +每个额外的方向输入需要额外的按钮。 + +### 安装 + +对于每个按钮，将按钮的一侧连接到其在网页配置器中分配的对应 GPIO 引脚。将按钮的另一侧连接到 GND。 + +## 其他注意事项 + +“游戏控制器方向”指核心方向（如“上”），而“DDI 方向”指此插件使用的方向（如“DDI 上”）。 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/focus-mode.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/focus-mode.mdx new file mode 100644 index 0000000..2e0ceed --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/focus-mode.mdx @@ -0,0 +1,36 @@ +--- +title: 专注模式配置 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to disable functions and inputs while Focus Mode is enabled" +--- + +# 专注模式配置 + +用途：此插件旨在允许您在启用专注模式时禁用多个功能或输入，但在其他情况下仍可访问它们。 + + + +## 网页配置器选项 + +- `锁定宏` - 启用后，在专注模式下宏触发将无法激活宏序列。 +- `锁定按键` - 启用后，列出的输入在专注模式下将不会被发送。随着输入的添加，将出现新的下拉菜单以供选择更多输入。 + +请注意，专注模式引脚可以在 [GPIO 引脚映射](../web-configurator/menu-pages/gpio-pin-mapping) 页面上设置。 + +## 硬件 + +### 要求 + +设置为 `Focus Mode Pin` 的 GPIO 引脚需要保持低电平以保持专注模式的激活。需要使用拨动开关、滑动开关或锁定开关才能使用 `Focus Mode Pin`。 + +也可以通过快捷键操作 [专注模式切换](../hotkeys.mdx#专注模式切换)（可在 [快捷键设置](../web-configurator/menu-pages/01-settings.mdx#快捷键设置) 中配置）启用或禁用专注模式。按下该快捷键将激活专注模式，按住该快捷键 3 秒将关闭专注模式。 +### 安装 + +安装方式取决于使用的是拨动开关、滑动开关还是锁定开关。通常情况下，将开关的一侧连接到设置为 `Focus Mode Pin` 的 GPIO 引脚。将开关的另一侧或如果有 3 个触点则连接中心触点到任何 GND 引脚。 + +## 其他注意事项 + +无。 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/gamepad-usb-host.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/gamepad-usb-host.mdx new file mode 100644 index 0000000..ebcbcab --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/gamepad-usb-host.mdx @@ -0,0 +1,36 @@ +--- +title: 游戏控制器 USB 主机 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to allow gamepads to be used inline with GP2040-CE" +--- + +# 游戏控制器 USB 主机 + +用途：此插件旨在允许游戏控制器与 GP2040-CE 一起使用。例如，可以将受支持的 USB 游戏控制器插入可用的 USB 主机端口，然后使用该 USB 游戏控制器进行游戏。此功能可以将受支持的游戏控制器转换为适用于其原本不支持的系统。 + + + +## 网页配置器选项 + +目前，您只能启用或禁用此插件。 + +请注意，目前您必须在 `键盘/鼠标主机` 和 `游戏控制器 USB 主机` 之间进行选择。 + +## 硬件 + +要使用此插件，您需要以下之一的游戏控制器： +- Sony Dualshock 4 无线控制器 +- Google Stadia 控制器 +- Ultrastick 360（2015 年之前版本） +- Ultrastick 360 + +### 要求 + +:::note + +请注意，未来可能会增加更多游戏控制器的支持。目前我们不接受添加额外游戏控制器的请求。 + +::: diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/hall-effect-trigger.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/hall-effect-trigger.mdx new file mode 100644 index 0000000..5d02532 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/hall-effect-trigger.mdx @@ -0,0 +1,67 @@ +--- +title: 霍尔效应按键 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to use hall-effect trigger buttons with GP2040-CE" +--- + +# 霍尔效应按键 + +用途：此插件用于单独使用霍尔效应按键，或通过多路复用器扩展板使用霍尔效应按键。 + + + +## 网页配置器选项 + +- `每个多路复用器的通道数` - 多路复用器的通道数量。请注意，如果使用多个多路复用器，它们的通道数必须相同。如果不使用多路复用器而是直接连接，请选择 `直连（无多路复用器）`。 +- `选择引脚 0` - 多路复用器选择引脚所使用的 GPIO 引脚。 +- `选择引脚 1` - 多路复用器选择引脚所使用的 GPIO 引脚。 +- `选择引脚 2` - 多路复用器选择引脚所使用的 GPIO 引脚。 +- `选择引脚 3` - 多路复用器选择引脚所使用的 GPIO 引脚。 +- `ADC 引脚 0` - 第一个多路复用器或单个霍尔效应轴体所使用的 ADC GPIO 引脚。 +- `ADC 引脚 1` - 第二个多路复用器或单个霍尔效应轴体所使用的 ADC GPIO 引脚。 +- `ADC 引脚 2` - 第三个多路复用器或单个霍尔效应轴体所使用的 ADC GPIO 引脚。 +- `ADC 引脚 3` - 第四个多路复用器或单个霍尔效应轴体所使用的 ADC GPIO 引脚。 +- `模拟平滑` - 启用模拟平滑，如果读数存在噪声，此选项可能会有帮助。 +- `平滑系数` - 介于 1 到 99 之间的 EMA（指数移动平均）值。值为 1 时平滑程度最高，值为 99 时平滑程度最低。 + +## 校准 + + + +### 如何校准霍尔效应轴体 + +所有已连接的霍尔效应轴体都需要校准，可以逐个校准，也可以一次性全部校准。在大多数情况下，建议同时校准所有霍尔效应按键，除非您使用了不同类型的霍尔效应轴体。 + +1 - 点击 `全部校准` 按钮，或点击任意一个多路复用器通道对应的磁铁按钮。 +2 - 在不按下按键的情况下，等待 `空闲电压读数` 稳定。 +3 - 点击 `校准空闲` 按钮。 +4 - 将霍尔效应轴体完全按下，在保持轴体完全按下的同时，点击 `校准按下` 按钮。 + + + +也可以点击 `手动调整` 按钮，手动进行高级校准。 + +在高级校准中可以使用以下选项： +- `空闲电压` - 轴体处于空闲状态时的电压。 +- `触发电压` - 轴体处于您希望设置的触发点时的电压。 +- `按下电压` - 轴体处于最大按下值时的电压。 +- `翻转极性` - 暂不支持。 + +`触发点读数` 部分会在您按下霍尔效应轴体时实时显示其状态。 + +如果您处于 `全部校准` 界面，将会看到一个 `覆盖所有按键` 按钮，用于覆盖所有之前保存的设置。 + +## 霍尔效应电压表 + + + +霍尔效应电压表会汇总显示您的霍尔效应轴体当前的所有设置。 + +:::note + +在网页配置器中切换到其他页面或重启进入控制器模式之前，请务必点击 `保存按键数值`，否则您的更改将不会被保存。 + +::: diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/i2c-analog-ads1219.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/i2c-analog-ads1219.mdx new file mode 100644 index 0000000..46612ef --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/i2c-analog-ads1219.mdx @@ -0,0 +1,67 @@ +--- +title: I2C Analog ADS1219 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to use an ADS1219 ADC for Left and Right analog joysticks on your controller" +--- + +import I2CTable from "../snippets/_i2c-block-table.mdx"; + +# I2C Analog ADS1219 + +用途：此插件旨在使用 ADS1219 24 位模拟-数字转换器（ADC）添加左右模拟摇杆功能。 + + + +## 网页配置器选项 + +:::info GPIO 引脚分配 + +I2C 的 SDA 和 SCL 引脚以及速度现在可以在 [`配置 > 外围设备映射 - I2C`](../web-configurator/menu-pages/03-peripheral-mapping.mdx#i2c) 中进行配置。 + +::: + +- `I2C Analog ADS1219 模块` - 要使用的 I2C 块（i2c0 或 i2c1）。 +- `I2C Analog ADS1219 地址` - 根据 SDA 和 SCL 引脚的使用情况设置 I2C 模拟 ADS1219 的地址，详见以下表格。 + +| A0 | A1 | I2C 地址 | +| :-: | --- | :---------: | +| SDA | SCL | 1001110 | +| SCL | SDA | 1001011 | + +## 硬件 + +### 要求 + +此插件需要 ADS1219 模数转换器（ADC）才能正常工作。 + +### 安装 + +根据以下表格连接 ADS1219 的引脚： + +| ADS1219 引脚 | 功能 | +| :----------: | ------------------------ | +| A0 | SDA 或 SCL | +| A1 | SDA 或 SCL | +| AIN0 | 左模拟摇杆 X 轴 | +| AIN1 | 左模拟摇杆 Y 轴 | +| AIN2 | 右模拟摇杆 X 轴 | +| AIN3 | 右模拟摇杆 Y 轴 | + ++ +:::info A0/A1 GPIO 分配 + +这些引脚需要连接到 RP2040 上的适当 SDA/SCL 引脚，并在网页配置器中设置正确的 I2C 块。 + +有关设置 I2C 的更多信息，请参阅 [外围设备映射](../web-configurator/menu-pages/03-peripheral-mapping.mdx#i2c)。 + +::: + +## 其他注意事项 + +这些安装说明仅涵盖 ADS1219 ADC 的连接，不包括使用 ADS1219 ADC 所需的额外电路。 + +[ADS1219 产品说明](https://www.ti.com/lit/ds/symlink/ads1219.pdf) diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/i2c-analog-ads1256-spi.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/i2c-analog-ads1256-spi.mdx new file mode 100644 index 0000000..f4a25d3 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/i2c-analog-ads1256-spi.mdx @@ -0,0 +1,33 @@ +--- +title: Analog ADS1256 (SPI) +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to use ADS1256 SPI for compatible accessories (currently in early beta)" +--- + +# Analog ADS1256（SPI） + +用途：此插件旨在允许您使用与 ADS1256 SPI 兼容的配件（目前处于早期测试阶段）。 + + + +## 网页配置器选项 + +:::info GPIO 引脚分配 + +`SPI 模块`、`Chip Select (CS) 引脚` 和 `Data Ready (DRDY) 引脚` 现在可以在 [`配置 > 外围设备映射 - SPI`](../web-configurator/menu-pages/03-peripheral-mapping.mdx#spi) 中进行配置。 + +::: + +- `SPI 模块` - 要使用的 SPI 模块（spi0 或 spi1）。 +- `Chip Select (CS) 引脚` - 用于片选的 GPIO 引脚。 +- `Data Ready (DRDY) 引脚` - 用于数据准备的 GPIO 引脚。 +- `模拟最大值` - 将使用的最大电压，可在此选择 `3.3V` 或 `5V`。 + +## 硬件 + +### 要求 + +请注意，此插件目前处于早期测试阶段，尚未提供使用示例。 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/input-history.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/input-history.mdx new file mode 100644 index 0000000..55f711c --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/input-history.mdx @@ -0,0 +1,55 @@ +--- +title: 输入历史 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to show input history" +--- + +# 输入历史 + +用途：此插件旨在允许您显示输入历史。 + + + +## 网页配置器选项 + +- `History length` - 设置历史记录的最大字符长度。 +- `Column` - 指定历史记录在显示屏上开始的列位置。（0 - 左侧，20 - 右侧） +- `Row` - 指定历史记录在显示屏上出现的行位置。（0 - 顶部，7 - 底部） + +## 硬件 + +### 要求 + +已配置的 [单色显示屏](../web-configurator/menu-pages/07-display-configuration.mdx)。 + +### 安装 + +无需安装。 + +## 其他说明 + +输入 - 符号映射： + +| GP2040-CE | PS3 | Switch | XINPUT | 键盘 | PS4 | 配置 | +|-----------|:---:|:------:|:------:|:----:|:---:|:----:| +| 上 | U | U | U | U | U | U | +| 下 | D | D | D | D | D | D | +| 左 | L | L | L | L | L | L | +| 右 | R | R | R | R | R | R | +| B1 | X | B | A | B1 | X | B1 | +| B2 | O | A | B | B2 | O | B2 | +| B3 | # | Y | X | B3 | # | B3 | +| B4 | ^ | X | Y | B4 | ^ | B4 | +| L1 | L1 | L | LB | L1 | L1 | L1 | +| R1 | R1 | R | RB | R1 | R1 | R1 | +| L2 | L2 | ZL | LT | L2 | L2 | L2 | +| R2 | R2 | ZR | RT | R2 | R2 | R2 | +| S1 | SL | - | BK | S1 | SH | S1 | +| S2 | ST | + | ST | S2 | OP | S2 | +| L3 | L3 | LS | LS | L3 | L3 | L3 | +| R3 | R3 | RS | RS | R3 | R3 | R3 | +| A1 | PS | H | G | A1 | PS | A1 | +| A2 | A2 | C | A2 | A2 | T | A2 | diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/input-reverse.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/input-reverse.mdx new file mode 100644 index 0000000..2f522a5 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/input-reverse.mdx @@ -0,0 +1,43 @@ +--- +title: 输入反转 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to use a button to reverse cardinal directions of the DPad of your controller" +--- + +# 输入反转 + +用途：此插件允许用户通过按下或按住一个额外的按钮，细化地反转、置于中立或保持游戏控制器上的基本方向不变，并输入新的方向。 + + + +## 网页配置器选项 + +- `反转输入引脚` - 用于反转输入按钮的 GPIO 引脚。 +- `反转输入引脚 LED` - 用于反转输入 LED 的 GPIO 引脚。 +- `反转上` - 当按下或按住反转输入按钮时，启用上方向反转。 +- `反转下` - 当按下或按住反转输入按钮时，启用下方向反转。 +- `反转左` - 当按下或按住反转输入按钮时，启用左方向反转。 +- `反转右` - 当按下或按住反转输入按钮时，启用右方向反转。 + +四个方向中的每一个都可以独立设置以下三种行为之一，当按住反转输入引脚时生效： + +- `禁用` - 此方向不发生变化（例如，上 + 反转 = 上）。 +- `启用` - 此方向被反向激活（例如，左 + 反转 = 右）。 +- `中立` - 此方向被置于中立（例如，下 + 反转 = 中立）。 + +## 硬件 + +### 要求 + +此插件需要一个额外的按钮映射到 GPIO 引脚。 + +### 安装 + +对于街机按钮和键盘开关，两侧的触点需要分别连接到 GPIO 引脚（例如，通过导线或 PCB 上的走线）和接地（例如，通过导线或 PCB 上的走线）。 + +## 其他说明 + +无。 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/keyboard-mouse-host.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/keyboard-mouse-host.mdx new file mode 100644 index 0000000..8df4fa4 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/add-ons/keyboard-mouse-host.mdx @@ -0,0 +1,98 @@ +--- +title: 键盘/鼠标主机配置 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "Add-on to use a USB keyboard in conjunction with GP2040-CE to send inputs to supported systems" +--- + +import InputLabelSelector, { + Hotkey, +} from "@site/src/components/LabelSelector.tsx"; +import InstallUSBHostPort from "../snippets/_add-usb-host-port.mdx"; + +选择要在使用指南中显示的按键标签： + +
+ +:::info 此页面并非键盘输入模式设置 + +此插件的用法是将键盘插入游戏控制器的 USB 接口上，通过按下键盘上的按键，由 GP2040-CE 将键盘信号转换为其它支持的输入模式信号。 + +如果您想让游戏控制器输出键盘信号，请前往 [`系统设置 > 输入模式设置`](../web-configurator/menu-pages/01-settings.mdx#键盘映射)，将 `当前输入模式` 更改为 `键盘`。 + +::: + +用途：此插件旨在允许将键盘和/或鼠标作为 GP2040-CE 的输入，并将其映射为其他输入，发送到受支持的系统。 + + + +## 网页配置器选项 + +:::info GPIO 引脚分配 + +USB 主机端口的 Data、5V Enable 和 Pin Orientation 选项现在在 [`功能配置 > 外围设备映射 - USB 主机`](../web-configurator/menu-pages/03-peripheral-mapping.mdx#usb-主机) 中配置。 + +::: + +## 键盘 + +### 默认按键绑定 + +| GP2040 | 键盘按键 | +| -------------------------------- | ------------ | +|
+ +用途：此插件旨在允许您使用 GP2040-CE 作为适配器，将 NES 游戏控制器、SNES 游戏控制器或 Super NES 鼠标连接到支持的系统。 + + + +## 网页配置器选项 + +- `CLOCK Pin` - 用于 SNES CLOCK 的 GPIO 引脚。 +- `LATCH Pin` - 用于 SNES LATCH 的 GPIO 引脚。 +- `DATA Pin` - 用于 SNES DATA 的 GPIO 引脚。 + +支持的游戏控制器类型及其映射如下： + +| GP2040 | NES | SNES | Super NES Mouse | +| ----------------------------- | ------ | ------ | --------------- | +|
USB 接口 --> 游戏控制器([游戏控制器]) -- 主机上的
USB接口 --> 主机{{主机}} +``` + +
+ +:::caution 不正确的通过认证设备连接方式 + +许多用户错误地将游戏控制器插入转换器/适配器，然后再将转换器/适配器插入主机。这种连接方式并非通过认证的预期用法，会导致转换器/适配器处理输入从而增加延迟。 + +请勿按如下方式进行连接： + +```mermaid +graph LR +游戏控制器([游戏控制器]) -- 转换器上的
USB接口 --> 转换器/适配器/加密狗 -- 主机上的
USB接口 --> 主机{{主机}} +``` + +::: + +## PlayStation + +### 为什么我的游戏控制器在 PS4 或 PS5 上使用一段时间后不再响应？ + +PS4 和 PS5 使用认证机制确保仅限授权游戏控制器在主机上使用。如果设备未实现该认证机制，游戏控制器将在 8 分钟后超时。 + +在 PC 上使用 PS4 输入模式则不会出现超时，不过建议在 PC 上使用 XInput 模式以获得最佳兼容性。 + +### 什么是 8 分钟超时？ + +8 分钟超时机制如下： + +1. 将游戏控制器插入 PS4/5。 +2. 按下 PS 按钮初始化游戏控制器。 +3. 大约 8 分钟后游戏。 +4. 由于认证失败，主机拒绝游戏控制器。 +5. 用户拔下停止响应的游戏控制器。 +6. 返回第 1 步并重复上述过程。 + +### 如何避免 8 分钟超时？ + +GP2040-CE 提供多种方法避免 8 分钟超时。建议根据是否在 PS4 或 PS5 上使用游戏控制器选择对应的方法。 + +- 对于 PS4，可使用 [PS4 输入模式](../web-configurator/menu-pages/01-settings.mdx#额外的-ps4-设置) 或 [PS5 输入模式](../web-configurator/menu-pages/01-settings.mdx#额外的-ps5-设置)。 +- 对于 PS5，只能使用 [PS5 输入模式](../web-configurator/menu-pages/01-settings.mdx#额外的-ps5-设置)。 + +### 如何让我的 GP2040-CE 设备在 PS4 或 PS5 上工作？ + +- **PS4**：需要使用 [PS4 输入模式](../web-configurator/menu-pages/01-settings.mdx#额外的-ps4-设置) 或 [PS5 输入模式](../web-configurator/menu-pages/01-settings.mdx#额外的-ps5-设置)。 +- **PS5**：不能使用 [PS4 输入模式](../web-configurator/menu-pages/01-settings.mdx#额外的-ps4-设置)，必须使用 [PS5 输入模式](../web-configurator/menu-pages/01-settings.mdx#额外的-ps5-设置)。 + +### 什么是 PS4 输入模式？ + +PS4 输入模式是一种允许 GP2040-CE 与 PS4 主机兼容的输入模式。可以通过上传密钥文件或使用带通过认证设备的 USB 主机端口来绕过 8 分钟超时。 + +
+ +:::note + +所有以下快捷键绑定都可以在网页配置器的 [快捷键设置](./web-configurator/menu-pages/01-settings.mdx#快捷键设置) 中更改或分配为不同的按钮组合。 + +::: + +## 无 + +此快捷键无功能。使用这个快捷键来禁用特定的快捷键组合。 + +## 十字键模式 + +此快捷键将方向模式更改为读取为十字键上的数字输入。 + +**默认**:
+ +:::note + +要使用迷你菜单，必须连接一个 OLED 显示屏。大多数设备需要在 [网页配置器](/web-configurator) 中进行特殊配置以允许使用迷你菜单。 + +::: + +## 设置迷你菜单 + +要设置迷你菜单，您需要备用的 GPIO 引脚用于专用迷你菜单控制，或通过快捷键添加控制的能力。 + +迷你菜单中有 7 个可分配的输入： + +- `Menu Up` - 在迷你菜单中向上导航。 +- `Menu Down` - 在迷你菜单中向下导航。 +- `Menu Left` - 在迷你菜单中向左导航。 +- `Menu Right` - 在迷你菜单中向右导航。 +- `Menu Select` - 在迷你菜单中选择或前进。 +- `Menu Back` - 在迷你菜单中后退。 +- `Menu Toggle` - 切换迷你菜单的开启或关闭。 + +在大多数情况下，建议打开 `Fn` 开关，并使用 Function 键组合其他按键来导航迷你菜单。 + + + +或者，以下配置需要将 `Menu Toggle` 分配到一个引脚，并在 [游戏控制器设置](./web-configurator/menu-pages/settings#游戏控制器设置) 中开启 `Use Gamepad Input for Display Mini Menu`。 + + + +将 `Menu Toggle` 分配到一个引脚后，转到 [游戏控制器设置](./web-configurator/menu-pages/settings#游戏控制器设置)，启用 `Use Gamepad Input for Display Mini Menu` 。请注意，在选择此选项时，迷你菜单的输入也会输出到您的游戏控制器。 + + + +设置 `Menu Toggle` 和 `Use Gamepad Input for Display Mini Menu` 选项后，迷你菜单现在只需要一个引脚分配即可操作。在此模式中，可以使用
+ +:::note + +对于 `D+` 和 `D-`，RP2040 上的任意 GPIO 引脚都可以使用。但有一个要求，即 `D-` GPIO 必须紧接在 `D+` 之前或之后（即 `D+` = GPIO 引脚 X -> `D-` 必须是 X+1 或 X-1）。 + +::: + +
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 | - | - | - | - | - | - | diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/snippets/_input-table.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/snippets/_input-table.mdx new file mode 100644 index 0000000..6ccbf37 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/snippets/_input-table.mdx @@ -0,0 +1,16 @@ +| 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 | diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/snippets/_pin-options-USB-Host.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/snippets/_pin-options-USB-Host.mdx new file mode 100644 index 0000000..55f9557 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/snippets/_pin-options-USB-Host.mdx @@ -0,0 +1,9 @@ +- `D+` - 用于在 USB 主机端口和 RP2040 之间传输 Data Plus 的 GPIO 引脚。 +- `D-` - 用于在 USB 主机端口和 RP2040 之间传输 Data Minus 的 GPIO 引脚。此引脚无法手动设置，将根据 `D+` 自动确定。 +- `5V Power (可选)` - 用于为板上的主机端口启用 5V 电源的 GPIO 引脚。 + +:::note 5V 电源 + +这仅适用于少量板子（例如 Adafruit RP2040 Feather USB Host），大多数板子不需要设置此选项。 + +::: diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/snippets/_spi-block-table.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/snippets/_spi-block-table.mdx new file mode 100644 index 0000000..cd6a835 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/snippets/_spi-block-table.mdx @@ -0,0 +1,10 @@ +| RX | CS | CLK | TX | SPI Block | +| :--: | :--: | :--: | :--: | :-------: | +| GP00 | GP01 | GP02 | GP03 | **SPI0** | +| GP04 | GP05 | GP06 | GP08 | **SPI0** | +| GP08 | GP09 | GP10 | GP11 | **SPI1** | +| GP12 | GP13 | GP14 | GP15 | **SPI1** | +| GP16 | GP17 | GP18 | GP19 | **SPI0** | +| GP20 | GP21 | GP22 | GP23 | **SPI0** | +| GP24 | GP25 | GP26 | GP27 | **SPI1** | +| GP28 | GP29 | ---- | ---- | **SPI1** | diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/usage.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/usage.mdx new file mode 100644 index 0000000..972b541 --- /dev/null +++ b/i18n/zh/docusaurus-plugin-content-docs/current/usage.mdx @@ -0,0 +1,143 @@ +--- +title: 使用指南 +# tags: +# - +pagination_next: null +pagination_prev: null +description: "General How-To on using GP2040-CE" +--- + +import InputLabelSelector, { + Hotkey, +} from "@site/src/components/LabelSelector.tsx"; +import Tabs from "@theme/Tabs"; +import TabItem from "@theme/TabItem"; +import InputTable from "./snippets/_input-table.mdx"; +import InputTableMiniClassic from "./snippets/_input-table-mini-classic.mdx"; + +# GP2040-CE 使用指南 + +选择要在使用指南中显示的按键标签： + +
+ +:::caution + +v0.5+ 版本对除树莓派 Pico 以外的其他开发板有重大更改。如果您使用的是这些开发板，请勿从旧版本更新，除非您有已知正常版本的 .uf2 备份，或您清楚自己在做什么。 + +::: + +## 按键 + +GP2040-CE 使用通用按键标记来表示游戏控制器状态，然后在发送前转换为适当的输入类型。下表提供了 GP2040-CE 按键与支持的输入类型和布局的映射： + +
+ 
+ {name}
+
+ );
+};
+
+# Community Splash Screens
+
+Here is a collection of community created splash screens that can be used with an optional OLED screen. Upload the image using the web configurator to set it up.
+
+All images been formatted to 128x64 in black / white color.
+
+## GP2040-CE
+
+
+
+
+## Vendors
+
+
+
+
+## Video Games
+
+
+
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/web-configurator/menu-pages/00-home.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/web-configurator/menu-pages/00-home.mdx
new file mode 100644
index 0000000..fd56024
--- /dev/null
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/web-configurator/menu-pages/00-home.mdx
@@ -0,0 +1,48 @@
+---
+title: 主页
+# tags:
+# -
+# pagination_next: null
+pagination_prev: null
+description: "Home page for the GP2040-CE Web Configurator"
+---
+
+# 网页配置器 - 主页
+
+
+
+您可以在此查看设备的系统状态。
+
+-----
+
+## 版本
+
+`设备名称` - 这将告诉您设备的名称以及上传到设备上的 UF2 文件的名称。
+
+`当前` - 设备上正在运行的固件的当前版本。
+
+`最新` - 在我们的发布区中可用的最新固件版本。
+
+`架构` - 当前构建版本的芯片架构。
+
+`构建类型` - 这将告诉您当前构建的类型。
+
+`构建` - 这将告诉您当前构建所基于的提交（commit）。
+
+-----
+
+## 闪存
+
+本节显示了有关闪存模块的各种状态。
+
+:::note
+
+GP2040-CE 要求设备至少具有 2MB 闪存（这是树莓派 Pico 的标准配置）。
+
+有少量报告称，来自淘宝（AliExpress）等地方的一些低成本仿制设备只配备了 1MB 闪存。
+
+应避免使用只有 1MB 闪存的设备，因为它们可能无法工作或无法按预期工作。
+
+如果您正在制作自己的设备，请确保使用至少 2MB 的闪存模块。
+
+:::
diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/web-configurator/menu-pages/01-settings.mdx b/i18n/zh/docusaurus-plugin-content-docs/current/web-configurator/menu-pages/01-settings.mdx
new file mode 100644
index 0000000..ea49f71
--- /dev/null
+++ b/i18n/zh/docusaurus-plugin-content-docs/current/web-configurator/menu-pages/01-settings.mdx
@@ -0,0 +1,216 @@
+---
+title: 系统设置
+# tags:
+# -
+# pagination_next: null
+# pagination_prev: null
+description: "Select the input mode, DPad Mode, SOCD Cleaning Mode, etc. and configure Hotkey Shortcuts"
+---
+
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+# 系统设置
+
+## 输入模式设置
+
+
+
+- `当前输入模式` - 选择此连接设备在通电时启动的主要输入模式（XInput、 DInput、 Switch、 PS4 、 HID-Keyboard 等）。此选择将在断开连接并重新插入游戏控制器后保持不变。
+- `输入模式控制器类型` - 选择此控制器的子类型（请注意，除 `游戏手柄` 外的其他类型均为实验性功能）
+- `认证设置` - 如果模式需要认证，请选择一种认证方法。
+
+:::note
+
+Xinput 在 PC 上无需任何认证即可工作。如果您希望在 Xbox 360 上使用，请选择 USB 认证并连接适当的认证设备。
+
+:::
+
+
+
+GP2040-CE 允许您覆盖部分 USB 描述符信息。这些设置仅在您明确知道自己在做什么时进行更改。
+
+- `Product Name` - 您希望设备在设备列表中显示的名称
+- `Manufacturer` - 您希望设备详情中显示的制造商名称
+- `Version` - 您希望分配给设备详情的版本
+
+在 `Override Physical IDs` 下还有一层额外的 USB 设备信息可以更改。
+
+- `Vendor ID` - 供应商 ID 描述符
+- `Product ID` - 产品 ID 描述符
+
+:::warning
+
+请注意，更改 `Advanced USB Override` 或 `Override Physical IDs` 中的任何选项可能会导致输入模式无法正常工作。
+
+GP2040-CE 团队不对因更改这些设置而引发的问题提供支持。
+
+:::
+
+### 键盘映射
+
+在此，您可以将 GP2040-CE 按钮重新映射为不同的键盘键码，当按下键盘模式时，这些键码会发送到 PC 或游戏主机。
+
+
+
+### 额外的 PS4 设置
+
+
+
+- `输入模式控制器类型` - 选择此控制器的子类型（请注意，除 `游戏手柄` 外的其他类型均为实验性功能）
+- `触摸板(Touchpad)和分享键(Share)互换` - 分享键现在将映射到 A2 而不是 S1 ，触摸板现在将映射到 S1 而不是 A2 。
+- `识别模式` 是一种允许在需要真正 DualShock 4 的情况下使用的选项。由于技术原因，这并不会使设备成为真正的 DS4 ，但它确实使固件行为更像 DS4 。
+ - `主机模式` - 这是大家熟悉的模式。它在 PS4/PS5 上工作，并具有您期望的授权限制。
+ - `串流/模拟模式` - 用于只能使用 DualShock 4 的情况，但不一定需要任何形式的透传授权。 PS Remote Play 仅允许“真实”的 DualShock 4/DualSense 游戏控制器，但目前似乎不需要授权。带有 PADEMU USB 游戏控制器驱动程序的 Open PS2 Loader (OPL) 版本仅寻找“真实”的 DualShock 3/4 游戏控制器，但不需要授权即可工作。
+在直接使用 PS4/PS5 主机时，使用主机模式将允许游戏控制器按预期运行。这是默认模式。在直接使用串流/模拟模式时，由于技术原因，游戏控制器不会被检测到。
+在通过 PS Remote Play 游戏时，由于主机模式无法显示为真实的 DualShock 4 游戏控制器，因此不会被检测到。使用第三方串流客户端（如 Chiaki）则没有此限制。
+除非 PS Remote Play 有具体变化，否则串流/模拟模式不需要授权。
+- `认证设置`
+ - `上传密钥文件` - 上传从 DualShock 4 获取的密钥文件以认证并绕过 PS4 的 8 分钟超时限制
+ - `主机 USB` - 使用加密狗、转换器或授权的 PS4 游戏控制器认证您的 GP2040-CE 设备
+
++ +GP2040-CE 包含一个内置的基于 Web 的配置应用程序，您可以通过在将游戏控制器插入 PC 时按住
+ +  + +
+ ++ 基于RP2040的多平台游戏控制器固件 +
+ +
+ 
+ 
+ GP2040-CE（社区版）是一款用于树莓派 Pico 和其他基于 RP2040 微控制器的游戏控制器固件，结合了多平台兼容性、低延迟和丰富的功能集，为用户提供了无限的自定义可能性，同时不牺牲性能。 +
+ ++ GP2040-CE 兼容 PC、PS3、PS4、PS5、Nintendo Switch、Xbox One、Steam Deck、MiSTer 和 Android。 +
+ +## 链接 + +[下载](./downloads) | [安装](/installation) | [接线](/controller-build/wiring) | [使用](/usage) | [常见问题](/faq/faq-general) | [GitHub](https://github.com/OpenStickCommunity/GP2040-CE) + +## 功能 + +- 可选择 13 种输入模式，包括 X-Input、Nintendo Switch、Playstation 4/5、Xbox One、D-Input 和键盘模式 +- Xinput 平均输入延迟为 0.76ms，Playstation 5 平均输入延迟为 0.90ms +- 多种 SOCD 覆盖模式 - 上优先（又称无摇杆模式）、回中、后输入优先和先输入优先 +- 通过方向键输入模拟左摇杆和右摇杆，以及专用切换开关 +- 方向键 + LS/RS 双方向输入支持 +- 按钮反转输入支持 +- [连发 (Turbo) 和 Turbo LED](/add-ons/turbo)，支持速度选择 +- 每个按钮支持 RGB LED +- PWM 玩家指示灯 LED 支持（仅限 XInput） +- 支持多种 LED 配置文件 +- 支持 128x64 单色 I2C 显示屏 - 兼容 SSD1306、SH1106 和 SH1107 +- 自定义启动画面，支持通过网页配置轻松上传图像 +- 支持被动蜂鸣器扬声器（3V 或 5V） +- [内置嵌入式网页配置器](/web-configurator) - 无需下载！ + +访问 [GP2040-CE 使用指南](/usage) 页面了解更多详情。 + +## 性能 + +输入延迟使用 [WydD 的 inputlag.science 网站](https://inputlag.science/controller/methodology) 中描述的方法进行测试，固件使用默认的 1000 Hz（1ms）轮询率。您可以在 [这里](https://github.com/OpenStickCommunity/Site/blob/main/latency_testing/README.md) 阅读我们用于延迟测试的设置，以便自行测试或了解用于测试的设备。 + +| 版本 | 模式 | 轮询率 | 最小值 | 最大值 | 平均值 | 标准差 | 准时概率 | 1帧跳过概率 | 2帧跳过概率 | +| ------- | --------- | -------- | -------- | -------- | -------- | -------- | ---------- | ------------- | ------------- | +| v0.7.11 | Xinput | 1 ms | 0.45 ms | 1.28 ms | 0.76 ms | 0.24 ms | 98.48% | 1.52% | 0% | +| v0.7.11 | Switch | 1 ms | 0.41 ms | 1.23 ms | 0.72 ms | 0.24 ms | 98.53% | 1.47% | 0% | +| v0.7.11 | HID USB | 1 ms | 0.41 ms | 1.30 ms | 0.72 ms | 0.24 ms | 98.53% | 1.47% | 0% | +| v0.7.11 | PS3 | 1 ms | 0.52 ms | 1.46 ms | 0.83 ms | 0.24 ms | 98.38% | 1.62% | 0% | +| v0.7.11 | PS4 | 1 ms | 0.55 ms | 2.37 ms | 0.90 ms | 0.32 ms | 98.19% | 1.81% | 0% | +| v0.7.11 | PS5 | 1 ms | 0.55 ms | 2.37 ms | 0.91 ms | 0.33 ms | 98.17% | 1.83% | 0% | + +完整测试结果可在 [GP2040-CE v0.7.11 固件延迟测试结果.xlsx](https://github.com/OpenStickCommunity/Site/raw/main/latency_testing/GP2040-CE_Firmware_Latency_Test_Results_v0.7.11.xlsx) 表中找到。 + +v0.7.10 的结果可在 [这里](https://github.com/OpenStickCommunity/Site/raw/main/latency_testing/GP2040-CE_Firmware_Latency_Test_Results_v0.7.10.xlsx) 找到。之前的测试结果可在 [`latency_testing`](https://github.com/OpenStickCommunity/Site/tree/main/latency_testing) 文件夹中找到。 + +## 支持 + +如果您希望讨论功能、问题或任何与 GP2040-CE 相关的内容，请 [创建 issue](https://github.com/OpenStickCommunity/GP2040-CE/issues/new) 或加入 [OpenStick GP2040-CE Discord](https://discord.gg/k2pxhke7q8) 支持频道。 + +## 贡献 + +希望帮助改进 GP2040-CE？有很多方式可以参与！ + +### 社区参与 + +有一个很酷的新功能想法，或者只是想与开发人员讨论一些技术细节？加入 [OpenStick GP2040-CE Discord](https://discord.gg/k2pxhke7q8) 服务器，与我们活跃且不断壮大的社区互动！ + +### 拉取请求 + +欢迎并鼓励提交拉取请求以进行功能增强、错误修复和文档更新。 + +请遵守您正在处理的文件的编码风格，并在存在 `.editorconfig` 文件时强制使用。 + +## 致谢 + +- [FeralAI](https://github.com/FeralAI) 构建了 [GP2040](https://github.com/FeralAI/GP2040)，为这个社区项目奠定了基础 +- Ha Thach 的优秀 [TinyUSB 库](https://github.com/hathach/tinyusb) 示例 +- fluffymadness 的 [tinyusb-xinput](https://github.com/fluffymadness/tinyusb-xinput) 示例 +- Kevin Boone 的 [关于使用 RP2040 闪存作为模拟 EEPROM 的博客文章](https://kevinboone.me/picoflash.html) +- [bitbank2](https://github.com/bitbank2) 提供的 [OneBitDisplay](https://github.com/bitbank2/OneBitDisplay) 和 [BitBang_I2C](https://github.com/bitbank2/BitBang_I2C) 库，这些库已移植用于 Pico SDK +- [arntsonl](https://github.com/arntsonl) 提供了出色的清理和功能增强，使我们达到了 v0.5.0 +- [alirin222](https://github.com/alirin222) 提供了出色的 Turbo 代码（在 Twitter 上为 [@alirin222](https://twitter.com/alirin222)） +- [deeebug](https://github.com/deeebug) 改进了 Web-UI 并修复了 PS3 Home 按钮问题 +- [TheTrain](https://github.com/TheTrainGoes/GP2040-Projects) 和 [Fortinbra](https://github.com/Fortinbra) 帮助推动我们的社区发展 +- [PassingLink](https://github.com/passinglink/passinglink) 提供了有关 PS4 实现的技术细节和代码 +- [Youssef Habchi](https://youssef-habchi.com/) 允许我们购买 Road Rage 字体的使用许可 +- [tamanegitaro](https://github.com/tamanegitaro/) 和 [alirin222](https://github.com/alirin222) 为迷你/经典游戏控制器工作提供了基础 +- [Ryzee119](https://github.com/Ryzee119) 提供了出色的 [ogx360_t4](https://github.com/Ryzee119/ogx360_t4/) 和 xid_driver 库，用于支持原版 Xbox +- [Santroller](https://github.com/Santroller/Santroller) 和 [GIMX](https://github.com/matlo/GIMX) 提供了使用直通认证 Xbox One 的技术示例 diff --git a/i18n/zh/docusaurus-theme-classic/navbar.json b/i18n/zh/docusaurus-theme-classic/navbar.json new file mode 100644 index 0000000..919b4a1 --- /dev/null +++ b/i18n/zh/docusaurus-theme-classic/navbar.json @@ -0,0 +1,22 @@ +{ + "logo.alt": { + "message": "GP2040-CE Logo", + "description": "The alt text of navbar logo" + }, + "item.label.Documentation": { + "message": "文档", + "description": "Navbar item with label Documentation" + }, + "item.label.Web Config": { + "message": "网页设置", + "description": "Navbar item with label Web Config" + }, + "item.label.Contribute": { + "message": "贡献", + "description": "Navbar item with label Contribute" + }, + "item.label.Downloads": { + "message": "下载", + "description": "Navbar item with label Downloads" + } +} diff --git a/src/components/Download.tsx b/src/components/Download.tsx index 1cea082..3a80263 100644 --- a/src/components/Download.tsx +++ b/src/components/Download.tsx @@ -3,6 +3,7 @@ import styles from './download.module.css'; import LinkIcon from './LinkIcon'; import boards from '../config/boards'; import { useGitHubInfo } from '../hooks/useGitHubInfo'; +import { translate } from '@docusaurus/Translate'; const createDownloadLink = ({ releaseVersion, configName }) => releaseVersion @@ -31,10 +32,28 @@ const RenderDownloadBox = ({{desc()}
diff --git a/src/components/LabelSelector.tsx b/src/components/LabelSelector.tsx
index a45a983..fb956af 100644
--- a/src/components/LabelSelector.tsx
+++ b/src/components/LabelSelector.tsx
@@ -3,6 +3,7 @@ import Select from 'react-select';
import { create } from 'zustand';
import styles from '@site/src/components/labelselector.module.css';
import { persist } from 'zustand/middleware';
+import { translate } from '@docusaurus/Translate';
const inputLabels = [
{ value: 'GP2040', label: 'GP2040' },
@@ -16,158 +17,158 @@ const inputLabels = [
const labelData = {
GP2040: {
- name: 'GP2040',
- Up: 'Up',
- Down: 'Down',
- Left: 'Left',
- Right: 'Right',
- B1: 'B1',
- B2: 'B2',
- B3: 'B3',
- B4: 'B4',
- L1: 'L1',
- R1: 'R1',
- L2: 'L2',
- R2: 'R2',
- S1: 'S1',
- S2: 'S2',
- L3: 'L3',
- R3: 'R3',
- A1: 'A1',
- A2: 'A2',
- Function: 'Function',
+ name: translate({id: 'GP2040.name', message: 'GP2040'}),
+ Up: translate({id: 'GP2040.Up', message: 'Up'}),
+ Down: translate({id: 'GP2040.Down', message: 'Down'}),
+ Left: translate({id: 'GP2040.Left', message: 'Left'}),
+ Right: translate({id: 'GP2040.Right', message: 'Right'}),
+ B1: translate({id: 'GP2040.B1', message: 'B1'}),
+ B2: translate({id: 'GP2040.B2', message: 'B2'}),
+ B3: translate({id: 'GP2040.B3', message: 'B3'}),
+ B4: translate({id: 'GP2040.B4', message: 'B4'}),
+ L1: translate({id: 'GP2040.L1', message: 'L1'}),
+ R1: translate({id: 'GP2040.R1', message: 'R1'}),
+ L2: translate({id: 'GP2040.L2', message: 'L2'}),
+ R2: translate({id: 'GP2040.R2', message: 'R2'}),
+ S1: translate({id: 'GP2040.S1', message: 'S1'}),
+ S2: translate({id: 'GP2040.S2', message: 'S2'}),
+ L3: translate({id: 'GP2040.L3', message: 'L3'}),
+ R3: translate({id: 'GP2040.R3', message: 'R3'}),
+ A1: translate({id: 'GP2040.A1', message: 'A1'}),
+ A2: translate({id: 'GP2040.A2', message: 'A2'}),
+ Function: translate({id: 'GP2040.Function', message: 'Function'}),
},
XInput: {
- name: 'XInput',
- Up: 'Up',
- Down: 'Down',
- Left: 'Left',
- Right: 'Right',
- B1: 'A',
- B2: 'B',
- B3: 'X',
- B4: 'Y',
- L1: 'LB',
- R1: 'RB',
- L2: 'LT',
- R2: 'RT',
- S1: 'Back',
- S2: 'Start',
- L3: 'LS',
- R3: 'RS',
- A1: 'Guide',
- A2: '(A2)',
- Function: 'Function',
+ name: translate({id: 'XInput.name', message: 'XInput'}),
+ Up: translate({id: 'XInput.Up', message: 'Up'}),
+ Down: translate({id: 'XInput.Down', message: 'Down'}),
+ Left: translate({id: 'XInput.Left', message: 'Left'}),
+ Right: translate({id: 'XInput.Right', message: 'Right'}),
+ B1: translate({id: 'XInput.B1', message: 'A'}),
+ B2: translate({id: 'XInput.B2', message: 'B'}),
+ B3: translate({id: 'XInput.B3', message: 'X'}),
+ B4: translate({id: 'XInput.B4', message: 'Y'}),
+ L1: translate({id: 'XInput.L1', message: 'LB'}),
+ R1: translate({id: 'XInput.R1', message: 'RB'}),
+ L2: translate({id: 'XInput.L2', message: 'LT'}),
+ R2: translate({id: 'XInput.R2', message: 'RT'}),
+ S1: translate({id: 'XInput.S1', message: 'Back'}),
+ S2: translate({id: 'XInput.S2', message: 'Start'}),
+ L3: translate({id: 'XInput.L3', message: 'LS'}),
+ R3: translate({id: 'XInput.R3', message: 'RS'}),
+ A1: translate({id: 'XInput.A1', message: 'Guide'}),
+ A2: translate({id: 'XInput.A2', message: '(A2)'}),
+ Function: translate({id: 'XInput.Function', message: 'Function'}),
},
DirectInput: {
- name: 'DirectInput',
- Up: 'Up',
- Down: 'Down',
- Left: 'Left',
- Right: 'Right',
- B1: '2',
- B2: '3',
- B3: '1',
- B4: '4',
- L1: '5',
- R1: '6',
- L2: '7',
- R2: '8',
- S1: '9',
- S2: '10',
- L3: '11',
- R3: '12',
- A1: '13',
- A2: '14',
- Function: 'Function',
+ name: translate({id: 'DirectInput.name', message: 'DirectInput'}),
+ Up: translate({id: 'DirectInput.Up', message: 'Up'}),
+ Down: translate({id: 'DirectInput.Down', message: 'Down'}),
+ Left: translate({id: 'DirectInput.Left', message: 'Left'}),
+ Right: translate({id: 'DirectInput.Right', message: 'Right'}),
+ B1: translate({id: 'DirectInput.B1', message: '2'}),
+ B2: translate({id: 'DirectInput.B2', message: '3'}),
+ B3: translate({id: 'DirectInput.B3', message: '1'}),
+ B4: translate({id: 'DirectInput.B4', message: '4'}),
+ L1: translate({id: 'DirectInput.L1', message: '5'}),
+ R1: translate({id: 'DirectInput.R1', message: '6'}),
+ L2: translate({id: 'DirectInput.L2', message: '7'}),
+ R2: translate({id: 'DirectInput.R2', message: '8'}),
+ S1: translate({id: 'DirectInput.S1', message: '9'}),
+ S2: translate({id: 'DirectInput.S2', message: '10'}),
+ L3: translate({id: 'DirectInput.L3', message: '11'}),
+ R3: translate({id: 'DirectInput.R3', message: '12'}),
+ A1: translate({id: 'DirectInput.A1', message: '13'}),
+ A2: translate({id: 'DirectInput.A2', message: '14'}),
+ Function: translate({id: 'DirectInput.Function', message: 'Function'}),
},
'Nintendo Switch': {
- name: 'Nintendo Switch',
- Up: 'Up',
- Down: 'Down',
- Left: 'Left',
- Right: 'Right',
- B1: 'B',
- B2: 'A',
- B3: 'Y',
- B4: 'X',
- L1: 'L',
- R1: 'R',
- L2: 'ZL',
- R2: 'ZR',
- S1: 'Minus',
- S2: 'Plus',
- L3: 'LS',
- R3: 'RS',
- A1: 'Home',
- A2: 'Capture',
- Function: 'Function',
+ name: translate({id: 'NintendoSwitch.name', message: 'Nintendo Switch'}),
+ Up: translate({id: 'NintendoSwitch.Up', message: 'Up'}),
+ Down: translate({id: 'NintendoSwitch.Down', message: 'Down'}),
+ Left: translate({id: 'NintendoSwitch.Left', message: 'Left'}),
+ Right: translate({id: 'NintendoSwitch.Right', message: 'Right'}),
+ B1: translate({id: 'NintendoSwitch.B1', message: 'B'}),
+ B2: translate({id: 'NintendoSwitch.B2', message: 'A'}),
+ B3: translate({id: 'NintendoSwitch.B3', message: 'Y'}),
+ B4: translate({id: 'NintendoSwitch.B4', message: 'X'}),
+ L1: translate({id: 'NintendoSwitch.L1', message: 'L'}),
+ R1: translate({id: 'NintendoSwitch.R1', message: 'R'}),
+ L2: translate({id: 'NintendoSwitch.L2', message: 'ZL'}),
+ R2: translate({id: 'NintendoSwitch.R2', message: 'ZR'}),
+ S1: translate({id: 'NintendoSwitch.S1', message: 'Minus'}),
+ S2: translate({id: 'NintendoSwitch.S2', message: 'Plus'}),
+ L3: translate({id: 'NintendoSwitch.L3', message: 'LS'}),
+ R3: translate({id: 'NintendoSwitch.R3', message: 'RS'}),
+ A1: translate({id: 'NintendoSwitch.A1', message: 'Home'}),
+ A2: translate({id: 'NintendoSwitch.A2', message: 'Capture'}),
+ Function: translate({id: 'NintendoSwitch.Function', message: 'Function'}),
},
PS4: {
- name: 'PS4',
- Up: 'Up',
- Down: 'Down',
- Left: 'Left',
- Right: 'Right',
- B1: 'Cross',
- B2: 'Circle',
- B3: 'Square',
- B4: 'Triangle',
- L1: 'L1',
- R1: 'R1',
- L2: 'L2',
- R2: 'R2',
- S1: 'Share',
- S2: 'Options',
- L3: 'L3',
- R3: 'R3',
- A1: 'PS',
- A2: 'Touchpad',
- Function: 'Function',
+ name: translate({id: 'PS4.name', message: 'PS4'}),
+ Up: translate({id: 'PS4.Up', message: 'Up'}),
+ Down: translate({id: 'PS4.Down', message: 'Down'}),
+ Left: translate({id: 'PS4.Left', message: 'Left'}),
+ Right: translate({id: 'PS4.Right', message: 'Right'}),
+ B1: translate({id: 'PS4.B1', message: 'Cross'}),
+ B2: translate({id: 'PS4.B2', message: 'Circle'}),
+ B3: translate({id: 'PS4.B3', message: 'Square'}),
+ B4: translate({id: 'PS4.B4', message: 'Triangle'}),
+ L1: translate({id: 'PS4.L1', message: 'L1'}),
+ R1: translate({id: 'PS4.R1', message: 'R1'}),
+ L2: translate({id: 'PS4.L2', message: 'L2'}),
+ R2: translate({id: 'PS4.R2', message: 'R2'}),
+ S1: translate({id: 'PS4.S1', message: 'Share'}),
+ S2: translate({id: 'PS4.S2', message: 'Options'}),
+ L3: translate({id: 'PS4.L3', message: 'L3'}),
+ R3: translate({id: 'PS4.R3', message: 'R3'}),
+ A1: translate({id: 'PS4.A1', message: 'PS'}),
+ A2: translate({id: 'PS4.A2', message: 'Touchpad'}),
+ Function: translate({id: 'PS4.Function', message: 'Function'}),
},
PS3: {
- name: 'PS3',
- Up: 'Up',
- Down: 'Down',
- Left: 'Left',
- Right: 'Right',
- B1: 'Cross',
- B2: 'Circle',
- B3: 'Square',
- B4: 'Triangle',
- L1: 'L1',
- R1: 'R1',
- L2: 'L2',
- R2: 'R2',
- S1: 'Select',
- S2: 'Start',
- L3: 'L3',
- R3: 'R3',
- A1: 'PS',
- A2: '(A2)',
- Function: 'Function',
+ name: translate({id: 'PS3.name', message: 'PS3'}),
+ Up: translate({id: 'PS3.Up', message: 'Up'}),
+ Down: translate({id: 'PS3.Down', message: 'Down'}),
+ Left: translate({id: 'PS3.Left', message: 'Left'}),
+ Right: translate({id: 'PS3.Right', message: 'Right'}),
+ B1: translate({id: 'PS3.B1', message: 'Cross'}),
+ B2: translate({id: 'PS3.B2', message: 'Circle'}),
+ B3: translate({id: 'PS3.B3', message: 'Square'}),
+ B4: translate({id: 'PS3.B4', message: 'Triangle'}),
+ L1: translate({id: 'PS3.L1', message: 'L1'}),
+ R1: translate({id: 'PS3.R1', message: 'R1'}),
+ L2: translate({id: 'PS3.L2', message: 'L2'}),
+ R2: translate({id: 'PS3.R2', message: 'R2'}),
+ S1: translate({id: 'PS3.S1', message: 'Select'}),
+ S2: translate({id: 'PS3.S2', message: 'Start'}),
+ L3: translate({id: 'PS3.L3', message: 'L3'}),
+ R3: translate({id: 'PS3.R3', message: 'R3'}),
+ A1: translate({id: 'PS3.A1', message: 'PS'}),
+ A2: translate({id: 'PS3.A2', message: '(A2)'}),
+ Function: translate({id: 'PS3.Function', message: 'Function'}),
},
Arcade: {
- name: 'Arcade',
- Up: 'Up',
- Down: 'Down',
- Left: 'Left',
- Right: 'Right',
- B1: 'K1',
- B2: 'K2',
- B3: 'P1',
- B4: 'P2',
- L1: 'P4',
- R1: 'P3',
- L2: 'K4',
- R2: 'K3',
- S1: 'Select',
- S2: 'Start',
- L3: 'LS',
- R3: 'RS',
- A1: 'Home',
- A2: '(A2)',
- Function: 'Function',
+ name: translate({id: 'Arcade.name', message: 'Arcade'}),
+ Up: translate({id: 'Arcade.Up', message: 'Up'}),
+ Down: translate({id: 'Arcade.Down', message: 'Down'}),
+ Left: translate({id: 'Arcade.Left', message: 'Left'}),
+ Right: translate({id: 'Arcade.Right', message: 'Right'}),
+ B1: translate({id: 'Arcade.B1', message: 'K1'}),
+ B2: translate({id: 'Arcade.B2', message: 'K2'}),
+ B3: translate({id: 'Arcade.B3', message: 'P1'}),
+ B4: translate({id: 'Arcade.B4', message: 'P2'}),
+ L1: translate({id: 'Arcade.L1', message: 'P4'}),
+ R1: translate({id: 'Arcade.R1', message: 'P3'}),
+ L2: translate({id: 'Arcade.L2', message: 'K4'}),
+ R2: translate({id: 'Arcade.R2', message: 'K3'}),
+ S1: translate({id: 'Arcade.S1', message: 'Select'}),
+ S2: translate({id: 'Arcade.S2', message: 'Start'}),
+ L3: translate({id: 'Arcade.L3', message: 'LS'}),
+ R3: translate({id: 'Arcade.R3', message: 'RS'}),
+ A1: translate({id: 'Arcade.A1', message: 'Home'}),
+ A2: translate({id: 'Arcade.A2', message: '(A2)'}),
+ Function: translate({id: 'Arcade.Function', message: 'Function'}),
},
} as const;
diff --git a/src/components/LinkIcon.tsx b/src/components/LinkIcon.tsx
index 6b7b62f..d6f4f93 100644
--- a/src/components/LinkIcon.tsx
+++ b/src/components/LinkIcon.tsx
@@ -12,6 +12,9 @@ const icons = {
Download: faFileDownload,
Pinout: faGamepad,
Website: faGlobe,
+ 下载: faFileDownload,
+ 引脚: faGamepad,
+ 网站: faGlobe,
} as const;
type LinkIconTypes = {
diff --git a/src/config/boards.tsx b/src/config/boards.tsx
index feb905e..e2b398e 100644
--- a/src/config/boards.tsx
+++ b/src/config/boards.tsx
@@ -1,745 +1,1111 @@
import React from 'react';
+import Translate, { translate } from '@docusaurus/Translate';
const boards = {
- 'Microcontroller Boards': [
- {
- name: 'Raspberry Pi Pico',
- configName: 'Pico',
- pinout: '/controller-build/wiring#raspberry-pi-pico',
- website: 'https://www.raspberrypi.com/products/raspberry-pi-pico/',
- image: '/img/boards/Pico.jpg',
- supported: true,
- desc: () => (
- - The Raspberry Pi Pico is a powerful, low-cost board based on the - Raspberry Pi RP2040 microcontroller. This build is the reference - implementation for GP2040-CE. -
- ), - }, - { - name: 'Raspberry Pi Pico W', - configName: 'PicoW', - pinout: '/controller-build/wiring#raspberry-pi-pico', - website: 'https://www.raspberrypi.com/products/raspberry-pi-pico/', - image: '/img/boards/PicoW.jpg', - supported: true, - desc: () => ( -- The Raspberry Pi Pico W is a powerful, low-cost board based on the - Raspberry Pi RP2040 microcontroller. -
- ), - }, - { - name: 'Raspberry Pi Pico 2', - configName: 'Pico2', - pinout: '/controller-build/wiring#raspberry-pi-pico', - website: 'https://www.raspberrypi.com/products/raspberry-pi-pico-2/', - image: '/img/boards/Pico2.jpg', - supported: true, - desc: () => ( -- The Raspberry Pi Pico 2 is a powerful, low-cost board based on the - Raspberry Pi RP2350 microcontroller. -
- ), - }, - { - name: 'Adafruit KB2040', - configName: 'KB2040', - pinout: '/controller-build/wiring#adafruit-kb2040', - website: 'https://learn.adafruit.com/adafruit-kb2040', - image: '/img/boards/KB2040.jpg', - supported: true, - desc: () => ( -- Another RP2040 board in the Pro Micro form factor, with 2 additional - pins for USB data. This build is configured for DIY gamepad mods. -
- ), - }, - { - name: 'Liatris', - configName: 'SparkFunProMicro', - pinout: '/controller-build/wiring#sparkfun-pro-micro---rp2040', - website: - 'https://splitkb.com/products/liatris', - image: '/img/boards/Liatris.jpg', - supported: true, - desc: () => ( -- Drop in RP2040 replacement for Pro Micro builds by {' '} - - SplitKB.com - - . -
- ), - }, - { - name: 'Seeed XAIO RP2040', - configName: 'SeeedXIAORP2040', - pinout: '/controller-build/wiring#seeed-xiao-rp2040', - website: - 'https://wiki.seeedstudio.com/XIAO-RP2040/', - image: '/img/boards/SeeedXIAORP2040.jpg', - supported: true, - desc: () => ( -- The Seeed Studio XIAO RP2040 is a small RP2040 board created by Seeed Studio. -
- ), - }, - { - name: 'SparkFun Pro Micro', - configName: 'SparkFunProMicro', - pinout: '/controller-build/wiring#sparkfun-pro-micro---rp2040', - website: - 'https://learn.sparkfun.com/tutorials/pro-micro-rp2040-hookup-guide', - image: '/img/boards/SparkFunProMicro.jpg', - supported: true, - desc: () => ( -- An RP2040 board in the Pro Micro form factor. This build is a drop-in - replacement for the{' '} - - Daemonbite Arcade Encoder - - . -
- ), - }, - { - name: 'Waveshare RP2040-Zero', - configName: 'WaveshareZero', - pinout: '/controller-build/wiring#waveshare-rp2040-zero', - website: 'https://www.waveshare.com/wiki/RP2040-Zero', - image: '/img/boards/WaveshareZero.jpg', - supported: true, - desc: () => ( -- The{' '} - - Waveshare RP2040-Zero - {' '} - is a small form factor board with castellated pins and USB-C, making - this a popular choice for custom built PCBs without the need for SMT - assembly. -
- ), - }, - ], - 'Community Devices': [ - { - name: 'ARC Accessibility Controller', - configName: 'ARCController', - pinout: null, - website: 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/GP2040-CE%20Official%20Controllers/ARC%20Accessibility%20Controller', - image: '/img/boards/ARCController.jpg', - category: 'official', - desc: () => ( -- The ARC Controller is an accessibility controller.{' '} - This was designed by TheTrain taking some design ideas from jfedor2{' '} - as well as the universal standards for accessibility controller connectors. -
- ), - }, - { - name: 'ASi LVL ABC', - configName: 'ASiLVLABC', - pinout: null, - website: 'https://asindo.pro/products/lvl-abc', - image: '/img/boards/ASiLVLABC.jpg', - category: 'closed', - desc: () => ( -- The ASi LVL ABC Controller is a compact leverless controller created by ASIndo. -
- ), - }, - { - name: 'ASi LVL WASD', - configName: 'ASiLVLWASD', - pinout: null, - website: 'https://asindo.pro/collections/lvl/products/lvl-wasd', - image: '/img/boards/ASiLVLWASD.jpg', - category: 'closed', - desc: () => ( -- The ASi LVL WASD Controller is a compact leverless controller created by ASIndo. -
- ), - }, - { - name: 'Flatbox Rev 4', - configName: 'FlatboxRev4', - pinout: null, - website: 'https://github.com/jfedor2/flatbox/tree/master/hardware-rev4', - image: '/img/boards/FlatboxRev4.jpg', - category: 'open', - desc: () => ( -- Stickless PCB designed by{' '} - jfedor2 using an embedded - RP2040 chip. -
- ), - }, - { - name: 'Flatbox Rev 5', - configName: 'FlatboxRev5', - pinout: null, - website: 'https://github.com/jfedor2/flatbox/tree/master/hardware-rev5', - image: '/img/boards/FlatboxRev5.jpg', - category: 'open', - desc: () => ( -- Stickless PCB designed by{' '} - jfedor2 using the Waveshare - RP2040-Zero. -
- ), - }, - { - name: 'Flatbox Rev 5 Southpaw', - configName: 'FlatboxRev5Southpaw', - pinout: null, - website: 'https://github.com/SkylaHila/flatbox-southpaw', - image: '/img/boards/FlatboxRev5Southpaw.jpg', - category: 'open', - desc: () => ( -- Mirrored version of the Flatbox Rev 5 by SkylaHila. Based on the Flatbox Rev 5 by - jfedor2. -
- ), - }, - { - name: 'Flatbox Rev 5 RGB', - configName: 'FlatboxRev5RGB', - pinout: null, - website: - 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/GP2040-CE%20Official%20Controllers/Flatbox%20Rev%205%20RGB', - image: '/img/boards/FlatboxRev5RGB.jpg', - category: 'open', - desc: () => ( -- Stickless PCB designed by{' '} - jfedor2 and{' '} - TheTrain using the - Waveshare RP2040-Zero. -
- ), - }, - { - name: 'Flatbox Rev 5 USB Passthrough', - configName: 'FlatboxRev5USBPassthrough', - pinout: null, - website: - 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/GP2040-CE%20Official%20Controllers/Flatbox%20Rev%205%20Passthrough', - image: '/img/boards/FlatboxRev5USBPassthrough.jpg', - category: 'open', - desc: () => ( -- Stickless PCB designed by{' '} - jfedor2 and{' '} - TheTrain using the - Waveshare RP2040-Zero. -
- ), - }, - { - name: 'GP2040-CE Keyboard Converter', - configName: 'KeyboardConverter', - pinout: null, - website: - 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/Supported%20Boards/GP2040%20Keyboard%20Converter/Waveshare%20Zero-PCB', - image: '/img/boards/KeyboardConverter.jpg', - category: 'open', - desc: () => ( -- The GP2040-CE Keyboard Converter Case is designed to be a USB Host - Device for the use of a keyboard with the GP2040-CE project. -
- ), - }, - { - name: 'Granola Summit', - configName: 'Granola', - pinout: null, - website: 'https://granola.games/collections/controllers', - image: '/img/boards/Granola.jpg', - category: 'open', - desc: () => ( -- Configuration for the {' '} - - Granola Summit - - . PCB and design files can be found here. -
- ), - }, - { - name: 'Granola Beacon', - configName: 'GranolaBeacon', - pinout: null, - website: 'https://granola.games/products/beacon', - image: '/img/boards/GranolaBeacon.jpg', - category: 'closed', - desc: () => ( -- Configuration for the {' '} - - Granola Beacon - -
- ), - }, - { - name: 'Haute42 Series', - configName: 'Haute42COSMOX', - pinout: null, - website: 'https://haute42.com/', - image: '/img/boards/Haute42.jpg', - category: 'closed', - desc: () => ( -- Configuration for the {' '} - - Haute42 Series - - . The Haute42 products are all compatible with the same configuration file. - These products include the Haute42 Pad M Series, T Series, G Series, and mini. -
- ), - }, - { - name: 'HautePad M Lite', - configName: 'Haute42COSMOXMLite', - pinout: null, - website: 'https://cosmoxgaming.com/m-lite/', - image: '/img/boards/Haute42COSMOXMLite.jpg', - category: 'closed', - desc: () => ( -- Configuration for the {' '} - - HautePad M Lite - - . The HautePad M Lite product contains special case RGB code specific to the M-Lite. - The firmware uf2 will automatically set the case rgbs and mode to enable full LEDs. -
- ), - }, - { - name: 'HautePad M Ultra', - configName: 'Haute42COSMOXMUltra', - pinout: null, - website: 'https://cosmoxgaming.com/m-ultra/', - image: '/img/boards/Haute42COSMOXMUltra.jpg', - category: 'closed', - desc: () => ( -- Configuration for the {' '} - - HautePad M Ultra - - . The HautePad M Ultra product contains special case RGB code specific to the M Ultra. - The firmware uf2 will automatically set the case rgbs and mode to enable full LEDs. -
- ), - }, - { - name: 'HautePad X (Analog Configuration)', - configName: 'Haute42COSMOXXAnalog', - pinout: null, - website: 'https://cosmoxgaming.com/x/', - image: '/img/boards/Haute42COSMOXXAnalog.jpg', - category: 'closed', - desc: () => ( -- Configuration for the {' '} - - HautePad X Series in Analog Configuration - - . The HautePad X Series with the analog attachment requires a special configuration file to work immediately. -
- ), - }, - { - name: 'Mavercade Rev1', - configName: 'MavercadeRev1', - pinout: null, - website: - 'https://mavercade.com/', - image: '/img/boards/MavercadeRev1.jpg', - category: 'closed', - desc: () => ( -- Configuration for the{' '} - - Mavercade Rev1 - - . These revisions use a Waveshare RP2040-Zero board. -
- ), - }, - { - name: 'Mavercade Rev2', - configName: 'MavercadeRev2', - pinout: null, - website: - 'https://mavercade.com/', - image: '/img/boards/MavercadeRev2.jpg', - category: 'closed', - desc: () => ( -- Configuration for the{' '} - - Mavercade Rev2 - - . These revisions use a Waveshare RP2040-Zero board. -
- ), - }, - { - name: 'Mavercade Rev3', - configName: 'MavercadeRev3', - pinout: null, - website: - 'https://mavercade.com/', - image: '/img/boards/MavercadeRev3.jpg', - category: 'closed', - desc: () => ( -- Configuration for the{' '} - - Mavercade Rev3 - - . These revisions use a Waveshare RP2040-Zero board. -
- ), - }, - { - name: 'MiSTercadeV2', - configName: 'MiSTercadeV2', - pinout: null, - website: - 'https://github.com/misteraddons/MiSTercadeV1', - image: '/img/boards/MistercadeV2.jpg', - category: 'closed', - desc: () => ( -- Configuration for the{' '} - - Mistercade V2 - - . MiSTercade is the original JAMMA extension for MiSTer FPGA. -
- ), - }, - { - name: 'Open Core0', - configName: 'OpenCore0', - pinout: null, - website: - 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/GP2040-CE%20Official%20Controllers/Open_Core0', - image: '/img/boards/OpenCore0.jpg', - category: 'official', - desc: () => ( -- Open source stickless controller designed by {' '} - - TheTrain - . -
- ), - }, - { - name: 'Open Core0 WASD', - configName: 'OpenCore0WASD', - pinout: null, - website: - 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/GP2040-CE%20Official%20Controllers/Open_Core0%20WASD', - image: '/img/boards/OpenCore0WASD.jpg', - category: 'official', - desc: () => ( -- Open source stickless WASD controller designed by {' '} - - TheTrain - . -
- ), - }, - { - name: 'OSUMGP-RP2040', - configName: 'OSUMGP-RP2040', - pinout: null, - website: - 'https://github.com/NickGuyver/OSUMGP-RP2040', - image: '/img/boards/OSUMGP-RP2040.jpg', - category: 'open', - desc: () => ( -- OSUMGP-RP2040: Open Source Universal Modern Game Pad - RP2040 Edition by - - NickGuyver - . -
- ), - }, - { - name: 'Pico Fighting Board', - configName: 'PicoFightingBoard', - pinout: null, - website: 'https://github.com/FeralAI/PicoFightingBoard', - image: '/img/boards/PicoFightingBoard.jpg', - category: 'open', - desc: () => ( -- Arcade encoder board designed by {' '} - FeralAI using a Raspberry Pi - Pico or pin-equivalent RP2040 board. -
- ), - }, - { - name: 'PXP-Gamepad', - configName: 'PXPGamepad', - pinout: null, - website: 'https://github.com/MegaBitmap/PXP-Gamepad', - image: '/img/boards/PXPGamepad.png', - category: 'open', - desc: () => ( -- DIY universal controller pocket gamepad by {' '} - MegaBitmap using - an RP2040-Zero MCU soldered onto a custom PCB. -
- ), - }, - { - name: 'Reflex Encode v1.2', - configName: 'ReflexEncodeV1.2', - pinout: null, - website: 'https://github.com/misteraddons/ReflexFightingBoard', - image: '/img/boards/ReflexEncode_v1.2.jpg', - category: 'open', - desc: () => ( -- Arcade encoder board designed and sold by{' '} - MiSTerAddons using an - embedded RP2040 chip. -
- ), - }, - { - name: 'Reflex Encode v2.0', - configName: 'ReflexEncodeV2.0', - pinout: null, - website: 'https://github.com/misteraddons/ReflexFightingBoard', - image: '/img/boards/ReflexEncode_v2.0.jpg', - category: 'open', - desc: () => ( -- Arcade encoder board designed and sold by {' '} - MiSTerAddons using an - embedded RP2040 chip. -
- ), - }, - { - name: 'Reflex CTRL Genesis 6', - configName: 'ReflexCtrlGenesis6', - pinout: null, - website: 'https://github.com/misteraddons/Reflex-CTRL', - image: '/img/boards/ReflexCTRLGenesis6.png', - category: 'open', - desc: () => ( -- Reflex Board Open source PCB for Sega Genesis 6 button Controller replacement PCBs - designed and sold by{' '} - MiSTerAddons using an - embedded RP2040 chip. -
- ), - }, - { - name: 'Reflex CTRL NES', - configName: 'ReflexCtrlNES', - pinout: null, - website: 'https://github.com/misteraddons/Reflex-CTRL', - image: '/img/boards/ReflexCTRLNES.png', - category: 'open', - desc: () => ( -- Reflex Board Open source PCB for NES Controller replacement PCBs - designed and sold by{' '} - MiSTerAddons using an - embedded RP2040 chip. -
- ), - }, - { - name: 'Reflex CTRL SNES', - configName: 'ReflexCtrlSNES', - pinout: null, - website: 'https://github.com/misteraddons/Reflex-CTRL', - image: '/img/boards/ReflexCTRLSNES.png', - category: 'open', - desc: () => ( -- Reflex Board Open source PCB for SNES Controller replacement PCBs - designed and sold by{' '} - MiSTerAddons using an - embedded RP2040 chip. -
- ), - }, - { - name: 'Reflex CTRL Saturn', - configName: 'ReflexCtrlSaturn', - pinout: null, - website: 'https://github.com/misteraddons/Reflex-CTRL', - image: '/img/boards/ReflexCTRLSaturn.png', - category: 'open', - desc: () => ( -- Reflex Board Open source PCB for Sega Saturn Controller replacement PCBs - designed and sold by{' '} - MiSTerAddons using an - embedded RP2040 chip. -
- ), - }, - { - name: 'Reflex CTRL Virtual Boy', - configName: 'ReflexCtrlVB', - pinout: null, - website: 'https://github.com/misteraddons/Reflex-CTRL', - image: '/img/boards/ReflexCTRLVB.png', - category: 'open', - desc: () => ( -- Reflex Board Open source PCB for Virtual Boy Controller replacement PCBs - designed and sold by{' '} - MiSTerAddons using an - embedded RP2040 chip. -
- ), - }, - { - name: 'RP2040 Advanced Breakout', - configName: 'RP2040AdvancedBreakoutBoard', - pinout: null, - website: - 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/GP2040-CE%20Official%20Boards/RP2040%20Advanced%20Breakout%20Board/RP2040%20Advanced%20Breakout%20Board', - image: '/img/boards/RP2040AdvancedBreakoutBoard.jpg', - category: 'official', - desc: () => ( -- Arcade encoder board designed by {' '} - TheTrain using an - embedded RP2040, and is the official board of the GP2040-CE project. -
- ), - }, - { - name: 'RP2040 Advanced Breakout (USB Passthrough)', - configName: 'RP2040AdvancedBreakoutBoardUSBPassthrough', - pinout: null, - website: 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/GP2040-CE%20Official%20Boards/RP2040%20Advanced%20Breakout%20Board/RP2040%20Advanced%20Breakout%20Board%20-%20Passthrough', - image: '/img/boards/RP2040AdvancedBreakoutBoardUSBPassthrough.jpg', - category: 'official', - desc: () => -- Official USB Passthrough Board of the Open Stick project. Updated version of - the RP2040 Advanced Breakout Board with USB passthrough included on the board. -
, - }, - { - name: 'RP2040 Mini Breakout Board', - configName: 'RP2040MiniBreakoutBoard', - pinout: null, - website: - 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/GP2040-CE%20Official%20Boards/RP2040%20Mini%20Breakout%20Board/RP2040%20Mini%20Breakout%20Board', - image: '/img/boards/RP2040MiniBreakoutBoard.jpg', - category: 'open', - desc: () => ( -- A reduced-footprint spin off of the RP2040 Advanced Breakout Board designed by {' '} - - TheTrain - . -
- ), - }, - { - name: 'ScrubTier BentoBox', - configName: 'BentoBox', - pinout: null, - website: - 'https://github.com/OpenStickCommunity/GP2040-CE/tree/main/configs/BentoBox', - image: '/img/boards/BentoBox.jpg', - category: 'closed', - desc: () => ( -- Configuration for the{' '} - - ScrubTier BentoBox v1 and v2 as well as the GGEZStick Keebfighters - - . -
- ), - }, - { - name: 'SGF Devices', - configName: 'SGFDevices', - pinout: null, - website: 'https://sgfdevices.com/collections/controllers', - image: '/img/boards/SGFFaust.jpg', - category: 'closed', - desc: () => ( -- The SGF stickless controllers are inspired by the open-source - flatbox rev4 design by jfedor. -
- ), - }, - { - name: 'Stress', - configName: 'Stress', - pinout: null, - website: 'https://github.com/GroooveBob/Stress', - image: '/img/boards/Stress.jpg', - category: 'open', - desc: () => ( -- A small and portable PCB-as-a-controller designed by{' '} - GroooveBob using the - Waveshare RP-2040-Zero. -
- ), - }, - { - name: 'Zero Rhythm', - configName: 'ZeroRhythm', - pinout: null, - website: 'https://github.com/OpenStickCommunity/Hardware/tree/main/Boards/GP2040-CE%20Official%20Controllers/Zero%20Rhythm', - image: '/img/boards/Zero_Rhythm.jpg', - category: 'official', - desc: () => ( -- The Zero Rhythm is a controller for the Theatrhythm game on the Nintendo Switch.{' '} - It allows you to play rhythm as well as dual stick games in a double WASD layout. -
- ), - }, - ], + 'Microcontroller Boards': [ + { + name: translate({ + id: 'boards.microcontroller.pico.name', + message: 'Raspberry Pi Pico', + }), + configName: 'Pico', + pinout: '/controller-build/wiring#raspberry-pi-pico', + website: 'https://www.raspberrypi.com/products/raspberry-pi-pico/', + image: '/img/boards/Pico.jpg', + supported: true, + desc: () => ( +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+