基于STM32F103的USB HID键盘开发：从矩阵扫描到协议实现-平芜编程栈

1. 项目概述与核心价值

最近在整理工作室的旧物，翻出来好几块吃灰的STM32F103C8T6核心板，也就是大家常说的“蓝板”或者“最小系统板”。看着这些当年玩剩下的“古董”，总觉得直接扔了有点可惜。正好手头缺一个用来调试设备、偶尔输个命令的备用小键盘，一个念头就冒出来了：能不能用这块小小的STM32，自己动手做一个USB键盘呢？

这个想法听起来可能有点“杀鸡用牛刀”，毕竟市面上USB键盘转换器或者宏键盘套件已经很成熟了。但自己做，乐趣和收获是完全不同的。你不仅能得到一个完全按自己想法定制的硬件——比如把不常用的F区键改成多媒体控制，或者做一个专为某个软件（像CAD、视频剪辑）优化的快捷键键盘；更重要的是，你能从头到尾搞清楚一个USB设备是如何被电脑识别并工作的。从芯片的GPIO扫描按键，到USB HID协议的数据打包，再到系统驱动的交互，整个链路打通之后，你对“设备即插即用”的理解会深刻得多。

对于电子爱好者、嵌入式初学者，或者想给项目增加一个人机交互界面的开发者来说，基于STM32制作USB键盘都是一个绝佳的练手项目。它综合了GPIO输入、定时器中断、USB设备协议栈等核心知识点，但难度又控制在入门到进阶的范围内。用STM32 CubeMX工具进行图形化配置，可以省去大量底层寄存器操作的繁琐工作，让我们更专注于应用逻辑。最终，你将获得一个即插即用、无需额外驱动的USB键盘，它可能外观简陋，但内核扎实，而且完全受你控制。

2. 硬件选型与电路设计思路

2.1 核心控制器：为什么是STM32F103？

选择STM32F103C8T6作为核心，几乎是这个项目的“标准答案”，原因有几个方面。首先，它是经典的Cortex-M3内核，主频72MHz，对于扫描几十个按键、处理USB通信绰绰有余。其次，也是最重要的一点，它内置了全速USB（12 Mbps）设备控制器。这意味着我们不需要像早期的51单片机那样，外挂一片CH375或PDIUSBD12之类的USB协议芯片，单芯片就能搞定所有事情，大大简化了硬件设计和成本。

这块芯片的社区资源极其丰富，各种库、教程、问题解答一搜一大把，几乎你遇到的每一个坑，前人都踩过并填平了。像我们手头的“蓝板”，通常已经引出了USB的D+和D-信号线到特定的引脚（PA11, PA12），并且板载了3.3V稳压和基本的复位电路，我们只需要专注于键盘矩阵电路和USB端口即可。

注意：并非所有STM32F103系列都支持USB。一定要确认你芯片的具体型号，像F103C6（小容量）是不带USB的，而F103C8（中容量）及以上才支持。购买核心板时务必看清描述。

2.2 键盘矩阵设计：平衡引脚与效率

一个全尺寸104键键盘如果每个键独立占用一个GPIO，那需要104个引脚，显然不现实。通用的方法是采用矩阵扫描。原理很简单：将按键排列成行和列，通过单片机引脚输出扫描行信号，同时读取列线的输入状态，从而通过行列坐标确定被按下的键。

对于一个自制的小键盘或宏键盘，我们可能不需要那么多键。假设我们设计一个包含26个字母键、10个数字键、回车、空格等常用键的紧凑键盘，大约需要40-50个键。一个经典的8x8矩阵可以支持64个键，这完全够用，甚至还有富余。

电路设计要点：

