Page History

Template Revision 2.8 - on construction

...

HTML

<!-- tables have all same width (web max 1200px and pdf full page(640px), flexible width or fix width on menu for single column can be used as before) -->
<style>
.wrapped{
  width: 100% !important;
  max-width: 1200px !important;
 }
</style>

...

hidden	true
id	Comments

Important General Note:

...

Export PDF to download, if vivado revision is changed!

Designate all graphics and pictures with a number and a description, Use "Scroll Title" macro

...

Figure template (note: inner scroll ignore/only only with drawIO object):

...

anchor	Figure_xyz
title	Text

Scroll Ignore
Create DrawIO object here: Attention if you copy from other page, use

Scroll Only
image link to the generate DrawIO PNG file of this page. This is a workaround until scroll pdf export bug is fixed

...

Table template:

Layout macro can be use for landscape of large tables
Set column width manually(can be used for small tables to fit over whole page) or leave empty (automatically)

...

anchor	Table_xyz
title	Text

...

Scroll pdf ignore

Overview

Page properties

hidden	true
id	Comments

Notes :

short description of the design
Short Link of "Scroll only" macro:
- Use short link the Wiki Resource page, for example: http://trenz.org/max1000-info
- List of available short links: https://wiki.trenz-electronic.de/display/CON/Redirects

NIOS II Design with software example "simple_socket_server".

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

Key Features

Page properties

hidden	true
id	Comments

Notes :

Add basic key futures, which can be tested with the design

Excerpt
Quartus 19.4 Pro NIOS II UART ETH QSPI flash memory DDR3L memory User LED

Revision History

Page properties

hidden	true
id	Comments

Notes :

add every update file on the download
add design changes on description

...

anchor	Table_DRH
title	Design Revision History

...

TEI0006-test_board_noprebuilt-quartus_19.4.0-20200513124953.zip

TEI0006-test_board-quartus_19.4.0-20200513125247.zip

...

TE scripts update

...

TEI0006-test_board-quartus_19.4-20200309134933.zip
TEI0006-test_board_noprebuilt-quartus_19.4-20200309135555.zip

...

initial release

Release Notes and Know Issues

...

Date	Version	Changes	Author
2023-09-13	2.3	update to 22.x "select COM Port" → Linux command changed	TD
2022-06-15	2.2	add 'QSPI-Boot mode' add 'Get prebuilt boot binaries' changed SD-Boot mode chapter 'Device Tree' chapter expanded	TD
2022-04-21	2.1	update to 21.x	TD
2022-02-28	2.0	add yocto to Overview → Key Features Overview → Requirements Design Flow Launch add section 'Software Design - Yocto'	TD
2021-06-15	1.2	table of content view template history placed a horizontal separation line under each chapter heading replaced <design name> by <project folder> update 19.x to 20.x	JH,TD
2020-11-24	1.1	add fix table of content add table size as macro	JH
--	1.0	--	--

Custom_table_size_100

Page properties

hidden	true
id	Comments

Important General Note:

Export PDF to download, if vivado revision is changed!

Designate all graphics and pictures with a number and a description, Use "Scroll Title" macro

Use "Scroll Title" macro for pictures and table labels. Figure number must be set manually at the moment (automatically enumeration is planned by scrollPDF)

Figure template (note: inner scroll ignore/only only with drawIO object):

Scroll Title

anchor	Figure_xyz
title	Text

Scroll Ignore
Create DrawIO object here: Attention if you copy from other page, use

Scroll Only
image link to the generate DrawIO PNG file of this page. This is a workaround until scroll pdf export bug is fixed

Table template:
- Layout macro can be use for landscape of large tables
- Set column width manually(can be used for small tables to fit over whole page) or leave empty (automatically)
Scroll Title
anchor Table_xyz
title Text
Scroll Table Layout
orientation portrait
sortDirection ASC
repeatTableHeaders default
style
widths
sortByColumn 1
sortEnabled false
cellHighlighting true
Example Comment
1 2

...

Overview

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Page properties

hidden	true
id	Comments

Notes :

short description of the design
Short Link of "Scroll only" macro:
- Use short link the Wiki Resource page, for example: http://trenz.org/tei0006-info
- List of available short links: https://wiki.trenz-electronic.de/display/CON/Redirects

Quartus Design with NIOS V/m and software example "simple_socket_server" and "hello_tei0006".

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

