利用STM32CubeMX來生成USB_HID_Mouse工程

本文轉載自查看原文 2017-05-11 16:17 2908 HID/ STM32/ usb/ [USB]

硬件開發板：STM32F103C8

軟件平台

好了現在開始利用STM32CubeMX來生成我們的工程

1、新建工程

選擇MCU的型號

選擇選擇時鍾

開啟usb的模塊

選擇USB的類

配置時鍾樹(主要是設置usb的48Mhz)

設置工程路徑和編譯環境

打開工程

我們現在在main.c進行修改

/* USER CODE BEGIN Includes */
#include "usbd_hid.h"
/* USER CODE END Includes */

  /* USER CODE BEGIN 1 */
  
  // HID Mouse
  struct mouseHID_t {
      uint8_t buttons;
      int8_t x;
      int8_t y;
      int8_t wheel;
  };
  struct mouseHID_t mouseHID;
  
  mouseHID.buttons = 0;
  mouseHID.x = 10;
  mouseHID.y = 0;
  mouseHID.wheel = 0;
  
  /* USER CODE END 1 */

  /* USER CODE BEGIN 3 */
  
  // Send HID report
    mouseHID.x = 10;
    USBD_HID_SendReport(&hUsbDeviceFS, (uint8_t*)&mouseHID, sizeof(struct mouseHID_t));
    HAL_Delay(1000);
  }
  /* USER CODE END 3 */

編譯下載后復位

在電腦設備管理中可以看到一個新的USB輸入設備(到這部時候可以看到我們的STM32的USB枚舉成功)

可以看到我們鼠標光標移動

如果出現

***JLink Error: Bad JTAG communication: Write to IR: Expected 0x1, got 0xF (TAP Command : 10) @ Off 0x5.

將在HAL_MspInit()代碼中 __HAL_AFIO_REMAP_SWJ_DISABLE();給注釋掉

為了回顧之前的淺析USB HID ReportDesc (HID報告描述符)

我們將對static uint8_t HID_MOUSE_ReportDesc[HID_MOUSE_REPORT_DESC_SIZE]進行分析

源碼

__ALIGN_BEGIN static uint8_t HID_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
};

View Code

注釋整理后

__ALIGN_BEGIN static uint8_t HID_MOUSE_ReportDesc[HID_MOUSE_REPORT_DESC_SIZE]  __ALIGN_END =
{
  0x05, 0x01,                    // USAGE_PAGE (Generic Desktop)
  0x09, 0x02,                    // USAGE (Mouse)
  0xa1, 0x01,                    // COLLECTION (Application)
  0x09, 0x01,                    //   USAGE (Pointer)  
  0xa1, 0x00,                    //   COLLECTION (Physical)
  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)
  0x05, 0x01,                    //     USAGE_PAGE (Generic Desktop)
  0x09, 0x30,                    //     USAGE (X)
  0x09, 0x31,                    //     USAGE (Y)
  0x09, 0x38,                    //     USAGE (Wheel)
  0x15, 0x81,                    //     LOGICAL_MINIMUM (-127)
  0x25, 0x7f,                    //     LOGICAL_MAXIMUM (127)
  0x75, 0x08,                    //     REPORT_SIZE (8)
  0x95, 0x03,                    //     REPORT_COUNT (3)  
  0x81, 0x06,                    //     INPUT (Data,Var,Rel)
  0xC0,                          //   END_COLLECTION  
  0x09, 0x3c,                    //     USAGE (Motion Wakeup)  
  0x05, 0xff,                    // USAGE_PAGE (0xff) //在HID Usage Tables 1.12中15 頁中UASE PAGES表格為Reserved
  0x09, 0x01,                    //     USAGE (SMBBatteryMode)  
  0x15, 0x00,                    //     LOGICAL_MINIMUM (0)   
  0x25, 0x01,                    //     LOGICAL_MAXIMUM (1)
  0x75, 0x01,                    //     REPORT_SIZE (1)    
  0x95, 0x02,                    //     REPORT_COUNT (2)
  0xb1, 0x22,                    //     FEATURE(Data,Var,Abs,NPrf)
  0x75, 0x06,                    //     REPORT_SIZE (6)
  0x95, 0x01,                    //     REPORT_COUNT (1)
  0xb1, 0x01,                    //     FEATURE(Cnst,Ary,Abs)
  0xc0                           // END_COLLECTION
};

現在各位同學請翻開《Universal Serial Bus Specification Revision 2.0 》<9.5 Descriptors >

我們參考Table 9-8. Standard Device Descriptor 將__ALIGN_BEGIN uint8_t USBD_FS_DeviceDesc[USB_LEN_DEV_DESC] 數據也按照這個表格填入數據

__ALIGN_BEGIN uint8_t USBD_FS_DeviceDesc[USB_LEN_DEV_DESC]的源碼如下：

