git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/CORTEX_M7_STM32F7_STM32756G-EVAL/ST_Library/include/stm32f7xx_hal_nor.h

   1 /**\r
   2   ******************************************************************************\r
   3   * @file    stm32f7xx_hal_nor.h\r
   4   * @author  MCD Application Team\r
   5   * @version V0.3.0\r
   6   * @date    06-March-2015\r
   7   * @brief   Header file of NOR HAL module.\r
   8   ******************************************************************************\r
   9   * @attention\r
  10   *\r
  11   * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>\r
  12   *\r
  13   * Redistribution and use in source and binary forms, with or without modification,\r
  14   * are permitted provided that the following conditions are met:\r
  15   *   1. Redistributions of source code must retain the above copyright notice,\r
  16   *      this list of conditions and the following disclaimer.\r
  17   *   2. Redistributions in binary form must reproduce the above copyright notice,\r
  18   *      this list of conditions and the following disclaimer in the documentation\r
  19   *      and/or other materials provided with the distribution.\r
  20   *   3. Neither the name of STMicroelectronics nor the names of its contributors\r
  21   *      may be used to endorse or promote products derived from this software\r
  22   *      without specific prior written permission.\r
  23   *\r
  24   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"\r
  25   * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\r
  26   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\r
  27   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\r
  28   * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\r
  29   * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\r
  30   * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\r
  31   * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\r
  32   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\r
  33   * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
  34   *\r
  35   ******************************************************************************\r
  36   */ \r
  37 \r
  38 /* Define to prevent recursive inclusion -------------------------------------*/\r
  39 #ifndef __STM32F7xx_HAL_NOR_H\r
  40 #define __STM32F7xx_HAL_NOR_H\r
  41 \r
  42 #ifdef __cplusplus\r
  43  extern "C" {\r
  44 #endif\r
  45 \r
  46 /* Includes ------------------------------------------------------------------*/\r
  47 #include "stm32f7xx_ll_fmc.h"\r
  48 \r
  49 \r
  50 /** @addtogroup STM32F7xx_HAL_Driver\r
  51   * @{\r
  52   */\r
  53 \r
  54 /** @addtogroup NOR\r
  55   * @{\r
  56   */ \r
  57 \r
  58 #if defined(STM32F756xx) || defined(STM32F746xx)\r
  59 /* Exported typedef ----------------------------------------------------------*/\r
  60 /** @defgroup NOR_Exported_Types NOR Exported Types\r
  61   * @{\r
  62   */\r
  63 \r
  64 /** \r
  65   * @brief  HAL SRAM State structures definition  \r
  66   */ \r
  67 typedef enum\r
  68 {  \r
  69   HAL_NOR_STATE_RESET             = 0x00,  /*!< NOR not yet initialized or disabled  */\r
  70   HAL_NOR_STATE_READY             = 0x01,  /*!< NOR initialized and ready for use    */\r
  71   HAL_NOR_STATE_BUSY              = 0x02,  /*!< NOR internal processing is ongoing   */\r
  72   HAL_NOR_STATE_ERROR             = 0x03,  /*!< NOR error state                      */\r
  73   HAL_NOR_STATE_PROTECTED         = 0x04   /*!< NOR NORSRAM device write protected   */\r
  74 }HAL_NOR_StateTypeDef;\r
  75 \r
  76 /**\r
  77   * @brief  FMC NOR Status typedef\r
  78   */\r
  79 typedef enum\r
  80 {\r
  81   HAL_NOR_STATUS_SUCCESS  = 0,\r
  82   HAL_NOR_STATUS_ONGOING,\r
  83   HAL_NOR_STATUS_ERROR,\r
  84   HAL_NOR_STATUS_TIMEOUT\r
  85 }HAL_NOR_StatusTypeDef;\r
  86 \r
  87 /**\r
  88   * @brief  FMC NOR ID typedef\r
  89   */\r
  90 typedef struct\r
  91 {\r
  92   uint16_t Manufacturer_Code;  /*!< Defines the device's manufacturer code used to identify the memory       */\r
  93 \r
  94   uint16_t Device_Code1;\r
  95 \r
  96   uint16_t Device_Code2;\r
  97 \r
  98   uint16_t Device_Code3;       /*!< Defines the device's codes used to identify the memory. \r
  99                                     These codes can be accessed by performing read operations with specific \r
 100                                     control signals and addresses set.They can also be accessed by issuing \r
 101                                     an Auto Select command                                                   */\r
 102 }NOR_IDTypeDef;\r
 103 \r
 104 /**\r
 105   * @brief  FMC NOR CFI typedef\r
 106   */\r
 107 typedef struct\r
 108 {\r
 109   /*!< Defines the information stored in the memory's Common flash interface\r
 110        which contains a description of various electrical and timing parameters, \r
 111        density information and functions supported by the memory                   */\r
 112 \r
 113   uint16_t CFI_1;\r
 114 \r
 115   uint16_t CFI_2;\r
 116 \r
 117   uint16_t CFI_3;\r
 118 \r
 119   uint16_t CFI_4;\r
 120 }NOR_CFITypeDef;\r
 121 \r
 122 /** \r
 123   * @brief  NOR handle Structure definition\r
 124   */ \r
 125 typedef struct\r
 126 {\r
 127   FMC_NORSRAM_TypeDef           *Instance;    /*!< Register base address                        */\r
 128 \r
 129   FMC_NORSRAM_EXTENDED_TypeDef  *Extended;    /*!< Extended mode register base address          */\r
 130 \r
 131   FMC_NORSRAM_InitTypeDef       Init;         /*!< NOR device control configuration parameters  */\r
 132 \r
 133   HAL_LockTypeDef               Lock;         /*!< NOR locking object                           */\r
 134 \r
 135   __IO HAL_NOR_StateTypeDef     State;        /*!< NOR device access state                      */\r
 136 \r
 137 }NOR_HandleTypeDef;\r
 138 /**\r
 139   * @}\r
 140   */\r
 141   \r
 142 /* Exported constants --------------------------------------------------------*/\r
 143 /* Exported macro ------------------------------------------------------------*/\r
 144 /** @defgroup NOR_Exported_Macros NOR Exported Macros\r
 145   * @{\r
 146   */\r
 147 /** @brief Reset NOR handle state\r
 148   * @param  __HANDLE__: specifies the NOR handle.\r
 149   * @retval None\r
 150   */\r
 151 #define __HAL_NOR_RESET_HANDLE_STATE(__HANDLE__) ((__HANDLE__)->State = HAL_NOR_STATE_RESET)\r
 152 /**\r
 153   * @}\r
 154   */\r
 155 \r
 156 /* Exported functions --------------------------------------------------------*/\r
 157 /** @addtogroup NOR_Exported_Functions NOR Exported Functions\r
 158   * @{\r
 159   */\r
 160 \r
 161 /** @addtogroup NOR_Exported_Functions_Group1 Initialization and de-initialization functions \r
 162   * @{\r
 163   */\r
 164 \r
 165 /* Initialization/de-initialization functions  ********************************/\r
 166 HAL_StatusTypeDef HAL_NOR_Init(NOR_HandleTypeDef *hnor, FMC_NORSRAM_TimingTypeDef *Timing, FMC_NORSRAM_TimingTypeDef *ExtTiming);\r
 167 HAL_StatusTypeDef HAL_NOR_DeInit(NOR_HandleTypeDef *hnor);\r
 168 void HAL_NOR_MspInit(NOR_HandleTypeDef *hnor);\r
 169 void HAL_NOR_MspDeInit(NOR_HandleTypeDef *hnor);\r
 170 void HAL_NOR_MspWait(NOR_HandleTypeDef *hnor, uint32_t Timeout);\r
 171 /**\r
 172   * @}\r
 173   */\r
 174 \r
 175 /** @addtogroup NOR_Exported_Functions_Group2 Input and Output functions \r
 176   * @{\r
 177   */\r
 178 \r
 179 /* I/O operation functions  ***************************************************/\r
 180 HAL_StatusTypeDef HAL_NOR_Read_ID(NOR_HandleTypeDef *hnor, NOR_IDTypeDef *pNOR_ID);\r
 181 HAL_StatusTypeDef HAL_NOR_ReturnToReadMode(NOR_HandleTypeDef *hnor);\r
 182 HAL_StatusTypeDef HAL_NOR_Read(NOR_HandleTypeDef *hnor, uint32_t *pAddress, uint16_t *pData);\r
 183 HAL_StatusTypeDef HAL_NOR_Program(NOR_HandleTypeDef *hnor, uint32_t *pAddress, uint16_t *pData);\r
 184 \r
 185 HAL_StatusTypeDef HAL_NOR_ReadBuffer(NOR_HandleTypeDef *hnor, uint32_t uwAddress, uint16_t *pData, uint32_t uwBufferSize);\r
 186 HAL_StatusTypeDef HAL_NOR_ProgramBuffer(NOR_HandleTypeDef *hnor, uint32_t uwAddress, uint16_t *pData, uint32_t uwBufferSize);\r
 187 \r
 188 HAL_StatusTypeDef HAL_NOR_Erase_Block(NOR_HandleTypeDef *hnor, uint32_t BlockAddress, uint32_t Address);\r
 189 HAL_StatusTypeDef HAL_NOR_Erase_Chip(NOR_HandleTypeDef *hnor, uint32_t Address);\r
 190 HAL_StatusTypeDef HAL_NOR_Read_CFI(NOR_HandleTypeDef *hnor, NOR_CFITypeDef *pNOR_CFI);\r
 191 /**\r
 192   * @}\r
 193   */\r
 194   \r
 195 /** @addtogroup NOR_Exported_Functions_Group3 Peripheral Control functions \r
 196   * @{\r
 197   */\r
 198 \r
 199 /* NOR Control functions  *****************************************************/\r
 200 HAL_StatusTypeDef HAL_NOR_WriteOperation_Enable(NOR_HandleTypeDef *hnor);\r
 201 HAL_StatusTypeDef HAL_NOR_WriteOperation_Disable(NOR_HandleTypeDef *hnor);\r
 202 /**\r
 203   * @}\r
 204   */\r
 205   \r
 206 /** @addtogroup NOR_Exported_Functions_Group4 Peripheral State functions \r
 207   * @{\r
 208   */\r
 209 \r
 210 /* NOR State functions ********************************************************/\r
 211 HAL_NOR_StateTypeDef  HAL_NOR_GetState(NOR_HandleTypeDef *hnor);\r
 212 HAL_NOR_StatusTypeDef HAL_NOR_GetStatus(NOR_HandleTypeDef *hnor, uint32_t Address, uint32_t Timeout);\r
 213 /**\r
 214   * @}\r
 215   */\r
 216     \r
 217 /**\r
 218   * @}\r
 219   */\r
 220   \r
 221 /* Private types -------------------------------------------------------------*/\r
 222 /* Private variables ---------------------------------------------------------*/\r
 223 /* Private constants ---------------------------------------------------------*/\r
 224 /** @defgroup NOR_Private_Constants NOR Private Constants\r
 225   * @{\r
 226   */\r
 227 /* NOR device IDs addresses */\r
 228 #define MC_ADDRESS               ((uint16_t)0x0000)\r
 229 #define DEVICE_CODE1_ADDR        ((uint16_t)0x0001)\r
 230 #define DEVICE_CODE2_ADDR        ((uint16_t)0x000E)\r
 231 #define DEVICE_CODE3_ADDR        ((uint16_t)0x000F)\r
 232 \r
 233 /* NOR CFI IDs addresses */\r
 234 #define CFI1_ADDRESS             ((uint16_t)0x61)\r
 235 #define CFI2_ADDRESS             ((uint16_t)0x62)\r
 236 #define CFI3_ADDRESS             ((uint16_t)0x63)\r
 237 #define CFI4_ADDRESS             ((uint16_t)0x64)\r
 238 \r
 239 /* NOR operation wait timeout */\r
 240 #define NOR_TMEOUT               ((uint16_t)0xFFFF)\r
 241    \r
 242 /* NOR memory data width */\r
 243 #define NOR_MEMORY_8B            ((uint8_t)0x0)\r
 244 #define NOR_MEMORY_16B           ((uint8_t)0x1)\r
 245 \r
 246 /* NOR memory device read/write start address */\r
 247 #define NOR_MEMORY_ADRESS1       ((uint32_t)0x60000000)\r
 248 #define NOR_MEMORY_ADRESS2       ((uint32_t)0x64000000)\r
 249 #define NOR_MEMORY_ADRESS3       ((uint32_t)0x68000000)\r
 250 #define NOR_MEMORY_ADRESS4       ((uint32_t)0x6C000000)\r
 251 /**\r
 252   * @}\r
 253   */\r
 254 \r
 255 /* Private macros ------------------------------------------------------------*/\r
 256 /** @defgroup NOR_Private_Macros NOR Private Macros\r
 257   * @{\r
 258   */\r
 259 /**\r
 260   * @brief  NOR memory address shifting.\r
 261   * @param  __NOR_ADDRESS: NOR base address \r
 262   * @param  __NOR_MEMORY_WIDTH_: NOR memory width\r
 263   * @param  __ADDRESS__: NOR memory address \r
 264   * @retval NOR shifted address value\r
 265   */\r
 266 #define NOR_ADDR_SHIFT(__NOR_ADDRESS, __NOR_MEMORY_WIDTH_, __ADDRESS__)       \\r
 267             ((uint32_t)(((__NOR_MEMORY_WIDTH_) == NOR_MEMORY_8B)?              \\r
 268               ((uint32_t)((__NOR_ADDRESS) + (2 * (__ADDRESS__)))):              \\r
 269               ((uint32_t)((__NOR_ADDRESS) + (__ADDRESS__)))))\r
 270  \r
 271 /**\r
 272   * @brief  NOR memory write data to specified address.\r
 273   * @param  __ADDRESS__: NOR memory address \r
 274   * @param  __DATA__: Data to write\r
 275   * @retval None\r
 276   */\r
 277 #define NOR_WRITE(__ADDRESS__, __DATA__)   do{                                                             \\r
 278                                                  (*(__IO uint16_t *)((uint32_t)(__ADDRESS__)) = (__DATA__)); \\r
 279                                                  __DSB();                                                    \\r
 280                                                } while(0)\r
 281 \r
 282 /**\r
 283   * @}\r
 284   */\r
 285 #endif /* STM32F756xx || STM32F746xx */\r
 286 /**\r
 287   * @}\r
 288   */ \r
 289 \r
 290 /**\r
 291   * @}\r
 292   */\r
 293 \r
 294 #ifdef __cplusplus\r
 295 }\r
 296 #endif\r
 297 \r
 298 #endif /* __STM32F7xx_HAL_NOR_H */\r
 299 \r
 300 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/\r