Menu

Theme

Component reference · Reference · CHECKED ON 5.0.0

The Logisim splitter: split a bus into bits, or join bits into a bus

A splitter connects one multi-bit wire (the combined end) to several narrower wires (the fan-out ends). Set Bit Width In to the bus width and Fan Out to the number of ends; by default the bits are shared out in order, lowest bits on the first end, so an 8-bit bus with Fan Out 2 gives bits 0 to 3 on the first end and 4 to 7 on the second (F11). It works in both directions, so the same component also joins wires into a bus.
FOR
Anyone working with buses
CHECKED
11 Nov 2026
Checked against Logisim-evolution 5.0.0 on 1 machines
On this page

Set a splitter and see where each bit goes

8 bits0: 0-31: 4-7
East facing, spacing 1. End 0 is the top end for this appearance.
What each end carries for the value you typed
EndBitsValue
End 00-30010 (0x2)
End 14-70001 (0x1)
Per-bit mapping (bit 0 is the least significant bit)
BitGoes toBit value
0
1
0
0
1
0
0
0
Attributes Logisim stores for this splitter
fanout="2"
incoming="8"
bit0="0"
bit1="0"
bit2="0"
bit3="0"
bit4="1"
bit5="1"
bit6="1"
bit7="1"

Splitters work in both directions: the same mapping joins the ends back into one bus. Changing Fan Out or Bit Width In in Logisim resets the mapping, as it does here. The drawing and the demo file use the default facing (east) and spacing 1.

What a splitter does

A splitter has one combined end and several fan-out ends. A value on the combined end is cut into groups of bits, one group per end. The component is bidirectional: the same mapping carries values from the ends back into the combined end.

circ-splitter-8-to-4-4 · mainscroll to see all
8448bDe0e04bLoe1e14bHi
An 8-bit input D split into Lo (end 0) and Hi (end 1). The first end gets the lowest bits (F11). CC BY 4.0 · SHA-256 df434da69fa1
Describe this circuit

Components: Input pin D; Splitter 1; Output pin Lo; Output pin Hi.

  • Input pin D connects to Splitter 1 (net D), 8 bits wide.
  • Splitter 1 connects to Output pin Lo (net e0, Lo), 4 bits wide.
  • Splitter 1 connects to Output pin Hi (net e1, Hi), 4 bits wide.
Rows from our test vector (27 rows, 0x00 to 0x1A, all passed in 5.0.0).
#DLoHi
0x000x00x0
0x010x10x0
0x0F0xF0x0
0x100x00x1
0x120x20x1
0x1A0xA0x1

Download circ-splitter-8-to-4-4.circ.

Set it up in three attributes

  1. Bit Width In: the width of the bus on the combined end.
  2. Fan Out: the number of ends.
  3. Bit 0 to Bit n-1: for each bit, which output it goes to, or None. Leave the default for an even split.
Attribute What it does
Facing Which way the ends point.
Fan Out Number of ends, 1 to 64.
Bit Width In Width of the combined end, 1 to 64.
Appearance Left-handed, Right-handed, Centered or Legacy: where the ends sit relative to the combined end.
Spacing Distance between ends. Only changes the drawing.
Bit x The end that bit x goes to (Output n), or None. Distribute Ascending and Distribute Descending are menu shortcuts for the mapping.

The attribute and option names are the ones in the 5.0.0 string table (F73). Ours are the explanations.

Which bit goes to which end

Bit 0 is the least significant bit. With the default mapping, end 0 carries the lowest bits.

Pick out one bit

Fan Out equal to Bit Width In gives one bit per end, and end i carries bit i.

circ-splitter-8-to-1x8 · mainscroll to see all
88bDe0e0B0e1e1B1e2e2B2e3e3B3e4e4B4e5e5B5e6e6B6e7e7B7
Fan Out 8 on an 8-bit bus: end i is bit i. Tested with 11 values in 5.0.0. CC BY 4.0 · SHA-256 3fe8844de29a
Describe this circuit

Components: Input pin D; Splitter 1; Output pin B0; Output pin B1; Output pin B2; Output pin B3; Output pin B4; Output pin B5; Output pin B6; Output pin B7.

  • Input pin D connects to Splitter 1 (net D), 8 bits wide.
  • Splitter 1 connects to Output pin B0 (net e0, B0).
  • Splitter 1 connects to Output pin B1 (net e1, B1).
  • Splitter 1 connects to Output pin B2 (net e2, B2).
  • Splitter 1 connects to Output pin B3 (net e3, B3).
  • Splitter 1 connects to Output pin B4 (net e4, B4).
  • Splitter 1 connects to Output pin B5 (net e5, B5).
  • Splitter 1 connects to Output pin B6 (net e6, B6).
  • Splitter 1 connects to Output pin B7 (net e7, B7).

Join wires into a bus (the opposite of a splitter)

Wire single bits into the ends and take the bus from the combined end. The ends’ order is the bit order.

circ-splitter-join-4-to-1 · mainscroll to see all
4I0i0i0I1i1i1I2i2i2I3i3i34bQ
Four 1-bit pins joined into a 4-bit bus, with the splitter facing west so the ends are on the left. All 16 combinations passed in 5.0.0 and, in the classic-format twin, in the 5.0.0 reader. CC BY 4.0 · SHA-256 ea125eb1f44a
Describe this circuit

