
KPhone/Pi is a 'Voice Over Internet' phone
which uses the Session Initiation Protocol (SIP).
SIP services are something like index or catalogue services
which are mapping a UserID to a real telephone number 
or to the IP address of the client.
Such services are available as Open Source.

There are provider, which offer such SIP services
and offer telephone calls to the phone net
via an "IP to telephone gateway".
To use these services, you need a hardware IP telephone
or a softphone like KPhone/Pi.


You need openssl to run KPhone/Pi.

KPhone/Pi can be compiled for
Linux Desktop (Qt3 based)
Sharp Zaurus Qtopia (Qt2 based)

KPhone/Pi is based on 
KPhone 4.0.3  from 
  Billy Biggs <bbiggs@div8.net>
  Wirlab <kphone@wirlab.net>


**************************************
HowTo build for the desktop:
**************************************
1. Set the environment variable QTDIR to where Qt3 is installed.
   In bash,   export QTDIR=/usr/lib/qt3
2. Create Makefile
    - qmake
3. Compile
   - make 
4. Now you have the binary in ./bin 
   Adjust the paths (exec and icon path ) in 
    kppi-desk.desktop
   to start that binary.
   Copy  kppi-desk.desktop to your desktop.
5. The icon directory kdepim/kphone must be in the same dir as the kppi binary.


**************************************
HowTo build for Embedded:
**************************************

*******************
HowTo Compile:
*******************

1) Set your environment variables.
   Examples can be found in the files setQtopia and setZaurus.

2) run tmake -o Makefile kphone.pro

3) run make
   You will need Openssl headers to compile.


*******************
HowTo Install:
*******************

Binary is $(QPEDIR)/bin/kppi

Copy kphone.desktop to $(QPEDIR)/apps/Pim

Copy dir bin/kphone to $(QPEDIR)/pics

Ready.

You will need Openssl lib to run.


*******************
HowTo make ipk for Zaurus:
*******************

rum mkipks  kphone-pi.control