FLASH Exported Functions

Collaboration diagram for FLASH Exported Functions:

Modules
	Programming operation functions
	Programming operation functions.
	Peripheral Control functions
	management functions
	Peripheral State and Errors functions
	Peripheral Errors functions.

Functions
HAL_StatusTypeDef	FLASH_WaitForLastOperation (uint32_t Timeout)
	Wait for a FLASH operation to complete.
static void	FLASH_Program_DoubleWord (uint32_t Address, uint64_t Data)
	Program a double word (64-bit) at a specified address.
static void	FLASH_Program_Word (uint32_t Address, uint32_t Data)
	Program word (32-bit) at a specified address.
static void	FLASH_Program_HalfWord (uint32_t Address, uint16_t Data)
	Program a half-word (16-bit) at a specified address.
static void	FLASH_Program_Byte (uint32_t Address, uint8_t Data)
	Program byte (8-bit) at a specified address.
static void	FLASH_SetErrorCode (void)
	Set the specific FLASH error flag.

Detailed Description

Function Documentation

FLASH_Program_Byte()

static void FLASH_Program_Byte ( uint32_t  Address, uint8_t  Data  )

static

Program byte (8-bit) at a specified address.

Note

This function must be used when the device voltage range is from 2.7V to 3.6V.

If an erase and a program operations are requested simultaneously,
the erase operation is performed before the program one.

Parameters

Address	specifies the address to be programmed.
Data	specifies the data to be programmed.

Return values

None

Definition at line 767 of file stm32f7xx_hal_flash.c.

{
  /* Check the parameters */
  assert_param(IS_FLASH_ADDRESS(Address));
  
  /* If the previous operation is completed, proceed to program the new data */
  FLASH->CR &= CR_PSIZE_MASK;
  FLASH->CR |= FLASH_PSIZE_BYTE;
  FLASH->CR |= FLASH_CR_PG;
 
  *(__IO uint8_t*)Address = Data;
 
  /* Data synchronous Barrier (DSB) Just after the write operation
     This will force the CPU to respect the sequence of instruction (no optimization).*/
  __DSB();
}

FLASH_Program_DoubleWord()

static void FLASH_Program_DoubleWord ( uint32_t  Address, uint64_t  Data  )

static

Program a double word (64-bit) at a specified address.

Note

This function must be used when the device voltage range is from 2.7V to 3.6V and an External Vpp is present.

If an erase and a program operations are requested simultaneously,
the erase operation is performed before the program one.

Parameters

Address	specifies the address to be programmed.
Data	specifies the data to be programmed.

Return values

None

Definition at line 678 of file stm32f7xx_hal_flash.c.

{
  /* Check the parameters */
  assert_param(IS_FLASH_ADDRESS(Address));
  
  /* If the previous operation is completed, proceed to program the new data */
  FLASH->CR &= CR_PSIZE_MASK;
  FLASH->CR |= FLASH_PSIZE_DOUBLE_WORD;
  FLASH->CR |= FLASH_CR_PG;
  
  *(__IO uint64_t*)Address = Data;
  
  /* Data synchronous Barrier (DSB) Just after the write operation
     This will force the CPU to respect the sequence of instruction (no optimization).*/
  __DSB();
}

FLASH_Program_HalfWord()

static void FLASH_Program_HalfWord ( uint32_t  Address, uint16_t  Data  )

static

Program a half-word (16-bit) at a specified address.

Note

This function must be used when the device voltage range is from 2.7V to 3.6V.

If an erase and a program operations are requested simultaneously,
the erase operation is performed before the program one.

Parameters

Address	specifies the address to be programmed.
Data	specifies the data to be programmed.

Return values

None

Definition at line 737 of file stm32f7xx_hal_flash.c.

{
  /* Check the parameters */
  assert_param(IS_FLASH_ADDRESS(Address));
  
  /* If the previous operation is completed, proceed to program the new data */
  FLASH->CR &= CR_PSIZE_MASK;
  FLASH->CR |= FLASH_PSIZE_HALF_WORD;
  FLASH->CR |= FLASH_CR_PG;
 
  *(__IO uint16_t*)Address = Data;
 
  /* Data synchronous Barrier (DSB) Just after the write operation
     This will force the CPU to respect the sequence of instruction (no optimization).*/
  __DSB();
  
}

FLASH_Program_Word()

static void FLASH_Program_Word ( uint32_t  Address, uint32_t  Data  )

