/*!
 * @file        readme.txt
 *
 * @brief       This file is routine instruction
 *
 * @version     V1.0.0
 *
 * @date        2022-09-29
 *
 * @attention
 *
 *  Copyright (C) 2022 Geehy Semiconductor
 *
 *  You may not use this file except in compliance with the
 *  GEEHY COPYRIGHT NOTICE (GEEHY SOFTWARE PACKAGE LICENSE).
 *
 *  The program is only for reference, which is distributed in the hope
 *  that it will be usefull and instructional for customers to develop
 *  their software. Unless required by applicable law or agreed to in
 *  writing, the program is distributed on an "AS IS" BASIS, WITHOUT
 *  ANY WARRANTY OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the GEEHY SOFTWARE PACKAGE LICENSE for the governing permissions
 *  and limitations under the License.
 */

&par Example Description

This example describes how to use the USB device module on APM32F072 to
enumerated as a MSC USB disk. This example use PC as host, and APM32F072 use
RAM to simulate usb flash drives. PC will recognize the motherboard as a
disk, and formatting the U disk. This example will be used to test USB speed.

The USART1 is configured as follows:
    - TX:PA9, RX:PA10
    - BaudRate = 115200 baud
    - Word Length = 8 Bits
    - One Stop Bit
    - No parity
    - Hardware flow control disabled (RTS and CTS signals)
    - Receive and transmit enabled

&par Hardware Description
    - PA11 -> USBD-
    - PA12 -> USBD+
    - Close J7
    - Close J1 and J3

&par Directory contents

  - USB/USB_MSC_Disk/Source/apm32f0xx_int.c       Interrupt handlers
  - USB/USB_MSC_Disk/Source/usbd_msc.c            USB MSC handlers
  - USB/USB_MSC_Disk/Source/usbd_descriptor.c     USB MSC Descriptor
  - USB/USB_MSC_Disk/Source/usbd_bsp.c            USB device board support package
  - USB/USB_MSC_Disk/Source/usbd_storage_disk.c   Storage disk operations functions
  - USB/USB_MSC_Disk/Source/main.c                Main program

&par IDE environment

  - MDK-ARM V5.36
  - EWARM V8.50.4.26131

&par Hardware and Software environment

  - This example runs on APM32F072 EVAL Devices.
