mirror of
https://github.com/STMicroelectronics/STM32CubeF0.git
synced 2025-05-05 19:29:46 +08:00
365 lines
12 KiB
C
365 lines
12 KiB
C
/**
|
|
******************************************************************************
|
|
* @file FLASH/FLASH_WriteProtection/Src/main.c
|
|
* @author MCD Application Team
|
|
* @brief This example provides a description of how to set write protection on
|
|
* STM32F0xx FLASH.
|
|
******************************************************************************
|
|
* @attention
|
|
*
|
|
* <h2><center>© Copyright (c) 2016 STMicroelectronics.
|
|
* All rights reserved.</center></h2>
|
|
*
|
|
* This software component is licensed by ST under BSD 3-Clause license,
|
|
* the "License"; You may not use this file except in compliance with the
|
|
* License. You may obtain a copy of the License at:
|
|
* opensource.org/licenses/BSD-3-Clause
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
|
|
/* Includes ------------------------------------------------------------------*/
|
|
#include "main.h"
|
|
|
|
/** @addtogroup STM32F0xx_HAL_Examples
|
|
* @{
|
|
*/
|
|
|
|
/** @addtogroup FLASH_WriteProtection
|
|
* @{
|
|
*/
|
|
|
|
/* Private typedef -----------------------------------------------------------*/
|
|
typedef enum {FAILED = 0, PASSED = !FAILED} TestStatus;
|
|
/* Private define ------------------------------------------------------------*/
|
|
|
|
/* Uncomment this line to Enable Write Protection */
|
|
//#define WRITE_PROTECTION_ENABLE
|
|
|
|
/* Uncomment this line to Disable Write Protection */
|
|
#define WRITE_PROTECTION_DISABLE
|
|
|
|
#define FLASH_USER_START_ADDR ADDR_FLASH_PAGE_24 /* Start @ of user Flash area */
|
|
#define FLASH_USER_END_ADDR ADDR_FLASH_PAGE_28 /* End @ of user Flash area */
|
|
#define FLASH_PAGE_TO_BE_PROTECTED (OB_WRP_PAGES24TO25 | OB_WRP_PAGES26TO27)
|
|
|
|
#define DATA_32 ((uint32_t)0x12345678)
|
|
|
|
/* Check the status of the switches */
|
|
/* Enable by default the disable protection */
|
|
#if !defined(WRITE_PROTECTION_ENABLE)&&!defined(WRITE_PROTECTION_DISABLE)
|
|
#define WRITE_PROTECTION_DISABLE
|
|
#endif /* !WRITE_PROTECTION_ENABLE && !WRITE_PROTECTION_DISABLE */
|
|
|
|
/* Both switches cannot be enabled in the same time */
|
|
#if defined(WRITE_PROTECTION_ENABLE)&&defined(WRITE_PROTECTION_DISABLE)
|
|
#error "Switches WRITE_PROTECTION_ENABLE & WRITE_PROTECTION_DISABLE cannot be enabled in the time!"
|
|
#endif /* WRITE_PROTECTION_ENABLE && WRITE_PROTECTION_DISABLE */
|
|
|
|
/* Private macro -------------------------------------------------------------*/
|
|
/* Private variables ---------------------------------------------------------*/
|
|
uint32_t Address = 0;
|
|
uint32_t PageError = 0;
|
|
__IO TestStatus MemoryProgramStatus = PASSED;
|
|
/*Variable used for Erase procedure*/
|
|
static FLASH_EraseInitTypeDef EraseInitStruct;
|
|
/*Variable used to handle the Options Bytes*/
|
|
static FLASH_OBProgramInitTypeDef OptionsBytesStruct;
|
|
|
|
/* Private function prototypes -----------------------------------------------*/
|
|
void SystemClock_Config(void);
|
|
|
|
/* Private functions ---------------------------------------------------------*/
|
|
|
|
/**
|
|
* @brief Main program
|
|
* @param None
|
|
* @retval None
|
|
*/
|
|
int main(void)
|
|
{
|
|
/* STM32F0xx HAL library initialization:
|
|
- Configure the Flash prefetch
|
|
- Systick timer is configured by default as source of time base, but user
|
|
can eventually implement his proper time base source (a general purpose
|
|
timer for example or other time source), keeping in mind that Time base
|
|
duration should be kept 1ms since PPP_TIMEOUT_VALUEs are defined and
|
|
handled in milliseconds basis.
|
|
- Low Level Initialization
|
|
*/
|
|
HAL_Init();
|
|
|
|
/* Configure the system clock to 48 MHz */
|
|
SystemClock_Config();
|
|
|
|
/* Initialize LED2 */
|
|
BSP_LED_Init(LED2);
|
|
|
|
/* Initialize test status */
|
|
MemoryProgramStatus = PASSED;
|
|
|
|
/* Unlock the Flash to enable the flash control register access *************/
|
|
HAL_FLASH_Unlock();
|
|
|
|
/* Unlock the Options Bytes *************************************************/
|
|
HAL_FLASH_OB_Unlock();
|
|
|
|
/* Get pages write protection status ****************************************/
|
|
HAL_FLASHEx_OBGetConfig(&OptionsBytesStruct);
|
|
|
|
#ifdef WRITE_PROTECTION_DISABLE
|
|
/* Check if desired pages are already write protected ***********************/
|
|
if((OptionsBytesStruct.WRPPage & FLASH_PAGE_TO_BE_PROTECTED) != FLASH_PAGE_TO_BE_PROTECTED)
|
|
{
|
|
/* Restore write protected pages */
|
|
OptionsBytesStruct.OptionType = OPTIONBYTE_WRP;
|
|
OptionsBytesStruct.WRPState = OB_WRPSTATE_DISABLE;
|
|
OptionsBytesStruct.WRPPage = FLASH_PAGE_TO_BE_PROTECTED;
|
|
if(HAL_FLASHEx_OBProgram(&OptionsBytesStruct) != HAL_OK)
|
|
{
|
|
/* Error occurred while options bytes programming. **********************/
|
|
while (1)
|
|
{
|
|
/* Make LED2 blink (100ms on, 2s off) to indicate error in OB programming operation */
|
|
BSP_LED_On(LED2);
|
|
HAL_Delay(100);
|
|
BSP_LED_Off(LED2);
|
|
HAL_Delay(2000);
|
|
}
|
|
}
|
|
|
|
/* Generate System Reset to load the new option byte values ***************/
|
|
HAL_FLASH_OB_Launch();
|
|
}
|
|
#elif defined WRITE_PROTECTION_ENABLE
|
|
/* Check if desired pages are not yet write protected ***********************/
|
|
if(((~OptionsBytesStruct.WRPPage) & FLASH_PAGE_TO_BE_PROTECTED )!= FLASH_PAGE_TO_BE_PROTECTED)
|
|
{
|
|
/* Enable the pages write protection **************************************/
|
|
OptionsBytesStruct.OptionType = OPTIONBYTE_WRP;
|
|
OptionsBytesStruct.WRPState = OB_WRPSTATE_ENABLE;
|
|
OptionsBytesStruct.WRPPage = FLASH_PAGE_TO_BE_PROTECTED;
|
|
if(HAL_FLASHEx_OBProgram(&OptionsBytesStruct) != HAL_OK)
|
|
{
|
|
/* Error occurred while options bytes programming. **********************/
|
|
while (1)
|
|
{
|
|
/* Make LED2 blink (100ms on, 2s off) to indicate error in OB programming operation */
|
|
BSP_LED_On(LED2);
|
|
HAL_Delay(100);
|
|
BSP_LED_Off(LED2);
|
|
HAL_Delay(2000);
|
|
}
|
|
}
|
|
|
|
/* Generate System Reset to load the new option byte values ***************/
|
|
HAL_FLASH_OB_Launch();
|
|
}
|
|
#endif /* WRITE_PROTECTION_DISABLE */
|
|
|
|
/* Lock the Options Bytes *************************************************/
|
|
HAL_FLASH_OB_Lock();
|
|
|
|
/* The selected pages are not write protected *******************************/
|
|
if ((OptionsBytesStruct.WRPPage & FLASH_PAGE_TO_BE_PROTECTED) != 0x00)
|
|
{
|
|
/* Fill EraseInit structure************************************************/
|
|
EraseInitStruct.TypeErase = FLASH_TYPEERASE_PAGES;
|
|
EraseInitStruct.PageAddress = FLASH_USER_START_ADDR;
|
|
EraseInitStruct.NbPages = (FLASH_USER_END_ADDR - FLASH_USER_START_ADDR)/FLASH_PAGE_SIZE;
|
|
|
|
if (HAL_FLASHEx_Erase(&EraseInitStruct, &PageError) != HAL_OK)
|
|
{
|
|
/*
|
|
Error occurred while page erase.
|
|
User can add here some code to deal with this error.
|
|
PageError will contain the faulty page and then to know the code error on this page,
|
|
user can call function 'HAL_FLASH_GetError()'
|
|
*/
|
|
while (1)
|
|
{
|
|
/* Make LED2 blink (100ms on, 2s off) to indicate error in Erase operation */
|
|
BSP_LED_On(LED2);
|
|
HAL_Delay(100);
|
|
BSP_LED_Off(LED2);
|
|
HAL_Delay(2000);
|
|
}
|
|
}
|
|
|
|
/* FLASH Word program of DATA_32 at addresses defined by FLASH_USER_START_ADDR and FLASH_USER_END_ADDR */
|
|
Address = FLASH_USER_START_ADDR;
|
|
while (Address < FLASH_USER_END_ADDR)
|
|
{
|
|
if (HAL_FLASH_Program(FLASH_TYPEPROGRAM_WORD, Address, DATA_32) == HAL_OK)
|
|
{
|
|
Address = Address + 4;
|
|
}
|
|
else
|
|
{
|
|
/* Error occurred while writing data in Flash memory.
|
|
User can add here some code to deal with this error */
|
|
while (1)
|
|
{
|
|
/* Make LED2 blink (100ms on, 2s off) to indicate error in Write operation */
|
|
BSP_LED_On(LED2);
|
|
HAL_Delay(100);
|
|
BSP_LED_Off(LED2);
|
|
HAL_Delay(2000);
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Check the correctness of written data */
|
|
Address = FLASH_USER_START_ADDR;
|
|
|
|
while (Address < FLASH_USER_END_ADDR)
|
|
{
|
|
if((*(__IO uint32_t*) Address) != DATA_32)
|
|
{
|
|
MemoryProgramStatus = FAILED;
|
|
}
|
|
Address += 4;
|
|
}
|
|
}
|
|
else
|
|
{
|
|
/* The desired pages are write protected */
|
|
/* Check that it is not allowed to write in this page */
|
|
Address = FLASH_USER_START_ADDR;
|
|
if (HAL_FLASH_Program(FLASH_TYPEPROGRAM_WORD, Address, DATA_32) != HAL_OK)
|
|
{
|
|
/* Error returned during programming. */
|
|
/* Check that WRPERR flag is well set */
|
|
if (HAL_FLASH_GetError() == HAL_FLASH_ERROR_WRP)
|
|
{
|
|
MemoryProgramStatus = FAILED;
|
|
}
|
|
else
|
|
{
|
|
/* Another error occurred.
|
|
User can add here some code to deal with this error */
|
|
while (1)
|
|
{
|
|
/* Make LED2 blink (100ms on, 2s off) to indicate error in Write operation */
|
|
BSP_LED_On(LED2);
|
|
HAL_Delay(100);
|
|
BSP_LED_Off(LED2);
|
|
HAL_Delay(2000);
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
/* Write operation is successful. Should not occur
|
|
User can add here some code to deal with this error */
|
|
while (1)
|
|
{
|
|
/* Make LED2 blink (100ms on, 2s off) to indicate error in Write operation */
|
|
BSP_LED_On(LED2);
|
|
HAL_Delay(100);
|
|
BSP_LED_Off(LED2);
|
|
HAL_Delay(2000);
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Lock the Flash to disable the flash control register access (recommended
|
|
to protect the FLASH memory against possible unwanted operation) *********/
|
|
HAL_FLASH_Lock();
|
|
|
|
/*Check if there is an issue to program data*/
|
|
if (MemoryProgramStatus == PASSED)
|
|
{
|
|
/* No error detected. Switch on LED2*/
|
|
BSP_LED_On(LED2);
|
|
}
|
|
else
|
|
{
|
|
/* Error detected. LED2 will blink with 1s period */
|
|
while (1)
|
|
{
|
|
BSP_LED_On(LED2);
|
|
HAL_Delay(1000);
|
|
BSP_LED_Off(LED2);
|
|
HAL_Delay(1000);
|
|
}
|
|
}
|
|
|
|
/* Infinite loop */
|
|
while (1)
|
|
{
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @brief System Clock Configuration
|
|
* The system Clock is configured as follow :
|
|
* System Clock source = PLL (HSI)
|
|
* SYSCLK(Hz) = 48000000
|
|
* HCLK(Hz) = 48000000
|
|
* AHB Prescaler = 1
|
|
* APB1 Prescaler = 1
|
|
* HSI Frequency(Hz) = 8000000
|
|
* PREDIV = 2
|
|
* PLLMUL = 12
|
|
* Flash Latency(WS) = 1
|
|
* @param None
|
|
* @retval None
|
|
*/
|
|
void SystemClock_Config(void)
|
|
{
|
|
RCC_ClkInitTypeDef RCC_ClkInitStruct;
|
|
RCC_OscInitTypeDef RCC_OscInitStruct;
|
|
|
|
/* No HSE Oscillator on Nucleo, Activate PLL with HSI as source */
|
|
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_NONE;
|
|
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
|
|
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSI;
|
|
RCC_OscInitStruct.PLL.PREDIV = RCC_PREDIV_DIV2;
|
|
RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL12;
|
|
if (HAL_RCC_OscConfig(&RCC_OscInitStruct)!= HAL_OK)
|
|
{
|
|
/* Initialization Error */
|
|
while(1);
|
|
}
|
|
|
|
/* Select PLL as system clock source and configure the HCLK, PCLK1 clocks dividers */
|
|
RCC_ClkInitStruct.ClockType = (RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1);
|
|
RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
|
|
RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
|
|
RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1;
|
|
if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_1)!= HAL_OK)
|
|
{
|
|
/* Initialization Error */
|
|
while(1);
|
|
}
|
|
}
|
|
#ifdef USE_FULL_ASSERT
|
|
/**
|
|
* @brief Reports the name of the source file and the source line number
|
|
* where the assert_param error has occurred.
|
|
* @param file: pointer to the source file name
|
|
* @param line: assert_param error line source number
|
|
* @retval None
|
|
*/
|
|
void assert_failed(uint8_t *file, uint32_t line)
|
|
{
|
|
/* User can add his own implementation to report the file name and line number,
|
|
ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
|
|
|
|
/* Infinite loop */
|
|
while (1)
|
|
{
|
|
}
|
|
}
|
|
#endif
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
|