Project Delivery - Intel devices

Quick Start

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.

There are several options to create the Quartus project from the project delivery. 

One option to create project ist using the "Module Selection Guide" in "_create_win_setup.cmd" on Windows OS and "_create_linux_setup.sh" on Linux OS:

1. Execute "_create_win_setup.cmd" or "_create_linux_setup.sh"
2. Select "Module Selection Guide" (press "0" and Enter)
3. Follow instructions

For manuell configuration or addition command files for execution will be generated with "_create_win_setup.cmd" or "_create_linux_setup.sh". If you use our prepared batch files for project creation do the following steps:

1. open "design_basic_settings.cmd/.sh" with text editor and set correct quartus path and board part number from <project_root_directory>/board_files/TEIxxxx_devices.csv
2. run "quartus_create_project_batchmode.cmd/sh".

See  Reference Design: Getting Started for more details.

Zip Project Delivery

Zip Name Description

Last supported Release

Currently limitations of functionality

• • • no current limitations of functionality

Directory structure

Command Files

Command files will be generated with "_create_win_setup.cmd" on Windows OS and with "_create_linux.setup.sh" on Linux OS.

Windows Command Files

Linux Command Files

Design Environment: Usage

Reference-Design: Getting Started

• Install "Quartus Prime 18.1 Lite Edition" (additional recommended: Install "Quartus Prime Software v18.1 Update 1")
• Automatically configuration of the reference-designs:
  • Run "_create_win_setup.cmd" or "_create_linux_setup.sh"
  • select "Module Selection Guide" and follow instructions.
    • • "design_basic_settings.cmd/.sh" will be configured over this menu
• Manual Configure the reference-design (Note: batch/bash files works only in the basefolder of the project, use "_create_win_setup.cmd"/"_create_linux_setup.sh" or copy manually):
  1. Open “design_basic_settings.cmd/.sh” with a text-editor:
      a. Set correct Quartus Environment:
          @set QUADIR=C:/intelFPGA_lite (example for Windows OS)
          @set QUARTUS_VERSION=18.1
          Program settings will be search in :
          %QUADIR%/%QUARTUS_VERSION%/quartus/
         %QUADIR%/%QUARTUS_VERSION%/nios2eds/
          Example directory: C:/intelFPGA_lite/18.1/
          Attention: Scripts are supported only with predefined Quartus Version!
      b. Set the correct module part-number:      
          @set PARTNUMBER=x
          You find the available Module Numbers in <design_name>/board_files/TEIxxxx_devices.csv
  
• Create a project in one step:
  2. Run “quartus_create_project_batchmode.cmd”/"quartus_create_project_bashmode.sh"
• Programming FPGA or flash memory with prebuilt files:
  3. Connect your Hardware-Modul with PC via JTAG
  4. Open "Programmer (Quartus Prime 18.1)" from start menu or run "quartus_open_existing_project_guimode.cmd" and select Tools → Programmer
  5. Select "Add File..." and open correct file from <design_name>/prebuilt/<board_part_shortname>/programming_files/
  6. Press "Start" to programm FPGA or flash memory

Hardware Design

Device list CSV Description

Device list csv file is used for TE-Scripts only.

SDC Conventions

• All *.sdc from <design_name>/source_files/quartus/ are load into the quartus project on project creation.

Advanced Usage

Attention not all features of the TE-Scripts are supported in the advanced usage!

User defined device list csv file

To modifiy current device list csv list, make a copy of the original csv and rename with suffix "_mod.csv", ex.TEI0001_devices.csv as TEI0001_devices_mod.csv. Scripts use modified csv instead of the original file.

User defined Settings

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 automaticaly 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-Design

HDL files can be saved in the subfolder "<design_name>/vhdl/". They will be loaded automatically on project creation. Available formats are *.vhd, *.v and *.sv.

Checklist / Troubleshoot

1. Are you using exactly the same Quartus version? If not then the scripts will not work, no need to try.
2. Are you using Quartus on Windows PC? Quartus works in Linux also, but the scripts are tested on Windows only.
3. Win OS only: Use short path name, OS allows only 256 characters in normal path.
4. Linux OS only: Use bash as shell and add access rights to bash files. Check with "ls ls /bin/sh". It should be display: /bin/sh -> bash. Access rights can be changed with "chmod"
5. Are space character on the project path? Somtimes TCL-Scripts can't handle this correctly. Remove spaces from project path.
6. Did you have the newest reference design build version? Maybe it's only a bug from a older version.
7. On project creation process old files will be deleted. Sometimes the access will be denied by os (synchronisiation problem) and the scripts canceled. Please try again. 
   
8. If nothing helps, send a mail to Trenz Electronic Support (support[at]trenz-electronic.de) with subject line "[TE-Reference Designs] ",  the complete zip-name from your reference design.

References

1. Intel Quartus Prime User Guide: Getting Started (UG-20129)
2. Intel Quartus Prime User Guide: Platform Designer (UG-20130)
3. Intel Quartus Prime User Guide: Design Compilation (UG-20132)
4. Intel Quartus Prime User Guide: Scripting (UG-20144)

Document Change History

To get content of older revision  got to "Change History"  of this page and select older revision number.