FLASH Programming in STM32

Every microcontroller have some memory allocated for the user flash. Today We will use this memory to store some data in it. The benefit of using this flash memory is that, even after the power disconnect, the data remains safe in the flash memory.

This tutorial is devided into two halves. The first Half will cover those microcontrollers, whose memory is divided into pages. For eg- Cortex M3, and M0 series. The second Half is for those microcontrollers, whose memory is divided into Sectors.

H7 Series users can get the files from https://github.com/controllerstech/STM32/tree/master/FLASH_PROGRAM/H7%20SERIES

FLASH PAGE TYPE

For the first half, I am using STM32F103 microcontroller, and you can see the memory distribution in the picture below

As you can see above that the main memory (Flash memory) is distributed in 128 pages. Each page is of 1 KB, thus making the total memory of 128 KB

Now always remember that we should start programming as lower as possible in the flash memory. This is because the start of the flash is already allocated to the program, that is being executed on your controller right now. I have explained it properly in the video, you can check that out in the end.

Each page can hold 1024 Bytes of data, and i don’t have much data to write, so I will choose the last page of the flash memory, i.e. 0x0801FC00 – 0x0801FFFF


Some insight into the CODE

Write Data to FLASH

Below is the function to write the data into the Flash.

uint32_t Flash_Write_Data (uint32_t StartPageAddress, uint32_t *Data, uint16_t numberofwords);

The function Flash_Write_Data takes the following parameters

  • @ StartPageAddress is the address of the Start page, or memory in the page, from where you want to start writing the data.
  • @ Data is the pointer to the 32 bit data array, that you want to write into the flash.
  • @ numberofwords is the number of words, that you want to write in the memory.

The function is very big to be able to explain here. But here are few important hings that it does in order to write the data into the given memory location.

  • Flash will be Unlocked to make modifications.
  • Based on the number of words and start page address, it will calculate the number of pages required to store that data into.
  • Next, the required number of pages will be erased, and the new data will be written into them.
  • Flash will be Locked again.

Read Data from FLASH

Below is the function to read the data from the Flash.

void Flash_Read_Data (uint32_t StartPageAddress, uint32_t *RxBuf, uint16_t numberofwords);

The function Flash_Read_Data reads the data from the flash. It takes the following parameters

  • StartPageAddress is the Start address of the page, from where you want to start reading the data.
  • RxBuf is the address of the 32 bit array, where you want to store the data.
  • numberofwords is the number of words that you want to read from the memory.

Main Function

char *data = "hello FLASH from ControllerTech\
	      This is a test to see how many words can we work with";

uint32_t data2[] = {0x1,0x2,0x3,0x4,0x5,0x6,0x7,0x8,0x9};
uint32_t Rx_Data[30];
char string[100];

int number = 123;
float val = 123.456;
float RxVal;

  Flash_Write_Data(0x08004410 , (uint32_t *)data2, 9);
  Flash_Read_Data(0x08004410 , Rx_Data, 10);


  int numofwords = (strlen(data)/4)+((strlen(data)%4)!=0);
  Flash_Write_Data(0x08004810 , (uint32_t *)data, numofwords);
  Flash_Read_Data(0x08004810 , Rx_Data, numofwords);
  Convert_To_Str(Rx_Data, string);


  Flash_Write_NUM(0x08005C10, number);
  RxVal = Flash_Read_NUM(0x08005C10);

  Flash_Write_NUM(0x08012000, val);
  RxVal = Flash_Read_NUM(0x08012000);

Here I am writing 4 different data types to the different locations in the memory.

After we perform the read, the same data will be available, and this indicates that the write and read was successful.


Result

Check out the Video Below



FLASH SECTOR TYPE

Some microcontrollers have memory distributed in Sectors.

In my STM32F446RE, there are 7 sectors and the size is varying between them. Similarly, some microcontrollers can have 11, 15 or 23 sectors. This code will cover all these types, irrespective of the number of sectors the controller have.

