AgentPad13｜AI 智能体专用开源 13 键宏键盘

AgentPad13，基于 RP2040 的全开源 13 键宏键盘，专为 AI Agent 工作流打造，支持 Raw‑HID 双向状态交互，集成摇杆、旋转编码器、电容触摸与 RGB 状态反馈，硬件 PCB、3D 外壳、固件完全开源可自制。

AgentPad13｜AI 智能体专用开源 13 键宏键盘封面
oshw_hqzl2026-08-07 17:46:57CERN-OHL-W v2
95
Star1

PCBA

设计文件

KiCad图标pcb.zip4.77MB（6次下载）

EDA查看器

复制嵌入代码

详细介绍

AgentPad13 是一套面向 AI Agent（AI 智能体） 场景的全开源自制宏键盘外设，硬件 PCB、3D 外壳结构、RP2040 固件、生产组装文档全部开放。区别于普通快捷键小键盘，它通过自定义 Raw‑HID 双向协议，实现硬件输入与 AI 程序运行状态的双向可视化交互。

一、项目背景与设计目标

传统宏键盘仅单向向电脑发送按键信号。在 AI Agent 工作场景中，程序存在思考、执行、等待、完成、报错等运行状态，普通键盘无法直观反馈这类信息。

AgentPad13 设计目标：

  1. 提供丰富的物理输入：按键、摇杆、编码器、触摸，给 Agent 提供物理操控入口；

  2. 通过 RGB 灯光把 AI 智能体内部状态物理可视化；

  3. 完整可制造：普通开发者可以直接拿仓库文件打样 PCB、3D 打印外壳，完成整机制作；

  4. 不锁定用途：既可以作为 Agent 专用交互面板，也可以降级为普通宏键盘使用。

二、硬件规格（PCB v5）

项目

参数

主控芯片

RP2040，2 层 PCB，尺寸 84.2 mm × 100 mm

按键阵列

13 颗热插拔机械按键（12+1 布局），支持 MX 轴座

附加输入

EC11 旋转编码器；YAI31 平面模拟摇杆；电容触摸感应按键

灯光系统

每颗按键独立 RGB；PCB 边缘底部 RGB 氛围灯带

接口

USB‑C

工艺

大部分元器件支持 SMT 贴片；仅编码器需要手工焊接

硬件要点

  1. 摇杆为 180° 倒置安装，固件内置专门校准逻辑，无需修改硬件；

  2. PCB 已经完成 DRC 校验，仓库提供 Gerber 生产文件，可直接发给 PCB 工厂；

  3. BOM、装配 bundle 文件随仓库附带，方便一键下单元器件。

三、机械外壳 Case v2.7

  1. 结构组成：FR4 前面板 + 3D 打印底座，可直接打印装配，无需复杂后处理；

  2. 提供多种变体版本：不同厚度面板、不同按键高度、可选盖板；

  3. 全部 STL 模型开源，支持自行修改外壳造型；

  4. 外壳已经针对 v5 PCB 做定位适配，孔位、摇杆开孔、编码器开孔全部对齐。

四、固件与通信协议

  1. 运行平台：RP2040，支持模拟器仿真测试；

  2. 核心通信：自定义 Agent‑status Raw‑HID 双向协议

    • 上行（设备→电脑）：按键、编码器、摇杆、触摸事件上报给上位机软件；

    • 下行（电脑→设备）：AI 程序下发状态指令，控制每颗按键 RGB、底光，把thinking / running / waiting / done等状态映射为灯光颜色；

  3. 兼容性：固件可以修改，关闭自定义 HID，当做普通 USB 宏键盘使用；

  4. 仓库包含构建脚本、预编译固件、摇杆极性与校准配置。

💡 注意：原生固件不是标准 HID 键盘，需要上位机程序对接自定义协议才能完整发挥 Agent 交互能力。

五、仓库文件组织结构

agentpad13
├─ hardware/
│   ├─ pcb/          # KiCad工程、原理图、PCB源文件、Gerber、BOM装配包
│   └─ case/         # 3D外壳STL，FR4面板文件，多种变体模型
├─ firmware/         # RP2040固件源码、构建配置、预编译uf2固件
├─ HOW‑TO‑ORDER‑and.md # 打样、采购零件、组装、调试完整实操手册
└─ README.md         # 项目总说明、状态、许可

六、开源许可

  • 硬件（原理图、PCB、外壳 CAD）：CERN‑OHL‑W‑2.0 开源硬件协议

  • 固件代码：GPL‑2.0‑or‑later

  • 依赖第三方库marbastlib，继承上游开源许可证。

七、项目当前状态

  • ✅ PCB v5：设计冻结，验证完成，可直接生产，修复旧版定位、USB‑C、编码器结构问题；

  • ✅ Case v2.7：外壳设计冻结，多版本打印可用；

  • ✅ Firmware：协议验证通过，引脚映射匹配 v5 硬件，支持仿真；

  • 📝 文档完整：包含下单打样指引、组装、焊接提示、摇杆校准说明。

八、使用场景

  1. AI Agent 开发调试面板：物理按钮触发 Agent 任务，灯光观察 Agent 内部状态；

  2. 工作站自定义宏键盘：剪辑、编程、工控快捷操作；

  3. 开源硬件学习参考：学习 RP2040 多输入外设、Raw‑HID 双向通信、完整从设计到制造的开源项目范式。

九、自制简要流程

  1. 导出 / 直接使用仓库 Gerber 文件下单 PCB；

  2. 3D 打印外壳，或下单 FR4 前面板；

  3. 采购 BOM 元器件，工厂贴片 + 手工焊接编码器；

  4. 刷写.uf2固件到 RP2040；

  5. 组装外壳，完成摇杆校准；

  6. 对接上位机 Agent 程序，或者作为普通宏键盘使用。

十、项目地址

https://github.com/yuz207/agentpad13