Difference between revisions of "Laser Antenna"

From Space Engineers Wiki
Jump to: navigation, search
(Programming)
(Establishing a connection)
 
(21 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{itembox
+
{{SimpleItembox
| item = Laser Antenna
+
|Mod:Vanilla/CubeBlock/LargeBlockLaserAntenna
| description = Used to broadcast a communication between two ship or station.
+
|Size|Mass|Integrity|BuildTimeSeconds
| tool = no
+
|RotationRate
| largeship = yes
+
|PowerInputIdle#kW
| smallship = yes
+
|PowerInputTurning#kW
| component = no
+
|PowerInputLasing#kW
| rawmaterial = no
+
|ResourceSinkGroup|IsAirTight|PCU
| material = no
+
}}{{SimpleItembox
 
+
|Mod:Vanilla/CubeBlock/SmallBlockLaserAntenna
| lbuildtime = 50
+
|Size|Mass|Integrity|BuildTimeSeconds
| lpowerconsumption = 0.576
+
|RotationRate
| lpowerstandby = 0.186
+
|PowerInputIdle#kW
| lresourcesinkgroup = Utility
+
|PowerInputTurning#kW
| lairtightness = sometimes
+
|PowerInputLasing#kW
| lcomponentstructure = 3
+
|ResourceSinkGroup|IsAirTight|PCU
| lcomponent1 = Steel Plate
 
| lcomponent1amt = 10
 
| lcomponent2 = Bulletproof Glass
 
| lcomponent2amt = 4
 
| lcomponent3 = Computer
 
| lcomponent3amt = 50
 
| lcomponent4 = Superconductor Component
 
| lcomponent4amt = 100
 
| lcomponent5 = Radio-Communication Components
 
| lcomponent5amt = 20
 
| lcomponent6 = Detector Components
 
| lcomponent6amt = 30
 
| lcomponent7 = Motor
 
| lcomponent7amt = 16
 
| lcomponent8 = Construction Component
 
| lcomponent8amt = 40
 
| lcomponent9 = Steel Plate
 
| lcomponent9amt = 40
 
| lwidth = 1
 
| lheight = 2
 
| ldepth = 1
 
 
 
| sbuildtime = 20
 
| spowerconsumption = 0.18
 
| spowerstandby = 0.06
 
| sresourcesinkgroup = Utility
 
| sairtightness = no
 
| scomponentstructure = 3
 
| scomponent1 = Steel Plate
 
| scomponent1amt = 4
 
| scomponent2 = Bulletproof Glass
 
| scomponent2amt = 2
 
| scomponent3 = Computer
 
| scomponent3amt = 30
 
| scomponent4 = Superconductor Component
 
| scomponent4amt = 10
 
| scomponent5 = Radio-Communication Components
 
| scomponent5amt = 5
 
| scomponent6 = Motor
 
| scomponent6amt = 5
 
| scomponent7 = Construction Component
 
| scomponent7amt = 10
 
| scomponent8 = Small Steel Tube
 
| scomponent8amt = 10
 
| scomponent9 = Steel Plate
 
| scomponent9amt = 6
 
| swidth = 3
 
| sheight = 3
 
| sdepth = 3
 
 
 
| version = 01.105
 
 
}}
 
}}
{{stub}}
+
{{CategorizeComponents|Mod:Vanilla/CubeBlock/LargeBlockLaserAntenna}}
 +
{{CategorizeComponents|Mod:Vanilla/CubeBlock/SmallBlockLaserAntenna}}
  
 
== Overview ==
 
== Overview ==
The Laser Antenna is a block capable of establishing a communication link between two units. Contrary to the [[Antenna]], it does not broadcast the ship/station name of the specific systems it is on, giving an advantage on PvP servers - communication between two different locations without revealing the position of either. However, as their name would suggest, Laser Antennae must have a clear line of sight between them, at a maximum range of 200km (this allows secret communications between Earth and the Moon, for example, which are approximately 160km apart on [[Scenarios|Easy Start Earth]]). Players, Ships, Stations and Asteroid present in the direction of two Laser Antenna facing each other will disrupt the communication until the path is cleared.
+
The Laser Antenna is a block capable of establishing a communication link between two units. Contrary to the [[Antenna]], it does not broadcast the ship/station name of the specific systems it is on, giving an advantage on PvP servers - communication between two different locations without revealing the position of either. However, as the name would suggest, Laser Antennae must have a clear line of sight between them and has unlimited range (this allows secret communications between Earth and the Moon, for example, which are approximately 160km apart on [[Scenarios|Easy Start Earth]]). Players, Ships, Stations and Asteroid present in the direction of two Laser Antenna facing each other will disrupt the communication until the path is cleared.
  
 
The Laser Antenna can also relay the signal of other antennae within its range as long as another Antenna or Laser Antenna are present within the same system.
 