IMPORTANT

If the memory for the controller is arranged in dual banks, like Bank1 or Bank2, by defaults these Banks are disabled and the memory uses only single Bank addressing. Check the sector addresses in the single Bank distribution.

Also, if the sector sizes are different than as shown in the picture above, All you need to do is, define new sectors as according to your device datasheet in the function static uint32_t GetSector(uint32_t Address)

Some insight into the CODE

Write Data to FLASH

uint32_t Flash_Write_Data (uint32_t StartSectorAddress, uint32_t *Data, uint16_t numberofwords)
{

	static FLASH_EraseInitTypeDef EraseInitStruct;
	uint32_t SECTORError;
	int sofar=0;


	 /* Unlock the Flash to enable the flash control register access *************/
	  HAL_FLASH_Unlock();

	  /* Erase the user Flash area */

	  /* Get the number of sector to erase from 1st sector */

	  uint32_t StartSector = GetSector(StartSectorAddress);
	  uint32_t EndSectorAddress = StartSectorAddress + numberofwords*4;
	  uint32_t EndSector = GetSector(EndSectorAddress);

	  /* Fill EraseInit structure*/
	  EraseInitStruct.TypeErase     = FLASH_TYPEERASE_SECTORS;
	  EraseInitStruct.VoltageRange  = FLASH_VOLTAGE_RANGE_3;
	  EraseInitStruct.Sector        = StartSector;
	  EraseInitStruct.NbSectors     = (EndSector - StartSector) + 1;

	  /* Note: If an erase operation in Flash memory also concerns data in the data or instruction cache,
	     you have to make sure that these data are rewritten before they are accessed during code
	     execution. If this cannot be done safely, it is recommended to flush the caches by setting the
	     DCRST and ICRST bits in the FLASH_CR register. */
	  if (HAL_FLASHEx_Erase(&EraseInitStruct, &SECTORError) != HAL_OK)
	  {
		  return HAL_FLASH_GetError ();
	  }

	  /* Program the user Flash area word by word
	    (area defined by FLASH_USER_START_ADDR and FLASH_USER_END_ADDR) ***********/

	   while (sofar<numberofwords)
	   {
	     if (HAL_FLASH_Program(FLASH_TYPEPROGRAM_WORD, StartSectorAddress, Data[sofar]) == HAL_OK)
	     {
	    	 StartSectorAddress += 4;  // use StartPageAddress += 2 for half word and 8 for double word
	    	 sofar++;
	     }
	     else
	     {
	       /* Error occurred while writing data in Flash memory*/
	    	 return HAL_FLASH_GetError ();
	     }
	   }

	  /* Lock the Flash to disable the flash control register access (recommended
	     to protect the FLASH memory against possible unwanted operation) *********/
	  HAL_FLASH_Lock();

	   return 0;
}
  • Flash_Write_Data will write data to the given memory location.
  • It will calculate the start sector number based on the address given in the parameter
  • then, the sector address of the sector where the data is going to end
  • and finally the sector number of the last sector
  • It will than erase the required number of sectors and program it with the new data

Read Data from FLASH

void Flash_Read_Data (uint32_t StartSectorAddress, uint32_t *RxBuf, uint16_t numberofwords)
{
	while (1)
	{

		*RxBuf = *(__IO uint32_t *)StartSectorAddress;
		StartSectorAddress += 4;
		RxBuf++;
		if (!(numberofwords--)) break;
	}
}

Flash_Read_Data will read the given amount of words from the memory location, and save it in the RxBuf


Main Function

char *data = "hello FLASH from ControllerTech\
			  This is a test to see how many words can we work with";

uint32_t data2[] = {0x1,0x2,0x3,0x4,0x5,0x6,0x7,0x8,0x9};

uint32_t Rx_Data[30];

char string[100];

int number = 123;

float val = 123.456;

