12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544 |
- /**
- ******************************************************************************
- * @file stm32l4xx_hal_nor.c
- * @author MCD Application Team
- * @brief NOR HAL module driver.
- * This file provides a generic firmware to drive NOR memories mounted
- * as external device.
- *
- ******************************************************************************
- * @attention
- *
- * Copyright (c) 2017 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 NOR flash memories. It uses the FMC layer functions to interface
- with NOR devices. This driver is used as follows:
- (+) NOR flash memory configuration sequence using the function HAL_NOR_Init()
- with control and timing parameters for both normal and extended mode.
- (+) Read NOR flash memory manufacturer code and device IDs using the function
- HAL_NOR_Read_ID(). The read information is stored in the NOR_ID_TypeDef
- structure declared by the function caller.
- (+) Access NOR flash memory by read/write data unit operations using the functions
- HAL_NOR_Read(), HAL_NOR_Program().
- (+) Perform NOR flash erase block/chip operations using the functions
- HAL_NOR_Erase_Block() and HAL_NOR_Erase_Chip().
- (+) Read the NOR flash CFI (common flash interface) IDs using the function
- HAL_NOR_Read_CFI(). The read information is stored in the NOR_CFI_TypeDef
- structure declared by the function caller.
- (+) You can also control the NOR device by calling the control APIs HAL_NOR_WriteOperation_Enable()/
- HAL_NOR_WriteOperation_Disable() to respectively enable/disable the NOR write operation
- (+) You can monitor the NOR device HAL state by calling the function
- HAL_NOR_GetState()
- [..]
- (@) This driver is a set of generic APIs which handle standard NOR flash operations.
- If a NOR flash device contains different operations and/or implementations,
- it should be implemented separately.
- *** NOR HAL driver macros list ***
- =============================================
- [..]
- Below the list of most used macros in NOR HAL driver.
- (+) NOR_WRITE : NOR memory write data to specified address
- *** Callback registration ***
- =============================================
- [..]
- The compilation define USE_HAL_NOR_REGISTER_CALLBACKS when set to 1
- allows the user to configure dynamically the driver callbacks.
- Use Functions HAL_NOR_RegisterCallback() to register a user callback,
- it allows to register following callbacks:
- (+) MspInitCallback : NOR MspInit.
- (+) MspDeInitCallback : NOR MspDeInit.
- This function takes as parameters the HAL peripheral handle, the Callback ID
- and a pointer to the user callback function.
- Use function HAL_NOR_UnRegisterCallback() to reset a callback to the default
- weak (surcharged) function. It allows to reset following callbacks:
- (+) MspInitCallback : NOR MspInit.
- (+) MspDeInitCallback : NOR MspDeInit.
- This function) takes as parameters the HAL peripheral handle and the Callback ID.
- By default, after the HAL_NOR_Init and if the state is HAL_NOR_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_NOR_Init
- and HAL_NOR_DeInit only when these callbacks are null (not registered beforehand).
- If not, MspInit or MspDeInit are not null, the HAL_NOR_Init and HAL_NOR_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_NOR_RegisterCallback before calling HAL_NOR_DeInit
- or HAL_NOR_Init function.
- When The compilation define USE_HAL_NOR_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 "stm32l4xx_hal.h"
- #if defined(FMC_BANK1)
- /** @addtogroup STM32L4xx_HAL_Driver
- * @{
- */
- #ifdef HAL_NOR_MODULE_ENABLED
- /** @defgroup NOR NOR
- * @brief NOR driver modules
- * @{
- */
- /* Private typedef -----------------------------------------------------------*/
- /* Private define ------------------------------------------------------------*/
- /** @defgroup NOR_Private_Defines NOR Private Defines
- * @{
- */
- /* Constants to define address to set to write a command */
- #define NOR_CMD_ADDRESS_FIRST (uint16_t)0x0555
- #define NOR_CMD_ADDRESS_FIRST_CFI (uint16_t)0x0055
- #define NOR_CMD_ADDRESS_SECOND (uint16_t)0x02AA
- #define NOR_CMD_ADDRESS_THIRD (uint16_t)0x0555
- #define NOR_CMD_ADDRESS_FOURTH (uint16_t)0x0555
- #define NOR_CMD_ADDRESS_FIFTH (uint16_t)0x02AA
- #define NOR_CMD_ADDRESS_SIXTH (uint16_t)0x0555
- /* Constants to define data to program a command */
- #define NOR_CMD_DATA_READ_RESET (uint16_t)0x00F0
- #define NOR_CMD_DATA_FIRST (uint16_t)0x00AA
- #define NOR_CMD_DATA_SECOND (uint16_t)0x0055
- #define NOR_CMD_DATA_AUTO_SELECT (uint16_t)0x0090
- #define NOR_CMD_DATA_PROGRAM (uint16_t)0x00A0
- #define NOR_CMD_DATA_CHIP_BLOCK_ERASE_THIRD (uint16_t)0x0080
- #define NOR_CMD_DATA_CHIP_BLOCK_ERASE_FOURTH (uint16_t)0x00AA
- #define NOR_CMD_DATA_CHIP_BLOCK_ERASE_FIFTH (uint16_t)0x0055
- #define NOR_CMD_DATA_CHIP_ERASE (uint16_t)0x0010
- #define NOR_CMD_DATA_CFI (uint16_t)0x0098
- #define NOR_CMD_DATA_BUFFER_AND_PROG (uint8_t)0x25
- #define NOR_CMD_DATA_BUFFER_AND_PROG_CONFIRM (uint8_t)0x29
- #define NOR_CMD_DATA_BLOCK_ERASE (uint8_t)0x30
- #define NOR_CMD_READ_ARRAY (uint16_t)0x00FF
- #define NOR_CMD_WORD_PROGRAM (uint16_t)0x0040
- #define NOR_CMD_BUFFERED_PROGRAM (uint16_t)0x00E8
- #define NOR_CMD_CONFIRM (uint16_t)0x00D0
- #define NOR_CMD_BLOCK_ERASE (uint16_t)0x0020
- #define NOR_CMD_BLOCK_UNLOCK (uint16_t)0x0060
- #define NOR_CMD_READ_STATUS_REG (uint16_t)0x0070
- #define NOR_CMD_CLEAR_STATUS_REG (uint16_t)0x0050
- /* Mask on NOR STATUS REGISTER */
- #define NOR_MASK_STATUS_DQ4 (uint16_t)0x0010
- #define NOR_MASK_STATUS_DQ5 (uint16_t)0x0020
- #define NOR_MASK_STATUS_DQ6 (uint16_t)0x0040
- #define NOR_MASK_STATUS_DQ7 (uint16_t)0x0080
- /* Address of the primary command set */
- #define NOR_ADDRESS_COMMAND_SET (uint16_t)0x0013
- /* Command set code assignment (defined in JEDEC JEP137B version may 2004) */
- #define NOR_INTEL_SHARP_EXT_COMMAND_SET (uint16_t)0x0001 /* Supported in this driver */
- #define NOR_AMD_FUJITSU_COMMAND_SET (uint16_t)0x0002 /* Supported in this driver */
- #define NOR_INTEL_STANDARD_COMMAND_SET (uint16_t)0x0003 /* Not Supported in this driver */
- #define NOR_AMD_FUJITSU_EXT_COMMAND_SET (uint16_t)0x0004 /* Not Supported in this driver */
- #define NOR_WINDBOND_STANDARD_COMMAND_SET (uint16_t)0x0006 /* Not Supported in this driver */
- #define NOR_MITSUBISHI_STANDARD_COMMAND_SET (uint16_t)0x0100 /* Not Supported in this driver */
- #define NOR_MITSUBISHI_EXT_COMMAND_SET (uint16_t)0x0101 /* Not Supported in this driver */
- #define NOR_PAGE_WRITE_COMMAND_SET (uint16_t)0x0102 /* Not Supported in this driver */
- #define NOR_INTEL_PERFORMANCE_COMMAND_SET (uint16_t)0x0200 /* Not Supported in this driver */
- #define NOR_INTEL_DATA_COMMAND_SET (uint16_t)0x0210 /* Not Supported in this driver */
- /**
- * @}
- */
- /* Private macro -------------------------------------------------------------*/
- /* Private variables ---------------------------------------------------------*/
- /** @defgroup NOR_Private_Variables NOR Private Variables
- * @{
- */
- static uint32_t uwNORMemoryDataWidth = NOR_MEMORY_8B;
- /**
- * @}
- */
- /* Private functions ---------------------------------------------------------*/
- /* Exported functions --------------------------------------------------------*/
- /** @defgroup NOR_Exported_Functions NOR Exported Functions
- * @{
- */
- /** @defgroup NOR_Exported_Functions_Group1 Initialization and de-initialization functions
- * @brief Initialization and Configuration functions
- *
- @verbatim
- ==============================================================================
- ##### NOR Initialization and de_initialization functions #####
- ==============================================================================
- [..]
- This section provides functions allowing to initialize/de-initialize
- the NOR memory
- @endverbatim
- * @{
- */
- /**
- * @brief Perform the NOR memory Initialization sequence
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @param Timing pointer to NOR control timing structure
- * @param ExtTiming pointer to NOR extended mode timing structure
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_Init(NOR_HandleTypeDef *hnor, FMC_NORSRAM_TimingTypeDef *Timing,
- FMC_NORSRAM_TimingTypeDef *ExtTiming)
- {
- uint32_t deviceaddress;
- HAL_StatusTypeDef status = HAL_OK;
- /* Check the NOR handle parameter */
- if (hnor == NULL)
- {
- return HAL_ERROR;
- }
- if (hnor->State == HAL_NOR_STATE_RESET)
- {
- /* Allocate lock resource and initialize it */
- hnor->Lock = HAL_UNLOCKED;
- #if (USE_HAL_NOR_REGISTER_CALLBACKS == 1)
- if (hnor->MspInitCallback == NULL)
- {
- hnor->MspInitCallback = HAL_NOR_MspInit;
- }
- /* Init the low level hardware */
- hnor->MspInitCallback(hnor);
- #else
- /* Initialize the low level hardware (MSP) */
- HAL_NOR_MspInit(hnor);
- #endif /* (USE_HAL_NOR_REGISTER_CALLBACKS) */
- }
- /* Initialize NOR control Interface */
- (void)FMC_NORSRAM_Init(hnor->Instance, &(hnor->Init));
- /* Initialize NOR timing Interface */
- (void)FMC_NORSRAM_Timing_Init(hnor->Instance, Timing, hnor->Init.NSBank);
- /* Initialize NOR extended mode timing Interface */
- (void)FMC_NORSRAM_Extended_Timing_Init(hnor->Extended, ExtTiming, hnor->Init.NSBank, hnor->Init.ExtendedMode);
- /* Enable the NORSRAM device */
- __FMC_NORSRAM_ENABLE(hnor->Instance, hnor->Init.NSBank);
- /* Initialize NOR Memory Data Width*/
- if (hnor->Init.MemoryDataWidth == FMC_NORSRAM_MEM_BUS_WIDTH_8)
- {
- uwNORMemoryDataWidth = NOR_MEMORY_8B;
- }
- else
- {
- uwNORMemoryDataWidth = NOR_MEMORY_16B;
- }
- /* Initialize the NOR controller state */
- hnor->State = HAL_NOR_STATE_READY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- if (hnor->Init.WriteOperation == FMC_WRITE_OPERATION_DISABLE)
- {
- (void)FMC_NORSRAM_WriteOperation_Disable(hnor->Instance, hnor->Init.NSBank);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_PROTECTED;
- }
- else
- {
- /* Get the value of the command set */
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIRST_CFI), NOR_CMD_DATA_CFI);
- hnor->CommandSet = *(__IO uint16_t *) NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_ADDRESS_COMMAND_SET);
- status = HAL_NOR_ReturnToReadMode(hnor);
- }
- return status;
- }
- /**
- * @brief Perform NOR memory De-Initialization sequence
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_DeInit(NOR_HandleTypeDef *hnor)
- {
- #if (USE_HAL_NOR_REGISTER_CALLBACKS == 1)
- if (hnor->MspDeInitCallback == NULL)
- {
- hnor->MspDeInitCallback = HAL_NOR_MspDeInit;
- }
- /* DeInit the low level hardware */
- hnor->MspDeInitCallback(hnor);
- #else
- /* De-Initialize the low level hardware (MSP) */
- HAL_NOR_MspDeInit(hnor);
- #endif /* (USE_HAL_NOR_REGISTER_CALLBACKS) */
- /* Configure the NOR registers with their reset values */
- (void)FMC_NORSRAM_DeInit(hnor->Instance, hnor->Extended, hnor->Init.NSBank);
- /* Reset the NOR controller state */
- hnor->State = HAL_NOR_STATE_RESET;
- /* Release Lock */
- __HAL_UNLOCK(hnor);
- return HAL_OK;
- }
- /**
- * @brief NOR MSP Init
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @retval None
- */
- __weak void HAL_NOR_MspInit(NOR_HandleTypeDef *hnor)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hnor);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_NOR_MspInit could be implemented in the user file
- */
- }
- /**
- * @brief NOR MSP DeInit
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @retval None
- */
- __weak void HAL_NOR_MspDeInit(NOR_HandleTypeDef *hnor)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hnor);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_NOR_MspDeInit could be implemented in the user file
- */
- }
- /**
- * @brief NOR MSP Wait for Ready/Busy signal
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @param Timeout Maximum timeout value
- * @retval None
- */
- __weak void HAL_NOR_MspWait(NOR_HandleTypeDef *hnor, uint32_t Timeout)
- {
- /* Prevent unused argument(s) compilation warning */
- UNUSED(hnor);
- UNUSED(Timeout);
- /* NOTE : This function Should not be modified, when the callback is needed,
- the HAL_NOR_MspWait could be implemented in the user file
- */
- }
- /**
- * @}
- */
- /** @defgroup NOR_Exported_Functions_Group2 Input and Output functions
- * @brief Input Output and memory control functions
- *
- @verbatim
- ==============================================================================
- ##### NOR Input and Output functions #####
- ==============================================================================
- [..]
- This section provides functions allowing to use and control the NOR memory
- @endverbatim
- * @{
- */
- /**
- * @brief Read NOR flash IDs
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @param pNOR_ID pointer to NOR ID structure
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_Read_ID(NOR_HandleTypeDef *hnor, NOR_IDTypeDef *pNOR_ID)
- {
- uint32_t deviceaddress;
- HAL_NOR_StateTypeDef state;
- HAL_StatusTypeDef status = HAL_OK;
- /* Check the NOR controller state */
- state = hnor->State;
- if (state == HAL_NOR_STATE_BUSY)
- {
- return HAL_BUSY;
- }
- else if (state == HAL_NOR_STATE_PROTECTED)
- {
- return HAL_ERROR;
- }
- else if (state == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- /* Send read ID command */
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIRST), NOR_CMD_DATA_FIRST);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_SECOND), NOR_CMD_DATA_SECOND);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_THIRD), NOR_CMD_DATA_AUTO_SELECT);
- }
- else if (hnor->CommandSet == NOR_INTEL_SHARP_EXT_COMMAND_SET)
- {
- NOR_WRITE(deviceaddress, NOR_CMD_DATA_AUTO_SELECT);
- }
- else
- {
- /* Primary command set not supported by the driver */
- status = HAL_ERROR;
- }
- if (status != HAL_ERROR)
- {
- /* Read the NOR IDs */
- pNOR_ID->Manufacturer_Code = *(__IO uint16_t *) NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, MC_ADDRESS);
- pNOR_ID->Device_Code1 = *(__IO uint16_t *) NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth,
- DEVICE_CODE1_ADDR);
- pNOR_ID->Device_Code2 = *(__IO uint16_t *) NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth,
- DEVICE_CODE2_ADDR);
- pNOR_ID->Device_Code3 = *(__IO uint16_t *) NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth,
- DEVICE_CODE3_ADDR);
- }
- /* Check the NOR controller state */
- hnor->State = state;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return status;
- }
- /**
- * @brief Returns the NOR memory to Read mode.
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_ReturnToReadMode(NOR_HandleTypeDef *hnor)
- {
- uint32_t deviceaddress;
- HAL_NOR_StateTypeDef state;
- HAL_StatusTypeDef status = HAL_OK;
- /* Check the NOR controller state */
- state = hnor->State;
- if (state == HAL_NOR_STATE_BUSY)
- {
- return HAL_BUSY;
- }
- else if (state == HAL_NOR_STATE_PROTECTED)
- {
- return HAL_ERROR;
- }
- else if (state == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- NOR_WRITE(deviceaddress, NOR_CMD_DATA_READ_RESET);
- }
- else if (hnor->CommandSet == NOR_INTEL_SHARP_EXT_COMMAND_SET)
- {
- NOR_WRITE(deviceaddress, NOR_CMD_READ_ARRAY);
- }
- else
- {
- /* Primary command set not supported by the driver */
- status = HAL_ERROR;
- }
- /* Check the NOR controller state */
- hnor->State = state;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return status;
- }
- /**
- * @brief Read data from NOR memory
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @param pAddress pointer to Device address
- * @param pData pointer to read data
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_Read(NOR_HandleTypeDef *hnor, uint32_t *pAddress, uint16_t *pData)
- {
- uint32_t deviceaddress;
- HAL_NOR_StateTypeDef state;
- HAL_StatusTypeDef status = HAL_OK;
- /* Check the NOR controller state */
- state = hnor->State;
- if (state == HAL_NOR_STATE_BUSY)
- {
- return HAL_BUSY;
- }
- else if (state == HAL_NOR_STATE_PROTECTED)
- {
- return HAL_ERROR;
- }
- else if (state == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- /* Send read data command */
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIRST), NOR_CMD_DATA_FIRST);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_SECOND), NOR_CMD_DATA_SECOND);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_THIRD), NOR_CMD_DATA_READ_RESET);
- }
- else if (hnor->CommandSet == NOR_INTEL_SHARP_EXT_COMMAND_SET)
- {
- NOR_WRITE(pAddress, NOR_CMD_READ_ARRAY);
- }
- else
- {
- /* Primary command set not supported by the driver */
- status = HAL_ERROR;
- }
- if (status != HAL_ERROR)
- {
- /* Read the data */
- *pData = (uint16_t)(*(__IO uint32_t *)pAddress);
- }
- /* Check the NOR controller state */
- hnor->State = state;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return status;
- }
- /**
- * @brief Program data to NOR memory
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @param pAddress Device address
- * @param pData pointer to the data to write
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_Program(NOR_HandleTypeDef *hnor, uint32_t *pAddress, uint16_t *pData)
- {
- uint32_t deviceaddress;
- HAL_StatusTypeDef status = HAL_OK;
- /* Check the NOR controller state */
- if (hnor->State == HAL_NOR_STATE_BUSY)
- {
- return HAL_BUSY;
- }
- else if (hnor->State == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- /* Send program data command */
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIRST), NOR_CMD_DATA_FIRST);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_SECOND), NOR_CMD_DATA_SECOND);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_THIRD), NOR_CMD_DATA_PROGRAM);
- }
- else if (hnor->CommandSet == NOR_INTEL_SHARP_EXT_COMMAND_SET)
- {
- NOR_WRITE(pAddress, NOR_CMD_WORD_PROGRAM);
- }
- else
- {
- /* Primary command set not supported by the driver */
- status = HAL_ERROR;
- }
- if (status != HAL_ERROR)
- {
- /* Write the data */
- NOR_WRITE(pAddress, *pData);
- }
- /* Check the NOR controller state */
- hnor->State = HAL_NOR_STATE_READY;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return status;
- }
- /**
- * @brief Reads a half-word buffer from the NOR memory.
- * @param hnor pointer to the NOR handle
- * @param uwAddress NOR memory internal address to read from.
- * @param pData pointer to the buffer that receives the data read from the
- * NOR memory.
- * @param uwBufferSize number of Half word to read.
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_ReadBuffer(NOR_HandleTypeDef *hnor, uint32_t uwAddress, uint16_t *pData,
- uint32_t uwBufferSize)
- {
- uint32_t deviceaddress;
- uint32_t size = uwBufferSize;
- uint32_t address = uwAddress;
- uint16_t *data = pData;
- HAL_NOR_StateTypeDef state;
- HAL_StatusTypeDef status = HAL_OK;
- /* Check the NOR controller state */
- state = hnor->State;
- if (state == HAL_NOR_STATE_BUSY)
- {
- return HAL_BUSY;
- }
- else if (state == HAL_NOR_STATE_PROTECTED)
- {
- return HAL_ERROR;
- }
- else if (state == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- /* Send read data command */
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIRST), NOR_CMD_DATA_FIRST);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_SECOND), NOR_CMD_DATA_SECOND);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_THIRD), NOR_CMD_DATA_READ_RESET);
- }
- else if (hnor->CommandSet == NOR_INTEL_SHARP_EXT_COMMAND_SET)
- {
- NOR_WRITE(deviceaddress, NOR_CMD_READ_ARRAY);
- }
- else
- {
- /* Primary command set not supported by the driver */
- status = HAL_ERROR;
- }
- if (status != HAL_ERROR)
- {
- /* Read buffer */
- while (size > 0U)
- {
- *data = *(__IO uint16_t *)address;
- data++;
- address += 2U;
- size--;
- }
- }
- /* Check the NOR controller state */
- hnor->State = state;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return status;
- }
- /**
- * @brief Writes a half-word buffer to the NOR memory. This function must be used
- only with S29GL128P NOR memory.
- * @param hnor pointer to the NOR handle
- * @param uwAddress NOR memory internal start write address
- * @param pData pointer to source data buffer.
- * @param uwBufferSize Size of the buffer to write
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_ProgramBuffer(NOR_HandleTypeDef *hnor, uint32_t uwAddress, uint16_t *pData,
- uint32_t uwBufferSize)
- {
- uint16_t *p_currentaddress;
- const uint16_t *p_endaddress;
- uint16_t *data = pData;
- uint32_t deviceaddress;
- HAL_StatusTypeDef status = HAL_OK;
- /* Check the NOR controller state */
- if (hnor->State == HAL_NOR_STATE_BUSY)
- {
- return HAL_BUSY;
- }
- else if (hnor->State == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- /* Initialize variables */
- p_currentaddress = (uint16_t *)(deviceaddress + uwAddress);
- p_endaddress = (uint16_t *)(deviceaddress + uwAddress + (2U * (uwBufferSize - 1U)));
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- /* Issue unlock command sequence */
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIRST), NOR_CMD_DATA_FIRST);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_SECOND), NOR_CMD_DATA_SECOND);
- /* Write Buffer Load Command */
- NOR_WRITE((deviceaddress + uwAddress), NOR_CMD_DATA_BUFFER_AND_PROG);
- NOR_WRITE((deviceaddress + uwAddress), (uint16_t)(uwBufferSize - 1U));
- }
- else if (hnor->CommandSet == NOR_INTEL_SHARP_EXT_COMMAND_SET)
- {
- /* Write Buffer Load Command */
- NOR_WRITE((deviceaddress + uwAddress), NOR_CMD_BUFFERED_PROGRAM);
- NOR_WRITE((deviceaddress + uwAddress), (uint16_t)(uwBufferSize - 1U));
- }
- else
- {
- /* Primary command set not supported by the driver */
- status = HAL_ERROR;
- }
- if (status != HAL_ERROR)
- {
- /* Load Data into NOR Buffer */
- while (p_currentaddress <= p_endaddress)
- {
- NOR_WRITE(p_currentaddress, *data);
- data++;
- p_currentaddress ++;
- }
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- NOR_WRITE((deviceaddress + uwAddress), NOR_CMD_DATA_BUFFER_AND_PROG_CONFIRM);
- }
- else /* => hnor->CommandSet == NOR_INTEL_SHARP_EXT_COMMAND_SET */
- {
- NOR_WRITE((deviceaddress + uwAddress), NOR_CMD_CONFIRM);
- }
- }
- /* Check the NOR controller state */
- hnor->State = HAL_NOR_STATE_READY;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return status;
- }
- /**
- * @brief Erase the specified block of the NOR memory
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @param BlockAddress Block to erase address
- * @param Address Device address
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_Erase_Block(NOR_HandleTypeDef *hnor, uint32_t BlockAddress, uint32_t Address)
- {
- uint32_t deviceaddress;
- HAL_StatusTypeDef status = HAL_OK;
- /* Check the NOR controller state */
- if (hnor->State == HAL_NOR_STATE_BUSY)
- {
- return HAL_BUSY;
- }
- else if (hnor->State == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- /* Send block erase command sequence */
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIRST), NOR_CMD_DATA_FIRST);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_SECOND), NOR_CMD_DATA_SECOND);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_THIRD),
- NOR_CMD_DATA_CHIP_BLOCK_ERASE_THIRD);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FOURTH),
- NOR_CMD_DATA_CHIP_BLOCK_ERASE_FOURTH);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIFTH),
- NOR_CMD_DATA_CHIP_BLOCK_ERASE_FIFTH);
- NOR_WRITE((uint32_t)(BlockAddress + Address), NOR_CMD_DATA_BLOCK_ERASE);
- }
- else if (hnor->CommandSet == NOR_INTEL_SHARP_EXT_COMMAND_SET)
- {
- NOR_WRITE((BlockAddress + Address), NOR_CMD_BLOCK_UNLOCK);
- NOR_WRITE((BlockAddress + Address), NOR_CMD_CONFIRM);
- NOR_WRITE((BlockAddress + Address), NOR_CMD_BLOCK_ERASE);
- NOR_WRITE((BlockAddress + Address), NOR_CMD_CONFIRM);
- }
- else
- {
- /* Primary command set not supported by the driver */
- status = HAL_ERROR;
- }
- /* Check the NOR memory status and update the controller state */
- hnor->State = HAL_NOR_STATE_READY;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return status;
- }
- /**
- * @brief Erase the entire NOR chip.
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @param Address Device address
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_Erase_Chip(NOR_HandleTypeDef *hnor, uint32_t Address)
- {
- uint32_t deviceaddress;
- HAL_StatusTypeDef status = HAL_OK;
- UNUSED(Address);
- /* Check the NOR controller state */
- if (hnor->State == HAL_NOR_STATE_BUSY)
- {
- return HAL_BUSY;
- }
- else if (hnor->State == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- /* Send NOR chip erase command sequence */
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIRST), NOR_CMD_DATA_FIRST);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_SECOND), NOR_CMD_DATA_SECOND);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_THIRD),
- NOR_CMD_DATA_CHIP_BLOCK_ERASE_THIRD);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FOURTH),
- NOR_CMD_DATA_CHIP_BLOCK_ERASE_FOURTH);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIFTH),
- NOR_CMD_DATA_CHIP_BLOCK_ERASE_FIFTH);
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_SIXTH), NOR_CMD_DATA_CHIP_ERASE);
- }
- else
- {
- /* Primary command set not supported by the driver */
- status = HAL_ERROR;
- }
- /* Check the NOR memory status and update the controller state */
- hnor->State = HAL_NOR_STATE_READY;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return status;
- }
- /**
- * @brief Read NOR flash CFI IDs
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @param pNOR_CFI pointer to NOR CFI IDs structure
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_Read_CFI(NOR_HandleTypeDef *hnor, NOR_CFITypeDef *pNOR_CFI)
- {
- uint32_t deviceaddress;
- HAL_NOR_StateTypeDef state;
- /* Check the NOR controller state */
- state = hnor->State;
- if (state == HAL_NOR_STATE_BUSY)
- {
- return HAL_BUSY;
- }
- else if (state == HAL_NOR_STATE_PROTECTED)
- {
- return HAL_ERROR;
- }
- else if (state == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Select the NOR device address */
- if (hnor->Init.NSBank == FMC_NORSRAM_BANK1)
- {
- deviceaddress = NOR_MEMORY_ADRESS1;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK2)
- {
- deviceaddress = NOR_MEMORY_ADRESS2;
- }
- else if (hnor->Init.NSBank == FMC_NORSRAM_BANK3)
- {
- deviceaddress = NOR_MEMORY_ADRESS3;
- }
- else /* FMC_NORSRAM_BANK4 */
- {
- deviceaddress = NOR_MEMORY_ADRESS4;
- }
- /* Send read CFI query command */
- NOR_WRITE(NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, NOR_CMD_ADDRESS_FIRST_CFI), NOR_CMD_DATA_CFI);
- /* read the NOR CFI information */
- pNOR_CFI->CFI_1 = *(__IO uint16_t *) NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, CFI1_ADDRESS);
- pNOR_CFI->CFI_2 = *(__IO uint16_t *) NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, CFI2_ADDRESS);
- pNOR_CFI->CFI_3 = *(__IO uint16_t *) NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, CFI3_ADDRESS);
- pNOR_CFI->CFI_4 = *(__IO uint16_t *) NOR_ADDR_SHIFT(deviceaddress, uwNORMemoryDataWidth, CFI4_ADDRESS);
- /* Check the NOR controller state */
- hnor->State = state;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return HAL_OK;
- }
- #if (USE_HAL_NOR_REGISTER_CALLBACKS == 1)
- /**
- * @brief Register a User NOR Callback
- * To be used instead of the weak (surcharged) predefined callback
- * @param hnor : NOR handle
- * @param CallbackId : ID of the callback to be registered
- * This parameter can be one of the following values:
- * @arg @ref HAL_NOR_MSP_INIT_CB_ID NOR MspInit callback ID
- * @arg @ref HAL_NOR_MSP_DEINIT_CB_ID NOR MspDeInit callback ID
- * @param pCallback : pointer to the Callback function
- * @retval status
- */
- HAL_StatusTypeDef HAL_NOR_RegisterCallback(NOR_HandleTypeDef *hnor, HAL_NOR_CallbackIDTypeDef CallbackId,
- pNOR_CallbackTypeDef pCallback)
- {
- HAL_StatusTypeDef status = HAL_OK;
- HAL_NOR_StateTypeDef state;
- if (pCallback == NULL)
- {
- return HAL_ERROR;
- }
- /* Process locked */
- __HAL_LOCK(hnor);
- state = hnor->State;
- if ((state == HAL_NOR_STATE_READY) || (state == HAL_NOR_STATE_RESET) || (state == HAL_NOR_STATE_PROTECTED))
- {
- switch (CallbackId)
- {
- case HAL_NOR_MSP_INIT_CB_ID :
- hnor->MspInitCallback = pCallback;
- break;
- case HAL_NOR_MSP_DEINIT_CB_ID :
- hnor->MspDeInitCallback = pCallback;
- break;
- default :
- /* update return status */
- status = HAL_ERROR;
- break;
- }
- }
- else
- {
- /* update return status */
- status = HAL_ERROR;
- }
- /* Release Lock */
- __HAL_UNLOCK(hnor);
- return status;
- }
- /**
- * @brief Unregister a User NOR Callback
- * NOR Callback is redirected to the weak (surcharged) predefined callback
- * @param hnor : NOR handle
- * @param CallbackId : ID of the callback to be unregistered
- * This parameter can be one of the following values:
- * @arg @ref HAL_NOR_MSP_INIT_CB_ID NOR MspInit callback ID
- * @arg @ref HAL_NOR_MSP_DEINIT_CB_ID NOR MspDeInit callback ID
- * @retval status
- */
- HAL_StatusTypeDef HAL_NOR_UnRegisterCallback(NOR_HandleTypeDef *hnor, HAL_NOR_CallbackIDTypeDef CallbackId)
- {
- HAL_StatusTypeDef status = HAL_OK;
- HAL_NOR_StateTypeDef state;
- /* Process locked */
- __HAL_LOCK(hnor);
- state = hnor->State;
- if ((state == HAL_NOR_STATE_READY) || (state == HAL_NOR_STATE_RESET) || (state == HAL_NOR_STATE_PROTECTED))
- {
- switch (CallbackId)
- {
- case HAL_NOR_MSP_INIT_CB_ID :
- hnor->MspInitCallback = HAL_NOR_MspInit;
- break;
- case HAL_NOR_MSP_DEINIT_CB_ID :
- hnor->MspDeInitCallback = HAL_NOR_MspDeInit;
- break;
- default :
- /* update return status */
- status = HAL_ERROR;
- break;
- }
- }
- else
- {
- /* update return status */
- status = HAL_ERROR;
- }
- /* Release Lock */
- __HAL_UNLOCK(hnor);
- return status;
- }
- #endif /* (USE_HAL_NOR_REGISTER_CALLBACKS) */
- /**
- * @}
- */
- /** @defgroup NOR_Exported_Functions_Group3 NOR Control functions
- * @brief management functions
- *
- @verbatim
- ==============================================================================
- ##### NOR Control functions #####
- ==============================================================================
- [..]
- This subsection provides a set of functions allowing to control dynamically
- the NOR interface.
- @endverbatim
- * @{
- */
- /**
- * @brief Enables dynamically NOR write operation.
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_WriteOperation_Enable(NOR_HandleTypeDef *hnor)
- {
- /* Check the NOR controller state */
- if (hnor->State == HAL_NOR_STATE_PROTECTED)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Enable write operation */
- (void)FMC_NORSRAM_WriteOperation_Enable(hnor->Instance, hnor->Init.NSBank);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_READY;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return HAL_OK;
- }
- /**
- * @brief Disables dynamically NOR write operation.
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_NOR_WriteOperation_Disable(NOR_HandleTypeDef *hnor)
- {
- /* Check the NOR controller state */
- if (hnor->State == HAL_NOR_STATE_READY)
- {
- /* Process Locked */
- __HAL_LOCK(hnor);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_BUSY;
- /* Disable write operation */
- (void)FMC_NORSRAM_WriteOperation_Disable(hnor->Instance, hnor->Init.NSBank);
- /* Update the NOR controller state */
- hnor->State = HAL_NOR_STATE_PROTECTED;
- /* Process unlocked */
- __HAL_UNLOCK(hnor);
- }
- else
- {
- return HAL_ERROR;
- }
- return HAL_OK;
- }
- /**
- * @}
- */
- /** @defgroup NOR_Exported_Functions_Group4 NOR State functions
- * @brief Peripheral State functions
- *
- @verbatim
- ==============================================================================
- ##### NOR State functions #####
- ==============================================================================
- [..]
- This subsection permits to get in run-time the status of the NOR controller
- and the data flow.
- @endverbatim
- * @{
- */
- /**
- * @brief return the NOR controller state
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @retval NOR controller state
- */
- HAL_NOR_StateTypeDef HAL_NOR_GetState(NOR_HandleTypeDef *hnor)
- {
- return hnor->State;
- }
- /**
- * @brief Returns the NOR operation status.
- * @param hnor pointer to a NOR_HandleTypeDef structure that contains
- * the configuration information for NOR module.
- * @param Address Device address
- * @param Timeout NOR programming Timeout
- * @retval NOR_Status The returned value can be: HAL_NOR_STATUS_SUCCESS, HAL_NOR_STATUS_ERROR
- * or HAL_NOR_STATUS_TIMEOUT
- */
- HAL_NOR_StatusTypeDef HAL_NOR_GetStatus(NOR_HandleTypeDef *hnor, uint32_t Address, uint32_t Timeout)
- {
- HAL_NOR_StatusTypeDef status = HAL_NOR_STATUS_ONGOING;
- uint16_t tmpsr1;
- uint16_t tmpsr2;
- uint32_t tickstart;
- /* Poll on NOR memory Ready/Busy signal ------------------------------------*/
- HAL_NOR_MspWait(hnor, Timeout);
- /* Get the NOR memory operation status -------------------------------------*/
- /* Get tick */
- tickstart = HAL_GetTick();
- if (hnor->CommandSet == NOR_AMD_FUJITSU_COMMAND_SET)
- {
- while ((status != HAL_NOR_STATUS_SUCCESS) && (status != HAL_NOR_STATUS_TIMEOUT))
- {
- /* Check for the Timeout */
- if (Timeout != HAL_MAX_DELAY)
- {
- if (((HAL_GetTick() - tickstart) > Timeout) || (Timeout == 0U))
- {
- status = HAL_NOR_STATUS_TIMEOUT;
- }
- }
- /* Read NOR status register (DQ6 and DQ5) */
- tmpsr1 = *(__IO uint16_t *)Address;
- tmpsr2 = *(__IO uint16_t *)Address;
- /* If DQ6 did not toggle between the two reads then return HAL_NOR_STATUS_SUCCESS */
- if ((tmpsr1 & NOR_MASK_STATUS_DQ6) == (tmpsr2 & NOR_MASK_STATUS_DQ6))
- {
- return HAL_NOR_STATUS_SUCCESS ;
- }
- if ((tmpsr1 & NOR_MASK_STATUS_DQ5) == NOR_MASK_STATUS_DQ5)
- {
- status = HAL_NOR_STATUS_ONGOING;
- }
- tmpsr1 = *(__IO uint16_t *)Address;
- tmpsr2 = *(__IO uint16_t *)Address;
- /* If DQ6 did not toggle between the two reads then return HAL_NOR_STATUS_SUCCESS */
- if ((tmpsr1 & NOR_MASK_STATUS_DQ6) == (tmpsr2 & NOR_MASK_STATUS_DQ6))
- {
- return HAL_NOR_STATUS_SUCCESS;
- }
- if ((tmpsr1 & NOR_MASK_STATUS_DQ5) == NOR_MASK_STATUS_DQ5)
- {
- return HAL_NOR_STATUS_ERROR;
- }
- }
- }
- else if (hnor->CommandSet == NOR_INTEL_SHARP_EXT_COMMAND_SET)
- {
- do
- {
- NOR_WRITE(Address, NOR_CMD_READ_STATUS_REG);
- tmpsr2 = *(__IO uint16_t *)(Address);
- /* Check for the Timeout */
- if (Timeout != HAL_MAX_DELAY)
- {
- if (((HAL_GetTick() - tickstart) > Timeout) || (Timeout == 0U))
- {
- return HAL_NOR_STATUS_TIMEOUT;
- }
- }
- } while ((tmpsr2 & NOR_MASK_STATUS_DQ7) == 0U);
- NOR_WRITE(Address, NOR_CMD_READ_STATUS_REG);
- tmpsr1 = *(__IO uint16_t *)(Address);
- if ((tmpsr1 & (NOR_MASK_STATUS_DQ5 | NOR_MASK_STATUS_DQ4)) != 0U)
- {
- /* Clear the Status Register */
- NOR_WRITE(Address, NOR_CMD_READ_STATUS_REG);
- status = HAL_NOR_STATUS_ERROR;
- }
- else
- {
- status = HAL_NOR_STATUS_SUCCESS;
- }
- }
- else
- {
- /* Primary command set not supported by the driver */
- status = HAL_NOR_STATUS_ERROR;
- }
- /* Return the operation status */
- return status;
- }
- /**
- * @}
- */
- /**
- * @}
- */
- /**
- * @}
- */
- #endif /* HAL_NOR_MODULE_ENABLED */
- /**
- * @}
- */
- #endif /* FMC_BANK1 */
|