上拉电阻：每个列线都需要一个上拉电阻（通常4.7kΩ或10kΩ）接到3.3V。当没有按键按下时，列线被拉高为逻辑‘1’；当某行被拉低且该行某列的按键被按下时，对应的列线就会被拉低至‘0’。STM32的GPIO可以配置为内部上拉，但为了稳定性和抗干扰，尤其是在矩阵规模稍大时，建议外部上拉电阻还是加上。
二极管隔离：这是实现“全键无冲”（NKRO）或至少“6键无冲”的关键。在每个按键上串联一个开关二极管（如1N4148），方向从行线指向列线。它的作用是防止当多个键同时按下时，电流通过不同的路径反向流通，导致“鬼键”（Ghosting）现象，即检测到实际并未按下的键。对于自制键盘，如果对无冲要求不高（通常USB标准HID键盘默认是6键无冲），为了简化焊接，可以暂时不加二极管，但需要了解其原理。
消抖处理：按键是机械触点，闭合和断开瞬间会产生抖动，可能导致单片机误判为多次按下。消抖可以通过硬件（RC滤波电路）或软件实现。我们通常采用软件消抖，在检测到按键状态变化后，延时10-20ms再次检测，如果状态稳定则确认为有效动作。

引脚规划示例（8x8矩阵）：

行线（输出）：使用GPIOA的PA0-PA7，共8个引脚，配置为推挽输出。
列线（输入）：使用GPIOB的PB0-PB7，共8个引脚，配置为上拉输入。

这样我们使用了16个GPIO，实现了对64个按键的监控。你可以根据自己键盘的实际键位布局来规划行和列，不一定要用满8x8。

2.3 USB接口电路：简单但不可马虎

USB接口电路相对简单，但细节决定成败。

USB Connector：使用标准的Micro-USB或USB Type-C母座。对于自制，Micro-USB更常见，引脚少，易于焊接。
数据线：USB的D+（PA12）和D-（PA11）信号线，需要直接连接到连接器。为了信号完整性，建议在数据线靠近芯片端串联一个22Ω左右的电阻（有的设计也会用0Ω电阻代替，作为调试预留）。
电源：USB的VBUS（+5V）接入后，绝对不能直接接到STM32的VDD！STM32的工作电压是3.3V。我们需要一个LDO稳压芯片（如AMS1117-3.3），将5V降压为稳定的3.3V，为整个系统供电。你的核心板上如果已有这个稳压电路，则只需将USB的VBUS和GND接到板子的5V和GND输入点即可。
电容：在3.3V和GND之间，靠近芯片电源引脚处，放置一个0.1uF和一个10uF的电容进行去耦，这是保证单片机稳定运行的基本操作。

3. 软件环境搭建与CubeMX工程配置

3.1 工具链准备：Keil、CubeMX与驱动

工欲善其事，必先利其器。我们需要三个核心软件：

STM32CubeMX：ST官方的图形化配置工具，它可以根据你的选择，自动生成芯片初始化代码（HAL库），是快速开发的神器。去ST官网下载安装即可。
Keil MDK-ARM (uVision)：经典的ARM开发IDE，用于编写、编译和调试代码。需要安装对应STM32F1系列的Device Pack。
ST-LINK/V2驱动：用于连接ST-LINK仿真器（或那种带ST-LINK的核心板）和电脑，进行程序下载和调试。同样在ST官网下载。

安装过程按部就班即可，注意安装路径不要有中文。安装完CubeMX后，第一次打开它会在线下载芯片支持包，找到F1系列，安装STM32F1的DFP（Device Family Pack）。

3.2 CubeMX工程初始化：从芯片到时钟树

打开CubeMX，点击New Project，在芯片选择器里输入STM32F103C8，在结果中选中STM32F103C8Tx，点击Start Project。

第一步：配置系统核心（SYS）在Pinout & Configuration标签页，找到System Core->SYS。

Debug：选择Serial Wire。这会将PA13和PA14用作SWD接口，用于调试和下载程序。如果你只用串口下载，可以选No Debug，但强烈建议保留SWD，调试方便。
Timebase Source：保持默认的SysTick即可。这是HAL库的时基来源。

