/**
  @page USART_Printf USART printf example
  
  @verbatim
  ****************** (C) COPYRIGHT 2023 Megawin Technology *******************
  * @file    USART/USART_Printf/readme.txt 
  * @author  Megawin Application Team
  * @version V0.0.4
  * @date    16-June-2023
  * @brief   Description of the USART USART_Printf 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, MEGAWIN 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 shows how to retarget the standard input and output function to the USART1.

In this example, Main clock is from PLL clock and it is configured at 96MHz. The PLL clock is based on 8MHz HSE. APB1 clock is from Main clock, APB2 clock is the 2 frequency division of the Main clock.

The code to implement the input/output redirection function is in \Utilities\Common\Retarget_USART1.c.

USART1 configuration is as follows:
  - Baud rate: 115200
  - Data bit: 8
  - Stop bit: 1
  - No parity check
  - Disable automatic flow control
  - Enable FIFO

@par Directory contents 

  - USART/USART_Printf/USART_Printf.uvprojx         MDK5 project file
  - USART/USART_Printf/USART_Printf.uvoptx          MDK5 project options file
  - USART/USART_Printf/JLinkSettings.ini            Jlink settings file
  - USART/USART_Printf/main.c                       Main program


@par Hardware and Software environment 

  - Hardware environment
    - HSE crystal is 8MHz
    - USART1 (PA9, PA10) is connected to PC


@par How to use it ? 

In order to make the program work, you must do the following :
 - Open USART_Printf.uvprojx from this example folder by Keil MDK5
 - Rebuild all files and load your image into target memory
 - Run the example 
   
 * <h3><center>&copy; COPYRIGHT 2023 Megawin Technology</center></h3>
 */
