Felipe Gomes / BSP_DISCO_F469NI

library

Dependents:   Aprendendo Final_v3

stm32469i_discovery/stm32469i_discovery_sd.h@0:0002c86c2220, 2015-12-18 (annotated)

Committer:
bcostm
Date:
Fri Dec 18 07:32:01 2015 +0000
Revision:
0:0002c86c2220
Initial version

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bcostm 0:0002c86c2220 1 /**
bcostm 0:0002c86c2220 2 ******************************************************************************
bcostm 0:0002c86c2220 3 * @file stm32469i_discovery_sd.h
bcostm 0:0002c86c2220 4 * @author MCD Application Team
bcostm 0:0002c86c2220 5 * @version V1.0.1
bcostm 0:0002c86c2220 6 * @date 29-September-2015
bcostm 0:0002c86c2220 7 * @brief This file contains the common defines and functions prototypes for
bcostm 0:0002c86c2220 8 * the stm32469i_discovery_sd.c driver.
bcostm 0:0002c86c2220 9 ******************************************************************************
bcostm 0:0002c86c2220 10 * @attention
bcostm 0:0002c86c2220 11 *
bcostm 0:0002c86c2220 12 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
bcostm 0:0002c86c2220 13 *
bcostm 0:0002c86c2220 14 * Redistribution and use in source and binary forms, with or without modification,
bcostm 0:0002c86c2220 15 * are permitted provided that the following conditions are met:
bcostm 0:0002c86c2220 16 * 1. Redistributions of source code must retain the above copyright notice,
bcostm 0:0002c86c2220 17 * this list of conditions and the following disclaimer.
bcostm 0:0002c86c2220 18 * 2. Redistributions in binary form must reproduce the above copyright notice,
bcostm 0:0002c86c2220 19 * this list of conditions and the following disclaimer in the documentation
bcostm 0:0002c86c2220 20 * and/or other materials provided with the distribution.
bcostm 0:0002c86c2220 21 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bcostm 0:0002c86c2220 22 * may be used to endorse or promote products derived from this software
bcostm 0:0002c86c2220 23 * without specific prior written permission.
bcostm 0:0002c86c2220 24 *
bcostm 0:0002c86c2220 25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bcostm 0:0002c86c2220 26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bcostm 0:0002c86c2220 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bcostm 0:0002c86c2220 28 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bcostm 0:0002c86c2220 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bcostm 0:0002c86c2220 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bcostm 0:0002c86c2220 31 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bcostm 0:0002c86c2220 32 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bcostm 0:0002c86c2220 33 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bcostm 0:0002c86c2220 34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bcostm 0:0002c86c2220 35 *
bcostm 0:0002c86c2220 36 ******************************************************************************
bcostm 0:0002c86c2220 37 */
bcostm 0:0002c86c2220 38
bcostm 0:0002c86c2220 39 /* Define to prevent recursive inclusion -------------------------------------*/
bcostm 0:0002c86c2220 40 #ifndef __STM32469I_DISCOVERY_SD_H
bcostm 0:0002c86c2220 41 #define __STM32469I_DISCOVERY_SD_H
bcostm 0:0002c86c2220 42
bcostm 0:0002c86c2220 43 #ifdef __cplusplus
bcostm 0:0002c86c2220 44 extern "C" {
bcostm 0:0002c86c2220 45 #endif
bcostm 0:0002c86c2220 46
bcostm 0:0002c86c2220 47 /* Includes ------------------------------------------------------------------*/
bcostm 0:0002c86c2220 48 #include "stm32469i_discovery.h"
bcostm 0:0002c86c2220 49
bcostm 0:0002c86c2220 50 /** @addtogroup BSP
bcostm 0:0002c86c2220 51 * @{
bcostm 0:0002c86c2220 52 */
bcostm 0:0002c86c2220 53
bcostm 0:0002c86c2220 54 /** @addtogroup STM32469I-Discovery
bcostm 0:0002c86c2220 55 * @{
bcostm 0:0002c86c2220 56 */
bcostm 0:0002c86c2220 57
bcostm 0:0002c86c2220 58 /** @defgroup STM32469I-Discovery_SD STM32469I-Discovery SD
bcostm 0:0002c86c2220 59 * @{
bcostm 0:0002c86c2220 60 */
bcostm 0:0002c86c2220 61
bcostm 0:0002c86c2220 62 /** @defgroup STM32469I-Discovery_SD_Exported_Types SD Exported Types
bcostm 0:0002c86c2220 63 * @{
bcostm 0:0002c86c2220 64 */
bcostm 0:0002c86c2220 65
bcostm 0:0002c86c2220 66 /**
bcostm 0:0002c86c2220 67 * @brief SD Card information structure
bcostm 0:0002c86c2220 68 */
bcostm 0:0002c86c2220 69 #define SD_CardInfo HAL_SD_CardInfoTypedef
bcostm 0:0002c86c2220 70 /**
bcostm 0:0002c86c2220 71 * @}
bcostm 0:0002c86c2220 72 */
bcostm 0:0002c86c2220 73
bcostm 0:0002c86c2220 74 /**
bcostm 0:0002c86c2220 75 * @brief SD status structure definition
bcostm 0:0002c86c2220 76 */
bcostm 0:0002c86c2220 77 #define MSD_OK ((uint8_t)0x00)
bcostm 0:0002c86c2220 78 #define MSD_ERROR ((uint8_t)0x01)
bcostm 0:0002c86c2220 79 #define MSD_ERROR_SD_NOT_PRESENT ((uint8_t)0x02)
bcostm 0:0002c86c2220 80
bcostm 0:0002c86c2220 81 /** @defgroup STM32469I-Discovery_SD_Exported_Constants SD Exported Constants
bcostm 0:0002c86c2220 82 * @{
bcostm 0:0002c86c2220 83 */
bcostm 0:0002c86c2220 84 #define SD_PRESENT ((uint8_t)0x01)
bcostm 0:0002c86c2220 85 #define SD_NOT_PRESENT ((uint8_t)0x00)
bcostm 0:0002c86c2220 86
bcostm 0:0002c86c2220 87 #define SD_DATATIMEOUT ((uint32_t)100000000)
bcostm 0:0002c86c2220 88
bcostm 0:0002c86c2220 89 /* DMA definitions for SD DMA transfer */
bcostm 0:0002c86c2220 90 #define __DMAx_TxRx_CLK_ENABLE __HAL_RCC_DMA2_CLK_ENABLE
bcostm 0:0002c86c2220 91 #define SD_DMAx_Tx_CHANNEL DMA_CHANNEL_4
bcostm 0:0002c86c2220 92 #define SD_DMAx_Rx_CHANNEL DMA_CHANNEL_4
bcostm 0:0002c86c2220 93 #define SD_DMAx_Tx_STREAM DMA2_Stream6
bcostm 0:0002c86c2220 94 #define SD_DMAx_Rx_STREAM DMA2_Stream3
bcostm 0:0002c86c2220 95 #define SD_DMAx_Tx_IRQn DMA2_Stream6_IRQn
bcostm 0:0002c86c2220 96 #define SD_DMAx_Rx_IRQn DMA2_Stream3_IRQn
bcostm 0:0002c86c2220 97 #define SD_DMAx_Tx_IRQHandler DMA2_Stream6_IRQHandler
bcostm 0:0002c86c2220 98 #define SD_DMAx_Rx_IRQHandler DMA2_Stream3_IRQHandler
bcostm 0:0002c86c2220 99 #define SD_DetectIRQHandler() HAL_GPIO_EXTI_IRQHandler(GPIO_PIN_8)
bcostm 0:0002c86c2220 100 /**
bcostm 0:0002c86c2220 101 * @}
bcostm 0:0002c86c2220 102 */
bcostm 0:0002c86c2220 103
bcostm 0:0002c86c2220 104 /** @defgroup STM32469I-Discovery_SD_Exported_Macro STM32469I Discovery SD Exported Macro
bcostm 0:0002c86c2220 105 * @{
bcostm 0:0002c86c2220 106 */
bcostm 0:0002c86c2220 107 /**
bcostm 0:0002c86c2220 108 * @}
bcostm 0:0002c86c2220 109 */
bcostm 0:0002c86c2220 110
bcostm 0:0002c86c2220 111 /** @defgroup STM32469I-Discovery_SD_Exported_Functions STM32469I Discovery SD Exported Functions
bcostm 0:0002c86c2220 112 * @{
bcostm 0:0002c86c2220 113 */
bcostm 0:0002c86c2220 114 uint8_t BSP_SD_Init(void);
bcostm 0:0002c86c2220 115 uint8_t BSP_SD_DeInit(void);
bcostm 0:0002c86c2220 116 uint8_t BSP_SD_ITConfig(void);
bcostm 0:0002c86c2220 117
bcostm 0:0002c86c2220 118
bcostm 0:0002c86c2220 119 uint8_t BSP_SD_ReadBlocks(uint32_t *pData, uint64_t ReadAddr, uint32_t BlockSize, uint32_t NumOfBlocks);
bcostm 0:0002c86c2220 120 uint8_t BSP_SD_WriteBlocks(uint32_t *pData, uint64_t WriteAddr, uint32_t BlockSize, uint32_t NumOfBlocks);
bcostm 0:0002c86c2220 121 uint8_t BSP_SD_ReadBlocks_DMA(uint32_t *pData, uint64_t ReadAddr, uint32_t BlockSize, uint32_t NumOfBlocks);
bcostm 0:0002c86c2220 122 uint8_t BSP_SD_WriteBlocks_DMA(uint32_t *pData, uint64_t WriteAddr, uint32_t BlockSize, uint32_t NumOfBlocks);
bcostm 0:0002c86c2220 123 uint8_t BSP_SD_Erase(uint64_t StartAddr, uint64_t EndAddr);
bcostm 0:0002c86c2220 124 void BSP_SD_IRQHandler(void);
bcostm 0:0002c86c2220 125 void BSP_SD_DMA_Tx_IRQHandler(void);
bcostm 0:0002c86c2220 126 void BSP_SD_DMA_Rx_IRQHandler(void);
bcostm 0:0002c86c2220 127 HAL_SD_TransferStateTypedef BSP_SD_GetStatus(void);
bcostm 0:0002c86c2220 128 void BSP_SD_GetCardInfo(HAL_SD_CardInfoTypedef *CardInfo);
bcostm 0:0002c86c2220 129 uint8_t BSP_SD_IsDetected(void);
bcostm 0:0002c86c2220 130
bcostm 0:0002c86c2220 131 /* These __weak function can be surcharged by application code in case the current settings (e.g. DMA stream)
bcostm 0:0002c86c2220 132 need to be changed for specific needs */
bcostm 0:0002c86c2220 133 void BSP_SD_MspInit(SD_HandleTypeDef *hsd, void *Params);
bcostm 0:0002c86c2220 134 void BSP_SD_Detect_MspInit(SD_HandleTypeDef *hsd, void *Params);
bcostm 0:0002c86c2220 135 void BSP_SD_MspDeInit(SD_HandleTypeDef *hsd, void *Params);
bcostm 0:0002c86c2220 136
bcostm 0:0002c86c2220 137 /**
bcostm 0:0002c86c2220 138 * @}
bcostm 0:0002c86c2220 139 */
bcostm 0:0002c86c2220 140
bcostm 0:0002c86c2220 141 /**
bcostm 0:0002c86c2220 142 * @}
bcostm 0:0002c86c2220 143 */
bcostm 0:0002c86c2220 144
bcostm 0:0002c86c2220 145 /**
bcostm 0:0002c86c2220 146 * @}
bcostm 0:0002c86c2220 147 */
bcostm 0:0002c86c2220 148
bcostm 0:0002c86c2220 149 /**
bcostm 0:0002c86c2220 150 * @}
bcostm 0:0002c86c2220 151 */
bcostm 0:0002c86c2220 152
bcostm 0:0002c86c2220 153 #ifdef __cplusplus
bcostm 0:0002c86c2220 154 }
bcostm 0:0002c86c2220 155 #endif
bcostm 0:0002c86c2220 156
bcostm 0:0002c86c2220 157 #endif /* __STM32469I_DISCOVERY_SD_H */
bcostm 0:0002c86c2220 158
bcostm 0:0002c86c2220 159 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/