Ricardo Benitez / mbed

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed by mbed official

TARGET_MTS_MDOT_F411RE/stm32f4xx_hal_sdram.h@99:dbbf35b96557, 2015-05-13 (annotated)

Committer:
Kojto
Date:
Wed May 13 08:08:21 2015 +0200
Revision:
99:dbbf35b96557
Parent:
93:e188a91d3eaa
Child:
106:ba1f97679dad
Release 99 of the mbed library



Changes:

 - new targets - MAXWSNENV, DISCO_L053C8

 - STM32F4xx - ST Cube driver

 - KSDK mcu - SPI timing fix

 - Nordic - update to softdevice s130

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Kojto 93:e188a91d3eaa 1 /**
Kojto 93:e188a91d3eaa 2 ******************************************************************************
Kojto 93:e188a91d3eaa 3 * @file stm32f4xx_hal_sdram.h
Kojto 93:e188a91d3eaa 4 * @author MCD Application Team
Kojto 99:dbbf35b96557 5 * @version V1.3.0
Kojto 99:dbbf35b96557 6 * @date 09-March-2015
Kojto 93:e188a91d3eaa 7 * @brief Header file of SDRAM HAL module.
Kojto 93:e188a91d3eaa 8 ******************************************************************************
Kojto 93:e188a91d3eaa 9 * @attention
Kojto 93:e188a91d3eaa 10 *
Kojto 99:dbbf35b96557 11 * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
Kojto 93:e188a91d3eaa 12 *
Kojto 93:e188a91d3eaa 13 * Redistribution and use in source and binary forms, with or without modification,
Kojto 93:e188a91d3eaa 14 * are permitted provided that the following conditions are met:
Kojto 93:e188a91d3eaa 15 * 1. Redistributions of source code must retain the above copyright notice,
Kojto 93:e188a91d3eaa 16 * this list of conditions and the following disclaimer.
Kojto 93:e188a91d3eaa 17 * 2. Redistributions in binary form must reproduce the above copyright notice,
Kojto 93:e188a91d3eaa 18 * this list of conditions and the following disclaimer in the documentation
Kojto 93:e188a91d3eaa 19 * and/or other materials provided with the distribution.
Kojto 93:e188a91d3eaa 20 * 3. Neither the name of STMicroelectronics nor the names of its contributors
Kojto 93:e188a91d3eaa 21 * may be used to endorse or promote products derived from this software
Kojto 93:e188a91d3eaa 22 * without specific prior written permission.
Kojto 93:e188a91d3eaa 23 *
Kojto 93:e188a91d3eaa 24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Kojto 93:e188a91d3eaa 25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
Kojto 93:e188a91d3eaa 26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
Kojto 93:e188a91d3eaa 27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
Kojto 93:e188a91d3eaa 28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
Kojto 93:e188a91d3eaa 29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
Kojto 93:e188a91d3eaa 30 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
Kojto 93:e188a91d3eaa 31 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
Kojto 93:e188a91d3eaa 32 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
Kojto 93:e188a91d3eaa 33 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Kojto 93:e188a91d3eaa 34 *
Kojto 93:e188a91d3eaa 35 ******************************************************************************
Kojto 93:e188a91d3eaa 36 */
Kojto 93:e188a91d3eaa 37
Kojto 93:e188a91d3eaa 38 /* Define to prevent recursive inclusion -------------------------------------*/
Kojto 93:e188a91d3eaa 39 #ifndef __STM32F4xx_HAL_SDRAM_H
Kojto 93:e188a91d3eaa 40 #define __STM32F4xx_HAL_SDRAM_H
Kojto 93:e188a91d3eaa 41
Kojto 93:e188a91d3eaa 42 #ifdef __cplusplus
Kojto 93:e188a91d3eaa 43 extern "C" {
Kojto 93:e188a91d3eaa 44 #endif
Kojto 93:e188a91d3eaa 45
Kojto 99:dbbf35b96557 46 #if defined(STM32F427xx) || defined(STM32F437xx) || defined(STM32F429xx) || defined(STM32F439xx) || defined(STM32F446xx)
Kojto 93:e188a91d3eaa 47
Kojto 93:e188a91d3eaa 48 /* Includes ------------------------------------------------------------------*/
Kojto 93:e188a91d3eaa 49 #include "stm32f4xx_ll_fmc.h"
Kojto 93:e188a91d3eaa 50
Kojto 93:e188a91d3eaa 51 /** @addtogroup STM32F4xx_HAL_Driver
Kojto 93:e188a91d3eaa 52 * @{
Kojto 93:e188a91d3eaa 53 */
Kojto 93:e188a91d3eaa 54
Kojto 93:e188a91d3eaa 55 /** @addtogroup SDRAM
Kojto 93:e188a91d3eaa 56 * @{
Kojto 93:e188a91d3eaa 57 */
Kojto 93:e188a91d3eaa 58
Kojto 93:e188a91d3eaa 59 /* Exported typedef ----------------------------------------------------------*/
Kojto 99:dbbf35b96557 60 /** @defgroup SDRAM_Exported_Types SDRAM Exported Types
Kojto 99:dbbf35b96557 61 * @{
Kojto 99:dbbf35b96557 62 */
Kojto 93:e188a91d3eaa 63
Kojto 93:e188a91d3eaa 64 /**
Kojto 93:e188a91d3eaa 65 * @brief HAL SDRAM State structure definition
Kojto 93:e188a91d3eaa 66 */
Kojto 93:e188a91d3eaa 67 typedef enum
Kojto 93:e188a91d3eaa 68 {
Kojto 93:e188a91d3eaa 69 HAL_SDRAM_STATE_RESET = 0x00, /*!< SDRAM not yet initialized or disabled */
Kojto 93:e188a91d3eaa 70 HAL_SDRAM_STATE_READY = 0x01, /*!< SDRAM initialized and ready for use */
Kojto 93:e188a91d3eaa 71 HAL_SDRAM_STATE_BUSY = 0x02, /*!< SDRAM internal process is ongoing */
Kojto 93:e188a91d3eaa 72 HAL_SDRAM_STATE_ERROR = 0x03, /*!< SDRAM error state */
Kojto 93:e188a91d3eaa 73 HAL_SDRAM_STATE_WRITE_PROTECTED = 0x04, /*!< SDRAM device write protected */
Kojto 93:e188a91d3eaa 74 HAL_SDRAM_STATE_PRECHARGED = 0x05 /*!< SDRAM device precharged */
Kojto 93:e188a91d3eaa 75
Kojto 93:e188a91d3eaa 76 }HAL_SDRAM_StateTypeDef;
Kojto 93:e188a91d3eaa 77
Kojto 93:e188a91d3eaa 78 /**
Kojto 93:e188a91d3eaa 79 * @brief SDRAM handle Structure definition
Kojto 93:e188a91d3eaa 80 */
Kojto 93:e188a91d3eaa 81 typedef struct
Kojto 93:e188a91d3eaa 82 {
Kojto 93:e188a91d3eaa 83 FMC_SDRAM_TypeDef *Instance; /*!< Register base address */
Kojto 93:e188a91d3eaa 84
Kojto 93:e188a91d3eaa 85 FMC_SDRAM_InitTypeDef Init; /*!< SDRAM device configuration parameters */
Kojto 93:e188a91d3eaa 86
Kojto 93:e188a91d3eaa 87 __IO HAL_SDRAM_StateTypeDef State; /*!< SDRAM access state */
Kojto 93:e188a91d3eaa 88
Kojto 93:e188a91d3eaa 89 HAL_LockTypeDef Lock; /*!< SDRAM locking object */
Kojto 93:e188a91d3eaa 90
Kojto 93:e188a91d3eaa 91 DMA_HandleTypeDef *hdma; /*!< Pointer DMA handler */
Kojto 93:e188a91d3eaa 92
Kojto 93:e188a91d3eaa 93 }SDRAM_HandleTypeDef;
Kojto 99:dbbf35b96557 94 /**
Kojto 99:dbbf35b96557 95 * @}
Kojto 99:dbbf35b96557 96 */
Kojto 99:dbbf35b96557 97
Kojto 99:dbbf35b96557 98 /* Exported constants --------------------------------------------------------*/
Kojto 93:e188a91d3eaa 99 /* Exported macro ------------------------------------------------------------*/
Kojto 99:dbbf35b96557 100 /** @defgroup SDRAM_Exported_Macros SDRAM Exported Macros
Kojto 99:dbbf35b96557 101 * @{
Kojto 99:dbbf35b96557 102 */
Kojto 93:e188a91d3eaa 103
Kojto 93:e188a91d3eaa 104 /** @brief Reset SDRAM handle state
Kojto 93:e188a91d3eaa 105 * @param __HANDLE__: specifies the SDRAM handle.
Kojto 93:e188a91d3eaa 106 * @retval None
Kojto 93:e188a91d3eaa 107 */
Kojto 93:e188a91d3eaa 108 #define __HAL_SDRAM_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_SDRAM_STATE_RESET)
Kojto 99:dbbf35b96557 109 /**
Kojto 99:dbbf35b96557 110 * @}
Kojto 99:dbbf35b96557 111 */
Kojto 93:e188a91d3eaa 112
Kojto 93:e188a91d3eaa 113 /* Exported functions --------------------------------------------------------*/
Kojto 99:dbbf35b96557 114 /** @addtogroup SDRAM_Exported_Functions SDRAM Exported Functions
Kojto 99:dbbf35b96557 115 * @{
Kojto 99:dbbf35b96557 116 */
Kojto 93:e188a91d3eaa 117
Kojto 99:dbbf35b96557 118 /** @addtogroup SDRAM_Exported_Functions_Group1
Kojto 99:dbbf35b96557 119 * @{
Kojto 99:dbbf35b96557 120 */
Kojto 99:dbbf35b96557 121
Kojto 99:dbbf35b96557 122 /* Initialization/de-initialization functions *********************************/
Kojto 93:e188a91d3eaa 123 HAL_StatusTypeDef HAL_SDRAM_Init(SDRAM_HandleTypeDef *hsdram, FMC_SDRAM_TimingTypeDef *Timing);
Kojto 93:e188a91d3eaa 124 HAL_StatusTypeDef HAL_SDRAM_DeInit(SDRAM_HandleTypeDef *hsdram);
Kojto 93:e188a91d3eaa 125 void HAL_SDRAM_MspInit(SDRAM_HandleTypeDef *hsdram);
Kojto 93:e188a91d3eaa 126 void HAL_SDRAM_MspDeInit(SDRAM_HandleTypeDef *hsdram);
Kojto 93:e188a91d3eaa 127
Kojto 93:e188a91d3eaa 128 void HAL_SDRAM_IRQHandler(SDRAM_HandleTypeDef *hsdram);
Kojto 93:e188a91d3eaa 129 void HAL_SDRAM_RefreshErrorCallback(SDRAM_HandleTypeDef *hsdram);
Kojto 93:e188a91d3eaa 130 void HAL_SDRAM_DMA_XferCpltCallback(DMA_HandleTypeDef *hdma);
Kojto 93:e188a91d3eaa 131 void HAL_SDRAM_DMA_XferErrorCallback(DMA_HandleTypeDef *hdma);
Kojto 99:dbbf35b96557 132 /**
Kojto 99:dbbf35b96557 133 * @}
Kojto 99:dbbf35b96557 134 */
Kojto 93:e188a91d3eaa 135
Kojto 99:dbbf35b96557 136 /** @addtogroup SDRAM_Exported_Functions_Group2
Kojto 99:dbbf35b96557 137 * @{
Kojto 99:dbbf35b96557 138 */
Kojto 99:dbbf35b96557 139 /* I/O operation functions ****************************************************/
Kojto 93:e188a91d3eaa 140 HAL_StatusTypeDef HAL_SDRAM_Read_8b(SDRAM_HandleTypeDef *hsdram, uint32_t *pAddress, uint8_t *pDstBuffer, uint32_t BufferSize);
Kojto 93:e188a91d3eaa 141 HAL_StatusTypeDef HAL_SDRAM_Write_8b(SDRAM_HandleTypeDef *hsdram, uint32_t *pAddress, uint8_t *pSrcBuffer, uint32_t BufferSize);
Kojto 93:e188a91d3eaa 142 HAL_StatusTypeDef HAL_SDRAM_Read_16b(SDRAM_HandleTypeDef *hsdram, uint32_t *pAddress, uint16_t *pDstBuffer, uint32_t BufferSize);
Kojto 93:e188a91d3eaa 143 HAL_StatusTypeDef HAL_SDRAM_Write_16b(SDRAM_HandleTypeDef *hsdram, uint32_t *pAddress, uint16_t *pSrcBuffer, uint32_t BufferSize);
Kojto 93:e188a91d3eaa 144 HAL_StatusTypeDef HAL_SDRAM_Read_32b(SDRAM_HandleTypeDef *hsdram, uint32_t *pAddress, uint32_t *pDstBuffer, uint32_t BufferSize);
Kojto 93:e188a91d3eaa 145 HAL_StatusTypeDef HAL_SDRAM_Write_32b(SDRAM_HandleTypeDef *hsdram, uint32_t *pAddress, uint32_t *pSrcBuffer, uint32_t BufferSize);
Kojto 93:e188a91d3eaa 146
Kojto 93:e188a91d3eaa 147 HAL_StatusTypeDef HAL_SDRAM_Read_DMA(SDRAM_HandleTypeDef *hsdram, uint32_t * pAddress, uint32_t *pDstBuffer, uint32_t BufferSize);
Kojto 93:e188a91d3eaa 148 HAL_StatusTypeDef HAL_SDRAM_Write_DMA(SDRAM_HandleTypeDef *hsdram, uint32_t *pAddress, uint32_t *pSrcBuffer, uint32_t BufferSize);
Kojto 99:dbbf35b96557 149 /**
Kojto 99:dbbf35b96557 150 * @}
Kojto 99:dbbf35b96557 151 */
Kojto 99:dbbf35b96557 152
Kojto 99:dbbf35b96557 153 /** @addtogroup SDRAM_Exported_Functions_Group3
Kojto 99:dbbf35b96557 154 * @{
Kojto 99:dbbf35b96557 155 */
Kojto 93:e188a91d3eaa 156 /* SDRAM Control functions *****************************************************/
Kojto 93:e188a91d3eaa 157 HAL_StatusTypeDef HAL_SDRAM_WriteProtection_Enable(SDRAM_HandleTypeDef *hsdram);
Kojto 93:e188a91d3eaa 158 HAL_StatusTypeDef HAL_SDRAM_WriteProtection_Disable(SDRAM_HandleTypeDef *hsdram);
Kojto 93:e188a91d3eaa 159 HAL_StatusTypeDef HAL_SDRAM_SendCommand(SDRAM_HandleTypeDef *hsdram, FMC_SDRAM_CommandTypeDef *Command, uint32_t Timeout);
Kojto 93:e188a91d3eaa 160 HAL_StatusTypeDef HAL_SDRAM_ProgramRefreshRate(SDRAM_HandleTypeDef *hsdram, uint32_t RefreshRate);
Kojto 93:e188a91d3eaa 161 HAL_StatusTypeDef HAL_SDRAM_SetAutoRefreshNumber(SDRAM_HandleTypeDef *hsdram, uint32_t AutoRefreshNumber);
Kojto 93:e188a91d3eaa 162 uint32_t HAL_SDRAM_GetModeStatus(SDRAM_HandleTypeDef *hsdram);
Kojto 99:dbbf35b96557 163 /**
Kojto 99:dbbf35b96557 164 * @}
Kojto 99:dbbf35b96557 165 */
Kojto 93:e188a91d3eaa 166
Kojto 99:dbbf35b96557 167 /** @addtogroup SDRAM_Exported_Functions_Group4
Kojto 99:dbbf35b96557 168 * @{
Kojto 99:dbbf35b96557 169 */
Kojto 93:e188a91d3eaa 170 /* SDRAM State functions ********************************************************/
Kojto 93:e188a91d3eaa 171 HAL_SDRAM_StateTypeDef HAL_SDRAM_GetState(SDRAM_HandleTypeDef *hsdram);
Kojto 99:dbbf35b96557 172 /**
Kojto 99:dbbf35b96557 173 * @}
Kojto 99:dbbf35b96557 174 */
Kojto 93:e188a91d3eaa 175
Kojto 93:e188a91d3eaa 176 /**
Kojto 93:e188a91d3eaa 177 * @}
Kojto 99:dbbf35b96557 178 */
Kojto 99:dbbf35b96557 179
Kojto 99:dbbf35b96557 180 /**
Kojto 99:dbbf35b96557 181 * @}
Kojto 99:dbbf35b96557 182 */
Kojto 99:dbbf35b96557 183
Kojto 99:dbbf35b96557 184 #endif /* STM32F427xx || STM32F437xx || STM32F429xx || STM32F439xx || STM32F446xx */
Kojto 93:e188a91d3eaa 185
Kojto 93:e188a91d3eaa 186 /**
Kojto 93:e188a91d3eaa 187 * @}
Kojto 93:e188a91d3eaa 188 */
Kojto 93:e188a91d3eaa 189
Kojto 93:e188a91d3eaa 190 #ifdef __cplusplus
Kojto 93:e188a91d3eaa 191 }
Kojto 93:e188a91d3eaa 192 #endif
Kojto 93:e188a91d3eaa 193
Kojto 93:e188a91d3eaa 194 #endif /* __STM32F4xx_HAL_SDRAM_H */
Kojto 93:e188a91d3eaa 195
Kojto 93:e188a91d3eaa 196 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/