2 ******************************************************************************
3 * @file stm32l0xx_hal_pcd.h
4 * @author MCD Application Team
6 * @date 06-February-2015
7 * @brief Header file of PCD HAL module.
8 ******************************************************************************
11 * <h2><center>© COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
13 * Redistribution and use in source and binary forms, with or without modification,
14 * are permitted provided that the following conditions are met:
15 * 1. Redistributions of source code must retain the above copyright notice,
16 * this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright notice,
18 * this list of conditions and the following disclaimer in the documentation
19 * and/or other materials provided with the distribution.
20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
21 * may be used to endorse or promote products derived from this software
22 * without specific prior written permission.
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 ******************************************************************************
40 /* Define to prevent recursive inclusion -------------------------------------*/
41 #ifndef __STM32L0xx_HAL_PCD_H
42 #define __STM32L0xx_HAL_PCD_H
48 #if !defined (STM32L031xx) && !defined (STM32L041xx) && !defined (STM32L051xx) && !defined (STM32L061xx) && !defined (STM32L071xx) && !defined (STM32L081xx)
50 /* Includes ------------------------------------------------------------------*/
51 #include "stm32l0xx_hal_def.h"
52 /** @addtogroup STM32L0xx_HAL_Driver
60 /* Exported types ------------------------------------------------------------*/
63 * @brief PCD State structures definition
75 /* double buffered endpoint direction */
81 /* endpoint buffer number */
89 #define PCD_ENDP0 ((uint8_t)0)
90 #define PCD_ENDP1 ((uint8_t)1)
91 #define PCD_ENDP2 ((uint8_t)2)
92 #define PCD_ENDP3 ((uint8_t)3)
93 #define PCD_ENDP4 ((uint8_t)4)
94 #define PCD_ENDP5 ((uint8_t)5)
95 #define PCD_ENDP6 ((uint8_t)6)
96 #define PCD_ENDP7 ((uint8_t)7)
100 #define PCD_DBL_BUF 1
102 #define IS_PCD_ALL_INSTANCE IS_USB_ALL_INSTANCE
104 * @brief PCD Initialization Structure definition
108 uint32_t dev_endpoints; /*!< Device Endpoints number.
109 This parameter depends on the used USB core.
110 This parameter must be a number between Min_Data = 1 and Max_Data = 15 */
112 uint32_t speed; /*!< USB Core speed.
113 This parameter can be any value of @ref PCD_Speed */
115 uint32_t ep0_mps; /*!< Set the Endpoint 0 Max Packet size.
116 This parameter can be any value of @ref PCD_USB_EP0_MPS */
118 uint32_t phy_itface; /*!< Select the used PHY interface.
119 This parameter can be any value of @ref PCD_USB_Core_PHY */
121 uint32_t Sof_enable; /*!< Enable or disable the output of the SOF signal.
122 This parameter can be set to ENABLE or DISABLE */
124 uint32_t low_power_enable; /*!< Enable or disable Low Power mode
125 This parameter can be set to ENABLE or DISABLE */
127 uint32_t lpm_enable; /*!< Enable or disable Link Power Management.
128 This parameter can be set to ENABLE or DISABLE */
130 uint32_t battery_charging_enable; /*!< Enable or disable Battery charging.
131 This parameter can be set to ENABLE or DISABLE */
137 uint8_t num; /*!< Endpoint number
138 This parameter must be a number between Min_Data = 1 and Max_Data = 15 */
140 uint8_t is_in; /*!< Endpoint direction
141 This parameter must be a number between Min_Data = 0 and Max_Data = 1 */
143 uint8_t is_stall; /*!< Endpoint stall condition
144 This parameter must be a number between Min_Data = 0 and Max_Data = 1 */
146 uint8_t type; /*!< Endpoint type
147 This parameter can be any value of @ref PCD_USB_EP_Type */
149 uint16_t pmaadress; /*!< PMA Address
150 This parameter can be any value between Min_addr = 0 and Max_addr = 1K */
153 uint16_t pmaaddr0; /*!< PMA Address0
154 This parameter can be any value between Min_addr = 0 and Max_addr = 1K */
157 uint16_t pmaaddr1; /*!< PMA Address1
158 This parameter can be any value between Min_addr = 0 and Max_addr = 1K */
161 uint8_t doublebuffer; /*!< Double buffer enable
162 This parameter can be 0 or 1 */
164 uint32_t maxpacket; /*!< Endpoint Max packet size
165 This parameter must be a number between Min_Data = 0 and Max_Data = 64KB */
167 uint8_t *xfer_buff; /*!< Pointer to transfer buffer */
170 uint32_t xfer_len; /*!< Current transfer length */
172 uint32_t xfer_count; /*!< Partial transfer length in case of multi packet transfer */
176 typedef USB_TypeDef PCD_TypeDef;
179 * @brief PCD Handle Structure definition
183 PCD_TypeDef *Instance; /*!< Register base address */
184 PCD_InitTypeDef Init; /*!< PCD required parameters */
185 __IO uint8_t USB_Address; /*!< USB Address */
186 PCD_EPTypeDef IN_ep[8]; /*!< IN endpoint parameters */
187 PCD_EPTypeDef OUT_ep[8]; /*!< OUT endpoint parameters */
188 HAL_LockTypeDef Lock; /*!< PCD peripheral status */
189 __IO PCD_StateTypeDef State; /*!< PCD communication state */
190 uint32_t Setup[12]; /*!< Setup packet buffer */
191 void *pData; /*!< Pointer to upper stack Handler */
195 #include "stm32l0xx_hal_pcd_ex.h"
196 /* Exported constants --------------------------------------------------------*/
197 /** @defgroup PCD_Exported_Constants
201 /** @defgroup PCD_Speed
204 #define PCD_SPEED_HIGH 0 /* Not Supported */
205 #define PCD_SPEED_FULL 2
210 /** @defgroup PCD_USB_Core_PHY
213 #define PCD_PHY_EMBEDDED 2
218 /** @defgroup PCD_USB_EP0_MPS
221 #define DEP0CTL_MPS_64 0
222 #define DEP0CTL_MPS_32 1
223 #define DEP0CTL_MPS_16 2
224 #define DEP0CTL_MPS_8 3
226 #define PCD_EP0MPS_64 DEP0CTL_MPS_64
227 #define PCD_EP0MPS_32 DEP0CTL_MPS_32
228 #define PCD_EP0MPS_16 DEP0CTL_MPS_16
229 #define PCD_EP0MPS_08 DEP0CTL_MPS_8
234 /** @defgroup PCD_USB_EP_Type
237 #define PCD_EP_TYPE_CTRL 0
238 #define PCD_EP_TYPE_ISOC 1
239 #define PCD_EP_TYPE_BULK 2
240 #define PCD_EP_TYPE_INTR 3
249 /* Exported macros -----------------------------------------------------------*/
251 /** @defgroup PCD_Interrupt_Clock
252 * @brief macros to handle interrupts and specific clock configurations
255 #define __HAL_PCD_GET_FLAG(__HANDLE__, __INTERRUPT__) ((((__HANDLE__)->Instance->ISTR) & (__INTERRUPT__)) == (__INTERRUPT__))
256 #define __HAL_PCD_CLEAR_FLAG(__HANDLE__, __INTERRUPT__) (((__HANDLE__)->Instance->ISTR) = ~(__INTERRUPT__))
258 #define USB_WAKEUP_EXTI_LINE ((uint32_t)0x00040000) /*!< External interrupt line 18 Connected to the USB FS EXTI Line */
260 #define __HAL_USB_WAKEUP_EXTI_ENABLE_IT() EXTI->IMR |= USB_WAKEUP_EXTI_LINE
261 #define __HAL_USB_WAKEUP_EXTI_DISABLE_IT() EXTI->IMR &= ~(USB_WAKEUP_EXTI_LINE)
262 #define __HAL_USB_EXTI_GENERATE_SWIT() (EXTI->SWIER |= USB_WAKEUP_EXTI_LINE)
264 /* Internal macros -----------------------------------------------------------*/
267 #define PCD_SET_ENDPOINT(USBx, bEpNum,wRegValue) (*(&USBx->EP0R + bEpNum * 2)= (uint16_t)wRegValue)
270 #define PCD_GET_ENDPOINT(USBx, bEpNum) (*(&USBx->EP0R + bEpNum * 2))
275 * @brief sets the type in the endpoint register(bits EP_TYPE[1:0])
276 * @param bEpNum: Endpoint Number.
277 * @param wType: Endpoint Type.
280 #define PCD_SET_EPTYPE(USBx, bEpNum,wType) (PCD_SET_ENDPOINT(USBx, bEpNum,\
281 ((PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EP_T_MASK) | wType )))
284 * @brief gets the type in the endpoint register(bits EP_TYPE[1:0])
285 * @param bEpNum: Endpoint Number.
286 * @retval Endpoint Type
288 #define PCD_GET_EPTYPE(USBx, bEpNum) (PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EP_T_FIELD)
292 * @brief free buffer used from the application realizing it to the line
293 toggles bit SW_BUF in the double buffered endpoint register
294 * @param bEpNum, bDir
297 #define PCD_FreeUserBuffer(USBx, bEpNum, bDir)\
299 if (bDir == PCD_EP_DBUF_OUT)\
300 { /* OUT double buffered endpoint */\
301 PCD_TX_DTOG(USBx, bEpNum);\
303 else if (bDir == PCD_EP_DBUF_IN)\
304 { /* IN double buffered endpoint */\
305 PCD_RX_DTOG(USBx, bEpNum);\
310 * @brief gets direction of the double buffered endpoint
311 * @param bEpNum: Endpoint Number.
312 * @retval EP_DBUF_OUT, EP_DBUF_IN,
313 * EP_DBUF_ERR if the endpoint counter not yet programmed.
315 #define PCD_GET_DB_DIR(USBx, bEpNum)\
317 if ((uint16_t)(*PCD_EP_RX_CNT(USBx, bEpNum) & 0xFC00) != 0)\
318 return(PCD_EP_DBUF_OUT);\
319 else if (((uint16_t)(*PCD_EP_TX_CNT(USBx, bEpNum)) & 0x03FF) != 0)\
320 return(PCD_EP_DBUF_IN);\
322 return(PCD_EP_DBUF_ERR);\
326 * @brief sets the status for tx transfer (bits STAT_TX[1:0]).
327 * @param bEpNum: Endpoint Number.
328 * @param wState: new state
331 #define PCD_SET_EP_TX_STATUS(USBx, bEpNum, wState) {\
332 register uint16_t _wRegVal; \
334 _wRegVal = PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EPTX_DTOGMASK;\
335 /* toggle first bit ? */ \
336 if((USB_EPTX_DTOG1 & wState)!= 0) \
337 _wRegVal ^= USB_EPTX_DTOG1; \
338 /* toggle second bit ? */ \
339 if((USB_EPTX_DTOG2 & wState)!= 0) \
340 _wRegVal ^= USB_EPTX_DTOG2; \
341 PCD_SET_ENDPOINT(USBx, bEpNum, (_wRegVal | USB_EP_CTR_RX|USB_EP_CTR_TX)); \
342 } /* PCD_SET_EP_TX_STATUS */
345 * @brief sets the status for rx transfer (bits STAT_TX[1:0])
346 * @param bEpNum: Endpoint Number.
347 * @param wState: new state
350 #define PCD_SET_EP_RX_STATUS(USBx, bEpNum,wState) {\
351 register uint16_t _wRegVal; \
353 _wRegVal = PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EPRX_DTOGMASK;\
354 /* toggle first bit ? */ \
355 if((USB_EPRX_DTOG1 & wState)!= 0) \
356 _wRegVal ^= USB_EPRX_DTOG1; \
357 /* toggle second bit ? */ \
358 if((USB_EPRX_DTOG2 & wState)!= 0) \
359 _wRegVal ^= USB_EPRX_DTOG2; \
360 PCD_SET_ENDPOINT(USBx, bEpNum, (_wRegVal | USB_EP_CTR_RX|USB_EP_CTR_TX)); \
361 } /* PCD_SET_EP_RX_STATUS */
364 * @brief sets the status for rx & tx (bits STAT_TX[1:0] & STAT_RX[1:0])
365 * @param bEpNum: Endpoint Number.
366 * @param wStaterx: new state.
367 * @param wStatetx: new state.
370 #define PCD_SET_EP_TXRX_STATUS(USBx,bEpNum,wStaterx,wStatetx) {\
371 register uint32_t _wRegVal; \
373 _wRegVal = PCD_GET_ENDPOINT(USBx, bEpNum) & (USB_EPRX_DTOGMASK |USB_EPTX_STAT) ;\
374 /* toggle first bit ? */ \
375 if((USB_EPRX_DTOG1 & wStaterx)!= 0) \
376 _wRegVal ^= USB_EPRX_DTOG1; \
377 /* toggle second bit ? */ \
378 if((USB_EPRX_DTOG2 & wStaterx)!= 0) \
379 _wRegVal ^= USB_EPRX_DTOG2; \
380 /* toggle first bit ? */ \
381 if((USB_EPTX_DTOG1 & wStatetx)!= 0) \
382 _wRegVal ^= USB_EPTX_DTOG1; \
383 /* toggle second bit ? */ \
384 if((USB_EPTX_DTOG2 & wStatetx)!= 0) \
385 _wRegVal ^= USB_EPTX_DTOG2; \
386 PCD_SET_ENDPOINT(USBx, bEpNum, _wRegVal | USB_EP_CTR_RX|USB_EP_CTR_TX); \
387 } /* PCD_SET_EP_TXRX_STATUS */
390 * @brief gets the status for tx/rx transfer (bits STAT_TX[1:0]
392 * @param bEpNum: Endpoint Number.
395 #define PCD_GET_EP_TX_STATUS(USBx, bEpNum) ((uint16_t)PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EPTX_STAT)
397 #define PCD_GET_EP_RX_STATUS(USBx, bEpNum) ((uint16_t)PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EPRX_STAT)
400 * @brief sets directly the VALID tx/rx-status into the endpoint register
401 * @param bEpNum: Endpoint Number.
404 #define PCD_SET_EP_TX_VALID(USBx, bEpNum) (PCD_SET_EP_TX_STATUS(USBx, bEpNum, USB_EP_TX_VALID))
406 #define PCD_SET_EP_RX_VALID(USBx, bEpNum) (PCD_SET_EP_RX_STATUS(USBx, bEpNum, USB_EP_RX_VALID))
409 * @brief checks stall condition in an endpoint.
410 * @param bEpNum: Endpoint Number.
411 * @retval TRUE = endpoint in stall condition.
413 #define PCD_GET_EP_TX_STALL_STATUS(USBx, bEpNum) (PCD_GET_EP_TX_STATUS(USBx, bEpNum) \
415 #define PCD_GET_EP_RX_STALL_STATUS(USBx, bEpNum) (PCD_GET_EP_RX_STATUS(USBx, bEpNum) \
419 * @brief set & clear EP_KIND bit.
420 * @param bEpNum: Endpoint Number.
423 #define PCD_SET_EP_KIND(USBx, bEpNum) (PCD_SET_ENDPOINT(USBx, bEpNum, \
424 (USB_EP_CTR_RX|USB_EP_CTR_TX|((PCD_GET_ENDPOINT(USBx, bEpNum) | USB_EP_KIND) & USB_EPREG_MASK))))
425 #define PCD_CLEAR_EP_KIND(USBx, bEpNum) (PCD_SET_ENDPOINT(USBx, bEpNum, \
426 (USB_EP_CTR_RX|USB_EP_CTR_TX|(PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EPKIND_MASK))))
429 * @brief Sets/clears directly STATUS_OUT bit in the endpoint register.
430 * @param bEpNum: Endpoint Number.
433 #define PCD_SET_OUT_STATUS(USBx, bEpNum) PCD_SET_EP_KIND(USBx, bEpNum)
434 #define PCD_CLEAR_OUT_STATUS(USBx, bEpNum) PCD_CLEAR_EP_KIND(USBx, bEpNum)
437 * @brief Sets/clears directly EP_KIND bit in the endpoint register.
438 * @param bEpNum: Endpoint Number.
441 #define PCD_SET_EP_DBUF(USBx, bEpNum) PCD_SET_EP_KIND(USBx, bEpNum)
442 #define PCD_CLEAR_EP_DBUF(USBx, bEpNum) PCD_CLEAR_EP_KIND(USBx, bEpNum)
445 * @brief Clears bit CTR_RX / CTR_TX in the endpoint register.
446 * @param bEpNum: Endpoint Number.
449 #define PCD_CLEAR_RX_EP_CTR(USBx, bEpNum) (PCD_SET_ENDPOINT(USBx, bEpNum,\
450 PCD_GET_ENDPOINT(USBx, bEpNum) & 0x7FFF & USB_EPREG_MASK))
451 #define PCD_CLEAR_TX_EP_CTR(USBx, bEpNum) (PCD_SET_ENDPOINT(USBx, bEpNum,\
452 PCD_GET_ENDPOINT(USBx, bEpNum) & 0xFF7F & USB_EPREG_MASK))
455 * @brief Toggles DTOG_RX / DTOG_TX bit in the endpoint register.
456 * @param bEpNum: Endpoint Number.
459 #define PCD_RX_DTOG(USBx, bEpNum) (PCD_SET_ENDPOINT(USBx, bEpNum, \
460 USB_EP_CTR_RX|USB_EP_CTR_TX|USB_EP_DTOG_RX | (PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EPREG_MASK)))
461 #define PCD_TX_DTOG(USBx, bEpNum) (PCD_SET_ENDPOINT(USBx, bEpNum, \
462 USB_EP_CTR_RX|USB_EP_CTR_TX|USB_EP_DTOG_TX | (PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EPREG_MASK)))
465 * @brief Clears DTOG_RX / DTOG_TX bit in the endpoint register.
466 * @param bEpNum: Endpoint Number.
469 #define PCD_CLEAR_RX_DTOG(USBx, bEpNum) if((PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EP_DTOG_RX) != 0)\
470 PCD_RX_DTOG(USBx, bEpNum)
471 #define PCD_CLEAR_TX_DTOG(USBx, bEpNum) if((PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EP_DTOG_TX) != 0)\
472 PCD_TX_DTOG(USBx, bEpNum)
475 * @brief Sets address in an endpoint register.
476 * @param bEpNum: Endpoint Number.
477 * @param bAddr: Address.
480 #define PCD_SET_EP_ADDRESS(USBx, bEpNum,bAddr) PCD_SET_ENDPOINT(USBx, bEpNum,\
481 USB_EP_CTR_RX|USB_EP_CTR_TX|(PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EPREG_MASK) | bAddr)
484 * @brief Gets address in an endpoint register.
485 * @param bEpNum: Endpoint Number.
488 #define PCD_GET_EP_ADDRESS(USBx, bEpNum) ((uint8_t)(PCD_GET_ENDPOINT(USBx, bEpNum) & USB_EPADDR_FIELD))
489 #define PCD_EP_TX_ADDRESS(USBx, bEpNum) ((uint16_t *)((USBx->BTABLE+bEpNum*8)+ ((uint32_t)USBx + 0x400)))
490 #define PCD_EP_TX_CNT(USBx, bEpNum) ((uint16_t *)((USBx->BTABLE+bEpNum*8+2)+ ((uint32_t)USBx + 0x400)))
491 #define PCD_EP_RX_ADDRESS(USBx, bEpNum) ((uint16_t *)((USBx->BTABLE+bEpNum*8+4)+ ((uint32_t)USBx + 0x400)))
492 #define PCD_EP_RX_CNT(USBx, bEpNum) ((uint16_t *)((USBx->BTABLE+bEpNum*8+6)+ ((uint32_t)USBx + 0x400)))
495 * @brief sets address of the tx/rx buffer.
496 * @param bEpNum: Endpoint Number.
497 * @param wAddr: address to be set (must be word aligned).
500 #define PCD_SET_EP_TX_ADDRESS(USBx, bEpNum,wAddr) (*PCD_EP_TX_ADDRESS(USBx, bEpNum) = ((wAddr >> 1) << 1))
501 #define PCD_SET_EP_RX_ADDRESS(USBx, bEpNum,wAddr) (*PCD_EP_RX_ADDRESS(USBx, bEpNum) = ((wAddr >> 1) << 1))
504 * @brief Gets address of the tx/rx buffer.
505 * @param bEpNum: Endpoint Number.
506 * @retval address of the buffer.
508 #define PCD_GET_EP_TX_ADDRESS(USBx, bEpNum) ((uint16_t)*PCD_EP_TX_ADDRESS(USBx, bEpNum))
509 #define PCD_GET_EP_RX_ADDRESS(USBx, bEpNum) ((uint16_t)*PCD_EP_RX_ADDRESS(USBx, bEpNum))
512 * @brief Sets counter of rx buffer with no. of blocks.
513 * @param bEpNum: Endpoint Number.
514 * @param wCount: Counter.
517 #define PCD_CALC_BLK32(dwReg,wCount,wNBlocks) {\
518 wNBlocks = wCount >> 5;\
519 if((wCount & 0x1f) == 0)\
521 *pdwReg = (uint16_t)((wNBlocks << 10) | 0x8000);\
522 }/* PCD_CALC_BLK32 */
524 #define PCD_CALC_BLK2(dwReg,wCount,wNBlocks) {\
525 wNBlocks = wCount >> 1;\
526 if((wCount & 0x1) != 0)\
528 *pdwReg = (uint16_t)(wNBlocks << 10);\
531 #define PCD_SET_EP_CNT_RX_REG(dwReg,wCount) {\
533 if(wCount > 62){PCD_CALC_BLK32(dwReg,wCount,wNBlocks);}\
534 else {PCD_CALC_BLK2(dwReg,wCount,wNBlocks);}\
535 }/* PCD_SET_EP_CNT_RX_REG */
537 #define PCD_SET_EP_RX_DBUF0_CNT(USBx, bEpNum,wCount) {\
538 uint16_t *pdwReg = PCD_EP_TX_CNT(USBx, bEpNum); \
539 PCD_SET_EP_CNT_RX_REG(pdwReg, wCount);\
542 * @brief sets counter for the tx/rx buffer.
543 * @param bEpNum: Endpoint Number.
544 * @param wCount: Counter value.
547 #define PCD_SET_EP_TX_CNT(USBx, bEpNum,wCount) (*PCD_EP_TX_CNT(USBx, bEpNum) = wCount)
548 #define PCD_SET_EP_RX_CNT(USBx, bEpNum,wCount) {\
549 uint16_t *pdwReg = PCD_EP_RX_CNT(USBx, bEpNum); \
550 PCD_SET_EP_CNT_RX_REG(pdwReg, wCount);\
554 * @brief gets counter of the tx buffer.
555 * @param bEpNum: Endpoint Number.
556 * @retval Counter value
558 #define PCD_GET_EP_TX_CNT(USBx, bEpNum)((uint16_t)(*PCD_EP_TX_CNT(USBx, bEpNum)) & 0x3ff)
559 #define PCD_GET_EP_RX_CNT(USBx, bEpNum)((uint16_t)(*PCD_EP_RX_CNT(USBx, bEpNum)) & 0x3ff)
562 * @brief Sets buffer 0/1 address in a double buffer endpoint.
563 * @param bEpNum: Endpoint Number.
564 * @param wBuf0Addr: buffer 0 address.
565 * @retval Counter value
567 #define PCD_SET_EP_DBUF0_ADDR(USBx, bEpNum,wBuf0Addr) {PCD_SET_EP_TX_ADDRESS(USBx, bEpNum, wBuf0Addr);}
568 #define PCD_SET_EP_DBUF1_ADDR(USBx, bEpNum,wBuf1Addr) {PCD_SET_EP_RX_ADDRESS(USBx, bEpNum, wBuf1Addr);}
571 * @brief Sets addresses in a double buffer endpoint.
572 * @param bEpNum: Endpoint Number.
573 * @param wBuf0Addr: buffer 0 address.
574 * @param wBuf1Addr = buffer 1 address.
577 #define PCD_SET_EP_DBUF_ADDR(USBx, bEpNum,wBuf0Addr,wBuf1Addr) { \
578 PCD_SET_EP_DBUF0_ADDR(USBx, bEpNum, wBuf0Addr);\
579 PCD_SET_EP_DBUF1_ADDR(USBx, bEpNum, wBuf1Addr);\
580 } /* PCD_SET_EP_DBUF_ADDR */
583 * @brief Gets buffer 0/1 address of a double buffer endpoint.
584 * @param bEpNum: Endpoint Number.
587 #define PCD_GET_EP_DBUF0_ADDR(USBx, bEpNum) (PCD_GET_EP_TX_ADDRESS(USBx, bEpNum))
588 #define PCD_GET_EP_DBUF1_ADDR(USBx, bEpNum) (PCD_GET_EP_RX_ADDRESS(USBx, bEpNum))
591 * @brief Gets buffer 0/1 address of a double buffer endpoint.
592 * @param bEpNum: Endpoint Number.
593 * bDir: endpoint dir EP_DBUF_OUT = OUT
595 * @param wCount: Counter value
598 #define PCD_SET_EP_DBUF0_CNT(USBx, bEpNum, bDir, wCount) { \
599 if(bDir == PCD_EP_DBUF_OUT)\
601 {PCD_SET_EP_RX_DBUF0_CNT(USBx, bEpNum,wCount);} \
602 else if(bDir == PCD_EP_DBUF_IN)\
604 *PCD_EP_TX_CNT(USBx, bEpNum) = (uint32_t)wCount; \
605 } /* SetEPDblBuf0Count*/
607 #define PCD_SET_EP_DBUF1_CNT(USBx, bEpNum, bDir, wCount) { \
608 if(bDir == PCD_EP_DBUF_OUT)\
610 {PCD_SET_EP_RX_CNT(USBx, bEpNum,wCount);}\
611 else if(bDir == PCD_EP_DBUF_IN)\
613 *PCD_EP_RX_CNT(USBx, bEpNum) = (uint32_t)wCount; \
614 } /* SetEPDblBuf1Count */
616 #define PCD_SET_EP_DBUF_CNT(USBx, bEpNum, bDir, wCount) {\
617 PCD_SET_EP_DBUF0_CNT(USBx, bEpNum, bDir, wCount); \
618 PCD_SET_EP_DBUF1_CNT(USBx, bEpNum, bDir, wCount); \
619 } /* PCD_SET_EP_DBUF_CNT */
622 * @brief Gets buffer 0/1 rx/tx counter for double buffering.
623 * @param bEpNum: Endpoint Number.
626 #define PCD_GET_EP_DBUF0_CNT(USBx, bEpNum) (PCD_GET_EP_TX_CNT(USBx, bEpNum))
627 #define PCD_GET_EP_DBUF1_CNT(USBx, bEpNum) (PCD_GET_EP_RX_CNT(USBx, bEpNum))
634 /* Exported functions --------------------------------------------------------*/
636 /* Initialization/de-initialization functions **********************************/
637 HAL_StatusTypeDef HAL_PCD_Init(PCD_HandleTypeDef *hpcd);
638 HAL_StatusTypeDef HAL_PCD_DeInit (PCD_HandleTypeDef *hpcd);
639 void HAL_PCD_MspInit(PCD_HandleTypeDef *hpcd);
640 void HAL_PCD_MspDeInit(PCD_HandleTypeDef *hpcd);
642 /* I/O operation functions *****************************************************/
643 /* Non-Blocking mode: Interrupt */
644 HAL_StatusTypeDef HAL_PCD_Start(PCD_HandleTypeDef *hpcd);
645 HAL_StatusTypeDef HAL_PCD_Stop(PCD_HandleTypeDef *hpcd);
646 void HAL_PCD_IRQHandler(PCD_HandleTypeDef *hpcd);
648 void HAL_PCD_DataOutStageCallback(PCD_HandleTypeDef *hpcd, uint8_t epnum);
649 void HAL_PCD_DataInStageCallback(PCD_HandleTypeDef *hpcd, uint8_t epnum);
650 void HAL_PCD_SetupStageCallback(PCD_HandleTypeDef *hpcd);
651 void HAL_PCD_SOFCallback(PCD_HandleTypeDef *hpcd);
652 void HAL_PCD_ResetCallback(PCD_HandleTypeDef *hpcd);
653 void HAL_PCD_SuspendCallback(PCD_HandleTypeDef *hpcd);
654 void HAL_PCD_ResumeCallback(PCD_HandleTypeDef *hpcd);
655 void HAL_PCD_ISOOUTIncompleteCallback(PCD_HandleTypeDef *hpcd, uint8_t epnum);
656 void HAL_PCD_ISOINIncompleteCallback(PCD_HandleTypeDef *hpcd, uint8_t epnum);
657 void HAL_PCD_ConnectCallback(PCD_HandleTypeDef *hpcd);
658 void HAL_PCD_DisconnectCallback(PCD_HandleTypeDef *hpcd);
662 /* Peripheral Control functions ************************************************/
663 HAL_StatusTypeDef HAL_PCD_DevConnect(PCD_HandleTypeDef *hpcd);
664 HAL_StatusTypeDef HAL_PCD_DevDisconnect(PCD_HandleTypeDef *hpcd);
665 HAL_StatusTypeDef HAL_PCD_SetAddress(PCD_HandleTypeDef *hpcd, uint8_t address);
666 HAL_StatusTypeDef HAL_PCD_EP_Open(PCD_HandleTypeDef *hpcd, uint8_t ep_addr, uint16_t ep_mps, uint8_t ep_type);
667 HAL_StatusTypeDef HAL_PCD_EP_Close(PCD_HandleTypeDef *hpcd, uint8_t ep_addr);
668 HAL_StatusTypeDef HAL_PCD_EP_Receive(PCD_HandleTypeDef *hpcd, uint8_t ep_addr, uint8_t *pBuf, uint32_t len);
669 HAL_StatusTypeDef HAL_PCD_EP_Transmit(PCD_HandleTypeDef *hpcd, uint8_t ep_addr, uint8_t *pBuf, uint32_t len);
670 uint16_t HAL_PCD_EP_GetRxCount(PCD_HandleTypeDef *hpcd, uint8_t ep_addr);
671 HAL_StatusTypeDef HAL_PCD_EP_SetStall(PCD_HandleTypeDef *hpcd, uint8_t ep_addr);
672 HAL_StatusTypeDef HAL_PCD_EP_ClrStall(PCD_HandleTypeDef *hpcd, uint8_t ep_addr);
673 HAL_StatusTypeDef HAL_PCD_EP_Flush(PCD_HandleTypeDef *hpcd, uint8_t ep_addr);
674 HAL_StatusTypeDef HAL_PCD_ActivateRemoteWakeup(PCD_HandleTypeDef *hpcd);
675 HAL_StatusTypeDef HAL_PCD_DeActivateRemoteWakeup(PCD_HandleTypeDef *hpcd);
676 /* Peripheral State functions **************************************************/
677 PCD_StateTypeDef HAL_PCD_GetState(PCD_HandleTypeDef *hpcd);
687 #endif /* #if !defined (STM32L031xx) && !defined (STM32L041xx) && !defined (STM32L051xx) && !defined (STM32L061xx) && !defined (STM32L071xx) && !defined (STM32L081xx) */
694 #endif /* __STM32L0xx_HAL_PCD_H */
696 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/