Skip to content

About

NixOS hardware support for FPGA and SoC-FPGA boards

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

nixos-fpga

NixOS hardware support for FPGA and SoC-FPGA boards, in the spirit of nixos-hardware.

These boards need things nixos-hardware doesn't handle:

  • Vendor kernel forks that Hydra never builds. This repo builds them in CI and serves them from its own binary cache.
  • Vendored boot blobs, each with documented provenance.
  • SD-card boot chains, which have to hand a vendor bootloader over to NixOS generations.

Boards

Board SoC Module Status
Terasic DE25-Nano Intel Agilex 5 terasic-de25-nano HPS boots NixOS. The fabric loads from Linux through common/fpga once the board boots HPS-first. On hardware 2026-11-09.
Digilent Zybo (original, not Z7) AMD Zynq-7010 digilent-zybo Boots NixOS from SD, cross-built from x86_64. The fabric loads from Linux through common/fpga, by hand or at boot. On hardware 2026-10-24.

Each board has a README covering how to use it, its console, boot chain and known limits.

Binary cache

CI builds every board's kernel and example image and pushes them to cachix. aarch64 boards build on native ARM runners. 32-bit boards are cross-built on x86_64, so their cache hits need nixpkgs.buildPlatform = "x86_64-linux". Add the cache, or every vendor kernel gets built from source on your machine:

nix.settings = {
  substituters = ["https://nixos-fpga.cachix.org"];
  trusted-public-keys = ["nixos-fpga.cachix.org-1:CACHIX_PUBLIC_KEY"];
};

How updates work

A daily job bumps nixpkgs and runs every package's updateScript (nix run .#update). It opens a PR, and CI builds and caches it.

  • PRs that only move nixpkgs merge themselves once green.
  • PRs that move a kernel get the needs-hardware-test label and wait for someone to flash and boot a board. CI can prove a kernel builds, but it can't prove the board boots.

Roadmap

  • common/fpga/: the Zybo and the DE25-Nano load through it. Still to come: device-tree overlays for what a design adds to the PS, enabling the DE25-Nano's HPS-to-FPGA bridges from Linux after a load, and an HPS-first QSPI image for the DE25-Nano.
  • U-Boot built from source for the DE25-Nano.
  • The mainline kernel once the DE25-Nano DTB is upstreamed.
  • More boards (Kria, the Zybo Z7, other Agilex and Cyclone SoC kits).

Contributing

See CONTRIBUTING.md.

About

NixOS hardware support for FPGA and SoC-FPGA boards

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages