Difference between revisions of "Laser Antenna"
Cryptkeeper (talk | contribs) (Updated to reflect new 200km range) |
Cowlinator (talk | contribs) (→Establishing a connection) |
||
(30 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{SimpleItembox |
− | | | + | |Mod:Vanilla/CubeBlock/LargeBlockLaserAntenna |
− | | | + | |Size|Mass|Integrity|BuildTimeSeconds |
− | + | |RotationRate | |
− | + | |PowerInputIdle#kW | |
− | + | |PowerInputTurning#kW | |
− | + | |PowerInputLasing#kW | |
− | + | |ResourceSinkGroup|IsAirTight|PCU | |
− | + | }}{{SimpleItembox | |
− | + | |Mod:Vanilla/CubeBlock/SmallBlockLaserAntenna | |
− | + | |Size|Mass|Integrity|BuildTimeSeconds | |
− | + | |RotationRate | |
− | + | |PowerInputIdle#kW | |
− | + | |PowerInputTurning#kW | |
− | + | |PowerInputLasing#kW | |
− | + | |ResourceSinkGroup|IsAirTight|PCU | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | |||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | | | ||
}} | }} | ||
− | {{ | + | {{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 | + | 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 | + | 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;"| | + | | 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;"| | + | | 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 101: | Line 51: | ||
=== Establishing a connection === | === 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: | ||
+ | |||
+ | # 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. | ||
+ | # 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. | ||
− | + | 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 === | === 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. | 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 == | == 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 116: | Line 85: | ||
== Programming == | == Programming == | ||
+ | |||
+ | 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"); | ||
+ | } | ||
+ | |||
+ | Echo("connected"); | ||
+ | } | ||
+ | } | ||
+ | </pre> | ||
== Related Items == | == Related Items == | ||
Line 125: | 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
3,584,000,000 mg
3.584 t
100 W
1,000 W
10,000,000 W
666,000,000 mg
0.666 t
186,000 W
1,000 W
10,000,000 W
Contents
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:
- 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.
- 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
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. |