T-REC-G.722.2-200201-S!AnnC!SOFT-ZST-S.zip_722.2_G.722.2_Soft!

=============================================================== *** README file for ITU-T G.722.2 Annex C (01/2002) *** Fixed-point C-code for AMR-WB 16 kbit/s codec *** Version 5.3.0 Last Update: 30 November 2001 =============================================================== This software is a integral part of ITU-T Rec. G.722.2 (01/2002) Annex C: "Wideband coding of speech at around 16 kbit/s using Adaptive Multi-rate Wideband (AMR-WB): Fixed-point C-code" IPR STATEMENT & DISCLAIMER ========================== User's attention is drawn to the possibility that the practice or implementation of this Recommendation may involve the use of existing patents. ITU takes no position concerning the evidence, validity or applicability of patents, whether asserted by ITU Member States, Sector Members, Associates or by others outside of the Recommendation development process. For further information implementors are strongly urged to consult the ITU-T patent database in this regard. DISCLAIMER: In no event shall the ITU be liable for any damages whatsoever (including, without limitation, damages for loss of profits, business interruption, loss of information, or any other pecuniary loss) arising out of or related to the use of or inability to use the accompanying Software. The ITU disclaims all warranties, express or implied, including but not limited to, warranties of merchantability and fitness for a particular purpose. ITU CONTACTS ============ For distribution of update software, please contact: Sales Department ITU Place des Nations CH-1211 Geneve 20 SUISSE email: sales@itu.int For reporting problems, please contact TSB helpdesk service at: TSB Helpdesk service ITU Place des Nations CH-1211 Geneve 20 SUISSE fax: +41 22 730 5853 email: tsbedh@itu.int ***************************** ** TECHNICAL DESCRIPTION ** ***************************** NOTE: This is an ITU version of the 3GPP AMR-WB codec 5.3.0. It is exactly the same than the one available in 3GPP server, except two modifications made: 1) The "ITU_interface" -flag has been added to IO-routines in order to be compatible with ITU requirements. * The modification applies to the following files: coder.c, decoder.c, bits.c, bits.h. 2) "NO_BFH" -flag has been added to indicate locations of the bad frame handling functionality in the source code. This version is not intended to be used for decoding of AMR-WB data. * The modification applies to the following files: d_gain2.c, dec_main.c, decoder.c, lagconc.c, qpisf_2s.c, acelp.h, dec_main.h The default condition is that flags "ITU-interface" and "NO_BFH" are NOT defined, which means that the default compilation of the code will produce exacutables that are bit-exact with 3GPP AMR-WB V.5.3.0. All code is written in ANSI-C. The system is implemented as two separate programs: coder - Speech Encoder decoder - Speech Decoder For encoding using the coder program, the input is a binary speech file (*.inp) and the output is a binary encoded parameter file (*.cod). For decoding using the decoder program, the input is a binary parameter file (*.cod) and the output is a binary synthesized speech file (*.out). The C code has been verified on the following a number of systems: - Sun Microsystems workstations and GNU gcc compiler - HP workstations and cc compiler - IBM PC compatible computers with Windows NT4 operating system and: * GNU gcc compiler * MS Visual C++ compiler FILE FORMATS: ============= The file format of the supplied binary data (*.inp, *.cod, *.out) is 16-bit binary data which is read and written in 16 bit words. The data is therefore platform DEPENDENT. The files contain only data, i.e., there is no header. The test files included in this package are "PC" format, meaning that the least signification byte of the 16-bit word comes first in the files. If the software is to be run on some other platform than PC, such as an HP (HP-UX) or a Sun, then binary files will need to be modified by swapping the byte order in the files. The input (*.inp) and output files (*.out) are 16-bit signed binary files with 16 kHz sampling rate with no headers. The Speech Encoder produces bitstream files which are as follows: 1) Default interface (3GPP) =========================== For every 20 ms input speech frame, the encoded bitstream contains the following data: Word16 TXRXFLAG Word16 FrameType Word16 Mode Word16 1st Databit Word16 2nd DataBit . . . Word16 Nth DataBit where the TXRXFLAG tells whether the frame is input from the speech encoder or from the output of the channel decoder. For Speech encoder the Flag is 0x6B21 and for channel decoder the flag is 0x6B20 The frametype tells whether the frame is speech, SID_FIRST, SID_UPDATE etc. The frame types are the same than used in the existing ETSI AMR narrow band codec. For more details on these frametype, refer to the AMR NB documentation. The mode can be from 0 to 8, corresponding bit rated from 6.6 kbit/s to 23.85 kbit/s. Finally, there is N databits where the N is the number of bits per frame for each mode. So for 6.6 kbit/s mode, there are 132 databits. Each bit is presented as follows: Bit 0 - -127, Bit 1 - 127. 2) ITU interface ================ Word16 Sync word Word16 DataLength Word16 1st Databit Word16 2nd DataBit . . . Word16 Nth DataBit ,where - Sync word is 0x6B21 (0x6B20 reserved for frame erasure indication) - DataLength is the length of the speech data frame in bits (NOTE: No codec frame type information supported by this format) INSTALLING THE SOFTWARE ======================= Installing the software on the PC: First unpack the testv.zip and the c-code.zip into your directory. After that you should have the following structure: <your_dir> <testv> *.bat *.inp *.cod *.out <c-code> makefile.gcc *.c *.h *.tab readme.txt The package include makefile for gcc, which have been tested with gcc in Windows NT 4 msdos-box. The code can be compiled in the dos-prompt by entering the directory c-code and typing the command: make -f makefile.gcc (assuming you have gcc installed) It is probably quite straightforward to use the same make file with other systems having gcc or a standard ANSI-C compiler with only small modifications. RUNNING THE SOFTWARE ==================== The usage of the "coder" program is as follows: 1) Default interface (3GPP) =========================== Usage: coder [-dtx] [-modefile <modefilename>] <mode> <speech_file> <bitstream_file> - The DTX is activated by typing the optional switch "-dtx". By default, the DTX is not active. - The mode is from 0 to 8 correspond the following bit-rates: 0 - 6.6 kbit/s, 1 - 8.85 kbit/s, 2 - 12.65 kbit/s, 3 - 14.25 kbit/s, 4 - 15.85 kbit/s 5 - 18.25 kbit/s, 6 - 19.85 kbit/s, 7 - 23.05 kbit/s, 8 - 23.85 kbit/s - Current mode for the codec can be read from the ASCII file by defining switch "modefile" and giving the filename where to find the mode numbers. NOTE: if this option is used, parameter mode should NOT be given in the command line. 2) ITU interface ================ Usage: coder [-q] [-modefile <modefilename>] <mode> <speech_file> <bitstream_file> - The mode is from 0 to 8 correspond the following bit-rates: 0 - 6.6 kbit/s, 1 - 8.85 kbit/s, 2 - 12.65 kbit/s, 3 - 14.25 kbit/s, 4 - 15.85 kbit/s 5 - 18.25 kbit/s, 6 - 19.85 kbit/s, 7 - 23.05 kbit/s, 8 - 23.85 kbit/s - Current mode for the codec can be read from the ASCII file by defining switch "modefile" and giving the filename where to