float RxVal;

  Flash_Write_Data(0x08004100 , (uint32_t *)data2, 9);
  Flash_Read_Data(0x08004100 , Rx_Data, 10);


  int numofwords = (strlen(data)/4)+((strlen(data)%4)!=0);
  Flash_Write_Data(0x08008100 , (uint32_t *)data, numofwords);
  Flash_Read_Data(0x08008100 , Rx_Data, numofwords);
  Convert_To_Str(Rx_Data, string);


  Flash_Write_NUM(0x0800C100, number);
  RxVal = Flash_Read_NUM(0x0800C100);

  Flash_Write_NUM(0x0800D100, val);
  RxVal = Flash_Read_NUM(0x0800D100);

Here I am writing 4 different data types to the different locations in the memory.

After we perform the read, the same data will be available, and this indicates that the write and read was successful.


Result

Check out the Video Below




Info

You can help with the development by DONATING Below.
To download the project, click the DOWNLOAD button.

Subscribe
Notify of

70 Comments
Newest
Oldest Most Voted
Inline Feedbacks
View all comments
Filo
3 months ago

Hello Thanks for the tutorial.
Writing and reading is working for me, BUT when i then try to program again my MCU after a writing the prog/debugger can complete anymore the interaction.

I see error
Error message from debugger back end:
Error finishing flash operation
Error finishing flash operation

in order to be able to program/debug again i have to make a full erase and comment the writing function and reprogram.

I’m using a stm32F439 ZI.

Thanks again!

damar
Reply to  Filo
1 month ago
Sorabh
Reply to  damar
1 month ago

Hey i have similar issue and tried to email but the email does ot exist

Christian
10 months ago

Thanks for the great tutorial. Helped me a lot. I noticed one minor bug in Flash_Read_Data. It should be
if (!(–numberofwords)) break;
instead of
if (!(numberofwords–)) break;
Otherwise there will be one additional loop run that might cause problems.

Christian
10 months ago

Thanks for this great tutorial. Helped me a lot. I noticed one minor bug in Flash_Read_Data. The line
if (!(numberofwords–)) break;
should be prefix decrement. So it should be changed to
if (!(–numberofwords)) break;
Otherwise there is one extra loop run.

Travis
1 year ago

I’m using your code from Github and I’m using STM32F103RC as well but the code didn’t work. I’m using the address 0x08005C10 and 0x08005D10. Write NUM function did not actually wrote anything into the flash (as I checked with the monitor it didn’t) and read NUM function only returns 0.

Mskumar
1 year ago

Hello Sir,
We are using STM32L432 and we are always getting error code as 128 that is FLASH_FLAG_MISERR. There are 2 changes done in our software.
EraseInitStruct does not have PageAddress element
EraseInitStruct.PageAddress = StartPage;
This was updated as
EraseInitStruct.Page = 127;

This error FLASH_FLAG_MISERR is appeared as part of the Page erase process. the following function output was 1.
status = FLASH_WaitForLastOperation((uint32_t)FLASH_TIMEOUT_VALUE);

The following error output was 128

error = (FLASH->SR & FLASH_FLAG_SR_ERRORS);

Do we have the example software for page erase for STM32L432 please?
Show less

Mskumar
1 year ago

Hello Sir,
We could write once and we are anot able to erase and update the last page. It looks like the flash is write protected. I meant we can compile and flash the chip. but we are not able erase the last page in our application software. How do we know the flash is write protected and How to clear the write protect before page erase? Could you please help us out?

Hieule
1 year ago

I’m working on STM32H750 with FreeRTOS and code not work, the function HAL_FLASHEx_Erase error, the function run to FLASH_WaitForLastOperation and return HAL_TIMEOUT.
When i comment:
if (HAL_FLASHEx_Erase(&EraseInitStruct, &SECTORError) != HAL_OK)
{
return HAL_FLASH_GetError();
}
program work fine.

What the happen, I’m a little confused here. Do you have any suggest for me.

ItiLan
2 years ago

