Menu

Tree [a9af9a] master /
 History

HTTPS access


File Date Author Commit
 CMakeModules 2013-01-30 Geoff McLane Geoff McLane [6ebb72] Minor changes to compile in WIN32, and update v...
 data 2013-09-05 Geoff McLane Geoff McLane [a9af9a] Update to a new version of gen_phonebook.pl. An...
 iaxclient 2013-09-05 Geoff McLane Geoff McLane [9b6181] Remove need for a 'special' config.h for MSVC. ...
 server 2013-09-05 Geoff McLane Geoff McLane [a9af9a] Update to a new version of gen_phonebook.pl. An...
 src 2013-09-05 Geoff McLane Geoff McLane [9b6181] Remove need for a 'special' config.h for MSVC. ...
 .gitignore 2012-06-11 Yves Sablonier Yves Sablonier [82d659] Adding recent trunk from sourceforge.net/fgcom
 CMakeLists.txt 2013-08-11 Geoff R. McLane Geoff R. McLane [0d7acb] Add variable add_LIBS to fgcom final link
 LICENSE.txt 2012-07-13 Martin Spott Martin Spott [8859bd] Change license to GPLv2,
 README 2013-09-05 Geoff McLane Geoff McLane [9af1b3] Remove the 'special' config.h.msvc from README ...
 README.msvc.txt 2013-09-05 Geoff McLane Geoff McLane [9af1b3] Remove the 'special' config.h.msvc from README ...
 README.osx.txt 2012-07-19 James Turner James Turner [64b12f] ALUT isn't actually used, remove it from CMakeL...
 version 2013-08-25 Geoff R. McLane Geoff R. McLane [3febe7] bump version to 2.12

Read Me

FGCOM
=====

This project can be build using CMake 2.8 or later
See : http://www.cmake.org/ for download and install details.

Dependencies:
 OpenAL - sound libraries
 PLIB - for network code plib net.lib and ul.lib

Building FGCOM in any system

1. Create an out of source 'build' directory

# mkdir build-fgcom
# cd build-fgcom

# cmake /path/to/fgcom [-G <desired generator] \
 [-DCMAKE_INSTALL_PREFIX:/where/to/install] \
 [-DCMAKE_PREFIX_PATH:/sg/path/include[;/plib][;OpenAL]]
 [-DCMAKE_LIBRARY_PATH:/sg/path/lib[;/plib/libs][;OpenAL/libs]]

Now depending on the generator chosen -

1: Unix/Linux Makefile, the standard unix mantra
# make
# [sudo] make install

2: MSVC solutions files
(a) load the build files in the generators IDE, F7, to 
compile and link. INSTALL must be done separatley.
or
(b) In command prompt
> cmake --build . --config Release
And if installation desired -
> cmake --build . --config Release --target INSTAll
OR
> cmake -DBUILD_TYPE=Release -P cmake_install.cmake

3: cmake supports a considerable number of different generators. Run
cmake --help to see the list supported on your platform.

Echo Test:
=========

To see the command line options run fgcom --help

Run fgcom binary with command -f910... 
$ ./fgcom -f910

You should see...
Reading airports [/some/path/positions.txt]... loaded NNNNN entries.
Call 0 accepted
Echo-Box
Call 0 answered

Speak 'one' into your microphone and you should hear an 
echoed 'one' from your speakers.

If the airports load fails, you may have to add -T/path/to/positions.txt

Ctrl+C to exit the application.

This is using the internal default voip server of fgcom.flightgear.org.
If you want to connect to another server use -Sdelta384.server4you.de
on the command line.

Running with FGFS:
=================

This is only required with fgfs version 2.12 or less. fgfs 2.99 onwards has fgcom 
integrated. Use the Multiplayer -> FGCom setting dialog to configure 
fgcom. Normally the space-bar is the PTT button.

But with earlier fgfs versions...

1: Run fgfs with the added command - 
 --generic=socket,out,10,localhost,16661,udp,fgcom

This causes fgfs to output the information per the file <fgdata>/Protcol/fgcom.xml 
as udp data on port 16661. This includes your selected com and nav frequencies, 
your position, speed, callsign, altitude, etc - see the xml for details.

YOu can check the udp data stream with utilities like 'netcat'.

2: Run fgcom. There are command line options to change the port, the 
voip server etc. As stated above use --help to see all the options, 
but the default port is 16661 on localhost.

When you select a com frequency in fgfs, fgcom will see that selection, and establish 
a call to the chosen voip server, and you should hear other nearby pilots who 
are on speaking on that same frequency.

When you want to speak your intentions, like starting engine, taxing, 
taking off, arriving, landing, etc, press the PTT key (usually space bar), 
and talk clearly into your microphone, and you transmission will be relayed 
to other nearby pilots or any active ATC if that is the chosen frequency.

3: There is also a fgcomgui, that offers a graphical front end to using 
fgcom - see https://code.google.com/p/fgcomgui/

4: If you want to set up an ATC service at an airport of your choice, 
then the OpenRadar java app can also use fgcom for voice communications.
See http://wiki.flightgear.org/OpenRadar

That's it folks ;=)) ENJOY!
Geoff.
20130905 - 20130825 - 20120615

; eof