/** ****************************************************************************** * @file usbd_audio.c * @author MCD Application Team * @brief This file provides the Audio core functions. * * ****************************************************************************** * @attention * * Copyright (c) 2015 STMicroelectronics. * All rights reserved. * * This software is licensed under terms that can be found in the LICENSE file * in the root directory of this software component. * If no LICENSE file comes with this software, it is provided AS-IS. * ****************************************************************************** * @verbatim * * =================================================================== * AUDIO Class Description * =================================================================== * This driver manages the Audio Class 1.0 following the "USB Device Class Definition for * Audio Devices V1.0 Mar 18, 98". * This driver implements the following aspects of the specification: * - Device descriptor management * - Configuration descriptor management * - Standard AC Interface Descriptor management * - 1 Audio Streaming Interface (with single channel, PCM, Stereo mode) * - 1 Audio Streaming Endpoint * - 1 Audio Terminal Input (1 channel) * - Audio Class-Specific AC Interfaces * - Audio Class-Specific AS Interfaces * - AudioControl Requests: only SET_CUR and GET_CUR requests are supported (for Mute) * - Audio Feature Unit (limited to Mute control) * - Audio Synchronization type: Asynchronous * - Single fixed audio sampling rate (configurable in usbd_conf.h file) * The current audio class version supports the following audio features: * - Pulse Coded Modulation (PCM) format * - sampling rate: 48KHz. * - Bit resolution: 16 * - Number of channels: 2 * - No volume control * - Mute/Unmute capability * - Asynchronous Endpoints * * @note In HS mode and when the DMA is used, all variables and data structures * dealing with the DMA during the transaction process should be 32-bit aligned. * * * @endverbatim ****************************************************************************** *//* ... */ /* BSPDependencies - "stm32xxxxx_{eval}{discovery}.c" - "stm32xxxxx_{eval}{discovery}_io.c" - "stm32xxxxx_{eval}{discovery}_audio.c" EndBSPDependencies *//* ... */ /* Includes ------------------------------------------------------------------*/ #include "usbd_audio.h" #include "usbd_ctlreq.h" /** @addtogroup STM32_USB_DEVICE_LIBRARY * @{ *//* ... */ /** @defgroup USBD_AUDIO * @brief usbd core module * @{ *//* ... */ /** @defgroup USBD_AUDIO_Private_TypesDefinitions * @{ *//* ... */ /** * @} *//* ... */ /** @defgroup USBD_AUDIO_Private_Defines * @{ *//* ... */ /** * @} *//* ... */ /** @defgroup USBD_AUDIO_Private_Macros * @{ *//* ... */ #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 */ /** * @} *//* ... */ /** @defgroup USBD_AUDIO_Private_FunctionPrototypes * @{ *//* ... */ static uint8_t USBD_AUDIO_Init(USBD_HandleTypeDef *pdev, uint8_t cfgidx); static uint8_t USBD_AUDIO_DeInit(USBD_HandleTypeDef *pdev, uint8_t cfgidx); static uint8_t USBD_AUDIO_Setup(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req); #ifndef USE_USBD_COMPOSITE static uint8_t *USBD_AUDIO_GetCfgDesc(uint16_t *length); static uint8_t *USBD_AUDIO_GetDeviceQualifierDesc(uint16_t *length);/* ... */ #endif /* USE_USBD_COMPOSITE */ static uint8_t USBD_AUDIO_DataIn(USBD_HandleTypeDef *pdev, uint8_t epnum); static uint8_t USBD_AUDIO_DataOut(USBD_HandleTypeDef *pdev, uint8_t epnum); static uint8_t USBD_AUDIO_EP0_RxReady(USBD_HandleTypeDef *pdev); static uint8_t USBD_AUDIO_EP0_TxReady(USBD_HandleTypeDef *pdev); static uint8_t USBD_AUDIO_SOF(USBD_HandleTypeDef *pdev); static uint8_t USBD_AUDIO_IsoINIncomplete(USBD_HandleTypeDef *pdev, uint8_t epnum); static uint8_t USBD_AUDIO_IsoOutIncomplete(USBD_HandleTypeDef *pdev, uint8_t epnum); static void AUDIO_REQ_GetCurrent(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req); static void AUDIO_REQ_SetCurrent(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req); static void *USBD_AUDIO_GetAudioHeaderDesc(uint8_t *pConfDesc); /** * @} *//* ... */ /** @defgroup USBD_AUDIO_Private_Variables * @{ *//* ... */ USBD_ClassTypeDef USBD_AUDIO = { USBD_AUDIO_Init, USBD_AUDIO_DeInit, USBD_AUDIO_Setup, USBD_AUDIO_EP0_TxReady, USBD_AUDIO_EP0_RxReady, USBD_AUDIO_DataIn, USBD_AUDIO_DataOut, USBD_AUDIO_SOF, USBD_AUDIO_IsoINIncomplete, USBD_AUDIO_IsoOutIncomplete, #ifdef USE_USBD_COMPOSITE NULL, NULL, NULL, NULL,/* ... */ #else USBD_AUDIO_GetCfgDesc, USBD_AUDIO_GetCfgDesc, USBD_AUDIO_GetCfgDesc, USBD_AUDIO_GetDeviceQualifierDesc,/* ... */ #endif /* USE_USBD_COMPOSITE */ ...}; #ifndef USE_USBD_COMPOSITE /* USB AUDIO device Configuration Descriptor */ __ALIGN_BEGIN static uint8_t USBD_AUDIO_CfgDesc[USB_AUDIO_CONFIG_DESC_SIZ] __ALIGN_END = { /* Configuration 1 */ 0x09, /* bLength */ USB_DESC_TYPE_CONFIGURATION, /* bDescriptorType */ LOBYTE(USB_AUDIO_CONFIG_DESC_SIZ), /* wTotalLength */ HIBYTE(USB_AUDIO_CONFIG_DESC_SIZ), 0x02, /* bNumInterfaces */ 0x01, /* bConfigurationValue */ 0x00, /* iConfiguration */ #if (USBD_SELF_POWERED == 1U) 0xC0, /* bmAttributes: Bus Powered according to user configuration */ #else 0x80, /* bmAttributes: Bus Powered according to user configuration */ #endif /* USBD_SELF_POWERED */ USBD_MAX_POWER, /* MaxPower (mA) */ /* 09 byte*/ /* USB Speaker Standard interface descriptor */ AUDIO_INTERFACE_DESC_SIZE, /* bLength */ USB_DESC_TYPE_INTERFACE, /* bDescriptorType */ 0x00, /* bInterfaceNumber */ 0x00, /* bAlternateSetting */ 0x00, /* bNumEndpoints */ USB_DEVICE_CLASS_AUDIO, /* bInterfaceClass */ AUDIO_SUBCLASS_AUDIOCONTROL, /* bInterfaceSubClass */ AUDIO_PROTOCOL_UNDEFINED, /* bInterfaceProtocol */ 0x00, /* 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 */ 0x00, 0x01, /* bInCollection */ 0x01, /* 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_OUT_STREAMING_CTRL, /* bUnitID */ 0x01, /* bSourceID */ 0x01, /* bControlSize */ AUDIO_CONTROL_MUTE, /* bmaControls(0) */ 0, /* 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 */ 0x01, /* 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 */ 0x01, /* 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*/ ...} ; /* USB Standard Device Descriptor */ __ALIGN_BEGIN static uint8_t USBD_AUDIO_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, ...};/* ... */ #endif /* USE_USBD_COMPOSITE */ static uint8_t AUDIOOutEpAdd = AUDIO_OUT_EP; /** * @} *//* ... */ /** @defgroup USBD_AUDIO_Private_Functions * @{ *//* ... */ /** * @brief USBD_AUDIO_Init * Initialize the AUDIO interface * @param pdev: device instance * @param cfgidx: Configuration index * @retval status *//* ... */ static uint8_t USBD_AUDIO_Init(USBD_HandleTypeDef *pdev, uint8_t cfgidx) { UNUSED(cfgidx); USBD_AUDIO_HandleTypeDef *haudio; /* Allocate Audio structure */ haudio = (USBD_AUDIO_HandleTypeDef *)USBD_malloc(sizeof(USBD_AUDIO_HandleTypeDef)); if (haudio == NULL) { pdev->pClassDataCmsit[pdev->classId] = NULL; return (uint8_t)USBD_EMEM; }if (haudio == NULL) { ... } pdev->pClassDataCmsit[pdev->classId] = (void *)haudio; pdev->pClassData = pdev->pClassDataCmsit[pdev->classId]; #ifdef USE_USBD_COMPOSITE /* Get the Endpoints addresses allocated for this class instance */ AUDIOOutEpAdd = USBD_CoreGetEPAdd(pdev, USBD_EP_OUT, USBD_EP_TYPE_ISOC, (uint8_t)pdev->classId);/* ... */ #endif /* USE_USBD_COMPOSITE */ if (pdev->dev_speed == USBD_SPEED_HIGH) { pdev->ep_out[AUDIOOutEpAdd & 0xFU].bInterval = AUDIO_HS_BINTERVAL; }if (pdev->dev_speed == USBD_SPEED_HIGH) { ... } else /* LOW and FULL-speed endpoints */ { pdev->ep_out[AUDIOOutEpAdd & 0xFU].bInterval = AUDIO_FS_BINTERVAL; }else { ... } /* Open EP OUT */ (void)USBD_LL_OpenEP(pdev, AUDIOOutEpAdd, USBD_EP_TYPE_ISOC, AUDIO_OUT_PACKET); pdev->ep_out[AUDIOOutEpAdd & 0xFU].is_used = 1U; haudio->alt_setting = 0U; haudio->offset = AUDIO_OFFSET_UNKNOWN; haudio->wr_ptr = 0U; haudio->rd_ptr = 0U; haudio->rd_enable = 0U; /* Initialize the Audio output Hardware layer */ if (((USBD_AUDIO_ItfTypeDef *)pdev->pUserData[pdev->classId])->Init(USBD_AUDIO_FREQ, AUDIO_DEFAULT_VOLUME, 0U) != 0U) { return (uint8_t)USBD_FAIL; }if (((USBD_AUDIO_ItfTypeDef *)pdev->pUserData[pdev->classId])->Init(USBD_AUDIO_FREQ, AUDIO_DEFAULT_VOLUME, 0U) != 0U) { ... } /* Prepare Out endpoint to receive 1st packet */ (void)USBD_LL_PrepareReceive(pdev, AUDIOOutEpAdd, haudio->buffer, AUDIO_OUT_PACKET); return (uint8_t)USBD_OK; }{ ... } /** * @brief USBD_AUDIO_Init * DeInitialize the AUDIO layer * @param pdev: device instance * @param cfgidx: Configuration index * @retval status *//* ... */ static uint8_t USBD_AUDIO_DeInit(USBD_HandleTypeDef *pdev, uint8_t cfgidx) { UNUSED(cfgidx); #ifdef USE_USBD_COMPOSITE /* Get the Endpoints addresses allocated for this class instance */ AUDIOOutEpAdd = USBD_CoreGetEPAdd(pdev, USBD_EP_OUT, USBD_EP_TYPE_ISOC, (uint8_t)pdev->classId);/* ... */ #endif /* USE_USBD_COMPOSITE */ /* Open EP OUT */ (void)USBD_LL_CloseEP(pdev, AUDIOOutEpAdd); pdev->ep_out[AUDIOOutEpAdd & 0xFU].is_used = 0U; pdev->ep_out[AUDIOOutEpAdd & 0xFU].bInterval = 0U; /* DeInit physical Interface components */ if (pdev->pClassDataCmsit[pdev->classId] != NULL) { ((USBD_AUDIO_ItfTypeDef *)pdev->pUserData[pdev->classId])->DeInit(0U); (void)USBD_free(pdev->pClassDataCmsit[pdev->classId]); pdev->pClassDataCmsit[pdev->classId] = NULL; pdev->pClassData = NULL; }if (pdev->pClassDataCmsit[pdev->classId] != NULL) { ... } return (uint8_t)USBD_OK; }{ ... } /** * @brief USBD_AUDIO_Setup * Handle the AUDIO specific requests * @param pdev: instance * @param req: usb requests * @retval status *//* ... */ static uint8_t USBD_AUDIO_Setup(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { USBD_AUDIO_HandleTypeDef *haudio; uint16_t len; uint8_t *pbuf; uint16_t status_info = 0U; USBD_StatusTypeDef ret = USBD_OK; haudio = (USBD_AUDIO_HandleTypeDef *)pdev->pClassDataCmsit[pdev->classId]; if (haudio == NULL) { return (uint8_t)USBD_FAIL; }if (haudio == NULL) { ... } switch (req->bmRequest & USB_REQ_TYPE_MASK) { case USB_REQ_TYPE_CLASS: switch (req->bRequest) { case AUDIO_REQ_GET_CUR: AUDIO_REQ_GetCurrent(pdev, req); break; case AUDIO_REQ_GET_CUR: case AUDIO_REQ_SET_CUR: AUDIO_REQ_SetCurrent(pdev, req); break; case AUDIO_REQ_SET_CUR: default: USBD_CtlError(pdev, req); ret = USBD_FAIL; break;default }switch (req->bRequest) { ... } break; case USB_REQ_TYPE_CLASS: case USB_REQ_TYPE_STANDARD: switch (req->bRequest) { case USB_REQ_GET_STATUS: if (pdev->dev_state == USBD_STATE_CONFIGURED) { (void)USBD_CtlSendData(pdev, (uint8_t *)&status_info, 2U); }if (pdev->dev_state == USBD_STATE_CONFIGURED) { ... } else { USBD_CtlError(pdev, req); ret = USBD_FAIL; }else { ... } break; case USB_REQ_GET_STATUS: case USB_REQ_GET_DESCRIPTOR: if ((req->wValue >> 8) == AUDIO_DESCRIPTOR_TYPE) { pbuf = (uint8_t *)USBD_AUDIO_GetAudioHeaderDesc(pdev->pConfDesc); if (pbuf != NULL) { len = MIN(USB_AUDIO_DESC_SIZ, req->wLength); (void)USBD_CtlSendData(pdev, pbuf, len); }if (pbuf != NULL) { ... } else { USBD_CtlError(pdev, req); ret = USBD_FAIL; }else { ... } }if ((req->wValue >> 8) == AUDIO_DESCRIPTOR_TYPE) { ... } break; case USB_REQ_GET_DESCRIPTOR: case USB_REQ_GET_INTERFACE: if (pdev->dev_state == USBD_STATE_CONFIGURED) { (void)USBD_CtlSendData(pdev, (uint8_t *)&haudio->alt_setting, 1U); }if (pdev->dev_state == USBD_STATE_CONFIGURED) { ... } else { USBD_CtlError(pdev, req); ret = USBD_FAIL; }else { ... } break; case USB_REQ_GET_INTERFACE: case USB_REQ_SET_INTERFACE: if (pdev->dev_state == USBD_STATE_CONFIGURED) { if ((uint8_t)(req->wValue) <= USBD_MAX_NUM_INTERFACES) { haudio->alt_setting = (uint8_t)(req->wValue); }if ((uint8_t)(req->wValue) <= USBD_MAX_NUM_INTERFACES) { ... } else { /* Call the error management function (command will be NAKed */ USBD_CtlError(pdev, req); ret = USBD_FAIL; }else { ... } }if (pdev->dev_state == USBD_STATE_CONFIGURED) { ... } else { USBD_CtlError(pdev, req); ret = USBD_FAIL; }else { ... } break; case USB_REQ_SET_INTERFACE: case USB_REQ_CLEAR_FEATURE: break; case USB_REQ_CLEAR_FEATURE: default: USBD_CtlError(pdev, req); ret = USBD_FAIL; break;default }switch (req->bRequest) { ... } break;case USB_REQ_TYPE_STANDARD: default: USBD_CtlError(pdev, req); ret = USBD_FAIL; break;default }switch (req->bmRequest & USB_REQ_TYPE_MASK) { ... } return (uint8_t)ret; }{ ... } #ifndef USE_USBD_COMPOSITE /** * @brief USBD_AUDIO_GetCfgDesc * return configuration descriptor * @param length : pointer data length * @retval pointer to descriptor buffer *//* ... */ static uint8_t *USBD_AUDIO_GetCfgDesc(uint16_t *length) { *length = (uint16_t)sizeof(USBD_AUDIO_CfgDesc); return USBD_AUDIO_CfgDesc; }{ ... } #endif/* ... */ /* USE_USBD_COMPOSITE */ /** * @brief USBD_AUDIO_DataIn * handle data IN Stage * @param pdev: device instance * @param epnum: endpoint index * @retval status *//* ... */ static uint8_t USBD_AUDIO_DataIn(USBD_HandleTypeDef *pdev, uint8_t epnum) { UNUSED(pdev); UNUSED(epnum); /* Only OUT data are processed */ return (uint8_t)USBD_OK; }{ ... } /** * @brief USBD_AUDIO_EP0_RxReady * handle EP0 Rx Ready event * @param pdev: device instance * @retval status *//* ... */ static uint8_t USBD_AUDIO_EP0_RxReady(USBD_HandleTypeDef *pdev) { USBD_AUDIO_HandleTypeDef *haudio; haudio = (USBD_AUDIO_HandleTypeDef *)pdev->pClassDataCmsit[pdev->classId]; if (haudio == NULL) { return (uint8_t)USBD_FAIL; }if (haudio == NULL) { ... } if (haudio->control.cmd == AUDIO_REQ_SET_CUR) { /* In this driver, to simplify code, only SET_CUR request is managed */ if (haudio->control.unit == AUDIO_OUT_STREAMING_CTRL) { ((USBD_AUDIO_ItfTypeDef *)pdev->pUserData[pdev->classId])->MuteCtl(haudio->control.data[0]); haudio->control.cmd = 0U; haudio->control.len = 0U; }if (haudio->control.unit == AUDIO_OUT_STREAMING_CTRL) { ... } }if (haudio->control.cmd == AUDIO_REQ_SET_CUR) { ... } return (uint8_t)USBD_OK; }{ ... } /** * @brief USBD_AUDIO_EP0_TxReady * handle EP0 TRx Ready event * @param pdev: device instance * @retval status *//* ... */ static uint8_t USBD_AUDIO_EP0_TxReady(USBD_HandleTypeDef *pdev) { UNUSED(pdev); /* Only OUT control data are processed */ return (uint8_t)USBD_OK; }{ ... } /** * @brief USBD_AUDIO_SOF * handle SOF event * @param pdev: device instance * @retval status *//* ... */ static uint8_t USBD_AUDIO_SOF(USBD_HandleTypeDef *pdev) { UNUSED(pdev); return (uint8_t)USBD_OK; }{ ... } /** * @brief USBD_AUDIO_SOF * handle SOF event * @param pdev: device instance * @param offset: audio offset * @retval status *//* ... */ void USBD_AUDIO_Sync(USBD_HandleTypeDef *pdev, AUDIO_OffsetTypeDef offset) { USBD_AUDIO_HandleTypeDef *haudio; uint32_t BufferSize = AUDIO_TOTAL_BUF_SIZE / 2U; if (pdev->pClassDataCmsit[pdev->classId] == NULL) { return; }if (pdev->pClassDataCmsit[pdev->classId] == NULL) { ... } haudio = (USBD_AUDIO_HandleTypeDef *)pdev->pClassDataCmsit[pdev->classId]; haudio->offset = offset; if (haudio->rd_enable == 1U) { haudio->rd_ptr += (uint16_t)BufferSize; if (haudio->rd_ptr == AUDIO_TOTAL_BUF_SIZE) { /* roll back */ haudio->rd_ptr = 0U; }if (haudio->rd_ptr == AUDIO_TOTAL_BUF_SIZE) { ... } }if (haudio->rd_enable == 1U) { ... } if (haudio->rd_ptr > haudio->wr_ptr) { if ((haudio->rd_ptr - haudio->wr_ptr) < AUDIO_OUT_PACKET) { BufferSize += 4U; }if ((haudio->rd_ptr - haudio->wr_ptr) < AUDIO_OUT_PACKET) { ... } else { if ((haudio->rd_ptr - haudio->wr_ptr) > (AUDIO_TOTAL_BUF_SIZE - AUDIO_OUT_PACKET)) { BufferSize -= 4U; }if ((haudio->rd_ptr - haudio->wr_ptr) > (AUDIO_TOTAL_BUF_SIZE - AUDIO_OUT_PACKET)) { ... } }else { ... } }if (haudio->rd_ptr > haudio->wr_ptr) { ... } else { if ((haudio->wr_ptr - haudio->rd_ptr) < AUDIO_OUT_PACKET) { BufferSize -= 4U; }if ((haudio->wr_ptr - haudio->rd_ptr) < AUDIO_OUT_PACKET) { ... } else { if ((haudio->wr_ptr - haudio->rd_ptr) > (AUDIO_TOTAL_BUF_SIZE - AUDIO_OUT_PACKET)) { BufferSize += 4U; }if ((haudio->wr_ptr - haudio->rd_ptr) > (AUDIO_TOTAL_BUF_SIZE - AUDIO_OUT_PACKET)) { ... } }else { ... } }else { ... } if (haudio->offset == AUDIO_OFFSET_FULL) { ((USBD_AUDIO_ItfTypeDef *)pdev->pUserData[pdev->classId])->AudioCmd(&haudio->buffer[0], BufferSize, AUDIO_CMD_PLAY); haudio->offset = AUDIO_OFFSET_NONE; }if (haudio->offset == AUDIO_OFFSET_FULL) { ... } }{ ... } /** * @brief USBD_AUDIO_IsoINIncomplete * handle data ISO IN Incomplete event * @param pdev: device instance * @param epnum: endpoint index * @retval status *//* ... */ static uint8_t USBD_AUDIO_IsoINIncomplete(USBD_HandleTypeDef *pdev, uint8_t epnum) { UNUSED(pdev); UNUSED(epnum); return (uint8_t)USBD_OK; }{ ... } /** * @brief USBD_AUDIO_IsoOutIncomplete * handle data ISO OUT Incomplete event * @param pdev: device instance * @param epnum: endpoint index * @retval status *//* ... */ static uint8_t USBD_AUDIO_IsoOutIncomplete(USBD_HandleTypeDef *pdev, uint8_t epnum) { USBD_AUDIO_HandleTypeDef *haudio; if (pdev->pClassDataCmsit[pdev->classId] == NULL) { return (uint8_t)USBD_FAIL; }if (pdev->pClassDataCmsit[pdev->classId] == NULL) { ... } haudio = (USBD_AUDIO_HandleTypeDef *)pdev->pClassDataCmsit[pdev->classId]; /* Prepare Out endpoint to receive next audio packet */ (void)USBD_LL_PrepareReceive(pdev, epnum, &haudio->buffer[haudio->wr_ptr], AUDIO_OUT_PACKET); return (uint8_t)USBD_OK; }{ ... } /** * @brief USBD_AUDIO_DataOut * handle data OUT Stage * @param pdev: device instance * @param epnum: endpoint index * @retval status *//* ... */ static uint8_t USBD_AUDIO_DataOut(USBD_HandleTypeDef *pdev, uint8_t epnum) { uint16_t PacketSize; USBD_AUDIO_HandleTypeDef *haudio; #ifdef USE_USBD_COMPOSITE /* Get the Endpoints addresses allocated for this class instance */ AUDIOOutEpAdd = USBD_CoreGetEPAdd(pdev, USBD_EP_OUT, USBD_EP_TYPE_ISOC, (uint8_t)pdev->classId);/* ... */ #endif /* USE_USBD_COMPOSITE */ haudio = (USBD_AUDIO_HandleTypeDef *)pdev->pClassDataCmsit[pdev->classId]; if (haudio == NULL) { return (uint8_t)USBD_FAIL; }if (haudio == NULL) { ... } if (epnum == AUDIOOutEpAdd) { /* Get received data packet length */ PacketSize = (uint16_t)USBD_LL_GetRxDataSize(pdev, epnum); /* Packet received Callback */ ((USBD_AUDIO_ItfTypeDef *)pdev->pUserData[pdev->classId])->PeriodicTC(&haudio->buffer[haudio->wr_ptr], PacketSize, AUDIO_OUT_TC); /* Increment the Buffer pointer or roll it back when all buffers are full */ haudio->wr_ptr += PacketSize; if (haudio->wr_ptr >= AUDIO_TOTAL_BUF_SIZE) { /* All buffers are full: roll back */ haudio->wr_ptr = 0U; if (haudio->offset == AUDIO_OFFSET_UNKNOWN) { ((USBD_AUDIO_ItfTypeDef *)pdev->pUserData[pdev->classId])->AudioCmd(&haudio->buffer[0], AUDIO_TOTAL_BUF_SIZE / 2U, AUDIO_CMD_START); haudio->offset = AUDIO_OFFSET_NONE; }if (haudio->offset == AUDIO_OFFSET_UNKNOWN) { ... } }if (haudio->wr_ptr >= AUDIO_TOTAL_BUF_SIZE) { ... } if (haudio->rd_enable == 0U) { if (haudio->wr_ptr == (AUDIO_TOTAL_BUF_SIZE / 2U)) { haudio->rd_enable = 1U; }if (haudio->wr_ptr == (AUDIO_TOTAL_BUF_SIZE / 2U)) { ... } }if (haudio->rd_enable == 0U) { ... } /* Prepare Out endpoint to receive next audio packet */ (void)USBD_LL_PrepareReceive(pdev, AUDIOOutEpAdd, &haudio->buffer[haudio->wr_ptr], AUDIO_OUT_PACKET); }if (epnum == AUDIOOutEpAdd) { ... } return (uint8_t)USBD_OK; }{ ... } /** * @brief AUDIO_Req_GetCurrent * Handles the GET_CUR Audio control request. * @param pdev: device instance * @param req: setup class request * @retval status *//* ... */ static void AUDIO_REQ_GetCurrent(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { USBD_AUDIO_HandleTypeDef *haudio; haudio = (USBD_AUDIO_HandleTypeDef *)pdev->pClassDataCmsit[pdev->classId]; if (haudio == NULL) { return; }if (haudio == NULL) { ... } (void)USBD_memset(haudio->control.data, 0, USB_MAX_EP0_SIZE); /* Send the current mute state */ (void)USBD_CtlSendData(pdev, haudio->control.data, MIN(req->wLength, USB_MAX_EP0_SIZE)); }{ ... } /** * @brief AUDIO_Req_SetCurrent * Handles the SET_CUR Audio control request. * @param pdev: device instance * @param req: setup class request * @retval status *//* ... */ static void AUDIO_REQ_SetCurrent(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { USBD_AUDIO_HandleTypeDef *haudio; haudio = (USBD_AUDIO_HandleTypeDef *)pdev->pClassDataCmsit[pdev->classId]; if (haudio == NULL) { return; }if (haudio == NULL) { ... } if (req->wLength != 0U) { haudio->control.cmd = AUDIO_REQ_SET_CUR; /* Set the request value */ haudio->control.len = (uint8_t)MIN(req->wLength, USB_MAX_EP0_SIZE); /* Set the request data length */ haudio->control.unit = HIBYTE(req->wIndex); /* Set the request target unit */ /* Prepare the reception of the buffer over EP0 */ (void)USBD_CtlPrepareRx(pdev, haudio->control.data, haudio->control.len); }if (req->wLength != 0U) { ... } }{ ... } #ifndef USE_USBD_COMPOSITE /** * @brief DeviceQualifierDescriptor * return Device Qualifier descriptor * @param length : pointer data length * @retval pointer to descriptor buffer *//* ... */ static uint8_t *USBD_AUDIO_GetDeviceQualifierDesc(uint16_t *length) { *length = (uint16_t)sizeof(USBD_AUDIO_DeviceQualifierDesc); return USBD_AUDIO_DeviceQualifierDesc; }{ ... } #endif/* ... */ /* USE_USBD_COMPOSITE */ /** * @brief USBD_AUDIO_RegisterInterface * @param pdev: device instance * @param fops: Audio interface callback * @retval status *//* ... */ uint8_t USBD_AUDIO_RegisterInterface(USBD_HandleTypeDef *pdev, USBD_AUDIO_ItfTypeDef *fops) { if (fops == NULL) { return (uint8_t)USBD_FAIL; }if (fops == NULL) { ... } pdev->pUserData[pdev->classId] = fops; return (uint8_t)USBD_OK; }{ ... } #ifdef USE_USBD_COMPOSITE /** * @brief USBD_AUDIO_GetEpPcktSze * @param pdev: device instance (reserved for future use) * @param If: Interface number (reserved for future use) * @param Ep: Endpoint number (reserved for future use) * @retval status *//* ... */ uint32_t USBD_AUDIO_GetEpPcktSze(USBD_HandleTypeDef *pdev, uint8_t If, uint8_t Ep) { uint32_t mps; UNUSED(pdev); UNUSED(If); UNUSED(Ep); mps = AUDIO_PACKET_SZE_WORD(USBD_AUDIO_FREQ); /* Return the wMaxPacketSize value in Bytes (Freq(Samples)*2(Stereo)*2(HalfWord)) */ return mps; }USBD_AUDIO_GetEpPcktSze (USBD_HandleTypeDef *pdev, uint8_t If, uint8_t Ep) { ... } /* ... */#endif /* USE_USBD_COMPOSITE */ /** * @brief USBD_AUDIO_GetAudioHeaderDesc * This function return the Audio descriptor * @param pdev: device instance * @param pConfDesc: pointer to Bos descriptor * @retval pointer to the Audio AC Header descriptor *//* ... */ static void *USBD_AUDIO_GetAudioHeaderDesc(uint8_t *pConfDesc) { USBD_ConfigDescTypeDef *desc = (USBD_ConfigDescTypeDef *)(void *)pConfDesc; USBD_DescHeaderTypeDef *pdesc = (USBD_DescHeaderTypeDef *)(void *)pConfDesc; uint8_t *pAudioDesc = NULL; uint16_t ptr; if (desc->wTotalLength > desc->bLength) { ptr = desc->bLength; while (ptr < desc->wTotalLength) { pdesc = USBD_GetNextDesc((uint8_t *)pdesc, &ptr); if ((pdesc->bDescriptorType == AUDIO_INTERFACE_DESCRIPTOR_TYPE) && (pdesc->bDescriptorSubType == AUDIO_CONTROL_HEADER)) { pAudioDesc = (uint8_t *)pdesc; break; }if ((pdesc->bDescriptorType == AUDIO_INTERFACE_DESCRIPTOR_TYPE) && (pdesc->bDescriptorSubType == AUDIO_CONTROL_HEADER)) { ... } }while (ptr < desc->wTotalLength) { ... } }if (desc->wTotalLength > desc->bLength) { ... } return pAudioDesc; }{ ... } /** * @} *//* ... */ /** * @} *//* ... */ /** * @} *//* ... */