Guide to circuits: Difference between revisions

From BeeStation Wiki
Jump to navigation Jump to search
imported>Supermichael777
(Barebones but its a start)
 
m (Marked as need revising)
 
(30 intermediate revisions by 17 users not shown)
Line 1: Line 1:
Circuits and devices are a new system for creating programmable objects from predefined modules. Currently unavailable in game
{{Needs revision|reason=Needs a list of components, shells and their uses, list of things can be connected to with usb cables, list of different kinds of connection within the circuit and general updating to out of date info on most of the text}}'''Circuits''' are an efficient way to automate simple and complex actions and contraptions. You can make almost anything you can think of with circuits, such as a [https://wiki.beestation13.com/view/Machines#Bluespace_Launchpad launchpad] system that can teleport you anywhere around the station, a translator that can translate any language into Galactic Common, or a scanner gate that bolts the doors if [[Mothpeople|certain]] [[Lizardperson|species]] [[Felinids|tries]] to enter your [[Science|domain]].  
==Terms==
 
Circuits work with two kinds of signals.
==Integrated Circuit==
*Pulses: used to coordinate the device and tell circuits to act.
The integrated circuit is the foundation for all circuits. Shells can be implanted with integrated circuits and removed with a screwdriver. You can't add components to an integrated circuit whilst it is in a shell, but you can rewire it with a multitool.
*Data: a value that the circuits store act, with, modify, and transmit as outputs.
 
**Strings are plain text values.
Batteries can be removed from an integrated circuit with screwdriver. Integrated Circuits are always off and do not process inputs when not in a shell. You can interact with an integrated circuits by using it in your hand, and you can attach components to it by hitting it with a component.
**Numbers are a numerical value that can have math done on it.
 
***Booleans are a special Number expecting any number >=1(True) or 0(False)
Each component has ports that input and output information. The component acts as the processor and the ports act as the input/outputs. An input can only be connected to one output but an output can be connected to many inputs.
**Refs are references to specific objects in the world.
 
==I/O==
Whenever an input receives a value, it drains 1 unit of energy from the attached battery cell There are currently no components that can interact with the physical world except a built-in component for the drone shell that allows it to move.
Every circuit has at least one of the following.
 
*Data input: These take data values that the device preforms functions with. Has a buffer that can store a single value
Signal ports are number ports, but are used to trigger the execution of a component. Each component will usually have an input signal port and an output signal port.
*Data output: these send values to inputs wired to them, overwriting the buffer.
==Circuit Multitool==
*Pulse input: these take a pulse and trigger a function on the circuit such as doing math.
The circuit multitool is used to mark entities. Using it in hand will clear the current marked entity, allowing you to mark another entity. A marked entity can then be uploaded to a circuit port with the "any" or "entity" type by pressing the upload button on it.
*Pulse output: these send out pulses based on some event, such as new data being written to outputs, a button on the device being pressed, or an internal clock ticking.
== Shells==
==Tools==
*Compact Remote - A remote with one button. Click on it to trigger it.
The primary method for interacting with devices is through specialized tools.
*Controller - Remote with 3 buttons. Normal clicking, alt-clicking, and right-clicking when in your hand will trigger one of the three ports.
*Circuit printer: makes all the bits for your cool new toys as well as all the tools
*Bot - A structure that cannot be picked up but is not dense. The most generic container as it has no special inputs or outputs.
*Wiring tool: allows you to wire and unwire inputs and outputs. Outputs should only be wired to Inputs of a compatible type!
*Drone - A mob that moves about when fed input commands by the circuit.
*Debug tool: allows you write Refs, Strings, numbers or the null value to any buffer and send pulses
*Server - A structure that cannot be picked up and only operates when anchored. Can hold an enormous amount of components.
*Copy tool: Allows you to get a text string used to copy devices.
[[Category:Guides]]
*Multitool: writes to bools and pulses
*crowbar: lets you open the device shells to modify them

Latest revision as of 13:58, 11 November 2023

This page needs revising!

The following page is out of date and/or needs to be revised. If the page's guide needs revision, see here for an example.
The revision reason is: "Needs a list of components, shells and their uses, list of things can be connected to with usb cables, list of different kinds of connection within the circuit and general updating to out of date info on most of the text"


Circuits are an efficient way to automate simple and complex actions and contraptions. You can make almost anything you can think of with circuits, such as a launchpad system that can teleport you anywhere around the station, a translator that can translate any language into Galactic Common, or a scanner gate that bolts the doors if certain species tries to enter your domain.

Integrated Circuit

The integrated circuit is the foundation for all circuits. Shells can be implanted with integrated circuits and removed with a screwdriver. You can't add components to an integrated circuit whilst it is in a shell, but you can rewire it with a multitool.

Batteries can be removed from an integrated circuit with screwdriver. Integrated Circuits are always off and do not process inputs when not in a shell. You can interact with an integrated circuits by using it in your hand, and you can attach components to it by hitting it with a component.

Each component has ports that input and output information. The component acts as the processor and the ports act as the input/outputs. An input can only be connected to one output but an output can be connected to many inputs.

Whenever an input receives a value, it drains 1 unit of energy from the attached battery cell There are currently no components that can interact with the physical world except a built-in component for the drone shell that allows it to move.

Signal ports are number ports, but are used to trigger the execution of a component. Each component will usually have an input signal port and an output signal port.

Circuit Multitool

The circuit multitool is used to mark entities. Using it in hand will clear the current marked entity, allowing you to mark another entity. A marked entity can then be uploaded to a circuit port with the "any" or "entity" type by pressing the upload button on it.

Shells

  • Compact Remote - A remote with one button. Click on it to trigger it.
  • Controller - Remote with 3 buttons. Normal clicking, alt-clicking, and right-clicking when in your hand will trigger one of the three ports.
  • Bot - A structure that cannot be picked up but is not dense. The most generic container as it has no special inputs or outputs.
  • Drone - A mob that moves about when fed input commands by the circuit.
  • Server - A structure that cannot be picked up and only operates when anchored. Can hold an enormous amount of components.