Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 7/07/2025
Public
Document Table of Contents

1.3.1. Option Precedence

Project assignments follow a set of precedence rules.
Assignments for a project can exist in three places:
  • Quartus® Prime Settings File (.qsf)
  • The Compiler database for the project revision
  • Command-line options

The .qsf file contains all the project-wide and entity-level assignments and settings for the current revision for the project. The Compiler database contains the result of the last compilation of the project revision in the /db directory, and reflects the assignments at the moment when you compiled the revision.

Command-line options override any assignments in the .qsf file or the Compiler database files. To specify whether the .qsf or Compiler database files take precedence for any assignments not specified in the command-line, use the --read_settings_files option.

Table 1.  Precedence for Reading Assignments
Option Specified Precedence for Reading Assignments
--read_settings_files = on

(Default)

  1. Command-line options
  2. The .qsf for the project
  3. Project database (db directory, if it exists)
  4. Quartus® Prime software defaults
--read_settings_files = off
  1. Command-line options
  2. Project database (db directory, if it exists)
  3. Quartus® Prime software defaults

The --write_settings_files command-line option lists the locations to which assignments are written..

Table 2.  Location for Writing Assignments
Option Specified Location for Writing Assignments
--write_settings_files = on (Default) .qsf file and Compiler database
--write_settings_files = off Compiler database

Any assignment not specified as a command-line option or found in the .qsf file or Compiler database file is set to its default value.

Use the options --read_settings_files=off and --write_settings_files=off (where appropriate) to optimize the way that the Quartus® Prime software reads and updates settings files.