/**
  @page Demo_Binary   Description of the STM32469I-EVAL Demo firmware's binary files
 
  @verbatim
  ******************** (C) COPYRIGHT 2017 STMicroelectronics *******************
  * @file    readme.txt 
  * @author  MCD Application Team
  * @brief   Description of the STM32469I-EVAL Demo firmware's binary files.
  ******************************************************************************
  *
  * Copyright (c) 2017 STMicroelectronics. All rights reserved.
  *
  * This software component is licensed by ST under Ultimate Liberty license SLA0044,
  * the "License"; You may not use this file except in compliance with the
  * License. You may obtain a copy of the License at:
  *                       http://www.st.com/SLA0044
  *
  ******************************************************************************
  @endverbatim

@par Demo Description

The STM32Cube Demonstration platform comes on top of the STM32CubeTM as a firmware
package that offers a full set of software components based on a modules architecture
allowing re-using them separately in standalone applications. All these modules are
managed by the STM32Cube Demonstration kernel allowing to dynamically adding new
modules and access to common resources (storage, graphical components and widgets,
memory management, Real-Time operating system)

The demonstration firmware is built around the graphical library STemWin and the FreeRTOS 
real time operating system and uses almost the whole STM32 capability to offer a large 
scope of usage based on the STM32Cube HAL BSP and several middleware components.

@par Demo Description

The STM32 F4 demonstration is running on STM32469I-EVAL boards RevC.
Tow flavours of the Demonstration binaries are available: 
  - 'STM32469I_EVAL_Demo_V1.2.0.hex': based on StemWin and which source code 
     is provided within the STM32Cube_FW_F4 package. Its modules are listed below.
  - 'STM32469I_EVAL_Demo_V1.2.0_FULL.hex' : an out of the box Demo integrating the StemWin 
     demo in addition to third parties graphical Demo modules: 
  - TouchGFX demonstration module based on Draupner Graphics’ commercial graphic library.
    Free evaluation version is available at www.touchgfx.com/stmicroelectronics.
  
Below you find an overview of the different offered module in the demonstration:

 + Video player
 --------------
 The video player module provides a video solution based on the STM32F4xx and STemWin
 movie API. It supports playing movie in emf format.
 
 + Audio player
 --------------
 The audio player module provides a complete audio solution based on the STM32F4xx and
 delivers a high-quality music experience. It supports playing music in WAV format but may
 be extended to support other compressed formats such as MP3 and WMA audio formats.
 The Module supports background mode feature.
 
  + Audio recorder
 -----------------
 The audio recorder module allows recording audio and playing it back.
 
 + VNC Server
 ------------
 The VNC server module allows to control the demo from a remote machine. It is based on
 the TCP/IP LwIP stacks. The background mode is supported.
 
 @note Launch any VNC Client or the emVNC software located under "Middlewares\ST\STemWin\Software" to run the module.
 @note Cannot run both video player and vnc server in the same time

 + Audio Recorder
 ----------------
 The Audio record module allows to record an audio file. The audio format supported is 
 WAV format but may be extended to support other compressed formats such as MP3.
 The recorded files are stored in USB Disk flash(USB High Speed).
  
 + Home alarm
 ------------ 
 Control of Home alarm system, equipped with cameras.
 Static picture shown when a room is selected and then the camera icon pressed
 General room alarm activation/deactivation when pressed.
 
 + Gardening control
 -------------------
 The gardening control module provides a graphic garden watering system behaviour
 
 + Game
 ------
 The game coming in the STM32Cube demonstration is based on the Reversi game. It is a
 strategy board game for two players, played on an 8×8 board. The goal of the game is to
 have the majority of disks turned to display your color when the last playable empty square
 is filled.
 
 + System Info
 --------------  
 The system info module provides information about the core, supported eval boards, 
 CPU speed and demonstration version.

 For more details about the demonstration modules please refers to STM32CubeF4 demonstration (UM1743)
 
@note Demonstration Firmware doesn't embed TouchGFX demonstration module. 
      Free evaluation version of the TouchGFX demonstration, based on Draupner Graphics’ 
      commercial graphic library, is available at www.touchgfx.com/stmicroelectronics
      
@par Hardware and Software environment

  - This application runs on STM32F469xx devices.  

  - This example has been tested with STMicroelectronics STM32469I_EVAL
    boards RevC and can be easily tailored to any other supported device 
    and development board.

  - Jumpers configuration:
     - JP2    Fitted (Power on MCU)  
     - JP5    <2-3> (PB3 (I2S Clock) is connected to Timer input PC6 used as microphone clock divider )
     - JP6    <2-3> (PD6 is connected to digital microphone as I2S data signal)
     - JP7    <1-2> (25MHz clock is provided by external crystal X4 (used for VNC server demonstration))
     - JP11   must be not fitted ==> NOR write protection is disabled
     - JP17   <2-3> (Data signal on digital microphone is connected to I2S port)
     - JP18   <2-3> (Clock signal on digital microphone is connected to Timer output (PC7))

@par How to use it ? 

The NOR external flash loader is not integrated with supported toolchains, it’s only supported with STM32
ST-Link Utility V3.7 or later.
To load the demonstration, use STM32 ST-Link Utility to program both internal Flash and external NOR memory.
To edit and debug the demonstration you need first to program the external NOR memory using STLink utility
and then use your preferred toolchain to update and debug the internal flash content.

Below the detailed steps:

In order to program the demonstration you must do the following:
1- Open STM32 ST-Link Utility V4.1.0, click on "External Loader" from the bar menu then check 
   "MT25QL512A_STM32469I-EVAL" box 
2- Connect the STM32469I-EVAL board to PC with USB cable through CN22
3- Use "STM32469I_EVAL_Demo_VX.Y.Z.hex" file provided under “Binary” with STM32 ST-Link Utility
   to program both internal Flash and external NOR memory
   The "STM32469I_EVAL_Demo_V1.2.0_FULL.hex" file provided under 'Binary', can also be used to take benefit
   from Touch-GFX third party demonstrations modules replacing Gardening control module.
   
4- copy the audio and video files provided under "Media/" in the USB key
5- Plug a USB micro A-Male to A-Female cable on CN8 connector
6- Plug a headphone to hear the sound(CN27)  /!\ Take care of yours ears. Default volume is 70%.
-> The internal Flash and the external NOR are now programmed and the demonstration is shown on the board.
  
 * <h3><center>&copy; COPYRIGHT STMicroelectronics</center></h3>
 */
 
