桌面与交互 · creative-018
可编程宏键盘
把复杂软件操作、直播控制和无障碍快捷键变成实体按键。
结构概念 · 工程参考
功能与方案目标
把复杂软件操作、直播控制和无障碍快捷键变成实体按键。
从此案例创建时，可根据使用场景调整功能、尺寸和交付范围；具体可实现性由所选器件、连接检查和验证结果共同确定。
Demo 实现路径
RP2040 枚举为 USB HID；网页配置按键、旋钮和 OLED 标签；配置保存在板上。
硬件组成与候选器件
RP2040、热插拔轴座、旋转编码器、OLED、RGB
这些条目描述方案方向或结构位置。具体型号、供电、引脚网络、原理图、PCBA 与固件状态见硬件评审。
进入硬件评审 →结构与装配组成
- 键帽矩阵
- 旋钮编码器
- 热插拔轴板
- 主控PCB
- USB-C接口
当前证据与工程边界
本页为公开工程参考方案。候选器件、结构尺寸和连接方案需按工作台中的证据与检查结果确认；不代表已完成样机实测或量产放行。
本页内容来自共用公开案例目录与公开结构记录。以下工程资料同步展示已有需求、实际关联器件、电路、来源及检查状态。
查看公开结构数据PUBLIC ENGINEERING RECORD
公开工程数据
共用案例库中的需求、选型、关联电路和检查记录。展开记录即可阅读完整内容。
5de6408420477549ab5561b33648f93f1b0ff1c7eeed08b0557a0b6527d109a5最近审计记录：2026-10-12T00:15:49.938640+00:00功能需求与约束
3 条记录USB HID、网页配置、板内存储
方案需求，待验证需求参数尚未记录。
Demo 实现路径
方案需求，待验证RP2040 枚举为 USB HID；网页配置按键、旋钮和 OLED 标签；配置保存在板上。
软件实现方向
方案需求，待验证QMK/自定义 HID、WebSerial
器件选型与案例关联
8 条记录选型记录保留具体料号及其与案例的关联；候选器件和未知参数按原状态展示。
3x4 Matrix Keypad
历史案例选板 · 待验证- 制造商
- Adafruit
- 型号
- 3x4 Matrix Keypad
- 与案例的关系
- 历史案例审计中的选用板卡，当前适配待复核
功能：key_matrix
待确认：无源矩阵；按照行列扫描示例连接，不能按 I2C 接线。；供应商示例需按指定主控复现；未完成平台烧录与实测。；历史案例选板不代表当前连接、固件、整机功能或实物测试通过。
依据 [1] [2] [3]USB Type C Breakout (4090)
历史案例选板 · 待验证- 制造商
- Adafruit
- 型号
- USB Type C Breakout (4090)
- 与案例的关系
- 历史案例审计中的选用板卡，当前适配待复核
功能：USB设备
待确认：只提供接口和 CC 配置，不包含完整保险丝、ESD、过压或限流保护。；历史案例选板不代表当前连接、固件、整机功能或实物测试通过。
依据 [4]TPS62827 3.3V (4920)
历史案例选板 · 待验证- 制造商
- Adafruit
- 型号
- TPS62827 3.3V (4920)
- 与案例的关系
- 历史案例审计中的选用板卡，当前适配待复核
待确认：输入范围、峰值负载、散热和去耦需按整机电源预算验证。；历史案例选板不代表当前连接、固件、整机功能或实物测试通过。
依据 [5] [6]NeoKey 1x4 QT
历史案例选板 · 待验证- 制造商
- Adafruit
- 型号
- NeoKey 1x4 QT
- 与案例的关系
- 历史案例审计中的选用板卡，当前适配待复核
功能：按键
待确认：不等于矩阵键盘；轴体与键帽另购。官网查询时缺货，需确认渠道。；历史案例选板不代表当前连接、固件、整机功能或实物测试通过。
依据 [7] [8] [9] [10] [11] [12] [13]STEMMA QT Rotary Encoder
历史案例选板 · 待验证- 制造商
- Adafruit
- 型号
- STEMMA QT Rotary Encoder
- 与案例的关系
- 历史案例审计中的选用板卡，当前适配待复核
功能：rotary
待确认：编码器与 I2C 扩展板的配套和地址需核对。；历史案例选板不代表当前连接、固件、整机功能或实物测试通过。
依据 [14] [15] [9] [10] [11] [16] [17]SSD1306 1.3in OLED
历史案例选板 · 待验证- 制造商
- Adafruit
- 型号
- SSD1306 1.3in OLED
- 与案例的关系
- 历史案例审计中的选用板卡，当前适配待复核
功能：OLED显示
待确认：屏幕修订、地址与 I2C/SPI 配置需锁定。；历史案例选板不代表当前连接、固件、整机功能或实物测试通过。
依据 [18] [19] [20] [21] [22] [23] [24] [25]案例电路与关联参考包
13 条电路 · 5 个参考包案例电路与参考设计
USB Type C Breakout (4090) · 原厂器件电路
板卡原厂参考电路该案例选板的原厂参考电路
记录编号：source:adafruit-4090/0 · 版本：未记录
待确认：原厂或资料重建电路只覆盖该板；整机电源、接口条件、板卡修订和样机结果仍需核对。
依据 [26]TPS62827 3.3V (4920) · 原厂器件电路
板卡原厂参考电路该案例选板的原厂参考电路
记录编号：source:adafruit-4920/0 · 版本：未记录
待确认：原厂或资料重建电路只覆盖该板；整机电源、接口条件、板卡修订和样机结果仍需核对。
依据 [27]NeoKey 1x4 QT · 原厂器件电路
板卡原厂参考电路该案例选板的原厂参考电路
记录编号：source:adafruit-4980/0 · 版本：未记录
待确认：原厂或资料重建电路只覆盖该板；整机电源、接口条件、板卡修订和样机结果仍需核对。
依据 [28]3x4 Matrix Keypad · 原厂资料重建电路
板卡原厂参考电路该案例选板的原厂参考电路
记录编号：source:adafruit-3845/0 · 版本：未记录
待确认：原厂或资料重建电路只覆盖该板；整机电源、接口条件、板卡修订和样机结果仍需核对。
依据 [1]展开其余 9 条电路记录
STEMMA QT Rotary Encoder · 原厂器件电路
板卡原厂参考电路该案例选板的原厂参考电路
记录编号：source:adafruit-4991/0 · 版本：未记录
待确认：原厂或资料重建电路只覆盖该板；整机电源、接口条件、板卡修订和样机结果仍需核对。
依据 [29]SSD1306 1.3in OLED · 原厂器件电路
板卡原厂参考电路该案例选板的原厂参考电路
记录编号：source:adafruit-938/0 · 版本：未记录
待确认：原厂或资料重建电路只覆盖该板；整机电源、接口条件、板卡修订和样机结果仍需核对。
依据 [30] [31]ESP32-S3 模组最小系统
已接入候选图，未签核已接入案例候选电路图，尚未签核
记录编号：esp32s3-module-minimum-system · 版本：c0f126f08caed4b371aa2b6d12d3e1ca708eba4203807e608413011653b7cdd2
待确认：现库符号可用但准确模组后缀与引脚限制未冻结；裸芯片与模组不能共用同一最小系统；模组内部RF晶振不重复添加
依据 [32] [33]TPS62827 降压电源参考电路
参考电路，未采用参考电路，未作为本案例已采用电路
记录编号：tps62827-buck-reference · 版本：5a85c104aa77fa80eaeb57e148f6b713ce49963c9c352def21b34728eaf88fa8
待确认：源符号名为TPS6282X，准确订货型号仍需BOM锁定；归档3.3V板参数不是任意输入输出组合通用值；热、瞬态、稳定性和电感料号替代需独立验证
依据 [27]I²C 上拉与总线边界
参考电路，未采用参考电路，未作为本案例已采用电路
记录编号：i2c-pullup-network · 版本：e2225e7ef8408c87d5a5098521581442c6d78a093b0e6928ae20a2860e150d8c
待确认：实际工作条件与外围采购料号尚未锁定；PCB封装文件、布局及实测未完成
依据 [34]SSD1306 图形显示
候选板卡的供应商示例历史选用板卡的原厂资料关联
记录编号：demo-adafruit-938 · 版本：e631f4c4e77a58e858044fbeddf1c36e9114b7458dfc3db959def158a8ff85d2
依据 [19]旋钮与按键读取
候选板卡的供应商示例历史选用板卡的原厂资料关联
记录编号：demo-adafruit-4991 · 版本：aaa08f5e0d206697002cf29324a1591b583360231ab5a18e5892fa722d8f1faf
依据 [15]四键输入与灯光反馈
候选板卡的供应商示例历史选用板卡的原厂资料关联
记录编号：demo-adafruit-4980 · 版本：6337b1250c3d38ed7d7f2c2668af6b963d8ef0858b283354e33ae4c3e606e436
依据 [8]3×4 矩阵键盘扫描
候选板卡的供应商示例历史选用板卡的原厂资料关联
记录编号：demo-adafruit-3845 · 版本：d9d2062306d01bbcaa2dc965b43ef8035f8ea82e550101e0bd29f6fbf5bff0f7
依据 [2]同源参考功能包
现有公开记录尚未将功能包及其实际工况绑定到本案例；以下仅列出具有相同原厂原理图依据的参考包，示例参数不作为案例参数或实测结果。
NeoKey 1×4 QT 四键与 RGB 交互板
同源电路参考 · 尚未采用与案例电路引用相同原厂原理图；尚未采用此功能包
记录编号：fp-neokey-four-key · 版本：6603643ac0673fc41fa3b63dcda4e8f8f373883a1560d2f7f4fa3c404805f400
待确认：仅确认引用相同原厂原理图；功能包修改、外围参数和案例完整网表尚未逐项绑定。；尚无本案例采用该功能包的版本锁定及实际工况记录；不使用示例参数补齐。；供电、时序、负载和板卡修订仍需按案例核对；此关联不证明仿真或实物验证通过。
依据 [28]I²C 旋转编码器与按压输入
同源电路参考 · 尚未采用与案例电路引用相同原厂原理图；尚未采用此功能包
记录编号：fp-rotary-encoder-i2c · 版本：e7f4f3f4fd9fe72d6ed545638d277f1218352933395185bd14b5053d2cd9e694
待确认：仅确认引用相同原厂原理图；功能包修改、外围参数和案例完整网表尚未逐项绑定。；尚无本案例采用该功能包的版本锁定及实际工况记录；不使用示例参数补齐。；供电、时序、负载和板卡修订仍需按案例核对；此关联不证明仿真或实物验证通过。
依据 [29]SSD1306 128×64 单色 OLED
同源电路参考 · 尚未采用与案例电路引用相同原厂原理图；尚未采用此功能包
记录编号：fp-ssd1306-oled · 版本：3938a8b814dd06371bd92316b50958d32c1e32d2fb10b8458e596d5406bc201d
待确认：仅确认引用相同原厂原理图；功能包修改、外围参数和案例完整网表尚未逐项绑定。；尚无本案例采用该功能包的版本锁定及实际工况记录；不使用示例参数补齐。；供电、时序、负载和板卡修订仍需按案例核对；此关联不证明仿真或实物验证通过。
依据 [30]TPS62827 3.3V 降压电源参考
同源电路参考 · 尚未采用与案例电路引用相同原厂原理图；尚未采用此功能包
记录编号：fp-tps62827-buck-3v3 · 版本：3e8fc6e65f417a62bf8663b1e152c79775fedce80e355b42ae044b27340b995d
待确认：仅确认引用相同原厂原理图；功能包修改、外围参数和案例完整网表尚未逐项绑定。；尚无本案例采用该功能包的版本锁定及实际工况记录；不使用示例参数补齐。；供电、时序、负载和板卡修订仍需按案例核对；此关联不证明仿真或实物验证通过。
依据 [27]展开其余 1 个功能电路包
USB-C 5V 受电与双 CC 下拉
同源电路参考 · 尚未采用与案例电路引用相同原厂原理图；尚未采用此功能包
记录编号：fp-usbc-5v-sink · 版本：258b27e1b2869f9c3cdb56ab88c638c73f71f4ada5bdc9d3abe6e9c8ec14db5b
待确认：仅确认引用相同原厂原理图；功能包修改、外围参数和案例完整网表尚未逐项绑定。；尚无本案例采用该功能包的版本锁定及实际工况记录；不使用示例参数补齐。；供电、时序、负载和板卡修订仍需按案例核对；此关联不证明仿真或实物验证通过。
依据 [26]检查记录与未解决问题
5 项检查 · 2 条缺口已有检查记录
案例网络图完整性
历史图完整性检查通过仅保存历史网络图结构检查结果；不证明电气工况、功能或制造可用。历史快照，源版本已变化，需重跑
记录日期：2026-10-12T00:15:49.938640+00:00
整机电气条件
尚无案例级完成证据本公开证据集没有可确认该案例已完成此项的结果；原厂例程、功能包示例和图完整性不能替代整机证据。
案例级电路仿真
尚无案例级完成证据本公开证据集没有可确认该案例已完成此项的结果；原厂例程、功能包示例和图完整性不能替代整机证据。
案例级固件编译
尚无案例级完成证据本公开证据集没有可确认该案例已完成此项的结果；原厂例程、功能包示例和图完整性不能替代整机证据。
案例级实物测试
尚无案例级完成证据本公开证据集没有可确认该案例已完成此项的结果；原厂例程、功能包示例和图完整性不能替代整机证据。
仍需补充或验证
原 RP2040 方案不能自动继承到 ESP32-S3/STM32；USB 引脚需复核
信息不足缺口详情待补充。
历史检查记录 2 个开放端子
信息不足数量来自对应历史检查；不代表当前设计已重新执行检查。
来源与可追溯资料
36 项来源来源说明资料依据；资料存在与本案例完成验证是不同状态。内部记录没有公开链接时保留记录标题。
- [1]3x4 Matrix Keypad ↗
可打开公开来源
- [2]3x4 Matrix Keypad ↗
可打开公开来源 · 资料记录日期：2026-09-21
- [3]3×4 矩阵键盘扫描 ↗
可打开公开来源 · 资料记录日期：2026-09-21
- [4]USB Type C Breakout (4090) ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [5]TPS62827 3.3V (4920) ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [6]EagleCAD files for schematic and Layout are available at GitHub ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [7]NeoKey 1x4 QT ↗
可打开公开来源
- [8]NeoKey 1x4 QT ↗
可打开公开来源 · 资料记录日期：2026-09-21
- [9]We have Arduino ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [10]CircuitPython/Python libraries ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [11]SAMD09 datasheet ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [12]adafruit_products_NK14_sch.png?1624643804 ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [13]四键输入与灯光反馈 ↗
可打开公开来源 · 资料记录日期：2026-09-21
- [14]STEMMA QT Rotary Encoder ↗
可打开公开来源
- [15]STEMMA QT Rotary Encoder ↗
可打开公开来源 · 资料记录日期：2026-09-21
- [16]adafruit_products_REI2C_sch.png?1620749653 ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [17]旋钮与按键读取 ↗
可打开公开来源 · 资料记录日期：2026-09-21
- [18]SSD1306 1.3in OLED ↗
可打开公开来源
- [19]SSD1306 1.3in OLED ↗
可打开公开来源 · 资料记录日期：2026-09-21
- [20]View on GitHub ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [21]UG-2832HSWEG02 ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [22]UG-2832HSWEG04 ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [23]adafruit_products_0-96in_OLED_sch.png?1596746114 ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [24]lcds___displays_schem.png?1476374564 ↗
可打开公开来源 · 资料记录日期：2026-09-16
- [25]SSD1306 图形显示 ↗
可打开公开来源 · 资料记录日期：2026-09-21
- [26]
- [27]
- [28]NeoKey 1x4 QT · 原厂器件电路 ↗
可打开公开来源
- [29]
- [30]
- [31]
- [32]ESP32-S3 模组最小系统 ↗
可打开公开来源
- [33]ESP32-S3 模组最小系统 ↗
可打开公开来源
- [34]I²C 上拉与总线边界 ↗
可打开公开来源
- [35]ESP32-S3-WROOM-1 ↗
可打开公开来源
- [36]ESP32-S3-WROOM-1 ↗
可打开公开来源
用这个案例开始你的硬件项目
先确认需要的功能与使用条件，再进入硬件和结构工作台。