back to the ToC

KPhoneIS User Manual: How to configure the Phone

Table of Contents

File -> Identity (Who are we)

Ask your provider/sysadmin for the parameters you have to enter here !


At last the changes are solicited with "OK". Please restart KPhoneSI, to activate your changes



Preferences -> SIP Preferences



Preferences -> SIP Preferences -> Socket

In many cases the defaults will work, you possible have to ask your provider for the correct choice.

Users behind a NAT and/or firewalls , should may possibly set the option "Use STUN Server" and enter a STUN. For details, please ask your provider!



Preferences -> SIP Preferences ->Call Forwarding

Implemented are :

Important: The CFnA-settings and the Auto-Answer-Flag will not be stored! They must be supplied after every restart of the phone, if it is planned to use them.



Preferences -> Audio Preferences

About the Soundcard

Configuring your sound system may proof quite tricky. I hope the following hints may help you:

Plugging  your headphone
If there are different possibilities, please test them all! Depending on the sound card the mic and the line-in plug  could be the right places for your headphone's mic plug. You may have two sets of plugs, one in the front, one in the rear. I know PCs, where I had to use the front mic and the rear lineout!

Select a sound-mixer-tool compatible to your sound card (use alsamixergui, if you have it and you feel it works! It has the easiest to use user interface) and
- Play with the mic and line-in related controls. Use "mic boost" only  if your mic is not loud enough without
- Check if you set your  input device to "recording"/"capturing"
- Play with the line-out related controls
- If your sound-mixer-tool has a capture tab, it could be the place to make the microphone run.

Tuning the audio card may be necessary, too . Your distribution's defaults may proof imperfect
         
Testing audio. Before blaming kphone test this:
  1. First do a play <some-name>.wav , kphone's ring.wav is a choice;
  2. Secondly rec foo.wav; speak into you mic; play foo.wav. You should here your recorded voice. (If youhave no rec, youse cat > instead)
If one of the tests fails, continue tuning and --- please do not blame kphone!

The Preferences

audio preferences


Codec

Bandwidth

Quality

G.711u

80Kbit

ISDN

GSM

13Kbit

European mobile phones

iLBC

15Kbit

n.a.

Speex

n.a.

n.a.


Ringing


Ringtone:
you may chose between no tone, for different tones or an audio file of type wav
Ringtone Device: Enter the audio device, you plan to use for ringing, if you have only one soundcard, always enter your auddio device
Application for ringing: We have two applications coming with kphoneSI:
  • kphonering: A little OSS (Open Sound System) based application. It plays some types of wav-files. If the file does not exist, a beep is played
  • kphoneringsh: A little, very simple shell script. It calls aplay (utilty from the alsa package) to play your tune.
To use kphoneringsh, change the "application for ringing"  field to kphoneringsh.

If you dislike both, enter your preferred audio player, be aware kphoneSI calls it only once. If you plan to adapt kphoneringsh yourself, never use a audio player with graphical user interface!
Ringtone Parameters:
%F is the file name, %D the device name.
For kphonering set  %F
kphoneringsh needs both %D  %F
Ringtone Sound File
the file you plan to play


Hacker's Corner

kphoneringsh is a shell script and so easy to adapt.

#!/bin/sh
while true
do
aplay -D $1 $2
sleep 1
done
The critical line is line 4. The parameter $1 is the %D  $2 the %F variable, if you keep the default configuration for kphoneringsh. If you want to use a different sound tool, you should change this line. For example with mplayer  as tool of your choice kphoneringsh looks that way:
#!/bin/sh
while true
do
mplayer -ao alsa:device=hw#$1 $2  .
sleep 1
done

If you use the loop swich, this is possible
#!/bin/sh
mplayer -loop 0  -ao alsa:device=hw#$1 $2  .

The audio manual:
Ringtone:
 chose the 2nd button (ext. Device)
Ringtone Device: 0:0
Application for ringing: mplayer
Ringtone Parameters:
%D %F
Ringtone Sound File
enter the file you plan to play

The Ringtone Device may take other values, if you installed more than one sound card.

Preferences -> video Preferences


Preferences->(CallType1, ... ,CallType4) – The External Sessions

Provisioning for the generalized sessions:

The button list:

The VectorID identifies the application. Only if both call sides use the same value, a call is possible.


These variables are set by the phone and can be used as Command Line parameters:


%A

IP Address the Peers


%P

Media-port-number of the peer


%O

Own media-port-number


%I

Direction Flag

o for a Outgoing Call, i for a Incoming Call

%T

SDP Transport


%D

The Call-ID


%L

Own IP-address


%R

referTo address


%M

own URI


%C

callee's URI


Preferences->Phonebook

See PhoneBook

Preferences->SRTP

See SRTP


back to the ToC