readme.txt

基于EP7312的MP3播放器源代码,包括MCU和PC端代码.

  as follows:

      +-------+  +-------+  +-------+  +-------+  +-------+  +-------+
      | User1 |  | User2 |  | User3 |  | User4 |  | User5 |  | User6 |
      +-------+  +-------+  +-------+  +-------+  +-------+  +-------+

  The meanings of these buttons are as follows:

  - User1
    - Pressing this button will start playback of the current track, or pause
      if the track is currently playing.
    - Holding this button for one and one half seconds will put the player into
      lower power mode.

  - User2
    - Pressing this button will stop playback of the current track.

  - User3
    - Pressing this button will change the current meaning of User5 and User6,
      advancing backwards through the list of possible meanings.
    - Holding this button will successively advance backwards through the
      meanings of User5 and User6.

  - User4
    - Pressing this button will change the current meaning of User5 and User6,
      advancing forwards through the list of possible meanings.
    - Holding this button will successively advance forwards through the
      meanings of User5 and User6.

  - User5
    - Pressing this button will decrement the value of the currently selected
      item.  For example, it will turn down the volume.  If the current item
      is "seek", it will skip to the beginning of the current track (if the
      current time is greater than 3 seconds) or to the previous track (if the
      current time is less than 3 seconds).
    - Holding this button will successively decrement the value of the current
      item.  If the current item is "seek", it will seek backwards within the
      track.
    - If playing Audible content and the current item is "seek", pressing this
      button will return to the beginning of the current section (if the
      current time is greater than 3 seconds into the section) or will skip to
      the previous section (if the current time is less than 3 seconds).  If
      the current time is within 3 seconds of the beginning of the track,
      pressing this button will skip to the previous track.

  - User6
    - Pressing this button will increment the value of the currently selected
      item.  For example, it will turn up the volume.  If the current item
      is "seek", it will skip to the next track.
    - Holding this button will successively increment the value of the current
      item.  If the current item is "seek", it will seek forwards within the
      track.
    - If playing Audible content and the current item is "seek", pressing this
      button will advance to the next section.  If the last section is already
      being played, it will advance to the next track.

* EP7212 Reference Design (revision B and C) and EP7309 Reference Design
  (revision B and C)

  This board has eight buttons and a small LCD display (128x33).  The LCD is
  used to display the status of the player, and the eight buttons are arranged
  as follows:

                 +-------+
                 | User2 |
                 +-------+

      +-------+  +-------+  +-------+
      | User4 |  | User1 |  | User5 |
      +-------+  +-------+  +-------+

                 +-------+
                 | User3 |
                 +-------+

      +-------+  +-------+  +-------+
      | User6 |  | User7 |  | User8 |
      +-------+  +-------+  +-------+

  The meanings of these buttons are as follows:

  - User1
    - Holding this button for one and one half seconds will put the player into
      low power mode.
    - Pressing this button will take you into and out of menu mode.

  - User2
    - Pressing this button will start playback of the current track, or pause
      if the track is currently playing.
    - While in menu mode, pressing this button will adjust up the value of the
      currently selected menu item.  Holding this button will continue the
      adjustment.

  - User3
    - Pressing this button will stop playback of the current track.
    - While in menu mode, pressing this button will adjust down the value of
      the currently selected menu item.  Holding this button will continue the
      adjustment.

  - User4
    - Pressing this button will return to the beginning of this track (if the
      current time is greater than 3 seconds) or will skip to the previous
      track (if the current time is less than 3 seconds).
    - Holding this button will seek backwards within the track, if the track is
      being played or is paused, and will continue skipping to the previous
      track, if the track is not being played.
    - While in menu mode, pressing this button will move left within the menu
      items.  Holding this button will continue to move left.
    - If playing Audible content, pressing this button will return to the
      beginning of the current section (if the current time is greater than 3
      seconds into the section) or will skip to the previous section (if the
      current time is less than 3 seconds).  If the current time is within 3
      seconds of the beginning of the track, pressing this button will skip to
      the previous track.

  - User5
    - Pressing this button will advance to the next track.
    - Holding this button will seek forwards within the track, if the track is
      being played or is paused, and will continue skipping to the next track,
      if the track is not being played.
    - While in menu mode, pressing this button will move right within the menu
      items.  Holding this button will continue to move right.
    - If playing Audible content, pressing this button will advance to the next
      section.  If the last section is already being played, it will advance to
      the next track.

  - User6
    - Pressing this button will turn the volume down one step.
    - Holding this button will continue the volume down adjustment.

  - User7
    - Holding this button for one second will start recording.  Recording is
      stopped by pressing the "stop" button (User3).

  - User8
    - Pressing this button will turn the volume up one step.
    - Holding this button will continue the volume up adjustment.

