From 0b06460a43c30670a764cb7e58c5a7918e789f6e Mon Sep 17 00:00:00 2001 From: Rania JMAI Date: Thu, 16 May 2024 14:38:40 +0100 Subject: [PATCH] Release v2.11.3 --- Class/CustomHID/Src/usbd_customhid.c | 10 +- Class/DFU/Src/usbd_dfu.c | 52 ++- Core/Src/usbd_core.c | 31 +- Core/Src/usbd_ctlreq.c | 20 +- Release_Notes.html | 29 ++ Release_Notes.md | 545 --------------------------- 6 files changed, 113 insertions(+), 574 deletions(-) delete mode 100644 Release_Notes.md diff --git a/Class/CustomHID/Src/usbd_customhid.c b/Class/CustomHID/Src/usbd_customhid.c index 8207618..c64ba99 100644 --- a/Class/CustomHID/Src/usbd_customhid.c +++ b/Class/CustomHID/Src/usbd_customhid.c @@ -479,7 +479,15 @@ static uint8_t USBD_CUSTOM_HID_Setup(USBD_HandleTypeDef *pdev, } } - (void)USBD_CtlSendData(pdev, pbuf, len); + if (pbuf != NULL) + { + (void)USBD_CtlSendData(pdev, pbuf, len); + } + else + { + USBD_CtlError(pdev, req); + ret = USBD_FAIL; + } break; case USB_REQ_GET_INTERFACE: diff --git a/Class/DFU/Src/usbd_dfu.c b/Class/DFU/Src/usbd_dfu.c index 3a1b29e..67ba12c 100644 --- a/Class/DFU/Src/usbd_dfu.c +++ b/Class/DFU/Src/usbd_dfu.c @@ -512,6 +512,7 @@ static uint8_t USBD_DFU_EP0_RxReady(USBD_HandleTypeDef *pdev) return (uint8_t)USBD_OK; } + /** * @brief USBD_DFU_EP0_TxReady * handle EP0 TRx Ready event @@ -525,7 +526,7 @@ static uint8_t USBD_DFU_EP0_TxReady(USBD_HandleTypeDef *pdev) uint32_t addr; USBD_DFU_HandleTypeDef *hdfu = (USBD_DFU_HandleTypeDef *)pdev->pClassDataCmsit[pdev->classId]; USBD_DFU_MediaTypeDef *DfuInterface = (USBD_DFU_MediaTypeDef *)pdev->pUserData[pdev->classId]; -#if (USBD_DFU_VENDOR_CMD_ENABLED == 1U) +#if (USBD_DFU_VENDOR_CMD_ENABLED == 1U) || (USBD_DFU_VENDOR_CHECK_ENABLED == 1U) uint32_t VendorStatus = 0U; #endif /* USBD_DFU_VENDOR_CMD_ENABLED */ @@ -619,7 +620,6 @@ static uint8_t USBD_DFU_EP0_TxReady(USBD_HandleTypeDef *pdev) hdfu->dev_status[4] = hdfu->dev_state; return (uint8_t)USBD_FAIL; } - } #if (USBD_DFU_VENDOR_CMD_ENABLED == 1U) else @@ -647,13 +647,57 @@ static uint8_t USBD_DFU_EP0_TxReady(USBD_HandleTypeDef *pdev) } else { +#if (USBD_DFU_VENDOR_CMD_ENABLED == 1U) + if (hdfu->wlength > 0U) + { +#if (USBD_DFU_VENDOR_CHECK_ENABLED == 1U) + if (DfuInterface->VendorCheck(hdfu->buffer.d8, IS_DFU_DOWNLOAD, &VendorStatus) != USBD_OK) + { + /* Update the state machine */ + hdfu->dev_state = DFU_STATE_ERROR; + hdfu->dev_status[0] = (uint8_t)VendorStatus; + hdfu->dev_status[1] = 0U; + hdfu->dev_status[2] = 0U; + hdfu->dev_status[3] = 0U; + hdfu->dev_status[4] = hdfu->dev_state; + return (uint8_t)USBD_FAIL; + } +#endif /* USBD_DFU_VENDOR_CHECK_ENABLED */ + + /* Vendor specific DFU CMD */ + if (DfuInterface->VendorDownloadCMD(hdfu->buffer.d8, hdfu->wblock_num, + hdfu->wlength, &VendorStatus) != USBD_OK) + { + /* Update the state machine */ + hdfu->dev_state = DFU_STATE_ERROR; + hdfu->dev_status[0] = (uint8_t)VendorStatus; + hdfu->dev_status[1] = 0U; + hdfu->dev_status[2] = 0U; + hdfu->dev_status[3] = 0U; + hdfu->dev_status[4] = hdfu->dev_state; + return (uint8_t)USBD_FAIL; + } + } + else + { + /* Reset the block number */ + hdfu->wblock_num = 0U; + + /* Call the error management function (command will be NAKed) */ + req.bmRequest = 0U; + req.wLength = 1U; + USBD_CtlError(pdev, &req); + } +#else /* Reset the global length and block number */ hdfu->wlength = 0U; hdfu->wblock_num = 0U; + /* Call the error management function (command will be NAKed) */ req.bmRequest = 0U; req.wLength = 1U; USBD_CtlError(pdev, &req); +#endif /* USBD_DFU_VENDOR_CMD_ENABLED */ } } /* Regular Download Command */ @@ -856,10 +900,10 @@ static void DFU_Download(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { USBD_DFU_HandleTypeDef *hdfu = (USBD_DFU_HandleTypeDef *)pdev->pClassDataCmsit[pdev->classId]; -#if (USBD_DFU_VENDOR_CMD_ENABLED == 1U) +#if (USBD_DFU_VENDOR_CHECK_ENABLED == 1U) USBD_DFU_MediaTypeDef *DfuInterface = (USBD_DFU_MediaTypeDef *)pdev->pUserData[pdev->classId]; uint32_t VendorStatus = 0U; -#endif /* USBD_DFU_VENDOR_CMD_ENABLED */ +#endif /* USBD_DFU_VENDOR_CHECK_ENABLED */ if (hdfu == NULL) { diff --git a/Core/Src/usbd_core.c b/Core/Src/usbd_core.c index 186a309..0576c87 100644 --- a/Core/Src/usbd_core.c +++ b/Core/Src/usbd_core.c @@ -83,11 +83,11 @@ /** * @brief USBD_Init - * Initializes the device stack and load the class driver + * Initialize the device stack and load the class driver * @param pdev: device instance * @param pdesc: Descriptor structure address * @param id: Low level core index - * @retval None + * @retval status: USBD Status */ USBD_StatusTypeDef USBD_Init(USBD_HandleTypeDef *pdev, USBD_DescriptorsTypeDef *pdesc, uint8_t id) @@ -142,9 +142,9 @@ USBD_StatusTypeDef USBD_Init(USBD_HandleTypeDef *pdev, /** * @brief USBD_DeInit - * Re-Initialize the device library + * De-Initialize the device library * @param pdev: device instance - * @retval status: status + * @retval status: USBD Status */ USBD_StatusTypeDef USBD_DeInit(USBD_HandleTypeDef *pdev) { @@ -195,7 +195,7 @@ USBD_StatusTypeDef USBD_DeInit(USBD_HandleTypeDef *pdev) /** * @brief USBD_RegisterClass * Link class driver to Device Core. - * @param pDevice : Device Handle + * @param pdev: Device Handle * @param pclass: Class handle * @retval USBD Status */ @@ -228,7 +228,7 @@ USBD_StatusTypeDef USBD_RegisterClass(USBD_HandleTypeDef *pdev, USBD_ClassTypeDe #endif /* USE_USB_FS */ /* Increment the NumClasses */ - pdev->NumClasses ++; + pdev->NumClasses++; return USBD_OK; } @@ -243,10 +243,10 @@ USBD_StatusTypeDef USBD_RegisterClass(USBD_HandleTypeDef *pdev, USBD_ClassTypeDe * @param EpAddr: Endpoint Address handle * @retval USBD Status */ -USBD_StatusTypeDef USBD_RegisterClassComposite(USBD_HandleTypeDef *pdev, USBD_ClassTypeDef *pclass, - USBD_CompositeClassTypeDef classtype, uint8_t *EpAddr) +USBD_StatusTypeDef USBD_RegisterClassComposite(USBD_HandleTypeDef *pdev, USBD_ClassTypeDef *pclass, + USBD_CompositeClassTypeDef classtype, uint8_t *EpAddr) { - USBD_StatusTypeDef ret = USBD_OK; + USBD_StatusTypeDef ret = USBD_OK; uint16_t len = 0U; if ((pdev->classId < USBD_MAX_SUPPORTED_CLASS) && (pdev->NumClasses < USBD_MAX_SUPPORTED_CLASS)) @@ -291,7 +291,7 @@ USBD_StatusTypeDef USBD_RegisterClassComposite(USBD_HandleTypeDef *pdev, USBD_C /** * @brief USBD_UnRegisterClassComposite * UnLink all composite class drivers from Device Core. - * @param pDevice : Device Handle + * @param pdev: Device Handle * @retval USBD Status */ USBD_StatusTypeDef USBD_UnRegisterClassComposite(USBD_HandleTypeDef *pdev) @@ -374,6 +374,7 @@ USBD_StatusTypeDef USBD_RegisterDevStateCallback(USBD_HandleTypeDef *pdev, USBD_ return USBD_OK; } #endif /* USBD_USER_REGISTER_CALLBACK */ + /** * @brief USBD_Start * Start the USB Device Core. @@ -499,7 +500,7 @@ USBD_StatusTypeDef USBD_SetClassConfig(USBD_HandleTypeDef *pdev, uint8_t cfgidx) * Clear current configuration * @param pdev: device instance * @param cfgidx: configuration index - * @retval status: USBD_StatusTypeDef + * @retval status */ USBD_StatusTypeDef USBD_ClrClassConfig(USBD_HandleTypeDef *pdev, uint8_t cfgidx) { @@ -539,6 +540,7 @@ USBD_StatusTypeDef USBD_ClrClassConfig(USBD_HandleTypeDef *pdev, uint8_t cfgidx) * @brief USBD_LL_SetupStage * Handle the setup stage * @param pdev: device instance + * @param psetup: setup packet buffer pointer * @retval status */ USBD_StatusTypeDef USBD_LL_SetupStage(USBD_HandleTypeDef *pdev, uint8_t *psetup) @@ -673,6 +675,7 @@ USBD_StatusTypeDef USBD_LL_DataOutStage(USBD_HandleTypeDef *pdev, * Handle data in stage * @param pdev: device instance * @param epnum: endpoint index + * @param pdata: data pointer * @retval status */ USBD_StatusTypeDef USBD_LL_DataInStage(USBD_HandleTypeDef *pdev, @@ -765,7 +768,6 @@ USBD_StatusTypeDef USBD_LL_DataInStage(USBD_HandleTypeDef *pdev, * @param pdev: device instance * @retval status */ - USBD_StatusTypeDef USBD_LL_Reset(USBD_HandleTypeDef *pdev) { USBD_StatusTypeDef ret = USBD_OK; @@ -848,7 +850,6 @@ USBD_StatusTypeDef USBD_LL_SetSpeed(USBD_HandleTypeDef *pdev, * @param pdev: device instance * @retval status */ - USBD_StatusTypeDef USBD_LL_Suspend(USBD_HandleTypeDef *pdev) { if (pdev->dev_state != USBD_STATE_SUSPENDED) @@ -867,7 +868,6 @@ USBD_StatusTypeDef USBD_LL_Suspend(USBD_HandleTypeDef *pdev) * @param pdev: device instance * @retval status */ - USBD_StatusTypeDef USBD_LL_Resume(USBD_HandleTypeDef *pdev) { if (pdev->dev_state == USBD_STATE_SUSPENDED) @@ -884,7 +884,6 @@ USBD_StatusTypeDef USBD_LL_Resume(USBD_HandleTypeDef *pdev) * @param pdev: device instance * @retval status */ - USBD_StatusTypeDef USBD_LL_SOF(USBD_HandleTypeDef *pdev) { /* The SOF event can be distributed for all classes that support it */ @@ -925,6 +924,7 @@ USBD_StatusTypeDef USBD_LL_SOF(USBD_HandleTypeDef *pdev) * @brief USBD_LL_IsoINIncomplete * Handle iso in incomplete event * @param pdev: device instance + * @param epnum: Endpoint number * @retval status */ USBD_StatusTypeDef USBD_LL_IsoINIncomplete(USBD_HandleTypeDef *pdev, @@ -950,6 +950,7 @@ USBD_StatusTypeDef USBD_LL_IsoINIncomplete(USBD_HandleTypeDef *pdev, * @brief USBD_LL_IsoOUTIncomplete * Handle iso out incomplete event * @param pdev: device instance + * @param epnum: Endpoint number * @retval status */ USBD_StatusTypeDef USBD_LL_IsoOUTIncomplete(USBD_HandleTypeDef *pdev, diff --git a/Core/Src/usbd_ctlreq.c b/Core/Src/usbd_ctlreq.c index af9a015..814b810 100644 --- a/Core/Src/usbd_ctlreq.c +++ b/Core/Src/usbd_ctlreq.c @@ -46,7 +46,9 @@ /** @defgroup USBD_REQ_Private_Defines * @{ */ - +#ifndef USBD_MAX_STR_DESC_SIZ +#define USBD_MAX_STR_DESC_SIZ 64U +#endif /* USBD_MAX_STR_DESC_SIZ */ /** * @} */ @@ -421,7 +423,7 @@ USBD_StatusTypeDef USBD_StdEPReq(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef * Handle Get Descriptor requests * @param pdev: device instance * @param req: usb request - * @retval status + * @retval None */ static void USBD_GetDescriptor(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { @@ -675,7 +677,7 @@ static void USBD_GetDescriptor(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *r * Set device address * @param pdev: device instance * @param req: usb request - * @retval status + * @retval None */ static void USBD_SetAddress(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { @@ -814,7 +816,7 @@ static USBD_StatusTypeDef USBD_SetConfig(USBD_HandleTypeDef *pdev, USBD_SetupReq * Handle Get device configuration request * @param pdev: device instance * @param req: usb request - * @retval status + * @retval None */ static void USBD_GetConfig(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { @@ -848,7 +850,7 @@ static void USBD_GetConfig(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) * Handle Get Status request * @param pdev: device instance * @param req: usb request - * @retval status + * @retval None */ static void USBD_GetStatus(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { @@ -889,7 +891,7 @@ static void USBD_GetStatus(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) * Handle Set device feature request * @param pdev: device instance * @param req: usb request - * @retval status + * @retval None */ static void USBD_SetFeature(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { @@ -915,7 +917,7 @@ static void USBD_SetFeature(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) * Handle clear device feature request * @param pdev: device instance * @param req: usb request - * @retval status + * @retval None */ static void USBD_ClrFeature(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) { @@ -941,8 +943,8 @@ static void USBD_ClrFeature(USBD_HandleTypeDef *pdev, USBD_SetupReqTypedef *req) /** * @brief USBD_ParseSetupRequest * Copy buffer into setup structure - * @param pdev: device instance * @param req: usb request + * @param pdata: setup data pointer * @retval None */ void USBD_ParseSetupRequest(USBD_SetupReqTypedef *req, uint8_t *pdata) @@ -1002,7 +1004,7 @@ void USBD_GetString(uint8_t *desc, uint8_t *unicode, uint16_t *len) } pdesc = desc; - *len = ((uint16_t)USBD_GetLen(pdesc) * 2U) + 2U; + *len = MIN(USBD_MAX_STR_DESC_SIZ, ((uint16_t)USBD_GetLen(pdesc) * 2U) + 2U); unicode[idx] = *(uint8_t *)len; idx++; diff --git a/Release_Notes.html b/Release_Notes.html index 31e63f7..94390d0 100644 --- a/Release_Notes.html +++ b/Release_Notes.html @@ -60,6 +60,35 @@ Page : STM32Cube USB Wiki Page

