ITU-T G.729 Speech Coder for TMS320C6201 Overview ... - Radisys

www.radisys.com
World Headquarters
5445 NE Dawson Creek Drive • Hillsboro, OR
97124 USA
Phone: 503-615-1100 • Fax: 503-615-1121
Toll-Free: 800-950-0044
International Headquarters
Gebouw Flevopoort • Televisieweg 1A
NL-1322 AC • Almere, The Netherlands
Phone: 31 36 5365595 • Fax: 31 36 5365620
007-00968-0002
November 2000
ITU-T G.729
Speech Coder for
TMS320C6201 †
Overview Guide

November 2000
Copyright ©2000 by RadiSys Corporation.
All rights reserved.
EPC, iRMX, INtime, Inside Advantage, and RadiSys are registered trademarks of RadiSys Corporation. Spirit,
DAI, DAQ, ASM, Brahma, and SAIB are trademarks of RadiSys Corporation.
† All other trademarks, registered trademarks, service marks, and trade names are the property of their
respective owners.

ITU-T G.729 Speech Coder for
TMS320C6201
The ITU-T G.729 Speech Coder for TMS320C6201 algorithm, as specified by the
ITU-T Recommendation G.729 “Coding of speech at 8 kbits/s using conjugatestructure
algebraic-code-excited linear-prediction (CS-ACELP)”, is optimally
implemented for the Texas Instruments TMS320C6x digital signal processor.
The Speech Coder is implemented as an encoder and decoder based on 10 ms
frames, i.e., they act only upon data collected for 10 ms.
For information about installing and using the Speech Coder software, see the
topics listed below.
For information about...
Go to this page...
Installation ........................................................................................................... 2
Requirements ................................................................................................. 2
Install the software ......................................................................................... 2
Compile and link the software......................................................................... 3
Application programmer interface......................................................................... 3
Init_G729Encoder .......................................................................................... 4
Init_G729Decoder .......................................................................................... 5
G729Encoder ................................................................................................. 5
G729_Decoder............................................................................................... 6
G729Encoder1 ............................................................................................... 6
G729Encoder2 ............................................................................................... 7
G729_Decoder............................................................................................... 7
Run-time initializations.................................................................................... 8
Testing and performance specifications................................................................. 8
Where to get more information........................................................................... 10
1

RadiSys Corporation
Installation
To make the Speech Coder software fully functional, follow these steps:
Start
Install the
software
Compile and link
the software
Requirements
Install the software
Done
Figure 1. Installing and building the Speech Coder software
Before you can install this software, you need the following:
• A Microsoft † Windows † 95, Windows 98, or Windows NT † compatible
PC platform.
• The following software installed on your computer:
• TMS320C6x Code Generation Tools Release 3.01 for Windows 95,
Windows 98, or Windows NT
—or—
Code Composer Studio Tools, version 1.2, for Windows 95, Windows 98,
or Windows NT.
• NMAKE utility (available from Microsoft).
• PKUNZIP utility.
To install the Speech Coder software:
1. Create a directory on the target system. For example:
mkdir c:\g729
2. Copy the product files from the CD-ROM to the directory you just created.
Use a copy utility that retains the directory structure, such as Xcopy.
2

ITU-T G.729 Speech Coder for TMS320C6201 Overview Guide
Compile and link the software
To compile and link the Speech Coder software:
1. Open an MS DOS command prompt window and go to the target directory,
then go to the /c6xsim sub-directory.
2. If you’ve already installed the TI tools, you can build the c6x version of the
Speech Coder by entering this command at the MS DOS command prompt:
NMAKE -f g729bld.mak
Code organization
When installed, the Speech Coder software files reside in this directory structure:
1 This file is tested to work with the Microsoft NMAKE utility, and can be modified to work with other
make utilities.
Application programmer interface
The \testvecs sub-directory contains files that have input and output test
vectors for each module. These files have extensions of .IN2, .IN, .BIT,
or .PST.
Directory Extension File type Description
\g729 .pdf User’s manual Includes this guide, in PDF format.
\g729\c6xsim
Control source and executable for C6x
.c C files (wrapper code) Control source files.
.cmd Linker command files Linker command files control object
modules, linking options, and
memory maps. These files include:
• coder.cmd: Command file for the
G729 Encoder Module.
• decoder.cmd: Command file for
the G729 Decoder Module.
.lib Library files The g729.lib file is a library of all
object modules.
.mak Build file The g729bld.mak file 1 controls the
build process.
\g729\include .h Header files Header files used to build the Speech
Coder. Applications can share these
files as well.
\g729\testvecs Test vector files ITU-T test vectors.
Once you’ve installed and built the Speech Coder software, you can use the Speech
Coder functions in your C application code.
Observe the following while developing your applications:
• All module execution shall be done on 10ms frames.
3