Hello,

I would like to know, Why a STM32 board binary code doesn’t run after I just flashed back to it of what I just red from the same board by using STM32 Cube Programmer?

Akash
2 years ago

Hi. It’s awesome tutorial. I have one question here.) What will happen to data in flash if power off and on

2) what will happen, if we flash again with read only function in main loop

Aljaz
2 years ago

Hi! Awesome tutorial, thanks for proper insight 🙂
Short question, why do you need to typecast again the pointer to array (uint32_t *) in the function Flash_Write_Data?
I am a little confused here 😀
Thanks!!

Mike
3 years ago

Hi,
I’m using STM32F429. I found your flash_sector_f4.c perfectly suited to my initial needs of storing binary data in a sector of flash. Thank you!

Now I’d like to be able to overwrite my running firmware with a new application after I’ve gotten it into RAM. I can’t use the built in bootloader. Is there an example of that anywhere? Thanks, Mike

Aditya Singh
Reply to  Mike
2 years ago

You should check out this video series https://youtu.be/OkUQ3iMmiYQ

Eran
3 years ago

Hello,

I use STM32H725.
I need to implement Flash_Write_Data() at Low Level , without HAL .
Does anyone have low-level realization experience Write flash?

andres
3 years ago

hello I have a problem

I can’t find the Flash_Write_NUM and Flash_Read_NUM functions

Vinicius Morais
3 years ago

Para stm32F030C8, sua memória flash é páginas, mas quantas?

damar
Reply to  Vinicius Morais
1 month ago

gracias

Andres
3 years ago

Hello

I have a question, and how can I get the free memory space I have left?

is there a HAL command?

Greetings from Colombia, your projects have helped me a lot

Emanuel
3 years ago