Update History

+ +
+

Main Changes

+ + + + + + + + + + + + + + + + + + + + +
Headline
USB Core:
Minor enhancement; add a check on device string descriptor length
USB DFU Class:
Improve DFU Vendor Commands support
+
+
+
+
diff --git a/Release_Notes.md b/Release_Notes.md deleted file mode 100644 index 5842e7e..0000000 --- a/Release_Notes.md +++ /dev/null @@ -1,545 +0,0 @@ ---- -pagetitle: Release Notes for STM32Cube USB Device Library -lang: en -header-includes: ---- - -::: {.row} -::: {.col-sm-12 .col-lg-4} - -
-# Release Notes for STM32Cube USB Device Library -Copyright © 2015 STMicroelectronics\ - -[![ST logo](_htmresc/st_logo_2020.png)](https://www.st.com){.logo} -
- -# Purpose - -The USB device library comes on top of the STM32Cube™ USB device HAL driver and -offers all the APIs required to develop an USB device application. - -The main USB device library features are: - - - Support of multi packet transfer features allowing sending big amount of data without - splitting it into max packet size transfers. - - Support of most common USB Class drivers (HID, MSC, DFU, CDC-ACM, CDC-ECM, RNDIS, MTP, AUDIO1.0, Printer, Video, Composite) - - Configuration files to interface with Cube HAL and change the library configuration without changing - the library code (Read Only). - - 32-bits aligned data structures to handle DMA based transfer in High speed modes. - -Here is the list of references to user documents: - -- [UM1734](https://www.st.com/resource/en/user_manual/DM00108129.pdf) : STM32Cube USB device library User Manual -- [Wiki Page](https://wiki.st.com/stm32mcu/wiki/USB_overview) : STM32Cube USB Wiki Page - -::: - -::: {.col-sm-12 .col-lg-8} -# Update History -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - **USB Core:** - Adding user callback to get device configuration state - **USB DFU Class:** - Adding DFU Vendor Commands support - **USB MSC Class:** - fix data sense response to be aligned with SBC-3 specification - **USB AUDIO Class:** - restart AUDIO ISO endpoint during ISO incomplete event - **USB VIDEO Class:** - restart VIDEO ISO endpoint during ISO incomplete event - -
-::: - -::: {.col-sm-12 .col-lg-8} -# Update History -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - Improvement of the memory management - **USB Core:** - Fix some compilation warnings related to unused parameters - Improve some code parts style - Add check on the USB Device status in USBD_LL_Suspend before suspending it - **USB CDC-ACM Class:** - Remove redundant prototype declaration of USBD_CDC_GetOtherSpeedCfgDesc() - **USB CompositeBuilder, CCID, CDC_ECM, CDC_RNDIS, CustomHID, MSC & Video Classes:** - Improve some code parts style - -
-::: - -::: {.col-sm-12 .col-lg-8} -# Update History -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - **USB VIDEO Class:** - Correction of the support of VS_PROBE_CONTROL & VS_COMMIT_CONTROL requests - **USB AUDIO Class:** - Correction of the check on AUDIO_TOTAL_BUF_SIZE to avoid vulnerabilities - **USB HID Class:** - Modification of some constants names to avoid duplication versus USB host library - **USB CustomHID Class:** - Add support of Get Report control request - Allow disabling EP OUT prepare receive using a dedicated macros that can be defined in usbd_conf.h application file - Add support of Report Descriptor with length greater than 255 bytes - **USB CCID Class:** - Fix minor Code Spelling warning - **USB All Classes:** - Update all classes to support composite multi-instance using the class id parameter - Fix code spelling and improve code style - fix misraC 2012 rule 10.3 - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - **Integration of new USB device Class driver:** - Adding support of Composite devices with an auto generation of composite device configuration descriptors - **USB All Classes:** - Fix Code Spelling and improve Code Style - Update device class drivers to support Composite devices - Improve declaration of USB configuration descriptor table which is allocated if the composite builder is not selected - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - **Integration of new USB device Class driver:** - USB CCID Class driver based on Universal Serial Bus Device Class Definition for Integrated Circuit(s) Cards Interface Devices Revision 1.1 - USB MTP Class driver based on Universal Serial Bus Device Class Media Transfer Protocol Revision 1.1 - **USB All Classes:** - Fix Code Spelling and improve Code Style - Update the way to declare licenses - **USB CDC/RNDIS/ECM Classes:** - Fix compilation warning with C++ due to missing casting during class handler allocation - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - **Integration of new USB device Class driver:** - USB Printer Class driver based on Universal Serial Bus Device Class Definition for Printing Devices Version 1.1 - **USB All Classes:** - Fix USB buffer overflow vulnerability for CDC, CDC-ECM, CDC-RNDIS, DFU, AUDIO, CustomHID, and Video Classes - Fix compilation warning with C++ due to missing casting during class handler allocation - Enhance comments of USB configuration descriptors fields - **USB Video Class:** - Fix missing closing bracket for extern "C" in usbd_video.h - Fix USBCV test with Uncompressed video format support - - -
-::: - - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - USB All Class: Add NULL pointer access check to Class handler - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - **Integration of new USB device Class driver:** - USB video Class driver based on USB-IF video class definition version 1.1 - **USB Core:** - Enhance NULL pointer check in Core APIs - Allow supporting both USER and USER Class string desc - Add support of USB controller which handles packet-size splitting by hardware - Avoid compilation warning due macro redefinition - change added to USBD_HandleTypeDef structure: dev_state, old_dev_state and ep0_state declaration become volatile to disable compiler optimization - Word spelling correction and file indentation improved - usbd_conf.h/c Template file updated to suggest using by default a static memory allocation for Class handler - **USB All Classes:** - Word spelling correction and file indentation improved - Allow updating device config descriptor Max power from user code usbd_conf.h using USBD_MAX_POWER define - Fix device config descriptor bmAttributes value which depends on user code define USBD_SELF_POWERED - **USB CDC Class:** - Class specific request, add protection to limit the maximum data length to be sent by the CDC device - **USB CustomHID Class:** - Allow changing CustomHID data EP size from user code - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - Fix minor misra-c 2012 violations - **USB Core:** - minor rework on USBD_Init() USBD_DeInit() - Fix warning issue with Keil due to missing return value of setup API - **USB CDC Class:** - Fix file indentation - Avoid accessing to NULL pointer in case TransmitCplt() user fops is not defined to allow application compatibility with device library version below v2.6.0 - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - Integration of three new USB device Class drivers:CDC ECM , CDC RNDIS Microsoft, USB Billboard - Fix mandatory misra-c 2012 violations - update user core and class template files - **USB Core:** - Fix unexpected EP0 stall during enumeration phase - Improve APIs error management and prevent accessing NULL pointers - **USB MSC Class:** - Fix USBCV specific class tests - Fix multiple error with SCSI commands handling - Protect medium access when host ask for medium ejection - **USB CDC Class:** - Add new function to inform user that current IN transfer is completed - update transmit and receive APIs to transfer up to 64KB - **USB AUDIO Class:** - Fix audio sync start buffer size - update user callback periodicTC args by adding pointer to user buffer and size - **USB CustomHID Class:** - Rework the OUT transfer complete and prevent automatically re-enabling the OUT EP - Add new user API to restart the OUT transfer: USBD_CUSTOM_HID_ReceivePacket() - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - Fix misra-c 2012 high severity violations - **Core driver:** - protect shared macros __ALIGN_BEGIN, __ALIGN_END with C directive #ifndef - update Core driver and DFU Class driver to use USBD_SUPPORT_USER_STRING_DESC instead of USBD_SUPPORT_USER_STRING - prevent accessing to NULL pointer if the get descriptor functions are not defined - Update on USBD_LL_Resume(), restore the device state only if the current state is USBD_STATE_SUSPENDED - - -
-::: - - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - DFU Class: fix compilation warning due to unreachable instruction code introduced with CMSIS V5.4.0 NVIC_SystemReset() prototype change - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - Update license section by adding path to get copy of ST Ultimate Liberty license - Core: Fix unexpected stall during status OUT phase - DFU Class: rework hdfu struct to prevent unaligned addresses - MSC Class: fix lba address overflow during large file transfers greater than 4Go - Template Class: add missing Switch case Break on USBD_Template_Setup API - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - Update license section - Update some functions to be MISRAC 2004 compliant - Add HS and OtherSpeed configuration descriptor for HID and CustomHID classes - Correct error handling in all class setup function - Add usbd_desc_template.c/ usbd_desc_template.h templates files - Add support of class and vendor request - CDC Class: fix zero-length packet issue in bulk IN transfer - Fix compilation warning with unused arguments for some functions - Improve USB Core enumeration state machine - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - **CDC Class** - usbd_cdc.c: change #include "USBD_CDC.h" by #include "usbd_cdc.h" - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - **CDC Class** - usbd_cdc.c: comments update - **MSC Class** - usbd_msc_bot.h: update to be C++ compliant - **AUDIO Class** - usbd_audio.c: fix issue when Host sends GetInterface command it gets a wrong value - usbd_audio.c: remove useless management of DMA half transfer - - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - **Core Driver** - Add support of Link Power Management (LPM): add new API GetBOSDescriptor(), that is used only if USBD_LPM_ENABLED switch is enabled in usbd_conf.h file - usbd_core.c: Fix bug of unsupported premature Host Out stage during data In stage (ie. when endpoint 0 maximum data size is 8 and Host requests GetDeviceDescriptor for the first time) - usbd_ctlreq.c: Fix bug of unsupported Endpoint Class requests (ie. Audio SetCurrent request for endpoint sampling rate setting) - **HID Class** - Updating Polling time API USBD_HID_GetPollingInterval() to query this period for HS and FS - usbd_hid.c: Fix USBD_LL_CloseEP() function call in USBD_HID_DeInit() replacing endpoint size by endpoint address. - **CDC Class** - usbd_cdc.c: Add missing GetInterface request management in USBD_CDC_Setup() function - usbd_cdc.c: Update USBD_CDC_Setup() function to allow correct user implementation of CDC_SET_CONTROL_LINE_STATE and similar no-data setup requests. - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - Update all drivers to be C++ compliant - **CDC Class** - usbd_cdc.c: fix clear flag issue in USBD_CDC_TransmitPacket() function - usbd_cdc_if_template.c: update TEMPLATE_Receive() function header comment - Miscellaneous source code comments update - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - Source code comments review and update - **HID class** - Remove unused API USBD_HID_DeviceQualifierDescriptor() - Add a new API in the HID class to query the poll time USBD_HID_GetPollingInterval() - **CDC class** - Bug fix: missing handling ZeroLength Setup request - **All classes** - Add alias for the class definition, it's defined as macro with capital letter - ex. for the HID, the USBD_HID_CLASS macro is defined this way #define USBD_HID_CLASS &USBD_HID - and the application code can use the previous definition: &USBD_HID ex. USBD_RegisterClass(&USBD_Device, &USBD_HID) or the new USBD_HID_CLASS ex. USBD_RegisterClass(&USBD_Device, USBD_HID_CLASS) - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - usbd_conf_template.c: update file with the right content (it was using MSC memory management layer) - usbd_conf_template.h: change include of stm32f4xx.h by stm32xxx.h and add comment to inform user to adapt it to the device used - Several enhancements in CustomHID class - Update the Custom HID class driver to simplify the link with user processes - Optimize the Custom HID class driver and reduce footprint - Add USBD_CUSTOM_HID_RegisterInterface() API to link user process to custom HID class - Add Custom HID interface template file usbd_customhid_if_template.c/h - Miscellaneous comments update - -
-::: - -::: {.collapse} - - -
- -## Main Changes - -Major update based on STM32Cube specification. - - Headline - --------- - Library Core, Classes architecture and APIs modified vs. V1.1.0, and thus the 2 versions are not compatible. - - -**This version has to be used only with STM32Cube based development** - -
-::: - -::: {.collapse} - - -
- -## Main Changes - - Headline - --------- - Official support of STM32F4xx devices - All source files: license disclaimer text update and add link to the License file on ST Internet. - Handle test mode in the set feature request - Handle dynamically the USB SELF POWERED feature - Handle correctly the USBD_CtlError process to take into account error during Control OUT stage - Miscellaneous bug fix - -
-::: - -::: {.collapse} - - -
- -## Main Changes - -First official version for STM32F105/7xx and STM32F2xx devices - -
-::: - -::: -::: - -