RadiSys Corporation
• Channel Variable, Control, Tables buffer allocation in the data memory are not
part of the mentioned APIs.
• G729 Encoder and Decoder assume that higher level control allocates the data
memory based on the size of each structure and the alignment.
The next section describes the APIs used for the functional implementation of
ITU-T G729 coder. This section specifies the APIs for two different memory
configurations:
• Configuration 1: Runs the complete encoder from external memory as a
single module.
• Configuration 2: The G729 Encoder code is separated into two modules to fit
into internal memory of the TMS320C6201.
You must know the configuration before calling the APIs.
APIs for initialization
The application needs to call this API once at the start of the call. This needs to be
done for every new call.
Configuration 1 and Configuration 2
Init_G729Encoder
Syntax
void Init_G729Encoder(
g729EncVars *variables_buf,
g729CodTabs *tables_buf
);
Parameters
For structure definitions, see include\tab_ld8k.h for the G.729 coder. And for
execution sequence of all APIs, see c6xsim\coder.c for G729 encoder and
c6xsim\decoder.c for decoder in the directory.
variables_buf
Pointer to Channel Encoder State Variable structure with sizeof
(g729EncVars), 32-bit alignment, and persistent (2268 bytes).
tables_buf
Pointer to Global Tables structure with sizeof(g729CodTabs), 32-bit
alignment, and shared (7460 bytes).
4

ITU-T G.729 Speech Coder for TMS320C6201 Overview Guide
Init_G729Decoder
Syntax
Configuration 1
G729Encoder
void Init_G729Decoder(
g729DecVars *variables_buf,
g729CodTabs *tables_buf
);
Parameters
variables_buf
Pointer to Channel Decoder State Variable structure with sizeof
(g729DecVars), 32-bit alignment, and persistent (1376 bytes).
tables_buf
Pointer to Global Tables structure with sizeof(g729CodTabs), 32-bit
alignment, and shared (7460 bytes).
APIs for run-time execution
The application needs to call this API for every 10ms frame after the start of call
and initialization.
Syntax
void G729Encoder(
g729EncVars *variables_buf,
g729CodTabs *tables_buf,
short *pInBuf,
unsigned char *pNwOutBuf,
unsigned char nb_words
);
Parameters
variables_buf
Pointer to Channel Encoder State Variable structure with sizeof
(g729EncVars), 32-bit alignment, and persistent (2268 bytes).
tables_buf
Pointer to Global Tables structure with sizeof(g729CodTabs), 32-bit
alignment, and shared (7460 bytes).
pInBuf
pNwOutBuf
Short Pointer to received PCM data, 32-bit alignment, non-persistent
(160 bytes).
Unsigned Char Pointer to the compressed data to be transmitted, 8-bit
alignment, non-persistent (10 bytes).
5

