DCS command activateBeacon

From DCS World Wiki - Hoggitworld.com


Task: ActivateBeacon Added with: 1.2.4
Hierarchy: Scripting Root > Tasks > Command > ActivateBeacon
Tasking Type: Command
For: Airplanes, Helicopters, Ground Vehicles, Ships
Available Under: Everything
Description: Activates a beacon on the assigned group/unit. Note only one beacon be active at a time, if another beacon is activated the old beacon will be deleted.
Format: This task needs to be in the following format.
ActivateBeacon = { 
  id = 'ActivateBeacon', 
  params = { 
    type = number, 
    system = number, 
    name = string, 
    callsign = string, 
    frequency = number, 
  } 
}

Required parameters: type: The type of Beacon that will be activated.

system: Determines what device(s) will be used.

frequency: Frequency of the beacons transmitter in Hz

callsign: Message that will broadcast in Morse Code

Optional Parameters:

name: Serves no purpose other than for readability in the mission editor

priority: The priority of the tasking, the lower the number the more important the objective is. Helps define the order in which AI will execute tasking. By default the value is 0.

Enumerators: Types of beacons
BEACON_TYPE_NULL = 0 
BEACON_TYPE_VOR = 1 
BEACON_TYPE_DME = 2 
BEACON_TYPE_VOR_DME = 3 
BEACON_TYPE_TACAN = 4 
BEACON_TYPE_VORTAC = 5 
BEACON_TYPE_RSBN = 32 
BEACON_TYPE_BROADCAST_STATION = 1024 
BEACON_TYPE_HOMER = 8 
BEACON_TYPE_AIRPORT_HOMER = 4104 
BEACON_TYPE_AIRPORT_HOMER_WITH_MARKER = 4136 
BEACON_TYPE_ILS_FAR_HOMER = 16408 
BEACON_TYPE_ILS_NEAR_HOMER = 16456 
BEACON_TYPE_ILS_LOCALIZER = 16640 
BEACON_TYPE_ILS_GLIDESLOPE = 16896 
BEACON_TYPE_NAUTICAL_HOMER = 32776


Types of Systems

SystemName = { 
  PAR_10 = 1, 
  RSBN_5 = 2, 
  TACAN = 3, 
  TACAN_TANKER = 4, 
  ILS_LOCALIZER = 5, 
  ILS_GLIDESLOPE = 6, 
  BROADCAST_STATION = 7 
}
Examples:
Notes: See article Mission Editor: AI Tasking for more information on how AI tasking is handled within DCS.

Assignment of callsign and radio is relatively new, need to investigate if those values are optional and if values are inherited from previous FAC tasks. ~ Grimes

Task List: Main Tasks: mission, AttackGroup, AttackUnit, Bombing, CarpetBombing, AttackMapObject, BombingRunway, orbit, refueling, land, follow, followBigFormation, escort, Embarking, fireAtPoint, hold, FAC_AttackGroup, EmbarkToTransport, DisembarkFromTransport, CargoTransportation, goToWaypoint

En-route Tasks: engageTargets, engageTargetsInZone, engageGroup, engageUnit, awacs, tanker, ewr, FAC_engageGroup, FAC

Commands: script, setCallsign, setFrequency, switchWaypoint, stopRoute, switchAction, setInvisible, setImmortal, activateBeacon, deactivateBeacon, eplrs, start, transmitMessage, stopTransmission

Options: ROE, Reaction To Threat, Radar Using, Flare Using, Formation, RTB On Bingo, silence, Disperse on Attack, Alarm State, RTB on Out of Ammo, ECM Using, Prohibit AA, Prohibit Jettison, Prohibit Afterburner, Prohibit AG, Missile Attack Range, Prohibit WP Pass Report, Engage Air Weapons