## ─────────────────────────────────────────────────────────────
## RouteRTL — Quartus Device Family Reference
## ─────────────────────────────────────────────────────────────
##
## Quartus Pro installs device support from .qdz files bundled with
## (or downloaded alongside) the main installer. If a device family's
## .qdz file is NOT present in the installer directory, that family
## will NOT be available after installation.
##
## This file documents the known device families, their .qdz naming
## patterns, and the environment variables that control device
## selection in the RouteRTL Docker container.
## ─────────────────────────────────────────────────────────────

## ─── Known Device Families (.qdz patterns) ──────────────────
##
## Family              .qdz pattern (example)                     Approx. Size
## ──────────────────  ─────────────────────────────────────────  ────────────
## Agilex 7 / 9       agilex*.qdz                                8-12 GB
## Arria 10            arria10*.qdz                               4-6 GB
## Arria V / V GZ      arriav*.qdz, arriavgz*.qdz                2-3 GB
## Cyclone V           cyclonev*.qdz                              1-2 GB
## Cyclone 10 GX       cyclone10gx*.qdz                          2-3 GB
## MAX 10 / MAX V      max10*.qdz, maxv*.qdz                     <1 GB
## Stratix 10          stratix10*.qdz                             6-10 GB
## Stratix V           stratixv*.qdz                              2-4 GB
##
## Download individual .qdz files from:
##   https://www.intel.com/content/www/us/en/products/details/fpga/
##
## Place them in the SAME directory as your Quartus installer .tar
## (the directory pointed to by QUARTUS_INSTALLER_PATH in .env).
## The unattended installer automatically picks up all .qdz files.

## ─── Environment Variables ──────────────────────────────────
##
## QUARTUS_INSTALLER_PATH  (required)
##   Host directory containing the Quartus .tar and .qdz files.
##   Set in your project .env file.
##
##   Example:
##     QUARTUS_INSTALLER_PATH=/mnt/c/Users/dmazure/Downloads
##
## QUARTUS_DEVICES  (optional, advisory)
##   Comma-separated list of device families you EXPECT to be
##   available after installation. The entrypoint script will
##   warn (but not block) if any listed family is missing.
##
##   Example:
##     QUARTUS_DEVICES=cyclonev,arria10,max10
##
## QUARTUS_INSTALLER_INDEX  (optional, CI/CD)
##   When multiple .tar files exist in the installer directory,
##   this 1-based index selects which one to use without showing
##   the interactive menu. Default: 1 (first file).
##
##   Example:
##     QUARTUS_INSTALLER_INDEX=2

## ─── Installer Flags Reference ──────────────────────────────
##
## The headless installer accepts these flags:
##
##   setup_pro.sh --mode unattended \
##                --accept_eula 1 \
##                --installdir /opt/altera
##
## Optional component control:
##   --disable-components quartus_help,modelsim_ase
##
## To skip Questa Intel FPGA Edition (~2 GB):
##   --disable-components modelsim_ase
##
## Device families are NOT controlled by --disable-components.
## They are controlled by which .qdz files are present.
