Kopie von _template_TEI0000 Intel Reference Design (Access rights for internal use only)

Overview

Refer to http://trenz.org/te0xyz-info for the current online version of this manual and other available documentation.

Key Features

• Quartus Prime Pro 21.4
• Yocto
• NIOS II
• UART
• ETH
• USB
• I2C
• QSPI flash
• DDR3 memory
• User LED

Revision History

Release Notes and Know Issues

Requirements

Software

Hardware

Complete List is available on <project folder>/board_files/*_board_files.csv

Design supports following modules:

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

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??? "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:
   
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"
4. Create and configure your Yocto Linux project, see Yocto KICKstart
   1. Copy the generated meta-<module> folder from <project name>/os/yocto/meta-<module> to the path/to/yocto/poky/ directory
   2. Follow the steps from Yocto KICKstart#Create a project for an Intel FPGA device without running the 'bitbake' command

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

      bitbake-layers add-layer ../meta-<module>

      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

   4. 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.
      Also define the variables INITRAMFS_IMAGE_BUNDLE and INITRAMFS_IMAGE to generate a ram disk image.

      sed -i '/^MACHINE/s/MACHINE/#MACHINE/g' conf/local.conf
      echo -e '\nMACHINE = "<module>-<Board-Part-Short-Name>"' >> conf/local.conf
      echo -e '\nINITRAMFS_IMAGE_BUNDLE = "1"' >> conf/local.conf
      echo -e 'INITRAMFS_IMAGE = "te-initramfs"' >> conf/local.conf

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

      bitbake te-image-minimal

Launch

Programming

Get prebuilt boot binaries

1. Run create_project_win.cmd/create_project_linux.sh
2. Select Module in 'Board selection'
3. Click on 'Export prebuilt files' button
   1. Folder <project folder>/_binaries_<Article Name> with subfolder boot_linux will be generated and opened

SD-Boot mode

1. Prepare SD card as follows for SD-Boot

   1. Run following command to get the device name of the SD card  (e.g. /dev/sdx):

      lsblk

   2. Insert SD card in the SD card reader, unmount and erase it

      sudo umount /dev/sdx
      sudo sfdisk --delete /dev/sdx

   3. Create required partitions on the SD card (partition 1: 50MB, FAT32 / partition 2: 2MB, a2) 

      echo -e ',50M,c\n,2M,a2' | sudo sfdisk /dev/sdb --force
      sudo mkfs.vfat -F 32 -n boot /dev/sdb1

   4. Copy the u-boot file to partition 2 of the SD card

      sudo dd if=path/to/_binaries_<Article Name>/boot_linux/u-boot-with-spl.sfp of=/dev/sdb2 bs=1M seek=0
      sync
      

   5. Copy  zimage-initramfs-<Yocto Machine Name>.bin, <Yocto Machine Name>.dtb, soc_system.rbf and the extlinux folder from path/to/_binaries_<Article Name>/boot_linux/  via file manager to the partition 1 (named 'boot')  on SD card
2. Set Boot Mode to SD-Boot
   • Depends on Carrier, see carrier TRM
3. Insert SD-Card in the SD-Slot

QSPI-Boot mode

Option for u-boot-with-spl.sfp on QSPI flash and zimage-initramfs-<Yocto Machine Name>.bin, <Yocto Machine Name>.dtb, soc_system.rbf and extlinux/extlinux.conf on SD card.

Use files from "<project folder>\_binaries_<Article Name>\boot_linux" from generated binary folder,see: #Get prebuilt boot binaries

1. Connect JTAG and power on carrier with module
2. Open path/to/intelFPGA_lite/21.1/embedded/Embedded_Command_Shell.bat ( Win OS)/path/to/intelFPGA_lite/21.1/embedded/embedded_command_shell.sh (Linux OS) from Intel SoC FPGA EDS

3. Run following commands:

   quartus_hps -c 1 -o pv -a 0x0 path/to/_binaries_<Article Name>/boot_linux/u-boot-with-spl.sfp

4. Copy  zimage-initramfs-<Yocto Machine Name>.bin, <Yocto Machine Name>.dtb, soc_system.rbf and the extlinux folder from path/to/_binaries_<Article Name>/boot_linux/ to SD card.
5. Set Boot Mode to QSPI-Boot
   
   • Depends on Carrier, see carrier TRM
6. Insert the SD card in the 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

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

   1. select COM Port

      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
4. Linux Console:

   1. Login data:

      Note: Wait until Linux boot finished

      Username: root
      Password: root

   2. 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)

5. ...

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

U-boot Device Tree

#u-boot device_tree.dts
/ {
};

#device_tree-u-boot.dts
/ {
};

Kernel Device Tree

#kernel device_tree.dts
/ {
};

Kernel

Start with Create a custom BSP layer for Intel SoC or FPGA#Configure linux 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/

Image recipes:

• te-image-minimal.bb: create minimal linux image
• te-initramfs.bb: required for building an image with initial RAM Filesystem

Added packages/recipes:

• No packages/recipes

Rootfs

Used filesystem: Initial RAM Filesystem (initramfs)

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