/** @page BEEP_3SignalsGeneration Generation of the 3 beep signals
  @verbatim
  ******************** (C)COPYRIGHT 2011 STMicroelectronics *******************
  * @file    BEEP/BEEP_3SignalsGeneration/readme.txt
  * @author  MCD Application Team
  * @version V2.1.0
  * @date    18-November-2011
  * @brief   This file contains the main function for BEEP 3 Signals Generation example
  ******************************************************************************
  *
  * 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 Example description

  This example provides a short description of how to use the BEEP peripheral:
  Each time the key button is pressed the Beeper frequency changes and a corresponding 
  led will be switched on. 


  @par Directory contents

  - BEEP\BEEP_3SignalsGeneration\main.c         Main file containing the "main" function
  - BEEP\BEEP_3SignalsGeneration\stm8s_conf.h   Library Configuration file
  - BEEP\BEEP_3SignalsGeneration\stm8s_it.c     Interrupt routines source (not used in this example)
  - BEEP\BEEP_3SignalsGeneration\stm8s_it.h     Interrupt routines declaration
  

  @par Hardware and Software environment

  - This example runs on STM8S and STM8A High density, Medium density and Low 
    density devices.
  
  @note: to run this example with STM8S Low Density devices, TIM1 should be used 
  instead of TIM3 for LSI calibration.
  
  - This example has been tested with STMicroelectronics STM8/128-EVAL evaluation 
    board and can be easily tailored to any other development board.

  - STM8/128-EVAL Set-up
     - Key push button
     - LD1..LD4
     - Mono LCD
     - PD4 used to drive the buzzer 


  @par 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\Template
  - Open your preferred toolchain 
  - Add the required file:
    - stm8s_eval_lcd.c  (under Utilities\STM8S_EVAL\Common)
  - Rebuild all files and load your image into target memory
  - Run the example
  - Per default, the BEEP signal is OFF and the 4 LEDs are ON.
  - Everytime you press the Key button on the board, you will toggle the
    buzzer frequency in this way: 1kHz -> 2kHz -> 4kHz -> OFF -> 1kHz -> etc...
  - The 4 LEDs will toggle respectively.
	
  @par Hint

   - Enable the beeper alternate function 
    - with STVD (menu: Debug Instrument -> MCU configuration ->AFR7: Alternate active)
    - with RIDE (edit the "STM8_OB.asm" file to set the AFR7 bit)
    - with EWSTM8 (menu: ST-LINK -> Option bytes ->AFR7: Alternate active)
   - Before using the LSI clock you have to configure the option bytes in order 
    to enable the "LSI_EN".
    - with STVD (menu: Debug Instrument -> MCU configuration -> Options -> LSI_EN = Enabled )
    - with RIDE (edit the "STM8_OB.asm" file to configure the OPT3 & NOPT3 option bytes)
    - with EWSTM8 (menu: ST-LINK -> Option bytes -> LSI_EN = Enabled)  
   - Verify that the JP14 is on the up position (to enable the speaker on the STM8/128-EVAL)
   - Verify the speaker volume by adjusting the RV2 potentiometer position on the STM8/128-EVAL

  @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.
   
 * <h3><center>&copy; COPYRIGHT 2011 STMicroelectronics</center></h3>
 */
