libs/rt-thread
libs
/
rt-thread
4
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
rt-thread/bsp/gd32103c-eval/Libraries/GD32F1xx_standard_peripheral/Source/gd32f10x_fmc.c

1167 lines
34 KiB
C
Raw Blame History

/**
******************************************************************************
* @brief FMC functions of the firmware library.
******************************************************************************/
/* Includes ------------------------------------------------------------------*/
#include "gd32f10x_fmc.h"
/** @addtogroup GD32F10x_Firmware
* @{
*/
/** @defgroup FMC
* @brief FMC driver modules
* @{
*/
/** @defgroup FMC_Private_Functions
* @{
*/
/** @defgroup FMC_Group1 FMC Memory Programming functions
* @brief FMC Memory Programming functions
*
@verbatim
===============================================================================
##### FMC Memory Programming functions #####
===============================================================================
[..] The FMC Memory Programming functions, includes the following functions:
(+) void FMC_Unlock(void);
(+) void FMC_UnlockBank1(void);
(+) void FMC_UnlockBank2(void);
(+) void FMC_Lock(void);
(+) void FMC_LockBank1(void)
(+) void FMC_LockBank2(void)
(+) FMC_State FMC_ErasePage(uint32_t Page_Address);
(+) FMC_State FMC_MassErase(void);
(+) FMC_State FMC_MassBank1Erase(void)
(+) FMC_State FMC_MassBank2Erase(void)
(+) FMC_State FMC_ProgramWord(uint32_t Address, uint32_t Data);
[..] Any operation of erase or program should follow these steps:
(#) Call the FMC_Unlock() function to unlock the FMC operation
(#) Call erase or program data
(#) Call the FMC_Lock() to lock the FMC operation
@endverbatim
* @{
*/
/**
* @brief Unlock the main FMC operation.
* @param None
* @retval None
*/
void FMC_Unlock(void)
{
if ((FMC->CMR & FMC_CMR_LK) != RESET) {
/* Write the FMC key */
FMC->UKEYR = FMC_KEY1;
FMC->UKEYR = FMC_KEY2;
}
if (FMC_SIZE > FMC_BANK1_SIZE) {
/* Authorize the FPEC of Bank2 Access */
if ((FMC->CMR2 & FMC_CMR_LK) != RESET) {
FMC->UKEYR2 = FMC_KEY1;
FMC->UKEYR2 = FMC_KEY2;
}
}
}
/**
* @brief Unlocks the FMC Bank1 Program Erase Controller.
* @note This function can be used for all GD32F10x devices.
* - For GD32F10X_XD and GD32F10X_CL devices this function unlocks Bank1.
* - For all other devices it unlocks Bank1 and it is
* equivalent to FLASH_Unlock function.
* @param None
* @retval None
*/
void FMC_UnlockB1(void)
{
/* Authorize the FPEC of Bank1 Access */
if ((FMC->CMR & FMC_CMR_LK) != RESET) {
FMC->UKEYR = FMC_KEY1;
FMC->UKEYR = FMC_KEY2;
}
}
/**
* @brief Unlocks the FMC Bank2 Program Erase Controller.
* @note This function can be used for GD32F10X_XD and GD32F10X_CL density devices.
* @param None
* @retval None
*/
#if defined GD32F10X_XD || defined GD32F10X_CL
void FMC_UnlockB2(void)
{
/* Authorize the FPEC of Bank2 Access */
if ((FMC->CMR2 & FMC_CMR_LK) != RESET) {
FMC->UKEYR2 = FMC_KEY1;
FMC->UKEYR2 = FMC_KEY2;
}
}
#endif /* GD32F10X_XD and GD32F10X_CL */
/**
* @brief Lock the main FMC operation.
* @param None
* @retval None
*/
void FMC_Lock(void)
{
/* Set the LOCK bit*/
FMC->CMR |= FMC_CMR_LK;
if (FMC_SIZE > FMC_BANK1_SIZE) {
/* Set the Lock Bit to lock the FPEC and the CR of Bank2 */
FMC->CMR2 |= FMC_CMR_LK;
}
}
/**
* @brief Locks the FMC Bank1 Program Erase Controller.
* @note this function can be used for all GD32F10X devices.
* - For GD32F10X_XD and GD32F10X_CL devices this function Locks Bank1.
* - For all other devices it Locks Bank1 and it is equivalent
* to FMC_Lock function.
* @param None
* @retval None
*/
void FMC_LockB1(void)
{
/* Set the Lock Bit to lock the FPEC and the CMR of Bank1 */
FMC->CMR |= FMC_CMR_LK;
}
/**
* @brief Locks the FMC Bank2 Program Erase Controller.
* @note This function can be used for GD32F10X_XD and GD32F10X_CL density devices.
* @param None
* @retval None
*/
#if defined GD32F10X_XD || defined GD32F10X_CL
void FMC_LockB2(void)
{
/* Set the Lock Bit to lock the FPEC and the CMR of Bank2 */
FMC->CMR2 |= FMC_CMR_LK;
}
#endif
/**
* @brief Erase a page.
* @param Page_Address: The page address to be erased.
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_ErasePage(uint32_t Page_Address)
{
if (FMC_SIZE > FMC_BANK1_SIZE) {
FMC_State temp_state = FMC_B1_WaitReady(FMC_TIMEOUT_COUNT);
if (Page_Address < FMC_B1_END_ADDRESS) {
/* Wait for last operation to be completed */
FMC_State temp_state = FMC_B1_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
FMC->CMR |= FMC_CMR_PE;
FMC->AR = Page_Address;
FMC->CMR |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_B1_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the PE bit */
FMC->CMR &= ~FMC_CMR_PE;
}
} else {
/* Wait for last operation to be completed */
FMC_State temp_state = FMC_B2_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
FMC->CMR2 |= FMC_CMR_PE;
FMC->AR2 = Page_Address;
if (FMC->OPTR & FMC_OPTR_PLEVEL1) {
FMC->AR = Page_Address;
}
FMC->CMR2 |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_B2_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the PE bit */
FMC->CMR2 &= ~FMC_CMR_PE;
}
}
/* Return the FMC state */
return temp_state;
}
else {
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Start page erase */
FMC->CMR |= FMC_CMR_PE;
FMC->AR = Page_Address;
FMC->CMR |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the PE bit */
FMC->CMR &= ~FMC_CMR_PE;
}
/* Return the FMC state */
return temp_state;
}
}
/**
* @brief Erase all main FMC.
* @param None
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_MassErase(void)
{
if (FMC_SIZE > FMC_BANK1_SIZE) {
/* Wait for last operation to be completed */
FMC_State temp_state = FMC_B1_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Start chip erase */
FMC->CMR |= FMC_CMR_ME;
FMC->CMR |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_B1_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the MER bit */
FMC->CMR &= ~FMC_CMR_ME;
}
temp_state = FMC_B2_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Start chip erase */
FMC->CMR2 |= FMC_CMR_ME;
FMC->CMR2 |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_B2_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the MER bit */
FMC->CMR2 &= ~FMC_CMR_ME;
}
/* Return the FMC state */
return temp_state;
} else {
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Start chip erase */
FMC->CMR |= FMC_CMR_ME;
FMC->CMR |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the MER bit */
FMC->CMR &= ~FMC_CMR_ME;
}
/* Return the FMC state */
return temp_state;
}
}
/**
* @brief Erases all Bank1 FMC pages.
* @note This function can be used for all GD32F10x devices.
* - For GD32F10X_XD and GD32F10X_CL devices this function erases all Bank1 pages.
* - For all other devices it erases all Bank1 pages and it is equivalent
* to FLASH_EraseAllPages function.
* @param None
* @retval FLASH Status: FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_MassB1Erase(void)
{
FMC_State temp_state = FMC_B1_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Start chip erase */
FMC->CMR |= FMC_CMR_ME;
FMC->CMR |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_B1_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the MER bit */
FMC->CMR &= ~FMC_CMR_ME;
}
/* Return the Erase Status */
return temp_state;
}
/**
* @brief Erases all Bank2 FMC pages.
* @note This function can be used for GD32F10X_XD and GD32F10X_CL density devices.
* @param None
* @retval FMC Status: FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_MassB2Erase(void)
{
FMC_State temp_state = FMC_B2_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Start chip erase */
FMC->CMR2 |= FMC_CMR_ME;
FMC->CMR2 |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_B2_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the MER bit */
FMC->CMR2 &= ~FMC_CMR_ME;
}
/* Return the Erase Status */
return temp_state;
}
/**
* @brief Program a word at the corresponding address.
* @param Address: The address to be programmed.
* @param Data: The data to be programmed.
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_ProgramWord(uint32_t Address, uint32_t Data)
{
if (FMC_SIZE > FMC_BANK1_SIZE) {
FMC_State temp_state = FMC_B1_WaitReady(FMC_TIMEOUT_COUNT);
if (Address < FMC_B1_END_ADDRESS) {
FMC_State temp_state = FMC_B1_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Set the PG bit to start program */
FMC->CMR |= FMC_CMR_PG;
*(__IO uint32_t *)Address = Data;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the PG bit */
FMC->CMR &= ~FMC_CMR_PG;
}
} else {
FMC_State temp_state = FMC_B2_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Set the PG bit to start program */
FMC->CMR2 |= FMC_CMR_PG;
*(__IO uint32_t *)Address = Data;
/* Wait for the FMC ready */
temp_state = FMC_B2_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the PG bit */
FMC->CMR2 &= ~FMC_CMR_PG;
}
}
/* Return the FMC state */
return temp_state;
} else {
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Set the PG bit to start program */
FMC->CMR |= FMC_CMR_PG;
*(__IO uint32_t *)Address = Data;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
/* Reset the PG bit */
FMC->CMR &= ~FMC_CMR_PG;
}
/* Return the FMC state */
return temp_state;
}
}
/**
* @}
*/
/** @defgroup FMC_Group2 Option Bytes Programming functions
* @brief Option Bytes Programming functions
*
@verbatim
===============================================================================
##### Option Bytes Programming functions #####
===============================================================================
[..] The FMC_Option Bytes Programming_functions, includes the following functions:
(+) void FMC_OB_Unlock(void);
(+) void FMC_OB_Lock(void);
(+) void FMC_OB_Reset(void);
(+) FMC_State FMC_OB_Erase(void);
(+) FMC_State FMC_OB_WRPConfig(uint32_t OB_WRP);
(+) FMC_State FMC_OB_RDPConfig(uint8_t OB_RDP);
(+) FMC_State FMC_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_DEEPSLEEP, uint8_t OB_STDBY);
(+) FMC_State FMC_OB_BOOTConfig(uint8_t OB_BOOT);
(+) FMC_State FMC_OB_WriteUser(uint8_t OB_USER);
(+) FMC_ProgramOptionByteData(uint32_t Address, uint8_t Data);
(+) uint8_t FMC_OB_GetUser(void);
(+) uint32_t FMC_OB_GetWRP(void);
(+) FlagStatus FMC_OB_GetRDP(void);
[..] Any operation of erase or program should follow these steps:
(#) Call the FMC_OB_Unlock() function to enable the Option Bytes registers access
(#) Call one or several functions to program the desired option bytes
(++) FMC_State FMC_OB_RDPConfig(uint8_t OB_RDP) => to set the desired read Protection Level
(++) FMC_State FMC_OB_WRPConfig(uint32_t OB_WRP, FunctionalState NewState)
=> to Enable/Disable the desired sector write protection
(++) FMC_State FMC_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_DEEPSLEEP, uint8_t OB_STDBY)
=> to configure the user option Bytes: IWDG, DEEPSLEEP and the Standby.
(++) FMC_State FMC_OB_BOOTConfig(uint8_t OB_BOOT1)
=> to set or reset BOOT1
(++) FMC_State FMC_OB_VDDAConfig(uint8_t OB_VDDA_ANALOG)
=> to enable or disable the VDDA Analog Monitoring
(++) You can write all User Options bytes at once using a single function
by calling FMC_State FMC_OB_WriteUser(uint8_t OB_USER)
(++) FMC_ProgramOptionByteData(uint32_t Address, uint8_t Data) to program the
two half word in the option bytes
(#) Once all needed option bytes to be programmed are correctly written, call the
FMC_OB_Launch(void) function to launch the Option Bytes programming process.
(#) Call the FMC_OB_Lock() to disable the Option Bytes registers access (recommended
to protect the option Bytes against possible unwanted operations)
@endverbatim
* @{
*/
/**
* @brief Unlock the option byte operation
* @param None
* @retval None
*/
void FMC_OB_Unlock(void)
{
if ((FMC->CMR & FMC_CMR_OBWE) == RESET) {
/* Write the FMC key */
FMC->OBKEYR = FMC_KEY1;
FMC->OBKEYR = FMC_KEY2;
}
}
/**
* @brief Lock the option byte operation.
* @param None
* @retval None
*/
void FMC_OB_Lock(void)
{
/* Reset the OBWE bit */
FMC->CMR &= ~FMC_CMR_OBWE;
}
/**
* @brief Generate a system reset to reload the option byte.
* @param None
* @retval None
*/
void FMC_OB_Reset(void)
{
/* Set the OPTR bit */
FMC->CMR |= FMC_CMR_OPTR;
}
/**
* @brief Erase the FMC option byte.
* @param None
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_OB_Erase(void)
{
uint16_t temp_rdp = RDP_LEVEL_0;
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
/* Check the ReadOut Protection Option Byte */
if (FMC_OB_GetRDP() != RESET) {
temp_rdp = 0x00;
}
if (temp_state == FMC_READY) {
/* Start erase the option byte */
FMC->CMR |= FMC_CMR_OBER;
FMC->CMR |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Reset the OPER bit */
FMC->CMR &= ~FMC_CMR_OBER;
/* Set the OBPG bit */
FMC->CMR |= FMC_CMR_OBPG;
/* Set default RDP level */
OB->RDP = (uint16_t)temp_rdp;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state != FMC_TIMEOUT_ERR) {
/* Reset the OBPG bit */
FMC->CMR &= ~FMC_CMR_OBPG;
}
} else {
if (temp_state != FMC_TIMEOUT_ERR) {
/* Reset the OBPG bit */
FMC->CMR &= ~FMC_CMR_OBPG;
}
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Program Write protect Byte
* @param OB_WRP: specify the address of the pages to be write protected.
* The legal parameter can be:
* @arg WRP_SECTOR0 ... WRP_SECTOR31
* @arg WRP_ALLSECTORS
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_OB_EnableWRP(uint32_t OB_WRP)
{
uint16_t temp_WRP0, temp_WRP1, temp_WRP2, temp_WRP3;
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
OB_WRP = (uint32_t)(~OB_WRP);
temp_WRP0 = (uint16_t)(OB_WRP & OB_WRP0_WRP0);
temp_WRP1 = (uint16_t)((OB_WRP & OB_WRP0_nWRP0) >> 8);
temp_WRP2 = (uint16_t)((OB_WRP & OB_WRP1_WRP1) >> 16);
temp_WRP3 = (uint16_t)((OB_WRP & OB_WRP1_nWRP1) >> 24);
if (temp_state == FMC_READY) {
FMC->OBKEYR = FMC_KEY1;
FMC->OBKEYR = FMC_KEY2;
/* Set the OBPG bit*/
FMC->CMR |= FMC_CMR_OBPG;
if (temp_WRP0 != 0xFF) {
OB->WRP0 = temp_WRP0;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
}
if ((temp_state == FMC_READY) && (temp_WRP1 != 0xFF)) {
OB->WRP1 = temp_WRP1;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
}
if ((temp_state == FMC_READY) && (temp_WRP2 != 0xFF)) {
OB->WRP2 = temp_WRP2;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
}
if ((temp_state == FMC_READY) && (temp_WRP3 != 0xFF)) {
OB->WRP3 = temp_WRP3;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
}
if (temp_state != FMC_TIMEOUT_ERR) {
/* Reset the OBPG bit */
FMC->CMR &= ~FMC_CMR_OBPG;
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Enable or disable the read out protection,this function erases all option bytes.
* @param NewValue: ENABLE or DISABLE.
* @retval FMC state: FMC_READY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_ReadOutProtection(TypeState NewValue)
{
FMC_State temp_state = FMC_READY;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Unlock option bytes */
FMC->OBKEYR = FMC_KEY1;
FMC->OBKEYR = FMC_KEY2;
while ((FMC->CMR & FMC_CMR_OBWE) != FMC_CMR_OBWE)
{}
FMC->CMR |= FMC_CMR_OBER;
FMC->CMR |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Disable the OBER Bit */
FMC->CMR &= ~FMC_CMR_OBER ;
/* Enable the OBPG Bit */
FMC->CMR |= FMC_CMR_OBPG;
if (NewValue != DISABLE) {
OB->RDP = 0x00;
} else {
OB->RDP = RDP_LEVEL_0;
}
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state != FMC_TIMEOUT_ERR) {
/* Enable the OBPG Bit */
FMC->CMR &= ~FMC_CMR_OBPG ;
}
} else {
if (temp_state != FMC_TIMEOUT_ERR) {
/* Disable the OBER Bit */
FMC->CMR &= ~FMC_CMR_OBER ;
}
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Config the Read Out Protection bit.
* @param FMC_ReadProtection_Level: The Read Out Protection level.
* This parameter can be:
* @arg RDP_LEVEL_0: No protection
* @arg RDP_LEVEL_1: Read Outprotection of the memory
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_OB_RDPConfig(uint8_t OB_RDP)
{
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
FMC->CMR |= FMC_CMR_OBER;
FMC->CMR |= FMC_CMR_START;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Reset the OBER bit */
FMC->CMR &= ~FMC_CMR_OBER;
/* Start the Option Bytes Programming */
FMC->CMR |= FMC_CMR_OBPG;
OB->RDP = OB_RDP;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state != FMC_TIMEOUT_ERR) {
/* Reset the OBPG bit */
FMC->CMR &= ~FMC_CMR_OBPG;
}
} else {
if (temp_state != FMC_TIMEOUT_ERR) {
/* Reset the OBER Bit */
FMC->CMR &= ~FMC_CMR_OBER;
}
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Program the FMC User Option Byte: IWDG_SW / RST_DEEPSLEEP / RST_STDBY.
* @param OB_IWDG: Config the WDG mode
* @arg OB_IWDG_SW: Software WDG selected
* @arg OB_IWDG_HW: Hardware WDG selected
* @param OB_DEEPSLEEP: Config Reset event when entering DEEPSLEEP mode.
* @arg OB_DEEPSLEEP_NORST: No reset generated when entering in DEEPSLEEP
* @arg OB_DEEPSLEEP_RST: Reset generated when entering in DEEPSLEEP
* @param OB_STDBY: Config Reset event when entering Standby mode.
* @arg OB_STDBY_NORST: No reset generated when entering in STANDBY
* @arg OB_STDBY_RST: Reset generated when entering in STANDBY
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_OB_UserConfig(uint8_t OB_IWDG, uint8_t OB_DEEPSLEEP, uint8_t OB_STDBY)
{
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Set the OBPG bit*/
FMC->CMR |= FMC_CMR_OBPG;
OB->USER = (uint16_t)((uint16_t)(OB_IWDG | OB_DEEPSLEEP) | (uint16_t)(OB_STDBY | 0xF8));
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state != FMC_TIMEOUT_ERR) {
/* Reset the OBPG bit */
FMC->CMR &= ~FMC_CMR_OBPG;
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Program the BOOT option bit.
* @param OB_BOOT: The legal parameter can be one of the following value:
* @arg OB_BOOT_B1:Start up from Bank1
* @arg OB_BOOT_B2:Start up from Bank2
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_OB_BOOTConfig(uint8_t OB_BOOT)
{
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
FMC->OBKEYR = FMC_KEY1;
FMC->OBKEYR = FMC_KEY2;
if (temp_state == FMC_READY) {
/* Set the OBPG bit*/
FMC->CMR |= FMC_CMR_OBPG;
if (OB_BOOT == OB_BOOT_B1) {
OB->USER |= OB_USER_BFB2;
} else {
OB->USER &= (uint16_t)(~(uint16_t)(OB_USER_BFB2));
}
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state != FMC_TIMEOUT_ERR) {
/* Reset the OBPG bit */
FMC->CMR &= ~FMC_CMR_OBPG;
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Program the FMC User Option Byte.
* @param OB_USER: Select all user option byte
* The legal parameter is one of the following values:
* @arg OB_IWDG_SW
* @arg OB_IWDG_HW
* @arg OB_DEEPSLEEP_NORST
* @arg OB_DEEPSLEEP_RST
* @arg OB_STDBY_NORST
* @arg OB_STDBY_RST
* @arg OB_BOOT_B1
* @arg OB_BOOT_B2
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_OB_WriteUser(uint8_t OB_USER)
{
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* Set the OBPG bit */
FMC->CMR |= FMC_CMR_OBPG;
OB->USER = OB_USER | 0xf0;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state != FMC_TIMEOUT_ERR) {
/* Reset the OBPG bit */
FMC->CMR &= ~FMC_CMR_OBPG;
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Program Option Byte Data.
* @param Address: The Option Byte address to be programmed.
* The legal parameter can be 0x1FFFF804 or 0x1FFFF806.
* @param Data: The Byte to be programmed.
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_ProgramOptionByteData(uint32_t Address, uint8_t Data)
{
FMC_State temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state == FMC_READY) {
/* SET the OPTPG bit */
FMC->CMR |= FMC_CMR_OBPG;
*(__IO uint16_t *)Address = Data;
/* Wait for the FMC ready */
temp_state = FMC_WaitReady(FMC_TIMEOUT_COUNT);
if (temp_state != FMC_TIMEOUT_ERR) {
/* Reset the OPTPG bit */
FMC->CMR &= ~FMC_CMR_OBPG;
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Get the FMC User Option Byte.
* @param None
* @retval The FMC User Option Byte.
*/
uint8_t FMC_OB_GetUser(void)
{
return (uint8_t)(FMC->OPTR >> 8);
}
/**
* @brief Get the FMC Write Protection Option Byte.
* @param None
* @retval The FMC Write Protection Option Byte
*/
uint32_t FMC_OB_GetWRP(void)
{
return (uint32_t)(FMC->WPR);
}
/**
* @brief Check whether the FMC Read out Protection Status is SET or RESET.
* @param None
* @retval FMC ReadOut Protection state
*/
TypeState FMC_OB_GetRDP(void)
{
TypeState RDPState = RESET;
if ((uint8_t)(FMC->OPTR & (FMC_OPTR_PLEVEL1)) != RESET) {
RDPState = SET;
} else {
RDPState = RESET;
}
return RDPState;
}
/**
* @}
*/
/** @defgroup FMC_Group3 Interrupts and flags management functions
* @brief Interrupts and flags management functions
*
@verbatim
===============================================================================
##### Interrupts and flags management functions #####
===============================================================================
@endverbatim
* @{
*/
/**
* @brief Enable or disable the corresponding FMC interrupt source.
* @param FMC_INT: The FMC interrupt source to be enabled or disabled.
* This parameter can be any combination of the following values:
* @arg FMC_INT_EOP: FMC end of programming Interrupt
* @arg FMC_INT_ERR: FMC Error Interrupt
* @arg FMC_INT_B2_EOP: FMC end of programming Interrupt
* @arg FMC_INT_B2_ERR: FMC Error Interrupt
* @param NewValue: ENABLE or DISABLE.
* @retval None
*/
void FMC_INTConfig(uint32_t FMC_INT, TypeState NewValue)
{
if (FMC_SIZE > FMC_BANK1_SIZE) {
if ((FMC_INT & 0x80000000) != 0x0) {
if (NewValue != DISABLE) {
/* Enable the interrupt sources */
FMC->CMR2 |= (FMC_INT & 0x7fffffff);
} else {
/* Disable the interrupt sources */
FMC->CMR2 &= ~(uint32_t)(FMC_INT & 0x7fffffff);
}
} else {
if (NewValue != DISABLE) {
/* Enable the interrupt sources */
FMC->CMR |= FMC_INT;
} else {
/* Disable the interrupt sources */
FMC->CMR &= ~(uint32_t)FMC_INT;
}
}
} else {
if (NewValue != DISABLE) {
/* Enable the interrupt sources */
FMC->CMR |= FMC_INT;
} else {
/* Disable the interrupt sources */
FMC->CMR &= ~(uint32_t)FMC_INT;
}
}
}
/**
* @brief Checks whether the FMC flag is SET or RESET.
* @param FMC_FLAG: the corresponding FMC flag.
* the legal parameter can be:
* @arg FMC_FLAG_BSY: FMC BUSY flag
* @arg FMC_FLAG_PERR: FMC Programming error flag flag
* @arg FMC_FLAG_WERR: FMC Write protection error flag
* @arg FMC_FLAG_EOP: FMC End of Programming flag
* @arg FMC_FLAG_OPTER: FMC option byte error flag
* @retval The state of the FMC flag.
*/
TypeState FMC_GetBitState(uint32_t FMC_FLAG)
{
if (FMC_SIZE > FMC_BANK1_SIZE) {
/* Check the parameters */
if (FMC_FLAG == FMC_FLAG_OPTERR) {
if ((FMC->OPTR & FMC_FLAG_OPTERR) != (uint32_t)RESET) {
return SET;
} else {
return RESET;
}
} else {
if ((FMC_FLAG & 0x80000000) != 0x0) {
if ((FMC->CSR2 & FMC_FLAG) != (uint32_t)RESET) {
return SET;
} else {
return RESET;
}
} else {
if ((FMC->CSR & FMC_FLAG) != (uint32_t)RESET) {
return SET;
} else {
return RESET;
}
}
}
} else {
if (FMC_FLAG == FMC_FLAG_OPTERR) {
if ((FMC->OPTR & FMC_FLAG_OPTERR) != (uint32_t)RESET) {
return SET;
} else {
return RESET;
}
} else {
if ((FMC->CSR & FMC_FLAG) != (uint32_t)RESET) {
return SET;
}
/* Return the state of corresponding FMC flag */
else {
return RESET;
}
}
}
}
/**
* @brief Clear the FMC pending flag.
* @param FMC_FLAG: clear the corresponding FMC flag.
* @arg FMC_FLAG_PERR: Programming error flag flag
* @arg FMC_FLAG_WERR: Write protection error flag
* @arg FMC_FLAG_EOP: End of Programming flag
* @retval None
*/
void FMC_ClearBitState(uint32_t FMC_FLAG)
{
if (FMC_SIZE > FMC_BANK1_SIZE) {
if ((FMC_FLAG & 0x80000000) != 0x0) {
/* Clear the flags */
FMC->CSR2 = FMC_FLAG;
} else {
/* Clear the flags */
FMC->CSR = FMC_FLAG;
}
} else {
FMC->CSR = FMC_FLAG;
}
}
/**
* @brief Return the FMC state.
* @param None
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, or FMC_PGERR
*/
FMC_State FMC_GetState(void)
{
FMC_State temp_state = FMC_READY;
if ((FMC->CSR & FMC_CSR_BUSY) == FMC_CSR_BUSY) {
temp_state = FMC_BSY;
} else {
if ((FMC->CSR & (uint32_t)FMC_CSR_WPEF) != (uint32_t)0x00) {
temp_state = FMC_WRPERR;
} else {
if ((FMC->CSR & (uint32_t)(FMC_CSR_PGEF)) != (uint32_t)0x00) {
temp_state = FMC_PGERR;
} else {
temp_state = FMC_READY;
}
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Return the FMC bak1 state.
* @param None
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, or FMC_PGERR
*/
FMC_State FMC_GetB1State(void)
{
FMC_State temp_state = FMC_READY;
if ((FMC->CSR & FMC_CSR_BUSY) == FMC_CSR_BUSY) {
temp_state = FMC_BSY;
} else {
if ((FMC->CSR & (uint32_t)FMC_CSR_WPEF) != (uint32_t)0x00) {
temp_state = FMC_WRPERR;
} else {
if ((FMC->CSR & (uint32_t)(FMC_CSR_PGEF)) != (uint32_t)0x00) {
temp_state = FMC_PGERR;
} else {
temp_state = FMC_READY;
}
}
}
return temp_state;
}
/**
* @brief Return the FMC bak2 state.
* @param None
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, or FMC_PGERR
*/
FMC_State FMC_GetB2State(void)
{
FMC_State temp_state = FMC_READY;
if ((FMC->CSR2 & FMC_CSR2_BUSY & 0x7fffffff) == (FMC_CSR2_BUSY & 0x7fffffff)) {
temp_state = FMC_BSY;
} else {
if ((FMC->CSR2 & FMC_CSR2_WPEF & 0x7fffffff) != (uint32_t)0x00) {
temp_state = FMC_WRPERR;
} else {
if ((FMC->CSR2 & FMC_CSR2_PGEF & 0x7fffffff) != (uint32_t)0x00) {
temp_state = FMC_PGERR;
} else {
temp_state = FMC_READY;
}
}
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Check whether FMC is ready or not.
* @param Timeout: Count of loop
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_WaitReady(uint32_t uCount)
{
FMC_State temp_state = FMC_BSY;
/* Wait for FMC ready */
do {
/* Get FMC state */
temp_state = FMC_GetState();
uCount--;
} while ((temp_state == FMC_BSY) && (uCount != 0x00));
if (temp_state == FMC_BSY) {
temp_state = FMC_TIMEOUT_ERR;
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Check whether FMC Bank1 is ready or not.
* @param Timeout: Count of loop
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_B1_WaitReady(uint32_t uCount)
{
FMC_State temp_state = FMC_BSY;
/* Wait for FMC ready */
do {
/* Get FMC state */
temp_state = FMC_GetB1State();
uCount--;
} while ((temp_state == FMC_BSY) && (uCount != 0x00));
if (temp_state == FMC_BSY) {
temp_state = FMC_TIMEOUT_ERR;
}
/* Return the FMC state */
return temp_state;
}
/**
* @brief Check whether FMC Bank2 is ready or not.
* @param Timeout: Count of loop
* @retval FMC state: FMC_READY, FMC_BSY, FMC_WRPERR, FMC_PGERR or FMC_TIMEOUT_ERR.
*/
FMC_State FMC_B2_WaitReady(uint32_t uCount)
{
FMC_State temp_state = FMC_BSY;
/* Wait for FMC ready */
do {
/* Get FMC state */
temp_state = FMC_GetB2State();
uCount--;
} while ((temp_state == (FMC_BSY && 0x7FFFFFFF)) && (uCount != 0x00));
if (temp_state == FMC_BSY) {
temp_state = FMC_TIMEOUT_ERR;
}
/* Return the FMC state */
return temp_state;
}
/**
* @}
*/
/**
* @}
*/
/**
* @}
*/
/**
* @}
*/
View Git Blame Copy Permalink