ATC-pie FAQ: Difference between revisions

Jump to navigation Jump to search
v1.7.0
(Directory name change)
(v1.7.0)
Line 19: Line 19:


=== FGCom radio is not working. ===
=== FGCom radio is not working. ===
If you are using external clients, i.e. FGCom instances running outside of ATC-pie, you must troubleshoot them there. This section assumes you are trying with '''internal''' radio boxes. If you do not understand this distinction, the latter case is yours and you should read on.
If you are using external clients, i.e. FGCom instances running outside of ATC-pie, you must troubleshoot them there. This section assumes you are trying with '''internal''' radio boxes.


First, try an echo test:
First, try an echo test:
Line 28: Line 28:
If you hear yourself when you speak, you may skip directly to item 3 below. Otherwise start with 1.
If you hear yourself when you speak, you may skip directly to item 3 below. Otherwise start with 1.
# Bad FGCom version/path setting
# Bad FGCom version/path setting
#: Verify the path to your FGCom executable in the system settings. It should point to the right executable file. Linux, Mac and Windows versions are initially packaged with the program under <code>resources/fgcom</code>, but you can use your own or FlightGear's if you have it installed.
#: 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 (also see the [[ATC-pie installation guide]]). Try the entry from a terminal in the ATC-pie directory to check that FGCom runs correctly.
# FGCom server down
# FGCom server down
#: This can happen, unfortunately even for up to a few days. Check for responses from the server, e.g. with <code>ping fgcom.flightgear.org</code>.
#: This can happen, 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 subprocess error
# FGCom subprocess error
#: If the server is up (responding to ping), check for errors in the logged FGCom output files in the <code>OUTPUT</code> directory.
#: If the server is up (responding to ping), check for errors in the logged FGCom output files in the <code>OUTPUT</code> directory.
# Port mess-up on your side
# Port mess-up on your side
#: If you are running multiple instances of ATC-pie, make sure you have no more than one radio box on every port. To check what port a radio box is using, see its "on/off" button tooltip. You can change your FGCom settings from the system settings dialog. In any case, you should only choose available ports, not reserved by your operating system. Typically, ports from 16661 and counting up work fine.
#: If you are running multiple instances of ATC-pie, make sure you have no more than one radio box for every port number used on the system. To check what port a radio box is using, see its "on/off" button tooltip. When creating a new radio box, only choose available ports not reserved by your operating system. In general, ports from 16661 and counting up work fine on all platforms.


=== I cannot record an ATIS. ===
=== I cannot record an ATIS with FGCom. ===
Assuming FGCom is working otherwise (confirm this with an echo test before reading on), but no beep is heard after pressing "record"...
Assuming FGCom is working otherwise (confirm this with an echo test before reading on), but no beep is heard after pressing "record"...


Line 45: Line 45:
Unless you have updated or edited the frequency data yourself, check against the airport <code>.dat</code> file sourced on your side, as it should still be similar. One of the two conditions is probably not met, or the frequency missing all together.
Unless you have updated or edited the frequency data yourself, check against the airport <code>.dat</code> file sourced on your side, as it should still be similar. One of the two conditions is probably not met, or the frequency missing all together.


NB: the frequencies in the ATIS drop-down list of ATC-pie are matched against the condition (1), but not against the somewhat restrictive condition (2).
NB: The frequencies in the ATIS drop-down list of ATC-pie are matched against the condition (1), but not against the somewhat restrictive condition (2).


=== Tower view is not starting. ===
=== Tower view is not starting. ===
Line 54: Line 54:


=== 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 digging 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. 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.
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.
Line 69: Line 69:
== What is ...? Why is ...? What value/setting for ...? ==
== What is ...? Why is ...? What value/setting for ...? ==


