1. 项目背景与硬件选型
最近我在做一个基于GD32F350的数字键盘项目,目标是实现一个完全模拟电脑数字键盘功能的USB-HID设备。这个项目特别适合想要学习嵌入式开发和USB协议的小伙伴,尤其是那些对硬件设计和固件优化感兴趣的开发者。GD32F350作为一款国产32位微控制器,性价比很高,完全能够满足矩阵键盘和USB-HID的开发需求。
选择GD32F350的原因很简单:它价格亲民,性能足够,而且生态完善。芯片内置了USB FS(全速)控制器,支持12Mbps的传输速率,完全符合USB-HID设备的要求。同时,GD32的开发工具链和STM32非常相似,之前用过STM32的朋友可以无缝切换,学习成本几乎为零。
硬件方面,我设计了一个4×5的矩阵键盘,总共20个按键。这种设计最大的好处是节省IO口——20个按键只需要9个GPIO(4列+5行)就能搞定。如果每个按键单独占用一个IO口,那就需要20个,显然矩阵方案更划算。实际项目中,这种设计在键盘、遥控器、工控设备中非常常见。
2. 电路设计详解
矩阵键盘的电路设计其实很简单,但有几个细节需要特别注意。我的设计用了4个列引脚和5个行引脚,具体分配如下:
- 列引脚:PA15、PB8、PB9、PC13
- 行引脚:PB10、PB11、PB12、PB13、PB14
在PCB布局时,行线和列线最好平行走线,减少交叉,这样可以降低干扰。每个按键两端我都加了0.1μF的电容到地,用来滤波防抖动。虽然软件消抖也能做,但硬件上加个小电容效果更稳。
电源部分,GD32F350需要3.3V供电。如果是从USB取电,记得加个LDO(比如AMS1117-3.3)把5V转成3.3V。USB的D+和D-线上最好串个22Ω的电阻,匹配阻抗,减少信号反射。这些细节虽然小,但对稳定性影响很大。
// 引脚定义
typedef struct {
uint32_t GPIO_Group;
uint32_t GPIO_Pin;
} GPIO_Pin_t;
// 列引脚配置
GPIO_Pin_t lie_pins[] = {
{GPIOA, GPIO_PIN_15},
{GPIOB, GPIO_PIN_8},
{GPIOB, GPIO_PIN_9},
{GPIOC, GPIO_PIN_13}
};
// 行引脚配置
GPIO_Pin_t hang_pins[] = {
{GPIOB, GPIO_PIN_10},
{GPIOB, GPIO_PIN_11},
{GPIOB, GPIO_PIN_12},
{GPIOB, GPIO_PIN_13},
{GPIOB, GPIO_PIN_14}
};
实际焊接时,建议用贴片元件,减少空间占用。如果做成品,可以考虑用柔性PCB,更适合键盘这种需要弯曲的场景。测试点记得留出来,方便后期调试。我就吃过亏,第一版没留测试点,出了问题只能飞线,特别麻烦。
3. 按键扫描算法优化
按键扫描是矩阵键盘的核心,也是最容易出问题的地方。我最开始用的是传统的行列扫描法:列设为输出,行设为输入,逐列输出高电平,检测哪一行变高来判断按键。但很快发现一个问题——当同一行的两个按键同时按下时,系统会误判为所有按键都松开。
这个问题折腾了我好久。后来发现是电平冲突导致的:当多列同时输出高电平时,如果同一行有两个按键按下,电流会从高电平列流向低电平列,造成干扰。解决办法其实很简单——在扫描某一列时,把其他三列设为输入模式,而不是输出低电平。这样就能彻底隔离电平干扰。
void lieshuru(int i) {
for(int a=0; a<4; ++a) {
if(a == i) continue;
gpio_mode_set(lie_pins[a].GPIO_Group, GPIO_MODE_INPUT,
GPIO_PUPD_PULLDOWN, lie_pins[a].GPIO_Pin);
}
}
void lieshuchu(int i) {
for(int a=0; a<4; ++a) {
if(a == i) continue;
gpio_mode_set(lie_pins[a].GPIO_Group, GPIO_MODE_OUTPUT,
GPIO_PUPD_PULLUP, lie_pins[a].GPIO_Pin);
gpio_output_options_set(lie_pins[a].GPIO_Group,
GPIO_OTYPE_PP, GPIO_OSPEED_10MHZ,
lie_pins[a].GPIO_Pin);
gpio_bit_reset(lie_pins[a].GPIO_Group, lie_pins[a].GPIO_Pin);
}
}
消抖处理也很重要。我采用两次检测法:第一次检测到按键后延时10ms,再次检测确认。这样能有效防止机械抖动带来的误触发。实际测试中,10ms的延时对于大多数按键都足够,如果遇到特别抖的按键,可以增加到20ms。
另一个优化点是按键处理逻辑。我设计了一个状态机来处理多键同时按下的情况:只返回最新按下的键值,只有当最新按键松开后才返回0。这样符合标准键盘的行为模式。测试时可以用记事本试试,同时按多个数字键,看看是不是最后一个按下的字符会被重复输入。
4. USB-HID协议实现
USB-HID协议是这项目的重点,也是难点。好在GD32提供了完整的USB库,大大降低了开发难度。首先要去兆易创新官网下载GD32F3x0的固件库,里面有个hid_keyboard例程,我们就基于这个来修改。
第一步是配置系统时钟。USB模块需要48MHz的时钟,GD32F350可以通过PLL从IRC8M倍频得到。我实测96MHz和72MHz都能正常工作,但推荐用96MHz,性能更充裕。
// 在system_gd32f3x0.c中修改系统时钟
#define __SYSTEM_CLOCK_96M_PLL_IRC8M_DIV2
第二步是修改中断处理函数。官方例程里的EXTI0_1_IRQHandler和USBFS_WKUP_IRQHandler函数中有个resume_mcu_clk()调用,这个会导致设备枚举卡住,需要屏蔽掉。这个问题我排查了好久,最后在论坛里找到答案。
HID报告描述符是关键配置,它告诉电脑我们是个键盘设备。标准键盘需要定义8字节的输入报告和输出报告。输入报告的第一个字节是修饰键(如Ctrl、Alt),第二个字节保留,后面6字节是普通按键值。
uint8_t pcnum[21] = {
0x53U, 0x53U, 0x54U, 0x55U, 0x56U, 0x5FU, 0x60U, 0x61U, 0x57U, 0x5CU,
0x5DU, 0x5EU, 0x57U, 0x59U, 0x5AU, 0x5BU, 0x58U, 0x62U, 0x62U, 0x63U, 0x00U
};
这个数组定义了键值映射,把我们的扫描码转换成HID用法码。比如0x53对应NumLock,0x54对应/键等。如果需要自定义按键功能,修改这个数组就行了。
5. 长按与短按功能实现
长按和短按是键盘的常用功能,比如短按输入数字,长按触发特殊功能。我的实现方法是用一个计数器来计时:当按键按下时计数器递增,根据计数值判断是短按还是长按。
短按设为计数器在2-25之间(约20-250ms),长按设为大于25(约250ms)。这个阈值可以根据实际需求调整,比如游戏键盘可能需要更快的响应,就把短按时间设短些。
uint8_t key_proc(void) {
static int timecount = 0;
static int num = 0;
static int last_num = 0;
num = key_sacn();
if(num == 0) {
timecount = 0;
} else {
if(last_num != num && last_num != 0) {
fop_handler.hid_itf_data_process(&hid_keyboard, num);
timecount = 15;
}
timecount++;
if(timecount == 2) {
fop_handler.hid_itf_data_process(&hid_keyboard, num);
}
if(timecount >= 25) {
fop_handler.hid_itf_data_process(&hid_keyboard, num);
}
}
last_num = num;
return 0;
}
实际测试中发现,长按时会连续发送键值,这符合键盘的自动重复功能。但如果想要长按触发特殊功能(比如切换模式),就需要在长按检测到后重置状态,防止重复触发。
还有一个细节是按键释放处理:只有当所有按键都松开时,才把输出键值清零。这样能确保多键操作时不会误判。你可以用记事本测试,同时按多个键然后逐个松开,看看显示效果对不对。
6. 固件调试与优化
调试USB设备最麻烦的是枚举过程。如果电脑识别不到设备,首先检查硬件连接,特别是USB的D+和D-线有没有接反。然后用逻辑分析仪抓USB数据,看看枚举阶段有没有错误。
GD32有个很好的调试功能——USB打印调试信息。可以在usbd_conf.c中开启调试输出,通过串口查看USB状态。我经常用这个功能排查枚举问题,比如描述符是否正确、端点配置是否匹配。
电源管理也需要优化。USB设备通常要求低功耗,特别是在待机状态下。GD32F350支持多种低功耗模式,在USB挂起时可以进入睡眠模式,有按键按下时再唤醒。这样能大大降低功耗,适合电池供电的场景。
// 进入低功耗模式
void enter_sleep_mode(void) {
pmu_to_sleepmode(WFI_CMD);
}
// USB唤醒中断配置
void usb_wakeup_config(void) {
usbd_intr_disable(&hid_keyboard);
nvic_irq_disable(USBFS_IRQn);
pmu_to_sleepmode(WFI_CMD);
nvic_irq_enable(USBFS_IRQn, 0, 0);
usbd_intr_enable(&hid_keyboard);
}
固件大小优化也很重要。GD32F350的Flash只有64KB,要精打细算。编译时选择-Os优化等级,去掉不用的库函数。比如printf这种很占空间的函数,可以用简单的串口发送代替。
7. 常见问题与解决方案
开发过程中遇到最多的问题是USB枚举失败。现象就是电脑识别不到设备,或者识别成未知设备。这时候首先检查48MHz时钟是否准确,可以用示波器测量PA8脚的输出。误差最好控制在0.5%以内,否则USB通信可能不稳定。
另一个常见问题是按键响应慢。这通常是扫描频率太低导致的。建议把键盘扫描放在定时器中断中,每1ms扫描一次。这样既能保证响应速度,又不会占用太多CPU资源。
静电防护也很重要。键盘是经常接触的设备,容易带静电。我在USB口和按键矩阵上都加了ESD二极管,防止静电损坏芯片。实际测试中,接触放电8kV都能正常工作。
如果遇到某些电脑识别不了,可能是USB描述符的问题。不同操作系统对HID描述符的解析有细微差别。建议用USBlyzer这类工具抓包分析,对比标准键盘的描述符,找出差异点。
最后推荐几个调试工具:
- USBlyzer:Windows下的USB协议分析器
- Bushound:USB数据抓包工具
- GD32 MCU ISP:GD32的烧录工具
- 逻辑分析仪:抓时序波形,分析扫描过程
这些工具在我开发过程中帮了大忙,特别是USBlyzer,能清晰看到USB枚举过程和HID报告内容。
1073



被折叠的 条评论
为什么被折叠?



