Red Griffin ATC: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
No edit summary
Line 6: Line 6:
| developedby            = Antonello Biancalana (Red Griffin, IK0TOJ)
| developedby            = Antonello Biancalana (Red Griffin, IK0TOJ)
| initialrelease        = January 5, 2020
| initialrelease        = January 5, 2020
| latestrelease          = 2.2.0 March 6, 2021
| latestrelease          = 2.3.0 May 7, 2021
| writtenin              = Nasal
| writtenin              = Nasal
| developmentstatus      = Active (2019-)
| developmentstatus      = Active (2019-)
Line 26: Line 26:
* Support for ground, take off, visual approach, ILS and landing operations
* Support for ground, take off, visual approach, ILS and landing operations
* ATC assisted approach, guiding the pilot to the proper route, altitude and speed up to the final approach point to runway and according to aircraft type
* ATC assisted approach, guiding the pilot to the proper route, altitude and speed up to the final approach point to runway and according to aircraft type
* Festival Speech Synthesis System support
* Squawking
* Squawking
* Approach and slope monitor
* Approach and slope monitor
* Speech synthesis of messages through native FlightGear speech synthesizer
* Speech synthesis of messages through native FlightGear speech synthesizer
* Festival Speech Synthesis System support
* ATC can be operated both with mouse and keyboard
* ATC can be operated both with mouse and keyboard
* Independent dialog window or pop-up window operation modes
* Independent dialog window or pop-up window operation modes
Line 153: Line 153:
The changes done in the settings dialog are immediate and are effective as soon as the dialog is closed. The settings dialog allows to change the following options and therefore affecting the operational mode of the Red Griffin ATC addon:
The changes done in the settings dialog are immediate and are effective as soon as the dialog is closed. The settings dialog allows to change the following options and therefore affecting the operational mode of the Red Griffin ATC addon:
* '''Dialog Position''' ''(possible values: Top Left, Top Right, Bottom Left, Bottom Right)'' - Sets the initial position of the main dialog relative to the screen or window.
* '''Dialog Position''' ''(possible values: Top Left, Top Right, Bottom Left, Bottom Right)'' - Sets the initial position of the main dialog relative to the screen or window.
* '''ATC text position''' ''(possible values: Top Left, Top Center, Top Right, Middle Left, Middle Center, Middle Right, Bottom Left, Bottom Center, Bottom Right)'' - Sets the position of the ATC messages relative to the screen.
* '''ATC text transparency''' ''(possible values: Off, Very low, Low, Medium, High, Very high)'' - Sets the transparency of ATC messages in the screen.
* '''Call sign''' - Pilot call sign or aircraft registration code. It defaults to <code>/sim/multiplay/callsign</code> property. This value is copied both to <code>/sim/multiplay/callsign</code> and <code>/sim/user/callsign</code> properties.
* '''Call sign''' - Pilot call sign or aircraft registration code. It defaults to <code>/sim/multiplay/callsign</code> property. This value is copied both to <code>/sim/multiplay/callsign</code> and <code>/sim/user/callsign</code> properties.
* '''Call sign usage''' ''(possible values: Complete, Last three letters, First and last two letters)'' - Defines how the ATC will use the pilot's call sign in all communications. Please note whenever a radio is tuned for the first time, the pilot will always provide the call sign in complete form in the very first contact to the radio station.
* '''Call sign usage''' ''(possible values: Complete, Last three letters, First and last two letters)'' - Defines how the ATC will use the pilot's call sign in all communications. Please note whenever a radio is tuned for the first time, the pilot will always provide the call sign in complete form in the very first contact to the radio station.
Line 159: Line 161:
* '''Aircraft type''' ''(possible values: Auto, Small single engine, Small multi engine, Executive turboprop/jet, Business jet, Airline jet, Large/military jet, Special military)'' - Defines the rules and settings used by the ATC and according to the aircraft type. In particular, it changes the parameters used in the assisted approach procedure - such as altitude, distance and speed - initial altitude after take off and cruising altitude. When set to "Auto" Red Griffin ATC will try to automatically detect the aircraft type according to the values set in <code>/sim/tags</code>. In case it was not possible to detect the aircraft types, including the case the aircraft in use has no tags defined, Red Griffin ATC will warn the user to properly choose the aircraft type. In case the user does not set an aircraft type, Red Griffin ATC will consider the aircraft as a "Small single engine" and set operational parameters accordingly. The currently selected aircraft type is always shown in the main dialog's title bar.
* '''Aircraft type''' ''(possible values: Auto, Small single engine, Small multi engine, Executive turboprop/jet, Business jet, Airline jet, Large/military jet, Special military)'' - Defines the rules and settings used by the ATC and according to the aircraft type. In particular, it changes the parameters used in the assisted approach procedure - such as altitude, distance and speed - initial altitude after take off and cruising altitude. When set to "Auto" Red Griffin ATC will try to automatically detect the aircraft type according to the values set in <code>/sim/tags</code>. In case it was not possible to detect the aircraft types, including the case the aircraft in use has no tags defined, Red Griffin ATC will warn the user to properly choose the aircraft type. In case the user does not set an aircraft type, Red Griffin ATC will consider the aircraft as a "Small single engine" and set operational parameters accordingly. The currently selected aircraft type is always shown in the main dialog's title bar.
* '''Squawking''' ''(possible values: On, Off)'' - Enable or disable ATC squawking. When on, the ATC will require the pilot to properly set the aircraft's transponder as well as operating it according to the ATC requests.
* '''Squawking''' ''(possible values: On, Off)'' - Enable or disable ATC squawking. When on, the ATC will require the pilot to properly set the aircraft's transponder as well as operating it according to the ATC requests.
* '''Approach slope angle''' ''(possible values: from 2 to 8)'' - Approach slope angle in degrees for the final leg to the destination runway. Default: 3 degrees.
* '''Open dialog at startup''' ''(possible values: On, Off)'' - Enable or disable the opening of Red Griffin ATC dialog at FlightGear startup.
* '''Pilot request''' ''(possible values: Disabled, Voice only, Text only, Voice and text)'' - Defines how the pilot requests to the ATC are to be shown, spoken or disabled. Text modes will show a pop-up message with the pilot request to be transmitted to the ATC, Voice modes will activate the speech synthesis for the requests by using <code>/sim/sound/voices/pilot</code> property and will therefore use the voice assigned by FlightGear for that specific purpose.
* '''Pilot request''' ''(possible values: Disabled, Voice only, Text only, Voice and text)'' - Defines how the pilot requests to the ATC are to be shown, spoken or disabled. Text modes will show a pop-up message with the pilot request to be transmitted to the ATC, Voice modes will activate the speech synthesis for the requests by using <code>/sim/sound/voices/pilot</code> property and will therefore use the voice assigned by FlightGear for that specific purpose.
* '''Pilot response''' ''(possible values: Disabled, Voice only, Text only, Voice and text)'' - Same as "Pilot request" but referring to the confirmation responses and message used by the pilot to acknowledge the ATC operations and instructions.
* '''Pilot response''' ''(possible values: Disabled, Voice only, Text only, Voice and text)'' - Same as "Pilot request" but referring to the confirmation responses and message used by the pilot to acknowledge the ATC operations and instructions.
Line 167: Line 169:
* '''Terrain warning''' ''(possible values: On, Off)'' - Enable or disable ATC warning in case the aircraft is flying towards terrain, such as a mountain or hill.
* '''Terrain warning''' ''(possible values: On, Off)'' - Enable or disable ATC warning in case the aircraft is flying towards terrain, such as a mountain or hill.
* '''Multiplayer chat''' ''(possible values: Off, Important messages only, All messages)'' - Define how ATC messages should be broadcast to the multiplayer chat in order to let other know about the traffic in your current airport. When set to "Important messages only", only relevant traffic information will be sent to the multiplayer chat, such as taxing, take off and landing.
* '''Multiplayer chat''' ''(possible values: Off, Important messages only, All messages)'' - Define how ATC messages should be broadcast to the multiplayer chat in order to let other know about the traffic in your current airport. When set to "Important messages only", only relevant traffic information will be sent to the multiplayer chat, such as taxing, take off and landing.
* '''Approach slope angle''' ''(possible values: from 2 to 8)'' - Approach slope angle in degrees for the final leg to the destination runway. Default: 3 degrees.
* '''Reset button''' - Resets all the setting options to their default value.
* '''Reset button''' - Resets all the setting options to their default value.
* '''Close button''' - Close the settings dialog and permanently save the options to the file <code>$FG_HOME/Export/RedGriffinATC-config.xml</code>
* '''Close button''' - Close the settings dialog and permanently save the options to the file <code>$FG_HOME/Export/RedGriffinATC-config.xml</code>
== ATC Log ==
[[File:Red Griffin ATC Log window.png|thumb|Red Griffin ATC Log window ]]
Red Griffin ATC logs every message sent and received to or from any radio tuned during the flight session. The ATC Log can be opened by selecting "ATC Log" from the menu. The messages can be scrolled with the mouse wheel or by grabbing the "scroll bar" to the right of the window.
The log widows has two buttons and corresponding to the following actions:
* '''Clear''' - Clears all the messages contained in the log
* '''Close''' - Close the log window


