readme.txt

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

  crd7212c/player.img - For use on the EP7212 reference design (revision C)

  crd7309c/player.img - For use on the EP7309 reference design (revision C)

  edb7312/player.img - For use on the EP7312 evaluation board

Alternately, a player image can be built from the source and then downloaded.
Downloading a version of the player to a board other than the one on which it
is intended to run will have unpredictable results (though it will almost
certainly not fully function).  The procedure used to download is dependent
upon the board.

The download utility on Linux requires root authority (since it must open
/dev/ttyS?, which is normally installed with root-only read/write access).
Either run download as root, make download a set-userid root program, or change
the permissions on /dev/ttyS? to be less restrictive.

* EP7209 and EP73xx Evaluation Boards

  The following procedure is used to download to the EP7209 and EP73xx
  evaluation boards:

  - Power off the board.
  - Put a jumper on JP2.
  - Connect "serial port 0" of the board to an available serial port on the PC
    with a NULL modem cable.
  - Run "download {image file name}" on the PC.  If the PC serial port being
    used is not COM1, then specify the number after the name of the ROM (i.e.
    "download {image file name} 3" for COM3).
  - Power on the board.
  - Press the "WAKEUP" button on the board.
  - Wait until "download" says it has successfully downloaded the image.
  - Power off the board.
  - Remove the jumper from JP2.

* EP7212 and EP7309 Reference Designs

  The following procedure is used to download to the EP7212 and EP7309
  reference designs (all versions):

  - Connect the board's serial port to an available serial port on the PC with
    a NULL modem cable.
  - Run "download {image file name}" on the PC.  If the PC serial port being
    used is not COM1, then specify the number after the name of the ROM (i.e.
    "download {image file name} 3" for COM3).
  - Hold the nBROM button on the board.
  - Power on the board (or press and release the POR button if the board is
    already powered on).
  - Once "download" says it has started downloading, release the nBROM button.
  - Wait until "download" says it has successfully downloaded the image.

* EP7312 Evaluation Board

  The following procedure is used to download to the EP7312 evaluation board:

  - Power on the board.
  - Connect "serial port 0" of the board to an available serial port on the PC
    with a NULL modem cable.
  - Run "download {image file name}" on the PC.  If the PC serial port being
    used is not COM1, then specify the number after the name of the ROM (i.e.
    "download {image file name} 3" for COM3).
  - Press and hold the "CPU BROM" button on the board.
  - Press and release the "CPU POR" button on the board.
  - Release the "CPU BROM" button on the board.
  - Wait until "download" says it has successfully downloaded the image.

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

                      ==> Unformatting The NAND FLASH <==

If a version of the player older than release 12 was previously running on the
board, or a complete erase of the NAND FLASH (restoring it to the factory
state) is desired, the unformat utility must be run before the player can be
run.  Eight pre-built unformat utilities are supplied in the release
distribution:

  edb7209/unformat - For use with the EP7209 evaluation board for use on Linux

  edb7209/unformat.exe - For use with the EP7209 evaluation board for use on
                         Windows

  crd7212c/unformat - For use with the EP7212 reference design (revision C) for
                      use on Linux

  crd7212c/unformat.exe - For use with the EP7212 reference design (revision C)
                          for use on Windows

  crd7309c/unformat - For use with the EP7309 reference design (revision C) for
                      use on Linux

  crd7309c/unformat.exe - For use with the EP7309 reference design (revision C)
                          for use on Windows

  edb7312/unformat - For use with the EP7312 evaluation board for use on Linux

  edb7312/unformat.exe - For use with the EP7312 evaluation board for use on
                         Windows

Using a version of the unformat utility on a board other than the one for
which it is intended to be used will have unpredictable results (though it will
almost certainly not erase the NAND FLASH).

The unformat utility on Linux requires root authority (since it must open
/dev/ttyS?, which is normally installed with root-only read/write access).
Either run unformat as root, make unformat a set-userid root program, or change
the permissions on /dev/ttyS? to be less restrictive.

The procedure for running the unformat utility is the same as running the
download utility (see above), except that "unformat" (with no file name
argument) is run instead of "download".  To specify a different PC serial port,
specify the port number (i.e. "unformat 3" for COM3).

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

                          ==> Running The Player <==

After the player has been downloaded to the board, and the NAND FLASH has been
erased (if necessary), the player can be run.  The procedure for running the
player is dependent upon the board:

* EP7209 Evaluation Board and EP73xx Evaluation Board
  - Connect "serial port 0" of the board to an available serial port on the PC
    with a NULL modem cable.
  - Run a communications program (such as HyperTerminal) and configure it for
    the PC serial port, 115,200 baud, and 8-N-1.
  - Power on the board.
  - Press the "wakeup" button on the board.
  - A message will appear on the communications program saying "Stopped".

* EP7212 Reference Board and EP7309 Reference Board
  - Power on the board.
  - The Cirrus Logic logo will appear on the LCD, followed by the Maverick
    logo.

* EP7312 Evaluation Board
  - Connect "serial port 0" of the board to an available serial port on the PC
    with a NULL modem cable.
  - Run a communications program (such as HyperTerminal) and configure it for
    the PC serial port, 115,200 baud, and 8-N-1.
  - Power on the board.
  - A message will appear on the communications program saying "Stopped".

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

                      ==> Installing The USB Drivers <==

