Page History

^*used as reference

Design supports following carriers:

Design supports following carriers:

Additional HW Requirements:

Content

For general structure and usage of the reference design, see Project Delivery - Intel devices

Design Sources

Prebuilt

Prebuilt

Download

Reference Design is only usable with the specified Quartus version. Do never use different versions of Quartus software for the same project.

Reference Design is available on:

• TEI0??? CR00100 "Test Board" Reference Design

Design Flow

Trenz Electronic provides a tcl based built environment based on Quartus Design Flow.

See also:

• Project Delivery - Intel devices

The Trenz Electronic FPGA Reference Designs are TCL-script based projects. To create a project, open a project or program a device execute "create_project_win.cmd" on Windows OS and "create_project_linux.sh" on Linux OS.

TE Scripts are only needed to generate the quartus project, all other additional steps are optional and can also executed by Intel Quartus/SDK GUI. For currently Scripts limitations on Win OS and Linux OS see: Project Delivery - Intel devices → Currently limitations of functionality

1. Open create_project_win.cmd/create_project_linux.sh:
   'Create Project' GUI example
2. Select Board in "Board selection"
3. Click on "Create project" button to create project
   
   1. (optional for manual changes) Select correct quartus installation path in "<project folder>/settings/design_basic_settings.tcl"
   Create and configure your Yocto Linux project, see Yocto KICKstart
4. Copy the generated meta-<module> folder from <project name>/os/yocto/meta-<module> to the path/to/yocto/poky/ directory
5. Follow the steps from Yocto KICKstart#Create a project for an Intel FPGA device without running the 'bitbake' command

Add the generated bsp layer meta-<machine> to path/to/yocto/poky/build/conf/bblayers.conf with:

Code Block
theme Midnight linenumbers true
bitbake-layers add-layer ../meta-<module>

Info
Note: The generated meta-<module> layer depends on the meta-altera layer (for more information see: Yocto KICKstart#Used source files), so you need to add both bsp layers to bblayers.conf

Redefine the variable MACHINE with '<module>-<Board-Part-Short-Name>' in path/to//yocto/poky/build/conf/local.conf. The correct MACHINE name can be found in the #Hardware table.

Code Block
theme Midnight linenumbers true
sed -i '/^MACHINE/s/MACHINE/#MACHINE/g' conf/local.conf echo -e '\nMACHINE = "<module>-<Board-Part-Short-Name>"' >> conf/local.conf

Build the image with following command (the image recipes are located in meta-<module>/recipes-images/yocto/):

Code Block
theme Midnight linenumbers true
bitbake <module>-image-minimal

Launch

Programming

SD-Boot mode

1. Follow the steps described in Yocto KICKstart#Copy image to SD card to copy the generated linux image to the SD card.
2. Set Boot Mode to SD-Boot.
   • Depends on Carrier, see carrier TRM.
3. Insert SD-Card in SD-Slot.

QSPI

1. Connect JTAG and power on carrier with module
2. Open create_project_win.cmd/create_project_linux.sh
3. Select correct board in "Board selection"
4. Click on "Program device" button
   1. if prebuilt files are available: select "Program prebuilt file"
   2. using own generated programming file: select "Program other file" and click on "Browse ..." to open own generated programming file
   3. (optional) click on "Open programmer GUI" to program device with Quartus programmer GUI
5. Click on "Start program device" button

JTAG

Not used on this example.

Usage

1. Prepare HW like described on section Kopie von _template_TEI0000 Intel Reference Design (Access rights for internal use only)
2. Connect UART USB (most cases same as JTAG)
3. Connect your board to the network
4. Power on PCB

UART

select COM Port

Login data:

Username: root
Password: root

You can use Linux shell now.

i2cdetect -y -r 1   (check I2C 1 Bus)
dmesg | grep rtc    (RTC check)
udhcpc              (ETH0 check)
lsusb               (USB check)

Launch

Programming

MAX10 Flash

1. Connect JTAG and power on carrier with module
2. Open create_project_win.cmd/create_project_linux.sh
3. Select correct board in "Board selection"
4. Click on "Program device" button
   1. if prebuilt files are available: select "Program prebuilt file"
   2. using own generated programming file: select "Program other file" and click on "Browse ..." to open own generated programming file
   3. (optional) click on "Open programmer GUI" to program device with Quartus programmer GUI
5. Click on "Start program device" button

JTAG

Not used on this example.

Usage

1. Prepare HW like described on section Programming
2. Connect UART USB (most cases same as JTAG)
3. Power on PCB

UART

1. Open Serial Console (e.g. PuTTY)

   1. select COM Port

      Info
      Win OS: see device manager Linux OS: see  dmesg | grep tty  (UART is *USB1)

      
      

   2. Speed: 115200
2. Press reset button
3. Console output depends on used Software project, see Software Design - SDK#Application

System Design - Quartus

Block Design

The block designs may differ depending on the assembly variant.

Scroll Title
anchor Figure_BD title-alignment center title Block Design - Project
Image Added

Scroll Title
anchor Figure_BD title-alignment center title Block Design - Platform Desginer
Image Added

Software Design - SDK

Application

Used software project depends on board assembly variant. Template location: <project folder>/source_files/software/

hello_cr00100

This is a Hello World example as endless loop instead of one console output

System Design - Quartus

Block Design

The block designs may differ depending on the assembly variant.

HPS Interfaces

Activated interfaces:

Software Design - SDK

Application

Used software project depends on board assembly variant. Template location: <project folder>/source_files/software/

...

Software Design - Yocto

For Yocto installation and project creation, follow instructions from:

• Yocto KICKstart
• Create a custom BSP layer for Intel SoC or FPGA

U-Boot

Start with Create a custom BSP layer for Intel SoC or FPGA#Configure u-boot

File location: meta-<module>/recipes-bsp/u-boot/

Changes:

• No changes

Device Tree

#device tree
/ {
};

Kernel

File location: meta-<module>/recipes-kernel/linux/

Changes:

• No changes.

Images

Image recipe for minimal console image

File location: meta-<module>/recipes-images/yocto/

Added packages/recipes:

.

Appx. A: Change History and Legal Notices

Document Change History

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

Legal Notices