stm32f10x_flash.c
上传用户:yj_qqy
上传日期:2017-01-28
资源大小:2911k
文件大小:32k
源码类别:

uCOS

开发平台:

C/C++

  1. /******************** (C) COPYRIGHT 2008 STMicroelectronics ********************
  2. * File Name          : stm32f10x_flash.c
  3. * Author             : MCD Application Team
  4. * Version            : V2.0.2
  5. * Date               : 07/11/2008
  6. * Description        : This file provides all the FLASH firmware functions.
  7. ********************************************************************************
  8. * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
  9. * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE TIME.
  10. * AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY DIRECT,
  11. * INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING FROM THE
  12. * CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE CODING
  13. * INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
  14. *******************************************************************************/
  15. /* Includes ------------------------------------------------------------------*/
  16. #include "stm32f10x_flash.h"
  17. /* Private typedef -----------------------------------------------------------*/
  18. /* Private define ------------------------------------------------------------*/
  19. /* Flash Access Control Register bits */
  20. #define ACR_LATENCY_Mask         ((u32)0x00000038)
  21. #define ACR_HLFCYA_Mask          ((u32)0xFFFFFFF7)
  22. #define ACR_PRFTBE_Mask          ((u32)0xFFFFFFEF)
  23. #ifdef _FLASH_PROG
  24. /* Flash Access Control Register bits */
  25. #define ACR_PRFTBS_Mask          ((u32)0x00000020) 
  26. /* Flash Control Register bits */
  27. #define CR_PG_Set                ((u32)0x00000001)
  28. #define CR_PG_Reset              ((u32)0x00001FFE) 
  29. #define CR_PER_Set               ((u32)0x00000002)
  30. #define CR_PER_Reset             ((u32)0x00001FFD)
  31. #define CR_MER_Set               ((u32)0x00000004)
  32. #define CR_MER_Reset             ((u32)0x00001FFB)
  33. #define CR_OPTPG_Set             ((u32)0x00000010)
  34. #define CR_OPTPG_Reset           ((u32)0x00001FEF)
  35. #define CR_OPTER_Set             ((u32)0x00000020)
  36. #define CR_OPTER_Reset           ((u32)0x00001FDF)
  37. #define CR_STRT_Set              ((u32)0x00000040)
  38.  
  39. #define CR_LOCK_Set              ((u32)0x00000080)
  40. /* FLASH Mask */
  41. #define RDPRT_Mask               ((u32)0x00000002)
  42. #define WRP0_Mask                ((u32)0x000000FF)
  43. #define WRP1_Mask                ((u32)0x0000FF00)
  44. #define WRP2_Mask                ((u32)0x00FF0000)
  45. #define WRP3_Mask                ((u32)0xFF000000)
  46. /* FLASH Keys */
  47. #define RDP_Key                  ((u16)0x00A5)
  48. #define FLASH_KEY1               ((u32)0x45670123)
  49. #define FLASH_KEY2               ((u32)0xCDEF89AB)
  50. /* Delay definition */   
  51. #define EraseTimeout             ((u32)0x00000FFF)
  52. #define ProgramTimeout           ((u32)0x0000000F)
  53. #endif
  54. /* Private macro -------------------------------------------------------------*/
  55. /* Private variables ---------------------------------------------------------*/
  56. /* Private function prototypes -----------------------------------------------*/
  57. #ifdef _FLASH_PROG
  58. static void delay(void);
  59. #endif
  60. /* Private functions ---------------------------------------------------------*/
  61. /*******************************************************************************
  62. * Function Name  : FLASH_SetLatency
  63. * Description    : Sets the code latency value.
  64. * Input          : - FLASH_Latency: specifies the FLASH Latency value.
  65. *                    This parameter can be one of the following values:
  66. *                       - FLASH_Latency_0: FLASH Zero Latency cycle
  67. *                       - FLASH_Latency_1: FLASH One Latency cycle
  68. *                       - FLASH_Latency_2: FLASH Two Latency cycles
  69. * Output         : None
  70. * Return         : None
  71. *******************************************************************************/
  72. void FLASH_SetLatency(u32 FLASH_Latency)
  73. {
  74.   /* Check the parameters */
  75.   assert_param(IS_FLASH_LATENCY(FLASH_Latency));
  76.   
  77.   /* Sets the Latency value */
  78.   FLASH->ACR &= ACR_LATENCY_Mask;
  79.   FLASH->ACR |= FLASH_Latency;
  80. }
  81. /*******************************************************************************
  82. * Function Name  : FLASH_HalfCycleAccessCmd
  83. * Description    : Enables or disables the Half cycle flash access.
  84. * Input          : - FLASH_HalfCycle: specifies the FLASH Half cycle Access mode.
  85. *                    This parameter can be one of the following values:
  86. *                       - FLASH_HalfCycleAccess_Enable: FLASH Half Cycle Enable
  87. *                       - FLASH_HalfCycleAccess_Disable: FLASH Half Cycle Disable
  88. * Output         : None
  89. * Return         : None
  90. *******************************************************************************/
  91. void FLASH_HalfCycleAccessCmd(u32 FLASH_HalfCycleAccess)
  92. {
  93.   /* Check the parameters */
  94.   assert_param(IS_FLASH_HALFCYCLEACCESS_STATE(FLASH_HalfCycleAccess));
  95.   
  96.   /* Enable or disable the Half cycle access */
  97.   FLASH->ACR &= ACR_HLFCYA_Mask;
  98.   FLASH->ACR |= FLASH_HalfCycleAccess;
  99. }
  100. /*******************************************************************************
  101. * Function Name  : FLASH_PrefetchBufferCmd
  102. * Description    : Enables or disables the Prefetch Buffer.
  103. * Input          : - FLASH_PrefetchBuffer: specifies the Prefetch buffer status.
  104. *                    This parameter can be one of the following values:
  105. *                       - FLASH_PrefetchBuffer_Enable: FLASH Prefetch Buffer Enable
  106. *                       - FLASH_PrefetchBuffer_Disable: FLASH Prefetch Buffer Disable
  107. * Output         : None
  108. * Return         : None
  109. *******************************************************************************/
  110. void FLASH_PrefetchBufferCmd(u32 FLASH_PrefetchBuffer)
  111. {
  112.   /* Check the parameters */
  113.   assert_param(IS_FLASH_PREFETCHBUFFER_STATE(FLASH_PrefetchBuffer));
  114.   
  115.   /* Enable or disable the Prefetch Buffer */
  116.   FLASH->ACR &= ACR_PRFTBE_Mask;
  117.   FLASH->ACR |= FLASH_PrefetchBuffer;
  118. }
  119. #ifdef _FLASH_PROG
  120. /*******************************************************************************
  121. * Function Name  : FLASH_Unlock
  122. * Description    : Unlocks the FLASH Program Erase Controller.
  123. * Input          : None
  124. * Output         : None
  125. * Return         : None
  126. *******************************************************************************/
  127. void FLASH_Unlock(void)
  128. {
  129.   /* Authorize the FPEC Access */
  130.   FLASH->KEYR = FLASH_KEY1;
  131.   FLASH->KEYR = FLASH_KEY2;
  132. }
  133. /*******************************************************************************
  134. * Function Name  : FLASH_Lock
  135. * Description    : Locks the FLASH Program Erase Controller.
  136. * Input          : None
  137. * Output         : None
  138. * Return         : None
  139. *******************************************************************************/
  140. void FLASH_Lock(void)
  141. {
  142.   /* Set the Lock Bit to lock the FPEC and the FCR */
  143.   FLASH->CR |= CR_LOCK_Set;
  144. }
  145. /*******************************************************************************
  146. * Function Name  : FLASH_ErasePage
  147. * Description    : Erases a specified FLASH page.
  148. * Input          : - Page_Address: The page address to be erased.
  149. * Output         : None
  150. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  151. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  152. *                  FLASH_TIMEOUT.
  153. *******************************************************************************/
  154. FLASH_Status FLASH_ErasePage(u32 Page_Address)
  155. {
  156.   FLASH_Status status = FLASH_COMPLETE;
  157.   /* Check the parameters */
  158.   assert_param(IS_FLASH_ADDRESS(Page_Address));
  159.   /* Wait for last operation to be completed */
  160.   status = FLASH_WaitForLastOperation(EraseTimeout);
  161.   
  162.   if(status == FLASH_COMPLETE)
  163.   { 
  164.     /* if the previous operation is completed, proceed to erase the page */
  165.     FLASH->CR|= CR_PER_Set;
  166.     FLASH->AR = Page_Address; 
  167.     FLASH->CR|= CR_STRT_Set;
  168.     
  169.     /* Wait for last operation to be completed */
  170.     status = FLASH_WaitForLastOperation(EraseTimeout);
  171.     if(status != FLASH_BUSY)
  172.     {
  173.       /* if the erase operation is completed, disable the PER Bit */
  174.       FLASH->CR &= CR_PER_Reset;
  175.     }
  176.   }
  177.   /* Return the Erase Status */
  178.   return status;
  179. }
  180. /*******************************************************************************
  181. * Function Name  : FLASH_EraseAllPages
  182. * Description    : Erases all FLASH pages.
  183. * Input          : None
  184. * Output         : None
  185. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  186. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  187. *                  FLASH_TIMEOUT.
  188. *******************************************************************************/
  189. FLASH_Status FLASH_EraseAllPages(void)
  190. {
  191.   FLASH_Status status = FLASH_COMPLETE;
  192.   /* Wait for last operation to be completed */
  193.   status = FLASH_WaitForLastOperation(EraseTimeout);
  194.   
  195.   if(status == FLASH_COMPLETE)
  196.   {
  197.     /* if the previous operation is completed, proceed to erase all pages */
  198.      FLASH->CR |= CR_MER_Set;
  199.      FLASH->CR |= CR_STRT_Set;
  200.     
  201.     /* Wait for last operation to be completed */
  202.     status = FLASH_WaitForLastOperation(EraseTimeout);
  203.     if(status != FLASH_BUSY)
  204.     {
  205.       /* if the erase operation is completed, disable the MER Bit */
  206.       FLASH->CR &= CR_MER_Reset;
  207.     }
  208.   }    
  209.   /* Return the Erase Status */
  210.   return status;
  211. }
  212. /*******************************************************************************
  213. * Function Name  : FLASH_EraseOptionBytes
  214. * Description    : Erases the FLASH option bytes.
  215. * Input          : None
  216. * Output         : None
  217. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  218. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  219. *                  FLASH_TIMEOUT.
  220. *******************************************************************************/
  221. FLASH_Status FLASH_EraseOptionBytes(void)
  222. {
  223.   FLASH_Status status = FLASH_COMPLETE;
  224.   
  225.   /* Wait for last operation to be completed */
  226.   status = FLASH_WaitForLastOperation(EraseTimeout);
  227.   if(status == FLASH_COMPLETE)
  228.   {
  229.     /* Authorize the small information block programming */
  230.     FLASH->OPTKEYR = FLASH_KEY1;
  231.     FLASH->OPTKEYR = FLASH_KEY2;
  232.     
  233.     /* if the previous operation is completed, proceed to erase the option bytes */
  234.     FLASH->CR |= CR_OPTER_Set;
  235.     FLASH->CR |= CR_STRT_Set;
  236.     /* Wait for last operation to be completed */
  237.     status = FLASH_WaitForLastOperation(EraseTimeout);
  238.     
  239.     if(status == FLASH_COMPLETE)
  240.     {
  241.       /* if the erase operation is completed, disable the OPTER Bit */
  242.       FLASH->CR &= CR_OPTER_Reset;
  243.        
  244.       /* Enable the Option Bytes Programming operation */
  245.       FLASH->CR |= CR_OPTPG_Set;
  246.       /* Enable the readout access */
  247.       OB->RDP= RDP_Key; 
  248.       /* Wait for last operation to be completed */
  249.       status = FLASH_WaitForLastOperation(ProgramTimeout);
  250.  
  251.       if(status != FLASH_BUSY)
  252.       {
  253.         /* if the program operation is completed, disable the OPTPG Bit */
  254.         FLASH->CR &= CR_OPTPG_Reset;
  255.       }
  256.     }
  257.     else
  258.     {
  259.       if (status != FLASH_BUSY)
  260.       {
  261.         /* Disable the OPTPG Bit */
  262.         FLASH->CR &= CR_OPTPG_Reset;
  263.       }
  264.     }  
  265.   }
  266.   /* Return the erase status */
  267.   return status;
  268. }
  269. /*******************************************************************************
  270. * Function Name  : FLASH_ProgramWord
  271. * Description    : Programs a word at a specified address.
  272. * Input          : - Address: specifies the address to be programmed.
  273. *                  - Data: specifies the data to be programmed.
  274. * Output         : None
  275. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  276. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  277. *                  FLASH_TIMEOUT. 
  278. *******************************************************************************/
  279. FLASH_Status FLASH_ProgramWord(u32 Address, u32 Data)
  280. {
  281.   FLASH_Status status = FLASH_COMPLETE;
  282.   /* Check the parameters */
  283.   assert_param(IS_FLASH_ADDRESS(Address));
  284.   /* Wait for last operation to be completed */
  285.   status = FLASH_WaitForLastOperation(ProgramTimeout);
  286.   
  287.   if(status == FLASH_COMPLETE)
  288.   {
  289.     /* if the previous operation is completed, proceed to program the new first 
  290.     half word */
  291.     FLASH->CR |= CR_PG_Set;
  292.   
  293.     *(vu16*)Address = (u16)Data;
  294.     /* Wait for last operation to be completed */
  295.     status = FLASH_WaitForLastOperation(ProgramTimeout);
  296.  
  297.     if(status == FLASH_COMPLETE)
  298.     {
  299.       /* if the previous operation is completed, proceed to program the new second 
  300.       half word */
  301.       *(vu16*)(Address + 2) = Data >> 16;
  302.     
  303.       /* Wait for last operation to be completed */
  304.       status = FLASH_WaitForLastOperation(ProgramTimeout);
  305.         
  306.       if(status != FLASH_BUSY)
  307.       {
  308.         /* Disable the PG Bit */
  309.         FLASH->CR &= CR_PG_Reset;
  310.       }
  311.     }
  312.     else
  313.     {
  314.       if (status != FLASH_BUSY)
  315.       {
  316.         /* Disable the PG Bit */
  317.         FLASH->CR &= CR_PG_Reset;
  318.       }
  319.      }
  320.   }
  321.   /* Return the Program Status */
  322.   return status;
  323. }
  324. /*******************************************************************************
  325. * Function Name  : FLASH_ProgramHalfWord
  326. * Description    : Programs a half word at a specified address.
  327. * Input          : - Address: specifies the address to be programmed.
  328. *                  - Data: specifies the data to be programmed.
  329. * Output         : None
  330. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  331. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  332. *                  FLASH_TIMEOUT. 
  333. *******************************************************************************/
  334. FLASH_Status FLASH_ProgramHalfWord(u32 Address, u16 Data)
  335. {
  336.   FLASH_Status status = FLASH_COMPLETE;
  337.   /* Check the parameters */
  338.   assert_param(IS_FLASH_ADDRESS(Address));
  339.   /* Wait for last operation to be completed */
  340.   status = FLASH_WaitForLastOperation(ProgramTimeout);
  341.   
  342.   if(status == FLASH_COMPLETE)
  343.   {
  344.     /* if the previous operation is completed, proceed to program the new data */
  345.     FLASH->CR |= CR_PG_Set;
  346.   
  347.     *(vu16*)Address = Data;
  348.     /* Wait for last operation to be completed */
  349.     status = FLASH_WaitForLastOperation(ProgramTimeout);
  350.     if(status != FLASH_BUSY)
  351.     {
  352.       /* if the program operation is completed, disable the PG Bit */
  353.       FLASH->CR &= CR_PG_Reset;
  354.     }
  355.   } 
  356.   /* Return the Program Status */
  357.   return status;
  358. }
  359. /*******************************************************************************
  360. * Function Name  : FLASH_ProgramOptionByteData
  361. * Description    : Programs a half word at a specified Option Byte Data address.
  362. * Input          : - Address: specifies the address to be programmed.
  363. *                    This parameter can be 0x1FFFF804 or 0x1FFFF806. 
  364. *                  - Data: specifies the data to be programmed.
  365. * Output         : None
  366. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  367. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  368. *                  FLASH_TIMEOUT. 
  369. *******************************************************************************/
  370. FLASH_Status FLASH_ProgramOptionByteData(u32 Address, u8 Data)
  371. {
  372.   FLASH_Status status = FLASH_COMPLETE;
  373.   /* Check the parameters */
  374.   assert_param(IS_OB_DATA_ADDRESS(Address));
  375.   status = FLASH_WaitForLastOperation(ProgramTimeout);
  376.   if(status == FLASH_COMPLETE)
  377.   {
  378.     /* Authorize the small information block programming */
  379.     FLASH->OPTKEYR = FLASH_KEY1;
  380.     FLASH->OPTKEYR = FLASH_KEY2;
  381.     /* Enables the Option Bytes Programming operation */
  382.     FLASH->CR |= CR_OPTPG_Set; 
  383.     *(vu16*)Address = Data;
  384.     
  385.     /* Wait for last operation to be completed */
  386.     status = FLASH_WaitForLastOperation(ProgramTimeout);
  387.     if(status != FLASH_BUSY)
  388.     {
  389.       /* if the program operation is completed, disable the OPTPG Bit */
  390.       FLASH->CR &= CR_OPTPG_Reset;
  391.     }
  392.   }    
  393.   /* Return the Option Byte Data Program Status */
  394.   return status;      
  395. }
  396. /*******************************************************************************
  397. * Function Name  : FLASH_EnableWriteProtection
  398. * Description    : Write protects the desired pages
  399. * Input          : - FLASH_Pages: specifies the address of the pages to be 
  400. *                    write protected. This parameter can be:
  401. *                    - For STM32F10Xxx Medium-density devices (FLASH page size equal to 1 KB)
  402. *                       - A value between FLASH_WRProt_Pages0to3 and 
  403. *                         FLASH_WRProt_Pages124to127
  404. *                    - For STM32F10Xxx High-density devices (FLASH page size equal to 2 KB) 
  405. *                       - A value between FLASH_WRProt_Pages0to1 and
  406. *                         FLASH_WRProt_Pages60to61 or FLASH_WRProt_Pages62to255 
  407. *                       - FLASH_WRProt_AllPages
  408. * Output         : None
  409. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  410. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  411. *                  FLASH_TIMEOUT.
  412. *******************************************************************************/
  413. FLASH_Status FLASH_EnableWriteProtection(u32 FLASH_Pages)
  414. {
  415.   u16 WRP0_Data = 0xFFFF, WRP1_Data = 0xFFFF, WRP2_Data = 0xFFFF, WRP3_Data = 0xFFFF;
  416.   
  417.   FLASH_Status status = FLASH_COMPLETE;
  418.   
  419.   /* Check the parameters */
  420.   assert_param(IS_FLASH_WRPROT_PAGE(FLASH_Pages));
  421.   
  422.   FLASH_Pages = (u32)(~FLASH_Pages);
  423.   WRP0_Data = (vu16)(FLASH_Pages & WRP0_Mask);
  424.   WRP1_Data = (vu16)((FLASH_Pages & WRP1_Mask) >> 8);
  425.   WRP2_Data = (vu16)((FLASH_Pages & WRP2_Mask) >> 16);
  426.   WRP3_Data = (vu16)((FLASH_Pages & WRP3_Mask) >> 24);
  427.   
  428.   /* Wait for last operation to be completed */
  429.   status = FLASH_WaitForLastOperation(ProgramTimeout);
  430.   
  431.   if(status == FLASH_COMPLETE)
  432.   {
  433.     /* Authorizes the small information block programming */
  434.     FLASH->OPTKEYR = FLASH_KEY1;
  435.     FLASH->OPTKEYR = FLASH_KEY2;
  436.     FLASH->CR |= CR_OPTPG_Set;
  437.     if(WRP0_Data != 0xFF)
  438.     {
  439.       OB->WRP0 = WRP0_Data;
  440.       
  441.       /* Wait for last operation to be completed */
  442.       status = FLASH_WaitForLastOperation(ProgramTimeout);
  443.     }
  444.     if((status == FLASH_COMPLETE) && (WRP1_Data != 0xFF))
  445.     {
  446.       OB->WRP1 = WRP1_Data;
  447.       
  448.       /* Wait for last operation to be completed */
  449.       status = FLASH_WaitForLastOperation(ProgramTimeout);
  450.     }
  451.     if((status == FLASH_COMPLETE) && (WRP2_Data != 0xFF))
  452.     {
  453.       OB->WRP2 = WRP2_Data;
  454.       
  455.       /* Wait for last operation to be completed */
  456.       status = FLASH_WaitForLastOperation(ProgramTimeout);
  457.     }
  458.     
  459.     if((status == FLASH_COMPLETE)&& (WRP3_Data != 0xFF))
  460.     {
  461.       OB->WRP3 = WRP3_Data;
  462.      
  463.       /* Wait for last operation to be completed */
  464.       status = FLASH_WaitForLastOperation(ProgramTimeout);
  465.     }
  466.           
  467.     if(status != FLASH_BUSY)
  468.     {
  469.       /* if the program operation is completed, disable the OPTPG Bit */
  470.       FLASH->CR &= CR_OPTPG_Reset;
  471.     }
  472.   } 
  473.   /* Return the write protection operation Status */
  474.   return status;       
  475. }
  476. /*******************************************************************************
  477. * Function Name  : FLASH_ReadOutProtection
  478. * Description    : Enables or disables the read out protection.
  479. *                  If the user has already programmed the other option bytes before 
  480. *                  calling this function, he must re-program them since this 
  481. *                  function erases all option bytes.
  482. * Input          : - Newstate: new state of the ReadOut Protection.
  483. *                    This parameter can be: ENABLE or DISABLE.
  484. * Output         : None
  485. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  486. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  487. *                  FLASH_TIMEOUT.
  488. *******************************************************************************/
  489. FLASH_Status FLASH_ReadOutProtection(FunctionalState NewState)
  490. {
  491.   FLASH_Status status = FLASH_COMPLETE;
  492.   /* Check the parameters */
  493.   assert_param(IS_FUNCTIONAL_STATE(NewState));
  494.   status = FLASH_WaitForLastOperation(EraseTimeout);
  495.   if(status == FLASH_COMPLETE)
  496.   {
  497.     /* Authorizes the small information block programming */
  498.     FLASH->OPTKEYR = FLASH_KEY1;
  499.     FLASH->OPTKEYR = FLASH_KEY2;
  500.     FLASH->CR |= CR_OPTER_Set;
  501.     FLASH->CR |= CR_STRT_Set;
  502.     /* Wait for last operation to be completed */
  503.     status = FLASH_WaitForLastOperation(EraseTimeout);
  504.     if(status == FLASH_COMPLETE)
  505.     {
  506.       /* if the erase operation is completed, disable the OPTER Bit */
  507.       FLASH->CR &= CR_OPTER_Reset;
  508.       /* Enable the Option Bytes Programming operation */
  509.       FLASH->CR |= CR_OPTPG_Set; 
  510.       if(NewState != DISABLE)
  511.       {
  512.         OB->RDP = 0x00;
  513.       }
  514.       else
  515.       {
  516.         OB->RDP = RDP_Key;  
  517.       }
  518.       /* Wait for last operation to be completed */
  519.       status = FLASH_WaitForLastOperation(EraseTimeout); 
  520.     
  521.       if(status != FLASH_BUSY)
  522.       {
  523.         /* if the program operation is completed, disable the OPTPG Bit */
  524.         FLASH->CR &= CR_OPTPG_Reset;
  525.       }
  526.     }
  527.     else 
  528.     {
  529.       if(status != FLASH_BUSY)
  530.       {
  531.         /* Disable the OPTER Bit */
  532.         FLASH->CR &= CR_OPTER_Reset;
  533.       }
  534.     }
  535.   }
  536.   /* Return the protection operation Status */
  537.   return status;      
  538. }
  539.   
  540. /*******************************************************************************
  541. * Function Name  : FLASH_UserOptionByteConfig
  542. * Description    : Programs the FLASH User Option Byte: IWDG_SW / RST_STOP /
  543. *                  RST_STDBY.
  544. * Input          : - OB_IWDG: Selects the IWDG mode
  545. *                     This parameter can be one of the following values:
  546. *                     - OB_IWDG_SW: Software IWDG selected
  547. *                     - OB_IWDG_HW: Hardware IWDG selected
  548. *                  - OB_STOP: Reset event when entering STOP mode.
  549. *                     This parameter can be one of the following values:
  550. *                     - OB_STOP_NoRST: No reset generated when entering in STOP
  551. *                     - OB_STOP_RST: Reset generated when entering in STOP
  552. *                  - OB_STDBY: Reset event when entering Standby mode.
  553. *                    This parameter can be one of the following values:
  554. *                     - OB_STDBY_NoRST: No reset generated when entering in STANDBY
  555. *                     - OB_STDBY_RST: Reset generated when entering in STANDBY
  556. * Output         : None
  557. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  558. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  559. *                  FLASH_TIMEOUT.
  560. *******************************************************************************/
  561. FLASH_Status FLASH_UserOptionByteConfig(u16 OB_IWDG, u16 OB_STOP, u16 OB_STDBY)
  562. {
  563.   FLASH_Status status = FLASH_COMPLETE; 
  564.   /* Check the parameters */
  565.   assert_param(IS_OB_IWDG_SOURCE(OB_IWDG));
  566.   assert_param(IS_OB_STOP_SOURCE(OB_STOP));
  567.   assert_param(IS_OB_STDBY_SOURCE(OB_STDBY));
  568.   /* Authorize the small information block programming */
  569.   FLASH->OPTKEYR = FLASH_KEY1;
  570.   FLASH->OPTKEYR = FLASH_KEY2;
  571.   
  572.   /* Wait for last operation to be completed */
  573.   status = FLASH_WaitForLastOperation(ProgramTimeout);
  574.   
  575.   if(status == FLASH_COMPLETE)
  576.   {  
  577.     /* Enable the Option Bytes Programming operation */
  578.     FLASH->CR |= CR_OPTPG_Set; 
  579.            
  580.     OB->USER = ( OB_IWDG | OB_STOP |OB_STDBY) | (u16)0xF8; 
  581.   
  582.     /* Wait for last operation to be completed */
  583.     status = FLASH_WaitForLastOperation(ProgramTimeout);
  584.     if(status != FLASH_BUSY)
  585.     {
  586.       /* if the program operation is completed, disable the OPTPG Bit */
  587.       FLASH->CR &= CR_OPTPG_Reset;
  588.     }
  589.   }    
  590.   /* Return the Option Byte program Status */
  591.   return status;
  592. }
  593. /*******************************************************************************
  594. * Function Name  : FLASH_GetUserOptionByte
  595. * Description    : Returns the FLASH User Option Bytes values.
  596. * Input          : None
  597. * Output         : None
  598. * Return         : The FLASH User Option Bytes values:IWDG_SW(Bit0), RST_STOP(Bit1)
  599. *                  and RST_STDBY(Bit2).
  600. *******************************************************************************/
  601. u32 FLASH_GetUserOptionByte(void)
  602. {
  603.   /* Return the User Option Byte */
  604.   return (u32)(FLASH->OBR >> 2);
  605. }
  606. /*******************************************************************************
  607. * Function Name  : FLASH_GetWriteProtectionOptionByte
  608. * Description    : Returns the FLASH Write Protection Option Bytes Register value.
  609. * Input          : None
  610. * Output         : None
  611. * Return         : The FLASH Write Protection  Option Bytes Register value
  612. *******************************************************************************/
  613. u32 FLASH_GetWriteProtectionOptionByte(void)
  614. {
  615.   /* Return the Falsh write protection Register value */
  616.   return (u32)(FLASH->WRPR);
  617. }
  618. /*******************************************************************************
  619. * Function Name  : FLASH_GetReadOutProtectionStatus
  620. * Description    : Checks whether the FLASH Read Out Protection Status is set 
  621. *                  or not.
  622. * Input          : None
  623. * Output         : None
  624. * Return         : FLASH ReadOut Protection Status(SET or RESET)
  625. *******************************************************************************/
  626. FlagStatus FLASH_GetReadOutProtectionStatus(void)
  627. {
  628.   FlagStatus readoutstatus = RESET;
  629.   if ((FLASH->OBR & RDPRT_Mask) != (u32)RESET)
  630.   {
  631.     readoutstatus = SET;
  632.   }
  633.   else
  634.   {
  635.     readoutstatus = RESET;
  636.   }
  637.   return readoutstatus;
  638. }
  639. /*******************************************************************************
  640. * Function Name  : FLASH_GetPrefetchBufferStatus
  641. * Description    : Checks whether the FLASH Prefetch Buffer status is set or not.
  642. * Input          : None
  643. * Output         : None
  644. * Return         : FLASH Prefetch Buffer Status (SET or RESET).
  645. *******************************************************************************/
  646. FlagStatus FLASH_GetPrefetchBufferStatus(void)
  647. {
  648.   FlagStatus bitstatus = RESET;
  649.   
  650.   if ((FLASH->ACR & ACR_PRFTBS_Mask) != (u32)RESET)
  651.   {
  652.     bitstatus = SET;
  653.   }
  654.   else
  655.   {
  656.     bitstatus = RESET;
  657.   }
  658.   /* Return the new state of FLASH Prefetch Buffer Status (SET or RESET) */
  659.   return bitstatus; 
  660. }
  661. /*******************************************************************************
  662. * Function Name  : FLASH_ITConfig
  663. * Description    : Enables or disables the specified FLASH interrupts.
  664. * Input          : - FLASH_IT: specifies the FLASH interrupt sources to be 
  665. *                    enabled or disabled.
  666. *                    This parameter can be any combination of the following values:
  667. *                       - FLASH_IT_ERROR: FLASH Error Interrupt
  668. *                       - FLASH_IT_EOP: FLASH end of operation Interrupt
  669. * Output         : None
  670. * Return         : None 
  671. *******************************************************************************/
  672. void FLASH_ITConfig(u16 FLASH_IT, FunctionalState NewState)
  673. {
  674.   /* Check the parameters */
  675.   assert_param(IS_FLASH_IT(FLASH_IT)); 
  676.   assert_param(IS_FUNCTIONAL_STATE(NewState));
  677.   if(NewState != DISABLE)
  678.   {
  679.     /* Enable the interrupt sources */
  680.     FLASH->CR |= FLASH_IT;
  681.   }
  682.   else
  683.   {
  684.     /* Disable the interrupt sources */
  685.     FLASH->CR &= ~(u32)FLASH_IT;
  686.   }
  687. }
  688. /*******************************************************************************
  689. * Function Name  : FLASH_GetFlagStatus
  690. * Description    : Checks whether the specified FLASH flag is set or not.
  691. * Input          : - FLASH_FLAG: specifies the FLASH flag to check.
  692. *                     This parameter can be one of the following values:
  693. *                    - FLASH_FLAG_BSY: FLASH Busy flag           
  694. *                    - FLASH_FLAG_PGERR: FLASH Program error flag       
  695. *                    - FLASH_FLAG_WRPRTERR: FLASH Write protected error flag      
  696. *                    - FLASH_FLAG_EOP: FLASH End of Operation flag           
  697. *                    - FLASH_FLAG_OPTERR:  FLASH Option Byte error flag     
  698. * Output         : None
  699. * Return         : The new state of FLASH_FLAG (SET or RESET).
  700. *******************************************************************************/
  701. FlagStatus FLASH_GetFlagStatus(u16 FLASH_FLAG)
  702. {
  703.   FlagStatus bitstatus = RESET;
  704.   /* Check the parameters */
  705.   assert_param(IS_FLASH_GET_FLAG(FLASH_FLAG)) ;
  706.   if(FLASH_FLAG == FLASH_FLAG_OPTERR) 
  707.   {
  708.     if((FLASH->OBR & FLASH_FLAG_OPTERR) != (u32)RESET)
  709.     {
  710.       bitstatus = SET;
  711.     }
  712.     else
  713.     {
  714.       bitstatus = RESET;
  715.     }
  716.   }
  717.   else
  718.   {
  719.    if((FLASH->SR & FLASH_FLAG) != (u32)RESET)
  720.     {
  721.       bitstatus = SET;
  722.     }
  723.     else
  724.     {
  725.       bitstatus = RESET;
  726.     }
  727.   }
  728.   /* Return the new state of FLASH_FLAG (SET or RESET) */
  729.   return bitstatus;
  730. }
  731. /*******************************************************************************
  732. * Function Name  : FLASH_ClearFlag
  733. * Description    : Clears the FLASH抯 pending flags.
  734. * Input          : - FLASH_FLAG: specifies the FLASH flags to clear.
  735. *                    This parameter can be any combination of the following values:
  736. *                    - FLASH_FLAG_BSY: FLASH Busy flag           
  737. *                    - FLASH_FLAG_PGERR: FLASH Program error flag       
  738. *                    - FLASH_FLAG_WRPRTERR: FLASH Write protected error flag      
  739. *                    - FLASH_FLAG_EOP: FLASH End of Operation flag           
  740. * Output         : None
  741. * Return         : None
  742. *******************************************************************************/
  743. void FLASH_ClearFlag(u16 FLASH_FLAG)
  744. {
  745.   /* Check the parameters */
  746.   assert_param(IS_FLASH_CLEAR_FLAG(FLASH_FLAG)) ;
  747.   
  748.   /* Clear the flags */
  749.   FLASH->SR = FLASH_FLAG;
  750. }
  751. /*******************************************************************************
  752. * Function Name  : FLASH_GetStatus
  753. * Description    : Returns the FLASH Status.
  754. * Input          : None
  755. * Output         : None
  756. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  757. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP or FLASH_COMPLETE
  758. *******************************************************************************/
  759. FLASH_Status FLASH_GetStatus(void)
  760. {
  761.   FLASH_Status flashstatus = FLASH_COMPLETE;
  762.   
  763.   if((FLASH->SR & FLASH_FLAG_BSY) == FLASH_FLAG_BSY) 
  764.   {
  765.     flashstatus = FLASH_BUSY;
  766.   }
  767.   else 
  768.   {  
  769.     if(FLASH->SR & FLASH_FLAG_PGERR)
  770.     { 
  771.       flashstatus = FLASH_ERROR_PG;
  772.     }
  773.     else 
  774.     {
  775.       if(FLASH->SR & FLASH_FLAG_WRPRTERR)
  776.       {
  777.         flashstatus = FLASH_ERROR_WRP;
  778.       }
  779.       else
  780.       {
  781.         flashstatus = FLASH_COMPLETE;
  782.       }
  783.     }
  784.   }
  785.   /* Return the Flash Status */
  786.   return flashstatus;
  787. }
  788. /*******************************************************************************
  789. * Function Name  : FLASH_WaitForLastOperation
  790. * Description    : Waits for a Flash operation to complete or a TIMEOUT to occur.
  791. * Input          : - Timeout: FLASH progamming Timeout
  792. * Output         : None
  793. * Return         : FLASH Status: The returned value can be: FLASH_BUSY, 
  794. *                  FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE or 
  795. *                  FLASH_TIMEOUT.
  796. *******************************************************************************/
  797. FLASH_Status FLASH_WaitForLastOperation(u32 Timeout)
  798.   FLASH_Status status = FLASH_COMPLETE;
  799.    
  800.   /* Check for the Flash Status */
  801.   status = FLASH_GetStatus();
  802.   /* Wait for a Flash operation to complete or a TIMEOUT to occur */
  803.   while((status == FLASH_BUSY) && (Timeout != 0x00))
  804.   {
  805.     delay();
  806.     status = FLASH_GetStatus();
  807.     Timeout--;
  808.   }
  809.   if(Timeout == 0x00 )
  810.   {
  811.     status = FLASH_TIMEOUT;
  812.   }
  813.   /* Return the operation status */
  814.   return status;
  815. }
  816. /*******************************************************************************
  817. * Function Name  : delay
  818. * Description    : Inserts a time delay.
  819. * Input          : None
  820. * Output         : None
  821. * Return         : None
  822. *******************************************************************************/
  823. static void delay(void)
  824. {
  825.   vu32 i = 0;
  826.   for(i = 0xFF; i != 0; i--)
  827.   {
  828.   }
  829. }
  830. #endif
  831. /******************* (C) COPYRIGHT 2008 STMicroelectronics *****END OF FILE****/