stm32f10x_flash.c

stm32f10xx的中文译文例程

*                    这个参数可以是下面的值之一:
*                     - OB_STDBY_NoRST: 当进入STOP模式时产生复位
*                     - OB_STDBY_RST: 当进入STANDBY模式时产生复位
* 输出参数: 无
* 返回参数: FLASH状态:这个返回值可以是: FLASH_BUSY,
*                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
*                  FLASH_TIMEOUT.
*******************************************************************************/
FLASH_Status FLASH_UserOptionByteConfig(u16 OB_IWDG, u16 OB_STOP, u16 OB_STDBY)
{
  FLASH_Status status = FLASH_COMPLETE; 

  /* Check the parameters [检查参数]*/
  assert_param(IS_OB_IWDG_SOURCE(OB_IWDG));
  assert_param(IS_OB_STOP_SOURCE(OB_STOP));
  assert_param(IS_OB_STDBY_SOURCE(OB_STDBY));

  /* Authorize the small information block programming [授权小信息块编程]*/
  FLASH->OPTKEYR = FLASH_KEY1;
  FLASH->OPTKEYR = FLASH_KEY2;
  
  /* Wait for last operation to be completed [等待最后一个操作完成]*/
  status = FLASH_WaitForLastOperation(ProgramTimeout);
  
  if(status == FLASH_COMPLETE)
  {  
    /* Enable the Option Bytes Programming operation [使能字节编程操作选项]*/
    FLASH->CR |= CR_OPTPG_Set; 
           
    OB->USER = ( OB_IWDG | OB_STOP |OB_STDBY) | (u16)0xF8; 
  
    /* Wait for last operation to be completed [等待最后一个操作完成]*/
    status = FLASH_WaitForLastOperation(ProgramTimeout);

    if(status != FLASH_BUSY)
    {
      /* if the program operation is completed, disable the OPTPG Bit [如果编程操作完成，禁止OPTPG位]*/
      FLASH->CR &= CR_OPTPG_Reset;
    }
  }    
  /* Return the Option Byte program Status [返回选项字节编程状态]*/
  return status;
}

/*******************************************************************************
* 函数名称: FLASH_GetUserOptionByte
* 功能描述: 返回FLASH用户选项字节值.
* 输入参数: 无
* 输出参数: 无
* 返回参数: FLASH用户选项字节值：:IWDG_SW(Bit0), RST_STOP(Bit1)和RST_STDBY(Bit2).
*******************************************************************************/
u32 FLASH_GetUserOptionByte(void)
{
  /* Return the User Option Byte */
  return (u32)(FLASH->OBR >> 2);
}

/*******************************************************************************
* 函数名称: FLASH_GetWriteProtectionOptionByte
* 功能描述: 返回FLASH写保护选项字节寄存器值.
* 输入参数: 无
* 输出参数: 无
* 返回参数: FLASH写保护选项字节寄存器值
*******************************************************************************/
u32 FLASH_GetWriteProtectionOptionByte(void)
{
  /* Return the Flash write protection Register value [返回FLASH写保护寄存器值]*/
  return (u32)(FLASH->WRPR);
}

/*******************************************************************************
* 函数名称: FLASH_GetReadOutProtectionStatus
* 功能描述: 检查FLASH读取保护状态是否被置位了.
* 输入参数: 无
* 输出参数: 无
* 返回参数: FLASH读出保护状态（SET或RESET）
*******************************************************************************/
FlagStatus FLASH_GetReadOutProtectionStatus(void)
{
  FlagStatus readoutstatus = RESET;

  if ((FLASH->OBR & RDPRT_Mask) != (u32)RESET)
  {
    readoutstatus = SET;
  }
  else
  {
    readoutstatus = RESET;
  }
  return readoutstatus;
}

/*******************************************************************************
* 函数名称: FLASH_GetPrefetchBufferStatus
* 功能描述: 检查FLASH预取缓冲区状态是否被置位.
* 输入参数: 无
* 输出参数: 无
* 返回参数: FLASH预取缓冲区状态（SET或RESET）.
*******************************************************************************/
FlagStatus FLASH_GetPrefetchBufferStatus(void)
{
  FlagStatus bitstatus = RESET;
  
  if ((FLASH->ACR & ACR_PRFTBS_Mask) != (u32)RESET)
  {
    bitstatus = SET;
  }
  else
  {
    bitstatus = RESET;
  }
  /* Return the new state of FLASH Prefetch Buffer Status (SET or RESET) [返回flash预取缓冲状态的新状态(SET 或 RESET)]*/
  return bitstatus; 
}

/*******************************************************************************
* 函数名称: FLASH_ITConfig
* 功能描述: 使能（或禁能）特定的FLASH中断.
* 输入参数: FLASH_IT：被使能（或禁能）的FLASH中断源。
*                   这个参数可以是下面值的任意组合:
*                       - FLASH_IT_ERROR: FLASH 错误中断
*                       - FLASH_IT_EOP: FLASH 完成操作中断
* 输出参数: 无
* 返回参数: 无
*******************************************************************************/
void FLASH_ITConfig(u16 FLASH_IT, FunctionalState NewState)
{
  /* Check the parameters [检查参数]*/
  assert_param(IS_FLASH_IT(FLASH_IT)); 
  assert_param(IS_FUNCTIONAL_STATE(NewState));

  if(NewState != DISABLE)
  {
    /* Enable the interrupt sources [使能中断源]*/
    FLASH->CR |= FLASH_IT;
  }
  else
  {
    /* Disable the interrupt sources [禁止中断源]*/
    FLASH->CR &= ~(u32)FLASH_IT;
  }
}