RadiSys Corporation
nb_words
Number of valid bytes in the compressed packet (pNwOutBuf), 8-bit
alignment, non-persistent (1 byte).
G729_Decoder
Syntax
void G729_Decoder(
g729DecVars *variables_buf,
g729CodTabs *tables_buf,
unsigned char *pNwInBuf,
unsigned char Status,
Word16 *pOutBuf
)
Parameters
variables_buf
Pointer to Channel Decoder State Variable structure with sizeof
(g729DecVars), 32-bit alignment, and persistent (1376 bytes).
tables_buf
Pointer to Global Tables structure with sizeof(g729CodTabs), 32-bit
alignment, and shared (7460 bytes).
pNwInBuf
Status
pOutBuf
Configuration 2
G729Encoder1
Syntax
Unsigned Char Pointer to received data from network, 8-bit alignment,
non-persistent (10 bytes).
Unsigned Char status of the compressed packet received from the
network, 8-bit alignment, non-persistent (1 byte).
Short Pointer to PCM data to be transmitted, 32-bit alignment,
non-persistent (160 bytes).
void G729Encoder1(
short *pInBuf,
g729EncVars *variables_buf,
g729CodTabs *tables_buf
)
Parameters
variables_buf
Pointer to Channel Encoder State Variable structure with sizeof
(g729EncVars), 32-bit alignment, and persistent (2268 bytes).
tables_buf
Pointer to Global Tables structure with sizeof(g729CodTabs), 32-bit
alignment, and shared (7460 bytes).
6

ITU-T G.729 Speech Coder for TMS320C6201 Overview Guide
pInBuf
Short Pointer to received PCM data, 32-bit alignment, non-persistent
(160 bytes).
G729Encoder2
Syntax
G729_Decoder
void G729Encoder2(
g729EncVars *variables_buf,
g729CodTabs *tables_buf,
unsigned char *pNwOutBuf,
unsigned char *nb_words
)
Parameters
variables_buf
Pointer to Channel Encoder State Variable structure with sizeof
(g729EncVars), 32-bit alignment, and persistent (2268 bytes).
tables_buf
Pointer to Global Tables structure with sizeof(g729CodTabs), 32-bit
alignment, and shared (7460 bytes).
pNwOutBuf
nb_words
Syntax
Unsigned Char Pointer to the compressed data to be transmitted, 8-bit
alignment, non-persistent (10 bytes).
Number of valid bytes in the compressed packet (pNwOutBuf), 8-bit
alignment, non-persistent (1 byte).
void G729_Decoder(
g729DecVars *variables_buf,
g729CodTabs *tables_buf,
unsigned char *pNwInBuf,
unsigned char Status,
Word16 *pOutBuf
)
Parameters
variables_buf
Pointer to Channel Decoder State Variable structure with sizeof
(g729DecVars), 32-bit alignment, and persistent (1376 bytes).
tables_buf
Pointer to Global Tables structure with sizeof(g729CodTabs), 32-bit
alignment, and shared (7460 bytes).
pNwInBuf
Unsigned Char Pointer to received data from network, 8-bit alignment,
non-persistent (10 bytes).
7

RadiSys Corporation
Status
pOutBuf
Unsigned Char status of the compressed packet received from the
network, 8-bit alignment, non-persistent (1 byte).
Short Pointer to PCM data to be transmitted, 32-bit alignment,
non-persistent (160 bytes).
Run-time initializations
pInBuf Short Pointer to the TDM Input buffer (16-bit PCM samples) size of 160
bytes, 32 bit alignment.
pOutBuf
pNwInBuf
pNwOutBuf
Short Pointer to the TDM Output buffer (16-bit PCM samples) size of
160 bytes, 32 bit alignment.
Unsigned Char Pointer to received network packet data, 8-bit alignment,
and non-persistent (10 bytes).
Unsigned Char Pointer to network packet data to be transmitted, 8-bit
alignment, and non-persistent (10 bytes).
Status (8-bit)
Application need to provide the status information based on the network
packets/data.
If(PacketSize==10)
Status = ACTIVE_FRAME;
Else
Status = G729BAD_FRAME;
Testing and performance specifications
Test procedure
The G.729 software is tested using the Texas Instruments XDS-510 JTAG emulator
on the TEB (Test Evaluation Board) from Texas Instruments. The TEB used in these
tests had Rev. 1.5 of the TMS320C6201 on it. The emulator software version used
in the test procedure did not allow command line arguments for file names, hence
the file names for the input and output vectors were hard-coded as shown in the
following module description tables.
For this test the code is assumed to be resident in c:\g729\c6xsim and test vectors in
c:\g729\testvecs.
Encoder test procedure
1. Copy c:\g729\testvecs\algthm.in c:\g729\c6xsim\coder.in
2. Run coder.out using Texas Instruments emulator to produce the file decoder.in
8

