KPhone - IPv6

Last update from Mar.12.2004

0. Purpose:
KPhone is a voice-over-IP softphone which uses SIP for signalling. The original version is maintained at wirlab. This version of KPhone was extended to support IPv6 for audio calls and user registration. This work is the result of a project at the FOKUS institute of the Fraunhofer society.
KPhone is an application for the K Desktop environment (KDE) based on the free operating system "Linux".
1. Download:
Either the bzipped2 version of the archive:

kphone-3.11-ipv6.tar.bz2

Or the gzipped version of the archive:

kphone-3.11-ipv6.tar.gz

2. Unpack:
For the .tar.bz2 version of the archive:

bunzip2 -c kphone-3.11-ipv6.tar.bz2 | tar xvf -

Or if you have GNU tar installed, you may alternatively use:

tar xvjf kphone-3.11-ipv6.tar.bz2

For the .tar.gz version of the archive:

gunzip -c kphone-3.11-ipv6.tar.gz | tar xvf -

Or if you have GNU tar installed, you may alternatively use:

tar xvzf kphone-3.11-ipv6.tar.gz

3. Preparations
before you can start compilation of kphone, you must make sure that you have KDE 3.1.x and QT 3.1 installed properly. If you want to compile these from source or to check your installation, follow the instructions on this KDE developers page (http://developer.kde.org/build/compile_kde3_1.html) or if this page is not available try to find the instructions on the KDE main site http://www.kde.org/
4. Compilation
KPhone is compiled in the same fashion as all other KDE applications.

cd kphone-3.11-ipv6
rm -f config.cache config.status config.h
./configure
make
make install

The "make install" is only needed, if KPhone shall be used system wide.

5. Startup:
If installed system wide, the command "kphone" starts the program, if not, start it locally:

cd kphone-3.11-ipv6
kphone/kphone
 

6. Troubleshooting:
If you experience problems while compiling/starting/using the modified KPhone version, have a look at the known problems and clues on this page: FAQ
You may even want to try this little program to check your audio device for full duplex capability: fullduplex . If the A-R value is almost constant (a little rise over time is acceptable) and you hear the 440Hz testing sound and see the energy bar rise and fall while you speak, you have good chances that KPhone will work with your audio card.


Changelog

Mar.12.2004
Removed some IPv4<->IPv6 based bugs. This is the version to be presented in Lisbon March,16-19.
Jan.15.2004
Added a patch from Piers O'Hanlon (UCL) which solves some trouble with KPhone's audio device handling. This should make KPhone work if you are using the ALSA pcm-oss emulation module. E.g. this patch made KPhone work on our IBM Thinkpad where it did not work before. If you experienced the "I can hear you but you cannot hear me," problem, this could solve it. You still need a full duplex audio device.
Many thanks to Piers.
Nov.21.2003
Different startup procedure. Click CANCEL to avoid IPv4 or IPv6 contacts.
Added symmetric signaling.
Removed some minor bugs.
Fixed handling of generic parameters in URIs.
Oct.20.2003
Removed a bug that prevented KPhone from doing re-registration after the original registration expired. We experienced registration timeouts without renewal before this patch.
Oct.14.2003
Some minor fixes in behavior. Changed the decision process for IPv4/IPv6 again to match scenarios where IPv6 is installed, but unconfigured but with a working IPv6 nameservice over IPv4. The previous decision process caused KPhone to produce empty contacts and via header fields.
Oct.01.2003
Removed a bug that caused KPhone to crash if no KPhone runtime configuration file already exists. The bug could be triggered by removing the KPhone runtime configuration file .kde/share/config/kphonerc in the users home directory. The bug was also triggered, if KPhone is installed/used for the first time.
I also changed the compilation procedure a little bit to ensure that "configure" works well, s.a. "Compilation".
Sep.30.2003
No changes in the code. Just repacked and added a .tar.gz version as well. Added more detailed unpacking instructions.
Sep.26.2003
Hopefully removed a bug in the IP address detection mechanism, which caused KPhone to crash with a stack dump.
Sep.18.2003
Added mobility support. This means that KPhone checks periodically if its IP address has changed and re-registers if this happens. Check Preferences->SIP preferences->Mobility in KPhone to enable this feature.
Flaw: Re-registration is also done if e.g. the IPv4 address changes and KPhone has registered with its (unchanged) IPv6 address. This should cause no disturbances.
Sep.08.2003
Changed the decision process for the outgoing SDP address family after experiencing problems with an IPv4/IPv6 media gateway.
Sep.03.2003
Initial version of the modified package.