=== What "social name" should I use in the FlightGear multi-player system settings? ===
=== What "social name" should I use for the FlightGear/FSD system settings? ===
Choose any name you would like to be recognised by on the network. In ATC-pie, it will appear in the tooltip over your callsign for connected ATCs who see you. This feature is only social in the sense that it does not refer to an account or to anything technical, but it makes sense as typical ATC callsigns (e.g. "VHHHtwr") remain mostly anonymous over MP. Use this field so that other players can identify you.
Choose any name you would like to be recognised by on the network. In ATC-pie, it will appear in the tool tip over your callsign for connected ATCs who see you. This feature is only social in the sense that it does not refer to an account or to anything technical, but it makes sense as typical ATC callsigns (e.g. "VHHHtwr") remain mostly anonymous. Use this field to identify yourself on the network.


=== Are the vector headings true or magnetic? ===
=== Are the vector headings true or magnetic? ===
Line 109: Line 109:
#:: <code>sed -ri 's/ +@[0-9]+$//' file_to_clean</code>
#:: <code>sed -ri 's/ +@[0-9]+$//' file_to_clean</code>


Tip: You can check your image configuration without restarting the program, by reloading from the ''System'' menu or pressing <code>Shift+Alt+F12</code>.
Tip: You can check your image configuration without restarting the program, by reloading from the ''System'' menu or pressing <code>Alt+F12</code>.


NB: ATC-pie does not package or source from sector files directly because their data is not free, and a lot of it is redundant with its own GPL-licensed X-plane source (GPL).
NB: ATC-pie does not package or source from sector files directly because their data is not free, and a lot of it is redundant with its own GPL-licensed X-plane source (GPL).
Line 134: Line 134:
=== The navigation/airport data is outdated. How can I update it? ===
=== The navigation/airport data is outdated. How can I update it? ===


For '''airport data''' (taxiways, parking positions, frequencies, etc.), the included source is the last world-wide <code>apt.dat</code> compiled before it became too large to maintain as one huge file. We keep it there because it allows to run ATC-pie anywhere in the world without requiring external data, but its contents grows out of date with time. You should check for more recent sources on the [http://gateway.x-plane.com/airports/page X-plane airport gateway], directly accessible from the ''System'' menu, on a per-airport basis. Extract the <code>apt.dat</code> file from the download, rename it after the airport's ICAO code (keeping the extension, e.g. <code>KJFK.dat</code>), and place it in <code>CONFIG/ad</code> (also see the <code>Notice</code> there). Alternatively, for a quick manual touch-up of the included data, you can move and edit extracted files as explained in <code>resources/x-plane.extract/Notice</code>.
For '''airport data''' (taxiways, parking positions, frequencies, etc.), the included source is the last world-wide <code>apt.dat</code> compiled before it became too large to maintain as one huge file. We keep it there because it allows to run ATC-pie anywhere in the world without requiring external data, but its contents grows out of date with time. You should check for more recent sources on the [http://gateway.x-plane.com/airports/page X-plane airport gateway], directly accessible from the ''System'' menu, on a per-airport basis. Extract the <code>apt.dat</code> file from the download, rename it after the airport's ICAO code (keeping the extension, e.g. <code>KJFK.dat</code>), and place it in <code>CONFIG/ad</code> (also see the <code>Notice</code> there). Alternatively, for a quick manual touch-up of the included data, you can move and edit extracted files (see <code>OUTPUT/Notice</code>).


For '''navigation data''' (navaids, fixes, airways, etc.), the included data is the latest version of each file that was seen released as GPL, which makes some of it date back to 2013! You should provide more recent navigation data, as explained in <code>CONFIG/nav/Notice</code>.
For '''navigation data''' (navaids, fixes, airways, etc.), the included data is the latest version of each file that was seen released as GPL, which makes some of it date back to 2013! You should provide more recent navigation data, as explained in <code>CONFIG/nav/Notice</code>.


=== 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.ini</code> file. Each line holds the paint colour for the corresponding object type in a typical <code>#RRGGBB</code> (red-green-blue) format. 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 (<code>Shift+Alt+F12</code>).
To change the '''radar or strip drawing colours''', edit the <code>CONFIG/colours.ini</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 (<code>Shift+Alt+F12</code>).


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