# Tunnel

Library: | Wiring
Introduced: | 2.5.0 (in Base library, moved to Wiring in 2.7.0)
Appearance: |

## Behavior

A tunnel acts like a wire in that it binds points together, but unlike a wire the connection is not explicitly drawn. This is helpful when you need to connect points far apart in the circuit and a network of wires would make the circuit much more ugly. The below illustration illustrates how this works.

The illustration above shows how this works. Here the three tunnels have the same label, Clk_A, and represents the three points to which the tunnels are connected. If one of the tunnels has a different label, such as R_W, then it would be part of a different set of tunnels.
In the following example we can observe the occurrence of an error on activation of the controlled buffer conflicting with the bottom pin.

The controlled buffer emits a floating output since its lower input is 0. Normally this causes the wire from the controlled buffer to be blue, but here it is bright green. This is correct, as it is connected through the tunnel to the bottom pin which is 1. If the buffer control goes to 1, the tunnel will carry this value to the other points and it will conflict with the 1 on the bottom pin triggering an error. Red wires (E) can then be seen running through the three tunnels as in the example.

## Pins

A tunnel has only one pin, whose bit width matches the tunnel's Data Bits attribute. This pin is neither an input nor an output — Tunnels of the same label are simply interconnected transparently like wires.

## Attributes

When the component is selected or being added, Alt-0 through Alt-9 alter its Data Bits attribute and the arrow keys alter its Facing attribute.

Facing
  The direction toward which the tunnel points.
Data Bits
  The number of bits for the tunnel.
Label
  The text within the label associated with the tunnel. This tunnel is connected to all other tunnels with exactly the same label.
Label Font
  The font with which to render the label.

## Poke Tool Behavior

None.

## Text Tool Behavior

Allows the label associated with the tunnel to be edited.

Back to Library Reference