Skip to content

Latest commit

 

History

History
39 lines (22 loc) · 11.1 KB

combinators.md

File metadata and controls

39 lines (22 loc) · 11.1 KB

Clusterio Combinators

Clusterio provides various combinators for connecting circuits between worlds and to the cluster itself.

Inventory Combinator

  • Provides signals reporting inventory status of the cluster's storage, similar to roboport inventory reports.
  • Provides signal-unixtime with a real time signal. This can be used to monitor UPS and connectivity.
  • Provides signal-localid indicating this world's ID within the cluster.

Transmit Combinator

Transmitters are used to send data pulses or 'frames' into the cluster. Each tick, the output of all active Transmitters (those with conditions that are currently satisfied) are collected, as if on one wire together and sent to the cluster. The collected frame is automatically tagged with signal-srcid indicating the world it came from, and signal-srctick indicating the game tick (to allow reordering if required). Outgoing frames may be tagged before transmission with signal-dstid to send them only to a specific world.

Recieve Combinator

Recievers are used to listen for frames being transmitted. Incoming frames are queued up and replayed one per tick on all Recievers.

Example circuits

Basic inventory reporting

The following small circuits can be used to monitor a single status frame per world. The transmitter is configured to monitor a roboport's inventory and transmit updates whenever the frame changes. The receiver sorts incoming frames to one of the memory cells by its signal-srcid, and stores the last received frame. Stored frames are output on the poles at the bottom, for display/processing. Pushbuttons are included to clear each memory cell manually if required.

Simple Demo

0eNrtm11u2zgQx69S8HFXLkRSnwZ2X9ob9LEIBNmmY6L6AkUFNQIdoLfYs+1JlrJSR7FEeah0GwXWSxBZFjWc3/yHww8/ok1SsULwTKL1I+LbPCvR+usjKvl9FifNZ/JYMLRGXLIUWSiL0+Zqx7Z8x8Rqm6cbnsUyF6i2EM927Dta49q62oDIN3mRC9l5jNR3FmKZ5JKz1ojTxTHKqnTDhGr3/HRRye6rLVTkpXosz5r3qaZW7kfXQkf1j6/a33HBtu1dz0Kqi1LkSbRhh/iBq6fVI0/didS93amdsvl0z0Upo15HHriQlfrkbE37jdUmibffmv40TpRx41G7uUiLWJzMXKN/f/yjHssrqToAb5g9MHGUB57dt60XR2VolcloL/I04plqDK2lqFjdvjxre3vqA27+3AvGsq5H+U65W32Xi23FZXtZ39V1A+7C6WSMed/x9A0cH2dd7/xa33egDrp9Hyel1u+C7S69Tl96HXc83ly7l7eVJAbp0T49CxEtbGz0Wl0s0LN3YsHlIWWSb8fDAZuFw3Ozr4sIFm8PDbSSNc1Ez0GxUo7IC6Zi4mQG+mOKHE+NGzAn4853rrDrPT4Mx+nn1h6Pszq9j249jODnq9J8x6J8H3W8Zb8izIdtdo0D6rkH8wgo+2U8/fkm8WQUPzpxe8YsvJYEOcVSh4VzQyx8LYvrXyYXiSCEicY3BuW+Dajz2Pm/pOGn1g1YeeN5OBhl58FUFJzNvGdXalSnpUI1iZiXUfPdtsB4TTwOmRmaVXVPSreBAfRLqrpSqEZelnSrIPSpS11yUdr99RZFNSRGXgYYtk2SBQaOoU2rJiydmbCkFFPseY49U5jheLbA2AimA4SJzWCSecAMfAe7XjBTkn3dXaAkRig9IEqzmbM9D5KhQum5eK4kzUQXAEnRKaMh/p2kYEscf89ggSO8Mga6JgQJhlVd2JkyBi4EQemyh9BozkOA00/sTpzW4Fuefg4ViXA5aROiN6UKWeQEGrN6cgqNEFKgnMxXCegip6EyHZ7atHIKJlSCi5qGCZFxNRGjOTZxgGoKzXc+FjUNzZTgmU2nJmKbslhQDE6F4LLQosDmNdvT/g293e0b7Gr3bgEVXi/hAZcjCJm813bLrHwjVs4VVsAFCTJ9o/2WWYVGrK4s1lMbyMoxZWUvqIhthCq4ggpYhxO3c4CsPGwqKVWXdet7F9UCGcaz54lkQnNmDlAUVw0C3Dk6d2dBdv6GN/qhQ4Hh9P7nmO2APPK7ztLNZU2aYLMBmmjPdBF3vCrzwIfDqI68D1OA814VAB1gg2mnGhcFwJZ4x8ueEQX44woIwApwdORDmALIO1UAtGyhhqcG8KKAMQVQs2JyRAHhqAIG8OoU4OrIY5AC7PcqAGAxSA2355f4Hzvue20EcKDxT8dXpgbo6hrydOCfJ9cp2/EqXbFEdVGoWVuRJ0y7zxi8phTXnqh3TI2hE4wJgMa4psZgc2MGUuGwMZ6hMVNsGdybbpJP81uldee3URZK4g1T8kKfkqpUyY7nH77wtEjYh88szdV9paqynccHPiFOiGlI6/o/EyRdqw==

Bridged Feathernet

A more advanced reporting system, with multiple reporting stations per world, can be configured using Feathernet. Below is an example bus of two nodes and a bridge. With this system, frames may be sent to a specific node by setting signal-grey to that node's feathernet ID, or to all nodes by leaving it 0. signal-black is reserved for collision detection (and will cause this system to ignore frames from the simpler one above, and vice versa). signal-white is reserved for protocol IDs, as described in the Feathernet repo, with a value 0 set aside for use with native signals. All other signals are available for use.

Bridged Feathernet

Bridge: 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

Node: 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