I’m work with the STM32F429 and stmcubeide. I’ve a error – conflicting types for ‘Flash_Write_Data’- when call a function uint32_t Flash_Write_Data (uint32_t StartSectorAddress, uint32_t *Data, uint16_t numberofwords)
{

 int numofwords = (strlen(data)/4)+((strlen(data)%4)!=0);
  Flash_Write_Data(0x08008100 , (uint32_t *)data, numofwords);
  Flash_Read_Data(0x08008100 , Rx_Data, numofwords);

  sprintf(teste_data2_char, “%d”, Rx_Data);

  HAL_UART_Transmit(&huart1, (uint8_t *) teste_data2_char, strlen(teste_data2_char),500);

Emanuel Francisco Vicentini Carvalho
3 years ago

.

Last edited 3 years ago by Emanuel Francisco Vicentini Carvalho
Amaury
3 years ago

Hello sir Thank you very much for this code. I am working with the STM32G474RE. With your code I manage to write it but the delete is still not possible, what should I change or add? Thanks

Last edited 3 years ago by Amaury
Amaury
Reply to  admin
3 years ago

hello dear

I used the “Flash Page Type”.

I do not know why I manage to write, but Erasing does not work, I always have to go through STM32 ST-LINK utility to be able to delete. could you please help me ?

Amaury
Reply to  admin
3 years ago

unfortunately I’m only a beginner in this field, I don’t know how to force my controller to use the single Bank. Thank you once again for your time and your answers

Last edited 3 years ago by Amaury
DesperateStudent
Reply to  Amaury
2 years ago

I am also working with STM32G474RE. Could you please share your insights or maybe even your code how you managed to write to the flash? Thank you so much!

kishor sherolla
4 years ago

hello sir .. i am new to this 32 bit this controller. i am writing code for stm32f207. while writing the flash ,controller gets stops in erase function, what is the problem , i am using base address is sector a10 and end address is sector11 .actually my flash data is 150 bytes only

Corn
4 years ago

If this FLASH_PAGE would be used with STM32L4 series where page size is 64bits, how big of a modification would this need? Thank you.

aphonse
Reply to  Corn
3 years ago

I also want to use the program for stm32L4 series please help as i got error while writing in similar fashion

Maki
Reply to  aphonse
3 years ago

Thanks to the Admin for sharing the Knowledge! Did someone manage to change the code for a STM32L4xx, in my case L452 (512x1Kb Pages)?

reza
4 years ago

i write this code in keil MDK but has error for “(strlen(DATA_32)”
ERROR text:
(..\Src\FlASH_PAGE.c(109): error: #167: argument of type “uint32_t *” is incompatible with parameter of type “const char *”)

Chandler TIMM CAGMAT Doloriel
4 years ago

How can I use this code if my data is uint8_t?

Muhammed Imdaad
4 years ago

I cant use the read function for ota purposes because in your function it only breaks when there is an empty cell. otherwise it runs until the end!!!!!!!!!!!!!!!!
therefore I added size parameter.

Last edited 4 years ago by Muhammed Imdaad
Filip
4 years ago

Hi!
I want to report some bug in FLASH_SECTOR. During saving I was getting a hardfault. The problem is that function HAL_FLASH_Program() expects the address of the variable to be saved. And you send a value DATA_32[sofar]. It should be the address: &DATA_32[sofar]. Great job again 🙂
Greetings!
F.Rak

Last edited 4 years ago by Filip
Filip
Reply to  Filip
4 years ago

In FLASH_SECTOR read function should be some other stop condition. Your stop condition is when you find 0xffffffff value in the array where you store read data. When this array is defined as global, the momory is alocated just for given array size. So when you want to read 2 bytes then you define array for 2 elements. In memory is alocated only 2 cells. After this 2 cells, other program data exist. So when you read in flash_sector_read more then 2 bytes you will plow the memory. This function should get one more parameter that is number of variables to read. Then one if statement it works much better.
Regards,
F.Rak

Mike
4 years ago

When I write to the Flash I get memory protection and page alignment errors

Nor
4 years ago

Hi Sir.

How to find start page address ? In datasheet show page 127 address. I want to know another start page address.

Nor
Reply to  admin
4 years ago

Oh… Thanks. May I dump.
ex- 111*1024=113664(0x1bc00) right?
Thanks again.

Nor
Reply to  admin
4 years ago

I copy your library and your code. Then string flash in 0x1FC00 that my bluepills have 128KB right. I plan to make my custom pcb with STM32F103C8T6 chip on it for prototype product. I think to be sure my code is write on it have 64KB for safe my product. Many THANKS.

Last edited 4 years ago by Nor
Alex
4 years ago

I’m using Black Pill when i write to memory address it write and read quite well. But if i write in a loop for example i want to write to 0x08000400 and 0x08000400 the last written address is only stored in flash others are not stored why it’s happening? It’s urgent. Thank you

alex
Reply to  admin
4 years ago

I’m sorry for my bad explanation here is the sample code..

for (int i = 0; i <= 5; i ++){
        if(i == 0){
           Flash_Write_Data(0x08006010, data);
                  Flash_Read_Data(0x08006010, Rx_Data);
                  println(Rx_Data);
        } if(i == 2){
           Flash_Write_Data(0x08006020, data1);
                  Flash_Read_Data(0x08006020, Rx_Data);
                  println(Rx_Data);
        } if(i == 3){
           Flash_Write_Data(0x08006030, data2);
                  Flash_Read_Data(0x08006030, Rx_Data);
                  println(Rx_Data);
        } if(i == 4){
           Flash_Write_Data(0x08006050, data3);
                  Flash_Read_Data(0x08006050, Rx_Data);
                  println(Rx_Data);
        }

        HAL_Delay(2000);
     }

After running this code data is stored only at this address 0x08006050 but during the iteration i can see that data is being stored by calling Read_Flash function and the output is this

14:10:19.482 -> Hello World
14:10:23.535 -> Hello World 1
14:10:25.564 -> Hello World 2
14:10:27.595 -> Hello World 3

But if i check the memory location using STM32CubeProgrammer i can only see last address data is stored in flash…

     for (int i = 0; i <= 8; i ++){
        if(i == 0){
           Flash_Write_Data(0x08006010, data);

        } if(i == 2){
           Flash_Write_Data(0x08006020, data1);

        } if(i == 3){
           Flash_Write_Data(0x08006030, data2);

        } if(i == 4){
           Flash_Write_Data(0x08006050, data3);
        }
        if(i ==5){
          Flash_Read_Data(0x08006010, Rx_Data);
                            println(Rx_Data);
        }if(i == 6){
                           Flash_Read_Data(0x08006020, Rx_Data);
                           println(Rx_Data);
        }if(i == 7){
          Flash_Read_Data(0x08006030, Rx_Data);
                           println(Rx_Data);
        }if(i == 8){
          Flash_Read_Data(0x08006050, Rx_Data);
                        println(Rx_Data);
        }

        HAL_Delay(2000);
     }

and the output is this

14:22:06.325 ->
14:22:08.329 ->
14:22:10.322 ->
14:22:12.354 -> Hello World 3

I don’t know what causing this..

Azhar
4 years ago

I am using this concept to stm32f030f4 the value is uploaded to the flash memory address correctly and stored even though when the power is off but it does not reflect on the project kit when i reset the stm it works as per the coding logic it does not get the address value

thanks in advance

Mohit
4 years ago

Thank you sir.

Last edited 4 years ago by Mohit
Manjunath K S
4 years ago

Hi,
i am using stm32H753 it has 2 memory banks BANK1 & BANK2 with 7 sectors each, and its a cortex-m7 controller,
i tried to use our program.it is not working

Muhammed Okur
Reply to  admin
3 years ago

Hi, I am using STM32H753 and i have same problem. How can i fix the problem? Can you help me please.

Jestina Joy
Reply to  admin
3 years ago

Have you released the update for H7 series board? If yes, please share the link

Jestina Joy
Reply to  admin
3 years ago

Thanks for the update. When i used the code for H7 series i got below error:
In function ‘Flash_Write_Data’:
../Drivers/STM32H7xx_HAL_Driver/Inc/Legacy/stm32_hal_legacy.h:425:39: error: ‘FLASH_VOLTAGE_RANGE_3’ undeclared (first use in this function);
I am using STM32H7A3 Nucleo board. I could not find out a definition for FLASH_VOLTAGE_RANGE_3 in my code. Please help me..

vivek
4 years ago

Flash_Page.c file is written by you. Or It is in built HAL library file?

yedem bala nagendra reddy
4 years ago

Hello sir,

Iam using STM32L073Rz microcontrolller for flashing the data. But once we write the data in Particular address like 0X0802F000 iam not able to modify the string or numbers in the same address but we can flash another string in 0X0802F020 address. Please explain how to erase the previous flash data.

Iam trying to take external button as input after every press count value will be incremented and i am expecting to store the count value at any one address like 0X0802F000 after every increment count value stores at same address.

When use the board after power off also, count will be incremented from last value and it should be displayed on LCD or UART . Is it possible to do like that in Flash Programming.

I changed the GetPage function like this for STM32L073Rz is it correct

static uint32_t GetPage(uint32_t Address)
{
for (int indx=0; indx<512; indx++)
{
if((Address = (0x08000000 + 128*indx)))
{
return (0x08000000 + 128*indx);
}
}

return -1;
}

Please help to resolve the issue.

yedem bala nagendra reddy
Reply to  admin
4 years ago

Yes sir,

Please verify in STM32L073RZ Referance Manual page no. 68/1034
RM0367 Reference manual

won
4 years ago

Hi there,
Is Bluepill board 64kb flash memory?
How do you use 128kb pages?

won
Reply to  admin
4 years ago

Thanks for the reply and there is a confusion yes. But I thought it’s 64kb because it says 64kb in STM32CUBE IDE memory section on right bottom.