Skip to content

Tutorial

This page takes you from nothing to your own design running on an FPGA board. You'll install Logix IDE, open an example that blinks an LED, look at what the tools tell you about it, upload it to your board, and then change it and save it as your own project.

The steps use the iCESugar v1.5 board as the example. They're the same for every one of the supported boards; only the example's details differ.

What you need

  • A computer:

    A Mac with Apple Silicon (M1 or newer) and macOS 11 or newer.

    A 64-bit (x64) PC with Windows 10 or 11.

  • An FPGA board: one of the supported boards, and the USB cable that connects it to your computer. You can follow most of this page without a board; only the upload needs one. You can also add a board that isn't on the list (Your own boards), but that's outside this tutorial.

  • An internet connection: the first time you start Logix IDE.

The steps that differ between macOS and Windows have a tab for each: choose yours once, and every tab on these pages follows.

There's nothing else to install: Logix IDE downloads the FPGA tools it needs.

1. Install Logix IDE

Install Logix IDE as Installing describes: download it, allow it to open, and drag it into the Applications folder.

Install Logix IDE as Installing describes: download the .msi installer, allow it to run, and follow its steps.

2. Start Logix IDE

Open Finder, click Applications in the sidebar and double-click Logix IDE (or press Command-Space, type Logix IDE and press Return). Dragging it into Applications only copied it, so this is its first start.

Open the Start menu and click Logix IDE (or press the Windows key, type Logix IDE and press Enter).

The first time, Logix IDE downloads its FPGA tools, which takes a few minutes. The status bar at the bottom of the window shows the progress, and the output area above it shows what's happening:

Downloading logix-ide-examples 2026.11.12...
Downloaded logix-ide-examples 2026.11.12.
Downloading Logix Engine 2026.11.12...
Downloaded Logix Engine 2026.11.12.
Downloading the FPGA tools. The first time can take a few minutes.
Downloading logix-core 2026.11.11...
Downloaded logix-core 2026.11.11.
117 examples available.
Ready.

When the output says Ready., you can start. Later starts take only a few seconds and work without internet. Logix IDE checks for newer releases of Logix Engine, its FPGA tools and the examples once a day, when you use it, and downloads them by itself; Help > Check for Updates checks now.

The window shows the start screen, with buttons for a new project, an existing project and the examples:

The start screen: New Project, Open Project, Examples and recent projects

3. Connect your board and select it

Connect the board to your computer with its USB cable. Then select it in the board list in the toolbar: type part of its name to find it. The list starts with the boards you've used recently, followed by every board grouped by FPGA family. The iCESugar v1.5 is selected at first.

Next to the board list, Not connected changes to Connected when Logix IDE finds your board on USB.

4. Open the Blinky example

Click Examples… on the start screen. The window lists the examples for your board: select blinky and click New Project.

Blinky opens as a new project. Its files are in tabs above the editor:

  • main.v is the design, written in Verilog. On the iCESugar v1.5 it blinks the RGB LED in green, about once a second. Its comments explain each part.
  • pinout.pcf is the pin file: it says which FPGA pins connect to what on the board, such as the clock and the LED.
  • main_tb.v is a testbench: it checks the design on your computer, without a board.

5. Verify the design

Click Verify Verify button, the first button in the toolbar. Logix IDE checks the design for common errors and builds it. The status bar then says how much of the FPGA the design uses and how fast its clock can run:

Build succeeded in 1.2 s. Uses 1% of logic cells, max clock 79.7 MHz.

If there's an error, Logix IDE marks its line in the editor and the status bar says what's wrong; hover over the mark to read the message. Syntax errors are marked as you type, before you click Verify:

A syntax error marked on line 13, with the message shown on hover

6. Look at the board utilization

Verify's message gives the totals. For the details, choose Project > Board Utilization…: it lists each FPGA resource the design uses, such as logic cells, RAM blocks and I/O pins, with how many the FPGA has, and the design's clocks with their maximum speeds.

The Board Utilization window: the used resources with their descriptions, then the clock

7. See the design as a diagram

Choose Project > Show Diagram. Logix IDE draws the design as a schematic in a window of its own: the counter's register, the adder that counts, and the pins.

The diagram of the blinky design: the clock, the counter and its adder, and the RGB LED's pins