Currently, USB drivers for the Internet Audio Player are only available for
Windows (98, NT 4, Me, and 2000).  It is not possible to utilize the USB
interface on the board when using Linux (and therefore it is not possible to
download music to the board using Linux).

Once the player is running on the board, connect the USB cable between the
board and the PC.  If Windows does not have a driver for the player, it will
start the Add New Hardware Wizard to install drivers (see the Installing For
The First Time section below for details).  If drivers are already installed,
they will be loaded by Windows.  If running a new release of the player
software for the first time, or if newly built drivers need to be installed,
see the Updating Existing Drivers section below for details.

If a previous version of the player was previously running on the board, then
the new USB drivers must be installed on the PC in order to ensure proper
operation of the mavusb program.

The procedure given for installing drivers was taken from Windows 98; the
procedure in other versions of Windows might be slightly different.  Also,
Windows might be configured to not allow installation of device drivers; if so,
consult your system administrator for help.

                     --> Installing For The First Time <--

If drivers do not exist for the Internet Audio Player, the Add New Hardware
Wizard will appear on the screen when the player is plugged into the USB port.
When it does, perform the following steps:

* Click on "Next".
* Specify "Search for the best driver..." and then click on "Next".
* Choose "Specify a location" and type the location of the windows directory
  within the player software in the location field.
* Click on "Next".
* It should fin the INF file for the Maverick Internet Audio Player.  If it
  does not, click on "Back" and verify the directory location.
* Click on "Next".
* When it finishes loading the driver, click on "Finish".

                       --> Updating Existing Drivers <--

To update existing drivers to the drivers supplied with this package, or to
install newly built drivers, perform the following steps:

* Make sure that the player is running and connected to the computer's USB
  port.
* Right click on "My Computer" and select "Properties".
* Select the "Device Manager" tab.
* Click on the "+" next to "Universal serial bus controller".
* Click on the "Cirrus Logic Maverick(tm) Internet Audio Player".
* Click on the "Properties" button at the bottom.
* Click on the "Driver" tab.
* Click on the "Update Driver" button.
* Click on "Next".
* Specify "Search for a better driver..." and then click on "Next".
* Choose "Specify a location" and type the location of the windows directory
  within the player software in the location field.
* Click on "Next".
* It should find the INF file for the Maverick Internet Audio Player.  If it
  does not, click on "Back" and verify the directory location.
* Click on "Next".
* When it finishes loading the new driver, click on "Finish".

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

                           ==> Downloading Music <==

The mavusb.exe program is used to download music to the player.  With the
player running on the board and the USB cable connecting the board to the PC,
run the mavusb program.  Do not use a mavusb program from a previous version of
the player as it will most likely not work as expected.

Mavusb will display the set of files that are on the player.  Files can be
downloaded to the player in one of three ways: drag and drop a file from
someplace else onto the mavusb window, paste a file from the clipboard (Paste
from the Edit menu, or by pressing Ctrl-V), or opening a file with mavusb (Open
from the File menu, or by pressing Ctrl-O).  The mavusb application must be
closed before the player can be used to play the music that has been downloaded
to it.

The mavusb program can also be used to update the software that is running on
the player.  Selecting Update from the Tools menu will start the update
process.  After specifying the file containing the new software to be used, the
software on the player is updated and the player restarted.  The new software
must be packaged before it can be programmed into the player; this is done
automatically as part of the player build (producing player/player.pkg).

The mavusb menus are summarized below:

* File

  Open - Reads a file from the PC and writes it to the player.  Can also be
         accessed by pressing Ctrl-O.

  Save As... - Reads a file from the player and writes it to the PC.  This
               option is only available if one or more files in the mavusb
               window are selected.

  Exit - Exits the mavusb program.

* Edit

  Paste - Reads a file from the clipboard on the PC and writes it to the
          player.  This option is only available if there is a file on the
          clipboard.  Cal also be accessed by pressing Ctrl-V.

  Delete - Deletes the specified file(s) from the player.  This option is only
           available if one or more files in the mavusb window are selected.
           Can also be accessed by pressing Del.

  Select All - Selects all the files on the player.  Can also be accessed by
               pressing Ctrl-A.

* View

  Large Icons - Displays the files on the player using large icons.

  Small Icons - Displays the files on the player using small icons.

  List - Displays the files on the player using a list format.

  Details - Displays the files on the player using a list format with
            additional file details (file size and creation date/time).

  Refresh - Regenerates the list of files on the player by re-scanning the
            player.

* Drive

  Internal - Displays files from the on-board NAND FLASH.  This also becomes
             the location where files are copied to the player.

  External - Displays files from the SmartMedia card.  This also becomes the
             location where files are copied to the player.

* Tools

  Status - Displays the status of the currently selected drive.  The number of
           files, space used, space available, and total space are all
           displayed.

  Format - Formats the currently selected drive, erasing all files on the
           drive.

  Update - Writes new player software to the player.

* Help

  About - Displays a message box giving the version of the mavusb program.

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

                           ==> Using The Player <==

The player controls are different on each board since each board has a
different set of buttons and a different display.  Therefore, the operation of
the player is different on each board:

* EP7209 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