dw做网站是静态还是动态,做弹幕网站,wordpress页面乱码代码,如何做外贸网络推广在 STM32F407 上开发 USB 功能时#xff0c;STM32Cube 默认生成的代码通常只能支持单一设备类型#xff0c;例如仅能作为虚拟串口#xff08;CDC#xff09;、存储设备#xff08;MSC#xff09;或音频设备#xff08;Audio#xff09;之一使用。 然而#xff0c;在实…在 STM32F407 上开发 USB 功能时STM32Cube 默认生成的代码通常只能支持单一设备类型例如仅能作为虚拟串口CDC、存储设备MSC或音频设备Audio之一使用。 然而在实际应用中我们常常希望设备能够“一心多用”比如 既能作为 U 盘 与电脑进行文件传输MSC 又能提供 虚拟串口 用于调试和数据通信CDC 同时还能充当 音频输出设备 播放声音Audio。
要实现这样的多功能设备就需要将 CDC、MSC 和 Audio 三种 USB 类合并到同一个 USB 描述符中从而让主机在枚举时能同时识别并挂载这些功能。本文将介绍具体的实现方法和步骤。 1. 分别生成和调试单设备
使用 STM32CubeMX 分别生成 CDC、MSC 和 Audio 的单独工程并确保能正常运行 CDC 和 Audio 的代码基本可以直接使用 MSC 需要在 usbd_storage_if.c 中补充存储层实现可参考我之前的文章。
2. 合并工程代码
将 CDC、MSC、Audio 三个类相关文件合并到同一个工程中主要包含以下内容 CDC 相关 Middlewares\ST\STM32_USB_Device_Library\Class\CDC
USB_DEVICE\App\usbd_cdc_if.c/h MSC 相关 Middlewares\ST\STM32_USB_Device_Library\Class\MSC
USB_DEVICE\App\usbd_storage_if.c/hAudio 相关 Middlewares\ST\STM32_USB_Device_Library\Class\AUDIO
USB_DEVICE\App\usbd_audio_if.c/h我这里是基于 Audio 工程 添加 MSC 和 CDC 模块的。 另外在 USB_DEVICE\Target\usbd_conf.h 中增加
#define MSC_MEDIA_PACKET 512U3. 分配端点号
确保各个类的 IN/OUT 端点号不冲突。 STM32F407 除了 EP0只有 EP1、EP2、EP3 可用需合理分配 CDC #define CDC_IN_EP 0x81U /* EP1 IN */
#define CDC_OUT_EP 0x01U /* EP1 OUT */
#define CDC_CMD_EP 0x82U /* EP2 CMD */MSC #define MSC_EPIN_ADDR 0x83U
#define MSC_EPOUT_ADDR 0x03UAudio #define AUDIO_OUT_EP 0x02U4. 配置 USB FIFO
在 USB_DEVICE\Target\usbd_conf.c 的 USBD_LL_Init 函数中重新分配 FIFO 空间。 具体设置可参考下图 具体用法参考链接usb fifo设置
5. 启用复合设备支持 添加全局的宏USE_USBD_COMPOSITE
6. 配置支持多个 Class 和 Interface
在 usbd_conf.h 中增加
#define USBD_MAX_SUPPORTED_CLASS 3
#define USBD_MAX_NUM_INTERFACES 6说明
CDC Class MSC Class AUDIO Class 一共3个Class CDC: Control Data 共 2 个接口 MSC: 1 个接口 Audio: Control Streaming 共 2 个接口 合计至少 5 个接口这里配置为 6 更保险。 7. 定义配置描述符大小和接口数量
在 usbd_conf.h 中根据宏开关分别定义 #define USBD_AUDIO_CMPSIT_ENABLE 1
#define USBD_MSC_CMPSIT_ENABLE 1
#define USBD_CDC_CMPSIT_ENABLE 1#if (USBD_AUDIO_CMPSIT_ENABLE 1)
#define USB_CMPSIT_AUDIO_CONFIG_DESC_SIZ (USB_AUDIO_CONFIG_DESC_SIZ-98)
#define USBD_AUDIO_INTERFACES_NUM 2
#else
#define USB_CMPSIT_AUDIO_CONFIG_DESC_SIZ 0
#define USBD_AUDIO_INTERFACES_NUM 0
#endif#if (USBD_MSC_CMPSIT_ENABLE 1)
#define USB_CMPSIT_MSC_CONFIG_DESC_SIZ (USB_MSC_CONFIG_DESC_SIZ-98)
#define USBD_MSC_INTERFACES_NUM 1
#else
#define USB_CMPSIT_MSC_CONFIG_DESC_SIZ 0
#define USBD_MSC_INTERFACES_NUM 0
#endif#if (USBD_CDC_CMPSIT_ENABLE 1)
#define USB_CMPSIT_CDC_CONFIG_DESC_SIZ (USB_CDC_CONFIG_DESC_SIZ-98)
#define USBD_CDC_INTERFACES_NUM 2
#else
#define USB_CMPSIT_CDC_CONFIG_DESC_SIZ 0
#define USBD_CDC_INTERFACES_NUM 0
#endif8. 实现复合类接口
CubeMX 生成的代码中已经有复合设备的相关框架只需 定义宏 USE_USBD_COMPOSITE 新建 usbd_composite.c/h实现 USBD_CMPSIT 结构体和 USBD_CMPSIT_AddClass() 函数。
这样就能让主机正确识别并挂载 CDC MSC Audio 三个功能。 usbd_composite.c内容如下
#include usbd_composite.h
#include usbd_def.h
#include usbd_cdc.h
#include usbd_msc.h
#include usbd_audio.h#include usbd_core.h
#include usbd_desc.h
#include usbd_conf.h
#include stdio.h
#include log_debug.h#define USBD_LOG log_debug
// #define USBD_LOG#define USBD_PRODUCT_XSTR(s) USBD_PRODUCT_STR(s)
#define USBD_PRODUCT_STR(s) #s#if 1
#define USBD_CMPSIT_VID 1155
#define USBD_CMPSIT_LANGID_STRING 1033
#define USBD_CMPSIT_MANUFACTURER_STRING wenyzwolfGroup
#define USBD_CMPSIT_PID_FS 22336
#define USBD_CMPSIT_PRODUCT_STRING_FS STM32 composite product
#define USBD_CMPSIT_CONFIGURATION_STRING_FS Composite Config
#define USBD_CMPSIT_INTERFACE_STRING_FS Composite Interface
#else
#define USBD_CMPSIT_VID 1155
#define USBD_CMPSIT_LANGID_STRING 1033
#define USBD_CMPSIT_MANUFACTURER_STRING STMicroelectronics
#define USBD_CMPSIT_PID_FS 22336
#define USBD_CMPSIT_PRODUCT_STRING_FS STM32 Virtual ComPort
#define USBD_CMPSIT_CONFIGURATION_STRING_FS CDC Config
#define USBD_CMPSIT_INTERFACE_STRING_FS CDC Interface
#endif#define USBD_CDC_INTERFACE_STRING_FS CDC Interface
#define USBD_MSC_INTERFACE_STRING_FS MSC Interface
#define USBD_AUDIO_INTERFACE_STRING_FS AUDIO Interface#define AUDIO_SAMPLE_FREQ(frq) \(uint8_t)(frq), (uint8_t)((frq 8)), (uint8_t)((frq 16))#define AUDIO_PACKET_SZE(frq) \(uint8_t)(((frq * 2U * 2U) / 1000U) 0xFFU), (uint8_t)((((frq * 2U * 2U) / 1000U) 8) 0xFFU)#ifdef USE_USBD_COMPOSITE
#define AUDIO_PACKET_SZE_WORD(frq) (uint32_t)((((frq) * 2U * 2U)/1000U))
#endif /* USE_USBD_COMPOSITE */uint8_t * USBD_CMPSIT_FS_DeviceDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_CMPSIT_FS_LangIDStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_CMPSIT_FS_ManufacturerStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_CMPSIT_FS_ProductStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_CMPSIT_FS_SerialStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_CMPSIT_FS_ConfigStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
uint8_t * USBD_CMPSIT_FS_InterfaceStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
#if (USBD_LPM_ENABLED 1)
uint8_t * USBD_CMPSIT_FS_USR_BOSDescriptor(USBD_SpeedTypeDef speed, uint16_t *length);
#endif /* (USBD_LPM_ENABLED 1) */USBD_DescriptorsTypeDef usbCmpsitFS_Desc
{USBD_CMPSIT_FS_DeviceDescriptor
, USBD_CMPSIT_FS_LangIDStrDescriptor
, USBD_CMPSIT_FS_ManufacturerStrDescriptor
, USBD_CMPSIT_FS_ProductStrDescriptor
, USBD_CMPSIT_FS_SerialStrDescriptor
, USBD_CMPSIT_FS_ConfigStrDescriptor
, USBD_CMPSIT_FS_InterfaceStrDescriptor
#if (USBD_LPM_ENABLED 1)
, USBD_CMPSIT_FS_USR_BOSDescriptor
#endif /* (USBD_LPM_ENABLED 1) */
};__ALIGN_BEGIN uint8_t USBD_CMPSIT_FS_DeviceDesc[USB_LEN_DEV_DESC] __ALIGN_END
{0x12, /*bLength */USB_DESC_TYPE_DEVICE, /*bDescriptorType*/
#if (USBD_LPM_ENABLED 1)0x01, /*bcdUSB */ /* changed to USB version 2.01in order to support LPM L1 suspendresume test of USBCV3.0*/
#else0x00, /*bcdUSB */
#endif /* (USBD_LPM_ENABLED 1) */0x02,// Notify OS that this is a composite device0xEF, /*bDeviceClass*/0x02, /*bDeviceSubClass*/0x01, /*bDeviceProtocol*/USB_MAX_EP0_SIZE, /*bMaxPacketSize*/LOBYTE(USBD_CMPSIT_VID), /*idVendor*/HIBYTE(USBD_CMPSIT_VID), /*idVendor*/LOBYTE(USBD_CMPSIT_PID_FS), /*idProduct*/HIBYTE(USBD_CMPSIT_PID_FS), /*idProduct*/0x00, /*bcdDevice rel. 2.00*/0x02, /* bNumInterfaces */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*/};#if (USBD_LPM_ENABLED 1)
__ALIGN_BEGIN uint8_t USBD_CMPSIT_FS_BOSDesc[USB_SIZ_BOS_DESC] __ALIGN_END
{0x5,USB_DESC_TYPE_BOS,0xC,0x0,0x1, /* 1 device capability*//* device capability*/0x7,USB_DEVICE_CAPABITY_TYPE,0x2,0x2, /* LPM capability bit set*/0x0,0x0,0x0
};
#endif /* (USBD_LPM_ENABLED 1) *//** USB lang identifier descriptor. */
__ALIGN_BEGIN uint8_t USBD_CMPSIT_LangIDDesc[USB_LEN_LANGID_STR_DESC] __ALIGN_END
{USB_LEN_LANGID_STR_DESC,USB_DESC_TYPE_STRING,LOBYTE(USBD_CMPSIT_LANGID_STRING),HIBYTE(USBD_CMPSIT_LANGID_STRING)
};/* Internal string descriptor. */
__ALIGN_BEGIN uint8_t USBD_CMPSIT_StrDesc[USBD_MAX_STR_DESC_SIZ] __ALIGN_END;__ALIGN_BEGIN uint8_t USBD_CMPSIT_StringSerial[USB_SIZ_STRING_SERIAL] __ALIGN_END {USB_SIZ_STRING_SERIAL,USB_DESC_TYPE_STRING,
};uint8_t * USBD_CMPSIT_FS_DeviceDescriptor(USBD_SpeedTypeDef speed, uint16_t *length)
{USBD_LOG(USBD_CMPSIT_FS_DeviceDescriptor, speed %d, length %d\n, speed, *length);UNUSED(speed);*length sizeof(USBD_CMPSIT_FS_DeviceDesc);return USBD_CMPSIT_FS_DeviceDesc;
}uint8_t * USBD_CMPSIT_FS_LangIDStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length)
{USBD_LOG(USBD_CMPSIT_FS_LangIDStrDescriptor, speed %d, length %d\n, speed, *length);UNUSED(speed);*length sizeof(USBD_CMPSIT_LangIDDesc);return USBD_CMPSIT_LangIDDesc;
}
uint8_t * USBD_CMPSIT_FS_ManufacturerStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length)
{USBD_LOG(USBD_CMPSIT_FS_ManufacturerStrDescriptor, speed %d, length %d\n, speed, *length);UNUSED(speed);USBD_GetString((uint8_t *)USBD_CMPSIT_MANUFACTURER_STRING, USBD_CMPSIT_StrDesc, length);return USBD_CMPSIT_StrDesc;
}uint8_t * USBD_CMPSIT_FS_ProductStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length)
{USBD_LOG(USBD_CMPSIT_FS_ProductStrDescriptor, speed %d, length %d\n, speed, *length);if(speed 0){USBD_GetString((uint8_t *)USBD_CMPSIT_PRODUCT_STRING_FS, USBD_CMPSIT_StrDesc, length);}else{USBD_GetString((uint8_t *)USBD_CMPSIT_PRODUCT_STRING_FS, USBD_CMPSIT_StrDesc, length);}return USBD_CMPSIT_StrDesc;
}static void IntToUnicode(uint32_t value, uint8_t * pbuf, uint8_t len)
{uint8_t idx 0;for (idx 0; idx len; idx){if (((value 28)) 0xA){pbuf[2 * idx] (value 28) 0;}else{pbuf[2 * idx] (value 28) A - 10;}value value 4;pbuf[2 * idx 1] 0;}
}
static void Get_CMPSIT_SerialNum(void)
{USBD_LOG(Get_CMPSIT_SerialNum\n);uint32_t deviceserial0, deviceserial1, deviceserial2;deviceserial0 *(uint32_t *) DEVICE_ID1;deviceserial1 *(uint32_t *) DEVICE_ID2;deviceserial2 *(uint32_t *) DEVICE_ID3;deviceserial0 deviceserial2;if (deviceserial0 ! 0){IntToUnicode(deviceserial0, USBD_CMPSIT_StringSerial[2], 8);IntToUnicode(deviceserial1, USBD_CMPSIT_StringSerial[18], 4);}
}
uint8_t * USBD_CMPSIT_FS_SerialStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length)
{USBD_LOG(USBD_CMPSIT_FS_SerialStrDescriptor, speed %d, length %d\n, speed, *length);UNUSED(speed);*length USB_SIZ_STRING_SERIAL;/* Update the serial number string descriptor with the data from the unique* ID */Get_CMPSIT_SerialNum();/* USER CODE BEGIN USBD_FS_SerialStrDescriptor *//* USER CODE END USBD_FS_SerialStrDescriptor */return (uint8_t *) USBD_CMPSIT_StringSerial;
}uint8_t * USBD_CMPSIT_FS_InterfaceStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length)
{USBD_LOG(USBD_CMPSIT_FS_InterfaceStrDescriptor, speed %d, length %d\n, speed, *length);if(speed 0){USBD_GetString((uint8_t *)USBD_CMPSIT_INTERFACE_STRING_FS, USBD_CMPSIT_StrDesc, length);}else{USBD_GetString((uint8_t *)USBD_CMPSIT_INTERFACE_STRING_FS, USBD_CMPSIT_StrDesc, length);}return USBD_CMPSIT_StrDesc;
}uint8_t * USBD_CMPSIT_FS_ConfigStrDescriptor(USBD_SpeedTypeDef speed, uint16_t *length)
{USBD_LOG(USBD_CMPSIT_FS_ConfigStrDescriptor, speed %d, length %d\n, speed, *length);if(speed USBD_SPEED_HIGH){USBD_GetString((uint8_t *)USBD_CMPSIT_CONFIGURATION_STRING_FS, USBD_CMPSIT_StrDesc, length);}else{USBD_GetString((uint8_t *)USBD_CMPSIT_CONFIGURATION_STRING_FS, USBD_CMPSIT_StrDesc, length);}return USBD_CMPSIT_StrDesc;
}#if (USBD_LPM_ENABLED 1)
/*** brief Return the BOS descriptor* param speed : Current device speed* param length : Pointer to data length variable* retval Pointer to descriptor buffer*/
uint8_t * USBD_CMPSIT_FS_USR_BOSDescriptor(USBD_SpeedTypeDef speed, uint16_t *length)
{UNUSED(speed);*length sizeof(USBD_CMPSIT_FS_BOSDesc);return (uint8_t*)USBD_CMPSIT_FS_BOSDesc;
}
#endif /* (USBD_LPM_ENABLED 1) */__ALIGN_BEGIN static uint8_t USBD_CMPSIT_CfgDesc[USB_CMPSIT_CONFIG_DESC_SIZ] __ALIGN_END
{/* Configuration Descriptor */0x09, /* bLength: Configuration Descriptor size */USB_DESC_TYPE_CONFIGURATION, /* bDescriptorType: Configuration */LOBYTE(USB_CMPSIT_CONFIG_DESC_SIZ), /* wTotalLength */HIBYTE(USB_CMPSIT_CONFIG_DESC_SIZ),USBD_CMPSIT_NUM_INTERFACES, /* bNumInterfaces: CDC(2)MSC(1)Audio(2)5 interfaces */0x01, /* bConfigurationValue */0x00, /* iConfiguration */
#if (USBD_SELF_POWERED 1U)0xC0, /* bmAttributes: Self Powered */
#else0x80, /* bmAttributes: Bus Powered */
#endifUSBD_MAX_POWER, /* MaxPower */#if USBD_CDC_CMPSIT_ENABLE/* CDC IAD */0x08,0x0B,CDC_COMM_ITF_NBR, /* bFirstInterface */USBD_CDC_INTERFACES_NUM, /* bInterfaceCount */0x02, /* bFunctionClass: Communication Interface Class */0x02, /* bFunctionSubClass: Abstract Control Model */0x01, /* bFunctionProtocol: AT commands */0x06, /* iFunction *//* CDC Communication Interface Descriptor */0x09,USB_DESC_TYPE_INTERFACE,CDC_COMM_ITF_NBR, /* bInterfaceNumber */0x00,0x01, /* One endpoint: CDC_CMD_EP */0x02,0x02,0x01,0x06,/* CDC Header Functional Descriptor */0x05,0x24,0x00,0x10, 0x01,/* CDC Call Management Functional Descriptor */0x05,0x24,0x01,0x00,0x01, /* bDataInterface *//* CDC ACM Functional Descriptor */0x04,0x24,0x02,0x02,/* CDC Union Functional Descriptor */0x05,0x24,0x06,0x00, /* Master interface */0x01, /* Slave interface *//* CDC Command Endpoint Descriptor */0x07,USB_DESC_TYPE_ENDPOINT,CDC_CMD_EP,0x03,LOBYTE(CDC_CMD_PACKET_SIZE),HIBYTE(CDC_CMD_PACKET_SIZE),CDC_FS_BINTERVAL,/* CDC Data Interface Descriptor */0x09,USB_DESC_TYPE_INTERFACE,CDC_DATA_ITF_NBR, /* bInterfaceNumber */0x00,0x02, /* Two endpoints: IN/OUT */0x0A,0x00,0x00,0x06,/* CDC Data OUT Endpoint Descriptor */0x07,USB_DESC_TYPE_ENDPOINT,CDC_OUT_EP,0x02,LOBYTE(CDC_DATA_FS_MAX_PACKET_SIZE),HIBYTE(CDC_DATA_FS_MAX_PACKET_SIZE),0x00,/* CDC Data IN Endpoint Descriptor */0x07,USB_DESC_TYPE_ENDPOINT,CDC_IN_EP,0x02,LOBYTE(CDC_DATA_FS_MAX_PACKET_SIZE),HIBYTE(CDC_DATA_FS_MAX_PACKET_SIZE),0x00,
#endif /* USBD_MSC_CMPSIT_ENABLE */#if USBD_MSC_CMPSIT_ENABLE/* MSC IAD */0x08,0x0B,MSC_STD_ITF_NBR, /* bFirstInterface: MSC interface */USBD_MSC_INTERFACES_NUM,0x08,0x06,0x50,0x07,/* MSC Interface Descriptor */0x09,USB_DESC_TYPE_INTERFACE,MSC_STD_ITF_NBR, /* MSC interface number */0x00,0x02, /* Two endpoints */0x08,0x06,0x50,0x07,/* MSC IN Endpoint */0x07,USB_DESC_TYPE_ENDPOINT,MSC_EPIN_ADDR,0x02,LOBYTE(MSC_MAX_FS_PACKET),HIBYTE(MSC_MAX_FS_PACKET),0x00,/* MSC OUT Endpoint */0x07,USB_DESC_TYPE_ENDPOINT,MSC_EPOUT_ADDR,0x02,LOBYTE(MSC_MAX_FS_PACKET),HIBYTE(MSC_MAX_FS_PACKET),0x00,
#endif /* USBD_MSC_CMPSIT_ENABLE */#if USBD_AUDIO_CMPSIT_ENABLE/******** IAD to associate the two SPKR interfaces */0x08, /* bLength */0x0B, /* bDescriptorType */AUDIO_SPKR_AC_ITF_NBR, /* bFirstInterface */USBD_AUDIO_INTERFACES_NUM, /* bInterfaceCount */USB_DEVICE_CLASS_AUDIO, /* bFunctionClass */AUDIO_SUBCLASS_AUDIOCONTROL, /* bFunctionSubClass */AUDIO_PROTOCOL_UNDEFINED, /* bFunctionProtocol */0x00, /* iFunction (Index of string descriptor describing this function) *//* USB Speaker Standard interface descriptor */AUDIO_INTERFACE_DESC_SIZE, /* bLength */USB_DESC_TYPE_INTERFACE, /* bDescriptorType */AUDIO_SPKR_AC_ITF_NBR, /* bInterfaceNumber */0x00, /* bAlternateSetting */0x00, /* bNumEndpoints */USB_DEVICE_CLASS_AUDIO, /* bInterfaceClass */AUDIO_SUBCLASS_AUDIOCONTROL, /* bInterfaceSubClass */AUDIO_PROTOCOL_UNDEFINED, /* bInterfaceProtocol */AUDIO_SPKR_STR_DESC_IDX, /* iInterface *//* 09 byte*//* USB Speaker Class-specific AC Interface Descriptor */AUDIO_INTERFACE_DESC_SIZE, /* bLength */AUDIO_INTERFACE_DESCRIPTOR_TYPE, /* bDescriptorType */AUDIO_CONTROL_HEADER, /* bDescriptorSubtype */0x00, /* 1.00 */ /* bcdADC */0x01,0x27, /* wTotalLength 39*/0x00,0x01, /* bInCollection */AUDIO_SPKR_AS_ITF_NBR, /* baInterfaceNr *//* 09 byte*//* USB Speaker Input Terminal Descriptor */AUDIO_INPUT_TERMINAL_DESC_SIZE, /* bLength */AUDIO_INTERFACE_DESCRIPTOR_TYPE, /* bDescriptorType */AUDIO_CONTROL_INPUT_TERMINAL, /* bDescriptorSubtype */0x01, /* bTerminalID */0x01, /* wTerminalType AUDIO_TERMINAL_USB_STREAMING 0x0101 */0x01,0x00, /* bAssocTerminal */0x01, /* bNrChannels */0x00, /* wChannelConfig 0x0000 Mono */0x00,0x00, /* iChannelNames */0x00, /* iTerminal *//* 12 byte*//* USB Speaker Audio Feature Unit Descriptor */0x09, /* bLength */AUDIO_INTERFACE_DESCRIPTOR_TYPE, /* bDescriptorType */AUDIO_CONTROL_FEATURE_UNIT, /* bDescriptorSubtype */AUDIO_STREAMING_CTRL, /* bUnitID */0x01, /* bSourceID */0x01, /* bControlSize */AUDIO_CONTROL_MUTE, /* bmaControls(0) */0x00, /* bmaControls(1) */0x00, /* iTerminal *//* 09 byte*//*USB Speaker Output Terminal Descriptor */0x09, /* bLength */AUDIO_INTERFACE_DESCRIPTOR_TYPE, /* bDescriptorType */AUDIO_CONTROL_OUTPUT_TERMINAL, /* bDescriptorSubtype */0x03, /* bTerminalID */0x01, /* wTerminalType 0x0301*/0x03,0x00, /* bAssocTerminal */0x02, /* bSourceID */0x00, /* iTerminal *//* 09 byte*//* USB Speaker Standard AS Interface Descriptor - Audio Streaming Zero Bandwidth *//* Interface 1, Alternate Setting 0 */AUDIO_INTERFACE_DESC_SIZE, /* bLength */USB_DESC_TYPE_INTERFACE, /* bDescriptorType */AUDIO_SPKR_AS_ITF_NBR, /* bInterfaceNumber */0x00, /* bAlternateSetting */0x00, /* bNumEndpoints */USB_DEVICE_CLASS_AUDIO, /* bInterfaceClass */AUDIO_SUBCLASS_AUDIOSTREAMING, /* bInterfaceSubClass */AUDIO_PROTOCOL_UNDEFINED, /* bInterfaceProtocol */0x00, /* iInterface *//* 09 byte*//* USB Speaker Standard AS Interface Descriptor - Audio Streaming Operational *//* Interface 1, Alternate Setting 1 */AUDIO_INTERFACE_DESC_SIZE, /* bLength */USB_DESC_TYPE_INTERFACE, /* bDescriptorType */AUDIO_SPKR_AS_ITF_NBR, /* bInterfaceNumber */0x01, /* bAlternateSetting */0x01, /* bNumEndpoints */USB_DEVICE_CLASS_AUDIO, /* bInterfaceClass */AUDIO_SUBCLASS_AUDIOSTREAMING, /* bInterfaceSubClass */AUDIO_PROTOCOL_UNDEFINED, /* bInterfaceProtocol */0x00, /* iInterface *//* 09 byte*//* USB Speaker Audio Streaming Interface Descriptor */AUDIO_STREAMING_INTERFACE_DESC_SIZE, /* bLength */AUDIO_INTERFACE_DESCRIPTOR_TYPE, /* bDescriptorType */AUDIO_STREAMING_GENERAL, /* bDescriptorSubtype */0x01, /* bTerminalLink */0x01, /* bDelay */0x01, /* wFormatTag AUDIO_FORMAT_PCM 0x0001 */0x00,/* 07 byte*//* USB Speaker Audio Type III Format Interface Descriptor */0x0B, /* bLength */AUDIO_INTERFACE_DESCRIPTOR_TYPE, /* bDescriptorType */AUDIO_STREAMING_FORMAT_TYPE, /* bDescriptorSubtype */AUDIO_FORMAT_TYPE_I, /* bFormatType */0x02, /* bNrChannels */0x02, /* bSubFrameSize : 2 Bytes per frame (16bits) */16, /* bBitResolution (16-bits per sample) */0x01, /* bSamFreqType only one frequency supported */AUDIO_SAMPLE_FREQ(USBD_AUDIO_FREQ), /* Audio sampling frequency coded on 3 bytes *//* 11 byte*//* Endpoint 1 - Standard Descriptor */AUDIO_STANDARD_ENDPOINT_DESC_SIZE, /* bLength */USB_DESC_TYPE_ENDPOINT, /* bDescriptorType */AUDIO_OUT_EP, /* bEndpointAddress 1 out endpoint */USBD_EP_TYPE_ISOC, /* bmAttributes */AUDIO_PACKET_SZE(USBD_AUDIO_FREQ), /* wMaxPacketSize in Bytes (Freq(Samples)*2(Stereo)*2(HalfWord)) */AUDIO_FS_BINTERVAL, /* bInterval */0x00, /* bRefresh */0x00, /* bSynchAddress *//* 09 byte*//* Endpoint - Audio Streaming Descriptor*/AUDIO_STREAMING_ENDPOINT_DESC_SIZE, /* bLength */AUDIO_ENDPOINT_DESCRIPTOR_TYPE, /* bDescriptorType */AUDIO_ENDPOINT_GENERAL, /* bDescriptor */0x00, /* bmAttributes */0x00, /* bLockDelayUnits */0x00, /* wLockDelay */0x00,/* 07 byte*/
#endif /* USBD_AUDIO_CMPSIT_ENABLE */
};__ALIGN_BEGIN static uint8_t USBD_CMPSIT_DeviceQualifierDesc[USB_LEN_DEV_QUALIFIER_DESC] __ALIGN_END
{USB_LEN_DEV_QUALIFIER_DESC,USB_DESC_TYPE_DEVICE_QUALIFIER,0x00,0x02,0x00,0x00,0x00,0x40,0x01,0x00,
};static uint8_t *USBD_CMPSIT_GetFSCfgDesc(uint16_t *length);
static uint8_t *USBD_CMPSIT_GetHSCfgDesc(uint16_t *length);
static uint8_t *USBD_CMPSIT_GetOtherSpeedCfgDesc(uint16_t *length);
uint8_t *USBD_CMPSIT_GetDeviceQualifierDescriptor(uint16_t *length);/* This structure is used only for the Configuration descriptors and Device Qualifier */
USBD_ClassTypeDef USBD_CMPSIT
{NULL, /* Init, */NULL, /* DeInit, */NULL, /* Setup, */NULL, /* EP0_TxSent, */NULL, /* EP0_RxReady, */NULL, /* DataIn, */NULL, /* DataOut, */NULL, /* SOF, */NULL,NULL,
#ifdef USE_USB_HSUSBD_CMPSIT_GetHSCfgDesc,
#elseNULL,
#endif /* USE_USB_HS */USBD_CMPSIT_GetFSCfgDesc,USBD_CMPSIT_GetOtherSpeedCfgDesc,USBD_CMPSIT_GetDeviceQualifierDescriptor,
#if (USBD_SUPPORT_USER_STRING_DESC 1U)NULL,
#endif /* USBD_SUPPORT_USER_STRING_DESC */
};#ifdef USE_USBD_COMPOSITE
void USBD_CMPSIT_AddClass(USBD_HandleTypeDef *pdev, USBD_ClassTypeDef *pclass, USBD_CompositeClassTypeDef classtype, uint8_t *EpAddr)
{USBD_LOG(USBD_CMPSIT_AddClass, classId %d, type %d\r\n,pdev-classId,classtype);switch(classtype) {case CLASS_TYPE_CDC:{pdev-tclasslist[pdev-classId].ClassType CLASS_TYPE_CDC;pdev-tclasslist[pdev-classId].Active 1U;pdev-tclasslist[pdev-classId].NumEps 3;pdev-tclasslist[pdev-classId].Eps[0].add CDC_CMD_EP;pdev-tclasslist[pdev-classId].Eps[0].type USBD_EP_TYPE_INTR;pdev-tclasslist[pdev-classId].Eps[0].size CDC_CMD_PACKET_SIZE;pdev-tclasslist[pdev-classId].Eps[0].is_used 1U;pdev-tclasslist[pdev-classId].Eps[1].add CDC_OUT_EP;pdev-tclasslist[pdev-classId].Eps[1].type USBD_EP_TYPE_BULK;pdev-tclasslist[pdev-classId].Eps[1].size CDC_DATA_FS_MAX_PACKET_SIZE;pdev-tclasslist[pdev-classId].Eps[1].is_used 1U;pdev-tclasslist[pdev-classId].Eps[2].add CDC_IN_EP;pdev-tclasslist[pdev-classId].Eps[2].type USBD_EP_TYPE_BULK;pdev-tclasslist[pdev-classId].Eps[2].size CDC_DATA_FS_MAX_PACKET_SIZE;pdev-tclasslist[pdev-classId].Eps[2].is_used 1U;pdev-tclasslist[pdev-classId].NumIf USBD_CDC_INTERFACES_NUM;pdev-tclasslist[pdev-classId].Ifs[0] CDC_COMM_ITF_NBR;pdev-tclasslist[pdev-classId].Ifs[1] CDC_DATA_ITF_NBR; }break;case CLASS_TYPE_MSC:{pdev-tclasslist[pdev-classId].ClassType CLASS_TYPE_MSC;pdev-tclasslist[pdev-classId].Active 1U;pdev-tclasslist[pdev-classId].NumEps 2;pdev-tclasslist[pdev-classId].Eps[0].add MSC_EPIN_ADDR;pdev-tclasslist[pdev-classId].Eps[0].type USBD_EP_TYPE_BULK;pdev-tclasslist[pdev-classId].Eps[0].size MSC_MAX_FS_PACKET;pdev-tclasslist[pdev-classId].Eps[0].is_used 1U;pdev-tclasslist[pdev-classId].Eps[1].add MSC_EPOUT_ADDR;pdev-tclasslist[pdev-classId].Eps[1].type USBD_EP_TYPE_BULK;pdev-tclasslist[pdev-classId].Eps[1].size MSC_MAX_FS_PACKET;pdev-tclasslist[pdev-classId].Eps[1].is_used 1U;pdev-tclasslist[pdev-classId].NumIf USBD_MSC_INTERFACES_NUM;pdev-tclasslist[pdev-classId].Ifs[0] MSC_STD_ITF_NBR; }break;case CLASS_TYPE_AUDIO:{pdev-tclasslist[pdev-classId].ClassType CLASS_TYPE_AUDIO;pdev-tclasslist[pdev-classId].Active 1U;pdev-tclasslist[pdev-classId].NumEps 1;pdev-tclasslist[pdev-classId].Eps[0].add AUDIO_OUT_EP;pdev-tclasslist[pdev-classId].Eps[0].type USBD_EP_TYPE_ISOC;pdev-tclasslist[pdev-classId].Eps[0].size AUDIO_OUT_PACKET;//AUDIO_PACKET_SZE_WORD(USBD_AUDIO_FREQ);pdev-tclasslist[pdev-classId].Eps[0].is_used 1U;pdev-tclasslist[pdev-classId].NumIf USBD_AUDIO_INTERFACES_NUM;pdev-tclasslist[pdev-classId].Ifs[0] AUDIO_SPKR_AC_ITF_NBR;pdev-tclasslist[pdev-classId].Ifs[1] AUDIO_SPKR_AS_ITF_NBR; }break;default:break;}pdev-tclasslist[pdev-classId].CurrPcktSze 0U;}#endifuint8_t * USBD_UsrStrDescriptor(struct _USBD_HandleTypeDef *pdev, uint8_t index, uint16_t *length)
{USBD_LOG(USBD_UsrStrDescriptor, index %d, length %d\r\n, index, *length);*length 0;//printf(index%d\r\n,index);/* if (USBD_IDX_MICROSOFT_DESC_STR index) {*length sizeof (USBD_MS_OS_StringDescriptor);return USBD_MS_OS_StringDescriptor;} else if (USBD_IDX_ODRIVE_INTF_STR index) {USBD_GetString((uint8_t *)USBD_PRODUCT_XSTR(NATIVE_STRING), USBD_StrDesc, length);return USBD_StrDesc;} */if (USBD_IDX_CDC_INTF_STR index) {USBD_GetString((uint8_t *)USBD_CDC_INTERFACE_STRING_FS, USBD_CMPSIT_StrDesc, length);return USBD_CMPSIT_StrDesc;} else if (USBD_IDX_MSC_INTF_STR index) { USBD_GetString((uint8_t *)USBD_MSC_INTERFACE_STRING_FS, USBD_CMPSIT_StrDesc, length);return USBD_CMPSIT_StrDesc;} else if (USBD_IDX_AUDIO_INTF_STR index) { USBD_GetString((uint8_t *)USBD_AUDIO_INTERFACE_STRING_FS, USBD_CMPSIT_StrDesc, length);return USBD_CMPSIT_StrDesc;} return NULL;
}static uint8_t *USBD_CMPSIT_GetFSCfgDesc(uint16_t *length)
{*length (uint16_t)sizeof(USBD_CMPSIT_CfgDesc);USBD_LOG(USBD_CMPSIT_GetFSCfgDesc length %d\r\n, *length);return USBD_CMPSIT_CfgDesc;
}
static uint8_t *USBD_CMPSIT_GetHSCfgDesc(uint16_t *length)
{USBD_LOG(USBD_CMPSIT_GetHSCfgDesc length %d\r\n, *length);return NULL;
}
static uint8_t *USBD_CMPSIT_GetOtherSpeedCfgDesc(uint16_t *length)
{*length (uint16_t)sizeof(USBD_CMPSIT_CfgDesc);USBD_LOG(USBD_CMPSIT_GetOtherSpeedCfgDesc length %d\r\n, *length);return USBD_CMPSIT_CfgDesc;
}
uint8_t *USBD_CMPSIT_GetDeviceQualifierDescriptor(uint16_t *length)
{*length (uint16_t)sizeof(USBD_CMPSIT_DeviceQualifierDesc);USBD_LOG(USBD_CMPSIT_GetDeviceQualifierDescriptor length %d\r\n, *length);return USBD_CMPSIT_DeviceQualifierDesc;
}#ifdef USE_USBD_COMPOSITE
uint8_t USBD_get_composite_class_id(USBD_HandleTypeDef *pdev, uint8_t classType)
{for (uint8_t i 0; i USBD_MAX_SUPPORTED_CLASS; i){if (pdev-tclasslist[i].ClassType classType){return i;}}return 0xFF;
}uint8_t USBD_CMPST_ClearConfDesc(USBD_HandleTypeDef *pdev)
{UNUSED(pdev);return (uint8_t)USBD_OK;
}
#endif usbd_composite.h内容如下
#ifndef USBD_COMPOSITE_H
#define USBD_COMPOSITE_H
#include usbd_def.h
#include usbd_cdc.h
#include usbd_msc.h
#include usbd_audio.h
#include usbd_conf.h#define USBD_IDX_CDC_INTF_STR 0x06
#define USBD_IDX_MSC_INTF_STR 0x07
#define USBD_IDX_AUDIO_INTF_STR 0x08/* Derived counts and sizes */
#define USBD_CMPSIT_NUM_INTERFACES (USBD_AUDIO_INTERFACES_NUM USBD_MSC_INTERFACES_NUM USBD_CDC_INTERFACES_NUM)#define USB_CMPSIT_CONFIG_DESC_SIZ (9 USB_CMPSIT_AUDIO_CONFIG_DESC_SIZ USB_CMPSIT_CDC_CONFIG_DESC_SIZ USB_CMPSIT_MSC_CONFIG_DESC_SIZ)#define CDC_COMM_ITF_NBR 0x00U
#define CDC_DATA_ITF_NBR 0x01U
#define MSC_STD_ITF_NBR 0x02U
#define AUDIO_SPKR_AC_ITF_NBR 0x03U
#define AUDIO_SPKR_AS_ITF_NBR 0x04U
#define AUDIO_SPKR_STR_DESC_IDX 0x00U
#define AUDIO_STREAMING_CTRL 0x02Uextern USBD_ClassTypeDef USBD_CMPSIT;
extern USBD_DescriptorsTypeDef usbCmpsitFS_Desc;
#ifdef USE_USBD_COMPOSITE
void USBD_CMPSIT_AddClass(USBD_HandleTypeDef *pdev, USBD_ClassTypeDef *pclass, USBD_CompositeClassTypeDef classtype, uint8_t *EpAddr);
uint8_t USBD_get_composite_class_id(USBD_HandleTypeDef *pdev, uint8_t classType);
#endif
#endif
9. 修改初始化函数
最后一步是在 USB_DEVICE\App\usb_device.c 中调整 MX_USB_DEVICE_Init() 的实现确保复合设备的类注册和初始化顺序正确。
void MX_USB_DEVICE_Init(void)
{/* USER CODE BEGIN USB_DEVICE_Init_PreTreatment */if (USBD_Init(hUsbDeviceFS, FS_Desc, DEVICE_FS) ! USBD_OK){log_debug(USB init error\n);Error_Handler();}#ifdef USE_USBD_COMPOSITE
#if USBD_CDC_CMPSIT_ENABLEif(USBD_CDC_RegisterInterface(hUsbDeviceFS, USBD_Interface_fops_FS) ! USBD_OK){log_debug(USBD_CDC_RegisterInterface error\n);Error_Handler();}if(USBD_RegisterClassComposite(hUsbDeviceFS, USBD_CDC,CLASS_TYPE_CDC,0) ! USBD_OK){log_debug(USBD_RegisterClassComposite USBD_CDC error\n);Error_Handler();}
#endif #if USBD_MSC_CMPSIT_ENABLEif (USBD_MSC_RegisterStorage(hUsbDeviceFS, USBD_Storage_Interface_fops_FS) ! USBD_OK){log_debug(USBD_MSC_RegisterStorage error\n);Error_Handler();}if(USBD_RegisterClassComposite(hUsbDeviceFS, USBD_MSC,CLASS_TYPE_MSC,0) ! USBD_OK){log_debug(USBD_RegisterClassComposite USBD_MSC error\n);Error_Handler();}
#endif#if USBD_AUDIO_CMPSIT_ENABLEif (USBD_AUDIO_RegisterInterface(hUsbDeviceFS, USBD_AUDIO_fops_FS) ! USBD_OK){log_debug(USBD_MSC_RegisterStorage error\n);Error_Handler();}if(USBD_RegisterClassComposite(hUsbDeviceFS, USBD_AUDIO,CLASS_TYPE_AUDIO,0) ! USBD_OK){log_debug(USBD_RegisterClassComposite USBD_MSC error\n);Error_Handler();}#endifif (USBD_Start(hUsbDeviceFS) ! USBD_OK){log_debug(USBD_Start error\n);Error_Handler();}return;
#endif/* USER CODE END USB_DEVICE_Init_PreTreatment *//* Init Device Library, add supported class and start the library. *//* USER CODE BEGIN USB_DEVICE_Init_PostTreatment *//* USER CODE END USB_DEVICE_Init_PostTreatment */
}/*** }*//*** }*/完成以上修改后复合设备的代码就准备好了。编译并下载到开发板后电脑端即可同时识别出 CDC、MSC 和 Audio 三个 USB 功能。