static

Program word (32-bit) at a specified address.

Note

This function must be used when the device voltage range is from 2.7V to 3.6V.

If an erase and a program operations are requested simultaneously,
the erase operation is performed before the program one.

Parameters

Address	specifies the address to be programmed.
Data	specifies the data to be programmed.

Return values

None

Definition at line 708 of file stm32f7xx_hal_flash.c.

{
  /* Check the parameters */
  assert_param(IS_FLASH_ADDRESS(Address));
  
  /* If the previous operation is completed, proceed to program the new data */
  FLASH->CR &= CR_PSIZE_MASK;
  FLASH->CR |= FLASH_PSIZE_WORD;
  FLASH->CR |= FLASH_CR_PG;
 
  *(__IO uint32_t*)Address = Data;
  
  /* Data synchronous Barrier (DSB) Just after the write operation
     This will force the CPU to respect the sequence of instruction (no optimization).*/
  __DSB();
}

FLASH_SetErrorCode()

static void FLASH_SetErrorCode ( void  )

static

Set the specific FLASH error flag.

Return values

None

Definition at line 788 of file stm32f7xx_hal_flash.c.

{
  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_OPERR) != RESET)
  {
    pFlash.ErrorCode |= HAL_FLASH_ERROR_OPERATION;
  }
  
  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_WRPERR) != RESET)
  {
   pFlash.ErrorCode |= HAL_FLASH_ERROR_WRP;
  }
  
  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGAERR) != RESET)
  {
   pFlash.ErrorCode |= HAL_FLASH_ERROR_PGA;
  }
  
  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_PGPERR) != RESET)
  {
    pFlash.ErrorCode |= HAL_FLASH_ERROR_PGP;
  }
  
  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_ERSERR) != RESET)
  {
    pFlash.ErrorCode |= HAL_FLASH_ERROR_ERS;
  }
  
#if defined (FLASH_OPTCR2_PCROP)
  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_RDERR) != RESET)
  { 
   pFlash.ErrorCode |= HAL_FLASH_ERROR_RD;
  }  
#endif /* FLASH_OPTCR2_PCROP */
  
  /* Clear error programming flags */
  __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_ALL_ERRORS);
}

Referenced by FLASH_WaitForLastOperation().

Here is the caller graph for this function:

FLASH_WaitForLastOperation()

HAL_StatusTypeDef FLASH_WaitForLastOperation

(

uint32_t

Timeout

)

Wait for a FLASH operation to complete.

Parameters

Timeout

maximum flash operationtimeout

Return values

HAL

Status

Definition at line 618 of file stm32f7xx_hal_flash.c.

{
  (void)Timeout;
  //uint32_t tickstart = 0;
  
  /* Clear Error Code */
  pFlash.ErrorCode = HAL_FLASH_ERROR_NONE;
  
  /* Wait for the FLASH operation to complete by polling on BUSY flag to be reset.
     Even if the FLASH operation fails, the BUSY flag will be reset and an error
     flag will be set */
  /* Get tick */
  // todo: implement rusEfi own timeout
  //tickstart = HAL_GetTick();
 
  while(__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY) != RESET) 
  { 
      /*
      // todo: implement rusEfi own timeout
    if(Timeout != HAL_MAX_DELAY)
    {
      if((Timeout == 0)||((HAL_GetTick() - tickstart ) > Timeout))
      {
        return HAL_TIMEOUT;
      }
    } 
    */
  }
  
  if(__HAL_FLASH_GET_FLAG(FLASH_FLAG_ALL_ERRORS) != RESET)
  {
    /*Save the error code*/
    FLASH_SetErrorCode();
    return HAL_ERROR;
  }
  
  /* Check FLASH End of Operation flag  */
  if (__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP) != RESET)
  {
    /* Clear FLASH End of Operation pending bit */
    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
  }
 
  /* If there is an error flag set */
  return HAL_OK;
  
}  

Referenced by FLASH_OB_BootConfig(), FLASH_OB_DisablePCROP(), FLASH_OB_DisablePCROP(), FLASH_OB_DisableWRP(), FLASH_OB_EnablePCROP(), FLASH_OB_EnablePCROP(), FLASH_OB_EnableWRP(), FLASH_OB_RDP_LevelConfig(), FLASH_OB_UserConfig(), and HAL_FLASHEx_Erase().

Here is the call graph for this function:

Here is the caller graph for this function: