readme.txt

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

*******************************************************************************


                              Cirrus Logic, Inc.


                                 Maverick(tm)


                             Internet Audio Player
                              Reference Software


                                  Release 16


                                 July 9, 2001


*******************************************************************************


                               ==> Warning <==

Be sure to carefully read this entire file to ensure that the software works
as expected.  Also, do not mix and match software components from different
releases (such as the player from one release with the USB driver from another)
as this will most likely not work correctly.

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

                               ==> Features <==

* Supports the following codecs:
  - MP3 playback (decoder library included in this package).
  - WMA playback (evaluation decoder library included in this package, full
    decoder library and DRM library must be separately obtained from
    Microsoft).
  - AAC playback (decoder library must be separately obtained from Cirrus
    Logic).
  - ACELP.net playback (decoder library must be separately obtained from
    VoiceAge Corporation).
  - Microsoft ADPCM playback and record (encoder/decoder source included in
    this package).  Files recorded with MS ADPCM can be played back on the PC.
  - G.721 playback and record (encoder/decoder source included in this
    package).  Files recorded with G.721 can not be played back on the PC.

* Supports the following AudibleReady portable device requirements and
  recommendations (see the AudibleReady Portable Device Requirements
  specification for details):
  - Indication of Audible programs.
  - Maintenance of playback position.
  - Navigation of program sections.
  - Storage of program meta-data.
  - Long duration time display.
  - Accelerated navigation.

* Supports InterTrust Technologies Corp.'s Rights/PD(tm) (decryption library
  must be separately obtained from InterTrust).

* Contains an evaluation version of the Cirrus Logic SSFDC filesystem,
  supporting the following media:
  - On-board NAND FLASH.
  - SmartMedia cards.
  - MMC cards.

* All strings within the player are stored in Unicode and communicated to the
  host in Unicode.

* Downloads files via the USB at ~400K bytes per second.

* Windows GUI for downloading files via the USB.

* Windows Media Device Manager (WMDM) Service Provider Interface (SPI),
  allowing content download via WMDM-compliant applications, such as Windows
  Media Player Version 7.

* Player software update via the USB.

* Software sample rate conversion for non-44100Hz audio streams.

* Supports the sample clock generator on the EP73xx, eliminating the need for
  the software sample rate converter for 32000Hz and 48000Hz streams.

* Supports the tone and volume controls in the CS43L43 (via communication over
  a two-wire serial interface).

* Supports configuring the CS53L32A (via communication over a two-wire serial
  interface).

* Software tone and volume controls if needed.

* Modular output processing architecture which allows easy addition of third
  party audio processing effects.

* Supports the following third party audio processing effects:
  - WOW(tm) from SRS Labs (audio processing library must be separately obtained
    from SRS).
  - Q2X from QSound Labs (audio processing library included in this package).
  - Digital OnTheGoFX from Spatializer Audio Laboratories (evaluation audio
    processing library included in this package, full version must be
    separately obtained from Spatializer).

* Runs on the EP7209 evaluation board, the EP7212 reference design (revision
  B and C), the EP7309 reference design (revision B and C), the EP73xx
  evaluation board, and the EP7312 evaluation board.

* Can be built with the ARM Software Development Toolkit, Version 2.5, with the
  ARM Developer Suite, Version 1.x, or with the GNU toolchain.

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

                              ==> Limitations <==

* The evaluation version of the Cirrus Logic SSFDC filesystem has the following
  limitations:
  - It can only access 4MB, 8MB, and 16MB NAND FLASH/SmartMedia devices.
  - It will only store 10 files in the root directory.  If more than 10 files
    exist in the root directory, only the first 10 can be accessed.
  - It will only store 1MB of data in each file.  If more than 1MB of data
    exists in a file, only the first 1MB of data can be accessed.
  - It can not add, remove, or view any subdirectories, or access any files in
    subdirectories.

  The full version can access 4MB, 8MB, 16MB, 32MB, 64MB, and 128MB NAND FLASH
  devices, has no limitations on file size, quantity, or location (other than
  the actual limits of the media), and has full subdirectory support.  Contact
  your Cirrus Logic sales representative for details on obtaining the full
  version.

  Also included in this package is a very rudimentary file system (contained
  in player/nandfs.c) which only supports a single file and is not really
  usable for a real product.  It's only limitation is the fact that it stores
  only a single file; it can access any sized NAND FLASH, but is not compatible
  with the file system used on SmartMedia cards.  If the limitations of the
  evaluation version of the Cirrus Logic SSFDC file system are not acceptable,
  the rudimentary file system can be used instead.

* The evaluation version of WMA has the following limitations:
  - It will only play one minute's worth of audio for each track.  More
    specifically, it will decode (60 * sample rate) samples from each track,
    regardless of any seeking that is done (i.e. if you play 30 seconds, then
    seek forward 5 seconds, it will then play another 30 seconds and then
    stop).
  - Digital Rights Management is not supported.

  Contact Microsoft to obtain the full version of the WMA library.

* The evaluation version of Digital OnTheGoFX has the following limitation:
  - A tone will be inserted into the audio stream approximately every 40
    seconds.

  Contact Spatializer to obtain the full version of the OnTheGoFX library.