Components: Splitter 1; Input pin I0; Input pin I1; Input pin I2; Input pin I3; Output pin Q.

  • Splitter 1 connects to Output pin Q (net Q), 4 bits wide.
  • Splitter 1 connects to Input pin I0 (net I0, i0).
  • Splitter 1 connects to Input pin I1 (net I1, i1).
  • Splitter 1 connects to Input pin I2 (net I2, i2).
  • Splitter 1 connects to Input pin I3 (net I3, i3).

Custom mapping: uneven groups and skipped bits

A 16-bit instruction word cut into fields. OP takes bits 12 to 15, RD bits 9 to 11, RS bits 6 to 8 and IMM bits 0 to 4. Bit 5 is set to None, so it goes nowhere.

circ-splitter-instruction-fields · mainscroll to see all
16433516bIe0e04bOPe1e13bRDe2e23bRSe3e35bIMM
Custom mapping with uneven groups and one skipped bit. Twelve instruction words passed in 5.0.0. CC BY 4.0 · SHA-256 17c20803bee7
Describe this circuit

Components: Input pin I; Splitter 1; Output pin OP; Output pin RD; Output pin RS; Output pin IMM.

  • Input pin I connects to Splitter 1 (net I), 16 bits wide.
  • Splitter 1 connects to Output pin OP (net e0, OP), 4 bits wide.
  • Splitter 1 connects to Output pin RD (net e1, RD), 3 bits wide.
  • Splitter 1 connects to Output pin RS (net e2, RS), 3 bits wide.
  • Splitter 1 connects to Output pin IMM (net e3, IMM), 5 bits wide.

Download circ-splitter-instruction-fields.circ.

Bit Extender: widening a value

The Bit Extender (Wiring library) has attributes Bit Width In, Bit Width Out and Extension Type: Zero, One, Sign or Input (strings in the 5.0.0 table). Our circuit widens 8 bits to 16 three ways:

Rows from our test vector (8 rows, all passed in 5.0.0). The Input type adds a separate input; we did not test it.
#DZeroOneSign
0x000x00000xff000x0000
0x700x00700xff700x0070
0x800x00800xff800xff80
0xF00x00f00xfff00xfff0
0xFF0x00ff0xffff0xffff

Use Sign to extend a signed immediate (“logisim sign extend”): the top bit is copied into the new bits. Use Zero for unsigned values. Download circ-splitter-bit-extender.circ.

When the wires turn orange

Incompatible widths

Canvas status line, orange wire

The wire is orange when two widths meet. With a splitter the usual causes are: Bit Width In not equal to the bus; an end carrying several bits wired to a 1-bit pin; and an end whose width changed after you changed Fan Out. See wire colours for the full fix (F09).

Common mistakes

Check these0 / 6 done

Splitter in classic 2.7.1 and older Evolution

Feature2.7.15.0.0
Fan Out and Bit Width In attributes2.7.1: untestedsame names in classic files5.0.0: yesfanout and incoming (F84)
Default ports of a 2-end splitter2.7.1: yescombined end (0,0), ends (20,-20) and (20,-10)5.0.0: yesidentical (F23)
Maximum width2.7.1: partial32 bits, per the documentation5.0.0: partial64 bits, per the documentation
Appearance options2.7.1: untested5.0.0: yesLeft-handed, Right-handed, Centered, Legacy

Cells say untested where we have no 2.7.1 capture. See also Tunnel for labelling a bus instead of drawing it, and all components.

Frequently asked questions

What does a splitter do in Logisim?

It joins one multi-bit wire to several narrower wires. Used one way it splits a bus into bits; used the other way it combines wires into a bus.

Which end of the splitter is bit 0?

With the default mapping, the first end carries the lowest bits, so end 0 holds bit 0, the least significant bit. In our 8 to 2 test, input 0x12 gave 0010 on end 0 and 0001 on end 1 (F11).

How do I combine single wires into a bus in Logisim?

Use the same splitter the other way: wire each single bit into an end and take the bus from the combined end. End i supplies bit i.

How do I get one bit out of a multi-bit wire?

Set Bit Width In to the bus width and Fan Out to the same number, so each end carries one bit, then use the end you need.

Why does changing Fan Out reset my bit mapping?

Logisim rebuilds the default mapping when Fan Out or Bit Width In changes, according to the project's issue tracker. Set those two first, then customise the bits. We did not test the reset in the window.

Splitter or Bit Extender: which do I need to sign-extend a value?

A Bit Extender. Set Extension Type to Sign. In our test 0x80 became 0xff80 and 0x70 stayed 0x0070.

Why are my splitter wires orange?

A width does not match: the splitter's Bit Width In differs from the bus, or an end carrying several bits feeds a 1-bit pin. Match the widths.

Sources

  1. Splitter tests on Logisim-evolution 5.0.0, logisim.dev lab data: test-data/lab1-2026-11-09-linux-local/logs/splitter.txt, scripts/qa_splitter.mjs, src/content/circuits/circ-splitter-*
  2. Measured splitter ports, logisim.dev lab data: src/content/port-variants-le500.json (Wiring|Splitter, 328 variants)

Try: , , ,