/**
    @page Demo Demo
  
  @verbatim
  ******************** (C) COPYRIGHT 2011 STMicroelectronics *******************
  * @file    readme.txt 
  * @author  Microcontroller Division
  * @version V1.0.2
  * @date    September-2011
  * @brief   Description file for STM32L-Discovery board demonstration software.
  ******************************************************************************
  * 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.
  ******************************************************************************
   @endverbatim

@par Hardware and Software environment

  - Software environemnt
  ----------------------
    This Demo runs with

     - EWARM from version 6.21
     - MDK-ARM 4.21 
     - TrueSTUDIO V2.1.0.

  - ST-LINK/V2 driver requirement
  ------------------------------
    - After installing EWARM 6.21, you should install the ST-LINK/V2 driver by 
      running the ST-Link_V2_USB.exe from
      [IAR_INSTALL_DIRECTORY]\Embedded Workbench 6.0_2\arm\drivers\ST-Link
      \ST-Link_V2_USBdriver.exe
    - For MDK-ARM and TrueSTUDIO the ST-LINK/V2 driver is installed automatically 
        
  - Hardware environemnt
  ----------------------
     - Check jumper position on the board, JP1 on, CN3 on (Discovery selected).
     - Connect the STM32L-Discovery board to a PC with a USB cable to power the board.

@par Example Description 

This software demonstration aims to use various peripherals and connectors on
STM32L-Discovery  board.

When powering on the STM32L-Discovery board, the Red LED LD2 (PWR) then lights up.
Function 1 (see table below) is executed, and each click on user button B1 changes 
the executed function.
|--------------------------------------------------------------------------------
| Function |  LED LD3/4	  |  Description	              | MAIN FUNCTION    |
|--------------------------------------------------------------------------------|
|   1	   | Blink LD3/4  | STM32L VDD voltage measured	      |Voltage           |
|--------------------------------------------------------------------------------|
|   2	   |    LD3	  | Slider 0 to 100%	              |Slider            |
|-------------------------------------------------------------|                  |
|   3	   |    LD4	  | Used as 4 touch buttons	      |                  |
|----------|--------------|-----------------------------------|------------------|
|   4	   |    Off	  | Run mode (4 MHz)	              |STM32L consumption|
|	   |	          | Sleep mode (4 MHz)	              |measured          |
|----------|--------------|--------------------------------- -|                  |
|   5	   |     Off	  | Low power mode, Run (32 kHz       |                  |
|	   |	          | Low power mode, Sleep (32 kHz)    |                  |
|----------|--------------|-----------------------------------|                  |
|   6	   |     Off	  | Stop mode with RTC                |                  |
|          |              | Stop mode without RTC             |                  |
|----------|--------------|-----------------------------------|                  |
|   7	   |     Off	  | Standby mode  	              |                  |
|	   |	          |                                   |                  |
---------------------------------------------------------------------------------|
	

@par Directory contents

- "inc": contains the STM32L-Discovery demo header files  
  - stm32l1xx_conf.h          Library Configuration file
  - stm32l1xx_it.h            Interrupt handlers header file
  - discover_functions.h      Discover demo functions header file
  - icc_measure.h             Current measurements header file
  - stm32_tsl_conf.h          STM32 Touch Sensing header file

- "src": contains the STM32L-Discovery demo source files 
  - stm32l1xx_it.c            Interrupt handlers
  - discover_functions.c      Discover demo functions
  - icc_measure_Ram.c         Ram functions used for ICC current measurments
  - icc_measure.c             Current measurements source file
  - main.c                    Main program
  - system_stm32l1xx.c
       The "system_stm32l1xx.c" is generated by an automatic clock configuration 
       system and can be easily customized to your own configuration.

- "EWARM": contains pre-configured project for EWARM toolchain        
- "MDK-ARM": contains project for MDK ARM KEIL toolchain
- "TrueSTUDIO": contains project for Atollic TrueSTUDIO toolchain     



@par How to use it ? 

In order to make the program work, you must do the following :
1- Open STM32L-Discovery project
2- Rebuild all files and load your image into target memory
3- Run the example

   
 * <h3><center>&copy; COPYRIGHT 2011 STMicroelectronics</center></h3>
 */

