436 lines
14 KiB
C
436 lines
14 KiB
C
/**
|
|
******************************************************************************
|
|
* @file bsp_driver_sd.c for F4 (based on stm324x9i_eval_sd.c)
|
|
* @brief This file includes a generic uSD card driver.
|
|
******************************************************************************
|
|
* This notice applies to any and all portions of this file
|
|
* that are not between comment pairs USER CODE BEGIN and
|
|
* USER CODE END. Other portions of this file, whether
|
|
* inserted by the user or by software development tools
|
|
* are owned by their respective copyright owners.
|
|
*
|
|
* Copyright (c) 2018 STMicroelectronics International N.V.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted, provided that the following conditions are met:
|
|
*
|
|
* 1. Redistribution of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
* 3. Neither the name of STMicroelectronics nor the names of other
|
|
* contributors to this software may be used to endorse or promote products
|
|
* derived from this software without specific written permission.
|
|
* 4. This software, including modifications and/or derivative works of this
|
|
* software, must execute solely and exclusively on microcontroller or
|
|
* microprocessor devices manufactured by or for STMicroelectronics.
|
|
* 5. Redistribution and use of this software other than as permitted under
|
|
* this license is void and will automatically terminate your rights under
|
|
* this license.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY STMICROELECTRONICS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS, IMPLIED OR STATUTORY WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
|
|
* PARTICULAR PURPOSE AND NON-INFRINGEMENT OF THIRD PARTY INTELLECTUAL PROPERTY
|
|
* RIGHTS ARE DISCLAIMED TO THE FULLEST EXTENT PERMITTED BY LAW. IN NO EVENT
|
|
* SHALL STMICROELECTRONICS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
|
|
* OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
|
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* USER CODE BEGIN FirstSection */
|
|
/* can be used to modify / undefine following code or add new definitions */
|
|
/* USER CODE END FirstSection */
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "bsp_driver_sd.h"
|
|
#include "stm32f4xx_ll_bus.h" /* STM32 LL BUS header */
|
|
#include "stm32f4xx_ll_gpio.h" /* STM32 LL GPIO header */
|
|
|
|
/* Extern variables ---------------------------------------------------------*/
|
|
|
|
SD_HandleTypeDef hsd;
|
|
|
|
/* USER CODE BEGIN BeforeInitSection */
|
|
/* can be used to modify / undefine following code or add code */
|
|
/* USER CODE END BeforeInitSection */
|
|
|
|
|
|
/**
|
|
* @brief Initializes the SD SMP.
|
|
* @param hsd SD device handle.
|
|
*/
|
|
void HAL_SD_MspInit(SD_HandleTypeDef* hsd)
|
|
{
|
|
LL_GPIO_InitTypeDef GPIO_InitStruct;
|
|
|
|
/* Peripheral clock enable */
|
|
LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_SDIO);
|
|
LL_AHB1_GRP1_EnableClock(LL_AHB1_GRP1_PERIPH_GPIOC);
|
|
LL_AHB1_GRP1_EnableClock(LL_AHB1_GRP1_PERIPH_GPIOD);
|
|
|
|
/* SDIO GPIO Configuration:
|
|
* PC8 ------> SDIO_D0
|
|
* PC9 ------> SDIO_D1
|
|
* PC10 ------> SDIO_D2
|
|
* PC11 ------> SDIO_D3
|
|
* PC12 ------> SDIO_CK
|
|
* PD2 ------> SDIO_CMD
|
|
*/
|
|
GPIO_InitStruct.Pin = LL_GPIO_PIN_8 | LL_GPIO_PIN_9 | LL_GPIO_PIN_10 |
|
|
LL_GPIO_PIN_11 | LL_GPIO_PIN_12;
|
|
GPIO_InitStruct.Mode = LL_GPIO_MODE_ALTERNATE;
|
|
GPIO_InitStruct.Speed = LL_GPIO_SPEED_FREQ_VERY_HIGH;
|
|
GPIO_InitStruct.OutputType = LL_GPIO_OUTPUT_PUSHPULL;
|
|
GPIO_InitStruct.Pull = LL_GPIO_PULL_NO;
|
|
GPIO_InitStruct.Alternate = LL_GPIO_AF_12;
|
|
LL_GPIO_Init(GPIOC, &GPIO_InitStruct);
|
|
|
|
GPIO_InitStruct.Pin = LL_GPIO_PIN_2;
|
|
GPIO_InitStruct.Mode = LL_GPIO_MODE_ALTERNATE;
|
|
GPIO_InitStruct.Speed = LL_GPIO_SPEED_FREQ_VERY_HIGH;
|
|
GPIO_InitStruct.OutputType = LL_GPIO_OUTPUT_PUSHPULL;
|
|
GPIO_InitStruct.Pull = LL_GPIO_PULL_NO;
|
|
GPIO_InitStruct.Alternate = LL_GPIO_AF_12;
|
|
LL_GPIO_Init(GPIOD, &GPIO_InitStruct);
|
|
}
|
|
|
|
/**
|
|
* @brief Uninitializes the SD SMP.
|
|
* @param hsd SD device handle.
|
|
*/
|
|
void HAL_SD_MspDeInit(SD_HandleTypeDef* hsd)
|
|
{
|
|
/* Deinit used GPIOs. */
|
|
LL_GPIO_DeInit(GPIOD);
|
|
LL_GPIO_DeInit(GPIOC);
|
|
|
|
/* Peripheral clock disable */
|
|
LL_AHB1_GRP1_DisableClock(LL_AHB1_GRP1_PERIPH_GPIOD);
|
|
LL_AHB1_GRP1_DisableClock(LL_AHB1_GRP1_PERIPH_GPIOC);
|
|
LL_APB2_GRP1_DisableClock(LL_APB2_GRP1_PERIPH_SDIO);
|
|
}
|
|
|
|
|
|
/**
|
|
* @brief Initializes the SD card device.
|
|
* @retval SD status
|
|
*/
|
|
uint8_t BSP_SD_Init(void)
|
|
{
|
|
uint8_t sd_state = MSD_OK;
|
|
|
|
/* Configure the SD instance. */
|
|
hsd.Instance = SDIO;
|
|
hsd.Init.ClockEdge = SDIO_CLOCK_EDGE_RISING;
|
|
hsd.Init.ClockBypass = SDIO_CLOCK_BYPASS_DISABLE;
|
|
hsd.Init.ClockPowerSave = SDIO_CLOCK_POWER_SAVE_DISABLE;
|
|
hsd.Init.BusWide = SDIO_BUS_WIDE_1B;
|
|
hsd.Init.HardwareFlowControl = SDIO_HARDWARE_FLOW_CONTROL_DISABLE;
|
|
hsd.Init.ClockDiv = 3;
|
|
|
|
/* Check if the SD card is plugged in the slot */
|
|
if (BSP_SD_IsDetected() != SD_PRESENT)
|
|
{
|
|
return MSD_ERROR;
|
|
}
|
|
/* HAL SD initialization */
|
|
sd_state = HAL_SD_Init(&hsd);
|
|
/* Configure SD Bus width (4 bits mode selected) */
|
|
if (sd_state == MSD_OK)
|
|
{
|
|
/* Enable wide operation */
|
|
if (HAL_SD_ConfigWideBusOperation(&hsd, SDIO_BUS_WIDE_4B) != HAL_OK)
|
|
{
|
|
sd_state = MSD_ERROR;
|
|
}
|
|
}
|
|
|
|
return sd_state;
|
|
}
|
|
/* USER CODE BEGIN AfterInitSection */
|
|
/* can be used to modify previous code / undefine following code / add code */
|
|
/* USER CODE END AfterInitSection */
|
|
|
|
/**
|
|
* @brief Configures Interrupt mode for SD detection pin.
|
|
* @retval Returns 0 in success otherwise 1.
|
|
*/
|
|
uint8_t BSP_SD_ITConfig(void)
|
|
{
|
|
/* TBI: add user code here depending on the hardware configuration used */
|
|
|
|
return (uint8_t)0;
|
|
}
|
|
|
|
/** @brief SD detect IT treatment
|
|
*/
|
|
void BSP_SD_DetectIT(void)
|
|
{
|
|
/* TBI: add user code here depending on the hardware configuration used */
|
|
}
|
|
|
|
/** @brief SD detect IT detection callback
|
|
*/
|
|
__weak void BSP_SD_DetectCallback(void)
|
|
{
|
|
/* NOTE: This function Should not be modified, when the callback is needed,
|
|
the BSP_SD_DetectCallback could be implemented in the user file
|
|
*/
|
|
}
|
|
|
|
/* USER CODE BEGIN BeforeReadBlocksSection */
|
|
/* can be used to modify previous code / undefine following code / add code */
|
|
/* USER CODE END BeforeReadBlocksSection */
|
|
/**
|
|
* @brief Reads block(s) from a specified address in an SD card, in polling mode.
|
|
* @param pData: Pointer to the buffer that will contain the data to transmit
|
|
* @param ReadAddr: Address from where data is to be read
|
|
* @param NumOfBlocks: Number of SD blocks to read
|
|
* @param Timeout: Timeout for read operation
|
|
* @retval SD status
|
|
*/
|
|
uint8_t BSP_SD_ReadBlocks(uint32_t *pData, uint32_t ReadAddr, uint32_t NumOfBlocks, uint32_t Timeout)
|
|
{
|
|
uint8_t sd_state = MSD_OK;
|
|
|
|
if (HAL_SD_ReadBlocks(&hsd, (uint8_t *)pData, ReadAddr, NumOfBlocks, Timeout) != HAL_OK)
|
|
{
|
|
sd_state = MSD_ERROR;
|
|
}
|
|
|
|
return sd_state;
|
|
}
|
|
|
|
/* USER CODE BEGIN BeforeWriteBlocksSection */
|
|
/* can be used to modify previous code / undefine following code / add code */
|
|
/* USER CODE END BeforeWriteBlocksSection */
|
|
/**
|
|
* @brief Writes block(s) to a specified address in an SD card, in polling mode.
|
|
* @param pData: Pointer to the buffer that will contain the data to transmit
|
|
* @param WriteAddr: Address from where data is to be written
|
|
* @param NumOfBlocks: Number of SD blocks to write
|
|
* @param Timeout: Timeout for write operation
|
|
* @retval SD status
|
|
*/
|
|
uint8_t BSP_SD_WriteBlocks(uint32_t *pData, uint32_t WriteAddr, uint32_t NumOfBlocks, uint32_t Timeout)
|
|
{
|
|
uint8_t sd_state = MSD_OK;
|
|
|
|
if (HAL_SD_WriteBlocks(&hsd, (uint8_t *)pData, WriteAddr, NumOfBlocks, Timeout) != HAL_OK)
|
|
{
|
|
sd_state = MSD_ERROR;
|
|
}
|
|
|
|
return sd_state;
|
|
}
|
|
|
|
/* USER CODE BEGIN BeforeReadDMABlocksSection */
|
|
/* can be used to modify previous code / undefine following code / add code */
|
|
/* USER CODE END BeforeReadDMABlocksSection */
|
|
/**
|
|
* @brief Reads block(s) from a specified address in an SD card, in DMA mode.
|
|
* @param pData: Pointer to the buffer that will contain the data to transmit
|
|
* @param ReadAddr: Address from where data is to be read
|
|
* @param NumOfBlocks: Number of SD blocks to read
|
|
* @retval SD status
|
|
*/
|
|
uint8_t BSP_SD_ReadBlocks_DMA(uint32_t *pData, uint32_t ReadAddr, uint32_t NumOfBlocks)
|
|
{
|
|
uint8_t sd_state = MSD_OK;
|
|
|
|
/* Read block(s) in DMA transfer mode */
|
|
if (HAL_SD_ReadBlocks_DMA(&hsd, (uint8_t *)pData, ReadAddr, NumOfBlocks) != HAL_OK)
|
|
{
|
|
sd_state = MSD_ERROR;
|
|
}
|
|
|
|
return sd_state;
|
|
}
|
|
|
|
/* USER CODE BEGIN BeforeWriteDMABlocksSection */
|
|
/* can be used to modify previous code / undefine following code / add code */
|
|
/* USER CODE END BeforeWriteDMABlocksSection */
|
|
/**
|
|
* @brief Writes block(s) to a specified address in an SD card, in DMA mode.
|
|
* @param pData: Pointer to the buffer that will contain the data to transmit
|
|
* @param WriteAddr: Address from where data is to be written
|
|
* @param NumOfBlocks: Number of SD blocks to write
|
|
* @retval SD status
|
|
*/
|
|
uint8_t BSP_SD_WriteBlocks_DMA(uint32_t *pData, uint32_t WriteAddr, uint32_t NumOfBlocks)
|
|
{
|
|
uint8_t sd_state = MSD_OK;
|
|
|
|
/* Write block(s) in DMA transfer mode */
|
|
if (HAL_SD_WriteBlocks_DMA(&hsd, (uint8_t *)pData, WriteAddr, NumOfBlocks) != HAL_OK)
|
|
{
|
|
sd_state = MSD_ERROR;
|
|
}
|
|
|
|
return sd_state;
|
|
}
|
|
|
|
/* USER CODE BEGIN BeforeEraseSection */
|
|
/* can be used to modify previous code / undefine following code / add code */
|
|
/* USER CODE END BeforeEraseSection */
|
|
/**
|
|
* @brief Erases the specified memory area of the given SD card.
|
|
* @param StartAddr: Start byte address
|
|
* @param EndAddr: End byte address
|
|
* @retval SD status
|
|
*/
|
|
uint8_t BSP_SD_Erase(uint32_t StartAddr, uint32_t EndAddr)
|
|
{
|
|
uint8_t sd_state = MSD_OK;
|
|
|
|
if (HAL_SD_Erase(&hsd, StartAddr, EndAddr) != HAL_OK)
|
|
{
|
|
sd_state = MSD_ERROR;
|
|
}
|
|
|
|
return sd_state;
|
|
}
|
|
|
|
/* USER CODE BEGIN BeforeHandlersSection */
|
|
/* can be used to modify previous code / undefine following code / add code */
|
|
/* USER CODE END BeforeHandlersSection */
|
|
/**
|
|
* @brief Handles SD card interrupt request.
|
|
*/
|
|
void BSP_SD_IRQHandler(void)
|
|
{
|
|
HAL_SD_IRQHandler(&hsd);
|
|
}
|
|
|
|
/**
|
|
* @brief Handles SD DMA Tx transfer interrupt request.
|
|
*/
|
|
void BSP_SD_DMA_Tx_IRQHandler(void)
|
|
{
|
|
HAL_DMA_IRQHandler(hsd.hdmatx);
|
|
}
|
|
|
|
/**
|
|
* @brief Handles SD DMA Rx transfer interrupt request.
|
|
*/
|
|
void BSP_SD_DMA_Rx_IRQHandler(void)
|
|
{
|
|
HAL_DMA_IRQHandler(hsd.hdmarx);
|
|
}
|
|
|
|
/**
|
|
* @brief Gets the current SD card data status.
|
|
* @param None
|
|
* @retval Data transfer state.
|
|
* This value can be one of the following values:
|
|
* @arg SD_TRANSFER_OK: No data transfer is acting
|
|
* @arg SD_TRANSFER_BUSY: Data transfer is acting
|
|
*/
|
|
uint8_t BSP_SD_GetCardState(void)
|
|
{
|
|
return ((HAL_SD_GetCardState(&hsd) == HAL_SD_CARD_TRANSFER ) ? SD_TRANSFER_OK : SD_TRANSFER_BUSY);
|
|
}
|
|
|
|
/**
|
|
* @brief Get SD information about specific SD card.
|
|
* @param CardInfo: Pointer to HAL_SD_CardInfoTypedef structure
|
|
* @retval None
|
|
*/
|
|
void BSP_SD_GetCardInfo(HAL_SD_CardInfoTypeDef *CardInfo)
|
|
{
|
|
/* Get SD card Information */
|
|
HAL_SD_GetCardInfo(&hsd, CardInfo);
|
|
}
|
|
|
|
/* USER CODE BEGIN BeforeCallBacksSection */
|
|
/* can be used to modify previous code / undefine following code / add code */
|
|
/* USER CODE END BeforeCallBacksSection */
|
|
/**
|
|
* @brief SD Abort callbacks
|
|
* @param hsd: SD handle
|
|
* @retval None
|
|
*/
|
|
void HAL_SD_AbortCallback(SD_HandleTypeDef *hsd)
|
|
{
|
|
BSP_SD_AbortCallback();
|
|
}
|
|
|
|
/**
|
|
* @brief Tx Transfer completed callback
|
|
* @param hsd: SD handle
|
|
* @retval None
|
|
*/
|
|
void HAL_SD_TxCpltCallback(SD_HandleTypeDef *hsd)
|
|
{
|
|
BSP_SD_WriteCpltCallback();
|
|
}
|
|
|
|
/**
|
|
* @brief Rx Transfer completed callback
|
|
* @param hsd: SD handle
|
|
* @retval None
|
|
*/
|
|
void HAL_SD_RxCpltCallback(SD_HandleTypeDef *hsd)
|
|
{
|
|
BSP_SD_ReadCpltCallback();
|
|
}
|
|
|
|
/* USER CODE BEGIN CallBacksSection_C */
|
|
/**
|
|
* @brief BSP SD Abort callback
|
|
* @retval None
|
|
*/
|
|
__weak void BSP_SD_AbortCallback(void)
|
|
{
|
|
|
|
}
|
|
|
|
/**
|
|
* @brief BSP Tx Transfer completed callback
|
|
* @retval None
|
|
*/
|
|
__weak void BSP_SD_WriteCpltCallback(void)
|
|
{
|
|
|
|
}
|
|
|
|
/**
|
|
* @brief BSP Rx Transfer completed callback
|
|
* @retval None
|
|
*/
|
|
__weak void BSP_SD_ReadCpltCallback(void)
|
|
{
|
|
|
|
}
|
|
/* USER CODE END CallBacksSection_C */
|
|
|
|
/**
|
|
* @brief Detects if SD card is correctly plugged in the memory slot or not.
|
|
* @param None
|
|
* @retval Returns if SD is detected or not
|
|
*/
|
|
uint8_t BSP_SD_IsDetected(void)
|
|
{
|
|
__IO uint8_t status = SD_PRESENT;
|
|
|
|
/* USER CODE BEGIN 1 */
|
|
/* user code can be inserted here */
|
|
/* USER CODE END 1 */
|
|
|
|
return status;
|
|
}
|
|
|
|
/* USER CODE BEGIN AdditionalCode */
|
|
/* user code can be inserted here */
|
|
/* USER CODE END AdditionalCode */
|
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|