Try it:

  • Hover over a block or a wire to see its details, such as a signal's name and width.
  • Double-click the counter to see its line in main.v.
  • Drag to move the drawing, scroll to zoom, and click Fit to see all of it again.

You can keep the window open while you work: it's drawn again after each Verify. Diagram has more.

8. Run the tests

Click Run Tests Run Tests button. Logix IDE runs the testbench, main_tb.v, which drives the design with a clock and checks that the LED turns on and off when it should. The output says whether each test passed. Run the tests after every change, to make sure the design still works.

9. Simulate the design

Click Simulate Simulate button. Logix IDE runs the testbench too, but instead of a pass or fail result it opens the design's signals in GTKWave, a waveform viewer, in a window of its own.

GTKWave showing a testbench's signals over time: the clock, the counter and the LEDs

Try it:

  • Read the waves: each row on the right is one signal over time, from left to right: the clock ticking, the counter counting up, and the LED turning on and off as the counter's top bit changes.
  • Zoom with the zoom buttons in GTKWave's toolbar, to see single clock cycles or the whole simulation.
  • Add a signal: select the testbench in the tree at the top left, select a signal in the list below it, and click Append.
  • Keep your view: choose File > Write Save File in GTKWave, and the next simulation opens the same way.

Close GTKWave when you're done.

Testbenches and simulation explains both.

10. Upload it to the board

With the board connected, click Upload Upload button, next to Verify. Logix IDE builds the design if it changed and programs the board. A few seconds later the LED starts blinking: on the iCESugar v1.5, the RGB LED blinks green.

No driver is needed: macOS lets Logix IDE program every board as it is.

The iCESugar v1.5 needs no driver. Many other boards, such as those with an FTDI chip, need the WinUSB driver first: the first time, Upload asks to install it. Click Install Driver, then Yes when Windows asks whether Logix Engine may make changes to your device. Installing takes a minute or two, then the upload goes on. See Drivers on Windows.

The design is stored in the board's flash memory, so it runs again whenever the board gets power, even without your computer.

11. Modify the design

Now make it yours. In main.v, the counter's width N sets how fast the LED blinks: each step down doubles the speed. Find this line:

parameter N = 24  // Counter width: 2^24 cycles at 12 MHz is about 1.4 s.

Change 24 to 22 and click Upload. The LED now blinks four times as fast.

12. Save it as your project

Choose File > Save Project and give the project a name. Logix IDE creates a folder for it in your projects folder and lists it under Recent projects on the start screen. The projects folder is, by default:

~/Documents/OpenLogix/IDE

Documents\OpenLogix\IDE in your user folder

13. Explore the boards

Open the board list in the toolbar to see the supported boards, 81 so far, and any boards of your own (Your own boards). The ⓘ button next to the list opens the Board Explorer, with the selected board's facts: its FPGA, what its pins connect to (the clock, LEDs, buttons), how it's programmed, and its examples.

14. Explore the settings

Open the settings to change how Logix IDE works:

Choose Logix IDE > Settings… (Command-,).

Choose File > Settings… (Ctrl+,).

The settings are:

  • Projects folder location: where new projects are saved.
  • Editor font size, Interface scale and Theme (System, Light or Dark).
  • Show the output: when the output area comes back by itself after you hide it.
  • Show lint warnings on Verify: turn it off to skip the design check.
  • Check code while typing: mark syntax errors as you type.

If something goes wrong

Problem What to do
macOS says Logix IDE can't be opened Run the xattr -c command from Installing again, then install it again.
Windows says "Windows protected your PC" Click More info, then Run anyway: Logix IDE isn't signed yet.
On Windows, Upload says the board needs a driver Click Install Driver, then Yes in Windows' prompt. See Drivers on Windows.
The FPGA tools don't download A red bar shows the problem. Check your internet connection and click Retry.
Upload can't find the board Check that Connected shows next to the board list, and try another USB cable: some cables only charge.
Your board isn't in the list It isn't supported yet. To ask for it, choose Help > Report a Problem.

Troubleshooting covers these and more.

Next steps

  • Take the tour of the window: the toolbar, the files of a project and what each part does.
  • Open more examples with File > Examples…, such as rgb-led on the iCESugar v1.5.
  • Look up menus, keyboard shortcuts and settings in Using Logix IDE.