820a1d4708222a9464d104d3ea03d83e1d4cf7a6
2 ******************************************************************************
3 * @file stm32f7xx_hal_pcd_ex.c
4 * @author MCD Application Team
7 * @brief PCD HAL module driver.
8 * This file provides firmware functions to manage the following
9 * functionalities of the USB Peripheral Controller:
10 * + Extended features functions
12 ******************************************************************************
15 * <h2><center>© COPYRIGHT(c) 2016 STMicroelectronics</center></h2>
17 * Redistribution and use in source and binary forms, with or without modification,
18 * are permitted provided that the following conditions are met:
19 * 1. Redistributions of source code must retain the above copyright notice,
20 * this list of conditions and the following disclaimer.
21 * 2. Redistributions in binary form must reproduce the above copyright notice,
22 * this list of conditions and the following disclaimer in the documentation
23 * and/or other materials provided with the distribution.
24 * 3. Neither the name of STMicroelectronics nor the names of its contributors
25 * may be used to endorse or promote products derived from this software
26 * without specific prior written permission.
28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
29 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
31 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
32 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
33 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
34 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
35 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
36 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
37 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39 ******************************************************************************
42 /* Includes ------------------------------------------------------------------*/
43 #include "stm32f7xx_hal.h"
45 /** @addtogroup STM32F7xx_HAL_Driver
49 /** @defgroup PCDEx PCDEx
50 * @brief PCD Extended HAL module driver
53 #ifdef HAL_PCD_MODULE_ENABLED
55 /* Private types -------------------------------------------------------------*/
56 /* Private variables ---------------------------------------------------------*/
57 /* Private constants ---------------------------------------------------------*/
58 /* Private macros ------------------------------------------------------------*/
59 /* Private functions ---------------------------------------------------------*/
60 /* Exported functions --------------------------------------------------------*/
62 /** @defgroup PCDEx_Exported_Functions PCDEx Exported Functions
66 /** @defgroup PCDEx_Exported_Functions_Group1 Peripheral Control functions
67 * @brief PCDEx control functions
70 ===============================================================================
71 ##### Extended features functions #####
72 ===============================================================================
73 [..] This section provides functions allowing to:
74 (+) Update FIFO configuration
82 * @param hpcd: PCD handle
83 * @param fifo: The number of Tx fifo
84 * @param size: Fifo size
87 HAL_StatusTypeDef
HAL_PCDEx_SetTxFiFo(PCD_HandleTypeDef
*hpcd
, uint8_t fifo
, uint16_t size
)
90 uint32_t Tx_Offset
= 0;
92 /* TXn min size = 16 words. (n : Transmit FIFO index)
93 When a TxFIFO is not used, the Configuration should be as follows:
94 case 1 : n > m and Txn is not used (n,m : Transmit FIFO indexes)
95 --> Txm can use the space allocated for Txn.
96 case2 : n < m and Txn is not used (n,m : Transmit FIFO indexes)
97 --> Txn should be configured with the minimum space of 16 words
98 The FIFO is used optimally when used TxFIFOs are allocated in the top
99 of the FIFO.Ex: use EP1 and EP2 as IN instead of EP1 and EP3 as IN ones.
100 When DMA is used 3n * FIFO locations should be reserved for internal DMA registers */
102 Tx_Offset
= hpcd
->Instance
->GRXFSIZ
;
106 hpcd
->Instance
->DIEPTXF0_HNPTXFSIZ
= (uint32_t)(((uint32_t)size
<< 16) | Tx_Offset
);
110 Tx_Offset
+= (hpcd
->Instance
->DIEPTXF0_HNPTXFSIZ
) >> 16;
111 for (i
= 0; i
< (fifo
- 1); i
++)
113 Tx_Offset
+= (hpcd
->Instance
->DIEPTXF
[i
] >> 16);
116 /* Multiply Tx_Size by 2 to get higher performance */
117 hpcd
->Instance
->DIEPTXF
[fifo
- 1] = (uint32_t)(((uint32_t)size
<< 16) | Tx_Offset
);
125 * @param hpcd: PCD handle
126 * @param size: Size of Rx fifo
129 HAL_StatusTypeDef
HAL_PCDEx_SetRxFiFo(PCD_HandleTypeDef
*hpcd
, uint16_t size
)
131 hpcd
->Instance
->GRXFSIZ
= size
;
137 * @brief Activate LPM Feature
138 * @param hpcd: PCD handle
141 HAL_StatusTypeDef
HAL_PCDEx_ActivateLPM(PCD_HandleTypeDef
*hpcd
)
143 USB_OTG_GlobalTypeDef
*USBx
= hpcd
->Instance
;
145 hpcd
->lpm_active
= ENABLE
;
146 hpcd
->LPM_State
= LPM_L0
;
147 USBx
->GINTMSK
|= USB_OTG_GINTMSK_LPMINTM
;
148 USBx
->GLPMCFG
|= (USB_OTG_GLPMCFG_LPMEN
| USB_OTG_GLPMCFG_LPMACK
| USB_OTG_GLPMCFG_ENBESL
);
154 * @brief DeActivate LPM feature.
155 * @param hpcd: PCD handle
158 HAL_StatusTypeDef
HAL_PCDEx_DeActivateLPM(PCD_HandleTypeDef
*hpcd
)
160 USB_OTG_GlobalTypeDef
*USBx
= hpcd
->Instance
;
162 hpcd
->lpm_active
= DISABLE
;
163 USBx
->GINTMSK
&= ~USB_OTG_GINTMSK_LPMINTM
;
164 USBx
->GLPMCFG
&= ~(USB_OTG_GLPMCFG_LPMEN
| USB_OTG_GLPMCFG_LPMACK
| USB_OTG_GLPMCFG_ENBESL
);
170 * @brief Send LPM message to user layer callback.
171 * @param hpcd: PCD handle
172 * @param msg: LPM message
175 __weak
void HAL_PCDEx_LPM_Callback(PCD_HandleTypeDef
*hpcd
, PCD_LPM_MsgTypeDef msg
)
177 /* Prevent unused argument(s) compilation warning */
181 /* NOTE : This function Should not be modified, when the callback is needed,
182 the HAL_PCDEx_LPM_Callback could be implemented in the user file
194 #endif /* HAL_PCD_MODULE_ENABLED */
203 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/