The Laser Antenna can also relay the signal of other antennae within its range as long as another Antenna or Laser Antenna are present within the same system.
  
 
== Usage ==
 
== Usage ==
Unlike the [[Antenna]], the Laser Antenna does not broadcast its location. The maximum power demand on the large ships and stations for the Laser Antenna is 300x higher compared to the antenna. The ability to not publicly broadcast its location comes at a cost; with lesser range, direction limitation, more power usage and a requirement of a clear line of sight; The laser Antenna can only connect itself with another one to establish a link, reducing the amount of controlled remote system to one, the path between two linked Laser Antennae must be clear and the direction is limited by it own base, making it impossible to broadcast at full 360 degree range.
+
Unlike the [[Antenna]], the Laser Antenna has a longer range and does not broadcast its location. The maximum power demand on the large ships and stations for the Laser Antenna is alot higher compared to the antenna. The ability to not publicly broadcast its location comes at a cost; with direction limitation, more power usage and a requirement of a clear line of sight; the laser antenna can only connect to exactly one other laser antenna, and cannot connect to a regular antenna at all.  This means that a laser antenna can only remotely control one ship/base.  The path between two linked Laser Antennae must be clear and the direction is limited by it own base, making it impossible to broadcast at full 360 degree range.
 
You also cannot control remote structure directly from the control panel, you must sit in a cockpit or control station.
 
You also cannot control remote structure directly from the control panel, you must sit in a cockpit or control station.
  
Line 88: Line 38:
 
|-
 
|-
 
| style="text-align:center;"| Small Ship
 
| style="text-align:center;"| Small Ship
| style="text-align:center;"| 20000 m
+
| style="text-align:center;"| infinite
| style="text-align:center;"| 180 kW
+
| style="text-align:center;"| 180 kW @ 200km
 
| style="text-align:center;"| 60 kW
 
| style="text-align:center;"| 60 kW
 
| style="text-align:center;"| 1 kW
 
| style="text-align:center;"| 1 kW
 
|-
 
|-
 
| style="text-align:center;"| Large Ship / Station
 
| style="text-align:center;"| Large Ship / Station
| style="text-align:center;"| 200000 m
+
| style="text-align:center;"| infinite
| style="text-align:center;"| 576 kW
+
| style="text-align:center;"| 576 kW @ 2000km
 
| style="text-align:center;"| 186 kW
 
| style="text-align:center;"| 186 kW
 
| style="text-align:center;"| 1 kW
 
| style="text-align:center;"| 1 kW
Line 104: Line 54:
 
There are two ways to connect:
 
There are two ways to connect:
  
1.
+
# Establishing a connection - Via a Terminal block, the player may simply paste the coordinates of the target Laser Antenna to connect to, and press <Connect>. If both are in direct line of sight and range then they will face each other and connect. The same terminal allows the player to copy the antenna's coordinates.
  Via the termial block, player simply paste the coordinates of the antenna to connect to, and press connect.
+
# Automating the connection - Via an in-game script it is possible to [[Programmable Block|automate]] step one and let the script do the job. Antennas must still be within range and direct line of sight.
  If both are in direct line of sight and range then they will face each other and connect.
 
  The same terminal allow to copy the antenna's coordinates.
 
  
2)
+
A permanent connection can be made by ticking the corresponding checkbox in the terminal (or if a script set it to true). In which case if the connection is lost both antennas will try to reconnect. Note that if the connection was lost because one of the grids moved out of the currently set range, then the antennas themselves are not capable of moving the departing grid back to position. Here too, a script can be used to detect that the antenna is out of range, and attempt to move closer to the last known location of the other antenna (or increase the range). However, the moment both antennas are in range and achieve line of sight again they will automatically reconnect without the need of player intervention or a script.
  Via in-game script it is possible to automate option one and let the script do the job.
 
  Antennas must still be within range and direct line of sight.
 
 
 
