/* USER CODE BEGIN Header */ /** ****************************************************************************** * @file : Target/usbh_conf.c * @version : v1.0_Cube * @brief : This file implements the board support package for the USB host library ****************************************************************************** * @attention * * Copyright (c) 2022 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. * ****************************************************************************** */ /* USER CODE END Header */ /* Includes ------------------------------------------------------------------*/ #include "usbh_core.h" #include "usbh_platform.h" /* USER CODE BEGIN Includes */ /* USER CODE END Includes */ /* Private typedef -----------------------------------------------------------*/ /* Private define ------------------------------------------------------------*/ /* Private macro -------------------------------------------------------------*/ /* USER CODE BEGIN PV */ /* Private variables ---------------------------------------------------------*/ /* USER CODE END PV */ HCD_HandleTypeDef hhcd_USB_OTG_FS; void Error_Handler(void); /* USER CODE BEGIN 0 */ /* USER CODE END 0 */ /* USER CODE BEGIN PFP */ /* Private function prototypes -----------------------------------------------*/ USBH_StatusTypeDef USBH_Get_USB_Status(HAL_StatusTypeDef hal_status); /* USER CODE END PFP */ /* Private functions ---------------------------------------------------------*/ /* USER CODE BEGIN 1 */ /* USER CODE END 1 */ /******************************************************************************* LL Driver Callbacks (HCD -> USB Host Library) *******************************************************************************/ /* MSP Init */ void HAL_HCD_MspInit(HCD_HandleTypeDef* hcdHandle) { GPIO_InitTypeDef GPIO_InitStruct = {0}; if(hcdHandle->Instance==USB_OTG_FS) { /* USER CODE BEGIN USB_OTG_FS_MspInit 0 */ /* USER CODE END USB_OTG_FS_MspInit 0 */ __HAL_RCC_GPIOA_CLK_ENABLE(); /**USB_OTG_FS GPIO Configuration PA12 ------> USB_OTG_FS_DP PA11 ------> USB_OTG_FS_DM PA10 ------> USB_OTG_FS_ID PA9 ------> USB_OTG_FS_VBUS */ GPIO_InitStruct.Pin = USB_FS1_P_Pin|USB_FS1_N_Pin|USB_FS1_ID_Pin; GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH; GPIO_InitStruct.Alternate = GPIO_AF10_OTG_FS; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct); GPIO_InitStruct.Pin = VBUS_FS1_Pin; GPIO_InitStruct.Mode = GPIO_MODE_AF_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; HAL_GPIO_Init(VBUS_FS1_GPIO_Port, &GPIO_InitStruct); /* Peripheral clock enable */ __HAL_RCC_USB_OTG_FS_CLK_ENABLE(); /* Peripheral interrupt init */ HAL_NVIC_SetPriority(OTG_FS_IRQn, 5, 0); HAL_NVIC_EnableIRQ(OTG_FS_IRQn); /* USER CODE BEGIN USB_OTG_FS_MspInit 1 */ /* USER CODE END USB_OTG_FS_MspInit 1 */ } } void HAL_HCD_MspDeInit(HCD_HandleTypeDef* hcdHandle) { if(hcdHandle->Instance==USB_OTG_FS) { /* USER CODE BEGIN USB_OTG_FS_MspDeInit 0 */ /* USER CODE END USB_OTG_FS_MspDeInit 0 */ /* Peripheral clock disable */ __HAL_RCC_USB_OTG_FS_CLK_DISABLE(); /**USB_OTG_FS GPIO Configuration PA12 ------> USB_OTG_FS_DP PA11 ------> USB_OTG_FS_DM PA10 ------> USB_OTG_FS_ID PA9 ------> USB_OTG_FS_VBUS */ HAL_GPIO_DeInit(GPIOA, USB_FS1_P_Pin|USB_FS1_N_Pin|USB_FS1_ID_Pin|VBUS_FS1_Pin); /* Peripheral interrupt Deinit*/ HAL_NVIC_DisableIRQ(OTG_FS_IRQn); /* USER CODE BEGIN USB_OTG_FS_MspDeInit 1 */ /* USER CODE END USB_OTG_FS_MspDeInit 1 */ } } /** * @brief SOF callback. * @param hhcd: HCD handle * @retval None */ void HAL_HCD_SOF_Callback(HCD_HandleTypeDef *hhcd) { USBH_LL_IncTimer(hhcd->pData); } /** * @brief SOF callback. * @param hhcd: HCD handle * @retval None */ void HAL_HCD_Connect_Callback(HCD_HandleTypeDef *hhcd) { USBH_LL_Connect(hhcd->pData); } /** * @brief SOF callback. * @param hhcd: HCD handle * @retval None */ void HAL_HCD_Disconnect_Callback(HCD_HandleTypeDef *hhcd) { USBH_LL_Disconnect(hhcd->pData); } /** * @brief Notify URB state change callback. * @param hhcd: HCD handle * @param chnum: channel number * @param urb_state: state * @retval None */ void HAL_HCD_HC_NotifyURBChange_Callback(HCD_HandleTypeDef *hhcd, uint8_t chnum, HCD_URBStateTypeDef urb_state) { /* To be used with OS to sync URB state with the global state machine */ #if (USBH_USE_OS == 1) USBH_LL_NotifyURBChange(hhcd->pData); #endif } /** * @brief Port Port Enabled callback. * @param hhcd: HCD handle * @retval None */ void HAL_HCD_PortEnabled_Callback(HCD_HandleTypeDef *hhcd) { USBH_LL_PortEnabled(hhcd->pData); } /** * @brief Port Port Disabled callback. * @param hhcd: HCD handle * @retval None */ void HAL_HCD_PortDisabled_Callback(HCD_HandleTypeDef *hhcd) { USBH_LL_PortDisabled(hhcd->pData); } /******************************************************************************* LL Driver Interface (USB Host Library --> HCD) *******************************************************************************/ /** * @brief Initialize the low level portion of the host driver. * @param phost: Host handle * @retval USBH status */ USBH_StatusTypeDef USBH_LL_Init(USBH_HandleTypeDef *phost) { /* Init USB_IP */ if (phost->id == HOST_FS) { /* Link the driver to the stack. */ hhcd_USB_OTG_FS.pData = phost; phost->pData = &hhcd_USB_OTG_FS; hhcd_USB_OTG_FS.Instance = USB_OTG_FS; hhcd_USB_OTG_FS.Init.Host_channels = 8; hhcd_USB_OTG_FS.Init.speed = HCD_SPEED_FULL; hhcd_USB_OTG_FS.Init.dma_enable = DISABLE; hhcd_USB_OTG_FS.Init.phy_itface = HCD_PHY_EMBEDDED; hhcd_USB_OTG_FS.Init.Sof_enable = DISABLE; if (HAL_HCD_Init(&hhcd_USB_OTG_FS) != HAL_OK) { Error_Handler( ); } USBH_LL_SetTimer(phost, HAL_HCD_GetCurrentFrame(&hhcd_USB_OTG_FS)); } return USBH_OK; } /** * @brief De-Initialize the low level portion of the host driver. * @param phost: Host handle * @retval USBH status */ USBH_StatusTypeDef USBH_LL_DeInit(USBH_HandleTypeDef *phost) { HAL_StatusTypeDef hal_status = HAL_OK; USBH_StatusTypeDef usb_status = USBH_OK; hal_status = HAL_HCD_DeInit(phost->pData); usb_status = USBH_Get_USB_Status(hal_status); return usb_status; } /** * @brief Start the low level portion of the host driver. * @param phost: Host handle * @retval USBH status */ USBH_StatusTypeDef USBH_LL_Start(USBH_HandleTypeDef *phost) { HAL_StatusTypeDef hal_status = HAL_OK; USBH_StatusTypeDef usb_status = USBH_OK; hal_status = HAL_HCD_Start(phost->pData); usb_status = USBH_Get_USB_Status(hal_status); return usb_status; } /** * @brief Stop the low level portion of the host driver. * @param phost: Host handle * @retval USBH status */ USBH_StatusTypeDef USBH_LL_Stop(USBH_HandleTypeDef *phost) { HAL_StatusTypeDef hal_status = HAL_OK; USBH_StatusTypeDef usb_status = USBH_OK; hal_status = HAL_HCD_Stop(phost->pData); usb_status = USBH_Get_USB_Status(hal_status); return usb_status; } /** * @brief Return the USB host speed from the low level driver. * @param phost: Host handle * @retval USBH speeds */ USBH_SpeedTypeDef USBH_LL_GetSpeed(USBH_HandleTypeDef *phost) { USBH_SpeedTypeDef speed = USBH_SPEED_FULL; switch (HAL_HCD_GetCurrentSpeed(phost->pData)) { case 0 : speed = USBH_SPEED_HIGH; break; case 1 : speed = USBH_SPEED_FULL; break; case 2 : speed = USBH_SPEED_LOW; break; default: speed = USBH_SPEED_FULL; break; } return speed; } /** * @brief Reset the Host port of the low level driver. * @param phost: Host handle * @retval USBH status */ USBH_StatusTypeDef USBH_LL_ResetPort(USBH_HandleTypeDef *phost) { HAL_StatusTypeDef hal_status = HAL_OK; USBH_StatusTypeDef usb_status = USBH_OK; hal_status = HAL_HCD_ResetPort(phost->pData); usb_status = USBH_Get_USB_Status(hal_status); return usb_status; } /** * @brief Return the last transferred packet size. * @param phost: Host handle * @param pipe: Pipe index * @retval Packet size */ uint32_t USBH_LL_GetLastXferSize(USBH_HandleTypeDef *phost, uint8_t pipe) { return HAL_HCD_HC_GetXferCount(phost->pData, pipe); } /** * @brief Open a pipe of the low level driver. * @param phost: Host handle * @param pipe_num: Pipe index * @param epnum: Endpoint number * @param dev_address: Device USB address * @param speed: Device Speed * @param ep_type: Endpoint type * @param mps: Endpoint max packet size * @retval USBH status */ USBH_StatusTypeDef USBH_LL_OpenPipe(USBH_HandleTypeDef *phost, uint8_t pipe_num, uint8_t epnum, uint8_t dev_address, uint8_t speed, uint8_t ep_type, uint16_t mps) { HAL_StatusTypeDef hal_status = HAL_OK; USBH_StatusTypeDef usb_status = USBH_OK; hal_status = HAL_HCD_HC_Init(phost->pData, pipe_num, epnum, dev_address, speed, ep_type, mps); usb_status = USBH_Get_USB_Status(hal_status); return usb_status; } /** * @brief Close a pipe of the low level driver. * @param phost: Host handle * @param pipe: Pipe index * @retval USBH status */ USBH_StatusTypeDef USBH_LL_ClosePipe(USBH_HandleTypeDef *phost, uint8_t pipe) { HAL_StatusTypeDef hal_status = HAL_OK; USBH_StatusTypeDef usb_status = USBH_OK; hal_status = HAL_HCD_HC_Halt(phost->pData, pipe); usb_status = USBH_Get_USB_Status(hal_status); return usb_status; } /** * @brief Submit a new URB to the low level driver. * @param phost: Host handle * @param pipe: Pipe index * This parameter can be a value from 1 to 15 * @param direction : Channel number * This parameter can be one of the these values: * 0 : Output * 1 : Input * @param ep_type : Endpoint Type * This parameter can be one of the these values: * @arg EP_TYPE_CTRL: Control type * @arg EP_TYPE_ISOC: Isochrounous type * @arg EP_TYPE_BULK: Bulk type * @arg EP_TYPE_INTR: Interrupt type * @param token : Endpoint Type * This parameter can be one of the these values: * @arg 0: PID_SETUP * @arg 1: PID_DATA * @param pbuff : pointer to URB data * @param length : Length of URB data * @param do_ping : activate do ping protocol (for high speed only) * This parameter can be one of the these values: * 0 : do ping inactive * 1 : do ping active * @retval Status */ USBH_StatusTypeDef USBH_LL_SubmitURB(USBH_HandleTypeDef *phost, uint8_t pipe, uint8_t direction, uint8_t ep_type, uint8_t token, uint8_t *pbuff, uint16_t length, uint8_t do_ping) { HAL_StatusTypeDef hal_status = HAL_OK; USBH_StatusTypeDef usb_status = USBH_OK; hal_status = HAL_HCD_HC_SubmitRequest(phost->pData, pipe, direction , ep_type, token, pbuff, length, do_ping); usb_status = USBH_Get_USB_Status(hal_status); return usb_status; } /** * @brief Get a URB state from the low level driver. * @param phost: Host handle * @param pipe: Pipe index * This parameter can be a value from 1 to 15 * @retval URB state * This parameter can be one of the these values: * @arg URB_IDLE * @arg URB_DONE * @arg URB_NOTREADY * @arg URB_NYET * @arg URB_ERROR * @arg URB_STALL */ USBH_URBStateTypeDef USBH_LL_GetURBState(USBH_HandleTypeDef *phost, uint8_t pipe) { return (USBH_URBStateTypeDef)HAL_HCD_HC_GetURBState (phost->pData, pipe); } /** * @brief Drive VBUS. * @param phost: Host handle * @param state : VBUS state * This parameter can be one of the these values: * 0 : VBUS Inactive * 1 : VBUS Active * @retval Status */ USBH_StatusTypeDef USBH_LL_DriverVBUS(USBH_HandleTypeDef *phost, uint8_t state) { if (phost->id == HOST_FS) { MX_DriverVbusFS(state); } /* USER CODE BEGIN 0 */ /* USER CODE END 0*/ HAL_Delay(200); return USBH_OK; } /** * @brief Set toggle for a pipe. * @param phost: Host handle * @param pipe: Pipe index * @param toggle: toggle (0/1) * @retval Status */ USBH_StatusTypeDef USBH_LL_SetToggle(USBH_HandleTypeDef *phost, uint8_t pipe, uint8_t toggle) { HCD_HandleTypeDef *pHandle; pHandle = phost->pData; if(pHandle->hc[pipe].ep_is_in) { pHandle->hc[pipe].toggle_in = toggle; } else { pHandle->hc[pipe].toggle_out = toggle; } return USBH_OK; } /** * @brief Return the current toggle of a pipe. * @param phost: Host handle * @param pipe: Pipe index * @retval toggle (0/1) */ uint8_t USBH_LL_GetToggle(USBH_HandleTypeDef *phost, uint8_t pipe) { uint8_t toggle = 0; HCD_HandleTypeDef *pHandle; pHandle = phost->pData; if(pHandle->hc[pipe].ep_is_in) { toggle = pHandle->hc[pipe].toggle_in; } else { toggle = pHandle->hc[pipe].toggle_out; } return toggle; } /** * @brief Delay routine for the USB Host Library * @param Delay: Delay in ms * @retval None */ void USBH_Delay(uint32_t Delay) { HAL_Delay(Delay); } /** * @brief Returns the USB status depending on the HAL status: * @param hal_status: HAL status * @retval USB status */ USBH_StatusTypeDef USBH_Get_USB_Status(HAL_StatusTypeDef hal_status) { USBH_StatusTypeDef usb_status = USBH_OK; switch (hal_status) { case HAL_OK : usb_status = USBH_OK; break; case HAL_ERROR : usb_status = USBH_FAIL; break; case HAL_BUSY : usb_status = USBH_BUSY; break; case HAL_TIMEOUT : usb_status = USBH_FAIL; break; default : usb_status = USBH_FAIL; break; } return usb_status; }