第二步：配置时钟（RCC）找到System Core->RCC。

High Speed Clock (HSE)：选择Crystal/Ceramic Resonator。我们的核心板外部通常有一个8MHz的晶振，这是主时钟源。
Low Speed Clock (LSE)：保持Disable，我们暂时用不到RTC。

第三步：配置时钟树（Clock Configuration）点击顶部的Clock Configuration标签页，这是关键一步。我们需要将系统时钟配置到72MHz。

在输入部分，将HSE旁的分频/倍频框设置为8（MHz），表示我们接的是8M晶振。
找到PLL Source Mux，选择HSE。
配置PLLMUL，选择x9倍频。这样PLL输出 = 8MHz * 9 = 72MHz。
将System Clock Mux的源选择为PLLCLK。
检查HCLK（AHB总线时钟）是否自动变成了72MHz。APB1总线时钟最高36MHz，APB2总线时钟最高72MHz，系统会自动分频，保持绿色即可。
USB Clock：务必确保USB Clock的源是PLLCLK，并且经过一个分频器后，输入到USB模块的时钟是48MHz。这是USB全速设备控制器要求的精确时钟。在F103的时钟树里，通常是从PLL输出（72MHz）经过1.5分频得到48MHz。CubeMX通常会帮你算好，你只要确认USB Clock显示为48MHz即可。

第四步：配置USB外设回到Pinout & Configuration标签页，找到Connectivity->USB。

Mode：选择Device (FS)，即全速设备模式。
此时，左侧的芯片图上，PA11(USB_DM)和PA12(USB_DP)应该被自动分配了。

第五步：配置GPIO用于键盘矩阵假设我们使用之前规划的PA0-PA7为行（输出），PB0-PB7为列（输入）。

点击芯片图的PA0引脚，选择GPIO_Output。依次设置PA1到PA7为GPIO_Output。在左侧的System Core->GPIO中，可以批量设置这8个引脚。将输出模式设为Output Push Pull（推挽输出），上/下拉设为No pull-up and no pull-down，默认输出电平设为High（高电平，即不扫描时行线为高）。
点击芯片图的PB0引脚，选择GPIO_Input。依次设置PB1到PB7为GPIO_Input。在GPIO配置里，将这8个引脚的模式设为Input，上/下拉设为Pull-up（上拉输入）。这样我们就利用了芯片内部的上拉电阻，简化了电路。

3.3 生成工程代码：迈出第一步

点击顶部菜单的Project Manager标签页。

Project：填写工程名、存储路径（路径务必全英文！），选择MDK-ARM作为Toolchain/IDE。
Code Generator：这里有个重要设置。勾选Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral，这样每个外设的代码会单独成文件，结构更清晰。勾选Backup previously generated files when re-generating，重新生成代码时会备份旧文件，防止误覆盖你的修改。

最后，点击右上角的GENERATE CODE。CubeMX会生成一个完整的Keil工程。首次生成可能会提示安装软件包，确认即可。生成完毕后，点击Open Project，系统会自动用Keil打开这个工程。

4. USB HID设备描述符配置与报告描述符详解

4.1 USB枚举与描述符基础

当我们的“键盘”插入电脑时，电脑（主机）会发起一个叫做“枚举”的过程。主机会问：“你是谁？你能干什么？” 我们的设备就需要通过一系列标准化的数据结构来回答，这些数据结构就是“描述符”。对于HID（人机接口设备）键盘，核心描述符包括：

