: This file implements the board support package for the USB device library More...

#include "stm32f0xx.h"
#include "stm32f0xx_hal.h"
#include "usbd_def.h"
#include "usbd_core.h"
#include "usbd_cdc.h"

Functions
static void	SystemClockConfig_Resume (void)
	Configures system clock after wake-up from USB Resume CallBack: enable HSI, PLL and select PLL as system clock source. More...

void	HAL_PCDEx_SetConnectionState (PCD_HandleTypeDef *hpcd, uint8_t state)
	Software Device Connection. More...

void	HAL_PCD_MspInit (PCD_HandleTypeDef *hpcd)

void	HAL_PCD_MspDeInit (PCD_HandleTypeDef *hpcd)

void	HAL_PCD_SetupStageCallback (PCD_HandleTypeDef *hpcd)
	Setup Stage callback. More...

void	HAL_PCD_DataOutStageCallback (PCD_HandleTypeDef *hpcd, uint8_t epnum)
	Data Out Stage callback. More...

void	HAL_PCD_DataInStageCallback (PCD_HandleTypeDef *hpcd, uint8_t epnum)
	Data In Stage callback.. More...

void	HAL_PCD_SOFCallback (PCD_HandleTypeDef *hpcd)
	SOF callback. More...

void	HAL_PCD_ResetCallback (PCD_HandleTypeDef *hpcd)
	Reset callback. More...

