FLASH Private Functions

Functions
HAL_StatusTypeDef	FLASH_WaitForLastOperation (uint32_t Timeout)
	Wait for a FLASH operation to complete. More...
static void	FLASH_Program_DoubleWord (uint32_t Address, uint64_t Data)
	Program double-word (64-bit) at a specified address. More...
static void	FLASH_Program_Fast (uint32_t Address, uint32_t DataAddress)
	Fast program a row double-word (64-bit) at a specified address. More...

Detailed Description

Function Documentation

FLASH_Program_DoubleWord()

static void FLASH_Program_DoubleWord ( uint32_t  Address, uint64_t  Data  )

static

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

Parameters

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

Return values

None

Definition at line 700 of file stm32l4xx_hal_flash.c.

{
  /* Check the parameters */
  assert_param(IS_FLASH_PROGRAM_ADDRESS(Address));

  /* Set PG bit */
  SET_BIT(FLASH->CR, FLASH_CR_PG);

  /* Program first word */
  *(__IO uint32_t*)Address = (uint32_t)Data;

  /* Barrier to ensure programming is performed in 2 steps, in right order
    (independently of compiler optimization behavior) */
  __ISB();

  /* Program second word */
  *(__IO uint32_t*)(Address+4U) = (uint32_t)(Data >> 32);
}

FLASH_Program_Fast()

static void FLASH_Program_Fast ( uint32_t  Address, uint32_t  DataAddress  )

static

Fast program a row double-word (64-bit) at a specified address.

Parameters

Address	specifies the address to be programmed.
DataAddress	specifies the address where the data are stored.

Return values

None

Definition at line 725 of file stm32l4xx_hal_flash.c.

{
  uint32_t primask_bit;
  uint8_t row_index = (2*FLASH_NB_DOUBLE_WORDS_IN_ROW);
  __IO uint32_t *dest_addr = (__IO uint32_t*)Address;
  __IO uint32_t *src_addr = (__IO uint32_t*)DataAddress;

  /* Check the parameters */
  assert_param(IS_FLASH_MAIN_MEM_ADDRESS(Address));

  /* Set FSTPG bit */
  SET_BIT(FLASH->CR, FLASH_CR_FSTPG);

  /* Disable interrupts to avoid any interruption during the loop */
  primask_bit = __get_PRIMASK();
  __disable_irq();

  /* Program the double word of the row */
  do
  {
    *dest_addr = *src_addr;
    dest_addr++;
    src_addr++;
    row_index--;
  } while (row_index != 0U);

  /* Re-enable the interrupts */
  __set_PRIMASK(primask_bit);
}

FLASH_WaitForLastOperation()

HAL_StatusTypeDef FLASH_WaitForLastOperation

(

uint32_t

Timeout

)

Wait for a FLASH operation to complete.

Parameters

Timeout

maximum flash operation timeout

Return values

HAL_StatusTypeDef

HAL Status

Definition at line 649 of file stm32l4xx_hal_flash.c.

{
  /* 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 */

  uint32_t tickstart = HAL_GetTick();
  uint32_t error;

  while(__HAL_FLASH_GET_FLAG(FLASH_FLAG_BSY))
  {
    if(Timeout != HAL_MAX_DELAY)
    {
      if((HAL_GetTick() - tickstart) >= Timeout)
      {
        return HAL_TIMEOUT;
      }
    }
  }

  error = (FLASH->SR & FLASH_FLAG_SR_ERRORS);
  error |= (FLASH->ECCR & FLASH_FLAG_ECCD);

  if(error != 0u)
  {
    /*Save the error code*/
    pFlash.ErrorCode |= error;

    /* Clear error programming flags */
    __HAL_FLASH_CLEAR_FLAG(error);

    return HAL_ERROR;
  }

  /* Check FLASH End of Operation flag  */
  if (__HAL_FLASH_GET_FLAG(FLASH_FLAG_EOP))
  {
    /* Clear FLASH End of Operation pending bit */
    __HAL_FLASH_CLEAR_FLAG(FLASH_FLAG_EOP);
  }

  /* If there is an error flag set */
  return HAL_OK;
}