* EP73xx Evaluation Board

  This board has six buttons and no display (some of these boards have a
  640x240 ALPS LCD, but this requires too much memory for a frame buffer and
  comsumes too much bus bandwidth to refresh, so it is not used).  Due to the
  lack of a usable display, a serial port is used to "display" status
  information as the player runs.  The six buttons on the board are arranged
  as follows:

      +-------+  +-------+  +-------+
      | User4 |  | User5 |  | User6 |
      +-------+  +-------+  +-------+

      +-------+  +-------+  +-------+
      | User1 |  | User2 |  | User3 |
      +-------+  +-------+  +-------+

  The definitions of the buttons are identical to the EP7209 evaluation board
  (the buttons are simply arranged differently), with one exception:

  - User2
    - Pressing this button will stop playback of the current track.
    - Holding this button for one second will start recording.  Recording is
      stopped by pressing the "stop" button (User2).

* EP7312 Evaluation Board

  This board has six buttons and a large color LCD display (320x240).  Since
  the LCD is so large, it requires too much memory for a frame buffer and
  consumes too much bus bandwidth to refresh, so it is not used.  A serial port
  is instead used to "display" status information as the player runs.  The six
  buttons are arranged as follows:

      +-------+  +-------+  +-------+
      | User2 |  | User4 |  | User6 |
      +-------+  +-------+  +-------+

      +-------+  +-------+  +-------+
      | User1 |  | User3 |  | User5 |
      +-------+  +-------+  +-------+

  The definitions of the buttons are identical to the EP73xx evaluation board
  (the buttons are simply arranged differently).

-------------------------------------------------------------------------------

                         ==> Building The Software <==

The software can be broken into two categories; the code that runs on the ARM
and the code that runs on the PC.  Separate toolchains are used to build each
set of code.  The software must be configured before it can be built, to
specify the toolchains to be used, the board on which the software is to run,
and the features that should be included in the software.

                              --> Configuring <--

The configuration of the software is contained in a file called config.h.  A
set of "#define"s are used to specify how to build the software, including the
toolchains to use and the software features to include.  This file should be
modified (if necessary) before the software is built.

The "#define"s are described below:

* CROSSTOOLS is the name of the toolchain that is used to cross-compile the
  ARM code.  The following toolchains are currently supported:

  gcc - The GNU toolchain is used to build the ARM code.  This was tested using
        version 2.95.3 of gcc and version 2.11 of binutils; other versions may
        or may not work.
  sdt25 - The ARM Software Development Toolkit, Version 2.5 (or 2.51) is used
          to build the ARM code.
  ads - The ARM Developer Suite is used to build the ARM code.

* NATIVETOOLS is the name of the toolchain that is used to compile the PC code.
  The following toolchains are currently supported:

  gcc - The GNU toolchain is used to build the PC code (for use under Linux).
  msvc - Microsoft VisualStudio is used to build the PC code (for use under
         Windows).

