STM32CUBEMX配置实现STM32 USB鼠标功能

提示：某项目需要用到可编程的USB鼠标，索性通过STM32结合STM32CUBEMX软件实现。

文章目录

STM32CUBEMX配置实现STM32 USB鼠标功能
前言
一、下载安装
- 1.下载
- 2.安装
二、配置步骤
- 1.创建项目
- 2.引脚配置
- 3.时钟配置
- 4.生成代码
三、修改代码
- 1.向usb_device.c文件添加用户函数
- 2.在usb_device.h文件声明用户函数
- 3.向main.c文件添加测试程序
四、内容拓展
- 1.USB鼠标数据格式
- 2.USB接口硬件电路

前言

周所周知，嵌入式设备程序开发最为繁琐的工作莫过于各种库的编写和初始化函数的编写。STM32CubeMX（STM32 configuration and initialization C code generation）是一个图形化的工具，通过直观的可视化配置STM32初始化各项参数和功能，并且能够自动生成对应的C代码，大大提高开发效率。

对于制作一个可编程的USB鼠标，需要读懂几百页的USB协议文档才算入门，用兴趣可以通过此链接查看https://usb.org/ 。但站在巨人的肩膀上能看得更远，STM32CUBEMX软件能够帮我们把USB协议的各自库函数编写好，即使不懂USB协议也能流畅使用USB功能。

一、下载安装

1.下载

下载安装最新版本STM32CubeMX，本文使用的版本为V6.4.0，其他版本区别不大，下载链接：
https://download.csdn.net/download/XHL9434826546/75058920
（对于官网下载困难的用户可以下载，截止2022年1月发布的最新版本V6.4.0，适用于Windows平台，也可以访问官网进行下载：https://www.st.com/en/development-tools/stm32cubemx.html）

2.安装

全英文版，安装路径最后不要有任何中文，根据提示一路下一步，成功安装主界面如下：
在这里插入图片描述

二、配置步骤

1.创建项目

选择第一个，进入MCU选择器。
在这里插入图片描述
输入STM32F103C8筛选出对应的型号，点击开始项目按钮。

2.引脚配置

配置高速时钟源引脚与为外部晶振(默认8M)连接，
在这里插入图片描述
打开USB功能，

配置USB设备，设备名称和产品名称可以随意修改，这里默认保存不变

3.时钟配置

直接输入HCLK时钟为72，USB时钟为48，软件会自动匹配其他各个分频因子。
在这里插入图片描述

4.生成代码

输入项目名称，生成项目的路径(路径不能有任何中文，否则会报错)，编译器类型以及最低版本
在这里插入图片描述
本文使用的IDE为Keil uVision V5.25.2.0

生成后直接点击打开项目

点击编译，0错误，0警告，表示生成成功。

三、修改代码

1.向usb_device.c文件添加用户函数

插入用户自定义函数，这里写了5个常用函数，分别是鼠标单击左/右/中键、鼠标滚动和鼠标移动，可根据需要添加更多函数。

/** -- Insert your external function declaration here --*/
/* USER CODE BEGIN 1 */
void Click_L()
{uint8_t buf0[4] = {1,0,0,0};uint8_t buf1[4] = {0,0,0,0};USBD_HID_SendReport(&hUsbDeviceFS,buf0,4);//按下鼠标左键HAL_Delay(10);USBD_HID_SendReport(&hUsbDeviceFS,buf1,4);//松开鼠标按键HAL_Delay(10);
}
void Click_R()
{uint8_t buf0[4] = {2,0,0,0};uint8_t buf1[4] = {0,0,0,0};USBD_HID_SendReport(&hUsbDeviceFS,buf0,4);//按下鼠标右键HAL_Delay(10);USBD_HID_SendReport(&hUsbDeviceFS,buf1,4);//松开鼠标按键HAL_Delay(10);
}
void Click_M()
{uint8_t buf0[4] = {4,0,0,0};uint8_t buf1[4] = {0,0,0,0};USBD_HID_SendReport(&hUsbDeviceFS,buf0,4);//按下鼠标右键HAL_Delay(10);USBD_HID_SendReport(&hUsbDeviceFS,buf1,4);//松开鼠标按键HAL_Delay(10);
}
void Scroll(int8_t x)
{uint8_t buf[4] = {0,0,0,0};buf[3]=x;USBD_HID_SendReport(&hUsbDeviceFS,buf,4);//鼠标滚动HAL_Delay(10);
}
void Move(int8_t x,int8_t y)
{uint8_t buf[4] = {0,0,0,0};buf[1]=x;buf[2]=y;USBD_HID_SendReport(&hUsbDeviceFS,buf,4);//鼠标移动HAL_Delay(10);
}
/* USER CODE END 1 */

2.在usb_device.h文件声明用户函数

/** -- Insert functions declaration here --*/
/* USER CODE BEGIN FD */
void Click_L();
void Click_R();
void Click_M();
void Scroll(int8_t x);
void Move(int8_t x,int8_t y);
/* USER CODE END FD */

3.向main.c文件添加测试程序

	/* Infinite loop *//* USER CODE BEGIN WHILE */while (1){/* USER CODE END WHILE *//* USER CODE BEGIN 3 */Move(100,0);//向右移动100个像素Click_R();//单击右键HAL_Delay(1000);//延时1秒Move(0,100);//向下移动100个像素Click_R();//单击右键HAL_Delay(1000);//延时1秒Move(-100,0);//向左移动100个像素Click_R();//单击右键HAL_Delay(1000);//延时1秒Move(0,-100);//向上移动100个像素Click_R();//单击右键HAL_Delay(1000);//延时1秒}/* USER CODE END 3 */