1 /**
2   ******************************************************************************
3   * @file    stm32l4xx_hal_sd_ex.h
4   * @author  MCD Application Team
5   * @brief   Header file of SD HAL extended module.
6   ******************************************************************************
7   * @attention
8   *
9   * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics</center></h2>
10   *
11   * Redistribution and use in source and binary forms, with or without modification,
12   * are permitted provided that the following conditions are met:
13   *   1. Redistributions of source code must retain the above copyright notice,
14   *      this list of conditions and the following disclaimer.
15   *   2. Redistributions in binary form must reproduce the above copyright notice,
16   *      this list of conditions and the following disclaimer in the documentation
17   *      and/or other materials provided with the distribution.
18   *   3. Neither the name of STMicroelectronics nor the names of its contributors
19   *      may be used to endorse or promote products derived from this software
20   *      without specific prior written permission.
21   *
22   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
23   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
25   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
26   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
28   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
29   * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32   *
33   ******************************************************************************
34   */
35 
36 /* Define to prevent recursive inclusion -------------------------------------*/
37 #ifndef STM32L4xx_HAL_SD_EX_H
38 #define STM32L4xx_HAL_SD_EX_H
39 
40 #ifdef __cplusplus
41  extern "C" {
42 #endif
43 
44 #if defined(STM32L4R5xx) || defined(STM32L4R7xx) || defined(STM32L4R9xx) || defined(STM32L4S5xx) || defined(STM32L4S7xx) || defined(STM32L4S9xx)
45 
46 /* Includes ------------------------------------------------------------------*/
47 #include "stm32l4xx_hal_def.h"
48 
49 /** @addtogroup STM32L4xx_HAL_Driver
50   * @{
51   */
52 
53 /** @addtogroup SDEx
54   * @{
55   */
56 
57 /* Exported types ------------------------------------------------------------*/
58 /** @defgroup SDEx_Exported_Types SDEx Exported Types
59   * @{
60   */
61 
62 /** @defgroup SDEx_Exported_Types_Group1 SD Card Internal DMA Buffer structure
63   * @{
64   */
65 typedef enum
66 {
67   SD_DMA_BUFFER0      = 0x00U,    /*!< selects SD internal DMA Buffer 0     */
68   SD_DMA_BUFFER1      = 0x01U,    /*!< selects SD internal DMA Buffer 1     */
69 
70 }HAL_SDEx_DMABuffer_MemoryTypeDef;
71 
72 
73 /**
74   * @}
75   */
76 
77 /**
78   * @}
79   */
80 /* Exported constants --------------------------------------------------------*/
81 /* Exported macro ------------------------------------------------------------*/
82 /* Exported functions --------------------------------------------------------*/
83 /** @defgroup SDEx_Exported_Functions SDEx Exported Functions
84   * @{
85   */
86 
87 /** @defgroup SDEx_Exported_Functions_Group1 HighSpeed functions
88   * @{
89   */
90 uint32_t HAL_SDEx_HighSpeed (SD_HandleTypeDef *hsd);
91 
92 void HAL_SDEx_DriveTransceiver_1_8V_Callback(FlagStatus status);
93 
94 /**
95   * @}
96   */
97 
98 /** @defgroup SDEx_Exported_Functions_Group2 MultiBuffer functions
99   * @{
100   */
101 HAL_StatusTypeDef HAL_SDEx_ConfigDMAMultiBuffer(SD_HandleTypeDef *hsd, uint32_t * pDataBuffer0, uint32_t * pDataBuffer1, uint32_t BufferSize);
102 HAL_StatusTypeDef HAL_SDEx_ReadBlocksDMAMultiBuffer(SD_HandleTypeDef *hsd, uint32_t BlockAdd, uint32_t NumberOfBlocks);
103 HAL_StatusTypeDef HAL_SDEx_WriteBlocksDMAMultiBuffer(SD_HandleTypeDef *hsd, uint32_t BlockAdd, uint32_t NumberOfBlocks);
104 HAL_StatusTypeDef HAL_SDEx_ChangeDMABuffer(SD_HandleTypeDef *hsd, HAL_SDEx_DMABuffer_MemoryTypeDef Buffer, uint32_t *pDataBuffer);
105 
106 void HAL_SDEx_Read_DMADoubleBuffer0CpltCallback(SD_HandleTypeDef *hsd);
107 void HAL_SDEx_Read_DMADoubleBuffer1CpltCallback(SD_HandleTypeDef *hsd);
108 void HAL_SDEx_Write_DMADoubleBuffer0CpltCallback(SD_HandleTypeDef *hsd);
109 void HAL_SDEx_Write_DMADoubleBuffer1CpltCallback(SD_HandleTypeDef *hsd);
110 
111 /**
112   * @}
113   */
114 
115 /**
116   * @}
117   */
118 
119 /* Private types -------------------------------------------------------------*/
120 /* Private defines -----------------------------------------------------------*/
121 /* Private variables ---------------------------------------------------------*/
122 /* Private constants ---------------------------------------------------------*/
123 /* Private macros ------------------------------------------------------------*/
124 /* Private functions prototypes ----------------------------------------------*/
125 /* Private functions ---------------------------------------------------------*/
126 
127 /**
128   * @}
129   */
130 
131 /**
132   * @}
133   */
134 
135 #endif /* STM32L4R5xx || STM32L4R7xx || STM32L4R9xx || STM32L4S5xx || STM32L4S7xx || STM32L4S9xx */
136 
137 #ifdef __cplusplus
138 }
139 #endif
140 
141 
142 #endif /* STM32L4xx_HAL_SDEx_H */
143 
144 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
145