1  /* ***** BEGIN LICENSE BLOCK *****
  2   * Version: RCSL 1.0/RPSL 1.0
  3   *
  4   * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved.
  5   *
  6   * The contents of this file, and the files included with this file, are
  7   * subject to the current version of the RealNetworks Public Source License
  8   * Version 1.0 (the "RPSL") available at
  9   * http://www.helixcommunity.org/content/rpsl unless you have licensed
 10   * the file under the RealNetworks Community Source License Version 1.0
 11   * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl,
 12   * in which case the RCSL will apply. You may also obtain the license terms
 13   * directly from RealNetworks.  You may not use this file except in
 14   * compliance with the RPSL or, if you have a valid RCSL with RealNetworks
 15   * applicable to this file, the RCSL.  Please see the applicable RPSL or
 16   * RCSL for the rights, obligations and limitations governing use of the
 17   * contents of the file.
 18   *
 19   * This file is part of the Helix DNA Technology. RealNetworks is the
 20   * developer of the Original Code and owns the copyrights in the portions
 21   * it created.
 22   *
 23   * This file, and the files included with this file, is distributed and made
 24   * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 25   * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 26   * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS
 27   * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 28   *
 29   * Technology Compatibility Kit Test Suite(s) Location:
 30   *    http://www.helixcommunity.org/content/tck
 31   *
 32   * Contributor(s):
 33   *
 34   * ***** END LICENSE BLOCK ***** */
 35  
 36  /**************************************************************************************
 37   * Fixed-point MP3 decoder
 38   * Jon Recker (jrecker@real.com), Ken Cooke (kenc@real.com)
 39   * June 2003
 40   *
 41   * mp3dec.h - public C API for MP3 decoder
 42   **************************************************************************************/
 43  
 44  #ifndef _MP3DEC_H
 45  #define _MP3DEC_H
 46  
 47  #include <Arduino.h>
 48  
 49  #if defined(_WIN32) && !defined(_WIN32_WCE)
 50  #
 51  #elif defined(_WIN32) && defined(_WIN32_WCE) && defined(ARM)
 52  #
 53  #elif defined(_WIN32) && defined(WINCE_EMULATOR)
 54  #
 55  #elif defined(ARM_ADS)
 56  #
 57  #elif defined(_SYMBIAN) && defined(__WINS__)	/* Symbian emulator for Ix86 */
 58  #
 59  #elif defined(__GNUC__) && defined(ARM)
 60  #
 61  #elif defined(__GNUC__) && defined(__i386__)
 62  #
 63  #elif defined(_OPENWAVE_SIMULATOR) || defined(_OPENWAVE_ARMULATOR)
 64  #
 65  #elif defined(__GNUC__) && defined(__AVR32_UC__)
 66  #
 67  #elif defined(__CORTEX_M) && __CORTEX_M == 0x04U
 68  #
 69  #elif defined(__MK66FX1M0__) || defined(__MK64FX512__) || defined(__MK20DX256__)	/* teensy 3.6, 3.5, or 3.1/2 */
 70  #
 71  #else
 72  #error No platform defined. See valid options in mp3dec.h
 73  #endif
 74  
 75  #ifdef __cplusplus
 76  extern "C" {
 77  #endif
 78  
 79  /* determining MAINBUF_SIZE:
 80   *   max mainDataBegin = (2^9 - 1) bytes (since 9-bit offset) = 511
 81   *   max nSlots (concatenated with mainDataBegin bytes from before) = 1440 - 9 - 4 + 1 = 1428
 82   *   511 + 1428 = 1939, round up to 1940 (4-byte align)
 83   */
 84  #define MAINBUF_SIZE	1940
 85  
 86  #define MAX_NGRAN		2		/* max granules */
 87  #define MAX_NCHAN		2		/* max channels */
 88  #define MAX_NSAMP		576		/* max samples per channel, per granule */
 89  
 90  /* map to 0,1,2 to make table indexing easier */
 91  typedef enum {
 92  	MPEG1 =  0,
 93  	MPEG2 =  1,
 94  	MPEG25 = 2
 95  } MPEGVersion;
 96  
 97  typedef void *HMP3Decoder;
 98  
 99  enum {
100  	ERR_MP3_NONE =                  0,
101  	ERR_MP3_INDATA_UNDERFLOW =     -1,
102  	ERR_MP3_MAINDATA_UNDERFLOW =   -2,
103  	ERR_MP3_FREE_BITRATE_SYNC =    -3,
104  	ERR_MP3_OUT_OF_MEMORY =	       -4,
105  	ERR_MP3_NULL_POINTER =         -5,
106  	ERR_MP3_INVALID_FRAMEHEADER =  -6,
107  	ERR_MP3_INVALID_SIDEINFO =     -7,
108  	ERR_MP3_INVALID_SCALEFACT =    -8,
109  	ERR_MP3_INVALID_HUFFCODES =    -9,
110  	ERR_MP3_INVALID_DEQUANTIZE =   -10,
111  	ERR_MP3_INVALID_IMDCT =        -11,
112  	ERR_MP3_INVALID_SUBBAND =      -12,
113  
114  	ERR_UNKNOWN =                  -9999
115  };
116  
117  typedef struct _MP3FrameInfo {
118  	int bitrate;
119  	int nChans;
120  	int samprate;
121  	int bitsPerSample;
122  	int outputSamps;
123  	int layer;
124  	int version;
125  } MP3FrameInfo;
126  
127  /* public API */
128  HMP3Decoder MP3InitDecoder(void);
129  void MP3FreeDecoder(HMP3Decoder hMP3Decoder);
130  int MP3Decode(HMP3Decoder hMP3Decoder, unsigned char **inbuf, int *bytesLeft, short *outbuf, int useSize);
131  
132  void MP3GetLastFrameInfo(HMP3Decoder hMP3Decoder, MP3FrameInfo *mp3FrameInfo);
133  int MP3GetNextFrameInfo(HMP3Decoder hMP3Decoder, MP3FrameInfo *mp3FrameInfo, unsigned char *buf);
134  int MP3FindSyncWord(unsigned char *buf, int nBytes);
135  
136  #ifdef __cplusplus
137  }
138  #endif
139  
140  #endif	/* _MP3DEC_H */