SuperPad-V1

开源游戏手柄（控制器）项目 —— 基于 Input Labs Alpakka 参考设计开发。

许可

• 本仓库整体使用 GNU General Public License v2（GPL-2.0），全文见 LICENSE。
• 许可依据：上游 Alpakka 固件使用 GPL-2.0，本项目遵循同样的开源许可。
• 注意：上游 PCB / CAD 设计为 CC BY-NC-SA 4.0（非商业、署名、相同方式共享），见 hardware/alpakka_kicad/license.md；搬运硬件文件前请务必确认许可兼容性（NC 限制）。

目录结构

SuperPad-V1/
├── LICENSE                    # GPL-2.0
├── BOM.md                     # 硬件物料清单（Alpakka 主板 + Marmota 模块）
├── hardware/                  # 硬件设计
│   ├── superpad_v1_main.eprj2 # 嘉立创 EDA 专业版工程（本项目）
│   ├── alpakka_kicad/         # 上游 Alpakka KiCad 源文件（参考）
│   ├── enclosure/             # 3D 打印外壳（Alpakka 造型，STL+渲染+验证套件+装配/QA 文档）
│   └── IMPORT_ALPAKKA_TO_LCEDA.md  # 导入嘉立创 EDA 指南
├── firmware/                  # 固件（多平台）
│   ├── arduino/               #   Arduino 平台
│   │   └── RP2040/            #     RP2040（已验证可编译，UF2）
│   ├── keil/                  #   Keil 工程
│   │   └── RP2040/            #     RP2040（Alpakka 官方目标）
│   └── platformio_ide/        #   PlatformIO 工程
│       └── RP2040/            #     RP2040（Alpakka 官方目标）
└── ForeverThanksAlpakka/      # 上游归档（zip + 说明 + 许可）

快速开始

• 硬件：先看 BOM.md，再参照 hardware/IMPORT_ALPAKKA_TO_LCEDA.md 把 Alpakka 工程导入嘉立创 EDA 专业版。
• 外壳：3D 打印外壳交付见 hardware/enclosure/README.md（STL×3 + Blender 源文件 + 验证套件 v12 + 装配说明书/QA/风险清单）。
• 固件（Arduino）：cd firmware/arduino/RP2040 && ./build.ps1（详见 firmware/arduino/RP2040/readme.md 与 PORT_TO_ARDUINO.md）。
• 固件（PlatformIO）：见 firmware/platformio_ide/RP2040/readme.md。
• 固件（Keil）：见 firmware/keil/RP2040/PORT_TO_KEIL.md。

致谢

感谢 Input Labs 开源 Alpakka 控制器参考设计（固件 GPL-2.0、PCB/CAD CC BY-NC-SA 4.0）。详见 ForeverThanksAlpakka/README.md。