1. 项目概述MultiPad 是一款基于 STM32F103VET6 微控制器构建的高自由度桌面控制键盘系统其设计目标是为开发者、内容创作者及效率追求者提供一套可深度定制、即插即用、软硬协同的物理交互层解决方案。与传统机械键盘或商用宏键盘不同MultiPad 并非以输入文字为核心而是将硬件按键、旋转编码器与多屏可视化反馈深度融合形成“操作—反馈—状态确认”闭环的人机交互范式。整个系统采用分层架构下位机STM32负责实时 HID 控制、本地 Flash 配置存储与多屏驱动上位机Electron Vue3 TypeScript提供所见即所得的图形化配置界面支持图像编辑、事件映射、逻辑编排与跨平台配置同步。所有功能均在不依赖持续运行上位机的前提下完成——配置数据固化于 MCU 内部 Flash设备拔插后仍可独立执行预设动作。项目强调工程落地性与复刻可行性BOM 成本可控在百元以内PCB 提供模块版含串口切换开关、BOOT/RESET 按键与 FPC 版精简结构、面向量产优化两种形态硬件焊接完成后仅需烧录固件即可进入配置流程无驱动安装、无环境依赖、无注册激活等环节。其 GPL-3.0 开源协议覆盖全部软硬件设计包括原理图、PCB、固件源码与上位机代码确保技术透明与社区可演进性。2. 系统架构与核心设计思想2.1 整体架构分层MultiPad 系统划分为三个逻辑层物理层Hardware Layer、固件层Firmware Layer和配置层Configuration Layer各层职责明确、接口清晰符合嵌入式系统模块化设计原则。物理层由 STM32F103VET6 主控、8 路机械按键、3 路旋转编码器带按压、1.47″ 彩色 LCD172×172 像素、2×0.42″ 单色 OLED64×40 像素、USB Type-C 接口及电源管理电路构成。所有外设均通过低引脚复用方式接入避免资源冲突。固件层基于 STM32 HAL 库开发构建 CDC Custom HID 复合 USB 设备。HID 部分进一步细分为 Keyboard、Mouse、Consumer Control媒体键三个独立报告描述符Report Descriptor使主机操作系统能将其识别为多个标准 HID 类设备无需额外驱动CDC 部分则作为双向配置通道承载屏幕图像数据、键值映射表、事件触发逻辑等非实时配置信息。配置层运行于 Windows/macOS/Linux 的 Electron 应用通过 USB CDC 与下位机建立可靠通信。其核心价值在于将抽象的键值映射转化为具象的视觉编辑——用户在软件中拖拽调整屏幕区域、导入 PNG 图标、设置文字样式系统自动完成图像压缩、坐标映射、数据分包与 Flash 地址规划并生成可验证的二进制配置块。该分层设计实现了“功能解耦”与“部署解耦”物理层决定扩展能力上限固件层保障实时性与兼容性配置层专注用户体验与逻辑表达。三者通过明确定义的二进制协议交互使得任意一层的独立升级不影响其余两层正常工作。2.2 关键设计决策解析1USB 复合设备模式选择STM32F103VET6 未集成 USB PHY项目采用外部 USB 收发器CH340G 或兼容芯片实现全速 USB 通信。但此处存在一个关键权衡是否使用 CH340 的 CDC 功能作为唯一通信通道答案是否定的。原因在于实时性瓶颈若所有 HID 输出如键盘敲击、鼠标移动均经由 CDC 透传至上位机再转发至主机将引入不可接受的延迟典型值 15ms且丧失断连自治能力协议兼容性风险Windows/macOS 对自定义 CDC 设备的 HID 模拟支持不稳定易触发签名警告或权限弹窗资源占用过高频繁的 CDC 数据收发挤占中断带宽影响编码器旋转检测精度与 LCD 刷新帧率。因此固件层采用HID 硬件直驱 CDC 配置通道的双轨机制HID 报告由 STM32 自主构造并提交至 USB D / D− 总线完全绕过 CDC 缓冲区CDC 仅用于低频、大数据量的配置同步。这种设计使 MultiPad 在 USB 枚举后即具备完整控制能力上位机仅作为“配置器”而非“运行时依赖”。2多屏显示架构与内存管理系统配备三类显示单元其驱动策略差异显著屏幕类型分辨率接口刷新方式显存占用固件处理策略1.47″ LCD172×172SPI4线全帧刷新~58 KB16bpp使用内部 SRAM 缓存一帧DMA 触发刷新图像数据从 Flash 加载支持区域更新0.42″ OLED ×264×40I²C行扫描~3.2 KB1bpp ×2共享 I²C 总线地址可配显存驻留于 RAM支持逐行异步刷新由于 STM32F103VET6 仅具备 64 KB SRAM无法同时容纳三屏全帧显存。固件采用按需加载 压缩存储策略LCD 图像以 RLERun-Length Encoding格式压缩后存于 Flash解压时动态写入显存OLED 图像以字模数组形式直接存储每个像素点对应 1 bit极大节省空间所有屏幕内容更新均通过统一的screen_update()接口触发内部根据屏幕 ID 调用对应驱动函数屏蔽底层差异。此设计在有限资源下达成显示灵活性与内存效率的平衡。3事件驱动模型与状态机设计MultiPad 的 8 个按键与 3 个编码器支持丰富的事件组合固件层未采用轮询方式检测而是构建两级中断响应机制一级硬件中断所有按键连接至 EXTI 线编码器 A/B 相位信号接入 TIM2/TIM3 编码器接口模式。中断服务程序ISR仅执行最轻量操作记录时间戳、更新计数器、置位事件标志二级状态机调度主循环中调用event_dispatch()函数依据标志位与时间戳计算事件类型如“短按”、“长按”、“左旋1格”、“按下右旋”并查询 Flash 中存储的事件映射表获取对应动作指令。事件映射表结构如下Flash 中连续存储typedef struct { uint8_t event_type; // 0x01KEY_DOWN, 0x02KEY_UP, 0x03ENCODER_LEFT, ... uint8_t action_type; // 0x01KEYBOARD, 0x02MOUSE, 0x03TEXT, ... uint16_t payload_len; // 后续有效字节数 uint8_t payload[32]; // 具体参数如键码、坐标偏移、文本指针等 } __attribute__((packed)) event_mapping_t;该结构支持任意长度的动作负载为未来扩展如剪贴板读写、进程启动预留空间。状态机设计确保事件响应延迟稳定在 5ms 以内满足人因工程对交互实时性的基本要求。3. 硬件设计详解3.1 主控与电源系统STM32F103VET6 作为 Cortex-M3 内核 MCU具备 72 MHz 主频、512 KB Flash、64 KB SRAM、3 个通用定时器、2 个 I²C、3 个 SPI、5 个 USART 及丰富的 GPIO完全满足 MultiPad 的外设驱动需求。其最小系统设计遵循 ST 官方推荐规范晶振电路外部 8 MHz HSE 晶振配合 22 pF 负载电容经 PLL 倍频至 72 MHz 作为系统时钟32.768 kHz LSE 未启用因无 RTC 需求复位电路10 kΩ 上拉电阻 100 nF 电容构成 RC 复位网络确保上电稳定电源滤波VDD/VDDA 引脚均配置 100 nF 陶瓷电容 10 μF 钽电容并联滤波USB 5 V 输入经 AMS1117-3.3 稳压后供给 MCU输出端加 10 μF 电解电容抑制低频纹波。特别地USB Type-C 接口采用 CC1/CC2 引脚悬空设计强制设备工作于 UFP下行端口模式避免角色协商复杂度D / D− 线串联 27 Ω 电阻匹配 USB 传输阻抗并通过 1.5 kΩ 上拉电阻接 3.3 V标识全速设备。3.2 输入设备接口设计1机械按键矩阵8 个按键采用独立 GPIO 设计非矩阵扫描每路按键一端接地另一端接 MCU GPIO配置为上拉输入。此设计虽占用 8 个 IO但带来两大优势去抖逻辑简化硬件消抖由 100 nF 电容完成软件仅需检测边沿变化避免复杂计时器去抖事件类型丰富每个按键可独立区分按下KEY_DOWN、抬起KEY_UP、长按500 ms、双击两次按下间隔 300 ms等状态为上位机提供细粒度控制原语。GPIO 分配兼顾电气特性所有按键 IO 均来自同一端口如 GPIOA便于批量读取中断线选用 EXTI0–EXTI7支持单个 NVIC 通道集中管理。2旋转编码器接口3 个 EC11 型旋转编码器分别接入 TIM2CH1/CH2、TIM3CH1/CH2、TIM4CH1/CH2工作于编码器接口模式。该模式下定时器自动对 A/B 相位脉冲进行四倍频计数无需 CPU 干预即可获得精确旋转方向与步数。每个编码器的 SWSwitch引脚单独接入 GPIO同样配置为上拉输入支持按下SW_PRESS、抬起SW_RELEASE、按下旋转SW_PRESS_ROTATE等复合事件。为防止机械抖动导致误计数固件在定时器捕获中断中加入 2 μs 延迟NOP 指令待信号稳定后再读取计数值。实测该方案可将误触发率降至 0.1% 以下。3.3 显示系统电路11.47″ 彩色 LCDST7789VLCD 模块采用 4 线 SPI 接口SCL/MOSI/DC/CS/RES驱动芯片为 ST7789V支持 172×172 RGB565 显示。电路设计要点SPI 速率配置为 24 MHzAPB1 最大频率满足 60 fps 刷新需求全帧传输约 12 msDC 与 RES 引脚DCData/Command控制寄存器/数据写入模式RESReset由 GPIO 控制上电时执行硬复位背光驱动LED 接 3.3 VLED− 经 10 Ω 限流电阻接地亮度固定降低功耗与发热。20.42″ OLEDSSD1306两片 SSD1306 OLED 共享同一 I²C 总线PB6/SCL、PB7/SDA通过 A0/A1 引脚配置不同设备地址0x3C 与 0x3D。I²C 上拉电阻选用 4.7 kΩ兼顾速度100 kHz 标准模式与抗干扰性。OLED 采用 1 bpp 显示每屏显存仅需 320 字节64×40÷8可全驻留 RAM刷新延迟低于 1 ms。3.4 USB 通信与调试接口项目提供双烧录路径串口烧录Module 版CH340G 作为 USB-UART 桥接芯片TXD/RXD 分别接 STM32 PA9/PA10SWDIO/SWCLK 引出至 4 针排针支持 ST-Link/J-Link 在线调试SWD 烧录通用所有版本均保留 SWD 接口引脚定义严格遵循 ARM CMSIS-DAP 标准SWDIO、SWCLK、GND、3.3 V。Module 版 PCB 集成 USB/UART 切换拨码开关避免 DTR/RTS 电平冲突FPC 版则移除该开关USB 直连 STM32 的 USB PHY通过 CH340G 模拟结构更紧凑。4. 固件设计与关键实现4.1 USB 设备枚举与报告描述符固件基于 STM32CubeMX 生成的 USB Device 中间件自定义USBD_CUSTOM_HID_ReportDesc数组实现三重 HID 功能__ALIGN_BEGIN static uint8_t CUSTOM_HID_ReportDesc_FS[USBD_CUSTOM_HID_REPORT_DESC_SIZE] __ALIGN_END { // Keyboard Report Descriptor (HID 1.11 §10) 0x05, 0x01, // USAGE_PAGE (Generic Desktop) 0x09, 0x06, // USAGE (Keyboard) 0xa1, 0x01, // COLLECTION (Application) 0x05, 0x07, // USAGE_PAGE (Keyboard/Keypad) 0x19, 0xe0, // USAGE_MINIMUM (Keyboard LeftControl) 0x29, 0xe7, // USAGE_MAXIMUM (Keyboard Right GUI) 0x15, 0x00, // LOGICAL_MINIMUM (0) 0x25, 0x01, // LOGICAL_MAXIMUM (1) 0x75, 0x01, // REPORT_SIZE (1) 0x95, 0x08, // REPORT_COUNT (8) 0x81, 0x02, // INPUT (Data,Var,Abs) 0x95, 0x01, // REPORT_COUNT (1) 0x75, 0x08, // REPORT_SIZE (8) 0x81, 0x03, // INPUT (Cnst,Var,Abs) 0x95, 0x06, // REPORT_COUNT (6) 0x75, 0x08, // REPORT_SIZE (8) 0x15, 0x00, // LOGICAL_MINIMUM (0) 0x25, 0xff, // LOGICAL_MAXIMUM (255) 0x05, 0x07, // USAGE_PAGE (Keyboard/Keypad) 0x19, 0x00, // USAGE_MINIMUM (Reserved) 0x29, 0x65, // USAGE_MAXIMUM (Keyboard Application) 0x81, 0x00, // INPUT (Data,Ary,Abs) 0xc0, // END_COLLECTION // Mouse Report Descriptor 0x05, 0x01, // USAGE_PAGE (Generic Desktop) 0x09, 0x02, // USAGE (Mouse) 0xa1, 0x01, // COLLECTION (Application) 0x09, 0x01, // USAGE (Pointer) 0xa1, 0x00, // COLLECTION (Physical) 0x05, 0x09, // USAGE_PAGE (Button) 0x19, 0x01, // USAGE_MINIMUM (Button 1) 0x29, 0x03, // USAGE_MAXIMUM (Button 3) 0x15, 0x00, // LOGICAL_MINIMUM (0) 0x25, 0x01, // LOGICAL_MAXIMUM (1) 0x95, 0x03, // REPORT_COUNT (3) 0x75, 0x01, // REPORT_SIZE (1) 0x81, 0x02, // INPUT (Data,Var,Abs) 0x95, 0x01, // REPORT_COUNT (1) 0x75, 0x05, // REPORT_SIZE (5) 0x81, 0x03, // INPUT (Cnst,Var,Abs) 0x05, 0x01, // USAGE_PAGE (Generic Desktop) 0x09, 0x30, // USAGE (X) 0x09, 0x31, // USAGE (Y) 0x15, 0x81, // LOGICAL_MINIMUM (-127) 0x25, 0x7f, // LOGICAL_MAXIMUM (127) 0x75, 0x08, // REPORT_SIZE (8) 0x95, 0x02, // REPORT_COUNT (2) 0x81, 0x06, // INPUT (Data,Var,Rel) 0x09, 0x38, // USAGE (Wheel) 0x15, 0x81, // LOGICAL_MINIMUM (-127) 0x25, 0x7f, // LOGICAL_MAXIMUM (127) 0x75, 0x08, // REPORT_SIZE (8) 0x95, 0x01, // REPORT_COUNT (1) 0x81, 0x06, // INPUT (Data,Var,Rel) 0xc0, // END_COLLECTION 0xc0, // END_COLLECTION // Consumer Control Report Descriptor 0x05, 0x0c, // USAGE_PAGE (Consumer) 0x09, 0x01, // USAGE (Consumer Control) 0xa1, 0x01, // COLLECTION (Application) 0x85, 0x03, // REPORT_ID (3) 0x09, 0x02, // USAGE (Numeric Key Pad) 0xa1, 0x02, // COLLECTION (Logical) 0x05, 0x09, // USAGE_PAGE (Button) 0x19, 0x01, // USAGE_MINIMUM (Button 1) 0x29, 0x0a, // USAGE_MAXIMUM (Button 10) 0x15, 0x00, // LOGICAL_MINIMUM (0) 0x25, 0x01, // LOGICAL_MAXIMUM (1) 0x75, 0x01, // REPORT_SIZE (1) 0x95, 0x0a, // REPORT_COUNT (10) 0x81, 0x02, // INPUT (Data,Var,Abs) 0xc0, // END_COLLECTION 0xc0 // END_COLLECTION };该描述符使 Windows 设备管理器识别为“HID 键盘”、“HID 兼容鼠标”、“HID 消费电子设备”三个独立设备无需任何第三方驱动即可工作。4.2 Flash 存储布局与配置管理STM32F103VET6 的 512 KB Flash 被划分为以下区域地址范围大小用途说明0x08000000–0x0800FFFF64 KBBootloader System Code存放 USB CDC 驱动、HID 报告构造、事件调度核心0x08010000–0x08017FFF32 KBConfiguration Data存储屏幕图像、键值映射表、菜单层级结构0x08018000–0x0801FFFF32 KBReserved for Future预留 OTA 升级、日志存储等扩展空间0x08020000–0x0807FFFF384 KBUser Application当前未使用可扩展为文件系统或固件备份区配置数据采用结构化存储起始处为魔数0x4D554C54MULT ASCII后跟版本号、校验和、总长度再依次存放 LCD 图像数据、OLED 图像数据、事件映射表。每次上位机下发新配置时固件先校验 CRC32仅当校验通过才擦除对应扇区并写入确保配置原子性。4.3 实时 HID 报告构造与发送HID 报告发送采用零拷贝策略避免内存复制开销键盘报告全局静态数组keyboard_report_t kb_report事件发生时直接修改对应字节调用USBD_CUSTOM_HID_SendReport(hUsbDeviceFS, (uint8_t*)kb_report, sizeof(kb_report))鼠标报告同理mouse_report_t mouse_report结构体包含 X/Y 偏移、按钮状态、滚轮增量媒体键复用 Consumer Control 报告 ID3通过report[0]0x03; report[1]media_code发送。所有报告均在事件 ISR 中标记“需发送”主循环中统一检查标志位并调用发送函数确保 USB IN 端点缓冲区不被重复填充。5. 上位机软件架构与配置协议5.1 配置数据协议设计上位机与下位机通过 CDC 串口通信协议为 TLVType-Length-Value格式帧结构如下字段长度说明Header2 B固定值0xAA 0x55Type1 B0x01LCD Image, 0x02OLED Image, 0x03Event Map, 0x04Request ConfigLength2 BValue 字段长度小端序ValueN B具体数据载荷CRC81 BHeaderTypeLengthValue 的 CRC8 校验例如下发 LCD 图像时Type0x01Length 为压缩后图像字节数Value 为 RLE 编码数据流。下位机收到后先校验 CRC8再根据 Type 调用对应解析函数最终写入 Flash 指定地址。5.2 图形化编辑引擎实现上位机使用 Canvas API 实现所见即所得编辑图像导入支持 PNG 解码通过pngjs库自动适配 LCD172×172与 OLED64×40分辨率提供裁剪、缩放、滤镜灰度、二值化、反色工具文字渲染内置 8×16、12×24 等多套点阵字体支持 UTF-8 中文GB2312 编码映射文字位置可拖拽调整组件布局每个屏幕区域视为独立 Canvas用户可添加图标、文字、分隔线等组件组件属性坐标、颜色、大小实时序列化为 JSON与图像数据一同下发。编辑完成后软件自动执行以下步骤将 LCD 画布导出为 PNG调用 WASM 模块进行 RLE 压缩将 OLED 画布二值化生成紧凑的字模数组将所有事件映射关系按键→动作序列化为二进制事件表按 TLV 协议打包分片每片 ≤512 B通过 CDC 发送。5.3 跨平台兼容性保障Electron 应用通过serialport库访问 USB CDC 设备在 Windows/macOS/Linux 下均使用相同 API。为规避 macOS 的 USB 权限问题软件启动时自动检查设备列表若未发现 MultiPad则提示用户执行以下命令# macOS: 添加 USB 设备规则 echo SUBSYSTEMusb, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, MODE0666 | sudo tee /etc/udev/rules.d/99-multi-pad.rules sudo udevadm control --reload-rulesWindows 下则通过 INF 驱动文件确保 CH340G 被正确识别为 COM 端口。6. BOM 清单与成本分析序号器件型号/规格数量单价¥备注1主控芯片STM32F103VET6112.5LQFP100 封装嘉立创现货2USB 转串口CH340G11.2Module 版专用FPC 版省略3彩色 LCD1.47″ ST7789V172×172118.0带 PCB 转接板4OLED 屏幕0.42″ SSD130664×4028.5×217.0I²C 接口地址可配5机械按键Gateron 黑轴或国产替代81.5×812.0支持热插拔6旋转编码器EC11带按压33.0×39.0带金属外壳7连接器USB Type-C 母座12.5直插式8电容电阻0603 封装常规料若干3.0含滤波、上拉等9PCB双面喷锡含 SMT125.0嘉立创 2 层板10 cm×10 cm合计≈98.2不含外壳与线材注价格基于 2023 年嘉立创商城批量采购均价实际成本受订单数量、物流、汇率影响。FPC 版因省去 CH340G、拨码开关、按键、BOOT/RESET 按钮BOM 成本可再降 8–10 元。7. 快速上手与调试指南7.1 首次使用流程硬件组装焊接 STM32F103VET6、CH340GModule 版、LCD/OLED、按键、编码器确保无虚焊、短路固件烧录Module 版下载最新.hex文件使用 MCU ISP 软件将 USB/UART 开关拨至左侧UART 模式点击“开始编程”通用版使用 ST-Link Utility连接 SWD 接口选择.hex文件点击“Program Download”上位机配置下载最新版key-pad-application解压后双击MultiPad.exeWindows插入设备软件自动识别 COM 端口点击“连接设备”在主界面编辑 LCD/OLED 内容配置按键事件点击“写入设备”验证运行拔掉 USB 线重新插入电脑观察屏幕是否显示配置内容操作按键/编码器是否触发对应功能。7.2 常见问题排查现象可能原因解决方法设备管理器显示“未知设备”CH340G 驱动未安装下载 WCH 官方驱动CH341SER.EXE安装上位机无法连接 COM 口USB 线不支持数据传输更换带数据线缆的 USB 线LCD 屏幕全白/花屏LCD 初始化失败检查 RES 引脚电平、SPI 速率是否超限、DC 引脚连接编码器旋转无响应A/B 相位接反或抖动用示波器观测 A/B 波形确认相位差 90°增加硬件滤波电容按键触发延迟高GPIO 去抖参数不当修改KEY_DEBOUNCE_MS宏定义建议 10–20 ms配置写入后丢失Flash 写入校验失败降低 CDC 传输波特率至 115200重试写入所有调试信息可通过 STM32 的 USART1PA9/PA10输出使用串口助手查看printf日志固件中已预留DEBUG_LOG宏开关。8. 扩展性与二次开发支持MultiPad 的开源设计为深度定制提供坚实基础硬件扩展原理图中预留 I²C、SPI、UART 多个外设接口可轻松添加温湿度传感器SHT30、RGB 灯带WS2812、蜂鸣器等相关驱动已纳入 HAL 库框架固件定制CMake 构建系统支持模块化编译开发者可禁用LCD_DRIVER或OLED_DRIVER以减小代码体积事件映射表解析逻辑位于event_parser.c可扩展支持 MQTT 上报、BLE 广播等新动作类型上位机增强Vue3 组件化架构允许新增“宏录制”、“脚本编辑器JavaScript”、“多设备同步”等高级功能所有 UI 组件均通过src/renderer/components/目录组织遵循单一职责原则。项目 GitHub 仓库iLx11/multi-pad与iLx11/key-pad-application持续维护Issue 区域开放技术讨论Pull Request 欢迎高质量贡献。对于希望将 MultiPad 集成至自有产品的工程师建议从firmware/src/app/event_handler.c入手理解事件分发机制从app/src/main.ts入手掌握 USB 通信生命周期管理。