Merge pull request #10558 from iNavFlight/MrD_Correct-comments-on-OSD-symbols
[inav.git] / lib / main / STM32F7 / Drivers / STM32F7xx_HAL_Driver / Src / stm32f7xx_ll_usb.c
blobffc4f247fe7fea652d7a0efc303428df958cefc9
1 /**
2 ******************************************************************************
3 * @file stm32f7xx_ll_usb.c
4 * @author MCD Application Team
5 * @version V1.2.2
6 * @date 14-April-2017
7 * @brief USB Low Layer HAL module driver.
9 * This file provides firmware functions to manage the following
10 * functionalities of the USB Peripheral Controller:
11 * + Initialization/de-initialization functions
12 * + I/O operation functions
13 * + Peripheral Control functions
14 * + Peripheral State functions
16 @verbatim
17 ==============================================================================
18 ##### How to use this driver #####
19 ==============================================================================
20 [..]
21 (#) Fill parameters of Init structure in USB_OTG_CfgTypeDef structure.
23 (#) Call USB_CoreInit() API to initialize the USB Core peripheral.
25 (#) The upper HAL HCD/PCD driver will call the right routines for its internal processes.
27 @endverbatim
28 ******************************************************************************
29 * @attention
31 * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
33 * Redistribution and use in source and binary forms, with or without modification,
34 * are permitted provided that the following conditions are met:
35 * 1. Redistributions of source code must retain the above copyright notice,
36 * this list of conditions and the following disclaimer.
37 * 2. Redistributions in binary form must reproduce the above copyright notice,
38 * this list of conditions and the following disclaimer in the documentation
39 * and/or other materials provided with the distribution.
40 * 3. Neither the name of STMicroelectronics nor the names of its contributors
41 * may be used to endorse or promote products derived from this software
42 * without specific prior written permission.
44 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
45 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
46 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
47 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
48 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
49 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
50 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
51 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
52 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
53 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
55 ******************************************************************************
58 /* Includes ------------------------------------------------------------------*/
59 #include "stm32f7xx_hal.h"
61 /** @addtogroup STM32F7xx_LL_USB_DRIVER
62 * @{
65 #if defined (HAL_PCD_MODULE_ENABLED) || defined (HAL_HCD_MODULE_ENABLED)
67 /* Private typedef -----------------------------------------------------------*/
68 /* Private define ------------------------------------------------------------*/
69 /* Private macro -------------------------------------------------------------*/
70 /* Private variables ---------------------------------------------------------*/
71 /* Private function prototypes -----------------------------------------------*/
72 /* Private functions ---------------------------------------------------------*/
73 static HAL_StatusTypeDef USB_CoreReset(USB_OTG_GlobalTypeDef *USBx);
75 #ifdef USB_HS_PHYC
76 static HAL_StatusTypeDef USB_HS_PHYCInit(USB_OTG_GlobalTypeDef *USBx);
77 #endif
79 /* Exported functions --------------------------------------------------------*/
80 /** @defgroup LL_USB_Exported_Functions USB Low Layer Exported Functions
81 * @{
84 /** @defgroup LL_USB_Group1 Initialization/de-initialization functions
85 * @brief Initialization and Configuration functions
87 @verbatim
88 ===============================================================================
89 ##### Initialization/de-initialization functions #####
90 ===============================================================================
91 [..] This section provides functions allowing to:
93 @endverbatim
94 * @{
97 /**
98 * @brief Initializes the USB Core
99 * @param USBx: USB Instance
100 * @param cfg : pointer to a USB_OTG_CfgTypeDef structure that contains
101 * the configuration information for the specified USBx peripheral.
102 * @retval HAL status
104 HAL_StatusTypeDef USB_CoreInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg)
106 if (cfg.phy_itface == USB_OTG_ULPI_PHY)
109 USBx->GCCFG &= ~(USB_OTG_GCCFG_PWRDWN);
111 /* Init The ULPI Interface */
112 USBx->GUSBCFG &= ~(USB_OTG_GUSBCFG_TSDPS | USB_OTG_GUSBCFG_ULPIFSLS | USB_OTG_GUSBCFG_PHYSEL);
114 /* Select vbus source */
115 USBx->GUSBCFG &= ~(USB_OTG_GUSBCFG_ULPIEVBUSD | USB_OTG_GUSBCFG_ULPIEVBUSI);
116 if(cfg.use_external_vbus == 1)
118 USBx->GUSBCFG |= USB_OTG_GUSBCFG_ULPIEVBUSD;
120 /* Reset after a PHY select */
121 USB_CoreReset(USBx);
123 #ifdef USB_HS_PHYC
125 else if (cfg.phy_itface == USB_OTG_HS_EMBEDDED_PHY)
127 USBx->GCCFG &= ~(USB_OTG_GCCFG_PWRDWN);
129 /* Init The UTMI Interface */
130 USBx->GUSBCFG &= ~(USB_OTG_GUSBCFG_TSDPS | USB_OTG_GUSBCFG_ULPIFSLS | USB_OTG_GUSBCFG_PHYSEL);
132 /* Select vbus source */
133 USBx->GUSBCFG &= ~(USB_OTG_GUSBCFG_ULPIEVBUSD | USB_OTG_GUSBCFG_ULPIEVBUSI);
135 /* Select UTMI Interace */
136 USBx->GUSBCFG &= ~ USB_OTG_GUSBCFG_ULPI_UTMI_SEL;
137 USBx->GCCFG |= USB_OTG_GCCFG_PHYHSEN;
139 /* Enables control of a High Speed USB PHY */
140 USB_HS_PHYCInit(USBx);
142 if(cfg.use_external_vbus == 1)
144 USBx->GUSBCFG |= USB_OTG_GUSBCFG_ULPIEVBUSD;
146 /* Reset after a PHY select */
147 USB_CoreReset(USBx);
150 #endif
151 else /* FS interface (embedded Phy) */
153 /* Select FS Embedded PHY */
154 USBx->GUSBCFG |= USB_OTG_GUSBCFG_PHYSEL;
156 /* Reset after a PHY select and set Host mode */
157 USB_CoreReset(USBx);
159 /* Deactivate the power down*/
160 USBx->GCCFG = USB_OTG_GCCFG_PWRDWN;
163 if(cfg.dma_enable == ENABLE)
165 USBx->GAHBCFG |= USB_OTG_GAHBCFG_HBSTLEN_2;
166 USBx->GAHBCFG |= USB_OTG_GAHBCFG_DMAEN;
169 return HAL_OK;
173 * @brief USB_EnableGlobalInt
174 * Enables the controller's Global Int in the AHB Config reg
175 * @param USBx : Selected device
176 * @retval HAL status
178 HAL_StatusTypeDef USB_EnableGlobalInt(USB_OTG_GlobalTypeDef *USBx)
180 USBx->GAHBCFG |= USB_OTG_GAHBCFG_GINT;
181 return HAL_OK;
186 * @brief USB_DisableGlobalInt
187 * Disable the controller's Global Int in the AHB Config reg
188 * @param USBx : Selected device
189 * @retval HAL status
191 HAL_StatusTypeDef USB_DisableGlobalInt(USB_OTG_GlobalTypeDef *USBx)
193 USBx->GAHBCFG &= ~USB_OTG_GAHBCFG_GINT;
194 return HAL_OK;
198 * @brief USB_SetCurrentMode : Set functional mode
199 * @param USBx : Selected device
200 * @param mode : current core mode
201 * This parameter can be one of these values:
202 * @arg USB_OTG_DEVICE_MODE: Peripheral mode
203 * @arg USB_OTG_HOST_MODE: Host mode
204 * @arg USB_OTG_DRD_MODE: Dual Role Device mode
205 * @retval HAL status
207 HAL_StatusTypeDef USB_SetCurrentMode(USB_OTG_GlobalTypeDef *USBx , USB_OTG_ModeTypeDef mode)
209 USBx->GUSBCFG &= ~(USB_OTG_GUSBCFG_FHMOD | USB_OTG_GUSBCFG_FDMOD);
211 if ( mode == USB_OTG_HOST_MODE)
213 USBx->GUSBCFG |= USB_OTG_GUSBCFG_FHMOD;
215 else if ( mode == USB_OTG_DEVICE_MODE)
217 USBx->GUSBCFG |= USB_OTG_GUSBCFG_FDMOD;
219 HAL_Delay(50);
221 return HAL_OK;
225 * @brief USB_DevInit : Initializes the USB_OTG controller registers
226 * for device mode
227 * @param USBx : Selected device
228 * @param cfg : pointer to a USB_OTG_CfgTypeDef structure that contains
229 * the configuration information for the specified USBx peripheral.
230 * @retval HAL status
232 HAL_StatusTypeDef USB_DevInit (USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg)
234 uint32_t i = 0;
236 /*Activate VBUS Sensing B */
237 USBx->GCCFG |= USB_OTG_GCCFG_VBDEN;
239 if (cfg.vbus_sensing_enable == 0)
241 /* Deactivate VBUS Sensing B */
242 USBx->GCCFG &= ~ USB_OTG_GCCFG_VBDEN;
244 /* B-peripheral session valid override enable*/
245 USBx->GOTGCTL |= USB_OTG_GOTGCTL_BVALOEN;
246 USBx->GOTGCTL |= USB_OTG_GOTGCTL_BVALOVAL;
249 /* Restart the Phy Clock */
250 USBx_PCGCCTL = 0;
252 /* Device mode configuration */
253 USBx_DEVICE->DCFG |= DCFG_FRAME_INTERVAL_80;
255 if(cfg.phy_itface == USB_OTG_ULPI_PHY)
257 if(cfg.speed == USB_OTG_SPEED_HIGH)
259 /* Set High speed phy */
260 USB_SetDevSpeed (USBx , USB_OTG_SPEED_HIGH);
262 else
264 /* set High speed phy in Full speed mode */
265 USB_SetDevSpeed (USBx , USB_OTG_SPEED_HIGH_IN_FULL);
269 else if(cfg.phy_itface == USB_OTG_HS_EMBEDDED_PHY)
271 if(cfg.speed == USB_OTG_SPEED_HIGH)
273 /* Set High speed phy */
274 USB_SetDevSpeed (USBx , USB_OTG_SPEED_HIGH);
276 else
278 /* set High speed phy in Full speed mode */
279 USB_SetDevSpeed (USBx , USB_OTG_SPEED_HIGH_IN_FULL);
283 else
285 /* Set Full speed phy */
286 USB_SetDevSpeed (USBx , USB_OTG_SPEED_FULL);
289 /* Flush the FIFOs */
290 USB_FlushTxFifo(USBx , 0x10); /* all Tx FIFOs */
291 USB_FlushRxFifo(USBx);
293 /* Clear all pending Device Interrupts */
294 USBx_DEVICE->DIEPMSK = 0;
295 USBx_DEVICE->DOEPMSK = 0;
296 USBx_DEVICE->DAINT = 0xFFFFFFFF;
297 USBx_DEVICE->DAINTMSK = 0;
299 for (i = 0; i < cfg.dev_endpoints; i++)
301 if ((USBx_INEP(i)->DIEPCTL & USB_OTG_DIEPCTL_EPENA) == USB_OTG_DIEPCTL_EPENA)
303 USBx_INEP(i)->DIEPCTL = (USB_OTG_DIEPCTL_EPDIS | USB_OTG_DIEPCTL_SNAK);
305 else
307 USBx_INEP(i)->DIEPCTL = 0;
310 USBx_INEP(i)->DIEPTSIZ = 0;
311 USBx_INEP(i)->DIEPINT = 0xFF;
314 for (i = 0; i < cfg.dev_endpoints; i++)
316 if ((USBx_OUTEP(i)->DOEPCTL & USB_OTG_DOEPCTL_EPENA) == USB_OTG_DOEPCTL_EPENA)
318 USBx_OUTEP(i)->DOEPCTL = (USB_OTG_DOEPCTL_EPDIS | USB_OTG_DOEPCTL_SNAK);
320 else
322 USBx_OUTEP(i)->DOEPCTL = 0;
325 USBx_OUTEP(i)->DOEPTSIZ = 0;
326 USBx_OUTEP(i)->DOEPINT = 0xFF;
329 USBx_DEVICE->DIEPMSK &= ~(USB_OTG_DIEPMSK_TXFURM);
331 if (cfg.dma_enable == 1)
333 /*Set threshold parameters */
334 USBx_DEVICE->DTHRCTL = (USB_OTG_DTHRCTL_TXTHRLEN_6 | USB_OTG_DTHRCTL_RXTHRLEN_6);
335 USBx_DEVICE->DTHRCTL |= (USB_OTG_DTHRCTL_RXTHREN | USB_OTG_DTHRCTL_ISOTHREN | USB_OTG_DTHRCTL_NONISOTHREN);
337 i= USBx_DEVICE->DTHRCTL;
340 /* Disable all interrupts. */
341 USBx->GINTMSK = 0;
343 /* Clear any pending interrupts */
344 USBx->GINTSTS = 0xBFFFFFFF;
346 /* Enable the common interrupts */
347 if (cfg.dma_enable == DISABLE)
349 USBx->GINTMSK |= USB_OTG_GINTMSK_RXFLVLM;
352 /* Enable interrupts matching to the Device mode ONLY */
353 USBx->GINTMSK |= (USB_OTG_GINTMSK_USBSUSPM | USB_OTG_GINTMSK_USBRST |\
354 USB_OTG_GINTMSK_ENUMDNEM | USB_OTG_GINTMSK_IEPINT |\
355 USB_OTG_GINTMSK_OEPINT | USB_OTG_GINTMSK_IISOIXFRM|\
356 USB_OTG_GINTMSK_PXFRM_IISOOXFRM | USB_OTG_GINTMSK_WUIM);
358 if(cfg.Sof_enable)
360 USBx->GINTMSK |= USB_OTG_GINTMSK_SOFM;
363 if (cfg.vbus_sensing_enable == ENABLE)
365 USBx->GINTMSK |= (USB_OTG_GINTMSK_SRQIM | USB_OTG_GINTMSK_OTGINT);
368 return HAL_OK;
373 * @brief USB_OTG_FlushTxFifo : Flush a Tx FIFO
374 * @param USBx : Selected device
375 * @param num : FIFO number
376 * This parameter can be a value from 1 to 15
377 15 means Flush all Tx FIFOs
378 * @retval HAL status
380 HAL_StatusTypeDef USB_FlushTxFifo (USB_OTG_GlobalTypeDef *USBx, uint32_t num )
382 uint32_t count = 0;
384 USBx->GRSTCTL = ( USB_OTG_GRSTCTL_TXFFLSH |(uint32_t)( num << 6));
388 if (++count > 200000)
390 return HAL_TIMEOUT;
393 while ((USBx->GRSTCTL & USB_OTG_GRSTCTL_TXFFLSH) == USB_OTG_GRSTCTL_TXFFLSH);
395 return HAL_OK;
400 * @brief USB_FlushRxFifo : Flush Rx FIFO
401 * @param USBx : Selected device
402 * @retval HAL status
404 HAL_StatusTypeDef USB_FlushRxFifo(USB_OTG_GlobalTypeDef *USBx)
406 uint32_t count = 0;
408 USBx->GRSTCTL = USB_OTG_GRSTCTL_RXFFLSH;
412 if (++count > 200000)
414 return HAL_TIMEOUT;
417 while ((USBx->GRSTCTL & USB_OTG_GRSTCTL_RXFFLSH) == USB_OTG_GRSTCTL_RXFFLSH);
419 return HAL_OK;
423 * @brief USB_SetDevSpeed :Initializes the DevSpd field of DCFG register
424 * depending the PHY type and the enumeration speed of the device.
425 * @param USBx : Selected device
426 * @param speed : device speed
427 * This parameter can be one of these values:
428 * @arg USB_OTG_SPEED_HIGH: High speed mode
429 * @arg USB_OTG_SPEED_HIGH_IN_FULL: High speed core in Full Speed mode
430 * @arg USB_OTG_SPEED_FULL: Full speed mode
431 * @arg USB_OTG_SPEED_LOW: Low speed mode
432 * @retval Hal status
434 HAL_StatusTypeDef USB_SetDevSpeed(USB_OTG_GlobalTypeDef *USBx , uint8_t speed)
436 USBx_DEVICE->DCFG |= speed;
437 return HAL_OK;
441 * @brief USB_GetDevSpeed :Return the Dev Speed
442 * @param USBx : Selected device
443 * @retval speed : device speed
444 * This parameter can be one of these values:
445 * @arg USB_OTG_SPEED_HIGH: High speed mode
446 * @arg USB_OTG_SPEED_FULL: Full speed mode
447 * @arg USB_OTG_SPEED_LOW: Low speed mode
449 uint8_t USB_GetDevSpeed(USB_OTG_GlobalTypeDef *USBx)
451 uint8_t speed = 0;
453 if((USBx_DEVICE->DSTS & USB_OTG_DSTS_ENUMSPD) == DSTS_ENUMSPD_HS_PHY_30MHZ_OR_60MHZ)
455 speed = USB_OTG_SPEED_HIGH;
457 else if (((USBx_DEVICE->DSTS & USB_OTG_DSTS_ENUMSPD) == DSTS_ENUMSPD_FS_PHY_30MHZ_OR_60MHZ)||
458 ((USBx_DEVICE->DSTS & USB_OTG_DSTS_ENUMSPD) == DSTS_ENUMSPD_FS_PHY_48MHZ))
460 speed = USB_OTG_SPEED_FULL;
462 else if((USBx_DEVICE->DSTS & USB_OTG_DSTS_ENUMSPD) == DSTS_ENUMSPD_LS_PHY_6MHZ)
464 speed = USB_OTG_SPEED_LOW;
467 return speed;
471 * @brief Activate and configure an endpoint
472 * @param USBx : Selected device
473 * @param ep: pointer to endpoint structure
474 * @retval HAL status
476 HAL_StatusTypeDef USB_ActivateEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
478 if (ep->is_in == 1)
480 USBx_DEVICE->DAINTMSK |= USB_OTG_DAINTMSK_IEPM & ((1 << (ep->num)));
482 if (((USBx_INEP(ep->num)->DIEPCTL) & USB_OTG_DIEPCTL_USBAEP) == 0)
484 USBx_INEP(ep->num)->DIEPCTL |= ((ep->maxpacket & USB_OTG_DIEPCTL_MPSIZ ) | (ep->type << 18 ) |\
485 ((ep->num) << 22 ) | (USB_OTG_DIEPCTL_SD0PID_SEVNFRM) | (USB_OTG_DIEPCTL_USBAEP));
489 else
491 USBx_DEVICE->DAINTMSK |= USB_OTG_DAINTMSK_OEPM & ((1 << (ep->num)) << 16);
493 if (((USBx_OUTEP(ep->num)->DOEPCTL) & USB_OTG_DOEPCTL_USBAEP) == 0)
495 USBx_OUTEP(ep->num)->DOEPCTL |= ((ep->maxpacket & USB_OTG_DOEPCTL_MPSIZ ) | (ep->type << 18 ) |\
496 (USB_OTG_DIEPCTL_SD0PID_SEVNFRM)| (USB_OTG_DOEPCTL_USBAEP));
499 return HAL_OK;
502 * @brief Activate and configure a dedicated endpoint
503 * @param USBx : Selected device
504 * @param ep: pointer to endpoint structure
505 * @retval HAL status
507 HAL_StatusTypeDef USB_ActivateDedicatedEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
509 static __IO uint32_t debug = 0;
511 /* Read DEPCTLn register */
512 if (ep->is_in == 1)
514 if (((USBx_INEP(ep->num)->DIEPCTL) & USB_OTG_DIEPCTL_USBAEP) == 0)
516 USBx_INEP(ep->num)->DIEPCTL |= ((ep->maxpacket & USB_OTG_DIEPCTL_MPSIZ ) | (ep->type << 18 ) |\
517 ((ep->num) << 22 ) | (USB_OTG_DIEPCTL_SD0PID_SEVNFRM) | (USB_OTG_DIEPCTL_USBAEP));
521 debug |= ((ep->maxpacket & USB_OTG_DIEPCTL_MPSIZ ) | (ep->type << 18 ) |\
522 ((ep->num) << 22 ) | (USB_OTG_DIEPCTL_SD0PID_SEVNFRM) | (USB_OTG_DIEPCTL_USBAEP));
524 USBx_DEVICE->DEACHMSK |= USB_OTG_DAINTMSK_IEPM & ((1 << (ep->num)));
526 else
528 if (((USBx_OUTEP(ep->num)->DOEPCTL) & USB_OTG_DOEPCTL_USBAEP) == 0)
530 USBx_OUTEP(ep->num)->DOEPCTL |= ((ep->maxpacket & USB_OTG_DOEPCTL_MPSIZ ) | (ep->type << 18 ) |\
531 ((ep->num) << 22 ) | (USB_OTG_DOEPCTL_USBAEP));
533 debug = (uint32_t)(((uint32_t )USBx) + USB_OTG_OUT_ENDPOINT_BASE + (0)*USB_OTG_EP_REG_SIZE);
534 debug = (uint32_t )&USBx_OUTEP(ep->num)->DOEPCTL;
535 debug |= ((ep->maxpacket & USB_OTG_DOEPCTL_MPSIZ ) | (ep->type << 18 ) |\
536 ((ep->num) << 22 ) | (USB_OTG_DOEPCTL_USBAEP));
539 USBx_DEVICE->DEACHMSK |= USB_OTG_DAINTMSK_OEPM & ((1 << (ep->num)) << 16);
542 return HAL_OK;
545 * @brief De-activate and de-initialize an endpoint
546 * @param USBx : Selected device
547 * @param ep: pointer to endpoint structure
548 * @retval HAL status
550 HAL_StatusTypeDef USB_DeactivateEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
552 /* Read DEPCTLn register */
553 if (ep->is_in == 1)
555 USBx_DEVICE->DEACHMSK &= ~(USB_OTG_DAINTMSK_IEPM & ((1 << (ep->num))));
556 USBx_DEVICE->DAINTMSK &= ~(USB_OTG_DAINTMSK_IEPM & ((1 << (ep->num))));
557 USBx_INEP(ep->num)->DIEPCTL &= ~ USB_OTG_DIEPCTL_USBAEP;
559 else
561 USBx_DEVICE->DEACHMSK &= ~(USB_OTG_DAINTMSK_OEPM & ((1 << (ep->num)) << 16));
562 USBx_DEVICE->DAINTMSK &= ~(USB_OTG_DAINTMSK_OEPM & ((1 << (ep->num)) << 16));
563 USBx_OUTEP(ep->num)->DOEPCTL &= ~USB_OTG_DOEPCTL_USBAEP;
565 return HAL_OK;
569 * @brief De-activate and de-initialize a dedicated endpoint
570 * @param USBx : Selected device
571 * @param ep: pointer to endpoint structure
572 * @retval HAL status
574 HAL_StatusTypeDef USB_DeactivateDedicatedEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
576 /* Read DEPCTLn register */
577 if (ep->is_in == 1)
579 USBx_INEP(ep->num)->DIEPCTL &= ~ USB_OTG_DIEPCTL_USBAEP;
580 USBx_DEVICE->DAINTMSK &= ~(USB_OTG_DAINTMSK_IEPM & ((1 << (ep->num))));
582 else
584 USBx_OUTEP(ep->num)->DOEPCTL &= ~USB_OTG_DOEPCTL_USBAEP;
585 USBx_DEVICE->DAINTMSK &= ~(USB_OTG_DAINTMSK_OEPM & ((1 << (ep->num)) << 16));
587 return HAL_OK;
591 * @brief USB_EPStartXfer : setup and starts a transfer over an EP
592 * @param USBx : Selected device
593 * @param ep: pointer to endpoint structure
594 * @param dma: USB dma enabled or disabled
595 * This parameter can be one of these values:
596 * 0 : DMA feature not used
597 * 1 : DMA feature used
598 * @retval HAL status
600 HAL_StatusTypeDef USB_EPStartXfer(USB_OTG_GlobalTypeDef *USBx , USB_OTG_EPTypeDef *ep, uint8_t dma)
602 uint16_t pktcnt = 0;
604 /* IN endpoint */
605 if (ep->is_in == 1)
607 /* Zero Length Packet? */
608 if (ep->xfer_len == 0)
610 USBx_INEP(ep->num)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_PKTCNT);
611 USBx_INEP(ep->num)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_PKTCNT & (1 << 19)) ;
612 USBx_INEP(ep->num)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_XFRSIZ);
614 else
616 /* Program the transfer size and packet count
617 * as follows: xfersize = N * maxpacket +
618 * short_packet pktcnt = N + (short_packet
619 * exist ? 1 : 0)
621 USBx_INEP(ep->num)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_XFRSIZ);
622 USBx_INEP(ep->num)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_PKTCNT);
623 USBx_INEP(ep->num)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_PKTCNT & (((ep->xfer_len + ep->maxpacket -1)/ ep->maxpacket) << 19)) ;
624 USBx_INEP(ep->num)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_XFRSIZ & ep->xfer_len);
626 if (ep->type == EP_TYPE_ISOC)
628 USBx_INEP(ep->num)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_MULCNT);
629 USBx_INEP(ep->num)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_MULCNT & (1 << 29));
633 if (dma == 1)
635 USBx_INEP(ep->num)->DIEPDMA = (uint32_t)(ep->dma_addr);
637 else
639 if (ep->type != EP_TYPE_ISOC)
641 /* Enable the Tx FIFO Empty Interrupt for this EP */
642 if (ep->xfer_len > 0)
644 USBx_DEVICE->DIEPEMPMSK |= 1 << ep->num;
649 if (ep->type == EP_TYPE_ISOC)
651 if ((USBx_DEVICE->DSTS & ( 1 << 8 )) == 0)
653 USBx_INEP(ep->num)->DIEPCTL |= USB_OTG_DIEPCTL_SODDFRM;
655 else
657 USBx_INEP(ep->num)->DIEPCTL |= USB_OTG_DIEPCTL_SD0PID_SEVNFRM;
661 /* EP enable, IN data in FIFO */
662 USBx_INEP(ep->num)->DIEPCTL |= (USB_OTG_DIEPCTL_CNAK | USB_OTG_DIEPCTL_EPENA);
664 if (ep->type == EP_TYPE_ISOC)
666 USB_WritePacket(USBx, ep->xfer_buff, ep->num, ep->xfer_len, dma);
669 else /* OUT endpoint */
671 /* Program the transfer size and packet count as follows:
672 * pktcnt = N
673 * xfersize = N * maxpacket
675 USBx_OUTEP(ep->num)->DOEPTSIZ &= ~(USB_OTG_DOEPTSIZ_XFRSIZ);
676 USBx_OUTEP(ep->num)->DOEPTSIZ &= ~(USB_OTG_DOEPTSIZ_PKTCNT);
678 if (ep->xfer_len == 0)
680 USBx_OUTEP(ep->num)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_XFRSIZ & ep->maxpacket);
681 USBx_OUTEP(ep->num)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_PKTCNT & (1 << 19)) ;
683 else
685 pktcnt = (ep->xfer_len + ep->maxpacket -1)/ ep->maxpacket;
686 USBx_OUTEP(ep->num)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_PKTCNT & (pktcnt << 19));
687 USBx_OUTEP(ep->num)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_XFRSIZ & (ep->maxpacket * pktcnt));
690 if (dma == 1)
692 USBx_OUTEP(ep->num)->DOEPDMA = (uint32_t)ep->xfer_buff;
695 if (ep->type == EP_TYPE_ISOC)
697 if ((USBx_DEVICE->DSTS & ( 1 << 8 )) == 0)
699 USBx_OUTEP(ep->num)->DOEPCTL |= USB_OTG_DOEPCTL_SODDFRM;
701 else
703 USBx_OUTEP(ep->num)->DOEPCTL |= USB_OTG_DOEPCTL_SD0PID_SEVNFRM;
706 /* EP enable */
707 USBx_OUTEP(ep->num)->DOEPCTL |= (USB_OTG_DOEPCTL_CNAK | USB_OTG_DOEPCTL_EPENA);
709 return HAL_OK;
713 * @brief USB_EP0StartXfer : setup and starts a transfer over the EP 0
714 * @param USBx : Selected device
715 * @param ep: pointer to endpoint structure
716 * @param dma: USB dma enabled or disabled
717 * This parameter can be one of these values:
718 * 0 : DMA feature not used
719 * 1 : DMA feature used
720 * @retval HAL status
722 HAL_StatusTypeDef USB_EP0StartXfer(USB_OTG_GlobalTypeDef *USBx , USB_OTG_EPTypeDef *ep, uint8_t dma)
724 /* IN endpoint */
725 if (ep->is_in == 1)
727 /* Zero Length Packet? */
728 if (ep->xfer_len == 0)
730 USBx_INEP(ep->num)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_PKTCNT);
731 USBx_INEP(ep->num)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_PKTCNT & (1 << 19)) ;
732 USBx_INEP(ep->num)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_XFRSIZ);
734 else
736 /* Program the transfer size and packet count
737 * as follows: xfersize = N * maxpacket +
738 * short_packet pktcnt = N + (short_packet
739 * exist ? 1 : 0)
741 USBx_INEP(ep->num)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_XFRSIZ);
742 USBx_INEP(ep->num)->DIEPTSIZ &= ~(USB_OTG_DIEPTSIZ_PKTCNT);
744 if(ep->xfer_len > ep->maxpacket)
746 ep->xfer_len = ep->maxpacket;
748 USBx_INEP(ep->num)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_PKTCNT & (1 << 19)) ;
749 USBx_INEP(ep->num)->DIEPTSIZ |= (USB_OTG_DIEPTSIZ_XFRSIZ & ep->xfer_len);
753 /* EP enable, IN data in FIFO */
754 USBx_INEP(ep->num)->DIEPCTL |= (USB_OTG_DIEPCTL_CNAK | USB_OTG_DIEPCTL_EPENA);
756 if (dma == 1)
758 USBx_INEP(ep->num)->DIEPDMA = (uint32_t)(ep->dma_addr);
760 else
762 /* Enable the Tx FIFO Empty Interrupt for this EP */
763 if (ep->xfer_len > 0U)
765 USBx_DEVICE->DIEPEMPMSK |= 1U << (ep->num);
769 else /* OUT endpoint */
771 /* Program the transfer size and packet count as follows:
772 * pktcnt = N
773 * xfersize = N * maxpacket
775 USBx_OUTEP(ep->num)->DOEPTSIZ &= ~(USB_OTG_DOEPTSIZ_XFRSIZ);
776 USBx_OUTEP(ep->num)->DOEPTSIZ &= ~(USB_OTG_DOEPTSIZ_PKTCNT);
778 if (ep->xfer_len > 0)
780 ep->xfer_len = ep->maxpacket;
783 USBx_OUTEP(ep->num)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_PKTCNT & (1 << 19));
784 USBx_OUTEP(ep->num)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_XFRSIZ & (ep->maxpacket));
787 if (dma == 1)
789 USBx_OUTEP(ep->num)->DOEPDMA = (uint32_t)(ep->xfer_buff);
792 /* EP enable */
793 USBx_OUTEP(ep->num)->DOEPCTL |= (USB_OTG_DOEPCTL_CNAK | USB_OTG_DOEPCTL_EPENA);
795 return HAL_OK;
799 * @brief USB_WritePacket : Writes a packet into the Tx FIFO associated
800 * with the EP/channel
801 * @param USBx : Selected device
802 * @param src : pointer to source buffer
803 * @param ch_ep_num : endpoint or host channel number
804 * @param len : Number of bytes to write
805 * @param dma: USB dma enabled or disabled
806 * This parameter can be one of these values:
807 * 0 : DMA feature not used
808 * 1 : DMA feature used
809 * @retval HAL status
811 HAL_StatusTypeDef USB_WritePacket(USB_OTG_GlobalTypeDef *USBx, uint8_t *src, uint8_t ch_ep_num, uint16_t len, uint8_t dma)
813 uint32_t count32b= 0 , i= 0;
815 if (dma == 0)
817 count32b = (len + 3) / 4;
818 for (i = 0; i < count32b; i++, src += 4)
820 USBx_DFIFO(ch_ep_num) = *((uint32_t *)src);
823 return HAL_OK;
827 * @brief USB_ReadPacket : read a packet from the Tx FIFO associated
828 * with the EP/channel
829 * @param USBx : Selected device
830 * @param src : source pointer
831 * @param ch_ep_num : endpoint or host channel number
832 * @param len : Number of bytes to read
833 * @param dma: USB dma enabled or disabled
834 * This parameter can be one of these values:
835 * 0 : DMA feature not used
836 * 1 : DMA feature used
837 * @retval pointer to destination buffer
839 void *USB_ReadPacket(USB_OTG_GlobalTypeDef *USBx, uint8_t *dest, uint16_t len)
841 uint32_t i=0;
842 uint32_t count32b = (len + 3) / 4;
844 for ( i = 0; i < count32b; i++, dest += 4 )
846 *(uint32_t *)dest = USBx_DFIFO(0);
849 return ((void *)dest);
853 * @brief USB_EPSetStall : set a stall condition over an EP
854 * @param USBx : Selected device
855 * @param ep: pointer to endpoint structure
856 * @retval HAL status
858 HAL_StatusTypeDef USB_EPSetStall(USB_OTG_GlobalTypeDef *USBx , USB_OTG_EPTypeDef *ep)
860 if (ep->is_in == 1)
862 if (((USBx_INEP(ep->num)->DIEPCTL) & USB_OTG_DIEPCTL_EPENA) == 0)
864 USBx_INEP(ep->num)->DIEPCTL &= ~(USB_OTG_DIEPCTL_EPDIS);
866 USBx_INEP(ep->num)->DIEPCTL |= USB_OTG_DIEPCTL_STALL;
868 else
870 if (((USBx_OUTEP(ep->num)->DOEPCTL) & USB_OTG_DOEPCTL_EPENA) == 0)
872 USBx_OUTEP(ep->num)->DOEPCTL &= ~(USB_OTG_DOEPCTL_EPDIS);
874 USBx_OUTEP(ep->num)->DOEPCTL |= USB_OTG_DOEPCTL_STALL;
876 return HAL_OK;
881 * @brief USB_EPClearStall : Clear a stall condition over an EP
882 * @param USBx : Selected device
883 * @param ep: pointer to endpoint structure
884 * @retval HAL status
886 HAL_StatusTypeDef USB_EPClearStall(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep)
888 if (ep->is_in == 1)
890 USBx_INEP(ep->num)->DIEPCTL &= ~USB_OTG_DIEPCTL_STALL;
891 if (ep->type == EP_TYPE_INTR || ep->type == EP_TYPE_BULK)
893 USBx_INEP(ep->num)->DIEPCTL |= USB_OTG_DIEPCTL_SD0PID_SEVNFRM; /* DATA0 */
896 else
898 USBx_OUTEP(ep->num)->DOEPCTL &= ~USB_OTG_DOEPCTL_STALL;
899 if (ep->type == EP_TYPE_INTR || ep->type == EP_TYPE_BULK)
901 USBx_OUTEP(ep->num)->DOEPCTL |= USB_OTG_DOEPCTL_SD0PID_SEVNFRM; /* DATA0 */
904 return HAL_OK;
908 * @brief USB_StopDevice : Stop the usb device mode
909 * @param USBx : Selected device
910 * @retval HAL status
912 HAL_StatusTypeDef USB_StopDevice(USB_OTG_GlobalTypeDef *USBx)
914 uint32_t i;
916 /* Clear Pending interrupt */
917 for (i = 0; i < 15 ; i++)
919 USBx_INEP(i)->DIEPINT = 0xFF;
920 USBx_OUTEP(i)->DOEPINT = 0xFF;
922 USBx_DEVICE->DAINT = 0xFFFFFFFF;
924 /* Clear interrupt masks */
925 USBx_DEVICE->DIEPMSK = 0;
926 USBx_DEVICE->DOEPMSK = 0;
927 USBx_DEVICE->DAINTMSK = 0;
929 /* Flush the FIFO */
930 USB_FlushRxFifo(USBx);
931 USB_FlushTxFifo(USBx , 0x10 );
933 return HAL_OK;
937 * @brief USB_SetDevAddress : Stop the usb device mode
938 * @param USBx : Selected device
939 * @param address : new device address to be assigned
940 * This parameter can be a value from 0 to 255
941 * @retval HAL status
943 HAL_StatusTypeDef USB_SetDevAddress (USB_OTG_GlobalTypeDef *USBx, uint8_t address)
945 USBx_DEVICE->DCFG &= ~ (USB_OTG_DCFG_DAD);
946 USBx_DEVICE->DCFG |= (address << 4) & USB_OTG_DCFG_DAD ;
948 return HAL_OK;
952 * @brief USB_DevConnect : Connect the USB device by enabling the pull-up/pull-down
953 * @param USBx : Selected device
954 * @retval HAL status
956 HAL_StatusTypeDef USB_DevConnect (USB_OTG_GlobalTypeDef *USBx)
958 USBx_DEVICE->DCTL &= ~USB_OTG_DCTL_SDIS ;
959 HAL_Delay(3);
961 return HAL_OK;
965 * @brief USB_DevDisconnect : Disconnect the USB device by disabling the pull-up/pull-down
966 * @param USBx : Selected device
967 * @retval HAL status
969 HAL_StatusTypeDef USB_DevDisconnect (USB_OTG_GlobalTypeDef *USBx)
971 USBx_DEVICE->DCTL |= USB_OTG_DCTL_SDIS ;
972 HAL_Delay(3);
974 return HAL_OK;
978 * @brief USB_ReadInterrupts: return the global USB interrupt status
979 * @param USBx : Selected device
980 * @retval HAL status
982 uint32_t USB_ReadInterrupts (USB_OTG_GlobalTypeDef *USBx)
984 uint32_t v = 0;
986 v = USBx->GINTSTS;
987 v &= USBx->GINTMSK;
988 return v;
992 * @brief USB_ReadDevAllOutEpInterrupt: return the USB device OUT endpoints interrupt status
993 * @param USBx : Selected device
994 * @retval HAL status
996 uint32_t USB_ReadDevAllOutEpInterrupt (USB_OTG_GlobalTypeDef *USBx)
998 uint32_t v;
999 v = USBx_DEVICE->DAINT;
1000 v &= USBx_DEVICE->DAINTMSK;
1001 return ((v & 0xffff0000) >> 16);
1005 * @brief USB_ReadDevAllInEpInterrupt: return the USB device IN endpoints interrupt status
1006 * @param USBx : Selected device
1007 * @retval HAL status
1009 uint32_t USB_ReadDevAllInEpInterrupt (USB_OTG_GlobalTypeDef *USBx)
1011 uint32_t v;
1012 v = USBx_DEVICE->DAINT;
1013 v &= USBx_DEVICE->DAINTMSK;
1014 return ((v & 0xFFFF));
1018 * @brief Returns Device OUT EP Interrupt register
1019 * @param USBx : Selected device
1020 * @param epnum : endpoint number
1021 * This parameter can be a value from 0 to 15
1022 * @retval Device OUT EP Interrupt register
1024 uint32_t USB_ReadDevOutEPInterrupt (USB_OTG_GlobalTypeDef *USBx , uint8_t epnum)
1026 uint32_t v;
1027 v = USBx_OUTEP(epnum)->DOEPINT;
1028 v &= USBx_DEVICE->DOEPMSK;
1029 return v;
1033 * @brief Returns Device IN EP Interrupt register
1034 * @param USBx : Selected device
1035 * @param epnum : endpoint number
1036 * This parameter can be a value from 0 to 15
1037 * @retval Device IN EP Interrupt register
1039 uint32_t USB_ReadDevInEPInterrupt (USB_OTG_GlobalTypeDef *USBx , uint8_t epnum)
1041 uint32_t v, msk, emp;
1043 msk = USBx_DEVICE->DIEPMSK;
1044 emp = USBx_DEVICE->DIEPEMPMSK;
1045 msk |= ((emp >> epnum) & 0x1) << 7;
1046 v = USBx_INEP(epnum)->DIEPINT & msk;
1047 return v;
1051 * @brief USB_ClearInterrupts: clear a USB interrupt
1052 * @param USBx : Selected device
1053 * @param interrupt : interrupt flag
1054 * @retval None
1056 void USB_ClearInterrupts (USB_OTG_GlobalTypeDef *USBx, uint32_t interrupt)
1058 USBx->GINTSTS |= interrupt;
1062 * @brief Returns USB core mode
1063 * @param USBx : Selected device
1064 * @retval return core mode : Host or Device
1065 * This parameter can be one of these values:
1066 * 0 : Host
1067 * 1 : Device
1069 uint32_t USB_GetMode(USB_OTG_GlobalTypeDef *USBx)
1071 return ((USBx->GINTSTS ) & 0x1);
1076 * @brief Activate EP0 for Setup transactions
1077 * @param USBx : Selected device
1078 * @retval HAL status
1080 HAL_StatusTypeDef USB_ActivateSetup (USB_OTG_GlobalTypeDef *USBx)
1082 /* Set the MPS of the IN EP based on the enumeration speed */
1083 USBx_INEP(0)->DIEPCTL &= ~USB_OTG_DIEPCTL_MPSIZ;
1085 if((USBx_DEVICE->DSTS & USB_OTG_DSTS_ENUMSPD) == DSTS_ENUMSPD_LS_PHY_6MHZ)
1087 USBx_INEP(0)->DIEPCTL |= 3;
1089 USBx_DEVICE->DCTL |= USB_OTG_DCTL_CGINAK;
1091 return HAL_OK;
1096 * @brief Prepare the EP0 to start the first control setup
1097 * @param USBx : Selected device
1098 * @param dma: USB dma enabled or disabled
1099 * This parameter can be one of these values:
1100 * 0 : DMA feature not used
1101 * 1 : DMA feature used
1102 * @param psetup : pointer to setup packet
1103 * @retval HAL status
1105 HAL_StatusTypeDef USB_EP0_OutStart(USB_OTG_GlobalTypeDef *USBx, uint8_t dma, uint8_t *psetup)
1107 USBx_OUTEP(0)->DOEPTSIZ = 0;
1108 USBx_OUTEP(0)->DOEPTSIZ |= (USB_OTG_DOEPTSIZ_PKTCNT & (1 << 19)) ;
1109 USBx_OUTEP(0)->DOEPTSIZ |= (3 * 8);
1110 USBx_OUTEP(0)->DOEPTSIZ |= USB_OTG_DOEPTSIZ_STUPCNT;
1112 if (dma == 1)
1114 USBx_OUTEP(0)->DOEPDMA = (uint32_t)psetup;
1115 /* EP enable */
1116 USBx_OUTEP(0)->DOEPCTL = 0x80008000;
1119 return HAL_OK;
1124 * @brief Reset the USB Core (needed after USB clock settings change)
1125 * @param USBx : Selected device
1126 * @retval HAL status
1128 static HAL_StatusTypeDef USB_CoreReset(USB_OTG_GlobalTypeDef *USBx)
1130 uint32_t count = 0;
1132 /* Wait for AHB master IDLE state. */
1135 if (++count > 200000)
1137 return HAL_TIMEOUT;
1140 while ((USBx->GRSTCTL & USB_OTG_GRSTCTL_AHBIDL) == 0);
1142 /* Core Soft Reset */
1143 count = 0;
1144 USBx->GRSTCTL |= USB_OTG_GRSTCTL_CSRST;
1148 if (++count > 200000)
1150 return HAL_TIMEOUT;
1153 while ((USBx->GRSTCTL & USB_OTG_GRSTCTL_CSRST) == USB_OTG_GRSTCTL_CSRST);
1155 return HAL_OK;
1158 #ifdef USB_HS_PHYC
1160 * @brief Enables control of a High Speed USB PHY’s
1161 * Init the low level hardware : GPIO, CLOCK, NVIC...
1162 * @param USBx : Selected device
1163 * @retval HAL status
1165 static HAL_StatusTypeDef USB_HS_PHYCInit(USB_OTG_GlobalTypeDef *USBx)
1167 uint32_t count = 0;
1169 /* Enable LDO */
1170 USB_HS_PHYC->USB_HS_PHYC_LDO |= USB_HS_PHYC_LDO_ENABLE;
1172 /* wait for LDO Ready */
1173 while((USB_HS_PHYC->USB_HS_PHYC_LDO & USB_HS_PHYC_LDO_STATUS) == RESET)
1175 if (++count > 200000)
1177 return HAL_TIMEOUT;
1181 /* Controls PHY frequency operation selection */
1182 if (HSE_VALUE == 12000000) /* HSE = 12MHz */
1184 USB_HS_PHYC->USB_HS_PHYC_PLL = (uint32_t)(0x0 << 1);
1186 else if (HSE_VALUE == 12500000) /* HSE = 12.5MHz */
1188 USB_HS_PHYC->USB_HS_PHYC_PLL = (uint32_t)(0x2 << 1);
1190 else if (HSE_VALUE == 16000000) /* HSE = 16MHz */
1192 USB_HS_PHYC->USB_HS_PHYC_PLL = (uint32_t)(0x3 << 1);
1195 else if (HSE_VALUE == 24000000) /* HSE = 24MHz */
1197 USB_HS_PHYC->USB_HS_PHYC_PLL = (uint32_t)(0x4 << 1);
1199 else if (HSE_VALUE == 25000000) /* HSE = 25MHz */
1201 USB_HS_PHYC->USB_HS_PHYC_PLL = (uint32_t)(0x5 << 1);
1203 else if (HSE_VALUE == 32000000) /* HSE = 32MHz */
1205 USB_HS_PHYC->USB_HS_PHYC_PLL = (uint32_t)(0x7 << 1);
1208 /* Control the tuning interface of the High Speed PHY */
1209 USB_HS_PHYC->USB_HS_PHYC_TUNE |= USB_HS_PHYC_TUNE_VALUE;
1211 /* Enable PLL internal PHY */
1212 USB_HS_PHYC->USB_HS_PHYC_PLL |= USB_HS_PHYC_PLL_PLLEN;
1214 /* 2ms Delay required to get internal phy clock stable */
1215 HAL_Delay(2);
1217 return HAL_OK;
1220 #endif /* USB_HS_PHYC */
1222 * @brief USB_HostInit : Initializes the USB OTG controller registers
1223 * for Host mode
1224 * @param USBx : Selected device
1225 * @param cfg : pointer to a USB_OTG_CfgTypeDef structure that contains
1226 * the configuration information for the specified USBx peripheral.
1227 * @retval HAL status
1229 HAL_StatusTypeDef USB_HostInit (USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg)
1231 uint32_t i;
1233 /* Restart the Phy Clock */
1234 USBx_PCGCCTL = 0;
1236 /*Activate VBUS Sensing B */
1237 USBx->GCCFG |= USB_OTG_GCCFG_VBDEN;
1239 /* Disable the FS/LS support mode only */
1240 if((cfg.speed == USB_OTG_SPEED_FULL)&&
1241 (USBx != USB_OTG_FS))
1243 USBx_HOST->HCFG |= USB_OTG_HCFG_FSLSS;
1245 else
1247 USBx_HOST->HCFG &= ~(USB_OTG_HCFG_FSLSS);
1250 /* Make sure the FIFOs are flushed. */
1251 USB_FlushTxFifo(USBx, 0x10 ); /* all Tx FIFOs */
1252 USB_FlushRxFifo(USBx);
1254 /* Clear all pending HC Interrupts */
1255 for (i = 0; i < cfg.Host_channels; i++)
1257 USBx_HC(i)->HCINT = 0xFFFFFFFF;
1258 USBx_HC(i)->HCINTMSK = 0;
1261 /* Enable VBUS driving */
1262 USB_DriveVbus(USBx, 1);
1264 HAL_Delay(200);
1266 /* Disable all interrupts. */
1267 USBx->GINTMSK = 0;
1269 /* Clear any pending interrupts */
1270 USBx->GINTSTS = 0xFFFFFFFF;
1272 if(USBx == USB_OTG_FS)
1274 /* set Rx FIFO size */
1275 USBx->GRXFSIZ = (uint32_t )0x80;
1276 USBx->DIEPTXF0_HNPTXFSIZ = (uint32_t )(((0x60 << 16)& USB_OTG_NPTXFD) | 0x80);
1277 USBx->HPTXFSIZ = (uint32_t )(((0x40 << 16)& USB_OTG_HPTXFSIZ_PTXFD) | 0xE0);
1279 else
1281 /* set Rx FIFO size */
1282 USBx->GRXFSIZ = (uint32_t )0x200;
1283 USBx->DIEPTXF0_HNPTXFSIZ = (uint32_t )(((0x100 << 16)& USB_OTG_NPTXFD) | 0x200);
1284 USBx->HPTXFSIZ = (uint32_t )(((0xE0 << 16)& USB_OTG_HPTXFSIZ_PTXFD) | 0x300);
1287 /* Enable the common interrupts */
1288 if (cfg.dma_enable == DISABLE)
1290 USBx->GINTMSK |= USB_OTG_GINTMSK_RXFLVLM;
1293 /* Enable interrupts matching to the Host mode ONLY */
1294 USBx->GINTMSK |= (USB_OTG_GINTMSK_PRTIM | USB_OTG_GINTMSK_HCIM |\
1295 USB_OTG_GINTMSK_SOFM |USB_OTG_GINTSTS_DISCINT|\
1296 USB_OTG_GINTMSK_PXFRM_IISOOXFRM | USB_OTG_GINTMSK_WUIM);
1298 return HAL_OK;
1302 * @brief USB_InitFSLSPClkSel : Initializes the FSLSPClkSel field of the
1303 * HCFG register on the PHY type and set the right frame interval
1304 * @param USBx : Selected device
1305 * @param freq : clock frequency
1306 * This parameter can be one of these values:
1307 * HCFG_48_MHZ : Full Speed 48 MHz Clock
1308 * HCFG_6_MHZ : Low Speed 6 MHz Clock
1309 * @retval HAL status
1311 HAL_StatusTypeDef USB_InitFSLSPClkSel(USB_OTG_GlobalTypeDef *USBx , uint8_t freq)
1313 USBx_HOST->HCFG &= ~(USB_OTG_HCFG_FSLSPCS);
1314 USBx_HOST->HCFG |= (freq & USB_OTG_HCFG_FSLSPCS);
1316 if (freq == HCFG_48_MHZ)
1318 USBx_HOST->HFIR = (uint32_t)48000;
1320 else if (freq == HCFG_6_MHZ)
1322 USBx_HOST->HFIR = (uint32_t)6000;
1324 return HAL_OK;
1328 * @brief USB_OTG_ResetPort : Reset Host Port
1329 * @param USBx : Selected device
1330 * @retval HAL status
1331 * @note : (1)The application must wait at least 10 ms
1332 * before clearing the reset bit.
1334 HAL_StatusTypeDef USB_ResetPort(USB_OTG_GlobalTypeDef *USBx)
1336 __IO uint32_t hprt0;
1338 hprt0 = USBx_HPRT0;
1340 hprt0 &= ~(USB_OTG_HPRT_PENA | USB_OTG_HPRT_PCDET |
1341 USB_OTG_HPRT_PENCHNG | USB_OTG_HPRT_POCCHNG);
1343 USBx_HPRT0 = (USB_OTG_HPRT_PRST | hprt0);
1344 HAL_Delay (100); /* See Note #1 */
1345 USBx_HPRT0 = ((~USB_OTG_HPRT_PRST) & hprt0);
1346 HAL_Delay (10);
1348 return HAL_OK;
1352 * @brief USB_DriveVbus : activate or de-activate vbus
1353 * @param state : VBUS state
1354 * This parameter can be one of these values:
1355 * 0 : VBUS Active
1356 * 1 : VBUS Inactive
1357 * @retval HAL status
1359 HAL_StatusTypeDef USB_DriveVbus (USB_OTG_GlobalTypeDef *USBx, uint8_t state)
1361 __IO uint32_t hprt0;
1363 hprt0 = USBx_HPRT0;
1365 hprt0 &= ~(USB_OTG_HPRT_PENA | USB_OTG_HPRT_PCDET |
1366 USB_OTG_HPRT_PENCHNG | USB_OTG_HPRT_POCCHNG);
1368 if (((hprt0 & USB_OTG_HPRT_PPWR) == 0 ) && (state == 1 ))
1370 USBx_HPRT0 = (USB_OTG_HPRT_PPWR | hprt0);
1372 if (((hprt0 & USB_OTG_HPRT_PPWR) == USB_OTG_HPRT_PPWR) && (state == 0 ))
1374 USBx_HPRT0 = ((~USB_OTG_HPRT_PPWR) & hprt0);
1376 return HAL_OK;
1380 * @brief Return Host Core speed
1381 * @param USBx : Selected device
1382 * @retval speed : Host speed
1383 * This parameter can be one of these values:
1384 * @arg USB_OTG_SPEED_HIGH: High speed mode
1385 * @arg USB_OTG_SPEED_FULL: Full speed mode
1386 * @arg USB_OTG_SPEED_LOW: Low speed mode
1388 uint32_t USB_GetHostSpeed (USB_OTG_GlobalTypeDef *USBx)
1390 __IO uint32_t hprt0;
1392 hprt0 = USBx_HPRT0;
1393 return ((hprt0 & USB_OTG_HPRT_PSPD) >> 17);
1397 * @brief Return Host Current Frame number
1398 * @param USBx : Selected device
1399 * @retval current frame number
1401 uint32_t USB_GetCurrentFrame (USB_OTG_GlobalTypeDef *USBx)
1403 return (USBx_HOST->HFNUM & USB_OTG_HFNUM_FRNUM);
1407 * @brief Initialize a host channel
1408 * @param USBx : Selected device
1409 * @param ch_num : Channel number
1410 * This parameter can be a value from 1 to 15
1411 * @param epnum : Endpoint number
1412 * This parameter can be a value from 1 to 15
1413 * @param dev_address : Current device address
1414 * This parameter can be a value from 0 to 255
1415 * @param speed : Current device speed
1416 * This parameter can be one of these values:
1417 * @arg USB_OTG_SPEED_HIGH: High speed mode
1418 * @arg USB_OTG_SPEED_FULL: Full speed mode
1419 * @arg USB_OTG_SPEED_LOW: Low speed mode
1420 * @param ep_type : Endpoint Type
1421 * This parameter can be one of these values:
1422 * @arg EP_TYPE_CTRL: Control type
1423 * @arg EP_TYPE_ISOC: Isochronous type
1424 * @arg EP_TYPE_BULK: Bulk type
1425 * @arg EP_TYPE_INTR: Interrupt type
1426 * @param mps : Max Packet Size
1427 * This parameter can be a value from 0 to32K
1428 * @retval HAL state
1430 HAL_StatusTypeDef USB_HC_Init(USB_OTG_GlobalTypeDef *USBx,
1431 uint8_t ch_num,
1432 uint8_t epnum,
1433 uint8_t dev_address,
1434 uint8_t speed,
1435 uint8_t ep_type,
1436 uint16_t mps)
1439 /* Clear old interrupt conditions for this host channel. */
1440 USBx_HC(ch_num)->HCINT = 0xFFFFFFFF;
1442 /* Enable channel interrupts required for this transfer. */
1443 switch (ep_type)
1445 case EP_TYPE_CTRL:
1446 case EP_TYPE_BULK:
1448 USBx_HC(ch_num)->HCINTMSK = USB_OTG_HCINTMSK_XFRCM |\
1449 USB_OTG_HCINTMSK_STALLM |\
1450 USB_OTG_HCINTMSK_TXERRM |\
1451 USB_OTG_HCINTMSK_DTERRM |\
1452 USB_OTG_HCINTMSK_AHBERR |\
1453 USB_OTG_HCINTMSK_NAKM ;
1455 if (epnum & 0x80)
1457 USBx_HC(ch_num)->HCINTMSK |= USB_OTG_HCINTMSK_BBERRM;
1459 else
1461 if(USBx != USB_OTG_FS)
1463 USBx_HC(ch_num)->HCINTMSK |= (USB_OTG_HCINTMSK_NYET | USB_OTG_HCINTMSK_ACKM);
1466 break;
1468 case EP_TYPE_INTR:
1470 USBx_HC(ch_num)->HCINTMSK = USB_OTG_HCINTMSK_XFRCM |\
1471 USB_OTG_HCINTMSK_STALLM |\
1472 USB_OTG_HCINTMSK_TXERRM |\
1473 USB_OTG_HCINTMSK_DTERRM |\
1474 USB_OTG_HCINTMSK_NAKM |\
1475 USB_OTG_HCINTMSK_AHBERR |\
1476 USB_OTG_HCINTMSK_FRMORM ;
1478 if (epnum & 0x80)
1480 USBx_HC(ch_num)->HCINTMSK |= USB_OTG_HCINTMSK_BBERRM;
1483 break;
1484 case EP_TYPE_ISOC:
1486 USBx_HC(ch_num)->HCINTMSK = USB_OTG_HCINTMSK_XFRCM |\
1487 USB_OTG_HCINTMSK_ACKM |\
1488 USB_OTG_HCINTMSK_AHBERR |\
1489 USB_OTG_HCINTMSK_FRMORM ;
1491 if (epnum & 0x80)
1493 USBx_HC(ch_num)->HCINTMSK |= (USB_OTG_HCINTMSK_TXERRM | USB_OTG_HCINTMSK_BBERRM);
1495 break;
1498 /* Enable the top level host channel interrupt. */
1499 USBx_HOST->HAINTMSK |= (1 << ch_num);
1501 /* Make sure host channel interrupts are enabled. */
1502 USBx->GINTMSK |= USB_OTG_GINTMSK_HCIM;
1504 /* Program the HCCHAR register */
1505 USBx_HC(ch_num)->HCCHAR = (((dev_address << 22) & USB_OTG_HCCHAR_DAD) |\
1506 (((epnum & 0x7F)<< 11) & USB_OTG_HCCHAR_EPNUM)|\
1507 ((((epnum & 0x80) == 0x80)<< 15) & USB_OTG_HCCHAR_EPDIR)|\
1508 (((speed == HPRT0_PRTSPD_LOW_SPEED)<< 17) & USB_OTG_HCCHAR_LSDEV)|\
1509 ((ep_type << 18) & USB_OTG_HCCHAR_EPTYP)|\
1510 (mps & USB_OTG_HCCHAR_MPSIZ));
1512 if (ep_type == EP_TYPE_INTR)
1514 USBx_HC(ch_num)->HCCHAR |= USB_OTG_HCCHAR_ODDFRM ;
1517 return HAL_OK;
1521 * @brief Start a transfer over a host channel
1522 * @param USBx : Selected device
1523 * @param hc : pointer to host channel structure
1524 * @param dma: USB dma enabled or disabled
1525 * This parameter can be one of these values:
1526 * 0 : DMA feature not used
1527 * 1 : DMA feature used
1528 * @retval HAL state
1530 HAL_StatusTypeDef USB_HC_StartXfer(USB_OTG_GlobalTypeDef *USBx, USB_OTG_HCTypeDef *hc, uint8_t dma)
1532 static __IO uint32_t tmpreg = 0;
1533 uint8_t is_oddframe = 0;
1534 uint16_t len_words = 0;
1535 uint16_t num_packets = 0;
1536 uint16_t max_hc_pkt_count = 256;
1538 if((USBx != USB_OTG_FS) && (hc->speed == USB_OTG_SPEED_HIGH))
1540 if((dma == 0) && (hc->do_ping == 1))
1542 USB_DoPing(USBx, hc->ch_num);
1543 return HAL_OK;
1545 else if(dma == 1)
1547 USBx_HC(hc->ch_num)->HCINTMSK &= ~(USB_OTG_HCINTMSK_NYET | USB_OTG_HCINTMSK_ACKM);
1548 hc->do_ping = 0;
1552 /* Compute the expected number of packets associated to the transfer */
1553 if (hc->xfer_len > 0)
1555 num_packets = (hc->xfer_len + hc->max_packet - 1) / hc->max_packet;
1557 if (num_packets > max_hc_pkt_count)
1559 num_packets = max_hc_pkt_count;
1560 hc->xfer_len = num_packets * hc->max_packet;
1563 else
1565 num_packets = 1;
1567 if (hc->ep_is_in)
1569 hc->xfer_len = num_packets * hc->max_packet;
1572 /* Initialize the HCTSIZn register */
1573 USBx_HC(hc->ch_num)->HCTSIZ = (((hc->xfer_len) & USB_OTG_HCTSIZ_XFRSIZ)) |\
1574 ((num_packets << 19) & USB_OTG_HCTSIZ_PKTCNT) |\
1575 (((hc->data_pid) << 29) & USB_OTG_HCTSIZ_DPID);
1577 if (dma)
1579 /* xfer_buff MUST be 32-bits aligned */
1580 USBx_HC(hc->ch_num)->HCDMA = (uint32_t)hc->xfer_buff;
1583 is_oddframe = (USBx_HOST->HFNUM & 0x01) ? 0 : 1;
1584 USBx_HC(hc->ch_num)->HCCHAR &= ~USB_OTG_HCCHAR_ODDFRM;
1585 USBx_HC(hc->ch_num)->HCCHAR |= (is_oddframe << 29);
1587 /* Set host channel enable */
1588 tmpreg = USBx_HC(hc->ch_num)->HCCHAR;
1589 tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
1590 tmpreg |= USB_OTG_HCCHAR_CHENA;
1591 USBx_HC(hc->ch_num)->HCCHAR = tmpreg;
1593 if (dma == 0) /* Slave mode */
1595 if((hc->ep_is_in == 0) && (hc->xfer_len > 0))
1597 switch(hc->ep_type)
1599 /* Non periodic transfer */
1600 case EP_TYPE_CTRL:
1601 case EP_TYPE_BULK:
1603 len_words = (hc->xfer_len + 3) / 4;
1605 /* check if there is enough space in FIFO space */
1606 if(len_words > (USBx->HNPTXSTS & 0xFFFF))
1608 /* need to process data in nptxfempty interrupt */
1609 USBx->GINTMSK |= USB_OTG_GINTMSK_NPTXFEM;
1611 break;
1612 /* Periodic transfer */
1613 case EP_TYPE_INTR:
1614 case EP_TYPE_ISOC:
1615 len_words = (hc->xfer_len + 3) / 4;
1616 /* check if there is enough space in FIFO space */
1617 if(len_words > (USBx_HOST->HPTXSTS & 0xFFFF)) /* split the transfer */
1619 /* need to process data in ptxfempty interrupt */
1620 USBx->GINTMSK |= USB_OTG_GINTMSK_PTXFEM;
1622 break;
1624 default:
1625 break;
1628 /* Write packet into the Tx FIFO. */
1629 USB_WritePacket(USBx, hc->xfer_buff, hc->ch_num, hc->xfer_len, 0);
1633 return HAL_OK;
1637 * @brief Read all host channel interrupts status
1638 * @param USBx : Selected device
1639 * @retval HAL state
1641 uint32_t USB_HC_ReadInterrupt (USB_OTG_GlobalTypeDef *USBx)
1643 return ((USBx_HOST->HAINT) & 0xFFFF);
1647 * @brief Halt a host channel
1648 * @param USBx : Selected device
1649 * @param hc_num : Host Channel number
1650 * This parameter can be a value from 1 to 15
1651 * @retval HAL state
1653 HAL_StatusTypeDef USB_HC_Halt(USB_OTG_GlobalTypeDef *USBx , uint8_t hc_num)
1655 uint32_t count = 0;
1657 /* Check for space in the request queue to issue the halt. */
1658 if (((((USBx_HC(hc_num)->HCCHAR) & USB_OTG_HCCHAR_EPTYP) >> 18) == HCCHAR_CTRL) ||
1659 (((((USBx_HC(hc_num)->HCCHAR) & USB_OTG_HCCHAR_EPTYP) >> 18) == HCCHAR_BULK)))
1661 USBx_HC(hc_num)->HCCHAR |= USB_OTG_HCCHAR_CHDIS;
1663 if ((USBx->HNPTXSTS & 0xFFFF) == 0)
1665 USBx_HC(hc_num)->HCCHAR &= ~USB_OTG_HCCHAR_CHENA;
1666 USBx_HC(hc_num)->HCCHAR |= USB_OTG_HCCHAR_CHENA;
1667 USBx_HC(hc_num)->HCCHAR &= ~USB_OTG_HCCHAR_EPDIR;
1670 if (++count > 1000)
1672 break;
1675 while ((USBx_HC(hc_num)->HCCHAR & USB_OTG_HCCHAR_CHENA) == USB_OTG_HCCHAR_CHENA);
1677 else
1679 USBx_HC(hc_num)->HCCHAR |= USB_OTG_HCCHAR_CHENA;
1682 else
1684 USBx_HC(hc_num)->HCCHAR |= USB_OTG_HCCHAR_CHDIS;
1686 if ((USBx_HOST->HPTXSTS & 0xFFFF) == 0)
1688 USBx_HC(hc_num)->HCCHAR &= ~USB_OTG_HCCHAR_CHENA;
1689 USBx_HC(hc_num)->HCCHAR |= USB_OTG_HCCHAR_CHENA;
1690 USBx_HC(hc_num)->HCCHAR &= ~USB_OTG_HCCHAR_EPDIR;
1693 if (++count > 1000)
1695 break;
1698 while ((USBx_HC(hc_num)->HCCHAR & USB_OTG_HCCHAR_CHENA) == USB_OTG_HCCHAR_CHENA);
1700 else
1702 USBx_HC(hc_num)->HCCHAR |= USB_OTG_HCCHAR_CHENA;
1706 return HAL_OK;
1710 * @brief Initiate Do Ping protocol
1711 * @param USBx : Selected device
1712 * @param hc_num : Host Channel number
1713 * This parameter can be a value from 1 to 15
1714 * @retval HAL state
1716 HAL_StatusTypeDef USB_DoPing(USB_OTG_GlobalTypeDef *USBx , uint8_t ch_num)
1718 uint8_t num_packets = 1;
1719 uint32_t tmpreg = 0;
1721 USBx_HC(ch_num)->HCTSIZ = ((num_packets << 19) & USB_OTG_HCTSIZ_PKTCNT) |\
1722 USB_OTG_HCTSIZ_DOPING;
1724 /* Set host channel enable */
1725 tmpreg = USBx_HC(ch_num)->HCCHAR;
1726 tmpreg &= ~USB_OTG_HCCHAR_CHDIS;
1727 tmpreg |= USB_OTG_HCCHAR_CHENA;
1728 USBx_HC(ch_num)->HCCHAR = tmpreg;
1730 return HAL_OK;
1734 * @brief Stop Host Core
1735 * @param USBx : Selected device
1736 * @retval HAL state
1738 HAL_StatusTypeDef USB_StopHost(USB_OTG_GlobalTypeDef *USBx)
1740 uint8_t i;
1741 uint32_t count = 0;
1742 uint32_t value;
1744 USB_DisableGlobalInt(USBx);
1746 /* Flush FIFO */
1747 USB_FlushTxFifo(USBx, 0x10);
1748 USB_FlushRxFifo(USBx);
1750 /* Flush out any leftover queued requests. */
1751 for (i = 0; i <= 15; i++)
1754 value = USBx_HC(i)->HCCHAR ;
1755 value |= USB_OTG_HCCHAR_CHDIS;
1756 value &= ~USB_OTG_HCCHAR_CHENA;
1757 value &= ~USB_OTG_HCCHAR_EPDIR;
1758 USBx_HC(i)->HCCHAR = value;
1761 /* Halt all channels to put them into a known state. */
1762 for (i = 0; i <= 15; i++)
1764 value = USBx_HC(i)->HCCHAR ;
1766 value |= USB_OTG_HCCHAR_CHDIS;
1767 value |= USB_OTG_HCCHAR_CHENA;
1768 value &= ~USB_OTG_HCCHAR_EPDIR;
1770 USBx_HC(i)->HCCHAR = value;
1773 if (++count > 1000)
1775 break;
1778 while ((USBx_HC(i)->HCCHAR & USB_OTG_HCCHAR_CHENA) == USB_OTG_HCCHAR_CHENA);
1781 /* Clear any pending Host interrupts */
1782 USBx_HOST->HAINT = 0xFFFFFFFF;
1783 USBx->GINTSTS = 0xFFFFFFFF;
1784 USB_EnableGlobalInt(USBx);
1785 return HAL_OK;
1788 * @}
1791 #endif /* defined (HAL_PCD_MODULE_ENABLED) || defined (HAL_HCD_MODULE_ENABLED) */
1794 * @}
1797 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/