设备描述符 (Device Descriptor)：描述整个设备的基本信息，比如厂商ID（VID）、产品ID（PID）、版本号、设备类等。
配置描述符 (Configuration Descriptor)：描述设备的一种工作配置（供电模式、接口数量等）。
接口描述符 (Interface Descriptor)：一个配置下可以有多个接口。对于键盘，我们通常只有一个HID接口。这里会指明接口类（HID）、子类（Boot Interface，启动接口，兼容性更好）、协议（Keyboard）。
HID描述符 (HID Descriptor)：指向“报告描述符”的位置，并说明报告的长度。
端点描述符 (Endpoint Descriptor)：USB通信的数据管道。HID键盘至少需要一个中断输入端点（IN Endpoint），用于向主机发送按键数据。中断传输保证了数据的实时性。
报告描述符 (Report Descriptor)：这是HID设备的“灵魂”，它用一套复杂的语言（HID Usage Tables）定义了你这个设备能发送什么样的数据包（报告），每个数据位代表什么含义（比如哪个字节是修饰键，哪个字节是普通键值）。

幸运的是，CubeMX和HAL库帮我们自动生成了设备、配置、接口、端点和HID描述符。我们大部分工作，是理解和修改报告描述符。

4.2 在CubeMX中配置HID报告描述符

CubeMX可以帮我们生成一个简单的键盘报告描述符。在USB配置界面，找到Device Descriptor和Configuration Descriptor子菜单。

在Device Descriptor里，可以修改Vendor ID和Product ID。默认的VID/PID是ST的，对于自制设备，我们可以使用一个测试用的ID，比如0x0483（ST）和0x5750，或者去USB-IF申请一个（个人项目非商用通常用测试ID即可）。
在Configuration Descriptor->Interface 0->HID里，我们可以设置报告描述符。但CubeMX的图形化配置对报告描述符的支持有限，通常它生成的是一个非常基础的键盘描述符。

更常见的做法是，我们使用一个现成的、功能完善的键盘报告描述符，直接替换掉CubeMX生成的默认描述符。这个描述符定义在工程目录USB_DEVICE/App/usbd_hid.c文件中的一个常量数组里，变量名通常是HID_KEYBOARD_ReportDesc。

4.3 键盘报告描述符拆解与修改

一个标准的USB键盘报告描述符定义了主机期望从设备收到的数据格式。对于键盘，它通常发送一个8字节的报告：

字节0 (Byte 0)：修饰键（Modifier Keys）。每一位代表一个键：左Ctrl, 左Shift, 左Alt, 左GUI（Win键）, 右Ctrl, 右Shift, 右Alt, 右GUI。按下为1，释放为0。
字节1 (Byte 1)：保留字节，必须为0。
字节2-7 (Byte 2-7)：普通按键（Key Codes）。最多可以同时报告6个普通按键的键值（这就是USB标准键盘6键无冲的由来）。键值0表示无按键。

报告描述符就是用代码定义了这个8字节的结构。我们不需要从零开始写，可以找一个可靠的模板。例如，一个典型的Boot Keyboard报告描述符如下（这是一个简化示意，实际是一串十六进制数）：