/*******************************************************************************
* 函数名称: FLASH_GetFlagStatus
* 功能描述: 检查特定的FLASH标志是否被置位.
* 输入参数: FLASH_FLAG：需要检查的标志。
*                     这个参数可以是下面的值之一:
*                    - FLASH_FLAG_BSY: FLASH忙标志           
*                    - FLASH_FLAG_PGERR: FLASH程序错误标志      
*                    - FLASH_FLAG_WRPRTERR: FLASH写保护错误标志     
*                    - FLASH_FLAG_EOP: FLASH操作结束标志          
*                    - FLASH_FLAG_OPTERR:  FLASH选项字节错误标志    
* 输出参数: 无
* 返回参数: FLASH标志寄存器新状态（置位或复位）。
*******************************************************************************/
FlagStatus FLASH_GetFlagStatus(u16 FLASH_FLAG)
{
  FlagStatus bitstatus = RESET;

  /* Check the parameters [检查参数]*/
  assert_param(IS_FLASH_GET_FLAG(FLASH_FLAG)) ;

  if(FLASH_FLAG == FLASH_FLAG_OPTERR) 
  {
    if((FLASH->OBR & FLASH_FLAG_OPTERR) != (u32)RESET)
    {
      bitstatus = SET;
    }
    else
    {
      bitstatus = RESET;
    }
  }
  else
  {
   if((FLASH->SR & FLASH_FLAG) != (u32)RESET)
    {
      bitstatus = SET;
    }
    else
    {
      bitstatus = RESET;
    }
  }
  /* Return the new state of FLASH_FLAG (SET or RESET)[FLASH标志寄存器新状态(置位或复位)] */
  return bitstatus;
}

/*******************************************************************************
* 函数名称: FLASH_ClearFlag
* 功能描述: 清除FLASH挂起标志.
* 输入参数: FLASH_FLAG：需要清除的标志。
*                    这个参数可以是下面值的任意组合:
*                    - FLASH_FLAG_BSY: FLASH忙的标志           
*                    - FLASH_FLAG_PGERR: FLASH程序错误的标志      
*                    - FLASH_FLAG_WRPRTERR: FLASH页写保护错误的标志     
*                    - FLASH_FLAG_EOP: FLASH操作结束的标志          
* 输出参数: 无
* 返回参数: 无
*******************************************************************************/
void FLASH_ClearFlag(u16 FLASH_FLAG)
{
  /* Check the parameters [检查参数]*/
  assert_param(IS_FLASH_CLEAR_FLAG(FLASH_FLAG)) ;
  
  /* Clear the flags [清除标志]*/
  FLASH->SR = FLASH_FLAG;
}

/*******************************************************************************
* 函数名称: FLASH_GetStatus
* 功能描述: 返回FLASH状态.
* 输入参数: 无
* 输出参数: 无
* 返回参数: FLASH状态:这个返回值可以是: FLASH_BUSY,
*                  FLASH_ERROR_PG, FLASH_ERROR_WRP or FLASH_COMPLETE
*******************************************************************************/
FLASH_Status FLASH_GetStatus(void)
{
  FLASH_Status flashstatus = FLASH_COMPLETE;
  
  if((FLASH->SR & FLASH_FLAG_BSY) == FLASH_FLAG_BSY) 
  {
    flashstatus = FLASH_BUSY;
  }
  else 
  {  
    if(FLASH->SR & FLASH_FLAG_PGERR)
    { 
      flashstatus = FLASH_ERROR_PG;
    }
    else 
    {
      if(FLASH->SR & FLASH_FLAG_WRPRTERR)
      {
        flashstatus = FLASH_ERROR_WRP;
      }
      else
      {
        flashstatus = FLASH_COMPLETE;
      }
    }
  }
  /* Return the Flash Status [返回FLASH状态]*/
  return flashstatus;
}

/*******************************************************************************
* 函数名称: FLASH_WaitForLastOperation
* 功能描述: 等待一个Flash操作来结束或一个TIMEOUT事件发生.
* 输入参数: - Timeout: FLASH编程超时时间
* 输出参数: 无
* 返回参数: FLASH状态:这个返回值可以是: FLASH_BUSY,
*                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
*                  FLASH_TIMEOUT.
*******************************************************************************/
FLASH_Status FLASH_WaitForLastOperation(u32 Timeout)
{ 
  FLASH_Status status = FLASH_COMPLETE;
   
  /* Check for the Flash Status [检查FLASH状态]*/
  status = FLASH_GetStatus();

  /* Wait for a Flash operation to complete or a TIMEOUT to occur [等待FLASH操作完成或者发生超时]*/
  while((status == FLASH_BUSY) && (Timeout != 0x00))
  {
    delay();
    status = FLASH_GetStatus();
    Timeout--;
  }

  if(Timeout == 0x00 )
  {
    status = FLASH_TIMEOUT;
  }

  /* Return the operation status [返回操作状态]*/
  return status;
}

/*******************************************************************************
* 函数名称: delay
* 功能描述: 插入一个延时.
* 输入参数: 无
* 输出参数: 无
* 返回参数: 无
*******************************************************************************/
static void delay(void)
{
  vu32 i = 0;

  for(i = 0xFF; i != 0; i--)
  {
  }
}
#endif

/******************* (C) COPYRIGHT 2008 STMicroelectronics *****END OF FILE****/