Key Features

Page properties

hidden	true
id	Comments

Notes :

Add basic key futures, which can be tested with the design

Excerpt
Quartus 22.4 Pro NIOS V/m UART ETH QSPI flash memory DDR3 memory User LED

Revision History

Page properties

hidden

...

Requirements

Software

Page properties

hidden	true
id	Comments

Notes :

list of software which was used to generate the design

...

anchor	Table_SW
title	Software

Authors	Description
2024-01-09	22.4 Pro	TEI0006-test_board-quartus_22.4.0-20240109135625.zip TEI0006-test_board_noprebuilt-quartus_22.4.0-20240109135551.zip	Thomas Dück	Fixed bugs in TE scripts
2023-12-04	22.4 Pro	TEI0006-test_board_noprebuilt-quartus_22.4.0-20231204134534.zip TEI0006-test_board-quartus_22.4.0-20231204134455.zip	Thomas Dück	update to Quartus Prime Pro 22.4 TE scripts update new assembly variants
2023-04-13	20.4 Pro	TEI0006-test_board_noprebuilt-quartus_20.4.0-20230411171022.zip TEI0006-test_board-quartus_20.4.0-20230411171231.zip	Thomas Dück	change "Serial Flash Controller II" IP Core to "QUAD SPI Controller II" IP Core bugfix offset value of hex file
2021-06-15	20.4 Pro	TEI0006-test_board_noprebuilt-quartus_20.4.0-20210615142627.zip TEI0006-test_board-quartus_20.4.0-20210615142455.zip	Thomas Dück	update to Quartus Prime Pro 20.4 TE scripts update new assembly variants
2020-10-19	19.4 Pro	TEI0006-test_board_noprebuilt-quartus_19.4.0-20201019101920.zip TEI0006-test_board-quartus_19.4.0-20201019101840.zip	Thomas Dück	script update bugfixes
2020-05-13	19.4 Pro	TEI0006-test_board_noprebuilt-quartus_19.4.0-20200513124953.zip TEI0006-test_board-quartus_19.4.0-20200513125247.zip	Thomas Dück	TE scripts update
2020-03-09	19.4 Pro	TEI0006-test_board-quartus_19.4-20200309134933.zip TEI0006-test_board_noprebuilt-quartus_19.4-20200309135555.zip	Thomas Dück	initial release

Release Notes and Know Issues

Page properties

hidden	true
id	Comments

Notes :

add known Design issues and general notes for the current revision
do not delete known issue, add fixed version time stamp if issue fixed

Scroll Title

anchor	Table_KI
title-alignment	center
title	Known Issues

Scroll Table Layout

orientation	portrait
sortDirection	ASC
repeatTableHeaders	default
sortByColumn	1
sortEnabled	false
cellHighlighting	true

...

Hardware

Page properties

hidden	true
id	Comments

Notes :

list of software which was used to generate the design

