STM8S/A Standard Peripherals Firmware Library: How to use the block operations to Write/Erase the Data Memory

  ******************** (C)COPYRIGHT 2014 STMicroelectronics *******************
  * @file    FLASH/FLASH_DataProgram/readme.txt
  * @author  MCD Application Team
  * @version V2.2.0
  * @date    30-September-2014
  * @brief   Description of how to program the STM8S FLASH Data Memory using 
  *          the Write/erase block operations.
  ******************************************************************************
  *
  * Licensed under MCD-ST Liberty SW License Agreement V2, (the "License");
  * You may not use this file except in compliance with the License.
  * You may obtain a copy of the License at:
  *
  *        http://www.st.com/software_license_agreement_liberty_v2
  *
  * Unless required by applicable law or agreed to in writing, software 
  * distributed under the License is distributed on an "AS IS" BASIS, 
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  *
  ******************************************************************************
  

Example description

This example provides a description of how to use FLASH Write/Erase Block mode on data eeprom memory. After Reset, the Flash memory Program/Erase Controller is locked. To unlock it, the FLASH_Unlock function is used. Once done, the following operations on the data memory will be performed:

• Program a block at a specified address (0x4000) by using FLASH_ProgramBlock() function.
• Check program block (Read byte) if the program block operation failed LED1 will toggle.
• Erase block using FLASH_EraseBlock() function.
• Check erase (using Read byte) if the program block operation failed LED2 will toggle.

If Write/Erase operations passed LED3 will toggle.

Note:

Within the main.c file, you will find details on the procedures to follow to execute FLASH_ProgramBlock() and FLASH_EraseBlock() functions from RAM.

Directory contents

• FLASH/Data_Program/main.c Main file
• FLASH/Data_Program/stm8s_conf.h Library Configuration file
• FLASH/Data_Program/stm8s_it.c Interrupt routines source
• FLASH/Data_Program/stm8s_it.h Interrupt routines declaration

Hardware and Software environment

• This example runs on STM8S and STM8A High density, Medium density and Low density devices.

• This example has been tested with STMicroelectronics STM8/128-EVAL evaluation board and can be easily tailored to any other development board.

How to use it ?

In order to make the program work, you must do the following :

• Copy all source files from this example folder to the template folder under Project
• Open your preferred toolchain
• For Cosmic Compiler
  • In STVD Select Project "input" and in the RAM section add the FLASH_CODE segment with "-ic" options.
  • Uncomment the line "#define RAM_EXECUTION (1)" in the stm8s.h file to enable the FLASH functions execution from RAM.

• For Raisonance Compiler
  • Uncomment the line "#define RAM_EXECUTION (1)" in the stm8s.h file to enable the FLASH functions execution from RAM through the specific inram directive.

• For IAR Compiler
  • Uncomment the line "#define RAM_EXECUTION (1)" in the stm8s.h file to enable the FLASH functions execution from RAM through the specific __ramfunc keyword.

• Rebuild all files and load your image into target memory
• Run the example

Note:

• High-Density STM8A devices are the STM8AF52xx STM8AF6269/8x/Ax, STM8AF51xx, and STM8AF6169/7x/8x/9x/Ax microcontrollers where the Flash memory density ranges between 32 to 128 Kbytes
• Medium-Density STM8A devices are the STM8AF622x/4x, STM8AF6266/68, STM8AF612x/4x, and STM8AF6166/68 microcontrollers where the Flash memory density ranges between 8 to 32 Kbytes
• High-Density STM8S devices are the STM8S207xx, STM8S007 and STM8S208xx microcontrollers where the Flash memory density ranges between 32 to 128 Kbytes.
• Medium-Density STM8S devices are the STM8S105x and STM8S005 microcontrollers where the Flash memory density ranges between 16 to 32-Kbytes.
• Low-Density STM8S devices are the STM8S103xx, STM8S003 and STM8S903xx microcontrollers where the Flash density is 8 Kbytes.

© COPYRIGHT STMicroelectronics