FGCom (before 3.0)
FGCOM is an addon for Flightgear. With FGCOM (and the infrastructure behind) Flightgear gets a realtime voice communication system.
The original (and for now, authoratative) documentation is at [1]
VERY IMPORTANT!!!
22. November 2007:
Due to heavy development at this time there may be some differences between the information on the web pages and the installation. Please follow the discussions on the FlightGear development list!
The Quick 3 Steps to get FGCOM running on a 32 -bit Linux system
support for 64-bit machines will follow
Before you start, make sure that your speakers and mic are working and tested to sensible volumes.
1.) fetch fgcom (a copy of a working iaxclient is inside)
svn checkout svn://svn.dfn.de:/fgcom
Optional: edit iaxclient/lib/Makefile
To use oss emulation (recommended and the default for now)
USE_PA_OSS=1 USE_PA_ALSA=0 USE_PA_JACK=0 AUDIO_ALSA=0
To use native alsa (WARNING: PTT won't work)
USE_PA_OSS=0 USE_PA_ALSA=0 USE_PA_JACK=0 AUDIO_ALSA=1
To use portaudio alsa (WARNING: only if your card natively supports 8000Hz sample rate)
USE_PA_OSS=0 USE_PA_ALSA=1 USE_PA_JACK=0 AUDIO_ALSA=0
2.) Compile iaxclient and fgcom. To do so, do the following:
cd fgcom/src && make
3.) Install
make install
and you should be ready for a quick test...
Testing
quick test
$ fgcom -f910
will give the following output--
fgcom - a communication radio based on VoIP with IAX/Asterisk
(c)2007 by H. Wirtz <wirtz@dfn.de>
Version 1.1.0 build 42
Using iaxclient library Version SVN 42
Reading list of airports...done.
Initializing IAX client as guest:xxxxxxxxxxx@fgcom1.parasitstudio.de
Call 0 accepted
Echo-Box
Call 0 answered
- speak into the mic and your words will be echoed back with a short delay.
type ctrl-C to exit this test
Configuration
Or if it didn't work perfectly first time
fgcom --help
returns the following useful info
fgcom - a communication radio based on VoIP with IAX/Asterisk
(c)2007 by H. Wirtz <wirtz@dfn.de>
Version 1.1.0 build 42
Using iaxclient library Version SVN 42
fgcom: unrecognized option `--help'
Usage: fgcom [-u user] -w [password] [[-s voipserver] [-p port]] | [[-a airport] [-f frequency]] [-d]
--user | -U username for VoIP account (default: 'guest')
--password | -P password for VoIP account (default: 'guest')
--voipserver | -s voip server to ceonnect to (default 'localhost')
--port | -p where we should listen to FG(default '16661')
--airport | -a airport-id (ICAO) for ATC-mode
--frequency | -f frequency for ATC-mode
--mic | -i mic input level (0.0 - 1.0)
--speaker | -o speaker output level (0.0 - 1.0)
--debug | -d show debugging information
--mic-boost | -b enable mic boost
--list-audio | -l list audio devices
--set-audio-in | -r use <devicename> as audio input
--set-audio-out | -k use <devicename> as audio output
Mode 1: client for COM1 of flightgear:
$ fgcom
- connects fgcom to fgfs at localhost:16661
$ fgcom -sother.host.tld -p23456
- connects fgcom to fgfs at other.host.tld:23456
Mode 2: client for an ATC at <airport> on <frequency>:
$ fgcom -aKSFO -d120.500
- sets up fgcom for an ATC radio at KSFO 120.500 MHz
Note that fgcom starts with a guest account unless you use -U and -P!
To make full use of FGCOM you will need an account
please email wirtz@dfn.de and login details will be sent to you shortly.