ATC-pie FAQ: Difference between revisions

Jump to navigation Jump to search
313 bytes removed ,  19 December 2021
v1.8.5
(+ Template:Key press)
(v1.8.5)
Line 5: Line 5:
== Things "not working" ==
== Things "not working" ==


=== Why am I not seeing this aircraft on my radar? ===
=== This aircraft is connected but I am not seeing it on my radar. ===
Connected to FGMS: '''I know it is there: the pilot is sending chat messages and/or is visible on the online live map...'''
 
You only see an aircraft on your scopes if a radar contact is established, i.e. if it is visible to the primary radar or if the secondary radar (SSR) picks up a transponder signal from it.
You only see an aircraft on your scopes if a radar contact is established, i.e. if it is visible to the primary radar or if the secondary radar (SSR) picks up a transponder signal from it.


Line 21: Line 19:
First, verify that the FGCom variant selected in the ''system settings'' is the one you want to use. Check that your sound is on, your volume loud and your microphone working (system sound monitor picking up a signal). Close all open sessions and open a single ATC-pie instance.
First, verify that the FGCom variant selected in the ''system settings'' is the one you want to use. Check that your sound is on, your volume loud and your microphone working (system sound monitor picking up a signal). Close all open sessions and open a single ATC-pie instance.


If you have chosen the '''stand-alone''' FGCom variant, take the steps below in order:
If you have chosen the '''standalone''' FGCom variant, take the steps below in order:
# Echo test
# Echo test
#: Start an ''FGCom configuration test'' from the ''System'' menu. While the test is running, speak in the microphone and check if you can hear yourself back. If so, you may skip directly to step 4.
#: Start a standalone FGCom configuration test from the system tools menu. While the test is running, speak in the microphone and check if you can hear yourself back. If so, you may skip directly to step 4.
# Path to executable
# Path to executable
#: Verify the FGCom command entered in the system settings. It should contain an executable system command or a relative or absolute path to an FGCom executable file. If you have FlightGear installed on your machine, you can point to the FGCom executable already available with it. On Linux, the default "fgcom" command usually does the job. Otherwise, [https://sourceforge.net/projects/atc-pie/files/fgcom-standalone/ download an FGCom stand-alone program] from ATC-pie's SourceForge file list. In any case, try the entry from a terminal in the ATC-pie directory to manually check that it runs correctly.
#: Verify the FGCom command entered in the system settings. It should contain an executable system command or a relative or absolute path to an FGCom executable file. If you have FlightGear installed on your machine, you can point to the FGCom executable already available with it. On Linux, the default "fgcom" command usually does the job. Otherwise, [https://sourceforge.net/projects/atc-pie/files/fgcom-standalone/ download an FGCom standalone program] from ATC-pie's SourceForge file list. In any case, try the entry from a terminal in the ATC-pie directory to manually check that it runs correctly.
# FGCom server status
# FGCom server status
#: The server may temporarily be down, unfortunately even for up to a few days. Check for responses from the server, e.g. with <code>ping fgcom.flightgear.org</code> (adjusting the server name to match the one entered in the settings). FGCom will not work without a responding server.
#: The server may temporarily be down, unfortunately even for up to a few days. Check for responses from the server, e.g. with <code>ping fgcom.flightgear.org</code> (adjusting the server name to match the one entered in the settings). FGCom will not work without a responding server.
Line 39: Line 37:
#: Check that the control port in ATC-pie is set to the one FGCom-Mumble is listening on.
#: Check that the control port in ATC-pie is set to the one FGCom-Mumble is listening on.
# Echo test
# Echo test
#: Start an ''FGCom configuration test'' from the ''System'' menu.
#: Start an FGCom-Mumble configuration test from the system tools menu.


Note that the two variants are ''not'' interoperable. Users will only be able to hear and interact with others using the same variant (and server) as their own.
Note that the two variants are ''not'' interoperable. Users will only be able to hear and interact with others using the same variant (and server) as their own.


=== Recording ATIS with stand-alone FGCom: no beep is heard after pressing "record". ===
=== Recording ATIS with standalone FGCom: no beep is heard after pressing "record". ===
Assuming FGCom standalone is working (confirm this with an echo test before reading on)...
Assuming FGCom standalone is working (confirm this with an echo test before reading on)...


Line 61: Line 59:


=== Simulated aircraft appear to dip underground or levitate over taxiways. ===
=== Simulated aircraft appear to dip underground or levitate over taxiways. ===
Do you have a ground elevation map for the location? Quoting from <code>CONFIG/elev/Notice</code>: "''When no elevation map is found for an airport, the field elevation value is used everywhere on the ground. This should be OK for a rough approximation on flat terrain, but ground traffic will not follow any slopes, thus may appear as floating above the ground, or dipping into it.''"
Do you have a ground elevation map for the location? Quoting from <code>CONFIG/elev/Notice</code>: "''When no elevation map is found for an airport, the field elevation value is used everywhere on the ground. This should be OK for a rough approximation on flat terrain, but ground traffic will not follow any slopes, thus may appear as floating above the ground, or dipping into it.''" Read the full notice for instructions on how to build your elevation map.
 
Read the full notice for instructions on how to build your elevation map. Once you have one or decide that your field is flat enough, the next focus is on the FlightGear aircraft models. Each model has its own coordinate system chosen at developer's discretion. ATC-pie must be given the height difference between each model's origin and the aircraft touch-down point (gear wheels) to position aircraft more accurately. You can do this on a per-model basis with ":height" specifications in <code>CONFIG/acft/icao2fgfs</code>. Read the associated <code>Notice</code> file for more information.


A last possible altitude adjustment is available from the location options: "Altitude adjustment for FlightGear views". It applies the given offset to all traffic rendered by the views.
Once you have one or decide that your field is flat enough, the next focus is on the FlightGear aircraft models. Each model has its own coordinate system chosen at developer's discretion. ATC-pie must be given the height difference between each model's origin and the aircraft touch-down point (gear wheels) to position aircraft more accurately. You can do this on a per-model basis with ":height" specifications in <code>CONFIG/acft/icao2fgfs</code>. Read the associated <code>Notice</code> section for more information.


=== Phone lines have broken, choppy or dragged out sound ===
=== Phone lines have broken, choppy or dragged out sound ===
Line 138: Line 134:


=== How do I customise the GUI and colours? ===
=== How do I customise the GUI and colours? ===
To change the '''radar or strip drawing colours''', edit the <code>CONFIG/colours.conf</code> file. Each line specifies the paint colour for an object type, in a typical hex <code>RRGGBB</code> (red-green-blue) format or as an SVG colour keyword name like "white". To customise the '''main session window''', place a ''Qt stylesheet'' named <code>main-stylesheet.qss</code> in the <code>CONFIG</code> directory. ATC-pie will apply it to every session window. While you are working on your look and feel, use the reload feature from the "System" menu to avoid restarting after every change ({{key press|Shift|Alt|F12}}).
To change the '''radar or strip drawing colours''', edit the <code>CONFIG/colours.conf</code> file. Each line specifies the paint colour for an object type, in a typical hex <code>RRGGBB</code> (red-green-blue) format or as an SVG colour keyword name like "white". To customise the '''main session window''', place a ''Qt stylesheet'' named <code>main-stylesheet.qss</code> in the <code>CONFIG</code> directory. ATC-pie will apply it to every session window. While you are working on your look and feel, use the reload feature from the "System" menu to avoid restarting after every change.


Send us screenshots and share your files if you find a setup looking really cool! :-)
Send us screenshots and share your files if you find a setup looking really cool! :-)
265

edits

Navigation menu