* BOARD is the type of board on which the ARM code is to be run.  This affects
  the code in the bootcode, player, and unformat directories.  The following
  boards are currently supported:

  EP7209_Eval_Board - The Cirrus Logic EP7209 Evaluation Board, part number
                      EDB7209-4.

  EP7212_Reference_Board_Rev_A - The Cirrus Logic EP7212 Reference Design, Rev.
                                 A (this board was never generally available).

  EP7212_Reference_Board_Rev_B - The Cirrus Logic EP7212 Reference Design, Rev.
                                 B (this board was never generally available).

  EP7309_Reference_Board_Rev_B - The Cirrus Logic EP7309 Reference Design, Rev.
                                 B (this board was never generally available).

  EP7212_Reference_Board_Rev_C - The Cirrus Logic EP7212 Reference Design, Rev.
                                 C, part number CRD7212-C.

  EP7309_Reference_Board_Rev_C - The Cirrus Logic EP7309 Reference Design, Rev.
                                 C, part number CRD7309-C.

  EP73XX_Eval_Board - The Cirrus Logic EP73xx Evaluation Board (this board was
                      never generally available).

  EP7312_Eval_Board - The Cirrus Logic EP7312 Evaluation Board, part number
                      EDB7312.

* SUPPORT_AAC specifies that the AAC codec should be included in the player.
  This should only be defined once the AAC library and header files have been
  obtained and placed into the player/aac directory.

* SUPPORT_ACELPNET specifies that the ACELP.net codec should be included in the
  player.  This should only be defined once the ACELP.net library and header
  files have been obtained and placed into the player/acelpnet directory.
  There are four variants of the ACELP.net codec that can be individually
  selected by defining one of the following "#define"s:

  - SUPPORT_ACELPNET_5K0 is a variant of ACELP.net that produces audio at 8kHz
    from a 5kbps bitstream.
  - SUPPORT_ACELPNET_6K5 is a variant of ACELP.net that produces audio at 8kHz
    from a 6.5kbps bitstream.
  - SUPPORT_ACELPNET_8K5 is a variant of ACELP.net that produces audio at 8kHz
    from a 8.5kbps bitstream.
  - SUPPORT_ACELPNET_16K0 is a variant of ACELP.net that produces audio at
    16kHz from a 16kbps bitstream.

* SUPPORT_G721 specifies that the G.721 codec should be included in the player.
  This codec produces a 8kHz audio stream from a 32kbps bitstream, and can also
  encode a 8kHz audio stream to a 32kbps bitstream.

* SUPPORT_MP3 specifies that the MP3 codec should be included in the player.

* SUPPORT_MSADPCM specifies that the Microsoft ADPCM codec should be included
  in the player.  This codec produces a 8kHz audio stream from a 32kbps
  bitstream, and can also encode a 8kHz audio stream to a 32kbps bitstream.

* SUPPORT_WMA specifies that the WMA codec should be included in the player.
  This should only be defined once the WMA library and header files have been
  obtained and placed into the player/wma directory (the evalutation version of
  the WMA libraries must be extracted from a Microsoft supplied Windows
  executable included in this distribution).

* SUPPORT_AUDIBLE specifies that support for the Audible Portable Device
  Requirements should be included in the player.

* SUPPORT_SRS specifies that support for SRS Labs' audio processing should be
  included in the player.  All audio will pass through the SRS audio processing
  algorithm.  This should only be defined once the SRS library and header files
  have been obtained and placed into the player/srs directory.

  There are four different variants of SRS' audio processing, one of which can
  be included at a time.  The variants are (in order from the most MIPS to the
  least...consult SRS' documentation for details of these variants):

  - SUPPORT_WOW_FULL - The full version of WOW, which includes stereo
                       enhancement and improved bass response.
  - SUPPORT_WOW_MINIMAL - A version of WOW that approximates the full version
                          of WOW, but uses 20% less processing.
  - SUPPORT_TRU_BASS - Provides improved bass response.
  - SUPPORT_SRS_HEADPHONE - Provides stereo enhancement.

* SUPPORT_QSOUND specifies that support for QSound Labs' audio processing
  should be included in the player.  All audio will pass through the QSound
  audio processing algorithm.

* SUPPORT_SPATIALIZER specifies that support for Spatializer Laboratories'
  audio processing should be included in the player.  All audio will pass
  through the Spatializer audio processing algorithm.

* SUPPORT_RIGHTS_PD specifies that support for InterTrust's Rights/PD should be
  included in the player.  This should only be defined once the Rights/PD
  library and header files have been obtained and placed into the player/itrust