Menu

Theme

Advanced features · How-to · CHECKED ON 5.0.0

Run your Logisim circuit on an FPGA board

Logisim FPGA support turns a circuit into VHDL or Verilog, maps its inputs and outputs to a board's switches and LEDs, and can call the vendor's tools to program the board. 31 boards are built into 5.0.0 and you can add others. Choose FPGA, Synthesize & Download…, pick the board and map every input and output; without the mapping Logisim stops with Not all IO components have been mapped to the board. We have no board and no vendor software, so we tested everything up to HDL generation and describe the rest from documentation.
FOR
Students whose course pairs Logisim-evolution with an FPGA board · Logisim-evolution 5.0.0
CHECKED
12 Nov 2026
Checked against Logisim-evolution 5.0.0 on 1 machines
On this page

What you need

Before you start0 / 4 done

Supported boards

The 5.0.0 jar contains these 31 board definitions (F51). The resources are what Logisim itself listed when we ran --test-fpga with HDLONLY on a full adder for each board (F109). Each run reached the same stop (exit code 255) because nothing was mapped. No row means a board was programmed: we have none. The command line uses the same names (command line).

Board definitions in Logisim-evolution 5.0.0
ALCHITRY_AU_IO6 buttons, 3 dip switches, 32 LEDs, 1 7-segment (scanning)Reached the mapping stop
ARROW_SOCKIT8 buttons, 4 LEDsReached the mapping stop
BASYS234 pins, 12 buttons, 16 LEDsReached the mapping stop
BASYS351 pins, 21 buttons, 28 LEDsReached the mapping stop
BEMICRO_SDK4 buttons, 8 LEDsReached the mapping stop
CYCLOARDUINO28 pins, 11 buttons, 10 LEDsReached the mapping stop
CYCLONE_V_GX_STARTER2 pins, 13 buttons, 18 LEDs, 4 7-segmentReached the mapping stop
DE0_CV5 port i/o, 15 buttons, 10 LEDs, 6 7-segmentReached the mapping stop
DIGILENT_CMOD_A7_15T54 port i/o, 2 buttons, 1 rgb leds, 2 LEDsReached the mapping stop
DIGILENT_SPARTAN_3E_STARTER2 pins, 9 buttons, 8 LEDsReached the mapping stop
EPM2525_CONSOLE5 pins, 10 buttons, 16 LEDsReached the mapping stop
EPM2525_FULL2 port i/o, 14 pins, 1 buttonsReached the mapping stop
FPGA4U20 buttons, 100 LEDsReached the mapping stop
GECKO4LED6 buttons, 3 rgb leds, 1 dip switches, 64 LEDs, 3 7-segmentReached the mapping stop
GECKO4_EDUCATION1 led arrays, 77 pins, 10 buttons, 2 dip switches, 4 7-segmentReached the mapping stop
GECKO4_EDUCATION_EPFL_EDITION1 led arrays, 80 pins, 8 buttons, 2 dip switches, 2 LEDs, 4 7-segmentReached the mapping stop
GECKO5_EDUCATION1 led arrays, 16 pins, 11 buttons, 1 dip switches, 1 7-segment (scanning)Reached the mapping stop
LEGUAN1 led arrays, 40 pins, 12 buttons, 2 dip switches, 4 7-segmentReached the mapping stop
MAX1000-8k-BOARD15 pins, 8 LEDsReached the mapping stop
MAX_V_80P_25P3 port i/o, 6 pins, 12 buttons, 1 rgb leds, 1 dip switches, 8 LEDs, 1 7-segmentReached the mapping stop
MAX_V_CONSOLE2 port i/o, 6 pins, 21 buttons, 1 rgb leds, 1 dip switches, 24 LEDs, 1 7-segmentReached the mapping stop
MICROLABTLE3 buttons, 8 LEDsReached the mapping stop
REPTAR_SPARTAN_61 local bus, 1 port i/o, 7 pins, 9 buttons, 1 dip switches, 8 LEDs, 3 7-segmentReached the mapping stop
ROBOTCYCLONEFPGA16 pins, 11 buttons, 10 LEDsReached the mapping stop
SLO_MAX7000S82 pins, 23 buttons, 28 LEDsReached the mapping stop
TERASIC_DE01 port i/o, 14 buttons, 10 LEDs, 4 7-segmentReached the mapping stop
TERASIC_DE0_NANO2 buttons, 8 LEDsReached the mapping stop
TERASIC_DE10_LITE1 led arrays, 7 port i/o, 19 pins, 2 buttons, 1 dip switches, 6 7-segmentReached the mapping stop
TERASIC_DE10_NANO6 buttons, 8 LEDsReached the mapping stop
TERASIC_DE1_SOC2 port i/o, 6 7-segment (no dp), 14 buttons, 10 LEDsReached the mapping stop
ZYBO58 pins, 8 buttons, 4 LEDsReached the mapping stop

