Intel® Quartus® Prime is programmable logic device design software for analysis and synthesis of HDL designs, enabling developers to compile their designs, perform timing analysis, examine RTL diagrams, simulate a design's reaction to different stimuli, and configure the target device with the programmer.
Quartus Prime includes an implementation of VHDL and Verilog for hardware description, visual editing of logic circuits, and vector waveform simulation.
- Where to get help: Rætro Discord or GitHub discussions.
- GitHub repo: raetro/sdk-docker-fpga
- Where to file issues: https://github.com/raetro/sdk-docker-fpga/issues
Quartus® Lite Edition for Intel's low-cost FPGA devices families.
These images are built from official installation files provided by Intel (specifically, FPGA Software Download Center).
- Cyclone® II, III, IV
13.0,13.0sp1v13.0.1.232 (sp1)
- Cyclone® III, IV, V
13.1v13.1.4.182
- Cyclone® IV, V, 10LP and MAX® 10
17.0v17.0.2.60217.1v17.1.1.59318.1v18.1.1.64619.1v19.1.0.67020.1v20.1.0.71121.1,21.1.1v21.1.1.85022.1,22.1.2v22.1std.2.92223.1v23.1std.0.991
| Project | Version | Alias | Architecture | Model |
|---|---|---|---|---|
| MiMiC NSX | 17.1 |
mimic |
Various | Various |
| Analogue Pocket | 18.1 |
pocket |
Cyclone V | 5CEBA4F23C8 |
| Atlas | 17.1 |
atlas |
Cyclone 10 LP | 10CL025YU256C8G |
| MiST | 13.1 |
mist |
Cyclone III | EP3C25E144C8 |
| MiSTer | 17.0 |
mister |
Cyclone V SE | 5CSEBA6U23I7 |
| MultiCore | 13.1 |
mc |
Cyclone IV E | EP4CE10E22C8 |
| MultiCore2 | 13.1 |
mc2 |
Cyclone IV E | EP4CE22F17C8 |
| MultiCore2 Plus | 13.1 |
mcp |
Cyclone IV E | EP4CE55F23C8 |
| NeptUNO | 13.1 |
neptuno |
Cyclone IV E | EP4CE55F23C8 |
| SiDi | 13.1 |
sidi |
Cyclone IV E | EP4CE22F17C8 |
| Turbo Chameleon 64 v1 | 13.1 |
tc64v1 |
Cyclone III | EP3C25E144C8 |
| Turbo Chameleon 64 v2 | 18.1 |
tc64v2 |
Cyclone 10 LP | 10CL025YU256C8G |
| Unamiga Reloaded | 13.1 |
uareloaded |
Cyclone IV E | EP4CE55F23C8 |
MiMiC Supported Boards: DE10-Nano, SoCKit, Deca, C10LP-RefKit, CYC1000, Chameleon96.
Usage: docker run -it --rm raetro/quartus:<alias>. E.g.: docker run -it --rm raetro/quartus:mimic
The images are published on the Docker Hub as raetro/quartus:<version> and GitHub Container Registry as ghcr.io/raetro/quartus:<version>.
While the images works fine on desktops, the primary purpose is to be used in a continuous integration and continuous deployment (CI/CD) pipeline.
name: Test Build
on:
push:
branches:
- main
paths-ignore:
- '**.md'
pull_request:
branches:
- main
paths-ignore:
- '**.md'
jobs:
synthesis:
runs-on: ubuntu-latest
container: raetro/quartus:17.1
steps:
# 1 - Checkout repository
- name: Checkout repository
uses: actions/checkout@v2
# 2 - RTL synthesis
- name: Run compilation flow
run: quartus_sh --flow compile my_project.qpf
# 3 - Upload artifacts
- name: Upload artifacts
uses: actions/upload-artifact@v3
with:
name: OutputFiles.zip
path: output_files/For more examples and full workflow look inside the examples folder
docker pull raetro/quartus:<version> #DockerHub
# or
docker pull ghcr.io/raetro/quartus:<version> #GitHub Packagesdocker run -it --rm -v /path/to/project:/build raetro/quartus:<version> #DockerHub
# or
docker run -it --rm -v /path/to/project:/build ghcr.io/raetro/quartus:<version> #GitHub PackagesDocker will automatically download the image if it's not present locally
Use the quartus_sh executable with the --flow option to perform a complete compilation flow with a single command.
docker run -it --rm -v $(pwd):/build raetro/quartus:17.1 quartus_sh --flow compile my_project.qpfWindows Command Line (cmd)
docker run -it --rm -v %cd%:/build raetro/quartus:17.1 quartus_sh --flow compile my_project.qpfWindows PowerShell/WSL (Debian/Ubuntu)
docker run -it --rm -v ${pwd}:/build raetro/quartus:17.1 quartus_sh --flow compile my_project.qpfWSL Users: Make sure to enable WSL Integration on Docker Desktop at
Settings > Resources > WSL Integration
Where:
docker runspins up the container from the image-itspecifies that you want an interactive TTY--rmtells it to remove this temporary image when it exits-v <cmd>mounts a volume on the current directory and:/buildwithin the containerraetro/quartus:17.1is our Docker Image andquartus_sh --flow compile my_project.qpfperform a complete compilation flow.
Your project will be synthesized inside the container and exit when it finishes, the output files will be placed in the project directory.
Note: The
--flowoption supports the smart recompile feature and efficiently sets command-line arguments for each executable in the flow. You can resume an interrupted compilation with the-resumeargument of the--flowoption.
Add an alias to your profile:
Mac: nano ~/.bash_profile
Linux: nano ~/.bashrc or nano ~/.profile
alias qdc='f(){ docker run -it --rm -v "$(pwd)":/build raetro/quartus:17.1 "$@"; unset -f f; }; f'Windows PowerShell: ${Home}\Documents\WindowsPowerShell\Profile.ps1
Function _qdc { docker run -it --rm -v ${pwd}:/build raetro/quartus:17.1 @Args }
Set-Alias -Name qdc -Value _qdcFrom now on you can simply type qdc to log into the container on the current folder,
or just qdc quartus_sh --flow compile my_project.qpf to compile your source code.
GITHUB_TOKEN: The GitHub token to use with GitHub CLI.JTAG_SERVER: JTAG ServerName/IP address(eg: host running jtagd/jtagserver).JTAG_PASSWD: JTAG ServerPassword.LM_LICENSE_FILE: Specifies the location of a license file. Note: Separate multiple license servers and node locking license files with ":"
docker run -it -rm \
-e JTAG_SERVER=192.168.1.10 \
-e JTAG_PASSWD=1234 \
-e GITHUB_TOKEN=<GH_PAT> \
-e LM_LICENSE_FILE=/opt/license.dat \
-v /path/to/license.dat:/opt/license.dat:ro
-v ${pwd}:/build \
raetro/quartus:17.1- Download and Install Quartus Prime Programmer
- How to use the Quartus Programmer Tool
- Remote JTAG Server
If you want to make local modifications to these images for development purposes or just to customize the logic:
git clone https://github.com/raetro/sdk-docker-fpga.git
cd sdk-docker-fpga
./build.sh -v17.1 -b
# or if you wanna change the base image
./build.sh -vbase -oQuartus Prime Lite Container Builder.
Usage: build.sh [-v] [OPTION...]
-v Quartus version to build.
[13.0, 13.1, 17.0, 17.1, 18.1, 19.1, 20.1, 21.1]
Main modes of operation:
-b Build container using remote files.
-p Publish container to registry.
-g Publish container to GitHub registry.
-d Download files for local build.
-l Build container using local files.
-c Check local files integrity.
-o Build Base OS.
eg. build.sh -v21.1 -b
build.sh -vbase -o./build.sh -v17.1 -b # Build container using remote files.
./build.sh -v17.1 -p # Publish container to registry.
./build.sh -v17.1 -g # Publish container to GitHub registry.
./build.sh -v17.1 -d # Download files for local build.
./build.sh -v17.1 -c # Check local files integrity.
./build.sh -v17.1 -l # Build container using local files.
./build.sh -vbase -o # Build Base OS container.The Quartus images come in many versions, each designed for a specific use case.
If you need to install any additional packages beyond what comes with the image, you can do so by expanding the container.
For example, if you need to install the verilator utility, you can do so by creating a new Dockerfile for your project.
FROM raetro/quartus:17.1
RUN apt-get update && \
apt-get install -y --no-install-recommends verilator \
autoconf g++ flex bison ccache libgoogle-perftools-dev \
numactl perl-doc libfl-dev zlibc zlib1g zlib1g-dev && \
rm -rf /var/lib/apt/lists/* \
CMD [ "/bin/bash" ]Then, run the commands to build and run the Docker image:
docker build -t quartus-verilator .
docker run -it --rm quartus-verilator
- Base image: Debian Stretch (Slim)
- Installed Packages: Container Manifest
- GitHub CLI: 2.14.2
- CHANGELOG Generator: 0.15.1
Intel® Quartus® Prime Software - Copyright © Intel Corporation. All rights reserved.
Altera, Avalon, Cyclone, Intel, the Intel logo, MAX, Nios, Quartus are trademarks of Intel Corporation or its subsidiaries.
Your use of Intel Corporation's design tools, logic functions and other software and tools, and its AMPP partner logic functions, and any output files from any of the foregoing (including device programming or simulation files), and any associated documentation or information are expressly subject to the terms and conditions of the Intel Program License Subscription Agreement, the Intel Quartus Prime License Agreement, the Intel FPGA IP License Agreement, or other applicable license agreement, including, without limitation, that your use is for the sole purpose of programming logic devices manufactured by Intel and sold by Intel or its authorized distributors. Please refer to the applicable agreement for further details.
This work is licensed under multiple licenses.
- All original source code is licensed under MIT-license unless implicit indicated.
- All documentation is licensed under Creative Commons Attribution Share Alike 4.0 International Public License.
- Some configuration and data files are licensed under Creative Commons Zero v1.0 Universal.
The Rætro authors and contributors or any of its maintainers are in no way associated with or endorsed by Intel® or any other company not implicit indicated. All other brands or product names are the property of their respective holders.
As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc. from the base distribution, along with any direct or indirect dependencies of the primary software being contained).
As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.