const uint8_t HID_KEYBOARD_ReportDesc[63] = { 0x05, 0x01, // USAGE_PAGE (Generic Desktop) 0x09, 0x06, // USAGE (Keyboard) 0xa1, 0x01, // COLLECTION (Application) 0x05, 0x07, // USAGE_PAGE (Key Codes) 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) // 每个用法占1bit 0x95, 0x08, // REPORT_COUNT (8) // 有8个这样的用法（8个修饰键） 0x81, 0x02, // INPUT (Data,Var,Abs) // 这8个bit作为输入 0x95, 0x01, // REPORT_COUNT (1) // 下面1个字段 0x75, 0x08, // REPORT_SIZE (8) // 字段大小为8bit（1字节） 0x81, 0x03, // INPUT (Cnst,Var,Abs) // 这1个字节是常量（保留字节） 0x95, 0x06, // REPORT_COUNT (6) // 下面6个字段 0x75, 0x08, // REPORT_SIZE (8) // 每个字段8bit 0x15, 0x00, // LOGICAL_MINIMUM (0) 0x25, 0x65, // LOGICAL_MAXIMUM (101) // 最大键值 0x05, 0x07, // USAGE_PAGE (Key Codes) 0x19, 0x00, // USAGE_MINIMUM (Reserved (no event indicated)) 0x29, 0x65, // USAGE_MAXIMUM (Keyboard Application) 0x81, 0x00, // INPUT (Data,Ary,Abs) // 这6个字节是数组，代表6个按键 0xc0 // END_COLLECTION };

如何修改？对于自制键盘，我们通常不需要修改这个描述符本身，除非你想增加额外的功能（比如多媒体键、系统状态LED控制等）。我们只需要理解，我们的程序最终需要按照这个格式，组装一个8字节的数组（报告），并通过USB发送出去。

关键操作：在Keil工程中，找到USB_DEVICE/App/usbd_hid.c，用上面这个完整的描述符数组替换掉文件中原有的HID_KEYBOARD_ReportDesc数组。然后，在同一个文件中，找到报告的长度定义（可能在文件开头或USBD_HID_Setup函数附近），确保HID_KEYBOARD_REPORT_DESC_SIZE被定义为正确的长度（比如上面的例子是63）。

5. 键盘扫描逻辑与键值映射实现

5.1 矩阵扫描算法：逐行扫描法

有了硬件矩阵，我们需要一个软件算法来定期检测哪个键被按下。最常用的是“逐行扫描法”。其原理是，依次将每一行线拉低（输出0），然后读取所有列线的状态。如果某列线读到了低电平（0），说明当前被拉低的这一行和这一列交叉点的按键被按下了。

我们用一个定时器（比如TIM2）来产生一个周期性中断（例如1ms），在这个中断服务函数里执行扫描任务。这样可以确保扫描频率稳定，不受主循环其他任务的影响。

扫描步骤伪代码：

初始化所有行线为高电平（1）。
进入定时器中断。
将当前扫描行current_row拉低（0），其他所有行拉高（1）。
延时一小段时间（几个微秒，可用HAL_Delay或空循环），等待信号稳定。
读取所有列线的状态，存入一个变量column_state。
将column_state与上一次扫描时该行的状态last_state[current_row]进行比较。
如果状态发生变化（从高到低是按下，从低到高是释放），则进行软件消抖：设置一个消抖计时器，在接下来的几次扫描中，如果状态稳定，则确认为有效按键事件。
根据current_row和column_state中为0的列位，计算出按键的坐标（行，列）。
将坐标转换为对应的USB HID键值（Key Code）。
更新last_state[current_row]为当前的column_state。
current_row加1，指向下一行。如果超过总行数，则归零。
退出中断。

5.2 键值映射表：从坐标到HID键值

我们需要建立一个二维数组keymap[ROW_COUNT][COLUMN_COUNT]，作为键值映射表。数组的每个元素存储对应位置按键的HID Usage ID。这个ID是USB HID规范定义好的，例如：

0x04对应 a/A
0x05对应 b/B
...
0x1D对应 z/Z
0x27对应 0/)
0x1E对应 1/!
0x2C对应空格 (Space)
0x28对应回车 (Enter)
0x2A对应退格 (Backspace)
0xE0对应左Ctrl (作为修饰键，在报告的第0字节处理)

示例映射表定义：

// 假设是4x4矩阵，实际请根据你的布局修改 #define ROW_NUM 4 #define COL_NUM 4 const uint8_t keymap[ROW_NUM][COL_NUM] = { {HID_KEY_A, HID_KEY_S, HID_KEY_D, HID_KEY_F}, {HID_KEY_Q, HID_KEY_W, HID_KEY_E, HID_KEY_R}, {HID_KEY_1, HID_KEY_2, HID_KEY_3, HID_KEY_ENTER}, {HID_KEY_LEFT_CTRL, HID_KEY_SPACE, HID_KEY_BACKSPACE, HID_KEY_ESC} };

注意，像HID_KEY_LEFT_CTRL这样的修饰键，其值通常是0xE0。在发送报告时，我们需要特殊处理，将其放到报告的第0字节（修饰键字节）的对应位上，而不是放到第2-7字节的普通键数组里。