/* USB Standard Device Descriptor */
__ALIGN_BEGIN uint8_t USBD_FS_DeviceDesc[USB_LEN_DEV_DESC] __ALIGN_END =
  {
    0x12,                       /*bLength */
    USB_DESC_TYPE_DEVICE,       /*bDescriptorType*/
    0x00,                       /* bcdUSB */  
    0x02,
    0x00,                       /*bDeviceClass*/
    0x00,                       /*bDeviceSubClass*/
    0x00,                       /*bDeviceProtocol*/
    USB_MAX_EP0_SIZE,          /*bMaxPacketSize*/
    LOBYTE(USBD_VID),           /*idVendor*/
    HIBYTE(USBD_VID),           /*idVendor*/
    LOBYTE(USBD_PID_FS),           /*idVendor*/
    HIBYTE(USBD_PID_FS),           /*idVendor*/
    0x00,                       /*bcdDevice rel. 2.00*/
    0x02,
    USBD_IDX_MFC_STR,           /*Index of manufacturer  string*/
    USBD_IDX_PRODUCT_STR,       /*Index of product string*/
    USBD_IDX_SERIAL_STR,        /*Index of serial number string*/
    USBD_MAX_NUM_CONFIGURATION  /*bNumConfigurations*/
  } ; 
/* USB_DeviceDescriptor */

View Code

這個分析起來有點麻煩

/* USB HID device Configuration Descriptor */
__ALIGN_BEGIN static uint8_t USBD_HID_CfgDesc[USB_HID_CONFIG_DESC_SIZ]  __ALIGN_END =
{
  0x09, /* bLength: Configuration Descriptor size */
  USB_DESC_TYPE_CONFIGURATION, /* bDescriptorType: Configuration */
  USB_HID_CONFIG_DESC_SIZ,
  /* wTotalLength: Bytes returned */
  0x00,
  0x01,         /*bNumInterfaces: 1 interface*/
  0x01,         /*bConfigurationValue: Configuration value*/
  0x00,         /*iConfiguration: Index of string descriptor describing
  the configuration*/
  0xE0,         /*bmAttributes: bus powered and Support Remote Wake-up */
  0x32,         /*MaxPower 100 mA: this current is used for detecting Vbus*/
  
  /************** Descriptor of Joystick Mouse interface ****************/
  /* 09 */
  0x09,         /*bLength: Interface Descriptor size*/
  USB_DESC_TYPE_INTERFACE,/*bDescriptorType: Interface descriptor type*/
  0x00,         /*bInterfaceNumber: Number of Interface*/
  0x00,         /*bAlternateSetting: Alternate setting*/
  0x01,         /*bNumEndpoints*/
  0x03,         /*bInterfaceClass: HID*/
  0x01,         /*bInterfaceSubClass : 1=BOOT, 0=no boot*/
  0x02,         /*nInterfaceProtocol : 0=none, 1=keyboard, 2=mouse*/
  0,            /*iInterface: Index of string descriptor*/
  /******************** Descriptor of Joystick Mouse HID ********************/
  /* 18 */
  0x09,         /*bLength: HID Descriptor size*/
  HID_DESCRIPTOR_TYPE, /*bDescriptorType: HID*/
  0x11,         /*bcdHID: HID Class Spec release number*/
  0x01,
  0x00,         /*bCountryCode: Hardware target country*/
  0x01,         /*bNumDescriptors: Number of HID class descriptors to follow*/
  0x22,         /*bDescriptorType*/
  HID_MOUSE_REPORT_DESC_SIZE,/*wItemLength: Total length of Report descriptor*/
  0x00,
  /******************** Descriptor of Mouse endpoint ********************/
  /* 27 */
  0x07,          /*bLength: Endpoint Descriptor size*/
  USB_DESC_TYPE_ENDPOINT, /*bDescriptorType:*/
  
  HID_EPIN_ADDR,     /*bEndpointAddress: Endpoint Address (IN)*/
  0x03,          /*bmAttributes: Interrupt endpoint*/
  HID_EPIN_SIZE, /*wMaxPacketSize: 4 Byte max */
  0x00,
  HID_FS_BINTERVAL,          /*bInterval: Polling Interval (10 ms)*/
  /* 34 */
} ;

View Code

Table 9-10. Standard Configuration Descriptor

Table 9-12. Standard Interface Descriptor

這邊需要參考<Device Class Definition for Human Interface Devices (HID) Version 1.11 > "6.2.1 HID Descriptor"

Table 9-13. Standard Endpoint Descriptor

現在利用軟件直接看這個上面的信息

Connection Status	Device connected
Current Configuration	1
Speed	Full (12 Mbit/s)
Device Address	12
Number Of Open Pipes	1

Device Descriptor STM32 Human interface

