A simple 128x32 graphical LCD program to quickstart with LCD on ARM mbed IoT Starter Kit. This requires mbed Applciation Shield with FRDM-K64F platform.

Dependencies:   C12832

Committer:
tushki7
Date:
Sat Apr 11 04:08:13 2015 +0000
Revision:
0:60d829a0353a
A simple 128x32 LCD program to quickstart with LCD on ARM mbed IoT Starter kit. Mbed Application Shield is required if using FRDM-K64F platform.

Who changed what in which revision?

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