
STM32412G-DISCO Demonstration Firmware

  ******************** (C) COPYRIGHT 2017 STMicroelectronics *******************
  * @file    Demonstrations/readme.txt 
  * @author  MCD Application Team; edited by SEGGER
  * @brief   Description of STM32F412G-DISCO Demonstration
  ******************************************************************************
  *
  * Licensed under MCD-ST Liberty SW License Agreement V2, (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/software_license_agreement_liberty_v2
  *
  * Unless required by applicable law or agreed to in writing, software 
  * distributed under the License is distributed on an "AS IS" BASIS, 
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  *
  ******************************************************************************


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 STM32Cube Demonstration platform is built around the powerful 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.

The STM32 F4 demonstration is running on STM32F412G-DISCO boards RevC. 

Below you will find an overview of the various modules included in the demonstration:

 + Video player
 --------------
 The video player module provides a video solution based on the STM32F4xx and STemWin
 movie API. It supports playing movies in AVI format from an SD card.
 
 + 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 from an SD card but may
 be extended to support other compressed formats such as MP3 and WMA audio formats.
 The Module supports background mode feature.
 Listen to the audio by inserting headphones into audio jack (CN9) 
  
 + Audio recorder (swipe screen left to see icon)
 -----------------
 The audio recorder module allows recording audio via the on-board microphones and playing it back.
 Record audio by tapping the "Microphone" icon in the Audio recorder sub menu.
 To end the recording, tap the "Check Mark" icon. Then play back the recording by tapping the "Play" icon. 
 Note: The recorded file can also be played back in the Audio Player section of this demonstration.

 + Analog Clock
 ------------
 The analog clock module shows the the time and gives the option to set the time.
  
 + USB Device (MSC)
 ------------ 
 The USB device module includes mass storage device application using the MicroSD memory.
 (Tap on the USB connector icon in the USB sub menu to connect.)
 
 + System Info (swipe screen left to see icon)
 --------------  
 The system info module provides information about the core, supported boards, 
 CPU speed and demonstration version.  
       
Hardware and Software environment

  - This application runs on STM32F412xx devices.  

  - This example has been tested with STMicroelectronics STM32F412G_DISCO
    boards RevC and can be easily tailored to any other supported device 
    and development board.
	
  - This version contains a project file for the SEGGER Embedded Studio IDE (v3.41 or higher) 


How to use it ? 

In order to build the project using the SEGGER Embedded Studio IDE, do the following:
 - Download and install SEGGER Embedded Studio for Arm v3.41 or higher from https://www.segger.com/downloads/embedded-studio/ 
 - Start SEGGER Embedded Studio
 - Open the Demo Project (File|Open Solution) at this location:
   "C:\...\STM32F412G-D-DP\Project\STM32F412G-Discovery\Demonstrations\SES\STM32412G-Discovery_Demo\project.emproject"
 - Rebuild all files (Build|Build Solution)

After building, in order to download and run the program using the SEGGER Embedded Studio IDE, do the following:
 - Replace the ST-Link debugger firmware in the STM32F412G-DISCO board with the J-Link debugger firmware
   using the SEGGER STLinkReflash utility as described here:
   https://www.segger.com/products/debug-probes/j-link/models/other-j-links/st-link-on-board/
   (You will be able to restore the ST-Link firmware later on if desired) 
 - Connect the STM32F412G-DISCO board to your PC with a USB cable via connector CN6 (=> J-Link OnBoard)
 - Optional: Copy the audio and video files provided under "Utilities/Media/Audio" and "Utilities/Media/Video" to the root of a uSD Card
             and plug the uSD Card into the CN13 connector of the STM32F412G_DISCO board
 - Optional: Connect the STM32F412G-DISCO board to your PC with a USB cable via connector CN3 (USB_USER)
 - Start a debug session in SEGGER Embedded Studio (Debug|Go)
   The code gets downloaded onto the board and execution halts at main().
 - Select Debug|Go again to run the demonstration
 - Select Debug|Break to halt execution 
 - Select Debug|Stop to terminate the debug session

     
Pre-built option:
	 
You can also download the pre-built .hex file into your STM32F412G_DISCO boards RevC as follows:
 - Replace the ST-Link debugger firmware in the STM32F412G-DISCO board with the J-Link debugger firmware
   using the SEGGER STLinkReflash utility as described here:
   https://www.segger.com/products/debug-probes/j-link/models/other-j-links/st-link-on-board/
   (You will be able to restore the ST-Link firmware later on if desired) 
 - Connect the STM32F412G-DISCO board to your PC with a USB cable via connector CN6 (=> J-Link OnBoard)
 - Navigate to the "C:\...\STM32F412G-D-DP\Prebuilt\" folder
 - Double-click "StartBinary.bat" to program both internal Flash and external QSPI memory
 - The demonstration will run automatically after download is complete.
 
 
	 
 COPYRIGHT STMicroelectronics / SEGGER Microcontroller GmbH
 
