fgcom(1) - f39

1FGCOM(1)                     FlightGear man pages                     FGCOM(1)
2
3
4

NAME

6       fgcom - VoIP client for the FlightGear radio infrastructure
7

SYNOPSIS

9       fgcom  [--server=server]  [--host=listeninghost] [--port=port] [--call‐
10       sign=callsign]   [--frequency=frequency]   [--atis=frequency]   [--air‐
11       port=code]   [--username=user]   [--password=pass]   [--silence-thresh‐
12       old=threshold] [--debug] [--help] [--version]
13

DESCRIPTION

15       fgcom is the FlightGear utility  used  for  connecting  to  multiplayer
16       voice servers.
17
18       It  is  usually not necessary to run fgcom from the command line, as it
19       is already integrated into FlightGear, with the exception of a few spe‐
20       cific  cases  (such  as  recording  ATIS messages or performing a radio
21       check, see the EXAMPLE section).
22

OPTIONS

24       --server=server
25              Connect to the FGCom server server. By default, FGCom  tries  to
26              connect to fgcom.flightgear.org.
27
28       --host=listeninghost, --port=port
29              Listen  on  the  network interface having the IP address listen‐
30              inghost, on port port. By default, FGCom listens on the loopback
31              interface (127.0.0.1) on port 16661.
32
33              The  specified  port can be used by an instance of FlightGear to
34              communicate with FGCom and update the  pilot  position  as  they
35              fly.
36
37       --callsign=callsign
38              Use  the callsign callsign during the session. By default, FGCom
39              uses guest as callsign.
40
41       --frequency=frequency
42              Set the active radio frequency to frequency. The frequency  must
43              be written in the format xxx.xxx and must be given in MHz.
44
45       --atis=frequency
46              Record  an  ATIS message on frequency MHz. The frequency must be
47              written in the format xxx.xxx and must be given in MHz.
48
49       --airport=code
50              Position the pilot/controller to the  airport  having  the  ICAO
51              code code.
52
53              Since  some  radio frequencies might be reused across the world,
54              it is essential to set the pilot/controller  position  correctly
55              to  make  the  FGCom  server able to determine the correct voice
56              channel. Always use this  flag  if  you  are  not  connecting  a
57              FlightGear instance to FGCom.
58
59       --username=user, --password=pass
60              Log in to the FGCom server using the username user and the pass‐
61              word pass.
62
63       --silence-threshold=threshold
64              Set the silence threshold to threshold dB.  The  value  must  be
65              between -60 and 0. The default is -35.0 dB.
66
67              The  silence  threshold  is the level below which the sound cap‐
68              tured by the microphone is  considered  background  noise  (and,
69              thus,  filtered out by FGCom).  Setting the silence threshold to
70              -60 turns the filter off; setting it  to  0  filters  everything
71              (mutes the microphone).
72
73       --debug
74              Enable debug output for troubleshooting purposes.
75
76       --help Display usage information and exit.
77
78       --version
79              Display the FGCom version and exit.
80

EXIT STATUS

82       fgcom exits with EXIT_SUCCESS on success, with EXIT_FAILURE if the syn‐
83       tax of the command-line arguments is wrong or an error occurs.
84

NOTES

86       FGCom understands several special frequencies used for testing purposes
87       or general chatting:
88
89       ·  121.000 MHz, 121.500 MHz: "guard" frequencies reserved for emergency
90          communications;
91
92       ·  123.450 MHz, 123.500 MHz, 122.750 MHz: general chat frequencies;
93
94       ·  700.000 MHz: radio station frequency. Depending on the FGCom  server
95          in use, a recorded radio message will be played;
96
97       ·  723.340 MHz: French Air Patrol communication frequency;
98
99       ·  910.000  MHz:  echo  test  frequency. Your voice will be echoed back
100          after a short delay, to allow you to  check  that  your  microphone,
101          speakers/headset and that your connection to the FGCom server works.
102          The test is limited to a maximum of 65 seconds, after which you will
103          be automatically disconnected;
104
105       ·  911.000 MHz: "music on hold". The frequency continuously plays back‐
106          ground music, allowing you to check  that  your  connection  to  the
107          FGCom server works.
108

BUGS

110       ·  At the time of writing, there is no mechanism in place to update the
111          frequencies used by FGCom with the ones  used  in  the  real  world,
112          should  those  change. The former, thus, might not always correspond
113          to the latter. Always use the frequencies listed in FlightGear under
114          AI  ->  ATC Services in Range instead of the ones published on aero‐
115          nautical charts.
116

EXAMPLE

118       Connect to the default FGCom server, switch to the San Francisco Inter‐
119       national  Airport  (KSFO)  ground  frequency  (121.800  MHz)  and allow
120       FlightGear to update the current pilot position by sending it  to  port
121       16661 (the default one):
122
123           $ fgcom --frequency=121.800 --airport=KSFO
124
125       Perform a radio check by connecting to the echo test frequency:
126
127           $ fgcom --frequency=910.000
128
129       Record  an  ATIS  message  on  the  San Francisco International Airport
130       (KSFO) ATIS frequency (118.850 MHz):
131
132           $ fgcom --atis=118.850 --airport=KSFO
133