大家好，我是MCU起航。

最近在玩STM32CUBE的USB功能，用起來還是挺方便的。只要配置一下，設備描述符、配置描述符、接口描述符什么的，都能給你自動生成，其中還包括比較復雜的報告描述符。

這次給大家演示一下如何用STM32CUBE的配置，自動生成一個USB鼠標的過程。這里多說一句，USB是一套比較復雜的協議，單靠一兩個例程是不可能完全理解的。至少要找本書，再配著USB官網的各種協議啃幾天，才算入門。

所以這個例子起到的是一個拋磚引玉的過程，如果你真的感興趣，就去找相關資料學習。STM32CubeMX的便利，在很多方面都給了我們很大的幫助！當然，如果有感興趣的想繼續學的，可以留言，我會試著寫一些這方面的文章。

首先，軟件版本我用的是STM32CubeMX的5.3.0，并不是最新版。為什么沒用最新的？最新版有個很惡心的bug，好像是打不開工程，記不清了。

打開STM32CUBE，選擇一個芯片。這里我選的是STM32F103C8T6。

其次，RCC這里外部高速時鐘，外部默認都接8MHZ。

第三，SYS這里，調試接口選擇Serial Wire。我個人習慣用SW接口，你們隨意。

第四，GPIO這里，我把PA15設置為推挽輸出，默認高電平。這是和我的硬件電路相關的。首先要明確的一點是，STM32F103C8的這個片子，只支持USB的FS模式，也就是全速（FULL SPEED）模式。

USB主機（也就是電腦）如何知道USB設備支持全速模式？只要在USB設備的D+數據線上接一個1.5K的上拉電阻即可。而我這里這個上拉電阻的電源端是接到了STM32的PA15上面。如圖：

所以，如果你的板子上，上拉電阻默認接到VCC，這一步就不用管了。沒有的話，自己想辦法~~~

第五，Connectivity選項里，選擇USB，然后右側Device(FS)前面打勾，下面不用管。

第六，中間件（Middleware）這里，選擇USB。右側上面選擇Human Interface Device Class，也就是俗稱的HID。

下面要注意幾個地方！

VID和PID分別代表廠商（Vender）編號和產品（PID）編號，VID不能隨便用，要花錢向USB協會申請，所以這里僅供學習使用。PID還好，由廠商自己定義。

manufacturer_string是廠商字符串，product_string是產品字符串，configuration_string是配置字符串，interface_string是接口字符串，這四個是可以手動修改的。放心改，不要錢。我隨便改了兩個。

還有一個LANGID_STRING，它表示USB設備支持什么語言。我這里沒有動，默認選擇英語。

7、修改時鐘。USB那里需要48M的時鐘，別的無所謂。照著改吧！

8、生成工程。工程名稱和路徑，不用說了，那個是基本的。主要是框住的這兩個位置，根據你的代碼習慣和編譯器（KEIL還是IAR）來進行選擇。

9、修改代碼。打開工程，找到main.c，添加一些代碼。

/* Private includes ----------------------------------------------------------*/

/* USER CODE BEGIN Includes */

#include "usbd_hid.h"

/* USER CODE END Includes */

/* Private typedef -----------------------------------------------------------*/

/* USER CODE BEGIN PTD */

uint8_t MouseData01[4] = {0,0,0,0};

extern USBD_HandleTypeDef hUsbDeviceFS;

/* USER CODE END PTD */

主函數里：

while (1)

{

/* USER CODE END WHILE */

/* USER CODE BEGIN 3 */

MouseData01[0] = 0x01;

USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&MouseData01,sizeof(MouseData01));

HAL_Delay(1000);

MouseData01[0] = 0x00;

USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&MouseData01,sizeof(MouseData01));

HAL_Delay(1000);

}

好了，保存、編譯、下載、上電。你會發現，板子上電的時候電腦右下角彈出一個“發現新設備”的提示框。

然后你的屏幕上的光標位置，每隔1秒，自動點一下鼠標左鍵。

很多人到這里，其實是蒙的！！！

為什么？

自始至終，STM32CubeMX里，和主函數里沒出現鼠標相關的函數（除了我們自定義的一個帶鼠標字符的數組），怎么就出來一個鼠標？

為什么不是鍵盤？

為什么不是優盤？ 這個我可以回答，因為你選的是HID，而不是存儲類設備。

為什么不是游戲手柄？

其實，你可以理解為，這是官方提供給我們的一個鼠標例程。這里簡單說下USB設備上電的過程：

1、設備插入后，USB主機自動對設備進行復位，使設備地址為零。

2、USB主機對地址為零的設備提問：你是個什么東西？

3、USB設備說：我的PID是XX，VID是XX，USB協議是2.0等等。

4、USB主機再次對設備進行復位，然后給復位后的設備分配一個地址。

5、USB主機向新地址提問：你是個什么東西？ USB設備回答：…

6、兩次回答一樣，說明USB設備的地址分配成功。USB主機繼續提問，獲取其它描述符。

7、USB設備，在向主機回復配置集合的時候，表明自己的身份：你好，我是個鼠標！

也就是說，在配置集合中，有信息說明這個設備是鼠標，我們看下。在usb_hid.c文件中，有一個數組：USBD_HID_CfgFSDesc，其中一行：

單是這個還不夠，還要結合報告描述符。也在這個文件內，名字是HID_MOUSE_ReportDesc。內容如下：

__ALIGN_BEGINstaticuint8_tHID_MOUSE_ReportDesc[HID_MOUSE_REPORT_DESC_SIZE]__ALIGN_END=

{

0x05,0x01,

0x09,0x02,

0xA1,0x01,

0x09,0x01,

0xA1,0x00,

0x05,0x09,

0x19,0x01,

0x29,0x03,

0x15,0x00,

0x25,0x01,

0x95,0x03,

0x75,0x01,

0x81,0x02,

0x95,0x01,

0x75,0x05,

0x81,0x01,

0x05,0x01,

0x09,0x30,

0x09,0x31,

0x09,0x38,

0x15,0x81,

0x25,0x7F,

0x75,0x08,

0x95,0x03,

0x81,0x06,

0xC0,0x09,

0x3c,0x05,

0xff,0x09,

0x01,0x15,

0x00,0x25,

0x01,0x75,

0x01,0x95,

0x02,0xb1,

0x22,0x75,

0x06,0x95,

0x01,0xb1,

0x01,0xc0

};

是不是很懵逼？這都是啥？怎么沒有注釋？

別問我，我也不知道。可能是研發人員懶，也可能是他們忘了。

無論是配置集合，還是報告描述符，這里都不做解釋，因為一兩篇文章根本說不完。這里只說一點，由于報告描述符的規定，鼠標設備向電腦發送數據的時候，一般是發送4個字節的數據。

字節1：無符號字符型，低三位分別表示鼠標的左、右、中鍵是否被按下，1按下，0抬起。

字節2：有符號字符型，表示鼠標在x方向的移動。

字節3：有符號字符型，表示鼠標在y方向的移動。

字節4：有符號字符型，表示鼠標滾輪的移動。

所以，我在上面的代碼中循環將第一個字節的值設為0和1，就能看到屏幕上的光標每隔一秒，觸發一下鼠標左鍵。

好了，不知不覺說的有點多。還好大部分都是圖片，看起來不難理解。總結起來，就是個發送數據的過程。

還是那句話，USB協議比較復雜，只靠一兩篇文章是學不會的。完整例程我放到了公眾號后臺（單片機愛好者），回復關鍵詞：USB鼠標例程，即可獲取下載鏈接。