Complete List is available on <design_name>/board_files/*_devices.csv

Design supports following modules:

...

anchor	Table_HWM
title	Hardware Modules

...

Design supports following carriers:

...

anchor	Table_HWC
title	Hardware Carrier

...

Additional HW Requirements:

...

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

...

content of the zip file

...

Prebuilt

...

list of software which was used to generate the design
mark the module and carrier board, which was used tested with an ^*

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

Design supports following modules:

Scroll Title

anchor	Table_HWM
title-alignment	center
title	Hardware Modules

...

File

...

File-Extension

...

Description

...

Debian SD-Image

...

*.img

...

Debian Image for SD-Card

...

MCS-File

...

*.mcs

...

Flash Configuration File with Boot-Image (MicroBlaze or FPGA part only)

...

MMI-File

...

*.mmi

...

File with BRAM-Location to generate MCS or BIT-File with *.elf content (MicroBlaze only)

...

SREC-File

...

*.srec

...

Converted Software Application for MicroBlaze Processor Systems

Module Model	Board Part Short Name	PCB Revision Support	DDR	QSPI Flash	Others	Notes
TEI0006-03-220-5I*	220_5I_2GB	REV03\|REV02\|REV01	2GB	128MB	--	--
TEI0006-03-APC13-R	APC13R	REV03	128MB	128MB	--	without ETH PHY
TEI0006-03-ANC13-R	ANC13R	REV03	128MB	128MB	--	without ETH PHY
TEI0006-03-ALC13-R	ALC13R	REV03	128MB	128MB	--	without ETH PHY
TEI0006-03-ALC13	ALC13	REV03	128MB	128MB	--	--
TEI0006-04-ALC13A	ALC13	REV04	128MB	128MB	--	--
TEI0006-04-ALE13A	ALE13	REV04	128MB	128MB	--	--
TEI0006-04-ANE13A	ANE13	REV04	128MB	128MB	--	--
TEI0006-04-APE23A	APE23	REV04	2GB	128MB	--	--
TEI0006-04-API23A	API23	REV04	2GB	128MB	--	--
TEI0006-04-S004	API23R	REV04	2GB	128MB	--	without ETH PHY
TEI0006-04-S005	APE23	REV04	2GB	128MB	--	--
TEI0006-04-S006	BPI23	REV04	2GB	128MB	--	--
TEI0006-04-S007	APE23R	REV04	2GB	128MB	--	without ETH PHY

^*used as reference

Design supports following carriers:

Scroll Title

anchor	Table_HWC
title-alignment	center
title	Hardware Carrier

Scroll Table Layout

orientation	portrait
sortDirection	ASC
repeatTableHeaders	default
style
widths
sortByColumn	1
sortEnabled	false
cellHighlighting	true

Carrier Model	Notes
TEIB0006*

^*used as reference

Additional HW Requirements:

Scroll Title

anchor	Table_AHW
title-alignment	center
title	Additional Hardware

Scroll Table Layout

orientation	portrait
sortDirection	ASC
repeatTableHeaders	default
style
widths
sortByColumn	1
sortEnabled	false
cellHighlighting	true

Additional Hardware	Notes
USB cable for JTAG/UART	Check Carrier Board and Programmer for correct type
RJ45 ethernet cable	connect carrier board to network

Content

...

anchor	Table_PF
title	Prebuilt files (only on ZIP with prebult content)

...

File

...

File-Extension

...

Description

...

Download

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

Page properties

hidden	true
id	Comments

Important set new Vivado version link on every Design update of new vivado version!
Set Link to download folder (Remove ../de/.. ../en/.. from url) for example: https://shop.trenz-electronic.de/Download/?path=Trenz_Electronic/Modules_and_Module_Carriers/4x5/TE0712/Reference_Design/2018.2/test_board

Reference Design is available on:

TEI0006 "Test Board" Reference Design

Design Flow

Page properties

hidden	true
id	Comments

Notes :

Basic Design Steps
Add/ Remove project specific description

Note
Reference Design is available with and without prebuilt files. It's recommended to use TE prebuilt files for first lunch.

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

Programming

Note
Check Module and Carrier TRMs for proper HW configuration before you try any design.

QSPI

Connect JTAG and power on carrier with module
Open create_project_win.cmd/create_project_linux.sh
Select correct board in "Board selection"
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
Click on "Start program device" button

JTAG

Not used on this Example.

Usage

Prepare HW like described on section Programming
Connect UART USB (most cases same as JTAG)
Connect your board to the network
Power on PCB

UART

Open Serial Console (e.g. PuTTY)
1. COM Port: Win OS see device manager, Linux OS see dmesg | grep tty (UART is *USB1)
2. Speed: 11520
3. Select "Implicit CR in every LF" in category "Terminal"
Press reset button
Simple Socket Server is starting up. Follow instructions on shell.
1. If dhcp server is not available: open software project in sdk gui (e.g. NIOS II SBT for Eclipse) and change predefined IP address in "simple_socket_server.h", rebuild software project and download *.elf file to the device.
2. Open command shell and enter "telnet <ip_address> 30" to connect to simple socket server

Notes :

content of the zip file

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

Design Sources

Scroll Title

anchor	Table_DS
title-alignment	center
title	Design sources

Scroll Table Layout

orientation	portrait
sortDirection	ASC
repeatTableHeaders	default
sortByColumn	1
sortEnabled	false
cellHighlighting	true

Type

Location

Notes

Quartus

<project folder>/source_files/quartus

<project folder>/source_files/<Board Part Short Name>/quartus

Quartus project will be generated by TE Scripts

optional, source files for specific assembly variants

Software

<project folder>/source_files/software

Additional software will be generated by TE Scripts

Prebuilt

...

Description of Block Design, Constrains... BD Pictures from Export...

...

Scroll Title

anchor	Figure_BD
title	Block Design - Platform Designer

Image Removed

Software Design - SDK

Page properties

hidden	true
id	Comments

Note:

optional chapter separate
sections for different apps

Application

...

hidden	true
id	Comments

Template location: <design_name>/source_files/software/

simple_socket_server

Software example "Simple Socket Server" from eclipse (modified source files for TEI0006 board).

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.

Page properties

hidden	true
id	Comments

Note this list must be only updated, if the document is online on public doc!
It's semi automatically, so do following
- Add new row below first
- Copy "Page Information Macro(date)" Macro-Preview, Metadata Version number, Author Name and description to the empty row. Important Revision number must be the same as the Wiki document revision number Update Metadata = "Page Information Macro (current-version)" Preview+1 and add Author and change description. --> this point is will be deleted on newer pdf export template
- Metadata is only used of compatibility of older exports

...

anchor	Table_dch
title	Document change history.

...

Prebuilt files

Scroll Table Layout

orientation	portrait
sortDirection	ASC
repeatTableHeaders	default
style
widths
sortByColumn	1
sortEnabled	false
cellHighlighting	true

File	File-Extension	Description
SOPC Information File	*.sopcinfo	File with description of the .qsys file to create software for the target hardware
SRAM Object File	*.sof	Ram configuration file
Programmer Object File	*.pof	FPGA configuration file
JTAG Indirect Configuration file	*.jic	Flash configuration file
Raw binary file	*.rbf	FPGA configuration file
Diverse Reports	---	Report files in different formats
Software-Application-File	*.elf	Software application for Nios II/Nios V processor system
Device Tree	*.dtb	Device tree blob
SFP-File	*.sfp	Boot image with SPL (Secondary Program Loader)
BIN-File	*.bin	Image with linux kernel and ram disk
CONF-File	*.conf	Boot configuration file (extlinux.conf)
Yocto linux image	*.wic	Linux image for SD card

Scroll Title

anchor	Table_PF
title-alignment	center
title	Prebuilt files (only on ZIP with prebult content)

Scroll Table Layout

orientation	portrait
sortDirection	ASC
repeatTableHeaders	default
style
widths
sortByColumn	1
sortEnabled	false
cellHighlighting	true

File	File-Extension	Description
SOPC Information File	*.sopcinfo	File with description of the .qsys file to create software for the target hardware
SRAM Object File	*.sof	Ram configuration file
JTAG indirect configuration file	*.jic	Flash configuration file
Diverse Reports	---	Report files in different formats
Software-Application-File	*.elf	Software application for NIOS II processor system

Download

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

Page properties

hidden	true
id	Comments

Important set new Quartus version link on every Design update of new Quartus version!
Set Link to download folder (Remove ../de/.. ../en/.. from url) for example: https://shop.trenz-electronic.de/Download/?path=Trenz_Electronic/Modules_and_Module_Carriers/6x8/TEI0006/Reference_Design/22.4/test_board

Reference Design is available on:

TEI0006 "Test Board" Reference Design

Design Flow

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Page properties

hidden	true
id	Comments

Notes :

Basic Design Steps
Add/ Remove project specific description

Note
Reference Design is available with and without prebuilt files. It's recommended to use TE prebuilt files for first launch.

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

Launch

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Page properties

hidden	true
id	Comments

Note:

Programming and Startup procedure

Programming

Note

Check Module and Carrier TRMs for proper HW configuration before you try any design.

Reference Design is also available with prebuilt files. It's recommended to use TE prebuilt files for first launch.

Get prebuilt boot binaries

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

QSPI

Connect JTAG and power on carrier with module
Open create_project_win.cmd/create_project_linux.sh
Select correct board in "Board selection"
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
Click on "Start program device" button

JTAG

Not used on this Example.

Usage

Prepare HW like described on section Programming
Connect UART USB (most cases same as JTAG)
Connect your board to the network
Power on PCB

UART

Open Serial Console (e.g. PuTTY)
1. select COM Port
  Info
  Win OS: see device manager
  Linux OS: see ls -l dev/serial/by-id (UART is *USB1)
2. Speed: 115200
Press reset button
Console output depends on used Software project, see Software Design - SDK#Application

System Design - Quartus

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Page properties

hidden	true
id	Comments

Note:

Description of Block Design - Project, Block Design - Platform Desginer, ... Block Design Pictures from Export...

Block Design

The block design may differ depending on the assembly variant.

Scroll Title

anchor	Figure_BD
title-alignment	center
title	Block Design - Platform Designer

Image Added

Software Design - SDK

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Page properties

hidden	true
id	Comments

Note:

optional chapter separate
sections for different apps

Application

Page properties

hidden	true
id	Comments

----------------------------------------------------------

General Example:

hello_tei0006

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

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

hello_tei0006

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

simple_socket_server

Software example "Simple Socket Server" from eclipse (modified source files for TEI0006 board).

If DHCP Server is not available:
1. Open software project in sdk gui (e.g. Ashling RiscFree IDE for Intel FPGAs 22.4) and set in the main.c file the varaibles:
  - .use_dhcp = !DEF_TRUE
  - .ipv4_addr_str = <your static IP address>
  - .ipv4_gateway_str =<your gateway>
2. Rebuild the software project and download the *.elf file to the device.
3. Open the command shell and enter "telnet <ip_address> 80" to connect to the simple socket server

Appx. A: Change History and Legal Notices

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Document Change History

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

Page properties

hidden	true
id	Comments

Note this list must be only updated, if the document is online on public doc!
It's semi automatically, so do following
- Add new row below first
- Copy "Page Information Macro(date)" Macro-Preview, Metadata Version number, Author Name and description to the empty row. Important Revision number must be the same as the Wiki document revision number Update Metadata = "Page Information Macro (current-version)" Preview+1 and add Author and change description. --> this point is will be deleted on newer pdf export template
- Metadata is only used of compatibility of older exports

Scroll Title

anchor	Table_dch
title-alignment	center
title	Document change history

Scroll Table Layout

orientation	portrait
sortDirection	ASC
repeatTableHeaders	default
style
widths	2,,3,4
sortByColumn	1
sortEnabled	false
cellHighlighting	true

Date

Document Revision

Authors

Description

Page info

	modified-date
	modified-date
dateFormat	yyyy-MM-dd

Page info

infoType	Current version
dateFormat	yyyy-MM-dd
prefix	v.
type	Flat

Page info

infoType	Modified by
type	Flat

update to Quartus Prime Pro 22.4
new assembly variants

2023-04-13

v.12

Thomas Dück

Design files update

2021-07-26

v.10

Thomas Dück

update to Quartus Prime Pro 20.4
new assembly variants
document style update
script update

2020-10-19

v.6

Thomas Dück

script update
bugfixes

2020-05-13

v.5

Thomas Dück

...

Authors

...

Page info

infoType	Current version
dateFormat	yyyy-MM-dd
prefix	v.
type	Flat

...

Design files update

2020-03-18

v.4

Thomas Dück

initial release 19.4

--

all

Page info

infoType	Modified users
dateFormat	yyyy-MM-dd
type	Flat

--

Legal Notices

Include Page

	IN:Legal Notices
	IN:Legal Notices

Scroll Only

HTML
<style> .wiki-content .columnLayout .cell.aside { width: 0%; }</style>

Scroll pdf ignore

Custom_fix_page_content

Trenz Electronic Documentation

Page History

Versions Compared

Old Version 5

New Version Current

Key

Table of contents

Overview

Key Features

Revision History

Release Notes and Know Issues

Overview

Key Features

Revision History

Requirements

Software

Release Notes and Know Issues

Hardware

Requirements

Software

Page propertieshiddentrueidCommentsNotes :

Prebuilt

Hardware

Content

Download

Design Flow

Page propertieshiddentrueidComments

Programming

QSPI

JTAG

Usage

UART

Design Sources

Prebuilt

Page propertieshiddentrueidComments

Software Design - SDK

Application

simple_socket_server

Appx. A: Change History and Legal Notices

Document Change History

Download

Design Flow

Launch

Programming

Get prebuilt boot binaries

QSPI

JTAG

Usage

UART

System Design - Quartus

Block Design

Software Design - SDK

Application

hello_tei0006

simple_socket_server

Appx. A: Change History and Legal Notices

Document Change History

Legal Notices

Table of contents

Page properties
hidden true
id Comments
Notes :

Page properties
hidden true
id Comments

Page properties
hidden true
id Comments