/******************** (C) COPYRIGHT 2008 STMicroelectronics ********************
* File Name          : readme.txt
* Author             : MCD Application Team
* Version            : V2.0.2
* Date               : 09/22/2008
* Description        : Description of the binary directory.
********************************************************************************
* THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
* WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE TIME.
* AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY DIRECT,
* INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING FROM THE
* CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE CODING
* INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
*******************************************************************************/

Description
===================
This directory contains a set of sources files that build the application to be
loaded into into Flash memory using In-Application Programming (IAP, through USART1).

To build such application, some special configuration has to be peformed: 
1. Set the program load address at 0x08002000, using your toolcahin linker file
2. Relocate the vector table at address 0x08002000, using the "NVIC_SetVectorTable"
   function.
 
The SysTick example provided within the STM32F10x Firmware library is used as 
illustration.    
This example configures the SysTick to generate a time base equal to 1 ms.
The system clock is set to 72 MHz, the SysTick is clocked by the AHB clock (HCLK)
divided by 8.
A "Delay" function is implemented based on the SysTick end-of-count event.
Four LEDs connected to the GPIO_LED Pin 6, Pin 7, Pin 8 and Pin 9 are toggled
with a timing defined by the Delay function.


Directory contents
==================
 + template project
     - EWARMv5: This folder contains a pre-configured project file that produces
                a binary image of SysTick example to be loaded with IAP.

     - RIDE: This folder contains a pre-configured project file that produces a
             binary image of SysTick example to be loaded with IAP.

     - RVMDK: This folder contains a pre-configured project file that produces a
              binary image of SysTick example to be loaded with IAP.              

     - HiTOP: This folder contains a pre-configured project file that produces a
              binary image of SysTick example to be loaded with IAP.  

+ platform_config.h    Evaluation board specific configuration file     
 + stm32f10x_conf.h    Library Configuration file
 + stm32f10x_it.c      Interrupt handlers
 + stm32f10x_it.h      Header for stm32f10x_it.c
 + main.c              Main program
 + main.h              Header for main.c


Hardware environment
====================
This example runs on STMicroelectronics STM3210B-EVAL and STM3210E-EVAL evaluation
boards and can be easily tailored to any other hardware.
To select the STMicroelectronics evaluation board used to run the example, uncomment
the corresponding line in platform_config.h file.

 + STM3210B-EVAL 
    - Use LD1, LD2, LD3 and LD4 leds connected respectively to PC.06, PC.07, PC.08
      and PC.09 pins
 
 + STM3210E-EVAL
    - Use LD1, LD2, LD3 and LD4 leds connected respectively to PF.06, PF0.7, PF.08
      and PF.09 pins
                    
   
How to use it
=============
In order to load the SysTick example with the IAP, you must do the following:
 + EWARMv5:
    - Open the SysTick.eww workspace
    - In the workspace toolbar select the project config:
        - STM3210B-EVAL: to configure the project for STM32 Medium-density devices
        - STM3210E-EVAL: to configure the project for STM32 High-density devices
   - Rebuild all files: Project->Rebuild all
   - A binary file "SysTick.bin" will be generated under "STM3210E-EVAL\Exe" or
     "STM3210B-EVAL\Exe" folder depending on configuration you selected 
   - Finaly load this image with IAP application

 + RIDE
    - Open the SysTick.rprj project
    - In the configuration toolbar(Project->properties) select the project config:
        - STM3210B-EVAL: to configure the project for STM32 Medium-density devices
        - STM3210E-EVAL: to configure the project for STM32 High-density devices
    - Rebuild all files: Project->build project
    - Run "hextobin.bat"
    - A binary file "SysTick.bin" will be generated under "\STM3210E_EVAL" 
      or "\STM3210B_EVAL" folder depending on configuration you selected
    - Finaly load this image with IAP application

 + RVMDK
    - Open the SysTick.Uv2 project
    - In the build toolbar select the project config:
        - STM3210B-EVAL: to configure the project for STM32 Medium-density devices
        - STM3210E-EVAL: to configure the project for STM32 High-density devices
    - Rebuild all files: Project->Rebuild all target files
    - Run "axftobin.bat"
    - A binary file "STM3210B-EVAL_SysTick.bin" or "STM3210E-EVAL_SysTick.bin"
      will be generated under "\Obj" folder
    - Finaly load this image with IAP application
    
 + HiTOP     
    - Open the HiTOP toolchain, a "using projects in HiTOP" window appears.
    - Select open an existing project.
    - Browse to open the SysTick.htp:
        - under STM32F10B_EVAL directory: to select the project for STM32 Medium-density devices.
        - under STM32F10E_EVAL directory: to select the project for STM32 High-density devices
    - Rebuild all files: Project->Rebuild all
    - Load the project: Click on ok in the "download project" window.
    - Run "hextobin.bat"
    - A binary file "SysTick.bin" will be generated under "\STM32F10E_EVAL\Objects" 
      or "\STM32F10B_EVAL\Objects" folder depending on the directory selected above
    - Finaly load this image with IAP application.

NOTE:
 - Medium-density devices are STM32F101xx and STM32F103xx microcontrollers where
   the Flash memory density ranges between 32 and 128 Kbytes.
 - High-density devices are STM32F101xx and STM32F103xx microcontrollers where
   the Flash memory density ranges between 256 and 512 Kbytes. 


******************* (C) COPYRIGHT 2008 STMicroelectronics *****END OF FILE******
