See INSTALL file for instruction on how to install Speex.

The Speex is a patent-free, Open Source/Free Software voice codec. Unlike other codecs like MP3 and Ogg Vorbis, Speex is designed to compress voice at bitrates in the 2-45 kbps range. Possible applications include VoIP, internet audio streaming, archiving of speech data (e.g. voice mail), and audio books. In some sense, it is meant to be complementary to the Ogg Vorbis codec.

To use the Speex command line tools:

% speexenc [options] input_file.wav compressed_file.spx

% speexdec [options] compressed_file.spx output_file.wav

These are all of the changes and additions necessary to build a loopback application for the
TI C6415, C5509A, or C5416 simulators using the TI Code Composer Studio (CCS) development system.
A trial version of the tools can be downloaded from the TI website.

This build runs 8kbps narrowband, with minimum complexity.

Several changes are introduced in Speex 1.1.11 which are used in these applications:

arch.h: Added switch for compilers not supporting "long long" (C55x does, C54x, CCS 2.x C64x does not)
bits.c: Allow external definition for max buffer size, changed MAX_BYTES_PER_FRAME
        to MAX_CHARS_PER_FRAME for consistency
misc.c: Added override switches to alloc routines, conditional include of user file "user_misc.h".
        These changes allow manual memory allocation rather than using heap

The arch.h change allows operation with 2.x versions of Code Composer Studio.
The bits.c change reduces the data memory usage.
The misc.c change allows private memory allocation, for cases where it is not
desirable to use the normal heap.

Added files:

testenc-TI-C5x.c  (For C54x and C55x builds, derived from testenc.c,
                       manual alloc, byte packing/unpacking added)
testenc-TI-C64x.c  (For C64x builds, derived from testenc.c, manual alloc, byte packing/unpacking added)

config.h (not automatically generated, sets memory sizes, enables/disables manual alloc)
user_misc.h (contains the manual memory alloc routines, with debug code to display mem usage)
speex\speex_config_types.h (match Speex types to compiler types, not generated from types.in)

speex_c54_test\speex_c54_test.cmd (C5416 linker command file)
speex_c54_test\speex_c54_test.pjt (Code Composer Studio Project File )
speex_c55_test\speex_c55_test.cmd (C5509A linker command file)
speex_c55_test\speex_c55_test.pjt (Code Composer Studio Project File )
speex_c64_test\speex_c64_test.cmd (C6415 linker command file)
speex_c64_test\speex_c64_test.pjt (Code Composer Studio Project File )

samples\male.snd

Usage:
1. Create a Speex 1.1.11 (or later) source tree.
2. Edit the files testenc-TI-C5x.c and/or testenc-TI-C64x.c to change the hard-coded path
   for the test audio and data files.
   This build uses the file e:\speextrunktest\samples\male.snd.
   Note:  This is a headerless 16-bit stereo audio file derived from the male.wav test file
          http://www.speex.org/samples/male.wav
3. Edit the .pjt file with a text editor and change projdir or projectdir to the correct path
   (one place near the top of the file).
4. Edit config.h if desired, to change the memory allocation method (calloc or manual),
   and to enable/disable debug prints for the memory allocation
   (this makes it easier to determine the required size).
5. Run Code Composer Studio, and open the project for the desired target (e.g. speex_c55_test).
   Note that the correct simulator must be selected (in CCS Setup) before starting CCS.
6. Build and run the simulation.

Note that assembly optimizations will be required to run C54x in real time.
There are no assembly optimizations in any of these builds.

Speex has been ported to the Blackfin DSP, for the STAMP development board.

This port has been tested on the STAMP development board and requires the
toolchain available at http://blackfin.uclinux.org/

1/ In order to cross-compile for uClinux from the Speex tarball:

  ./configure --enable-blackfin-asm --enable-fixed-point --host=bfin-uclinux
  cd libspeex
  make

The --enable-blackfin-asm option is not required, but it speeds up Speex by
approximately a factor of two.

2/ In order to cross-compile for uClinux from the Speex Git:

  git clone git://git.xiph.org/speex.git
  cd speex
  ./autogen.sh --enable-blackfin-asm --enable-fixed-point --host=bfin-uclinux
  cd libspeex
  make

Using Speex on Symbian OS
Conrad Parker and Colin Ward, CSIRO Australia, July 2004


Introduction
------------

The symbian/ directory contains the following files for Symbian's abuild tool:

  bld.inf    Component definition file
  speex.mmp  Project specification file
  config.h   Configuration options for both emulator and device builds


Developing applications for libspeex for Symbian OS
---------------------------------------------------

     Any references to the statically defined SpeexMode structures must be
     replaced by a call to a speex_lib_get_mode () for that mode.

     * References to the statically defined array speex_mode_list[modeID]
     must be replaced by a call to speex_lib_get_mode (modeID):

-      mode = speex_mode_list[modeID];
+      mode = speex_lib_get_mode (modeID);

     * References to the statically defined mode structures must be replaced:

       SpeexMode * mode1, * mode2, * mode3;

-      mode1 = &speex_nb_mode;
+      mode1 = speex_lib_get_mode (SPEEX_MODEID_NB);

-      mode2 = &speex_wb_mode;
+      mode2 = speex_lib_get_mode (SPEEX_MODEID_WB);

-      mode3 = &speex_uwb_mode;
+      mode3 = speex_lib_get_mode (SPEEX_MODEID_UWB);

     Note that the constants SPEEX_MODEID_NB, SPEEX_MODEID_WB and
     SPEEX_MODEID_UWB were introduced in libspeex 1.1.6, and are
     defined in <speex/speex.h>. speex_lib_get_mode() was introduced
     in libspeex 1.1.7 and is declared in <speex/speex.h>.