Offset	Field	Size	Value	Description
0	bLength	1	12h
1	bDescriptorType	1	01h	Device
2	bcdUSB	2	0200h	USB Spec 2.0
4	bDeviceClass	1	00h	Class info in Ifc Descriptors
5	bDeviceSubClass	1	00h
6	bDeviceProtocol	1	00h
7	bMaxPacketSize0	1	40h	64 bytes
8	idVendor	2	0483h	SGS Thomson Microelectronics
10	idProduct	2	572Bh
12	bcdDevice	2	0200h	2.00
14	iManufacturer	1	01h	"STMicroelectronics"
15	iProduct	1	02h	"STM32 Human interface"
16	iSerialNumber	1	03h	"00000000001A"
17	bNumConfigurations	1	01h

Configuration Descriptor 1

Offset	Field	Size	Value	Description
0	bLength	1	09h
1	bDescriptorType	1	02h	Configuration
2	wTotalLength	2	0022h
4	bNumInterfaces	1	01h
5	bConfigurationValue	1	01h
6	iConfiguration	1	00h
7	bmAttributes	1	E0h	Self Powered, Remote Wakeup
	4..0: Reserved		...00000
	5: Remote Wakeup		..1.....	Yes
	6: Self Powered		.1......	Yes
	7: Reserved (set to one) (bus-powered for 1.0)		1.......
8	bMaxPower	1	32h	100 mA

Interface Descriptor 0/0 HID, 1 Endpoint

Offset	Field	Size	Value	Description
0	bLength	1	09h
1	bDescriptorType	1	04h	Interface
2	bInterfaceNumber	1	00h
3	bAlternateSetting	1	00h
4	bNumEndpoints	1	01h
5	bInterfaceClass	1	03h	HID
6	bInterfaceSubClass	1	01h	Boot Interface
7	bInterfaceProtocol	1	02h	Mouse
8	iInterface	1	00h

HID Descriptor

Offset	Field	Size	Value	Description
0	bLength	1	09h
1	bDescriptorType	1	21h	HID
2	bcdHID	2	0111h	1.11
4	bCountryCode	1	00h
5	bNumDescriptors	1	01h
6	bDescriptorType	1	22h	Report
7	wDescriptorLength	2	004Ah	74 bytes

Endpoint Descriptor 81 1 In, Interrupt, 10 ms

Offset	Field	Size	Value	Description
0	bLength	1	07h
1	bDescriptorType	1	05h	Endpoint
2	bEndpointAddress	1	81h	1 In
3	bmAttributes	1	03h	Interrupt
	1..0: Transfer Type		......11	Interrupt
	7..2: Reserved		000000..
4	wMaxPacketSize	2	0004h	4 bytes
6	bInterval	1	0Ah	10 ms

Interface 0 HID Report Descriptor Mouse

Item Tag (Value)	Raw Data
Usage Page (Generic Desktop)	05 01
Usage (Mouse)	09 02
Collection (Application)	A1 01
Usage (Pointer)	09 01
Collection (Physical)	A1 00
Usage Page (Button)	05 09
Usage Minimum (Button 1)	19 01
Usage Maximum (Button 3)	29 03
Logical Minimum (0)	15 00
Logical Maximum (1)	25 01
Report Count (3)	95 03
Report Size (1)	75 01
Input (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit)	81 02
Report Count (1)	95 01
Report Size (5)	75 05
Input (Cnst,Ary,Abs)	81 01
Usage Page (Generic Desktop)	05 01
Usage (X)	09 30
Usage (Y)	09 31
Usage (Wheel)	09 38
Logical Minimum (-127)	15 81
Logical Maximum (127)	25 7F
Report Size (8)	75 08
Report Count (3)	95 03
Input (Data,Var,Rel,NWrp,Lin,Pref,NNul,Bit)	81 06
End Collection	C0
Usage (Motion Wakeup)	09 3C
Usage Page	05 FF
Usage	09 01
Logical Minimum (0)	15 00
Logical Maximum (1)	25 01
Report Size (1)	75 01
Report Count (2)	95 02
Feature (Data,Var,Abs,NWrp,Lin,NPrf,NNul,NVol,Bit)	B1 22
Report Size (6)	75 06
Report Count (1)	95 01
Feature (Cnst,Ary,Abs,NWrp,Lin,Pref,NNul,NVol,Bit)	B1 01
End Collection	C0

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。

猜您在找 STM32cubeMX生成FreeRTOS工程利用STM32CubeMX之SPI STM32_使用STM32CubeMX創建一個USB+FATFS的TrueSTUDIO編譯環境下的工程 stm32+lwip(一):使用STM32CubeMX生成項目 stm32CubeMx lwip + freeRTOS stm32cubemx 固件安裝 STM32CubeMx的使用分享 STM32CubeMX與串口通信 STM32CubeMX軟件工程描述_USART配置過程 STM32CubeMX工程修改MCU的兩種方法