1FGCOM(1) FlightGear man pages FGCOM(1)
2
3
4
6 fgcom - VoIP client for the FlightGear radio infrastructure
7
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
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
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
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
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
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
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
135 fgfs(1), the FlightGear wiki "FGCom 3.0" page ⟨http://
136 wiki.flightgear.org/FGCom_3.0⟩
137
138
139
140FlightGear 2017-06-04 FGCOM(1)