chriz2600/quartus-lite

quartus-lite 镜像文档

镜像概述

quartus-lite是基于Debian系统构建的Quartus Lite Docker镜像，旨在提供隔离的运行环境以执行Quartus系列工具。该镜像特别优化了Mac OS X用户的使用体验，通过内置的quartus shell脚本，可便捷地在容器内运行quartus_sh等命令，同时将主机当前工作目录挂载至容器内的/build路径，实现文件操作与主机环境的无缝衔接。

核心功能与特性

• 基于Debian系统：提供稳定可靠的底层运行环境
• 专用shell脚本：包含quartus脚本，支持Mac OS X用户直接调用容器内Quartus命令
• 自动目录挂载：主机当前工作目录自动挂载至容器/build路径，确保项目文件可直接访问
• 远程编程支持：通过环境变量配置远程JTAG服务器及密码，实现远程设备编程

使用场景与适用范围

适用于FPGA开发流程中的各类任务，包括但不限于：

• 项目编译与逻辑综合（通过quartus_sh --flow compile命令）
• 远程JTAG设备编程
• 需要环境隔离的Quartus工具使用场景
• Mac OS X系统下运行Quartus工具的需求场景

使用方法与配置说明

前置准备

1. 将镜像提供的quartus shell脚本复制到主机PATH环境变量包含的目录（如/usr/local/bin），确保可直接执行：

   bash
   cp quartus /usr/local/bin/
   chmod +x /usr/local/bin/quartus
   

基本使用示例

在项目目录下执行Quartus命令，例如编译Quartus项目：

bash
quartus quartus_sh --flow compile my.qpf

上述命令会在容器内执行quartus_sh --flow compile my.qpf，其中my.qpf为当前工作目录下的Quartus项目文件（因当前目录已挂载至容器/build，命令可直接访问该文件）。

环境变量配置

通过设置环境变量可配置远程编程参数：

示例：指定远程JTAG服务器进行编程

bash
JTAG_SERVER=192.168.1.100 JTAG_PASSWD=jtagpass quartus quartus_pgm -c 1 -m jtag -o "p;output_file.sof"