Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
ivac2:firdef_atc_xml [2015/06/08 14:11]
splendor.bouman [Example]
ivac2:firdef_atc_xml [2017/09/02 17:59] (current)
ian.beswick [XML structure]
Line 1: Line 1:
 ====== atc.xml ====== ====== atc.xml ======
  
-The ''​atc.xml''​ file is located in the ''​fir/''​ directory ​and defines the available ATC positions for a FIR. It can also be used to define aliases for neighbouring ATC Units in order to customise the way the sector name is displayed.+A **position** is an individual controller connected to IVAO. Theoretically a position will be able to activate a number of sectors simultaneously which will be individually visible online. 
 + 
 +The ''​atc.xml''​ file is located in the ''​fir''​ directory
 ===== XML structure ===== ===== XML structure =====
  
-''​Format subject to change''​+''​Fields may be added in future''​
  
 ^Element|atc| ^Element|atc|
 ^Value^Format^Description^ ^Value^Format^Description^
 | id  |string| ATC position id | | id  |string| ATC position id |
-| long |string| position ​identification (long format) - used in labels, flight ​lists, .... | +| long |string| ​long position ​ID. Used in lists etcto identify other ATC positionsShould be unique. | 
-| short |string| position ​identification (short format) - used in labels, flight lists, .... (cfr. label owner tag) |+| short |string| ​short position ​ID. Used in label to identify current/​next sector ​|
 | freq |frequency| Frequency of the position (for legacy support) |  | freq |frequency| Frequency of the position (for legacy support) | 
 | avbl |true/​false| ATC position available for login (boolean: true/​false)| | avbl |true/​false| ATC position available for login (boolean: true/​false)|
-| callsign |string| radio callsign of the ATC positionused in ATIS etc,... |+| callsign |string| radio callsign of the ATC position ​
 +| name |string| Display name used in the launcher(defaults to callsign if not present) ​|
 | label |string| label definition to be used for this specific ATC position (default="​default"​) | | label |string| label definition to be used for this specific ATC position (default="​default"​) |
 | theme |string| SDD theme for this specific ATC position (default="​default"​) ​  | | theme |string| SDD theme for this specific ATC position (default="​default"​) ​  |
-| preset |string| map preset to load |+| preset |string| map preset to load when position is loaded | 
 +| atis |string| DEPARTURE (for departure ATIS), ARRIVAL (for arrival ATIS), BOTH (default value, combined departure and arrival ATIS), MINIMAL (no actual ATIS, callsign and voice server only (for ACC sectors etc.) | 
 +| lat || The latitude of the radar position/​radio antenna location| 
 +| lon || The longitude of the radar position/​radio antenna location| 
 +| range | int | The radar/radio range of the position (in NM)| 
 +| magvar| int | The magnetic variation specific to this ATC position. If specified, it will over-ride any value provided in the confg.fir file. This setting is deprecated in favour of applying magvar in a preset definition.|
  
  
Line 28: Line 36:
 |active |true/​false| whether or not this sector is visible as active | |active |true/​false| whether or not this sector is visible as active |
 | fir |string| the FIR ID in the  [[firdef_sectors_xml|sectors]] definition | | fir |string| the FIR ID in the  [[firdef_sectors_xml|sectors]] definition |
- 
 ==== Example ==== ==== Example ====
  
 <code XML> <code XML>
-<atc id="EBBU_W_CTR" long="WH" short="​W" freq="131.100" lat="N0505405" lon="E0042904" range="​250" avbl="​true"​ callsign="​Brussels ​Control"​ label="​canac2" theme="​canac2" preset="​w-acc">​ +<atc 
-  <sector id="WHS"​ active="​true"​ fir="​EBBU" /> +id="EKDK_A_CTR" long="EKDKA" short="​A" freq="121.375" 
-  <sector ​id="MKOK" active="​true"​ fir="EBBU" ​/+lat="N0550000" lon="E0110000" range="​150" avbl="​true"​ 
-  <sector id="APP"​ active="​false"​ fir="​EBBU" />+callsign="​Copenhagen ​Control"​ label="​acc" theme="​coopans" preset="​dka" 
 +name="​Copenhagen Sector A" atis="​MINIMAL"​ 
 +> 
 + 
 +  <sector id="DKA" active="​true"​ fir="EKDK" /> 
 + 
 +</atc> 
 + 
 +<​atc ​id="EKKA_TWR" ​long="​EKKATWR"​ short="​KT"​ freq="​119.575"​ 
 +lat="​N0561750850"​ lon="​E0090728660"​ range="​100"​ avbl="​true"​ 
 +label="app" ​theme="​coopans"​ callsign="​Karup Tower" preset="​ekka"​ name="​Karup TWR" 
 +> 
 + 
 +  <sector id="KT" active="​true" fir="EKDK" /> 
 +  ​
 </​atc>​ </​atc>​
 </​code>​ </​code>​
 <code XML> <code XML>
-<atc id="EBBR_GND" long="GND" short="​G" freq="​121.875" lat="N0505405" lon="E0042904" range="​60" avbl="​true" ​callsign="Brussels Ground" ​label="canac2" ​theme="twr" preset="​ebbr"/>+<atc id="EKCH_GND" long="APNARR" short="​APNA" freq="​121.625" 
 +lat="N0553704500" lon="E0123921500" range="​15" avbl="​true"​ 
 +label="app" ​theme="coopans" ​callsign="Kastrup Apron" preset="​ekch_apn" 
 +name="​Kastrup Apron (main/​arrival)"​ 
 +
 + 
 +  <sector id="​APNA"​ active="​true"​ fir="​EKDK"​ /> 
 + 
 +</atc>
 </​code>​ </​code>​
 <code XML> <code XML>
-<atc id="EGTT_CTR" long="TT" short="​TT" avbl="​false"​ callsign="​London ​Control"/>​+<atc id="ESMM_CTR" ​   long="ESMM" ​   short="​MM" avbl="​false"​ callsign="​Sweden Control"/>​ 
 +<atc id="​ESMM_K_CTR" ​ long="​ESMM-K" ​ short="​MM"​ avbl="​false"​ callsign="​Sweden Control"/>​ 
 +<atc id="​ESMM_L_CTR" ​ long="​ESMM-L" ​ short="​MM"​ avbl="​false"​ callsign="​Sweden ​Control"/>​
 </​code>​ </​code>​