void	HAL_PCD_SuspendCallback (PCD_HandleTypeDef *hpcd)
	Suspend callback. When Low power mode is enabled the debug cannot be used (IAR, Keil doesn't support it) More...

void	HAL_PCD_ResumeCallback (PCD_HandleTypeDef *hpcd)
	Resume callback. When Low power mode is enabled the debug cannot be used (IAR, Keil doesn't support it) More...

void	HAL_PCD_ISOOUTIncompleteCallback (PCD_HandleTypeDef *hpcd, uint8_t epnum)
	ISOOUTIncomplete callback. More...

void	HAL_PCD_ISOINIncompleteCallback (PCD_HandleTypeDef *hpcd, uint8_t epnum)
	ISOINIncomplete callback. More...

void	HAL_PCD_ConnectCallback (PCD_HandleTypeDef *hpcd)
	ConnectCallback callback. More...

void	HAL_PCD_DisconnectCallback (PCD_HandleTypeDef *hpcd)
	Disconnect callback. More...

USBD_StatusTypeDef	USBD_LL_Init (USBD_HandleTypeDef *pdev)
	Initializes the Low Level portion of the Device driver. More...

USBD_StatusTypeDef	USBD_LL_DeInit (USBD_HandleTypeDef *pdev)
	De-Initializes the Low Level portion of the Device driver. More...

USBD_StatusTypeDef	USBD_LL_Start (USBD_HandleTypeDef *pdev)
	Starts the Low Level portion of the Device driver. More...

USBD_StatusTypeDef	USBD_LL_Stop (USBD_HandleTypeDef *pdev)
	Stops the Low Level portion of the Device driver. More...

USBD_StatusTypeDef	USBD_LL_OpenEP (USBD_HandleTypeDef *pdev, uint8_t ep_addr, uint8_t ep_type, uint16_t ep_mps)
	Opens an endpoint of the Low Level Driver. More...

USBD_StatusTypeDef	USBD_LL_CloseEP (USBD_HandleTypeDef *pdev, uint8_t ep_addr)
	Closes an endpoint of the Low Level Driver. More...

USBD_StatusTypeDef	USBD_LL_FlushEP (USBD_HandleTypeDef *pdev, uint8_t ep_addr)
	Flushes an endpoint of the Low Level Driver. More...

USBD_StatusTypeDef	USBD_LL_StallEP (USBD_HandleTypeDef *pdev, uint8_t ep_addr)
	Sets a Stall condition on an endpoint of the Low Level Driver. More...

USBD_StatusTypeDef	USBD_LL_ClearStallEP (USBD_HandleTypeDef *pdev, uint8_t ep_addr)
	Clears a Stall condition on an endpoint of the Low Level Driver. More...

uint8_t	USBD_LL_IsStallEP (USBD_HandleTypeDef *pdev, uint8_t ep_addr)
	Returns Stall condition. More...

USBD_StatusTypeDef	USBD_LL_SetUSBAddress (USBD_HandleTypeDef *pdev, uint8_t dev_addr)
	Assigns a USB address to the device. More...

USBD_StatusTypeDef	USBD_LL_Transmit (USBD_HandleTypeDef pdev, uint8_t ep_addr, uint8_t pbuf, uint16_t size)
	Transmits data over an endpoint. More...

USBD_StatusTypeDef	USBD_LL_PrepareReceive (USBD_HandleTypeDef pdev, uint8_t ep_addr, uint8_t pbuf, uint16_t size)
	Prepares an endpoint for reception. More...

uint32_t	USBD_LL_GetRxDataSize (USBD_HandleTypeDef *pdev, uint8_t ep_addr)
	Returns the last transfered packet size. More...

void	USBD_LL_Delay (uint32_t Delay)
	Delays routine for the USB Device Library. More...

void *	USBD_static_malloc (uint32_t size)
	static single allocation. More...

void	USBD_static_free (void *p)
	Dummy memory free. More...

Variables
PCD_HandleTypeDef	hpcd_USB_FS

Detailed Description

: This file implements the board support package for the USB device library

Version: : v1.0_Cube COPYRIGHT(c) 2016 STMicroelectronics

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of STMicroelectronics nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Function Documentation

◆ HAL_PCD_ConnectCallback()

void HAL_PCD_ConnectCallback ( PCD_HandleTypeDef * hpcd )

ConnectCallback callback.

Parameters

hpcd	PCD handle

Return values

None

237 {

238 USBD_LL_DevConnected(hpcd->pData);

◆ HAL_PCD_DataInStageCallback()

void HAL_PCD_DataInStageCallback	(	PCD_HandleTypeDef *	hpcd,
		uint8_t	epnum
	)

Data In Stage callback..

Parameters

hpcd	PCD handle
epnum	Endpoint Number

Return values

None

129 {

130 USBD_LL_DataInStage(hpcd->pData, epnum, hpcd->IN_ep[epnum].xfer_buff);

◆ HAL_PCD_DataOutStageCallback()

void HAL_PCD_DataOutStageCallback	(	PCD_HandleTypeDef *	hpcd,
		uint8_t	epnum
	)

Data Out Stage callback.

Parameters

hpcd	PCD handle
epnum	Endpoint Number

Return values

None

118 {

119 USBD_LL_DataOutStage(hpcd->pData, epnum, hpcd->OUT_ep[epnum].xfer_buff);

◆ HAL_PCD_DisconnectCallback()

void HAL_PCD_DisconnectCallback ( PCD_HandleTypeDef * hpcd )

Disconnect callback.

Parameters

hpcd	PCD handle

Return values

None

247 {

248 USBD_LL_DevDisconnected(hpcd->pData);

◆ HAL_PCD_ISOINIncompleteCallback()

void HAL_PCD_ISOINIncompleteCallback	(	PCD_HandleTypeDef *	hpcd,
		uint8_t	epnum
	)

ISOINIncomplete callback.

Parameters

hpcd	PCD handle
epnum	Endpoint Number

Return values

None

227 {

228 USBD_LL_IsoINIncomplete(hpcd->pData, epnum);

◆ HAL_PCD_ISOOUTIncompleteCallback()

void HAL_PCD_ISOOUTIncompleteCallback	(	PCD_HandleTypeDef *	hpcd,
		uint8_t	epnum
	)

ISOOUTIncomplete callback.

Parameters

hpcd	PCD handle
epnum	Endpoint Number

Return values

None

216 {

217 USBD_LL_IsoOUTIncomplete(hpcd->pData, epnum);

◆ HAL_PCD_ResetCallback()

void HAL_PCD_ResetCallback ( PCD_HandleTypeDef * hpcd )

Reset callback.

Parameters

hpcd	PCD handle

Return values

None

 { 
   USBD_SpeedTypeDef speed = USBD_SPEED_FULL;
 
   /*Set USB Current Speed*/
   switch (hpcd->Init.speed)
   {
   case PCD_SPEED_FULL:
     speed = USBD_SPEED_FULL;    
     break;
     
   default:
     speed = USBD_SPEED_FULL;    
     break;    
   }
   USBD_LL_SetSpeed(hpcd->pData, speed);  
   
   /*Reset Device*/
   USBD_LL_Reset(hpcd->pData);

◆ HAL_PCD_ResumeCallback()

void HAL_PCD_ResumeCallback ( PCD_HandleTypeDef * hpcd )

Resume callback. When Low power mode is enabled the debug cannot be used (IAR, Keil doesn't support it)

Parameters

hpcd	PCD handle

Return values

None

 {
   /* USER CODE BEGIN 3 */
   if (hpcd->Init.low_power_enable)
   {    
     /* Reset SLEEPDEEP bit of Cortex System Control Register */
     SCB->SCR &= (uint32_t)~((uint32_t)(SCB_SCR_SLEEPDEEP_Msk | SCB_SCR_SLEEPONEXIT_Msk));   
     SystemClockConfig_Resume(); 
   }
   /* USER CODE END 3 */
   USBD_LL_Resume(hpcd->pData);
   

◆ HAL_PCD_SetupStageCallback()

void HAL_PCD_SetupStageCallback ( PCD_HandleTypeDef * hpcd )

Setup Stage callback.

Parameters

hpcd	PCD handle

Return values

None

107 {

108 USBD_LL_SetupStage(hpcd->pData, (uint8_t *)hpcd->Setup);

◆ HAL_PCD_SOFCallback()

void HAL_PCD_SOFCallback ( PCD_HandleTypeDef * hpcd )

SOF callback.

Parameters

hpcd	PCD handle

Return values

None

139 {

140 USBD_LL_SOF(hpcd->pData);

◆ HAL_PCD_SuspendCallback()

void HAL_PCD_SuspendCallback ( PCD_HandleTypeDef * hpcd )

Suspend callback. When Low power mode is enabled the debug cannot be used (IAR, Keil doesn't support it)

Parameters

hpcd	PCD handle

Return values

None

 {
   /* Inform USB library that core enters in suspend Mode */
   USBD_LL_Suspend(hpcd->pData);
   /*Enter in STOP mode */
   /* USER CODE BEGIN 2 */
   if (hpcd->Init.low_power_enable)
   {
     /* Set SLEEPDEEP bit and SleepOnExit of Cortex System Control Register */
     SCB->SCR |= (uint32_t)((uint32_t)(SCB_SCR_SLEEPDEEP_Msk | SCB_SCR_SLEEPONEXIT_Msk));
   }
   /* USER CODE END 2 */

◆ HAL_PCDEx_SetConnectionState()

void HAL_PCDEx_SetConnectionState	(	PCD_HandleTypeDef *	hpcd,
		uint8_t	state
	)

Software Device Connection.

Parameters

hpcd	PCD handle
state	connection state (0 : disconnected / 1: connected)

Return values

None

 {
 /* USER CODE BEGIN 6 */
   if (state == 1)
   {
     /* Configure Low Connection State */
     
   }
   else
   {
     /* Configure High Connection State */
    
   } 
 /* USER CODE END 6 */

◆ SystemClockConfig_Resume()

static void SystemClockConfig_Resume ( void )

static

Configures system clock after wake-up from USB Resume CallBack: enable HSI, PLL and select PLL as system clock source.

Parameters

None

Return values

None

508 {

509 SystemClock_Config();

SystemClock_Config

void SystemClock_Config(void)

System Clock Configuration Configure and initialize the main, systick, timer and peripheral clocks...

Definition: main.c:206

◆ USBD_LL_ClearStallEP()

USBD_StatusTypeDef USBD_LL_ClearStallEP	(	USBD_HandleTypeDef *	pdev,
		uint8_t	ep_addr
	)

Clears a Stall condition on an endpoint of the Low Level Driver.

Parameters

pdev	Device handle
ep_addr	Endpoint Number

Return values

USBD Status

 {
   
   HAL_PCD_EP_ClrStall(pdev->pData, ep_addr);  
   return USBD_OK; 

◆ USBD_LL_CloseEP()

USBD_StatusTypeDef USBD_LL_CloseEP	(	USBD_HandleTypeDef *	pdev,
		uint8_t	ep_addr
	)

Closes an endpoint of the Low Level Driver.

Parameters

pdev	Device handle
ep_addr	Endpoint Number

Return values

USBD Status

 {
   
   HAL_PCD_EP_Close(pdev->pData, ep_addr);
   return USBD_OK; 

◆ USBD_LL_DeInit()

USBD_StatusTypeDef USBD_LL_DeInit ( USBD_HandleTypeDef * pdev )

De-Initializes the Low Level portion of the Device driver.

Parameters

pdev	Device handle

Return values

USBD Status

 {
   HAL_PCD_DeInit(pdev->pData);
   return USBD_OK; 

◆ USBD_LL_Delay()

void USBD_LL_Delay ( uint32_t Delay )

Delays routine for the USB Device Library.

Parameters

Delay Delay in ms

Return values

None

475 {

476 HAL_Delay(Delay);

◆ USBD_LL_FlushEP()

USBD_StatusTypeDef USBD_LL_FlushEP	(	USBD_HandleTypeDef *	pdev,
		uint8_t	ep_addr
	)

Flushes an endpoint of the Low Level Driver.

Parameters

pdev	Device handle
ep_addr	Endpoint Number

Return values

USBD Status

 {
   
   HAL_PCD_EP_Flush(pdev->pData, ep_addr);
   return USBD_OK; 

◆ USBD_LL_GetRxDataSize()

uint32_t USBD_LL_GetRxDataSize	(	USBD_HandleTypeDef *	pdev,
		uint8_t	ep_addr
	)

Returns the last transfered packet size.

Parameters

pdev	Device handle
ep_addr	Endpoint Number

Return values

Recived Data Size

465 {

466 return HAL_PCD_EP_GetRxCount(pdev->pData, ep_addr);

◆ USBD_LL_Init()

USBD_StatusTypeDef USBD_LL_Init ( USBD_HandleTypeDef * pdev )

Initializes the Low Level portion of the Device driver.

Parameters

pdev	Device handle

Return values

USBD Status

 { 
   /* Init USB_IP */
   /* Link The driver to the stack */
   hpcd_USB_FS.pData = pdev;
   pdev->pData = &hpcd_USB_FS;
 
   hpcd_USB_FS.Instance = USB;
   hpcd_USB_FS.Init.dev_endpoints = 5;
   hpcd_USB_FS.Init.speed = PCD_SPEED_FULL;
   hpcd_USB_FS.Init.ep0_mps = DEP0CTL_MPS_8;
   hpcd_USB_FS.Init.phy_itface = PCD_PHY_EMBEDDED;
   hpcd_USB_FS.Init.low_power_enable = DISABLE;
   hpcd_USB_FS.Init.battery_charging_enable = DISABLE;
   HAL_PCD_Init(&hpcd_USB_FS);
 
   HAL_PCDEx_PMAConfig(pdev->pData , 0x00 , PCD_SNG_BUF, 0x18);
   HAL_PCDEx_PMAConfig(pdev->pData , 0x80 , PCD_SNG_BUF, 0x58);
   HAL_PCDEx_PMAConfig(pdev->pData , 0x81 , PCD_SNG_BUF, 0xC0);  
   HAL_PCDEx_PMAConfig(pdev->pData , 0x01 , PCD_SNG_BUF, 0x110);
   HAL_PCDEx_PMAConfig(pdev->pData , 0x82 , PCD_SNG_BUF, 0x100);  
   return USBD_OK;

◆ USBD_LL_IsStallEP()

uint8_t USBD_LL_IsStallEP	(	USBD_HandleTypeDef *	pdev,
		uint8_t	ep_addr
	)

Returns Stall condition.

Parameters

pdev	Device handle
ep_addr	Endpoint Number

Return values

Stall (1: Yes, 0: No)

 {
   PCD_HandleTypeDef *hpcd = pdev->pData; 
   
   if((ep_addr & 0x80) == 0x80)
   {
     return hpcd->IN_ep[ep_addr & 0x7F].is_stall; 
   }
   else
   {
     return hpcd->OUT_ep[ep_addr & 0x7F].is_stall; 
   }

◆ USBD_LL_OpenEP()

USBD_StatusTypeDef USBD_LL_OpenEP	(	USBD_HandleTypeDef *	pdev,
		uint8_t	ep_addr,
		uint8_t	ep_type,
		uint16_t	ep_mps
	)

Opens an endpoint of the Low Level Driver.

Parameters

pdev	Device handle
ep_addr	Endpoint Number
ep_type	Endpoint Type
ep_mps	Endpoint Max Packet Size

Return values

USBD Status

 {
 
   HAL_PCD_EP_Open(pdev->pData, 
                   ep_addr, 
                   ep_mps, 
                   ep_type);
   
   return USBD_OK; 

◆ USBD_LL_PrepareReceive()

USBD_StatusTypeDef USBD_LL_PrepareReceive	(	USBD_HandleTypeDef *	pdev,
		uint8_t	ep_addr,
		uint8_t *	pbuf,
		uint16_t	size
	)

Prepares an endpoint for reception.

Parameters

pdev	Device handle
ep_addr	Endpoint Number
pbuf	Pointer to data to be received
size	Data size

Return values

USBD Status

 {
 
   HAL_PCD_EP_Receive(pdev->pData, ep_addr, pbuf, size);
   return USBD_OK;   

◆ USBD_LL_SetUSBAddress()

USBD_StatusTypeDef USBD_LL_SetUSBAddress	(	USBD_HandleTypeDef *	pdev,
		uint8_t	dev_addr
	)

Assigns a USB address to the device.

Parameters

pdev	Device handle
ep_addr	Endpoint Number

Return values

USBD Status

 {
   
   HAL_PCD_SetAddress(pdev->pData, dev_addr);
   return USBD_OK; 

◆ USBD_LL_StallEP()

USBD_StatusTypeDef USBD_LL_StallEP	(	USBD_HandleTypeDef *	pdev,
		uint8_t	ep_addr
	)

Sets a Stall condition on an endpoint of the Low Level Driver.

Parameters

pdev	Device handle
ep_addr	Endpoint Number

Return values

USBD Status

 {
   
   HAL_PCD_EP_SetStall(pdev->pData, ep_addr);
   return USBD_OK; 

◆ USBD_LL_Start()

USBD_StatusTypeDef USBD_LL_Start ( USBD_HandleTypeDef * pdev )

Starts the Low Level portion of the Device driver.

Parameters

pdev	Device handle

Return values

USBD Status

 {
   HAL_PCD_Start(pdev->pData);
   return USBD_OK; 

◆ USBD_LL_Stop()

USBD_StatusTypeDef USBD_LL_Stop ( USBD_HandleTypeDef * pdev )

Stops the Low Level portion of the Device driver.

Parameters

pdev	Device handle

Return values

USBD Status

 {
   HAL_PCD_Stop(pdev->pData);
   return USBD_OK; 

◆ USBD_LL_Transmit()

USBD_StatusTypeDef USBD_LL_Transmit	(	USBD_HandleTypeDef *	pdev,
		uint8_t	ep_addr,
		uint8_t *	pbuf,
		uint16_t	size
	)

Transmits data over an endpoint.

Parameters

pdev	Device handle
ep_addr	Endpoint Number
pbuf	Pointer to data to be sent
size	Data size

Return values

USBD Status

 {
 
   HAL_PCD_EP_Transmit(pdev->pData, ep_addr, pbuf, size);
   return USBD_OK;   

Functions

Variables

Detailed Description

Function Documentation

◆ HAL_PCD_ConnectCallback()

◆ HAL_PCD_DataInStageCallback()

◆ HAL_PCD_DataOutStageCallback()

◆ HAL_PCD_DisconnectCallback()

◆ HAL_PCD_ISOINIncompleteCallback()

◆ HAL_PCD_ISOOUTIncompleteCallback()

◆ HAL_PCD_ResetCallback()

◆ HAL_PCD_ResumeCallback()

◆ HAL_PCD_SetupStageCallback()

◆ HAL_PCD_SOFCallback()

◆ HAL_PCD_SuspendCallback()

◆ HAL_PCDEx_SetConnectionState()

◆ SystemClockConfig_Resume()

◆ USBD_LL_ClearStallEP()

◆ USBD_LL_CloseEP()

◆ USBD_LL_DeInit()

◆ USBD_LL_Delay()

◆ USBD_LL_FlushEP()

◆ USBD_LL_GetRxDataSize()

◆ USBD_LL_Init()

◆ USBD_LL_IsStallEP()

◆ USBD_LL_OpenEP()

◆ USBD_LL_PrepareReceive()

◆ USBD_LL_SetUSBAddress()

◆ USBD_LL_StallEP()

◆ USBD_LL_Start()

◆ USBD_LL_Stop()

◆ USBD_LL_Transmit()