Tunnels that do not connect: the checks
Show all paths
- 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
- 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
- What colour is the wire at the receiving tunnel? Orange → Make the Data Bits equal
- What colour is the wire at the receiving tunnel? Red → Two drivers disagree
- 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:
- 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.
- Same width. Every tunnel of one label should have the same Data Bits.
- Same circuit. Tunnels in
mainand in a subcircuit with the same label are unrelated. - 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:
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.
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
| Label | The connection key. Tunnels with the same label are joined. It is not decoration. |
|---|---|
| Data Bits | The width of the signal. Keep it equal on every tunnel of the label. |
| Facing | The direction the tunnel is drawn. It changes the picture only. |
| Label Font | How the label is drawn. |
No rows match.
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:
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:
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):
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.