Metadata-Version: 2.1
Name: litex-boards
Version: 2025.12
Summary: LiteX supported boards
Home-page: http://enjoy-digital.fr
Download-URL: https://github.com/litex-hub/litex-boards
Author: Florent Kermarrec
Author-email: florent@enjoy-digital.fr
License: BSD
Keywords: HDL ASIC FPGA hardware design
Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
Classifier: Environment :: Console
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: litex


                                  __   _ __      _  __    ___                   __
                                 / /  (_) /____ | |/_/___/ _ )___  ___ ________/ /__
                                / /__/ / __/ -_)>  </___/ _  / _ \/ _ `/ __/ _  (_-<
                               /____/_/\__/\__/_/|_|   /____/\___/\_,_/_/  \_,_/___/

                                              LiteX boards files

                                     Copyright 2012-2025 / LiteX-Hub community

[![](https://github.com/litex-hub/litex-boards/workflows/ci/badge.svg)](https://github.com/litex-hub/litex-boards/actions) ![License](https://img.shields.io/badge/License-BSD%202--Clause-orange.svg) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/litex-hub/litex-boards)

[> Intro
--------
<figure>
<p align="center">
<img src="https://user-images.githubusercontent.com/1450143/88511626-73792100-cfe5-11ea-8d3e-dbeea6314e15.JPG">
</p>
<figcaption>
<p align="center">
From the very tiny Fomu to large PCIe accelerator boards....
</p>
</figcaption>
</figure>

This repository contains the platforms/targets currently supported by LiteX:

- The platform provides the definition of the board: IOs, constraints, clocks, components + methods to load and flash the bitstream to it.
- The target provides a LiteX base design for the board that allows you to create a SoC (with or without a CPU) and integrate easily all the base components of your board: Ethernet, DRAM, PCIe, SPIFlash, SDCard, Leds, GPIOs, etc...

The targets can be used as a base to build more complex or custom SoCs. They are for example directly reused by the [Linux-on-LiteX-VexRiscv](https://github.com/litex-hub/linux-on-litex-vexriscv) project that is just using a specific configuration (Linux-capable CPU, additional peripherals). Basing your design on provided targets helps reduce code duplication between various projects.

First make sure to install LiteX correctly by following the [installation guide](https://github.com/enjoy-digital/litex/wiki/Installation) and have a look at the [LiteX's wiki](https://github.com/enjoy-digital/litex/wiki) for [tutorials](https://github.com/enjoy-digital/litex/wiki/Tutorials-Resources),  [examples of projects](https://github.com/enjoy-digital/litex/wiki/Projects) and more information to use/build FPGA designs with it.

Each target provides a default configuration with a CPU, ROM, SRAM, UART, DRAM (if available), Ethernet (if available), etc... that can be simply built and loaded to the FPGA with:

    $ python3 -m litex_boards.targets.<board> --build --load

You can then open a terminal on the main UART of the board and interact with the LiteX BIOS:

<p align="center"><img src="https://raw.githubusercontent.com/enjoy-digital/litex/master/doc/bios_screenshot.png"></p>

**Build/Compilation behavior:**
- python3 -m litex_boards.targets.board : Test LiteX/Migen syntax but does not generate anything.
- Add `--build` to generate the SoC/Software headers and run the Software/Gateware compilation.
- Add `--no-compile` to disable the Software/Gateware compilation.
- Add `--no-compile-software` to disable the Software compilation.
- Add `--no-compile-gateware` to disable the Gateware compilation.

But this is just the starting point to create your own hardware! You can then:

- Change the CPU: add `--cpu-type=lm32, microwatt, serv, rocket, etc... `
- Change the Bus standard: add `--bus-standard=wishbone, axi-lite`
- Enable components: add `--with-ethernet --with-etherbone --with-sdcard etc...`
- [Load application code to the CPU](https://github.com/enjoy-digital/litex/wiki/Load-Application-Code-To-CPU) over UART/Ethernet/SDCard, etc...
- Create a bridge with your computer to easily [access the main bus of your SoC](https://github.com/enjoy-digital/litex/wiki/Use-Host-Bridge-to-control-debug-a-SoC).
- Add a Logic Analyzer to your SoC to easily [observe/debug your design](https://github.com/enjoy-digital/litex/wiki/Use-LiteScope-To-Debug-A-SoC).
- Simulate your SoC and interact with it at decent speed with [LiteX Sim](https://github.com/enjoy-digital/litex/blob/master/litex/tools/litex_sim.py)/Verilator.
- Integrate external cores/CPU to create your own design.
- etc...

Please use `python3 -m litex_boards.targets.<board> --help` to see the various pre-built possibilities.

Hoping you will find this useful and enjoy it, please contribute back if you make improvements that could be useful to others or find issues!

**A question or want to get in touch? Our IRC channel is [#litex at irc.libera.chat](https://web.libera.chat/#litex)**


[> Supported boards
-------------------

LiteX-Boards currently supports > 150 boards from very various FPGA Vendors (Xilinx, Intel, Lattice, Efinix, Gowin, etc...)!
Some of these boards are fully open-hardware boards (Fomu, NeTV2, OrangeCrab, Butterstick, etc...) with FPGAs often supported by the open-source toolchains, some of them are repurposed off-the-shelf hardware (Colorlight 5A/I5/I9, SQRL Acorn CLE 215+, FK33, Siglent SDS1104X-E, Decklink Mini 4k, etc...) and we also of course support popular/regular FPGA dev boards :)


Most of the peripherals present are generally supported: DRAM, UART, Ethernet, SPI-Flash, SDCard, PCIe, SATA, etc... making LiteX-Boards' targets hopefully a good base infrastructure to create your own custom SoCs!

> **Note:** All boards with >= 32MB of memory and enough logic can be considered as Linux Capable, have a look at [Linux-on-LiteX-Vexriscv](https://github.com/litex-hub/linux-on-litex-vexriscv) project to try Linux on your FPGA board!


<figure>
<p align="center">
<img src="https://user-images.githubusercontent.com/1450143/156173620-355c6f1d-87dc-4dda-be45-910bf379ae9a.jpg">
</p>
<figcaption>
<p align="center">
Some of the supported boards, see yours? Give LiteX-Boards a try!
</p>
</figcaption>
</figure>

[> Boards list
---------------
    ├── adi_adrv2crr_fmc
    ├── adi_plutosdr
    ├── alchitry_au
    ├── alchitry_au_v2
    ├── alchitry_cu
    ├── alchitry_mojo
    ├── alchitry_pt_v2
    ├── alibaba_vu13p
    ├── alibaba_xcku3p
    ├── alientek_davincipro
    ├── aliexpress_xc7k420t
    ├── aliexpress_xc7k70t
    ├── alinx_ax7010
    ├── alinx_ax7020
    ├── alinx_ax7203
    ├── alinx_axau15
    ├── alinx_axu2cga
    ├── analog_pocket
    ├── antmicro_artix_dc_scm
    ├── antmicro_datacenter_ddr4_test_board
    ├── antmicro_lpddr4_test_board
    ├── antmicro_sdi_mipi_video_converter
    ├── arduino_mkrvidor4000
    ├── arrow_axe5000
    ├── avnet_aesku40
    ├── berkeleylab_marble
    ├── berkeleylab_obsidian
    ├── bochenjingxin_kintex7_basec
    ├── camlink_4k
    ├── colognechip_gatemate_evb
    ├── colorlight_5a_75x
    ├── colorlight_i5
    ├── colorlight_i9plus
    ├── decklink_intensity_pro_4k
    ├── decklink_mini_4k
    ├── decklink_quad_hdmi_recorder
    ├── digilent_arty
    ├── digilent_arty_s7
    ├── digilent_arty_z7
    ├── digilent_atlys
    ├── digilent_basys3
    ├── digilent_cmod_a7
    ├── digilent_genesys2
    ├── digilent_netfpga_sume
    ├── digilent_nexys4
    ├── digilent_nexys4ddr
    ├── digilent_nexys_video
    ├── digilent_pynq_z1
    ├── digilent_zedboard
    ├── ebaz4205
    ├── efinix_t8f81_dev_kit
    ├── efinix_ti375_c529_dev_kit
    ├── efinix_titanium_ti60_f225_dev_kit
    ├── efinix_trion_t120_bga576_dev_kit
    ├── efinix_trion_t20_bga256_dev_kit
    ├── efinix_trion_t20_mipi_dev_kit
    ├── efinix_tz170_j484_dev_kit
    ├── efinix_xyloni_dev_kit
    ├── ego1
    ├── embedfire_rise_pro
    ├── enclustra_mercury_kx2
    ├── enclustra_mercury_xu5
    ├── enclustra_mercury_xu8_pe3
    ├── fairwaves_xtrx
    ├── fpc_iii
    ├── fpgawars_alhambra2
    ├── gadgetfactory_papilio_pro
    ├── gsd_butterstick
    ├── gsd_orangecrab
    ├── hackaday_hadbadge
    ├── hseda_xc7a35t
    ├── hyvision_pcie_opt01_revf
    ├── ice_v_wireless
    ├── icebreaker
    ├── icebreaker_bitsy
    ├── icepi_zero
    ├── intergalaktik_ulx5m_gs
    ├── isx_im1283
    ├── jungle_electronics_fireant
    ├── kosagi_fomu
    ├── kosagi_netv2
    ├── krtkl_snickerdoodle
    ├── lambdaconcept_ecpix5
    ├── lattice_certuspro_nx_evn
    ├── lattice_certuspro_nx_versa
    ├── lattice_certuspro_nx_vvml
    ├── lattice_crosslink_nx_evn
    ├── lattice_crosslink_nx_vip
    ├── lattice_ecp5_evn
    ├── lattice_ecp5_vip
    ├── lattice_ice40up5k_evn
    ├── lattice_versa_ecp5
    ├── lckfb_ljpi
    ├── limesdr_mini_v2
    ├── linsn_rv901t
    ├── litex_acorn_baseboard
    ├── litex_acorn_baseboard_mini
    ├── logicbone
    ├── machdyne_kolsch
    ├── machdyne_konfekt
    ├── machdyne_kopflos
    ├── machdyne_krote
    ├── machdyne_lakritz
    ├── machdyne_minze
    ├── machdyne_mozart_ml1
    ├── machdyne_mozart_ml2
    ├── machdyne_mozart_mx1
    ├── machdyne_mozart_mx2
    ├── machdyne_noir
    ├── machdyne_schoko
    ├── machdyne_vanille
    ├── machdyne_vivaldi_ml1
    ├── micronova_mercury2
    ├── microphase_a7_lite
    ├── microsoft_catapult_v3
    ├── mist
    ├── mlkpai_fs01_dr1v90m
    ├── mnt_rkx7
    ├── muselab_icesugar
    ├── muselab_icesugar_pro
    ├── myir_myc_j7a100t
    ├── myminieye_runber
    ├── newae_cw305
    ├── numato_aller
    ├── numato_mimas_a7
    ├── numato_nereid
    ├── numato_tagus
    ├── ocp_tap_timecard
    ├── olimex_gatemate_a1_evb
    ├── opalkelly_xem8320
    ├── opensourcesdrlab_kintex7
    ├── pano_logic_g2
    ├── puzhi_p7_starlite
    ├── puzhi_pz_a7xxt_kfb
    ├── qmtech_10cl006
    ├── qmtech_5cefa2
    ├── qmtech_5cefa5
    ├── qmtech_artix7_fbg484
    ├── qmtech_artix7_fgg676
    ├── qmtech_cyclone10_starterkit
    ├── qmtech_ep4ce15_starter_kit
    ├── qmtech_ep4cex5
    ├── qmtech_ep4cgx150
    ├── qmtech_kintex7_devboard
    ├── qmtech_wukong
    ├── qmtech_xc7a35t
    ├── qmtech_xc7k325t
    ├── quicklogic_quickfeather
    ├── qwertyembedded_beaglewire
    ├── radiona_ulx3s
    ├── radiona_ulx4m_ld_v2
    ├── radiona_ulx4m_ls_v2
    ├── rcs_arctic_tern_bmc_card
    ├── redpitaya
    ├── rz_easyfpga
    ├── saanlima_pipistrello
    ├── scarabhardware_minispartan6
    ├── seeedstudio_spartan_edge_accelerator
    ├── siglent_sds1104xe
    ├── signaloid_c0_microsd
    ├── simple
    ├── sipeed_slogic16u3
    ├── sipeed_tang_console
    ├── sipeed_tang_mega_138k
    ├── sipeed_tang_mega_138k_pro
    ├── sipeed_tang_nano
    ├── sipeed_tang_nano_20k
    ├── sipeed_tang_nano_4k
    ├── sipeed_tang_nano_9k
    ├── sipeed_tang_primer
    ├── sipeed_tang_primer_20k
    ├── sipeed_tang_primer_25k
    ├── sitlinv_a_e115fb
    ├── sitlinv_stlv7325_v1
    ├── sitlinv_stlv7325_v2
    ├── sitlinv_xc7k420t
    ├── sqrl_acorn
    ├── sqrl_fk33
    ├── sqrl_xcu1525
    ├── terasic_de0nano
    ├── terasic_de10lite
    ├── terasic_de10nano
    ├── terasic_de1soc
    ├── terasic_de2_115
    ├── terasic_deca
    ├── terasic_sockit
    ├── tinyfpga_bx
    ├── trellisboard
    ├── trenz_c10lprefkit
    ├── trenz_cyc1000
    ├── trenz_max1000
    ├── trenz_te0725
    ├── trenz_te0890
    ├── trenz_tec0117
    ├── tul_pynq_z2
    ├── xilinx_ac701
    ├── xilinx_alveo_u200
    ├── xilinx_alveo_u250
    ├── xilinx_alveo_u280
    ├── xilinx_kc705
    ├── xilinx_kcu105
    ├── xilinx_kcu116
    ├── xilinx_kv260
    ├── xilinx_sp605
    ├── xilinx_vc707
    ├── xilinx_vcu118
    ├── xilinx_vcu128
    ├── xilinx_zc706
    ├── xilinx_zcu102
    ├── xilinx_zcu104
    ├── xilinx_zcu106
    ├── xilinx_zcu216
    ├── xilinx_zybo_z7
    ├── ypcb_00338_1p1
    └── ztex213
