/** @page UART1_MultiProcessor Use the UART1 in multi-processor mode

  @verbatim
  ******************** (C)COPYRIGHT 2011 STMicroelectronics *******************
  * @file    UART1/UART1_MultiProcessor/readme.txt 
  * @author  MCD Application Team
  * @version V2.1.0
  * @date    18-November-2011
  * @brief   Description of the UART1 multi-processor 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 description of how to use the UART1 in multi-processor mode.
  First, the UART1 and UART3 addresses are set to 0x1 and 0x2. 

  The UART1 sends continuously the byte 0x33 to the UART3. When UART3 receives 
  byte (0x33), LED1 to LED4 toggle.

  When a falling edge is applied on EXTI PORTB (Joystick up push-button on 
  STM8-EVAL board is pressed), an interrupt is generated and in the 
  EXTI_PORTB_IRQHandler routine, the UART3 is put into mute mode and stays in 
  this mode(no LED toggling) until a rising edge is applied on EXTI PORTC
  (Key push-button on STM8-EVAL board is pressed). 
  In this interrupt routine the UART1 sends the address mark data (0x102) 
  to wake up the UART3. The LEDs restarts toggling.

  UART1 and UART3 are configured as follows:
   - BaudRate = 9600 baud  
   - Word Length = 9 Bits
   - One Stop Bit
   - No parity
   - Receive and transmit enabled
   - UART1 Clock disabled


  @par Directory contents

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

  @par Hardware and Software environment

  - This example runs on STM8S and STM8A High density devices only.
      
  - 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
    - Connect UART1_Tx(PA.05) to UART3_Rx(PD.06) and UART1_Rx(PA.04) to UART3_Tx(PD.05)
      or connect a null-modem female/female RS232 cable between CN15 and CN13.
     - Four leds LD1 to LD4, Key and Joystick UP push-button are used.
 

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