You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
548 lines
15 KiB
548 lines
15 KiB
/* 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; |
|
} |
|
|
|
|