* While the AudibleReady portable device requirements are implemented in the
  player software, there is no support in the PC software for accessing the
  full AudibleReady functionality of the player.

* While InterTrust's Rights/PD is supported, there is no support in the PC
  software for integrating with InterTrust's host side software.

* SmartMedia cards can only be hot plugged and unplugged on the EP7209
  reference design, not on the EP7209, EP73xx or EP7312 evaluation boards.
  This is due to a limitation in the design of the evaluation boards.

* MMC card support is very minimal.  Both single card sockets and two card
  stacked sockets (with both cards being used) are supported.  With a two card
  socket, the order of the two cards is dependent upon the IDs of the cards,
  not the slots in the socket.  Also, dynamic insertion/removal of MMC card(s)
  is not supported; the card(s) are enumerated at startup and are assumed to
  remain forever inserted.  Finally, there are no MMC sockets on any available
  board, so a socket must be breadboarded onto a board.

* When built with the ARM Developer Suite, the following features are not
  supported (due to the lack of libraries compatible with the ADS linker):
  - Rights/PD

* When built with the GNU toolchain, the following features are not supported
  (due to the lack of libraries compatible with the GNU linker):
  - WMA decode
  - ACELP.net decode
  - Digital OnTheGoFX audio processing

  Also, the GNU compiler is not very efficient about its use of the stack, so
  the default stack size is increased when compiling with the GNU toolchain,
  resulting in less SRAM available for other uses.

* There is not a USB driver for Linux, so while the player can be built on
  Linux and downloaded to the board on Linux, music can not be downloaded to
  the board on Linux.

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

                               ==> Licensing <==

The following modules must be licensed before they can be included in a
product (the company to contact for licensing is listed as well):

* WMA (Microsoft)
* AAC (Cirrus Logic)
* ACELP.net (VoiceAge)
* WOW (SRS)
* Q2X (QSound)
* Digital OnTheGoFX (Spatializer)
* Cirrus Logic SSFDC filesystem (Cirrus Logic)
* Rights/PD (InterTrust)

Additionally, to use the twowire library, the I2C patent must be licensed from
Philips for use on the Maverick processor.

Obtaining proper licensing is the responsibility of the OEM.

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

                         ==> Files In This Package <==

bin/* - Windows versions of Unix utilities needed to build the software under
        Windows.

bootcode/* - Source code for the bootup/update program.

crd7212c/* - Pre-built images for use with the EP7212 reference design,
             revision C.

crd7309c/* - Pre-built images for use with the EP7309 reference design,
             revision C.

download/* - Source code for the download utility.

download/download - Pre-built download executable for use on Linux.

download/download.exe - Pre-built download executable for use on Windows.

edb7209/* - Pre-built images for use with the EP7209 evaluation board.

edb7312/* - Pre-built images for use with the EP7312 evaluation board.

player/* - Source code for the Maverick Internet Audio Player.

tools/* - Source code for the tools used during the build process.

tools/buildimg - Pre-built buildimg executable for use on Linux.

tools/buildimg.exe - Pre-built buildimg executable for use on Windows.

tools/package - Pre-built package executable for use on Linux.

tools/package.exe - Pre-built package executable for use on Windows.

unformat/* - Source code for the program which unformats the NAND FLASH on the
             boards.

windows/* - Files which are only for use on Windows.

windows/mavspi/* - Source code for the WMDM SPI.

windows/mavusb/* - Source code for the Windows application for communicating
                   with the player over the USB.

windows/usbdrvr/* - Source code for the Windows 98/Windows NT USB driver for
                    the Maverick Internet Audio Player.

windows/mavspi.dll - Pre-built image of the WMDM SPI.

windows/mavusb.exe - Pre-built image of the Windows communication application.

windows/mavusb.inf - INF file used to install the USB driver.

windows/mavusb.sys - Pre-built image of the USB driver.

asmdefs.h - Definitions for the assembler directivies used by the assembly
            source.

config.h - Source file which contains the software configuration parameters.

ep72xx.h - Source file which contains the register definitions of the EP7209/
           EP7212 and the various external peripherals on the boards.

ep73xx.h - Source file which contains the register definitions of the EP7209/
           EP7312 and the various external peripherals on the boards.

getdefs.awk - Awk script which extracts "#define"s from a file and prints them
              in a syntax which can be read by make.  This is used as part of
              the build process.

hwdefs.h - Source file which includes the appropriate register definition file
           for the Maverick processor being used.

hwport.h - Source file which contains the board specific definitions for the
           player and the unformat code.

makedefs - The default rules used by all makefiles in the source tree.

makefile - The makefile which builds all of the software.

mkarray.awk - Awk script which converts a binary file into a C header file.
              This is used as part of the build process.

readme.txt - This file.

Since the player distribution is in a ZIP file, which does not retain file
permissions on Linux, the pre-built executables for Linux must be made
executable (via the "chmod" command) before they can be run.

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

                        ==> Downloading The Player <==

Four pre-built player images are supplied in the release distribution:

  edb7209/player.img - For use on the EP7209 evaluation board