== Supported Aircraft Types and Operational Values ==
== Supported Aircraft Types and Operational Values ==
Line 239: Line 253:
== Aircraft compatibility ==
== Aircraft compatibility ==


Red Griffin ATC radio support and use rely on FlightGear properties and, for this reason, it is essential for the aircraft to provide a functional implementation of both the radio stack and transponder. Red Griffin ATC has been extensively tested with tens of aircraft and, according to these tests, not all aircraft seem to provide a complete implementation of COM radios and transponder. In this particular case, those aircraft will not work because of lack of fundamental properties needed by Red Griffin ATC. As of version 2.2.0, Red Griffin ATC uses and relies on the following radio properties for each COM radio:
Red Griffin ATC radio support and use rely on FlightGear properties and, for this reason, it is essential for the aircraft to provide a functional implementation of both the radio stack and transponder. Red Griffin ATC has been extensively tested with tens of aircraft and, according to these tests, not all aircraft seem to provide a complete implementation of COM radios and transponder. In this particular case, those aircraft will not work because of lack of fundamental properties needed by Red Griffin ATC. As of version 2.3.0, Red Griffin ATC uses and relies on the following radio properties for each COM radio:


* <code>/instrumentation/comm[x]/serviceable</code>
* <code>/instrumentation/comm[x]/serviceable</code>
Line 252: Line 266:
* <code>/instrumentation/comm[x]/true-bearing-to-deg</code>
* <code>/instrumentation/comm[x]/true-bearing-to-deg</code>


