  /**
  @addtogroup MDR1206FI_EvalBoard MDR1206FI Evaluation Board
  @latexonly
  @verbatim
  ******************** (C) COPYRIGHT 2025 Milandr ******************************
  * @file    readme.txt
  * @author  Milandr Application Team
  * @version V0.1.0
  * @date    21/10/2025
  * @brief   Description of the demonstration example for MDR1206FI evaluation board.
  ******************************************************************************
  * THE PRESENT FIRMWARE IS FOR GUIDANCE ONLY. IT AIMS AT PROVIDING CUSTOMERS
  * WITH CODING INFORMATION REGARDING MILANDR'S PRODUCTS IN ORDER TO FACILITATE
  * THE USE AND SAVE TIME. MILANDR SHALL NOT BE HELD LIABLE FOR ANY
  * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES RESULTING
  * FROM THE CONTENT OF SUCH FIRMWARE AND/OR A USE MADE BY CUSTOMERS OF THE
  * CODING INFORMATION CONTAINED HEREIN IN THEIR PRODUCTS.
  ******************************************************************************
  @endverbatim
  @endlatexonly

@par Example Description

This example demonstrates the MDR1206FI evaluation board functionality.

The following modules are configured at startup:
    - LCD (PB[14:2] and PA[4] pins)
    - LEDs HL4-1 (PD[8:5] pins)
    - SB5 and SB3-1 buttons (PA[3:0] pins)
    - Wake3-1 buttons (WAKEUP[3:1] pins)
    - UART1 (PB[1:0] pins) with the following settings:
        - 115200 baud
        - 8 data bits
        - 1 stop bit
        - no parity control.
The UART1 pins (PB[1:0]) are connected to the on-board USB-UART adapter (FT2232HL chip).

After startup, the following actions are performed:
    - UART1 send the message "MDR1206FI Init end!"
    - JSC "ICC Milandr" logo is displayed on the LCD
    - LEDs HL4 (PD8 pin) and HL1 (PD5 pin) blink at different frequencies
    - buttons SB5, SB3-1 and Wake3-1 are polled, when they are pressed, the corresponding information is displayed on the LCD.


@par Directory contains:

    - bootloader/MDR1206_Bootloader.hex Actual bootloader (v.1.1.0) for the MCU.
    - launch_cfg/                       Directory containing Eclipse debug launch configurations.
    - Library/CMSIS                     Directory containing CMSIS library v.0.2.0.
    - Library/SPL                       Directory containing SPL library v.0.2.0.
    - Library/LCD                       Directory containing LCD driver.
    - src/main.c                        Main program.
    - src/syscalls.c                    Minimal Newlib syscalls implementation with UART1 input and output.
    - src/stdio_uart.c                  UART1 configuration functions.
    - src/stdio_uart.h                  UART1 configuration parameters and function prototypes.
    - src/lcd_mdr_logo.h                Logo of JSC "ICC Milandr" for LCD.
    - svd/                              Directory containing SVD (System View Description) file of the MCU.


@par Hardware and Software environment:

    - This example is intended to run on the MDR1206FI evaluation board with MDR1206FI microcontroller.


@par How to use

To launch the example, you must do the following:
    - Set up the environment: IDE Eclipse, RISC-V GCC toolchain, patched OpenOCD with MDR1206FI support.
    - Import the project into the workspace and compile it.
    - Connect a USB cable to the board and the PC (FT2232HL functions as a debugger and USB-UART adapter).
    - Run any of the Eclipse debug launch configurations.


 * <h3><center>&copy; COPYRIGHT 2025 Milandr</center></h3>
 */