A permanent connection can be made by ticking the corresponding checkbox in the terminal (or if a script set it to true).
 
In which case if connection is lost both antennas will try to reconnect.
 
Do note that if the connection was lost because one of the grids moved away then the antennas cannot move the grid back to position.
 
Here too, a script can be used to detect that the antenna is out of range, and attempt to move closer to the last known location of the other antenna.
 
The moment both antennas are in range and line of sight they will automatically reconnect without the need of plyer intervation or script.
 
  
 
=== Remote Access ===
 
=== Remote Access ===
Line 126: Line 66:
 
== Tips ==
 
== Tips ==
  
 +
You can use this formula to calculate the power consumption of the LA:
 +
 +
if distance < 200,000 m (200 km)
 +
 +
    Power [Watts] = 10 • distance [meters]
 +
 +
if distance > 200,000 m (200 km)
 +
 +
    Power [Watts] = 0.000025 • (distance [meters])^2 + 1,000,000
 +
 +
Power consumption is linear up to 200km, then it turns into a quadratic.
 +
You need 25MW for a 1000km connection, and 901MW for a 6000km distance.
  
 
== Media ==
 
== Media ==
Line 134: Line 86:
 
== Programming ==
 
== Programming ==
  
There is an insightful discussion on a [https://github.com/KeenSoftwareHouse/SpaceEngineers/pull/453 Keen Github web page] on PB communication scripting and other antennas hacks (from 2015-Oct to 2016-Jul).
+
There is an insightful discussion on [https://github.com/KeenSoftwareHouse/SpaceEngineers/pull/453 Keen's GitHub web page] on Programmable block communication scripting and other antenna hacks (from 2015-Oct to 2016-Jul).
 +
 
 +
Valuable information on "Programmable Block Inter-Grid Communication Guide" also appears in the programming section of the [[Antenna]] page.
 +
 
 +
=== Examples ===
 +
 
 +
For those needing a quickstart on building their own custom scripts for Laser Antennas, the following code may assist your endeavors.
 +
 
 +
<pre>
 +
/*
 +
Laser Antenna Reconnection Script
 +
* Helps you keep your remote ships connected to a base location
 +
* no matter which way the ship is pointing.
 +
* Note: Install laser antennas at the ends of your ship pointing in the
 +
* opposite directions.  This will help increase your coverage.
 +
*
 +
* Also note: you need to paste the host laser antenna (base) coordinates
 +
* into both of your ship's laser antennas before sending it off.
 +
* This way your ship will know what point to connect to in case the
 +
* connection is interrupted.
 +
*
 +
* The base laser antenna must be enabled and under your ownership
 +
* or else the laser antennas from your ship may not connect.
 +
 
 +
What you need:
 +
1. Programmable block
 +
2. Two laser antennas with the following names:
 +
- "Laser Antenna"
 +
- "Laser Antenna 2"
 +
3. A timer block that runs the programmable block and retriggers itself
 +
- Suggested to keep this around 1-10 seconds, depending on your needs
 +
*/
 +
 
 +
public void Main(void)
 +
{
 +
      // Grab the first laser antenna
 +
      var ant1 = GridTerminalSystem.GetBlockWithName("Laser Antenna") as IMyLaserAntenna;
 +
 
 +
      // Grab the second laser antenna
 +
      var ant2 = GridTerminalSystem.GetBlockWithName("Laser Antenna 2") as IMyLaserAntenna;
 +
 
 +
      // Check connection status of both antennas
 +
      var ant1ConStat = ant1.Status == MyLaserAntennaStatus.Connected;
 +
      var ant2ConStat = ant2.Status == MyLaserAntennaStatus.Connected;
 +
 
 +
      // If neither antenna is connected, try reinstating the connection
 +
      if(!ant1ConStat && !ant2ConStat)
 +
      {
 +
              ant1.Connect();
 +
              ant2.Connect();
 +
              Echo("connecting...");
 +
      }
 +
 
 +
      // Otherwise, put the unused antenna into an Idle state
 +
      // If both antennas connected, the first one will be set to Idle
 +
      else {
 +
              // Put the unused antenna into an Idle state
 +
              if(!ant1ConStat)
 +
              {
 +
                    ant1.ApplyAction("Idle");
 +
              } else if(!ant2ConStat)
 +
              {
 +
                    ant2.ApplyAction("Idle");
 +
              }
  
Valuable information on "Programmable Block Inter-Grid Communication Guide" also appears in the end programming section of the [[Antenna]] page.
+
              Echo("connected");
 +
      }
 +
}
 +
</pre>
  
 
== Related Items ==
 
== Related Items ==
Line 146: Line 164:
 
{| class="wikitable" style="width: 100%"
 
{| class="wikitable" style="width: 100%"
 
|style="text-align: center;width: 8%"| [[Update 01.072]] ||style="padding-left: 10px;padding-right: 10px;"| Laser Antenna introduced.
 
|style="text-align: center;width: 8%"| [[Update 01.072]] ||style="padding-left: 10px;padding-right: 10px;"| Laser Antenna introduced.
 +
|style="text-align: center;width: 8%"| [[Update 01.085]] ||style="padding-left: 10px;padding-right: 10px;"| Laser Antenna Range increased to 200km.
 +
|style="text-align: center;width: 8%"| [[Update 01.086]] ||style="padding-left: 10px;padding-right: 10px;"| Laser Antenna Range increased to infinite.
 
|}
 
|}
  
 
</div>
 
</div>
 +
[[Category:Functional Blocks]]

Latest revision as of 01:43, 14 December 2021

Laser Antenna Icon.png
Large Ship / Station
Laser Antenna
Large Ship Icon.png

ComponentsRequired

 Functional 

 Hack 

Dimensions (W,H,L)1,2,1
Mass3,584 kg
3,584,000 g
3,584,000,000 mg
3.584 t
Integrity8,050
Build time40 s
Rotation Rate0.01
Power Input Idle0.1 kW
1.0e-4 MW
100 W
Power Input Turning1 kW
1.0e-3 MW
1,000 W
Power Input Lasing10,000 kW
10 MW
10,000,000 W
Power Consumer GroupUtility
Is AirtightPartially
PCU Cost100
BrowseLast edit: 2020-04-08
Laser Antenna Icon.png
Small Ship
Laser Antenna
Small Ship Icon.png

ComponentsRequired

 Functional 

 Hack 

Dimensions (W,H,L)3,3,3
Mass666 kg
666,000 g
666,000,000 mg
0.666 t
Integrity1,925
Build time20 s
Rotation Rate0.01
Power Input Idle186 kW
0.186 MW
186,000 W
Power Input Turning1 kW
1.0e-3 MW
1,000 W
Power Input Lasing10,000 kW
10 MW
10,000,000 W
Power Consumer GroupUtility
Is AirtightPartially
PCU Cost100
BrowseLast edit: 2020-04-08

Overview

The Laser Antenna is a block capable of establishing a communication link between two units. Contrary to the Antenna, it does not broadcast the ship/station name of the specific systems it is on, giving an advantage on PvP servers - communication between two different locations without revealing the position of either. However, as the name would suggest, Laser Antennae must have a clear line of sight between them and has unlimited range (this allows secret communications between Earth and the Moon, for example, which are approximately 160km apart on Easy Start Earth). Players, Ships, Stations and Asteroid present in the direction of two Laser Antenna facing each other will disrupt the communication until the path is cleared.

The Laser Antenna can also relay the signal of other antennae within its range as long as another Antenna or Laser Antenna are present within the same system.

Usage

Unlike the Antenna, the Laser Antenna has a longer range and does not broadcast its location. The maximum power demand on the large ships and stations for the Laser Antenna is alot higher compared to the antenna. The ability to not publicly broadcast its location comes at a cost; with direction limitation, more power usage and a requirement of a clear line of sight; the laser antenna can only connect to exactly one other laser antenna, and cannot connect to a regular antenna at all. This means that a laser antenna can only remotely control one ship/base. The path between two linked Laser Antennae must be clear and the direction is limited by it own base, making it impossible to broadcast at full 360 degree range. You also cannot control remote structure directly from the control panel, you must sit in a cockpit or control station.

Type Maximum Range Power usage
Connection established Idle Turning to face connection
Small Ship infinite 180 kW @ 200km 60 kW 1 kW
Large Ship / Station infinite 576 kW @ 2000km 186 kW 1 kW

Establishing a connection

In order to connect two grids, both have to be powered and both laser antennas need to be within direct line of sight. There are two ways to connect:

  1. Establishing a connection - Via a Terminal block, the player may simply paste the coordinates of the target Laser Antenna to connect to, and press <Connect>. If both are in direct line of sight and range then they will face each other and connect. The same terminal allows the player to copy the antenna's coordinates.
  2. Automating the connection - Via an in-game script it is possible to automate step one and let the script do the job. Antennas must still be within range and direct line of sight.

A permanent connection can be made by ticking the corresponding checkbox in the terminal (or if a script set it to true). In which case if the connection is lost both antennas will try to reconnect. Note that if the connection was lost because one of the grids moved out of the currently set range, then the antennas themselves are not capable of moving the departing grid back to position. Here too, a script can be used to detect that the antenna is out of range, and attempt to move closer to the last known location of the other antenna (or increase the range). However, the moment both antennas are in range and achieve line of sight again they will automatically reconnect without the need of player intervention or a script.

Remote Access

The laser antenna functions similar to that of Antenna block in which you can control ships and stations remotely from extreme distances, provided you have a direct line of sight connection between both laser antenna blocks. After a connection is made, similar to how control over a regular antenna, the player simply scrolls down and locates the Remote Control Block. The only condition to this is that the player must be seated on the ship or station with the laser antenna in order to gain access to the other ship it is connected to.

See the Programming section on script-controlling vast quantities of remote fleets.

Tips

You can use this formula to calculate the power consumption of the LA:

if distance < 200,000 m (200 km)

   Power [Watts] = 10 • distance [meters]

if distance > 200,000 m (200 km)

   Power [Watts] = 0.000025 • (distance [meters])^2 + 1,000,000

Power consumption is linear up to 200km, then it turns into a quadratic. You need 25MW for a 1000km connection, and 901MW for a 6000km distance.

Media

Large laser antenna (left), and Small laser antenna (right)

Known Issues

Programming

There is an insightful discussion on Keen's GitHub web page on Programmable block communication scripting and other antenna hacks (from 2015-Oct to 2016-Jul).

Valuable information on "Programmable Block Inter-Grid Communication Guide" also appears in the programming section of the Antenna page.

Examples

For those needing a quickstart on building their own custom scripts for Laser Antennas, the following code may assist your endeavors.

/*
Laser Antenna Reconnection Script
* Helps you keep your remote ships connected to a base location
* no matter which way the ship is pointing.
* Note: Install laser antennas at the ends of your ship pointing in the
* opposite directions.  This will help increase your coverage.
*
* Also note: you need to paste the host laser antenna (base) coordinates
* into both of your ship's laser antennas before sending it off.
* This way your ship will know what point to connect to in case the
* connection is interrupted.
*
* The base laser antenna must be enabled and under your ownership
* or else the laser antennas from your ship may not connect.

What you need:
1. Programmable block
2. Two laser antennas with the following names:
 - "Laser Antenna"
 - "Laser Antenna 2"
3. A timer block that runs the programmable block and retriggers itself
 - Suggested to keep this around 1-10 seconds, depending on your needs
*/

public void Main(void)
{
       // Grab the first laser antenna
       var ant1 = GridTerminalSystem.GetBlockWithName("Laser Antenna") as IMyLaserAntenna;

       // Grab the second laser antenna
       var ant2 = GridTerminalSystem.GetBlockWithName("Laser Antenna 2") as IMyLaserAntenna;

       // Check connection status of both antennas
       var ant1ConStat = ant1.Status == MyLaserAntennaStatus.Connected;
       var ant2ConStat = ant2.Status == MyLaserAntennaStatus.Connected;

       // If neither antenna is connected, try reinstating the connection
       if(!ant1ConStat && !ant2ConStat)
       {
              ant1.Connect();
              ant2.Connect();
              Echo("connecting...");
       }

       // Otherwise, put the unused antenna into an Idle state
       // If both antennas connected, the first one will be set to Idle
       else {
              // Put the unused antenna into an Idle state
              if(!ant1ConStat)
              {
                     ant1.ApplyAction("Idle");
              } else if(!ant2ConStat)
              {
                     ant2.ApplyAction("Idle");
              }

              Echo("connected");
       }
}

Related Items

Update History

Update 01.072 Laser Antenna introduced. Update 01.085 Laser Antenna Range increased to 200km. Update 01.086 Laser Antenna Range increased to infinite.