The openXC7 FPGA toolchain's integration with the Nix package manager offers precise control over software builds and dependencies, emphasizing reproducibility and configuration transparency. Conversely, the adaptation to a containerized environment using Podman or Docker facilitates cross-platform operation, notably on Windows WSL and MacOS x86, and encapsulates the toolchain for consistent execution across varied systems. While Nix provides a robust, integrated environment, the container approach introduces portability and simplifies the toolchain's utilization for users less versed in Nix's specifics.
- Install the Nix package manager on your Linux distribution of choice (or use NixOS):
$ sh <(curl -L https://nixos.org/nix/install) --daemon
- Enable flakes:
Add the following to
~/.config/nix/nix.confor/etc/nix/nix.conf:
experimental-features = nix-command flakes
- Then you will get a development shell with the complete toolchain with:
$ nix develop github:openxc7/toolchain-nix
- Compile and load a demo project onto an FPGA:
$ git clone https://github.com/openXC7/demo-projects
$ cd demo-projects/blinky-qmtech
$ make
$ make program
To utilize the openXC7 FPGA toolchain in a Podman container, users must first ensure Podman is installed on their system. The process involves building the container image with the toolchain using a specific build command. Once the image is built, the toolchain is executed within the container through a run command. This containerized approach ensures a consistent development environment across various operating systems like Windows, MacOS (x86 only), and Linux, streamlining the deployment and usage of the toolchain.
For installation and contaienr usage, please refer to the detailed instructions.