Skip to content
Snippets Groups Projects
README 4.55 KiB
Newer Older
yanmorin's avatar
 
yanmorin committed
This is SFLPhoned-0.5 release.
savoirfairelinux's avatar
savoirfairelinux committed

yanmorin's avatar
 
yanmorin committed
You need ccrtp-1.3.5 which needs commoncpp2>=1.3.20
libeXosip2-1.9.1-pre17 needs libosip2-2.2.0
jpbl's avatar
jpbl committed
You also need PortAudio_v19
llea's avatar
llea committed
See http://www.sflphone.org/#downloads to download required libraries.
savoirfairelinux's avatar
savoirfairelinux committed

llea's avatar
llea committed
Dependencies build instructions:
--------------------------------
savoirfairelinux's avatar
savoirfairelinux committed

yanmorin's avatar
 
yanmorin committed
1/	For commoncpp2-1.3.20
llea's avatar
llea committed
	./configure [option]
	make
	make install
savoirfairelinux's avatar
savoirfairelinux committed

yanmorin's avatar
 
yanmorin committed
2/	For ccrtp-1.3.5
llea's avatar
llea committed
	./configure [option]
	make
	make install

yanmorin's avatar
 
yanmorin committed
3/	For libosip2-2.2.1
llea's avatar
llea committed
	./configure [option]
	make
	make install

yanmorin's avatar
 
yanmorin committed
4/ 	For libeXosip2-1.9.1-pre17
llea's avatar
llea committed
	./configure --disable-josua [option]
	make
	make install

jpbl's avatar
jpbl committed
5/  For PortAudio_v19
	./configure [option]
	make
	make install
yanmorin's avatar
 
yanmorin committed

llea's avatar
llea committed

yanmorin's avatar
 
yanmorin committed
How to compile SFLphoned ?
llea's avatar
llea committed
-------------------------

jpbl's avatar
jpbl committed
./configure [option]
savoirfairelinux's avatar
savoirfairelinux committed
make
jpbl's avatar
jpbl committed
make install (as root) 
savoirfairelinux's avatar
savoirfairelinux committed
  ( Be sure you have the correct permissions).


How to use it ?
---------------
llea's avatar
llea committed

yanmorin's avatar
 
yanmorin committed
If you have the sflphone 0.3 or 0.4 release, copy the file sflphonerc to sflphonedrc
cp ~/.sflphone/sflphonerc ~/.sflphone/sflphonedrc
If you have an oldre version, remove your sflphonerc file located in $HOME/.sflphone
llea's avatar
llea committed

yanmorin's avatar
 
yanmorin committed
1. Lauch sflphone-qt interface, a setup window appears. 
savoirfairelinux's avatar
savoirfairelinux committed

2. If you do have a SIP account, fill the SIP stuff where related. You can use
   STUN too.

3. Save your settings, restart it. You're done.

llea's avatar
llea committed
A user's guide will be available on:
http://www.sflphone.org/doc/SFLphoneDocEnglish.pdf
http://www.sflphone.org/doc/SFLphoneDocFrancais.pdf
savoirfairelinux's avatar
savoirfairelinux committed


Why does it not compile ?
-------------------------
llea's avatar
llea committed

savoirfairelinux's avatar
savoirfairelinux committed
	- You don't have the same library versions as we do.
	  See http://www.sflphone.org in section Downloads.

	- You don't have the same compiler (some libraries dislike
yanmorin's avatar
 
yanmorin committed
	  some compilers). We are using  gcc 4.0.1 on
	  Fedora Core 4 Linux. 
savoirfairelinux's avatar
savoirfairelinux committed

llea's avatar
llea committed
	- If error occured while loading shared libraries,
jpbl's avatar
jpbl committed
	  you have to export LD_LIBRARY_PATH with your lib directory.
llea's avatar
llea committed
	  ( example: export LD_LIBRARY_PATH=/opt/lib:${LD_LIBRARY_PATH} )

