1 /**
2   ******************************************************************************
3   * @file    stm32l5xx_hal_sd_ex.h
4   * @author  MCD Application Team
5   * @brief   Header file of SD HAL extended module.
6   ******************************************************************************
7   * @attention
8   *
9   * Copyright (c) 2019 STMicroelectronics.
10   * All rights reserved.
11   *
12   * This software is licensed under terms that can be found in the LICENSE file
13   * in the root directory of this software component.
14   * If no LICENSE file comes with this software, it is provided AS-IS.
15   *
16   ******************************************************************************
17   */
18 
19 /* Define to prevent recursive inclusion -------------------------------------*/
20 #ifndef STM32L5xx_HAL_SD_EX_H
21 #define STM32L5xx_HAL_SD_EX_H
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
27 /* Includes ------------------------------------------------------------------*/
28 #include "stm32l5xx_hal_def.h"
29 
30 /** @addtogroup STM32L5xx_HAL_Driver
31   * @{
32   */
33 #if defined (SDMMC1) || defined (SDMMC2)
34 
35 /** @addtogroup SDEx
36   * @brief SD HAL extended module driver
37   * @{
38   */
39 
40 /* Exported types ------------------------------------------------------------*/
41 /** @defgroup SDEx_Exported_Types SDEx Exported Types
42   * @{
43   */
44 
45 /** @defgroup SDEx_Exported_Types_Group1 SD Card Internal DMA Buffer structure
46   * @{
47   */
48 typedef enum
49 {
50   SD_DMA_BUFFER0      = 0x00U,    /*!< selects SD internal DMA Buffer 0     */
51   SD_DMA_BUFFER1      = 0x01U,    /*!< selects SD internal DMA Buffer 1     */
52 
53 } HAL_SDEx_DMABuffer_MemoryTypeDef;
54 
55 /**
56   * @}
57   */
58 /**
59   * @}
60   */
61 
62 /* Exported functions --------------------------------------------------------*/
63 /** @defgroup SDEx_Exported_Functions SDEx Exported Functions
64   * @{
65   */
66 
67 /** @defgroup SDEx_Exported_Functions_Group1 MultiBuffer functions
68   * @{
69   */
70 
71 HAL_StatusTypeDef HAL_SDEx_ConfigDMAMultiBuffer(SD_HandleTypeDef *hsd, uint32_t *pDataBuffer0, uint32_t *pDataBuffer1,
72                                                 uint32_t BufferSize);
73 HAL_StatusTypeDef HAL_SDEx_ReadBlocksDMAMultiBuffer(SD_HandleTypeDef *hsd, uint32_t BlockAdd, uint32_t NumberOfBlocks);
74 HAL_StatusTypeDef HAL_SDEx_WriteBlocksDMAMultiBuffer(SD_HandleTypeDef *hsd, uint32_t BlockAdd, uint32_t NumberOfBlocks);
75 HAL_StatusTypeDef HAL_SDEx_ChangeDMABuffer(SD_HandleTypeDef *hsd, HAL_SDEx_DMABuffer_MemoryTypeDef Buffer,
76                                            uint32_t *pDataBuffer);
77 
78 void HAL_SDEx_Read_DMADoubleBuf0CpltCallback(SD_HandleTypeDef *hsd);
79 void HAL_SDEx_Read_DMADoubleBuf1CpltCallback(SD_HandleTypeDef *hsd);
80 void HAL_SDEx_Write_DMADoubleBuf0CpltCallback(SD_HandleTypeDef *hsd);
81 void HAL_SDEx_Write_DMADoubleBuf1CpltCallback(SD_HandleTypeDef *hsd);
82 
83 /**
84   * @}
85   */
86 
87 /**
88   * @}
89   */
90 
91 /* Private types -------------------------------------------------------------*/
92 /* Private defines -----------------------------------------------------------*/
93 /* Private variables ---------------------------------------------------------*/
94 /* Private constants ---------------------------------------------------------*/
95 /* Private macros ------------------------------------------------------------*/
96 /* Private functions prototypes ----------------------------------------------*/
97 /* Private functions ---------------------------------------------------------*/
98 
99 /**
100   * @}
101   */
102 #endif /* SDMMC1 || SDMMC2 */
103 
104 /**
105   * @}
106   */
107 #ifdef __cplusplus
108 }
109 #endif
110 
111 
112 #endif /* stm32l5xx_HAL_SD_EX_H */
113