Menu

Theme

Component reference · Component · CHECKED ON 5.0.0

Logisim tunnels: wires joined by a name

A tunnel connects to every other tunnel in the same circuit that has exactly the same Label, as if a wire ran between them. If tunnels do not connect, check three things: the labels match character for character, including case; the widths match; and all the tunnels are in the same circuit, because tunnels never pass into or out of a subcircuit.
FOR
Students tidying a large circuit · Logisim-evolution 5.0.0
CHECKED
11 Nov 2026
FIX TIME
about 5 min
Checked against Logisim-evolution 5.0.0 on 1 machines
On this page

Tunnels that do not connect: the checks

Show all paths
  1. What colour is the wire at the receiving tunnel? Blue, or the pin reads U → Is there another tunnel with the same label in this circuit, and is it driven? I am not sure → Compare the labels character by character
  2. What colour is the wire at the receiving tunnel? Blue, or the pin reads U → Is there another tunnel with the same label in this circuit, and is it driven? Yes, and it is driven → Compare the labels character by character
  3. What colour is the wire at the receiving tunnel? Orange → Make the Data Bits equal
  4. What colour is the wire at the receiving tunnel? Red → Two drivers disagree
  5. What colour is the wire at the receiving tunnel? The value is right in one circuit but missing in another → Tunnels stop at the circuit boundary

The four checks, in the order to try them:

  1. Same label, exactly. Case matters. Labels that differ only in case did not connect in our test (F99). A trailing or leading space in a label written to a file did not stop two tunnels connecting, so do not rely on spaces either way.
  2. Same width. Every tunnel of one label should have the same Data Bits.
  3. Same circuit. Tunnels in main and in a subcircuit with the same label are unrelated.
  4. One driver per label, or tri-state drivers.

How a tunnel works

A tunnel has one connection point, and every tunnel with the same label in a circuit is one net. Here are two tunnels joining an input pin and an output pin, with no wire between them:

circ-tunnel-basic · mainscroll to see all
AYxx
Two tunnels labelled x join the input A and the output Y. In 5.0.0 the output followed the input for both values. CC BY 4.0 · SHA-256 3f420045a664
Describe this circuit

Components: Input pin A; Output pin Y.

  • Input pin A connects to Output pin Y (net A, Y, x).

Download the circuit. A whole full adder can be drawn this way, and it computes the same table as the version with wires: download it, eight rows checked in Logisim 5.0.0.

circ-tunnel-full-adder · mainscroll to see all
BX1CinAABX1CinSN1N2X1N1N2CoutBBCinCinAASSCoutCout
A full adder with every connection made by a tunnel label. CC BY 4.0 · SHA-256 f178f5d4c96a
Describe this circuit

Components: Input pin B; Input pin Cin; Input pin A; Input pin S; Input pin Cout; XOR Gate 1; AND Gate 1; AND Gate 2; XOR Gate 2; OR Gate 1.

  • Input pin B connects to AND Gate 1, XOR Gate 2 (net B).
  • XOR Gate 1 connects to AND Gate 2, XOR Gate 2 (net X1).
  • Input pin Cin connects to XOR Gate 1, AND Gate 2 (net Cin).
  • Input pin A connects to AND Gate 1, XOR Gate 2 (net A).
  • Input pin S connects to XOR Gate 1 (net S).
  • AND Gate 1 connects to OR Gate 1 (net N1).
  • AND Gate 2 connects to OR Gate 1 (net N2).
  • Input pin Cout connects to OR Gate 1 (net Cout).

Attributes

Tunnel attributes
LabelThe connection key. Tunnels with the same label are joined. It is not decoration.
Data BitsThe width of the signal. Keep it equal on every tunnel of the label.
FacingThe direction the tunnel is drawn. It changes the picture only.
Label FontHow the label is drawn.

These attribute names come from the project’s documentation; we have not opened the Properties panel for a tunnel in this guide.

Sending a signal into a subcircuit

Tunnels do not cross a subcircuit boundary. In this circuit the same label x is used in main and inside the subcircuit, and the subcircuit’s output stays undefined:

circ-tunnel-across-subcircuit-wrong · mainscroll to see all
AZxsub
Wrong: the tunnel x in main and the tunnel x inside the subcircuit are different nets. Z is U for both values of A. CC BY 4.0 · SHA-256 a832fd3c00b8
Describe this circuit

Components: Input pin A; Output pin Z; sub 1.

The fix is an input pin inside the subcircuit, with your signal wired to it in the parent:

circ-tunnel-across-subcircuit-right · mainscroll to see all
AZsub
Right: the subcircuit has an input pin X, and main wires A to it. Z follows A. CC BY 4.0 · SHA-256 78f392d98b13
Describe this circuit

Components: Input pin A; Output pin Z; sub 1.

Downloads: wrong and right. For a clock or reset that many parts need, wire it to a pin on each subcircuit; there is no global tunnel. See Subcircuits.

Tunnels and buses

A tunnel can carry a bus. In a file we wrote, a 4-bit tunnel pair joined two 4-bit pins and passed all values. When a tunnel’s width does not match the wire it touches, expect the orange wire and the message described in wire colours. We did not look at the window for a tunnel width mismatch, so we do not show one.

Two tunnels, two drivers

Two tunnels with the same label, both driven, show the value if they agree and E if they disagree (F99, F07):

circ-tunnel-two-drivers · mainscroll to see all
ABYxxx
A and B both drive the label x. When they differ, Y is E. CC BY 4.0 · SHA-256 a7ffc4171bc3
Describe this circuit

Components: Input pin A; Input pin B; Output pin Y.

  • Input pin A connects to Input pin B, Output pin Y (net A, B, Y, x).

Tunnels and Analyze Circuit

If you analyse a circuit that uses tunnels, Logisim says it will compute the truth table instead of an expression; the table and expressions are still shown (F48). See Combinational Analysis.

What a label may contain

In files we wrote, labels starting with a digit (2data), with a space inside (clk out) and with accented letters (données) all connected to themselves (F99). We did not type these in the window. The release notes mention stricter label checks in 5.0.0 for names that are used in generated HDL; they matter if you export HDL, see VHDL and Verilog when that page is available.

Frequently asked questions

Are Logisim tunnel labels case-sensitive?

Yes. In our test, tunnels labelled Data and data did not connect and the output stayed undefined (F99).

Can a tunnel go into a subcircuit?

No. A tunnel in the main circuit and a tunnel with the same label inside a subcircuit are unrelated. Give the subcircuit an input pin and wire your signal to it (F99).

Why is my tunnel wire blue?

Blue means the value is unknown. Usually no tunnel with that label is driven, or the labels differ. See the wire colour guide.

Can two tunnels with the same label both drive a value?

If the two drivers agree the net carries that value. If they disagree the net shows E, an error, and the wire turns red (F99, F07).

Why does Analyze Circuit say it computes a truth table instead of an expression?

Because the circuit uses tunnels. It is a notice, and the table and expressions are still shown (F48).

Sources

  1. Logisim-evolution user guide: Tunnel, Logisim-evolution project, accessed 9 Nov 2026
  2. Tunnel experiments in 5.0.0, logisim.dev lab data: test-data/FINDINGS.md F99; test-data/lab15-2026-11-11-tunnels/

Try: , , ,