   ITU-T G.729A Speech Coder with Annex B    ANSI-C Source Code
   Version 1.4    Last modified: November, 2000 */

TITLE
-----
Fixed-point description of Recommendation G.729A with ANNEX B

Coding of Speech at 8 kbit/s using Conjugate-Structure
Algebraic-Code-Excited Linear-Prediction (CS-ACELP) with
Voice Activity Decision(VAD), Discontinuous Transmission(DTX), 
and Comfort Noise Generation(CNG).


SOFTWARE AND INTELLECTUAL PROPERTY
----------------------------------
This software package is provided as part of ITU-T Recommendation G.729B.

 Copyright (c) 1996, AT&T, France Telecom, Lucent Technologies, NTT, 
                     Rockwell International, Universite de Sherbrooke.
 All rights reserved.

The copy of the source C code, version 1.4, is given under Copyright of the 
authors, only for the purpose of establishing the specification of a codec.


VERSION
-------
This is version 1.4.

----------------------------------------------------------------------------
   Differences between Version 1.2 and Version 1.1 :

 In version 1.2, tab_dtx.h, tab_dtx.c, vad.c and calcexc.c were updated as
per Corrigendum to annex B of G.729 published in COM 16-R20.

----------------------------------------------------------------------------
   Differences between Version 1.3 and Version 1.2 :

file : DEC_LD8A.C
*****************
Version 1.2 lines 151 to 153 :
----------------------------------------------------------------------------
  if(bfi == 1)
    if(past_ftyp == 1) ftyp = 1;
    else ftyp = 0;
----------------------------------------------------------------------------
replaced in Version 1.3 by lines 151 to 155 :
----------------------------------------------------------------------------
  if(bfi == 1) {
    if(past_ftyp == 1) ftyp = 1;
    else ftyp = 0;
    *parm = ftyp;  /* modification introduced in version V1.3 */
  }

file : BITS.C
*************
function : read_frame()

----------------------------------------------------------------------------
Version 1.2 line 219-224 :
----------------------------------------------------------------------------
  /* the hardware detects frame erasures by checking if all bits
     are set to zero */

  parm[0] = 0;           /* No frame erasure */
  for (i=0; i < serial[1]; i++)
    if (serial[i+2] == 0 ) parm[0] = 1;  /* frame erased     */
----------------------------------------------------------------------------
replaced in Version 1.3 by lines 219-230 :
----------------------------------------------------------------------------
  /* This part was modified for version V1.3 */
  /* for speech and SID frames, the hardware detects frame erasures
     by checking if all bits are set to zero */
  /* for untransmitted frames, the hardware detects frame erasures
     by testing serial[0] */

  parm[0] = 0;           /* No frame erasure */
  if(serial[1] != 0) {
   for (i=0; i < serial[1]; i++)
     if (serial[i+2] == 0 ) parm[0] = 1;  /* frame erased     */
  }
  else if(serial[0] != SYNC_WORD) parm[0] = 1;
----------------------------------------------------------------------------
   Differences between Version 1.4 and Version 1.3 :

In Version 1.4 the initialization of lspSid in dec_sid.c has been updated
according to the Corrigendum to Annex B of G.729 published in COM 16-R 60-E.

In terms of functionality, only the file dec_sid.c has changed.  For 
compilation purposes the two makefiles were changed, and the version number
was changed in coder.c and decoder.c.

The changes from Version 1.3 to Version 1.4 do not affect the test vectors.
----------------------------------------------------------------------------

DESCRIPTION
-----------
  This package includes the files needed to build the fixed point version
of the G.729A codec with VAD/DTX/CNG as described in ANNEX B.

 It includes also the PC executable (coder.exe and decoder.exe), a batch file
(test.bat), speech (test.inp) and data files (test_a.bit and test_a.syn) to 
verify the execution.  The binary reference files are in PC format. 


SIMILARITIES AND DIFFERENCES WITH G.729A
----------------------------------------

Common files with G.729A
~~~~~~~~~~~~~~~~~~~~~~~~
acelp_ca.c
basic_op.c
cor_func.c
de_acelp.c
dec_gain.c
dec_lag3.c
dspfunc.c
filter.c
gainpred.c
lpcfunc.c
lspgetq.c
oper_32b.c
p_parity.c
pitch_a.c
post_pro.c
pre_proc.c
pred_lt3.c
qua_gain.c
taming.c
basic_op.h
oper_32b.h
typedef.h

Files in G.729A but modified for ANNEX B
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
bits.c
cod_ld8a.c
coder.c
dec_ld8a.c
decoder.c
lpc.c
lspdec.c
postfilt.c
qua_lsp.c
tab_ld8a.c
util.c
ld8a.h
tab_ld8a.h

Files only in ANNEX B 
~~~~~~~~~~~~~~~~~~~~~
calcexc.c
dec_sid.c
dtx.c
qsidgain.c
qsidlsf.c
tab_dtx.c
vad.c
dtx.h
octet.h
sid.h
tab_dtx.h
vad.h


COMPILATION
-----------

Edit the file typedef.h to comply to your target platform


For UNIX systems the following makefiles are provided

   coder.mak
   decoder.mak



Edit the makefiles coder.mak and decoder.mak to set the proper options
for your system.
The command to compile and link all code on a UNIX system is

     make -f coder.mak
     make -f decoder.mak

For other platforms, the *.mak files can be used to work out the
compilation procedures.

This code has been successfully compiled and run on the following
platforms:

Platform                   Operating System      Compiler
-----------------------------------------------------------------------------
DEC ALPHA                  OSF/1                 DEC OSF/1 cc
SGI                        IRIX 5.2              cc
SUN                        SUNOS 4.1.3           gcc
PC                         DOS 6.2               Borland 4.02
                                                 Microsoft Quick C 2.5
                                                 Microsoft Visual C++ 1.51
                                                 Watcom 10.6
PC                         DOS 6.21              Borland 3.1
                                                 Microsoft 8
                                                 Watcom 9.6


USAGE
-----
The following files are used or generated
  inputfile    8 kHz sampled data file 16 bit PCM (binary)
  outputfile   8 kHz sampled data file 16 bit PCM (binary)
  bitstreamfile  binary file containing bitstream
The following parameter is used for the encoder
  dtx_option   = 1 : DTX enabled   0 : DTX disabled

coder  inputfile bitstreamfile dtx_option
decoder bitstreamfile outputfile
