Online version of this manual and other related documents can be found at https://wiki.trenz-electronic.de/display/PD/Project+Delivery+-+Intel+devices |
Table of contents |
The most Trenz Electronic FPGA Reference Designs are TCL-script based projects.
The "normal" Quartus project will be generated in the subfolder "/quartus/" and the additional software part will be generated in the subfolder "/software/" after executing scripts.
To create project do the following steps:
If you don't use predefined quartus installation path, open "design_basic_settings.cmd/.sh" with text editor and set correct quartus installation path.
See Reference Design: Getting Started for more details.
For Problems, please check Checklist / Troubleshoot at first. |
Description | PCB Name | Project Name+(opt. Variant) | supported Quartus Version | Date | ||||
---|---|---|---|---|---|---|---|---|
Example: | TEI0006 | - | test_board(_noprebuilt) | - | quartus_19.4 | - | 20200229145924 | .zip |
Type or File | Version |
---|---|
Quartus Prime | 19.1 lite / 19.4 pro |
Trenz Project Scripts | 19.4.0 |
Trenz <board_series>_devices.csv | 1.0 |
Trenz zip_ignore_list.csv | 1.1 |
Trenz mod_list.csv | 1.1 |
File or Directory | Type | Description |
---|---|---|
<design_name> | work, base directory | Base directory with predefined batch files (*.cmd, *.sh) to generate or open quartus project or program device |
<design_name>/backup/ | generated | (Optional) Directory for project backups |
<design_name>/board_files/ | source | Local list of available board variants (<board_series>_devices.csv) |
<design_name>/console | source | Folder with different command files |
<design_name>/log/ | generated | (Temporary) Directory with quartus log files (used only with predefined commands from tcl scripts, otherwise this logs will be writen into the Quartus work directory) |
<design_name>/prebuilt/ | prebuilt | Contains subfolders for different board variants |
<design_name>/prebuilt/<board_part_shortname> | prebuilt | Directory with prebuilt programming files (*.pof, *.sof or *.jic) for FPGA and different source files for hardware (*.sopcinfo) and software (*.elf) included in subfolders |
<design_name>/prebuilt/<board_part_shortname>/programming_files/ | prebuilt | Directory with prebuilt programming files (*.pof, *.sof or *.jic) |
<design_name>/prebuilt/<board_part_shortname>/hardware/ | prebuilt | Directory with prebuilt hardware sources (*.sopcinfo) |
<design_name>/prebuilt/<board_part_shortname>/software/ | prebuilt | Directory with prebuilt software sources (*.elf) |
<design_name>/quartus/ | generated | (Temporary) Directory where Quartus project is created. Quartus project file is <design_name>.qpf |
<design_name>/scripts/ | source | TCL scripts to build a project |
<design_name>/settings/ | source | (Optional) Additional design settings: zip_ignore_list.csv, mod_list.csv, preset_qsys.qprs |
<design_name>/software/ | generated | (Temporary) Directory with additional software |
<design_name>/source_files/ | source | Directory with source files needed for creating project |
<design_name>/source_files/quartus/ | source | Source files for Quartus project |
<design_name>/source_files/software/ | source | Source files for additional software |
Use to create project, open project or program device.
Select your board from listed modules. To find easier the correct board you can use the filter function. Click on "clear filter" button to reset the filter and show all available modules.
Some links to more information about the board, reference design and create_project_win.cmd/create_project_linux.sh gui.
Messagebox shows different info, warning and error messages.
Settings for the *.cmd files. Following settings are avaliable:
QUARTUS (optional for project creation and programming): %QUADIR%/%QUARTUS_VERSION%/quartus/
SDK (optional for software projects and programming): %QUADIR%/%QUARTUS_VERSION%/nios2eds/
Create project:
Manual configuration of the design basic settings (Note: batch/bash files works only in the basefolder of the project, use "create_project_win.cmd"/"create_project_linux.sh" or copy manually)
Programming FPGA or flash memory:
Device list csv file is used for TE-Scripts only.
Name | Description | Value |
---|---|---|
ID | ID to identify the board variant of the module series, used in TE-Scripts | Number, should be unique in csv list |
PRODID | Product ID | Product Name |
FAMILY | FPGA family, used in Quartus and TE-Scripts | device family, which is available in Quartus, ex. MAX 10 |
DEVICE | FPGA device, used in Quartus and TE-Scripts | device, which is available in Quartus, ex. 10M08SAU169C8G |
SHORTNAME | Subdirectory name, used for multi board projects to get correct sources and save prebuilt data | name to save prebuilt files or search for sources |
FLASHTYP | Flash typ used for programming Devices via Quartus/LabTools | "<Flash Name from Quartus>|<SPI Interface>" or "NA" , NA is not defined |
FLASH_SIZE | Size of Module Flash | use MB, for ex. "64MB" or "NA" if not available |
DDR_DEV | DDR Module | DDR module name |
DDR_SIZE | Size of Module DDR | use GB or MB, for ex. "2GB" or "512MB" or "NA" if not available |
PCB_REV | Supported PCB Revision | "<supported PCB Revision>|<supported PCB Revision>", for ex. "REV02" or "REV03|REV02" |
Attention not all features of the TE-Scripts are supported in the advanced usage!
To modifiy current device csv list, make a copy of the original csv and rename with suffix "_mod.csv", ex.TEI0006_devices.csv as TEI0006_devices_mod.csv. Scripts use modified csv instead of the original file.
ZIP ignore list:
Files which should not be added in the backup file can be defined in this file: "<design_name>/settings/zip_ignore_list.csv". This file will be loaded automatically on script initialisation.
mod list:
List with commands to modify source files during project creation. (<design_name>/settings/mod_list.csv)
Qsys presets file:
Predefined settings for Qsys IP Components (<design_name>/settings/presets_qsys.qprs)
HDL files can be saved in the subfolder "<design_name>/hdl/". They will be loaded automatically on project creation. Available formats are *.vhd, *.v and *.sv.
To get content of older revision got to "Change History" of this page and select older revision number.
<!-- Generate new entry: 1:add new row below first 2:Copy Page Information Macro(date+user) Preview, Page Information Macro Preview, Quartus Version(or update)to the empty row 3.Update Metadate =Page Information Macro Preview+1 --> |
Date | Revision | Quartus Version | Authors | Description |
---|---|---|---|---|
19.1 Lite 19.4 Pro |
| |||
2019-11-11 | v.5 | 18.1 | Thomas Dück |
|
2019-10-29 | v.4 | 18.1 | Thomas Dück |
|
All |