/************************************************************************

European digital cellular telecommunications system
             5600 bps speech codec for
         half rate speech traffic channels

Codec Homing Test sequences
Version 4.2.0
November 1997

*************************************************************************/


                       INSTALLING THE TEST VECTORS
                       ===========================


Installing the software on the Sun:
-----------------------------------

1. Getting the codec homing test files from pc disk:
        There are two ways of extracting the files off of the disk:

           a. Using FTP
           b. Mounting the disks and copying the files directly.

        If using FTP:
        Copy directory home_tv using the binary mode (by typing bin).  
        
        If copying the files directly:
        No special instructions.  Be aware though that the text files 
        on the Sun will still be in "pc" format.

Installing the software on the VAX (under VMS):
-----------------------------------------------

1. Getting files from pc disk:
        I assume you are using FTP.  We have no other way of transferring
        the files, so no other methods were tested.

        Copy directory home_tv using the binary mode (by typing bin).  

Installing the homing test vectors on the PC:
---------------------------------------------

1. Getting files from pc disk:
        From the directory where you want the files installed 
        (and assuming the diskette is in drive b), type:

        xcopy b:\home_tv


                 RUNNING THE HOMING TEST VECTORS
                 ===============================           

The usage of the "gsm_hr" program is as follows:

   Usage:

   gsm_hr option inputFileName outputFileName <number of frames> <dtx|nodtx>
   or
   gsm_hr option inputFileName outputFileName <dtx|nodtx> <number of frames>

   Options: enc    inputFileName: speech --> outputFileName: encoder output
            dec    inputFileName: decoder input --> outputFileName: speech

Note that running the "gsm_hr" program without any command line arguments
will cause it to print out the above Usage message.


The usage of the "reid" program is as follows:

   Usage: REID input output EPx 
   EPx: EP0
        EP1 (not implemented)
        EP2 (not implemented)
        EP3 (not implemented)

Note that running the "reid" program without any command line arguments
will cause it to print out the above Usage message.


Processing the codec homing test vectors on the Sun:
----------------------------------------------------

First, use the "swapbin" utility prgram to swap the bytes in the
example files from pc to Sun byte order.  To do this, switch to the
./exec directory and type:

        swapbin ../home_tv/homing01.dec ../home_tv/home_sun.dec
        swapbin ../home_tv/homing01.out ../home_tv/home_sun.out

Then, from the exec directory type:

        gsm_hr dec ../home_tv/home_sun.dec ../home_tv/home_tst.out nodtx

To verify, switch to the home_tv directory and type:

        cmp home_tst.out home_sun.out


        This compare command should yield no differences.


Processing the example files on the VAX:
----------------------------------------

Running a program with command line arguments under VMS (VAX) 
requires creating an alias.  From the exec directory,
define symbols to represent the gsm_hr and reid executables.
The exact path must be specified.  For example:

$ cmdgsm_hr :== USER$DISK1:[jasiuk.mark.exec]:gsm_hr.exe
$ cmdreid :== USER$DISK1:[jasiuk.mark.exec]:reid.exe

   $ cmdgsm_hr dec [-.home_tv]homing01.dec [-.home_tv]home_tst.out nodtx

Verification (in the home_tv directory):

        $ diff home_tst.out homing01.out


This diff command should indicate no differences
between the VAX and reference file.


Processing the test vectors on the PC:
---------------------------------------
                                  
From the exec directory:

        gsm_hr dec ..\home_tv\homing01.dec ..\home_tv\home_tst.out nodtx

Verification (in the home_tv directory):

        comp homing01.out home_tst.out

        this compare command should yield no differences.


More file format information:
-----------------------------

The file format of the supplied binary data (*.inp, *.cod, *.dec, and
*.out) and the resulting speech encoded parameter data is 16-bit binary
data which is read and written in 16 bit words.  The data is therefore
platform DEPENDENT.  This is advantageous since no data conditioning
is required to run files already present on the target platform.

The files contain only data, i.e., there is no header.