The Synthesize & Download window

The FPGA menu has two items: FPGA Board Editor and Synthesize & Download…. The second opens this window (F109):

LAB lab-lnx · Linux lab5.0.02026-11-12

The Synthesize and Download window: Clock settings with Frequency 1.0 Hz and Divider value 1, Annotation method with an Annotate button, Action method with Toplevel main, the action Generate HDL only and an Execute button, a Target board list showing BASYS2 with its picture blurred, a Settings button, a button Select Xilinx's software and a progress bar reading Idle.

FPGA, Synthesize & Download… in 5.0.0 with no vendor software chosen: the action list holds only Generate HDL only. The board picture is blurred. Linux lab (F109).lab-lnx-le500-fpga-01
The Synthesize and Download window: clock settings, annotation, Generate HDL only, Execute, target board BASYS2.

It has clock settings (frequency and a divider value), an annotation method, an action method with the top-level circuit, a target board, a button to choose the vendor software, and a progress bar with Infos, Warnings, Errors and Console tabs. With no vendor software chosen, the action list had one entry: Generate HDL only.

Settings

File, Preferences, FPGA Commander Settings holds the workspace location, the language used for generated HDL (VHDL by default), the list of external boards and the colours:

LAB lab-lnx · Linux lab5.0.02026-11-12

The FPGA Commander Settings tab of Preferences: Workspace location, Hardware description language VHDL, Use upper case for VHDL keywords ticked, an empty External FPGA Board list with Add a board and Remove selected board, two DRC suppress checkboxes, and colour settings for the board editor and board map.

File, Preferences, FPGA Commander Settings in 5.0.0, Linux lab (F109). There are no fields for Vivado or Quartus folders here.lab-lnx-le500-fpga-02
FPGA Commander Settings tab of Preferences: workspace location, HDL language, upper-case keywords, board list.

That tab has no field for a Vivado or Quartus folder. In the Synthesize window the board’s vendor software is chosen with the button below the board picture (it read “Select Xilinx’s software” for a Xilinx board). We did not press it, so we do not know what it asks for.

Prepare and map your design

  1. Prepare the circuit

    Pins become the board’s switches and LEDs. Label them, as in the pins guide.

    Check: Inputs and outputs are labelled; a top-level circuit exists.

  2. Open FPGA, Synthesize & Download…

    Pick the target board and the top-level circuit. The annotation method labels components that have no label or an invalid one.

    Check: The window above opens.

  3. Press Execute

    On our unmapped full adder, Execute built the netlist, ran the design rule check, listed the board’s resources and opened a window with the unmapped components /A#0, /B#0, /Cin#0, /Cout#0 and /S#0.

    Check: The mapping window opens when anything is unmapped.

  4. Map and save

    The window has Load Map, Save Map, Cancel and Done buttons. We did not map components, because the window is wider than our test screen. Save the project afterwards so the mapping is stored.

    Check: The mapped list holds every component; the file is saved.