5.3 状态管理与报告发送

我们需要维护几个关键的数据结构：

按键状态矩阵：一个二维数组keystate[ROW_NUM][COL_NUM]，记录每个按键当前是“按下”还是“释放”状态。
当前报告：一个8字节的数组keyboard_report[8]，其结构必须严格按照报告描述符的定义来组织。
消抖计数器：为每个按键设置一个计数器，用于软件消抖。

主循环或中断中的处理流程：

扫描矩阵，得到变化的按键坐标和动作（按下/释放）。
如果是按下动作，且该按键的消抖计数器为0，则将其状态置为“按下”，并触发“按键按下处理”。
如果是释放动作，且该按键状态为“按下”，则将其状态置为“释放”，并触发“按键释放处理”。
“按键按下处理”：
- 判断键值：如果是修饰键（如Ctrl, Shift），则将keyboard_report[0]的对应位置1。
- 如果是普通键，则遍历keyboard_report[2]到keyboard_report[7]这6个字节，找到一个值为0（空闲）的位置，将HID键值填入。
“按键释放处理”：
- 如果是修饰键，则将keyboard_report[0]的对应位置0。
- 如果是普通键，则遍历keyboard_report[2]到keyboard_report[7]，找到与释放键值相等的那个字节，将其置为0。
无论是否有按键状态变化，只要keyboard_report的内容与上一次发送的报告不同，就调用USB发送函数，将新的报告发送给主机。USB HID库通常提供一个发送函数，如USBD_HID_SendReport()。

实操心得：发送报告的频率不宜过高也不宜过低。通常可以在主循环中，每隔几毫秒检查一次报告是否有变化，有变化则发送。也可以在有按键事件发生时立即发送。但要注意，USB中断传输有带宽限制，过于频繁的发送可能造成数据堆积。实测下来，在按键事件触发时发送，并在没有按键时每隔10-20ms发送一次空报告（所有键值为0）以保持连接活性，是一个比较稳定的策略。

6. 主程序逻辑整合与调试技巧

6.1 程序骨架搭建

在main.c的主函数中，我们需要完成初始化并启动各个模块，然后进入主循环。