jpbl's avatar
jpbl committed
	- If you don't install dependencies in classic install directories,
	  you have to export CXXFLAGS. 
	  ( example: export CXXFLAGS="-I/opt/include" )

llea's avatar
llea committed

Short description of content of source tree:
-------------------------------------------
llea's avatar
llea committed

llea's avatar
llea committed
- rings/ contains the different ringtones.
- stund/ is an implementation of the protocol STUN used when there is a NAT.
- utilspp/ allows to implement a singleton.

yanmorin's avatar
 
yanmorin committed
- src/ is the core of SFLphone. It contains the main.cpp, managerimpl.cpp files, 
  audio and gui directories, and files about signalisation SIP. 
llea's avatar
llea committed
  Later, it should be better, when IAX will be implemented, that a directory 
  groups these protocols. 
  The ManagerImpl class is the intermediaire between all the layer in the tree.

yanmorin's avatar
 
yanmorin committed
- src/audio/ is the audio layer. It contains all about tones, dtmf, audiodriver,  
  rtp layer, audio codec ulaw, alaw and gsm.
llea's avatar
llea committed
- src/audio/gsm/ contains the implementation of gsm audiocodec library.
- src/audio/pacpp/ implements PortAudioCpp, a native C++ binding of 
  PortAudio V19.

yanmorin's avatar
 
yanmorin committed
- src/gui/ is the old directory that contains all about different user interface.
- src/gui/server is the directory that talk (tcp socket on port 3999) 
  to sflphone client. The slfphone client can be a console program or a graphical interface
llea's avatar
llea committed


llea's avatar
llea committed
How is structured SFLphone (>=0.4)
----------------------------------

yanmorin's avatar
 
yanmorin committed
		+------------+
		|TCPSessionIO|  
		+------------+
		       |
		+------------+
		| SessionIO  |  
		+------------+
		       |
		+------------+
		| GUI Server |  
		+------------+
  		       |		
llea's avatar
llea committed
		+---------------------------+	
yanmorin's avatar
 
yanmorin committed
		|      GUI Framework        |
llea's avatar
llea committed
		+---------------------------+
yanmorin's avatar
 
yanmorin committed
		             |
llea's avatar
llea committed
		+---------------------------+
yanmorin's avatar
 
yanmorin committed
		|        ManagerImpl        |  
llea's avatar
llea committed
		+---------------------------+
yanmorin's avatar
 
yanmorin committed
		             |
llea's avatar
llea committed
		+---------------------------+
yanmorin's avatar
 
yanmorin committed
		|         VoIPLink          |
llea's avatar
llea committed
		+---------------------------+
yanmorin's avatar
 
yanmorin committed
		      |                |
		+-----------+       +-------+
		|    SIP    |       |  IAX  |
		|    RTP    |       +-------+
		|   STUN    |
llea's avatar
llea committed
		+-----------+

It's in ManagerImpl where we declared Call vector and VoIPLink vector.
VoIPLink vector contains all different VoIP link like SIP, IAX, ...
Call vector contains all the calls according to the kind of VoIP link.


Misc.
-----

savoirfairelinux's avatar
savoirfairelinux committed
Of course we love patches. And contribution. See http://www.sflphone.org/ .    
llea's avatar
llea committed
The project infrastructure (CVS, bugtraqer, MLs) is maintained on : 
http://forge.novell.com/modules/xfmod/project/?sflphone

Don't hesitate to post your comments/suggestions/questions on the 
forge.novell mailing-list.

savoirfairelinux's avatar
savoirfairelinux committed

Jean-Philippe Barette-LaPierre 
(jean-philippe.barrette-lapierre@savoirfairelinux.com)
savoirfairelinux's avatar
savoirfairelinux committed
Laurielle Lea (laurielle.lea@savoirfairelinux.com)
jpbl's avatar
jpbl committed
Jerome Oufella (jerome.oufella@savoirfairelinux.com)
yanmorin's avatar
 
yanmorin committed
Yan Morin (yan.morin@savoirfairelinux.com)