LAB lab-lnx · Linux lab5.0.02026-11-12

The mapping window opened by Execute: a list Unmapped Components with /A#0, /B#0, /Cin#0, /Cout#0 and /S#0, an empty list Mapped Components and buttons on the right. Behind it the Synthesize window is greyed out and the Infos tab lists the netlist steps. The board picture is blurred.

Pressing Execute on a circuit with nothing mapped opens the mapping window, 5.0.0 on the Linux lab (F109). The window is wider than our 1280 pixel screen, so its right side is cut off.lab-lnx-le500-fpga-03
The FPGA mapping window: a list of unmapped components, an empty mapped list and buttons on the right.

Common errors

Errors
Not all IO components have been mapped to the board “BASYS3”; please map all components to continue!Map every input and output and save the file. From the command line this exits with 255.Tested (F51)
There is no current hw_targetReported by users of Vivado with a Basys 3: the programming cable or its driver is not seen. Check the cable, the driver and the vendor tool's hardware manager.Community report, not reproduced
VHDL compile errors in Quartus PrimeReported on the project's issue tracker. We did not run Quartus, so we cannot say whether 5.0.0 still shows them.Community report, not reproduced
RAM or buses behave differently on hardwareReported as upstream issues. Check on a small design first.Community report, not reproduced

Add your own board

The FPGA Board Editor is in the FPGA menu, and Preferences, FPGA Commander Settings has an External FPGA Board list with Add a board and Remove selected board (F109). We did not open the editor, so we give no steps. See the project’s documentation on adding a board.

Generate HDL only (no board needed)

This is the part we tested. Choose Generate HDL only in the window, or run:

Terminal
java -jar logisim-evolution-5.0.0-all.jar --test-fpga full-adder.circ main BASYS3 HDLONLY
Output: Building netlist for sheet “main”
Output: Circuit “main” has 8 nets and 0 buses.
Output: Circuit “main” passed DRC check.
Output: The Board BASYS3 has:
Output: 51 Pin(s)
Output: 21 Button(s)
Output: 28 Led(s)
Output: Not all IO components have been mapped to the board “BASYS3”; please map all components to continue!
exit: 255

A board must be chosen and every input and output mapped and saved first (F51). We did not run it on a mapped file, so we do not say where the HDL files are written. See VHDL and Verilog and the command line.

Limits

We did not test which components export to HDL, simulation against hardware differences, macOS or any vendor tool. We hold no board photos and show none: the board picture in our screenshots is blurred.

Frequently asked questions

Can Logisim program an FPGA?

Logisim-evolution can generate HDL and has a Synthesize & Download window that calls vendor software. We could not test the programming step: we have no board and installed no vendor tool.

Which FPGA boards does Logisim-evolution support?

31 board definitions are inside the 5.0.0 jar, including BASYS3, TERASIC_DE10_LITE, DE0_CV and ZYBO. The table on this page lists them (F51, F109).

Do I need Vivado or Quartus?

Not to generate HDL: with no vendor software chosen the action list offers Generate HDL only (F109). To synthesise and download you need the vendor tool for your board.

How do I fix no current hw_target?

This is a community-reported Vivado message about the programming cable or driver. We could not reproduce it without a board.

Can I add a board that is not in the list?

Yes, with the FPGA Board Editor in the FPGA menu, and Preferences has an External FPGA Board list with Add a board. We did not test either (F109).

Does it work on a Mac?

We did not test FPGA features on macOS. HDL-only generation needs no vendor software, so it is the part to try first.

Sources

  1. Logisim-evolution documentation and releases, Logisim-evolution project, accessed 9 Nov 2026
  2. Board list and the unmapped-I/O stop, logisim.dev lab data: test-data/FINDINGS.md F51; test-data/lab2-2026-11-09-components/fpga/
  3. FPGA window, Preferences tab and per-board resources, logisim.dev lab data: test-data/lab18-2026-11-12-fpga/ (F109)

Try: , , ,