README, Fixed-Point MP3 Decoder:
================================

SpecC model of a fixed-point implementation of a MP3 decoder example design.


Based on a reference C implementation obtained from [1]:
  libmad - MPEG audio decoder library
  Copyright (C) 2000-2004 Underbit Technologies, Inc.
  
The SpecC adaptation is [2]:
  Copyright (C) 2006-2007
  Center for Embedded Computer Systems (CECS)
  University of California, Irvine
  http://www.cecs.uci.edu/~specc
  specc@cecs.uci.edu

Please read the COPYRIGHT file for copyright and warranty information.
The code is release under the terms of the GNU General Public License (GPL).
Please see the file COPYING for a full text of the GNU GPL.


Changes made in the SpecC version include:
    - Layer III only
    - Code modifications (e.g. no function pointers)
    - 16-bit stereo PCM output (raw samples via RAW_SAMPLES macro)
    - Removed malloc/calloc, replaced memcpy/memmove with own versions


To compile the SpecC model run:

    make
    
or, if you are using the SpecC reference compiler (scrc), type

    make SCC=scrc
    

To run the test case, decoding three MP3 files into PCM and comparing
the results against the reference [1], type

    make test


References:
-----------

[1] Underbit Technologies, Inc.,
    "MAD: MPEG audio decoder,"
    http://www.underbit.com/products/mad.

[2] A. Gerstlauer, D. Shin, S. Abdi, P. Chandraiah, D. Gajski,
    "Design of a MP3 Decoder using the System-On-Chip Environment (SCE),"
    UC Irvine, Technical Report CECS-TR-07-05, November 2007.


-- 
10/05/06  A. Gerstlauer <gerstl@cecs.uci.edu>