int main(void) { HAL_Init(); // 初始化HAL库 SystemClock_Config(); // 配置系统时钟（由CubeMX生成） MX_GPIO_Init(); // 初始化GPIO MX_TIM2_Init(); // 初始化用于键盘扫描的定时器 MX_USB_DEVICE_Init(); // 初始化USB设备 // 初始化自定义的键盘状态变量、映射表等 keyboard_init(); HAL_TIM_Base_Start_IT(&htim2); // 启动定时器中断 while (1) { // 主循环处理非实时性任务 // 例如：检查是否有报告需要发送，处理LED指示等 keyboard_task(); // 键盘主任务函数 } }

在keyboard_task()函数里，我们可以实现前面提到的“检查报告变化并发送”的逻辑。

6.2 调试方法与问题排查

自制USB设备，调试是重中之重。以下是一些实用的调试技巧：

1. 硬件连接检查：

供电：用万用表测量STM32的VDD引脚是否为稳定的3.3V。USB口供电不稳可能导致枚举失败。
数据线：确认D+和D-线没有接反、短路或虚焊。可以用万用表通断档检查。
上拉电阻：USB全速设备要求在D+线上有一个1.5kΩ的上拉电阻接到3.3V，这个电阻通常集成在STM32的USB模块内部，并通过软件控制连接。在CubeMX的USB配置中，确保VBUS sensing和Soft disconnect等选项配置正确。对于F103，通常不需要外部上拉。

2. 软件调试手段：

串口打印：这是最直接的调试方式。在代码关键位置（如USB初始化成功、收到设置请求、发送报告等）通过串口打印信息。你需要先初始化一个USART，并重写printf函数到串口。
LED指示：用板载LED或自己接一个LED，用不同的闪烁模式来表示程序运行到了哪个阶段（如初始化完成、USB已连接、正在发送数据等）。
ST-LINK调试器：使用Keil的在线调试功能，可以设置断点、单步执行、查看变量值，是查找逻辑错误的最强武器。

3. 系统级工具验证：

设备管理器：插入你的键盘后，打开Windows设备管理器，查看“人体学输入设备”或“键盘”类别下，是否出现了一个新的HID键盘设备，并且没有黄色的感叹号。如果有感叹号，说明驱动或枚举过程有问题。
USBlyzer / Bus Hound：这些是专业的USB协议分析软件（Bus Hound在个人使用上有限制）。它们可以捕获USB总线上的所有数据包，让你清晰地看到主机发送了哪些请求（如获取描述符），你的设备回复了什么。这对于排查枚举失败、描述符错误等问题是终极工具。通过对比捕获的数据和USB规范，你能精准定位问题所在。

6.3 常见问题与解决方案实录

问题1：电脑完全没反应，设备管理器里看不到新设备。

排查：首先检查硬件连接，特别是USB的VBUS、GND、D+、D-四根线。然后检查程序是否正常运行（通过LED或串口）。最可能的原因是USB枚举失败。
解决：确保时钟配置正确，USB时钟必须是48MHz。检查usbd_conf.c中的USBD_LL_Init函数是否被正确调用。使用USB分析工具查看主机是否发出了Get_Descriptor请求，以及你的设备是否回复。

问题2：电脑识别到了设备，但显示“未知设备”或驱动错误。

排查：描述符可能有问题。特别是报告描述符的长度或内容不符合规范。
解决：仔细核对usbd_hid.c中的报告描述符数组。可以找一个已知能工作的描述符（比如STM32 Cube库自带的HID键盘例程里的描述符）直接替换试试。确保USBD_HID_Setup函数中对描述符请求的回复是正确的。

问题3：按键按下后，电脑上字符乱跳，或者一个键触发多个字符。

排查：键值映射错误，或者矩阵扫描算法有bug，产生了“鬼键”。
解决：首先简化测试，只接一个按键，看是否正常。如果正常，再接两个不在同一行同一列的按键，看是否正常。如果同时按下两个特定键时出现第三个键，就是“鬼键”现象，必须给每个按键加装隔离二极管。另外，检查keymap表，确保每个位置映射的键值是正确的HID Usage ID。

问题4：按键反应迟钝，或者偶尔失灵。

排查：消抖时间设置过长，或者扫描周期太慢。
解决：调整定时器中断周期和消抖计数器的阈值。通常扫描周期1-5ms，消抖时间10-20ms是比较合适的。也可以尝试优化扫描代码，减少中断服务函数中的耗时操作。

问题5：如何实现组合键（如Ctrl+C）？

实现：组合键的本质是同时报告多个键。当Ctrl按下时，你将keyboard_report[0]的对应位置1。当C键按下时，你将C的键值（HID_KEY_C）填入keyboard_report[2]到[7]的一个空闲位置。主机同时收到修饰键位图和普通键值，就会将其解释为Ctrl+C。你不需要在设备端做任何特殊处理，只需如实报告所有被按下的键的状态即可。

从一块闲置的STM32核心板，到最终成为一个被电脑识别的USB键盘，这个过程就像在解一道综合性的工程谜题。你需要串联起硬件电路、时钟配置、协议栈、驱动逻辑等多个环节。当第一次在记事本里敲出自己设计的键盘打出的字符时，那种成就感是购买成品无法比拟的。这个项目最大的价值不在于做出了一个多好用的键盘，而在于你亲手打通了从物理按键到系统交互的完整链路，理解了数据是如何一层层封装、传输并被解析的。这份理解，会让你在后续面对更复杂的嵌入式系统或USB设备开发时，心里更有底气。