| /** |
| ****************************************************************************** |
| * @file stm32f2xx_hal_pccard.c |
| * @author MCD Application Team |
| * @brief PCCARD HAL module driver. |
| * This file provides a generic firmware to drive PCCARD memories mounted |
| * as external device. |
| * |
| ****************************************************************************** |
| * @attention |
| * |
| * Copyright (c) 2016 STMicroelectronics. |
| * All rights reserved. |
| * |
| * This software is licensed under terms that can be found in the LICENSE file |
| * in the root directory of this software component. |
| * If no LICENSE file comes with this software, it is provided AS-IS. |
| * |
| ****************************************************************************** |
| @verbatim |
| =============================================================================== |
| ##### How to use this driver ##### |
| =============================================================================== |
| [..] |
| This driver is a generic layered driver which contains a set of APIs used to |
| control PCCARD/compact flash memories. It uses the FSMC layer functions |
| to interface with PCCARD devices. This driver is used for: |
| |
| (+) PCCARD/Compact Flash memory configuration sequence using the function |
| HAL_PCCARD_Init()/HAL_CF_Init() with control and timing parameters for |
| both common and attribute spaces. |
| |
| (+) Read PCCARD/Compact Flash memory maker and device IDs using the function |
| HAL_PCCARD_Read_ID()/HAL_CF_Read_ID(). The read information is stored in |
| the CompactFlash_ID structure declared by the function caller. |
| |
| (+) Access PCCARD/Compact Flash memory by read/write operations using the functions |
| HAL_PCCARD_Read_Sector()/ HAL_PCCARD_Write_Sector() - |
| HAL_CF_Read_Sector()/HAL_CF_Write_Sector(), to read/write sector. |
| |
| (+) Perform PCCARD/Compact Flash Reset chip operation using the function |
| HAL_PCCARD_Reset()/HAL_CF_Reset. |
| |
| (+) Perform PCCARD/Compact Flash erase sector operation using the function |
| HAL_PCCARD_Erase_Sector()/HAL_CF_Erase_Sector. |
| |
| (+) Read the PCCARD/Compact Flash status operation using the function |
| HAL_PCCARD_ReadStatus()/HAL_CF_ReadStatus(). |
| |
| (+) You can monitor the PCCARD/Compact Flash device HAL state by calling |
| the function HAL_PCCARD_GetState()/HAL_CF_GetState() |
| |
| [..] |
| (@) This driver is a set of generic APIs which handle standard PCCARD/compact flash |
| operations. If a PCCARD/Compact Flash device contains different operations |
| and/or implementations, it should be implemented separately. |
| |
| *** Callback registration *** |
| ============================================= |
| [..] |
| The compilation define USE_HAL_PCCARD_REGISTER_CALLBACKS when set to 1 |
| allows the user to configure dynamically the driver callbacks. |
| |
| Use Functions HAL_PCCARD_RegisterCallback() to register a user callback, |
| it allows to register following callbacks: |
| (+) MspInitCallback : PCCARD MspInit. |
| (+) MspDeInitCallback : PCCARD MspDeInit. |
| This function takes as parameters the HAL peripheral handle, the Callback ID |
| and a pointer to the user callback function. |
| |
| Use function HAL_PCCARD_UnRegisterCallback() to reset a callback to the default |
| weak (surcharged) function. It allows to reset following callbacks: |
| (+) MspInitCallback : PCCARD MspInit. |
| (+) MspDeInitCallback : PCCARD MspDeInit. |
| This function) takes as parameters the HAL peripheral handle and the Callback ID. |
| |
| By default, after the HAL_PCCARD_Init and if the state is HAL_PCCARD_STATE_RESET |
| all callbacks are reset to the corresponding legacy weak (surcharged) functions. |
| Exception done for MspInit and MspDeInit callbacks that are respectively |
| reset to the legacy weak (surcharged) functions in the HAL_PCCARD_Init |
| and HAL_PCCARD_DeInit only when these callbacks are null (not registered beforehand). |
| If not, MspInit or MspDeInit are not null, the HAL_PCCARD_Init and HAL_PCCARD_DeInit |
| keep and use the user MspInit/MspDeInit callbacks (registered beforehand) |
| |
| Callbacks can be registered/unregistered in READY state only. |
| Exception done for MspInit/MspDeInit callbacks that can be registered/unregistered |
| in READY or RESET state, thus registered (user) MspInit/DeInit callbacks can be used |
| during the Init/DeInit. |
| In that case first register the MspInit/MspDeInit user callbacks |
| using HAL_PCCARD_RegisterCallback before calling HAL_PCCARD_DeInit |
| or HAL_PCCARD_Init function. |
| |
| When The compilation define USE_HAL_PCCARD_REGISTER_CALLBACKS is set to 0 or |
| not defined, the callback registering feature is not available |
| and weak (surcharged) callbacks are used. |
| |
| @endverbatim |
| ****************************************************************************** |
| */ |
| |
| /* Includes ------------------------------------------------------------------*/ |
| #include "stm32f2xx_hal.h" |
| |
| |
| /** @addtogroup STM32F2xx_HAL_Driver |
| * @{ |
| */ |
| |
| #ifdef HAL_PCCARD_MODULE_ENABLED |
| |
| /** @defgroup PCCARD PCCARD |
| * @brief PCCARD HAL module driver |
| * @{ |
| */ |
| /* Private typedef -----------------------------------------------------------*/ |
| /* Private define ------------------------------------------------------------*/ |
| |
| /** @defgroup PCCARD_Private_Defines PCCARD Private Defines |
| * @{ |
| */ |
| #define PCCARD_TIMEOUT_READ_ID 0x0000FFFFU |
| #define PCCARD_TIMEOUT_READ_WRITE_SECTOR 0x0000FFFFU |
| #define PCCARD_TIMEOUT_ERASE_SECTOR 0x00000400U |
| #define PCCARD_TIMEOUT_STATUS 0x01000000U |
| |
| #define PCCARD_STATUS_OK (uint8_t)0x58 |
| #define PCCARD_STATUS_WRITE_OK (uint8_t)0x50 |
| /** |
| * @} |
| */ |
| |
| /* Private macro -------------------------------------------------------------*/ |
| /* Private variables ---------------------------------------------------------*/ |
| /* Private function ----------------------------------------------------------*/ |
| /* Exported functions --------------------------------------------------------*/ |
| /** @defgroup PCCARD_Exported_Functions PCCARD Exported Functions |
| * @{ |
| */ |
| |
| /** @defgroup PCCARD_Exported_Functions_Group1 Initialization and de-initialization functions |
| * @brief Initialization and Configuration functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### PCCARD Initialization and de-initialization functions ##### |
| ============================================================================== |
| [..] |
| This section provides functions allowing to initialize/de-initialize |
| the PCCARD memory |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Perform the PCCARD memory Initialization sequence |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @param ComSpaceTiming Common space timing structure |
| * @param AttSpaceTiming Attribute space timing structure |
| * @param IOSpaceTiming IO space timing structure |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCCARD_Init(PCCARD_HandleTypeDef *hpccard, FSMC_NAND_PCC_TimingTypeDef *ComSpaceTiming, |
| FSMC_NAND_PCC_TimingTypeDef *AttSpaceTiming, |
| FSMC_NAND_PCC_TimingTypeDef *IOSpaceTiming) |
| { |
| /* Check the PCCARD controller state */ |
| if (hpccard == NULL) |
| { |
| return HAL_ERROR; |
| } |
| |
| if (hpccard->State == HAL_PCCARD_STATE_RESET) |
| { |
| /* Allocate lock resource and initialize it */ |
| hpccard->Lock = HAL_UNLOCKED; |
| #if (USE_HAL_PCCARD_REGISTER_CALLBACKS == 1) |
| if (hpccard->MspInitCallback == NULL) |
| { |
| hpccard->MspInitCallback = HAL_PCCARD_MspInit; |
| } |
| hpccard->ItCallback = HAL_PCCARD_ITCallback; |
| |
| /* Init the low level hardware */ |
| hpccard->MspInitCallback(hpccard); |
| #else |
| /* Initialize the low level hardware (MSP) */ |
| HAL_PCCARD_MspInit(hpccard); |
| #endif /* USE_HAL_PCCARD_REGISTER_CALLBACKS */ |
| } |
| |
| /* Initialize the PCCARD state */ |
| hpccard->State = HAL_PCCARD_STATE_BUSY; |
| |
| /* Initialize PCCARD control Interface */ |
| FSMC_PCCARD_Init(hpccard->Instance, &(hpccard->Init)); |
| |
| /* Init PCCARD common space timing Interface */ |
| FSMC_PCCARD_CommonSpace_Timing_Init(hpccard->Instance, ComSpaceTiming); |
| |
| /* Init PCCARD attribute space timing Interface */ |
| FSMC_PCCARD_AttributeSpace_Timing_Init(hpccard->Instance, AttSpaceTiming); |
| |
| /* Init PCCARD IO space timing Interface */ |
| FSMC_PCCARD_IOSpace_Timing_Init(hpccard->Instance, IOSpaceTiming); |
| |
| /* Enable the PCCARD device */ |
| __FSMC_PCCARD_ENABLE(hpccard->Instance); |
| |
| /* Update the PCCARD state */ |
| hpccard->State = HAL_PCCARD_STATE_READY; |
| |
| return HAL_OK; |
| |
| } |
| |
| /** |
| * @brief Perform the PCCARD memory De-initialization sequence |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCCARD_DeInit(PCCARD_HandleTypeDef *hpccard) |
| { |
| #if (USE_HAL_PCCARD_REGISTER_CALLBACKS == 1) |
| if (hpccard->MspDeInitCallback == NULL) |
| { |
| hpccard->MspDeInitCallback = HAL_PCCARD_MspDeInit; |
| } |
| |
| /* DeInit the low level hardware */ |
| hpccard->MspDeInitCallback(hpccard); |
| #else |
| /* De-Initialize the low level hardware (MSP) */ |
| HAL_PCCARD_MspDeInit(hpccard); |
| #endif /* USE_HAL_PCCARD_REGISTER_CALLBACKS */ |
| |
| /* Configure the PCCARD registers with their reset values */ |
| FSMC_PCCARD_DeInit(hpccard->Instance); |
| |
| /* Update the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_RESET; |
| |
| /* Release Lock */ |
| __HAL_UNLOCK(hpccard); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief PCCARD MSP Init |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @retval None |
| */ |
| __weak void HAL_PCCARD_MspInit(PCCARD_HandleTypeDef *hpccard) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hpccard); |
| /* NOTE : This function Should not be modified, when the callback is needed, |
| the HAL_PCCARD_MspInit could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @brief PCCARD MSP DeInit |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @retval None |
| */ |
| __weak void HAL_PCCARD_MspDeInit(PCCARD_HandleTypeDef *hpccard) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hpccard); |
| /* NOTE : This function Should not be modified, when the callback is needed, |
| the HAL_PCCARD_MspDeInit could be implemented in the user file |
| */ |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup PCCARD_Exported_Functions_Group2 Input and Output functions |
| * @brief Input Output and memory control functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### PCCARD Input and Output functions ##### |
| ============================================================================== |
| [..] |
| This section provides functions allowing to use and control the PCCARD memory |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Read Compact Flash's ID. |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @param CompactFlash_ID Compact flash ID structure. |
| * @param pStatus pointer to compact flash status |
| * @retval HAL status |
| * |
| */ |
| HAL_StatusTypeDef HAL_PCCARD_Read_ID(PCCARD_HandleTypeDef *hpccard, uint8_t CompactFlash_ID[], uint8_t *pStatus) |
| { |
| uint32_t timeout = 0U; |
| uint32_t index = 0U; |
| uint8_t status = 0U; |
| |
| /* Process Locked */ |
| __HAL_LOCK(hpccard); |
| |
| /* Check the PCCARD controller state */ |
| if (hpccard->State == HAL_PCCARD_STATE_BUSY) |
| { |
| return HAL_BUSY; |
| } |
| |
| /* Initialize timeout value */ |
| timeout = PCCARD_TIMEOUT_READ_ID; |
| |
| /* Update the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_BUSY; |
| |
| /* Initialize the PCCARD status */ |
| *pStatus = PCCARD_READY; |
| |
| /* Send the Identify Command */ |
| *(__IO uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD) = (uint16_t)0xECEC; |
| |
| /* Read PCCARD IDs and timeout treatment */ |
| do |
| { |
| /* Read the PCCARD status */ |
| status = *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| |
| timeout--; |
| } while ((status != PCCARD_STATUS_OK) && timeout); |
| |
| if (timeout == 0U) |
| { |
| *pStatus = PCCARD_TIMEOUT_ERROR; |
| } |
| else |
| { |
| /* Read PCCARD ID bytes */ |
| for (index = 0U; index < 16U; index++) |
| { |
| CompactFlash_ID[index] = *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_DATA); |
| } |
| } |
| |
| /* Update the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hpccard); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Read sector from PCCARD memory |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @param pBuffer pointer to destination read buffer |
| * @param SectorAddress Sector address to read |
| * @param pStatus pointer to PCCARD status |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCCARD_Read_Sector(PCCARD_HandleTypeDef *hpccard, uint16_t *pBuffer, uint16_t SectorAddress, |
| uint8_t *pStatus) |
| { |
| uint32_t timeout = 0U; |
| uint32_t index = 0U; |
| uint8_t status = 0U; |
| |
| /* Process Locked */ |
| __HAL_LOCK(hpccard); |
| |
| /* Check the PCCARD controller state */ |
| if (hpccard->State == HAL_PCCARD_STATE_BUSY) |
| { |
| return HAL_BUSY; |
| } |
| |
| /* Initialize timeout value */ |
| timeout = PCCARD_TIMEOUT_READ_WRITE_SECTOR; |
| |
| /* Update the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_BUSY; |
| |
| /* Initialize PCCARD status */ |
| *pStatus = PCCARD_READY; |
| |
| /* Set the parameters to write a sector */ |
| *(__IO uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_CYLINDER_HIGH) = (uint16_t)0x0000; |
| *(__IO uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_SECTOR_COUNT) = ((uint16_t)0x0100) | ((uint16_t)SectorAddress); |
| *(__IO uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD) = (uint16_t)0xE4A0; |
| |
| do |
| { |
| /* wait till the Status = 0x80 */ |
| status = *(__IO uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| timeout--; |
| } while ((status == 0x80U) && timeout); |
| |
| if (timeout == 0U) |
| { |
| *pStatus = PCCARD_TIMEOUT_ERROR; |
| } |
| |
| timeout = PCCARD_TIMEOUT_READ_WRITE_SECTOR; |
| |
| do |
| { |
| /* wait till the Status = PCCARD_STATUS_OK */ |
| status = *(__IO uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| timeout--; |
| } while ((status != PCCARD_STATUS_OK) && timeout); |
| |
| if (timeout == 0U) |
| { |
| *pStatus = PCCARD_TIMEOUT_ERROR; |
| } |
| |
| /* Read bytes */ |
| for (; index < PCCARD_SECTOR_SIZE; index++) |
| { |
| *(uint16_t *)pBuffer++ = *(uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR); |
| } |
| |
| /* Update the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hpccard); |
| |
| return HAL_OK; |
| } |
| |
| |
| /** |
| * @brief Write sector to PCCARD memory |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @param pBuffer pointer to source write buffer |
| * @param SectorAddress Sector address to write |
| * @param pStatus pointer to PCCARD status |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCCARD_Write_Sector(PCCARD_HandleTypeDef *hpccard, uint16_t *pBuffer, uint16_t SectorAddress, |
| uint8_t *pStatus) |
| { |
| uint32_t timeout = 0U; |
| uint32_t index = 0U; |
| uint8_t status = 0U; |
| |
| /* Process Locked */ |
| __HAL_LOCK(hpccard); |
| |
| /* Check the PCCARD controller state */ |
| if (hpccard->State == HAL_PCCARD_STATE_BUSY) |
| { |
| return HAL_BUSY; |
| } |
| |
| /* Initialize timeout value */ |
| timeout = PCCARD_TIMEOUT_READ_WRITE_SECTOR; |
| |
| /* Update the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_BUSY; |
| |
| /* Initialize PCCARD status */ |
| *pStatus = PCCARD_READY; |
| |
| /* Set the parameters to write a sector */ |
| *(__IO uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_CYLINDER_HIGH) = (uint16_t)0x0000; |
| *(__IO uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_SECTOR_COUNT) = ((uint16_t)0x0100) | ((uint16_t)SectorAddress); |
| *(__IO uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD) = (uint16_t)0x30A0; |
| |
| do |
| { |
| /* Wait till the Status = PCCARD_STATUS_OK */ |
| status = *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| timeout--; |
| } while ((status != PCCARD_STATUS_OK) && timeout); |
| |
| if (timeout == 0U) |
| { |
| *pStatus = PCCARD_TIMEOUT_ERROR; |
| } |
| |
| /* Write bytes */ |
| for (; index < PCCARD_SECTOR_SIZE; index++) |
| { |
| *(uint16_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR) = *(uint16_t *)pBuffer++; |
| } |
| |
| do |
| { |
| /* Wait till the Status = PCCARD_STATUS_WRITE_OK */ |
| status = *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| timeout--; |
| } while ((status != PCCARD_STATUS_WRITE_OK) && timeout); |
| |
| if (timeout == 0U) |
| { |
| *pStatus = PCCARD_TIMEOUT_ERROR; |
| } |
| |
| /* Update the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hpccard); |
| |
| return HAL_OK; |
| } |
| |
| |
| /** |
| * @brief Erase sector from PCCARD memory |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @param SectorAddress Sector address to erase |
| * @param pStatus pointer to PCCARD status |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCCARD_Erase_Sector(PCCARD_HandleTypeDef *hpccard, uint16_t SectorAddress, uint8_t *pStatus) |
| { |
| uint32_t timeout = PCCARD_TIMEOUT_ERASE_SECTOR; |
| uint8_t status = 0U; |
| |
| /* Process Locked */ |
| __HAL_LOCK(hpccard); |
| |
| /* Check the PCCARD controller state */ |
| if (hpccard->State == HAL_PCCARD_STATE_BUSY) |
| { |
| return HAL_BUSY; |
| } |
| |
| /* Update the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_BUSY; |
| |
| /* Initialize PCCARD status */ |
| *pStatus = PCCARD_READY; |
| |
| /* Set the parameters to write a sector */ |
| *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_CYLINDER_LOW) = 0x00; |
| *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_CYLINDER_HIGH) = 0x00; |
| *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_SECTOR_NUMBER) = SectorAddress; |
| *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_SECTOR_COUNT) = 0x01; |
| *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_CARD_HEAD) = 0xA0; |
| *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD) = ATA_ERASE_SECTOR_CMD; |
| |
| /* wait till the PCCARD is ready */ |
| status = *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| |
| while ((status != PCCARD_STATUS_WRITE_OK) && timeout) |
| { |
| status = *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| timeout--; |
| } |
| |
| if (timeout == 0U) |
| { |
| *pStatus = PCCARD_TIMEOUT_ERROR; |
| } |
| |
| /* Check the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hpccard); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Reset the PCCARD memory |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef HAL_PCCARD_Reset(PCCARD_HandleTypeDef *hpccard) |
| { |
| /* Process Locked */ |
| __HAL_LOCK(hpccard); |
| |
| /* Check the PCCARD controller state */ |
| if (hpccard->State == HAL_PCCARD_STATE_BUSY) |
| { |
| return HAL_BUSY; |
| } |
| |
| /* Provide a SW reset and Read and verify the: |
| - PCCard Configuration Option Register at address 0x98000200 --> 0x80 |
| - Card Configuration and Status Register at address 0x98000202 --> 0x00 |
| - Pin Replacement Register at address 0x98000204 --> 0x0C |
| - Socket and Copy Register at address 0x98000206 --> 0x00 |
| */ |
| |
| /* Check the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_BUSY; |
| |
| *(__IO uint8_t *)(PCCARD_ATTRIBUTE_SPACE_ADDRESS | ATA_CARD_CONFIGURATION) = 0x01; |
| |
| /* Check the PCCARD controller state */ |
| hpccard->State = HAL_PCCARD_STATE_READY; |
| |
| /* Process unlocked */ |
| __HAL_UNLOCK(hpccard); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief This function handles PCCARD device interrupt request. |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @retval HAL status |
| */ |
| void HAL_PCCARD_IRQHandler(PCCARD_HandleTypeDef *hpccard) |
| { |
| /* Check PCCARD interrupt Rising edge flag */ |
| if (__FSMC_PCCARD_GET_FLAG(hpccard->Instance, FSMC_FLAG_RISING_EDGE)) |
| { |
| /* PCCARD interrupt callback*/ |
| #if (USE_HAL_PCCARD_REGISTER_CALLBACKS == 1) |
| hpccard->ItCallback(hpccard); |
| #else |
| HAL_PCCARD_ITCallback(hpccard); |
| #endif /* USE_HAL_PCCARD_REGISTER_CALLBACKS */ |
| |
| /* Clear PCCARD interrupt Rising edge pending bit */ |
| __FSMC_PCCARD_CLEAR_FLAG(hpccard->Instance, FSMC_FLAG_RISING_EDGE); |
| } |
| |
| /* Check PCCARD interrupt Level flag */ |
| if (__FSMC_PCCARD_GET_FLAG(hpccard->Instance, FSMC_FLAG_LEVEL)) |
| { |
| /* PCCARD interrupt callback*/ |
| #if (USE_HAL_PCCARD_REGISTER_CALLBACKS == 1) |
| hpccard->ItCallback(hpccard); |
| #else |
| HAL_PCCARD_ITCallback(hpccard); |
| #endif /* USE_HAL_PCCARD_REGISTER_CALLBACKS */ |
| |
| /* Clear PCCARD interrupt Level pending bit */ |
| __FSMC_PCCARD_CLEAR_FLAG(hpccard->Instance, FSMC_FLAG_LEVEL); |
| } |
| |
| /* Check PCCARD interrupt Falling edge flag */ |
| if (__FSMC_PCCARD_GET_FLAG(hpccard->Instance, FSMC_FLAG_FALLING_EDGE)) |
| { |
| /* PCCARD interrupt callback*/ |
| #if (USE_HAL_PCCARD_REGISTER_CALLBACKS == 1) |
| hpccard->ItCallback(hpccard); |
| #else |
| HAL_PCCARD_ITCallback(hpccard); |
| #endif /* USE_HAL_PCCARD_REGISTER_CALLBACKS */ |
| |
| /* Clear PCCARD interrupt Falling edge pending bit */ |
| __FSMC_PCCARD_CLEAR_FLAG(hpccard->Instance, FSMC_FLAG_FALLING_EDGE); |
| } |
| |
| /* Check PCCARD interrupt FIFO empty flag */ |
| if (__FSMC_PCCARD_GET_FLAG(hpccard->Instance, FSMC_FLAG_FEMPT)) |
| { |
| /* PCCARD interrupt callback*/ |
| #if (USE_HAL_PCCARD_REGISTER_CALLBACKS == 1) |
| hpccard->ItCallback(hpccard); |
| #else |
| HAL_PCCARD_ITCallback(hpccard); |
| #endif /* USE_HAL_PCCARD_REGISTER_CALLBACKS */ |
| |
| /* Clear PCCARD interrupt FIFO empty pending bit */ |
| __FSMC_PCCARD_CLEAR_FLAG(hpccard->Instance, FSMC_FLAG_FEMPT); |
| } |
| } |
| |
| /** |
| * @brief PCCARD interrupt feature callback |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @retval None |
| */ |
| __weak void HAL_PCCARD_ITCallback(PCCARD_HandleTypeDef *hpccard) |
| { |
| /* Prevent unused argument(s) compilation warning */ |
| UNUSED(hpccard); |
| /* NOTE : This function Should not be modified, when the callback is needed, |
| the HAL_PCCARD_ITCallback could be implemented in the user file |
| */ |
| } |
| |
| #if (USE_HAL_PCCARD_REGISTER_CALLBACKS == 1) |
| /** |
| * @brief Register a User PCCARD Callback |
| * To be used instead of the weak (surcharged) predefined callback |
| * @param hpccard : PCCARD handle |
| * @param CallbackId : ID of the callback to be registered |
| * This parameter can be one of the following values: |
| * @arg @ref HAL_PCCARD_MSP_INIT_CB_ID PCCARD MspInit callback ID |
| * @arg @ref HAL_PCCARD_MSP_DEINIT_CB_ID PCCARD MspDeInit callback ID |
| * @arg @ref HAL_PCCARD_IT_CB_ID PCCARD IT callback ID |
| * @param pCallback : pointer to the Callback function |
| * @retval status |
| */ |
| HAL_StatusTypeDef HAL_PCCARD_RegisterCallback(PCCARD_HandleTypeDef *hpccard, HAL_PCCARD_CallbackIDTypeDef CallbackId, |
| pPCCARD_CallbackTypeDef pCallback) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| if (pCallback == NULL) |
| { |
| return HAL_ERROR; |
| } |
| |
| /* Process locked */ |
| __HAL_LOCK(hpccard); |
| |
| if (hpccard->State == HAL_PCCARD_STATE_READY) |
| { |
| switch (CallbackId) |
| { |
| case HAL_PCCARD_MSP_INIT_CB_ID : |
| hpccard->MspInitCallback = pCallback; |
| break; |
| case HAL_PCCARD_MSP_DEINIT_CB_ID : |
| hpccard->MspDeInitCallback = pCallback; |
| break; |
| case HAL_PCCARD_IT_CB_ID : |
| hpccard->ItCallback = pCallback; |
| break; |
| default : |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else if (hpccard->State == HAL_PCCARD_STATE_RESET) |
| { |
| switch (CallbackId) |
| { |
| case HAL_PCCARD_MSP_INIT_CB_ID : |
| hpccard->MspInitCallback = pCallback; |
| break; |
| case HAL_PCCARD_MSP_DEINIT_CB_ID : |
| hpccard->MspDeInitCallback = pCallback; |
| break; |
| default : |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else |
| { |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| |
| /* Release Lock */ |
| __HAL_UNLOCK(hpccard); |
| return status; |
| } |
| |
| /** |
| * @brief Unregister a User PCCARD Callback |
| * PCCARD Callback is redirected to the weak (surcharged) predefined callback |
| * @param hpccard : PCCARD handle |
| * @param CallbackId : ID of the callback to be unregistered |
| * This parameter can be one of the following values: |
| * @arg @ref HAL_PCCARD_MSP_INIT_CB_ID PCCARD MspInit callback ID |
| * @arg @ref HAL_PCCARD_MSP_DEINIT_CB_ID PCCARD MspDeInit callback ID |
| * @arg @ref HAL_PCCARD_IT_CB_ID PCCARD IT callback ID |
| * @retval status |
| */ |
| HAL_StatusTypeDef HAL_PCCARD_UnRegisterCallback(PCCARD_HandleTypeDef *hpccard, HAL_PCCARD_CallbackIDTypeDef CallbackId) |
| { |
| HAL_StatusTypeDef status = HAL_OK; |
| |
| /* Process locked */ |
| __HAL_LOCK(hpccard); |
| |
| if (hpccard->State == HAL_PCCARD_STATE_READY) |
| { |
| switch (CallbackId) |
| { |
| case HAL_PCCARD_MSP_INIT_CB_ID : |
| hpccard->MspInitCallback = HAL_PCCARD_MspInit; |
| break; |
| case HAL_PCCARD_MSP_DEINIT_CB_ID : |
| hpccard->MspDeInitCallback = HAL_PCCARD_MspDeInit; |
| break; |
| case HAL_PCCARD_IT_CB_ID : |
| hpccard->ItCallback = HAL_PCCARD_ITCallback; |
| break; |
| default : |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else if (hpccard->State == HAL_PCCARD_STATE_RESET) |
| { |
| switch (CallbackId) |
| { |
| case HAL_PCCARD_MSP_INIT_CB_ID : |
| hpccard->MspInitCallback = HAL_PCCARD_MspInit; |
| break; |
| case HAL_PCCARD_MSP_DEINIT_CB_ID : |
| hpccard->MspDeInitCallback = HAL_PCCARD_MspDeInit; |
| break; |
| default : |
| /* update return status */ |
| status = HAL_ERROR; |
| break; |
| } |
| } |
| else |
| { |
| /* update return status */ |
| status = HAL_ERROR; |
| } |
| |
| /* Release Lock */ |
| __HAL_UNLOCK(hpccard); |
| return status; |
| } |
| #endif /* USE_HAL_PCCARD_REGISTER_CALLBACKS */ |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup PCCARD_Exported_Functions_Group3 State functions |
| * @brief Peripheral State functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### PCCARD State functions ##### |
| ============================================================================== |
| [..] |
| This subsection permits to get in run-time the status of the PCCARD controller |
| and the data flow. |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief return the PCCARD controller state |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @retval HAL state |
| */ |
| HAL_PCCARD_StateTypeDef HAL_PCCARD_GetState(PCCARD_HandleTypeDef *hpccard) |
| { |
| return hpccard->State; |
| } |
| |
| /** |
| * @brief Get the compact flash memory status |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @retval New status of the PCCARD operation. This parameter can be: |
| * - CompactFlash_TIMEOUT_ERROR: when the previous operation generate |
| * a Timeout error |
| * - CompactFlash_READY: when memory is ready for the next operation |
| */ |
| HAL_PCCARD_StatusTypeDef HAL_PCCARD_GetStatus(PCCARD_HandleTypeDef *hpccard) |
| { |
| uint32_t timeout = PCCARD_TIMEOUT_STATUS; |
| uint32_t status_pccard = 0U; |
| |
| /* Check the PCCARD controller state */ |
| if (hpccard->State == HAL_PCCARD_STATE_BUSY) |
| { |
| return HAL_PCCARD_STATUS_ONGOING; |
| } |
| |
| status_pccard = *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| |
| while ((status_pccard == PCCARD_BUSY) && timeout) |
| { |
| status_pccard = *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| timeout--; |
| } |
| |
| if (timeout == 0U) |
| { |
| status_pccard = PCCARD_TIMEOUT_ERROR; |
| } |
| |
| /* Return the operation status */ |
| return (HAL_PCCARD_StatusTypeDef) status_pccard; |
| } |
| |
| /** |
| * @brief Reads the Compact Flash memory status using the Read status command |
| * @param hpccard pointer to a PCCARD_HandleTypeDef structure that contains |
| * the configuration information for PCCARD module. |
| * @retval The status of the Compact Flash memory. This parameter can be: |
| * - CompactFlash_BUSY: when memory is busy |
| * - CompactFlash_READY: when memory is ready for the next operation |
| * - CompactFlash_ERROR: when the previous operation generates error |
| */ |
| HAL_PCCARD_StatusTypeDef HAL_PCCARD_ReadStatus(PCCARD_HandleTypeDef *hpccard) |
| { |
| uint8_t data = 0U; |
| uint8_t status_pccard = PCCARD_BUSY; |
| |
| /* Check the PCCARD controller state */ |
| if (hpccard->State == HAL_PCCARD_STATE_BUSY) |
| { |
| return HAL_PCCARD_STATUS_ONGOING; |
| } |
| |
| /* Read status operation */ |
| data = *(__IO uint8_t *)(PCCARD_IO_SPACE_PRIMARY_ADDR | ATA_STATUS_CMD_ALTERNATE); |
| |
| if ((data & PCCARD_TIMEOUT_ERROR) == PCCARD_TIMEOUT_ERROR) |
| { |
| status_pccard = PCCARD_TIMEOUT_ERROR; |
| } |
| else if ((data & PCCARD_READY) == PCCARD_READY) |
| { |
| status_pccard = PCCARD_READY; |
| } |
| |
| return (HAL_PCCARD_StatusTypeDef) status_pccard; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| #endif /* HAL_PCCARD_MODULE_ENABLED */ |
| |
| /** |
| * @} |
| */ |
| |