stm32f4xx_hal_sram.h 8.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202
  1. /**
  2. ******************************************************************************
  3. * @file stm32f4xx_hal_sram.h
  4. * @author MCD Application Team
  5. * @version V1.3.0
  6. * @date 09-March-2015
  7. * @brief Header file of SRAM HAL module.
  8. ******************************************************************************
  9. * @attention
  10. *
  11. * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
  12. *
  13. * Redistribution and use in source and binary forms, with or without modification,
  14. * are permitted provided that the following conditions are met:
  15. * 1. Redistributions of source code must retain the above copyright notice,
  16. * this list of conditions and the following disclaimer.
  17. * 2. Redistributions in binary form must reproduce the above copyright notice,
  18. * this list of conditions and the following disclaimer in the documentation
  19. * and/or other materials provided with the distribution.
  20. * 3. Neither the name of STMicroelectronics nor the names of its contributors
  21. * may be used to endorse or promote products derived from this software
  22. * without specific prior written permission.
  23. *
  24. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  25. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  27. * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
  28. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  30. * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  31. * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  32. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  33. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34. *
  35. ******************************************************************************
  36. */
  37. /* Define to prevent recursive inclusion -------------------------------------*/
  38. #ifndef __STM32F4xx_HAL_SRAM_H
  39. #define __STM32F4xx_HAL_SRAM_H
  40. #ifdef __cplusplus
  41. extern "C" {
  42. #endif
  43. /* Includes ------------------------------------------------------------------*/
  44. #if defined(STM32F405xx) || defined(STM32F415xx) || defined(STM32F407xx)|| defined(STM32F417xx)
  45. #include "stm32f4xx_ll_fsmc.h"
  46. #endif /* STM32F405xx || STM32F415xx || STM32F407xx || STM32F417xx */
  47. #if defined(STM32F427xx) || defined(STM32F437xx) || defined(STM32F429xx)|| defined(STM32F439xx) || defined(STM32F446xx)
  48. #include "stm32f4xx_ll_fmc.h"
  49. #endif /* STM32F427xx || STM32F437xx || STM32F429xx || STM32F439xx || STM32F446xx */
  50. /** @addtogroup STM32F4xx_HAL_Driver
  51. * @{
  52. */
  53. #if defined(STM32F405xx) || defined(STM32F415xx) || defined(STM32F407xx) || defined(STM32F417xx) ||\
  54. defined(STM32F427xx) || defined(STM32F437xx) || defined(STM32F429xx) || defined(STM32F439xx) ||\
  55. defined(STM32F446xx)
  56. /** @addtogroup SRAM
  57. * @{
  58. */
  59. /* Exported typedef ----------------------------------------------------------*/
  60. /** @defgroup SRAM_Exported_Types SRAM Exported Types
  61. * @{
  62. */
  63. /**
  64. * @brief HAL SRAM State structures definition
  65. */
  66. typedef enum
  67. {
  68. HAL_SRAM_STATE_RESET = 0x00, /*!< SRAM not yet initialized or disabled */
  69. HAL_SRAM_STATE_READY = 0x01, /*!< SRAM initialized and ready for use */
  70. HAL_SRAM_STATE_BUSY = 0x02, /*!< SRAM internal process is ongoing */
  71. HAL_SRAM_STATE_ERROR = 0x03, /*!< SRAM error state */
  72. HAL_SRAM_STATE_PROTECTED = 0x04 /*!< SRAM peripheral NORSRAM device write protected */
  73. }HAL_SRAM_StateTypeDef;
  74. /**
  75. * @brief SRAM handle Structure definition
  76. */
  77. typedef struct
  78. {
  79. FMC_NORSRAM_TypeDef *Instance; /*!< Register base address */
  80. FMC_NORSRAM_EXTENDED_TypeDef *Extended; /*!< Extended mode register base address */
  81. FMC_NORSRAM_InitTypeDef Init; /*!< SRAM device control configuration parameters */
  82. HAL_LockTypeDef Lock; /*!< SRAM locking object */
  83. __IO HAL_SRAM_StateTypeDef State; /*!< SRAM device access state */
  84. DMA_HandleTypeDef *hdma; /*!< Pointer DMA handler */
  85. }SRAM_HandleTypeDef;
  86. /**
  87. * @}
  88. */
  89. /* Exported constants --------------------------------------------------------*/
  90. /* Exported macro ------------------------------------------------------------*/
  91. /** @defgroup SRAM_Exported_Macros SRAM Exported Macros
  92. * @{
  93. */
  94. /** @brief Reset SRAM handle state
  95. * @param __HANDLE__: SRAM handle
  96. * @retval None
  97. */
  98. #define __HAL_SRAM_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_SRAM_STATE_RESET)
  99. /**
  100. * @}
  101. */
  102. /* Exported functions --------------------------------------------------------*/
  103. /** @addtogroup SRAM_Exported_Functions
  104. * @{
  105. */
  106. /** @addtogroup SRAM_Exported_Functions_Group1
  107. * @{
  108. */
  109. /* Initialization/de-initialization functions **********************************/
  110. HAL_StatusTypeDef HAL_SRAM_Init(SRAM_HandleTypeDef *hsram, FMC_NORSRAM_TimingTypeDef *Timing, FMC_NORSRAM_TimingTypeDef *ExtTiming);
  111. HAL_StatusTypeDef HAL_SRAM_DeInit(SRAM_HandleTypeDef *hsram);
  112. void HAL_SRAM_MspInit(SRAM_HandleTypeDef *hsram);
  113. void HAL_SRAM_MspDeInit(SRAM_HandleTypeDef *hsram);
  114. void HAL_SRAM_DMA_XferCpltCallback(DMA_HandleTypeDef *hdma);
  115. void HAL_SRAM_DMA_XferErrorCallback(DMA_HandleTypeDef *hdma);
  116. /**
  117. * @}
  118. */
  119. /** @addtogroup SRAM_Exported_Functions_Group2
  120. * @{
  121. */
  122. /* I/O operation functions *****************************************************/
  123. HAL_StatusTypeDef HAL_SRAM_Read_8b(SRAM_HandleTypeDef *hsram, uint32_t *pAddress, uint8_t *pDstBuffer, uint32_t BufferSize);
  124. HAL_StatusTypeDef HAL_SRAM_Write_8b(SRAM_HandleTypeDef *hsram, uint32_t *pAddress, uint8_t *pSrcBuffer, uint32_t BufferSize);
  125. HAL_StatusTypeDef HAL_SRAM_Read_16b(SRAM_HandleTypeDef *hsram, uint32_t *pAddress, uint16_t *pDstBuffer, uint32_t BufferSize);
  126. HAL_StatusTypeDef HAL_SRAM_Write_16b(SRAM_HandleTypeDef *hsram, uint32_t *pAddress, uint16_t *pSrcBuffer, uint32_t BufferSize);
  127. HAL_StatusTypeDef HAL_SRAM_Read_32b(SRAM_HandleTypeDef *hsram, uint32_t *pAddress, uint32_t *pDstBuffer, uint32_t BufferSize);
  128. HAL_StatusTypeDef HAL_SRAM_Write_32b(SRAM_HandleTypeDef *hsram, uint32_t *pAddress, uint32_t *pSrcBuffer, uint32_t BufferSize);
  129. HAL_StatusTypeDef HAL_SRAM_Read_DMA(SRAM_HandleTypeDef *hsram, uint32_t *pAddress, uint32_t *pDstBuffer, uint32_t BufferSize);
  130. HAL_StatusTypeDef HAL_SRAM_Write_DMA(SRAM_HandleTypeDef *hsram, uint32_t *pAddress, uint32_t *pSrcBuffer, uint32_t BufferSize);
  131. /**
  132. * @}
  133. */
  134. /** @addtogroup SRAM_Exported_Functions_Group3
  135. * @{
  136. */
  137. /* SRAM Control functions ******************************************************/
  138. HAL_StatusTypeDef HAL_SRAM_WriteOperation_Enable(SRAM_HandleTypeDef *hsram);
  139. HAL_StatusTypeDef HAL_SRAM_WriteOperation_Disable(SRAM_HandleTypeDef *hsram);
  140. /**
  141. * @}
  142. */
  143. /** @addtogroup SRAM_Exported_Functions_Group4
  144. * @{
  145. */
  146. /* SRAM State functions *********************************************************/
  147. HAL_SRAM_StateTypeDef HAL_SRAM_GetState(SRAM_HandleTypeDef *hsram);
  148. /**
  149. * @}
  150. */
  151. /**
  152. * @}
  153. */
  154. /* Private types -------------------------------------------------------------*/
  155. /* Private variables ---------------------------------------------------------*/
  156. /* Private constants ---------------------------------------------------------*/
  157. /* Private macros ------------------------------------------------------------*/
  158. /* Private functions ---------------------------------------------------------*/
  159. /**
  160. * @}
  161. */
  162. #endif /* STM32F405xx || STM32F415xx || STM32F407xx || STM32F417xx || STM32F427xx || STM32F437xx || STM32F429xx || STM32F439xx || STM32F446xx */
  163. /**
  164. * @}
  165. */
  166. #ifdef __cplusplus
  167. }
  168. #endif
  169. #endif /* __STM32F4xx_HAL_SRAM_H */
  170. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/