一、系统概述与核心功能1. 系统定位基于STM32的触控USB鼠标以“触摸输入采集-坐标转换-USB HID协议封装-即插即用”为核心将触摸传感器电容/电阻式的触摸位置、手势动作转换为标准USB鼠标事件移动、点击、滚动实现无需驱动的即插即用触控输入设备适用于触摸板替代、嵌入式人机交互、创意控制器等场景。2. 核心功能模块模块功能描述触摸传感电容触摸板I2C接口或电阻触摸屏ADC接口检测单点/多点触摸坐标X,Y及触摸状态按下/释放坐标处理原始坐标滤波滑动平均/卡尔曼滤波、坐标映射将触摸区域映射到屏幕分辨率、手势识别单击、双击、拖拽、双指滚动USB HIDSTM32内置USB FS全速外设配置为HID鼠标设备定义报告描述符标准鼠标X/Y相对移动、左/中/右键、滚轮事件转换触摸坐标→鼠标移动相对位移、触摸按下→鼠标点击、双指滑动→滚轮滚动低功耗设计无触摸时进入STOP模式触摸传感器中断唤醒USB挂起时进入SUSPEND模式待机电流1mA二、硬件设计方案1. 核心硬件选型模块型号关键参数接口方式主控MCUSTM32F103C8T672MHz Cortex-M364KB Flash20KB RAM全速USB 2.0PA11/PA1212位ADC2个I2C核心控制器USB HID设备电容触摸板GT911/FT6236I2C接口支持最多5点触摸分辨率320×240中断输出INTI2C1PB6SCLPB7SDA INTPA0电阻触摸屏4线电阻屏XPT2046SPI接口12位ADC压力检测需校准4点校准法SPI1PA5SCKPA6MISOPA7MOSIPA4CS IRQPA1USB接口Micro-USB插座USB 2.0全速DPA12、D-PA11内置1.5kΩ上拉电阻通过软件控制USB DP/DM直接连接MCU电源管理AMS1117-3.3V5V USB供电→3.3V给MCU/触摸传感器最大电流500mA供电一体化带ESD保护状态指示WS2812 RGB LED单线控制显示触摸状态红触摸中绿USB已连接蓝手势识别GPIOPB0单线时序2. 硬件电路设计要点2.1 核心电路连接以电容触摸板GT911为例STM32最小系统8MHz外部晶振32.768kHz RTC晶振可选SWD调试接口PA13/PA14复位电路10kΩ上拉0.1μF电容。USB接口DPA12、D-PA11直接连接MCUD通过1.5kΩ电阻上拉至3.3VSTM32内部软控制VBUS5V接AMS1117输入。电容触摸板GT911SCLPB6SDAPB7I2C14.7kΩ上拉电阻至3.3VINTPA0中断输出下降沿触发RSTPA1复位引脚上电时低电平复位VCC3.3VGND共地。抗干扰设计USB D/D-走线等长且包地触摸板I2C线加10pF电容滤波电源入口加TVS管ESD保护。2.2 备选方案电阻触摸屏XPT2046电阻屏4线X、X-、Y、Y-接XPT2046对应引脚XPT2046SPI接口SCKPA5MISOPA6MOSIPA7CSPA4IRQPA1触摸中断校准需存储4点校准参数ax,bx,cx,ay,by,cy至Flash开机时加载。三、软件设计与核心代码1. 系统架构FreeRTOS多任务采用FreeRTOS实时操作系统划分3个核心任务优先级从高到低触摸采集任务优先级3周期性读取触摸坐标I2C/SPI滤波后发送至消息队列。手势识别任务优先级2解析触摸序列单击、双击、拖拽、双指滑动生成鼠标事件移动、点击、滚动。USB HID任务优先级1将鼠标事件封装为HID报告通过USB发送给主机。2. STM32CubeMX配置关键步骤时钟配置HSE8MHzPLL输出72MHzUSB时钟需为48MHzPLL输出72MHz后经1.5分频。USB配置模式Device OnlyClassHuman Interface Device ClassHIDHID参数Vendor ID0x0483STProduct ID0x5750Polling Interval10ms。I2C/SPI配置根据触摸传感器选择I2C1400kHz或SPI18MHz。GPIO配置触摸中断引脚PA0设为外部中断下降沿触发USB DPPA12上拉通过软件控制。3. 核心代码实现基于HAL库电容触摸板GT9113.1 USB HID报告描述符usbd_hid.c中修改// 标准鼠标报告描述符8字节__ALIGN_BEGINstaticuint8_tHID_MOUSE_ReportDesc[]__ALIGN_END{0x05,0x01,// USAGE_PAGE (Generic Desktop)0x09,0x02,// USAGE (Mouse)0xA1,0x01,// COLLECTION (Application)0x09,0x01,// USAGE (Pointer)0xA1,0x00,// COLLECTION (Physical)// 按钮1字节8个按钮位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)// X/Y相对移动2字节-127~1270x05,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)// 滚轮1字节-127~1270x09,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_COLLECTION0xC0// END_COLLECTION};3.2 触摸采集任务GT911驱动#includegt911.h#includeFreeRTOS.h#includetask.h#includequeue.hQueueHandle_t touch_queue;// 触摸数据队列// 触摸数据结构体typedefstruct{uint16_tx;// X坐标0~320uint16_ty;// Y坐标0~240uint8_ttouch_num;// 触摸点数0~5uint8_tevent;// 事件0释放1按下2移动}TouchPoint_t;voidGT911_Task(void*pvParameters){TouchPoint_t tp;TickType_t xLastWakeTimexTaskGetTickCount();constTickType_t xFrequencypdMS_TO_TICKS(10);// 10ms采集一次100HzGT911_Init();// 初始化GT911I2C地址0x14/0x5Dwhile(1){// 读取触摸状态通过I2C读取GT911寄存器uint8_tstatusGT911_ReadReg(GT911_STATUS_REG);if(status0x80){// 有新数据tp.touch_numstatus0x0F;// 触摸点数if(tp.touch_num0){// 读取第一个触摸点坐标支持多点此处简化取第一个GT911_ReadTouchPoint(tp.x,tp.y,0);tp.event(tp.touch_num0)?1:0;// 按下/移动xQueueSend(touch_queue,tp,0);// 发送至队列}GT911_WriteReg(GT911_STATUS_REG,0x00);// 清除状态}vTaskDelayUntil(xLastWakeTime,xFrequency);}}3.3 手势识别与鼠标事件转换// 鼠标事件结构体对应HID报告typedefstruct{int8_tx_rel;// X相对移动-127~127int8_ty_rel;// Y相对移动-127~127uint8_tbuttons;// 按钮状态bit0左键bit1右键bit2中键int8_twheel;// 滚轮-127~127}MouseReport_t;voidGesture_Task(void*pvParameters){TouchPoint_t tp;MouseReport_t mouse{0};uint16_tlast_x0,last_y0;uint32_tlast_touch_time0;uint8_tclick_count0;while(1){if(xQueueReceive(touch_queue,tp,portMAX_DELAY)pdPASS){// 1. 坐标映射触摸区域320×240 → 屏幕分辨率int16_tdx0,dy0;if(tp.event1){// 按下/移动if(last_x!0||last_y!0){dx(tp.x-last_x)*127/320;// 缩放为相对移动-127~127dy(tp.y-last_y)*127/240;// 限制范围dx(dx-127)?-127:(dx127)?127:dx;dy(dy-127)?-127:(dy127)?127:dy;}last_xtp.x;last_ytp.y;mouse.buttons0x01;// 左键按下}else{// 释放last_xlast_y0;mouse.buttons0x00;// 所有按钮释放// 单击/双击判断时间阈值300msif(HAL_GetTick()-last_touch_time300)click_count;elseclick_count1;last_touch_timeHAL_GetTick();if(click_count2){// 双击mouse.buttons0x01;// 模拟左键双击快速按下释放两次click_count0;}}// 2. 双指手势判断滚动if(tp.touch_num2){// 读取第二个触摸点坐标简化假设垂直滑动为滚轮uint16_tx2,y2;GT911_ReadTouchPoint(x2,y2,1);int16_tdy2y2-tp.y;mouse.wheel(dy210)?-10:(dy2-10)?10:0;// 滚动步长}else{mouse.wheel0;}// 3. 更新鼠标报告mouse.x_reldx;mouse.y_reldy;// 4. 发送至USB HID任务xQueueSend(mouse_queue,mouse,0);}}}3.4 USB HID发送任务#includeusbd_hid.hexternUSBD_HandleTypeDef hUsbDeviceFS;voidUSB_HID_Task(void*pvParameters){MouseReport_t mouse;uint8_thid_report[4]{0};// 标准鼠标报告buttons, x, y, wheelwhile(1){if(xQueueReceive(mouse_queue,mouse,portMAX_DELAY)pdPASS){// 封装HID报告标准鼠标报告格式hid_report[0]mouse.buttons;// 按钮状态hid_report[1]mouse.x_rel;// X相对移动hid_report[2]mouse.y_rel;// Y相对移动hid_report[3]mouse.wheel;// 滚轮// 发送USB HID报告阻塞式超时10msUSBD_HID_SendReport(hUsbDeviceFS,hid_report,4);}vTaskDelay(pdMS_TO_TICKS(10));// 10ms发送间隔与HID描述符一致}}四、关键技术与优化1. 触摸坐标处理滤波算法对原始坐标进行5点滑动平均滤波消除抖动。坐标映射将触摸板物理坐标如320×240线性映射到屏幕分辨率如1920×1080公式xscreenxtouch×ScreenWidthTouchWidthx_{\text{screen}} \frac{x_{\text{touch}} \times \text{ScreenWidth}}{\text{TouchWidth}}xscreen​TouchWidthxtouch​×ScreenWidth​加速度曲线根据移动速度动态调整映射比例慢速时精细控制快速时快速移动提升操作手感。2. USB HID优化报告速率设置Polling Interval10ms100Hz平衡响应速度与USB带宽。复合设备可扩展为鼠标键盘复合设备通过修改报告描述符支持快捷键操作。即插即用Windows/Linux/macOS无需额外驱动系统自动识别为HID鼠标。3. 低功耗设计触摸中断唤醒配置GT911的INT引脚为下降沿触发无触摸时STM32进入STOP模式功耗10μA。USB挂起检测到USB总线挂起时关闭USB时钟进入SUSPEND模式。参考代码 STM32 触控USB鼠标www.youwenfan.com/contentcst/133749.html五、系统调试与扩展1. 调试步骤阶段操作工具USB枚举测试连接电脑查看设备管理器是否识别为“HID-compliant mouse”USBlyzer抓包工具、设备管理器触摸采集测试打印触摸原始坐标串口调试验证坐标范围与响应速度串口助手、逻辑分析仪I2C波形手势识别测试模拟单击、拖拽、双指滑动观察鼠标光标动作屏幕录像、鼠标光标跟踪软件性能测试测量触摸到光标移动的延迟目标20ms高速摄像机、延时测试工具2. 扩展功能多点触控利用GT911的5点触摸实现双指缩放、旋转等高级手势。自定义按键增加物理按键如左/右键、DPI切换通过USB HID报告扩展按钮数量。无线化替换USB为蓝牙模块如HC-05实现无线触控鼠标需修改为蓝牙HID协议。触摸屏模式修改HID描述符为“Touch Screen”类支持绝对坐标上报需Windows 10支持。六、总结基于STM32的触控USB鼠标通过电容/电阻触摸传感器采集坐标经手势识别算法转换为鼠标事件再通过USB HID协议上报主机实现低成本、高定制化的触控输入方案。