Moreover, in order to be fully compatible with Red Griffin ATC, the aircraft must also provide operative support for the transponder, in particular, the below properties need to be properly defined and usable:
Moreover, in order to be fully compatible with Red Griffin ATC, the aircraft must also provide operative support for its transponders, in particular, the below properties need to be properly defined and usable:


* <code>/instrumentation/transponder/serviceable</code>
* <code>/instrumentation/transponder[x]/serviceable</code>
* <code>/instrumentation/transponder/operable</code>
* <code>/instrumentation/transponder[x]/operable</code>
* <code>/instrumentation/transponder/id-code</code>
* <code>/instrumentation/transponder[x]/inputs/knob-mode</code>
* <code>/instrumentation/transponder/ident</code>
* <code>/instrumentation/transponder[x]/id-code</code>
* <code>/instrumentation/transponder[x]/ident</code>


In case the aircraft does not provide some of the above properties, Red Griffin ATC will show a warning message in the main dialog and any radio operation will not be possible. In this specific case, you can contact the aircraft developer and ask for a revision of the radio implementation in order to comply to the above properties.
In case the aircraft does not provide some of the above properties, Red Griffin ATC will show a warning message in the main dialog and any radio operation will not be possible. In this specific case, you can contact the aircraft developer and ask for a revision of the radio implementation in order to comply to the above properties.
136

edits

Navigation menu