ITU-T G.729 Speech Coder for TMS320C6201 Overview Guide
Decoder.in is the serial bit output file which should be same as the ITU-T test
vector file c:\g729\testvecs\algthm.bit
Table 1. Encoder module test summary
Module name
Input Vector File Names
Input Vector format
Typical ITU file from G.729
test vectors
Output Vector File Name
Output Vector format
Coder.out
Coder.in
Coder.in: 16 bit binary voice samples, Intel
Algthm.in
decoder.in
ITU-T Serial Bit Frame format. Each frame consists of
80 short words
Decoder test procedure
1. Copy c:\g729\testvecs\algthm.bit to c:\g729\c6xsim\decoder.in
2. Run decoder.out using TI emulator to produce the file decoder.res
3. decoder.res is the serial bit output file which should be same as the ITU-T test
vector file c:\g729\testvecs\algthm.pst
Table 2. Decoder module test summary
Module name
Input Vector File Names
Input Vector format
Typical ITU-T file from
G.729 test vectors
Output Vector File Name
Output Vector format
Coder.out
Decoder.in
ITU-T Serial Bit Vector Frame Format. Each frame
consist of 82 short words (164 bytes).
Algthm.bit
decoder.res
16-bit binary voice samples, Intel.
Performance specification
The performance results were computed for the test vector in the file algthm.in,
with Texas Instruments Code Composer Studio Tools, version 1.2. The cycle count
is for the module API functions excludes bit-packing, file reading and writing cycles,
and with all C files compiled with -o2 optimizer option.
Module
Cycles
(speech)
Table 3. G.729 c6x code performance
MCPS – speech
(assuming 200
MHz DSP)
Program
memory
(Kbytes)
Data memory
(Kbytes) tables,
var.
Stack
(Kbytes)
Encoder 108000 10.8 51.5 7.46 2.26 3.25
Decoder 28000 2.8 26.4 7.46 1.37 1.5
9

RadiSys Corporation
Where to get more information
About the ITU-T G.729 Speech Coder for TMS320C6201
You can find out more about the Speech Coder from these sources:
• Readme file: Lists features and issues that arose too late to include in other
documentation.
• World Wide Web: RadiSys maintains an active site on the World Wide Web. The
site contains current information about the company and locations of sales
offices, new and existing products, contacts for sales, service, and technical
support information. You can also send e-mail to RadiSys using the web site.
About related products
Requests for sales, service, and technical support information receive
prompt response.
SP6040
The RadiSys SP6040 (SPIRIT-6040 CompactPCI † board) is a high-performance
intelligent I/O subsystem designed for telecom and datacom applications. Based on
Texas Instruments † devices, the SP6040 has a 200MHz DSP engine with an I/O
connector that provides interface-to-digital network interfaces (DNI) such as E1/T1
and ATM. The SP6040 contains up to four TMS320C6201 digital signal processors.
SP6020
The RadiSys SP6020 (SPIRIT-6020 board) features two Texas Instruments
TMS320C6201B fixed-point DSPs that run at 200MHz and serve as the main
processing engines. Each ’C6x can deliver up to 1600 MIPS of processing power,
contingent on the available parallelism within the application code. The DSPs are
used for voice and data processing, compression, and decompression.
TASK-6000
When sending e-mail for technical support, please include information
about both the hardware and software, plus a detailed description of the
problem, including how to reproduce it.
To access the RadiSys web site, enter this URL in your web browser:
http://www.radisys.com
TASK-6000 software is a tool set that provides a framework for composing,
executing and dynamically configuring optimized real-time TMS320C62x DSP
applications. The Voice Gateway Platform (VGP), available from RadiSys, is used
as the reference hardware platform.
10

ITU-T G.729 Speech Coder for TMS320C6201 Overview Guide
For detailed information about TASK-6000 products, see the following
publications:
TASK-6000 User’s Manual, (07-0992-xx)
TASK-6000 Installation Guide, (07-1000-xx)
TI tools
Software tools from Texas Instruments used to build DSP executables.
For more information about Texas Instruments products, enter this URL in
your web browser:
http://www.ti.com/dsp
11

RadiSys Corporation
12