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

                              Copyright (c) 2009
                            Lantiq Deutschland GmbH
                     Am Campeon 3; 85579 Neubiberg, Germany

  For licensing information, see the file 'LICENSE' in the root folder of
  this software module.

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

HOW TO COMPILE
--------------

TAPI drivers are build using the commonly used configure, make, make install
process. The first step is to create a Makefile for your specific system
using the provided configure script and adapt the parameters according
to your paths and required features.

For Linux 2.6 several differences apply as the complete build processs is
controlled by the kbuild system. The kbuild system knows already the
architecture specific CFLAGS. The following configure options must be
provided for Linux 2.6.
--enable-linux-26, --enable-kernelincl=<path>, --enable-kernelbuild=<path>
If the kernel has been build inside the source directory (which is not nice),
the kernelbuild path is optional.


--1-- Configure TAPIv3
First create a separate build directory, e.g. below the sources. For Linux 2.6
this step is mandantory(!).

mkdir build_dir
cd build_dir

Example for MIPS, e.g. Danube, TwinPass, INCA-IP2 and Linux 2.4
../configure --build=i686-pc-linux --host=mips-linux --enable-warnings --enable-kernelincl=<...>/linux/include --prefix=/home/comacsd.exports/${USER}/danube/opt/ifx --with-cflags="-fno-strict-aliasing -fno-common -fomit-frame-pointer -G 0 -mno-abicalls -fno-pic -pipe -mtune=r4600 -mips2 -Wa,--trap -mlong-calls -DMODVERSIONS -DEXPORT_SYMTAB"  --enable-tapiincl=../../drv_tapi/include --enable-mpsincl=../../drv_mps_vmmc/include

Example for MIPS, e.g. Danube, TwinPass, INCA-IP2 and Linux 2.6
../configure --build=i686-pc-linux --host=mips-linux --enable-warnings --enable-trace --enable-log --enable-linux-26 --enable-kernelincl=<yourPath>/linux_danube26/include --enable-kernelbuild=<yourPath>/linux --prefix=/home/comacsd.exports/${USER}/danube_26/opt/ifx --enable-dect --enable-kpi --enable-tapiincl=../../drv_tapi/include --enable-mpsincl=../../drv_mps_vmmc/include

Note: One important parameter to adapt to a specific controller platform is
      --with-clags="" - this parameter gives you the option to add platform
     specific compiler flags easily. For Linux 2.6 it's not required to pass
     specific compiler options as the kernel build process will take care
     of this.

--1.1--

Additional compiler flags:
see ../configure --help

--2-- Build TAPI v3

make clean install

--3-- Strip your binary

Stripping of the device driver binary is implicitly done on make install. If you
want to strip the binary manually, please make sure not to use different options
than "--strip-debug" - otherwise the binary might be unusable.

enjoy
TAPIv3 team
