Редактирование: Guide to Telecommunications

{{Needs revision|reason=Needs badly an extremely easy to understand step-by-step guide on how to fix blown up tcomms. This happens way too often and it would encourage traitors to be more creative rather than forcing a shuttlecall 99% of the time when tcomms gets blown up. If you have the know-how, please help!}}

The '''telecommunication''' system is a complete overhaul of the way radios work, introduced in [http://code.google.com/p/tgstation13/source/detail?r=2807 revision 2807]. It adds an entire realm of complexity to the very simple and previously straight-forward process of radio communication, but in turn presents new strategies for antagonists and offers the sandbox for some... very interesting shenanigans. 

=Quick Guide to Telecommunications=
'''If you just want to know how to fix everything incredibly easy, skip to the image.'''

The room:

Full of supercooled gas. Don't breathe it, don't stand in it without internals. It has its own SMES and APC. If the APC is destroyed, replace it immediately. If the APC has power temporarily cut, look at the PDA server; if its light is red, the APC probably has a remote signaller in it, because killing APC power turns off the PDA messaging server indefinitely.

==The tools==
All machines are accessed and controlled by a multitool. One is in telecomms at the round start. To link machines, you add a machine to the multitool buffer then use the multitool on the machine to link to and hit [Link] at the bottom. Most telecomms machines will also have FILTERS to determine which frequencies are sent through which pieces of machinery. Additionally, each machine has an IDENTIFICATION STRING, which is just its unique name, and a NETWORK, defaulted to tcommsat, which allows it to link to machines on the same network name only. IF YOU CHANGE THE NETWORK NAME IT'LL UNLINK EVERYTHING. CHANGING THE HUB'S NETWORK NAME IS A COMMON METHOD OF GHETTO SABOTAGE. WATCH FOR IT.

==The machines==
* Subspace Receiver: Intakes ;Radio signals
* Subspace Broadcaster: Sends ;Radio signals
* Bus Mainframe: Regulates ;Radio signals
* Processor: Decodes ;Radio signals
* Servers: Log ;Radio signals, execute NTSL scripts.
* Hub: Takes in ;Radio signals and sends them to appropriate machines.
* Relay: Connected to a Hub on another Z-level. Allows ;Radio signals on its Z level to be run through the telecomms infrastructure of its linked hub.

==Standard Structure==
Each step is sent through the HUB typically
* [[File:Sreceiver.gif]] Signal goes from headset/intercom/etc. to a RECEIVER
* [[File:Bus.gif]] Signal is sent to the appropriate BUS MAINFRAME
* [[File:Pro.gif]] Signal is sent to the bus's corresponding PROCESSOR. Note that THE PROCESSOR AND BUS MUST BE DIRECTLY CONNECTED
* [[File:Bus.gif]] Signal is returned to the BUS MAINFRAME
* [[File:Server.gif]] Signal is logged at the SERVER and has scripts applied
* [[File:Broad.gif]] Signal is sent to the BROADCASTER
* [[File:Headset.png]] Signal is sent to all appropriate radio devices


Parts that are not optional:
* Subspace Receiver
* Subspace Broadcaster
* Bus Mainframe


Parts that are functionally non-optional:
* Processor. Why? You get this otherwise:
[[File:Simple_telecomms.png|thumb|286px|An extremely simple, but still functional version of telecommunications]]

<font color=green>>/;v**r; [145.9] says, "*ok at a;<th$>/e >$s>*v p*is#$*& ot**ng tr#nsl%/****"</font color>

'''Selene Avery''' ''says, "Look at all these massive penises not being translated."''

<font color=purple>P// [Engineering] yells, ";oly>$anna*>*&*&%$e</font color>

The above is a link of Receiver to Bus to Broadcaster.


==Can We Fix It?==
'''NOW TO IGNORE EVERYTHING ABOVE AND TELL YOU HOW TO FIX TELECOMMS INCREDIBLY EASILY NO MATTER WHAT'S DONE TO IT.'''

Machines you need: Receiver, Bus Mainframe, Processor, Broadcaster

This can be done anywhere with power, including a bombed-out telecomms room or anywhere else.

# Clear ANY frequency filters on the machines
# Grab the bus mainframe and put it on your multitool buffer
# Link it to the broadcaster, processor, and receiver.


That's it. You're done. It'll process all telecomms signals with no lag, no static, no loss of functionality except for the inability to use telecomms scripts - though this is a great way to evade hostile scripts like a rogue AI's mute script.


=A More Elaborate Guide to Telecommunications=
== The Central Compartment ==
[[File:TelecommEg.PNG|896px|thumb|right|A basic example of a telecommunication central compartment. All essential machines, including a monitoring and logging computer, are present.]]
A functional telecommunication central compartment (otherwise known as the "Server Room") contains several machines, each with its own isolated function. These machines make up a usually independent telecommunication network, with a pre-specified array of frequencies to process. Optionally, monitoring computers may be used to keep track of telecommunication activity and network integrity. It is important to notice that the machines, most dominantly the ''Processor Units'', generate a significant amount of heat. The central compartment is generally kept at a very low temperature to prevent the damage of the hardware infrastructure, so maintenance is usually not done without proper protective equipment.

A ''central'' communications compartment is not necessary for a functional telecommunications network. In fact, it may be more efficient to separate the network into sub-nets. Nanotrasen Tech Department, however, strongly suggests the centralization of the machinery for easier maintenance and bookkeeping. While a strong central compartment may be easier to maintain, it is also easier to sabotage or blow up. The only thing worse than explosive concussion damage and massive atmospheric de-stabilization is a downed communication grid. A central compartment should be well-fortified and stable, and fortunately for the crew, Nanotrasen cannot pinch for pennies in this department. The station will either receive a robust Communications Satellite or inner-station Server Room.

== The Machines == 
There are 5 different kinds of machines essential for a healthy telecommunication network. Without one or the other, the entire system would cease to function or would not function optimally. All telecommunication machines idle until they receive a signal, and all the machines are built with Hyperwave Filtering modules that allow for the scanning of signal's frequency regardless of intensity. This means each machine can selectively choose which signals to pay attention to, if there are any specified frequencies to tune into.


=== [[File:Sreceiver.gif]] Subspace Receivers ===
''Subspace Receivers'' are essential to a subspace telecommunication network. They have a long-term subspace window open at all times, and create the subspace-equivalent of a gravity well in its warped version of space-time. FTL signals traveling in subspace are going too "fast" to be sucked into the gravity well, but a carbon copy of the signal is produced whenever a signal passes through the pocket. This signal is then converted into a real radio wave by the Subspace Receiver and passed onto all immediately-linked machines. In a typical scenario only Bus Mainframes would receive the signal. 

=== [[File:Relay.gif]] Telecommunication Relays ===
''Telecommunication Relays'' are very essential creating a full network. They allow the network to expand by being able to send signals past Z levels. Meaning that when saying something in the radio, after the message is processed the HUB will locate all linked relays and add their Z level information to the signal data, which will then broadcast on the level when it reaches the broadcaster. It works by charging atoms for an almost faster than light signal. It then gets broadcasted to the hub, the only machine that can receive these almost-light speed signals and then sends them ideally to a Bus Mainframe.

=== [[File:Hub.gif]] Telecommunication Hub ===
''Telecommunication Hub'' is the main junction for the network. It is connected to many relays that are scattered along space, waiting to receive and send information to buses and relays. It uses a high level technology of circuits to send information as efficiently and as fast as possible.


[[File:SpessChart.png|640px|thumb|left|A simple visual synopsis of a basic radio telecommunication network. It shows the "route" a subspace transmission travels before it reaches its end destination(s).]]

=== [[File:Bus.gif]] Bus Mainframes ===
''Bus Mainframes'' regulate and handle the transfer of massive quantities of data at near instantaneous speeds. They are not essential to a network, but are required to keep data transfer instant. They usually transfer data back and forth between servers and processor units. If a Bus Mainframe is missing, network output may be unreliable or slow.


=== [[File:Pro.gif]] Processor Units ===
''Processor Units'' decrypt, clean and stretch hyper-compressed radio signals. Radio signals are sent into subspace using a preset encryption hash but random seed, which makes the process of encrypting and sending very light but unpacking and decrypting heavy due to the weird nature of subspace. Processor Units can instantly make signals readable by other machines. They are not essential to a subspace network but if one is missing, network output may not be understandable.


=== [[File:Server.gif]] Telecommunication Servers ===
''Telecommunication Servers'' log network statistics and signal traffic for easy maintenance. Each server represents a "channel" in the Nanotrasen default settings. They can listen in to multiple channels, however. For each signal that is sent to a server, a database entry is created and the signal's information is stored. The servers also help by sorting the order in which signals are transferred to subspace broadcasters, which is vital for instantaneous signal transferring.



''Additionally'', Telecommunication Servers are capable of running user-written scripts through use of a Telecommunications Traffic Monitor. When a signal passes through a server (and the server is set to automatically execute code), the interpreter halts the signal until the code has finished executing, then releases the signal. During this time, the server's script interpreter can modify the signal's contents or flag it as a rejected signal, which will cause broadcasters to ignore it.

''[[NT_Script|Learn more about NT Scripting (NTSL)]]''.

=== [[File:Broad.gif]] Subspace Broadcasters ===
''Subspace Broadcasters'' are impressive pieces of hardware that are capable of opening large enough subspace windows to transfer de-compressed data bursts, in encoded radio waves, through. They are necessary for any network that is expected to output information back to receiving radio devices. They operate by directing high-powered lasers into a small subspace window and fluctuating the amplitude of radio waves through subspace, allowing the large data packets easier entering and exiting of subspace.

== Maintenance Guide == 
Telecommunications machines are flexible and can adapt to structure changes, and they are otherwise immortal to mundane errors and crashes. However, in the event of a catastrophe such as an explosion, singularity, or anything of the like the default warranty becomes void and the machines will probably be destroyed or totaled. If one or more machines are destroyed, chances are the entire communication grid or at least part of it will be down. While intercoms and station bounced radios are capable of limited non-subspace communication it is most definitely not reliable. It should be maximum priority to get those machines up again.

If you suspect the machines aren't working properly (or at all), you should identify the cause first. Probably the most common issue is an exploded central compartment. Repair any structural damage and assess the machines. If they're still on (flashing/blinking lights, etc) then they are relatively functional. If there's been some atmospheric depressurization you're going to want to pump supercooled air into room; the machines need cold gas to survive or they will not be able to diffuse their heat into the environment, and will overheat.

[[File:Multitool-tcomm.png|thumb|274px|right|The multitool-telecomm interface.]]
If the machines have been overheated, you can fix them by simply reconstructing them. To do this, first unfasten the exterior bolts with a screwdriver. Next, dislodge the plating with a wrench. Next, remove the internal cables with some wirecutters. After that, you can use a crowbar to remove the internal components and circuit board. From there, you can either deconstruct the empty frame or simply rebuild it. If the machines have been completely destroyed, you're going to want to build more. You're going to have to bug R&D for some really high-tier circuit boards and stock parts, or salvage some parts from other toasted telecomm machines. Keep in mind, you don't have to reconstruct ALL the machines. At the very minimum you need 1 receiver, 1 processor, 1 server, and 1 broadcaster. You might have to manually reconnect to relays if they are destroyed, this involves a long walk.

== Telecommunication Polymorphism ==
The machines can be retrofitted manually to work with other machines that normally would not be very common or wise. In the case of an emergency, however, it can be a life-saver. You can use a multitool to interface with telecommunication machines, which will allow you to modify some of the machines' properties. You can also link together machines with this interface, which is possibly the most important function.

In order to link two machines, access one of them with your multitool. Select [Add Machine] at the bottom of the window to store this machine in the buffer of the multitool. Now access the other machine with the same multitool. The machine previously buffered should still be in the buffer of the multitool. Select [Link] to add the machine currently buffered to the list of machine links of the machine currently accessed. This will establish a link between these two machines. (Note that it is possible to link a machine to itself; this is both harmless and pointless.)

=== Subspace Receivers ===
You can link Subspace Receivers to ''Processor Units'' if you are unable to link to a functional bus mainframe. This can and will create substantial network lag, because Bus Mainframes are needed for rapid information transferring and advanced port configurations.

=== Bus Mainframes ===
You can link Bus Mainframes to ''Subspace Broadcasters'' if you are unable to link to a functional server. This will not have much of an effect besides a very miniscule performance decrease.

If you do not link to a Processor Unit, signals' readability will suffer substantially. It will also make it impossible to directly link to broadcasters.

=== Processor Units ===
You can link Processor Units to ''Telecommunication Servers'' if you are unable to link to Bus Mainframes. This will naturally have a significant performance cost.

=== Telecommunication Relay ===
Relays must be connected to a HUB in order to add information to the signal about the Z level it is in, and which will broadcast in. It cannot be linked to any other machine usefully.

=== Telecommunication Hub ===
This machine is essential when creating relays that allow you to send the same signal to multiple broadcasters on different space levels.
It is ordinarily connected to Relays, Servers and Buses. When it receives information from Relays it sends it to all linked Buses. If it receives information from a machine that isn't a Relay, it assumes it's ready-to-transmit data and then sends it to all linked Relays. This data is ideally received from Servers but Buses and Processors can send this information too.

=== Telecommunication Servers ===
These cannot really be linked to anything else other than a broadcaster. They are only needed to store logs and maintain sane bookkeeping.

=== Subspace Broadcasters === 
These are ESSENTIAL if you want an output. There is nothing you can do with these in terms of polymorphism.

= Being An Ass =
Now downing the radio may seem like something the captain does when he stubs his toe too hard, but downing the radios is something even the most [[Assistant|clueless trouble maker]] can do, provided they have the tools. Here are some easy ways to make nobody hear the screams of the station's inhabitants.

* Destroy the sub-space broadcaster. Those screams will be uttered, But not heard.

* Deconstruct the processor. This makes the radio blast gibberish that nobody can comprehend.

* Deconstruct the server and it's bus. Depending on which ones you knock out you can disable most of the command channels and such.

* Add Filtered Frequencies to the Hub in order to only allow people to speak on those frequencies. You can do this on any machine and department channels will also suffer from not being able to pass the filter.

* Use [[NT_Script|NTSL]] to make everyone speak [[NTSL_Scripts#Useful_Malicious_Scripts|weirdly]]
[[Category:Guides]]