Terasic TSOM User manual

TSoM Evaluation
Kit User Manual
1
www.terasic.com
July 26, 2019
TABLE OF CONTENTS
Chapter 1 Introduction .....................................................................................................................3
1.1 Package Contents................................................................................................................................3
1.2 TSoM Design Package........................................................................................................................4
1.3 Getting Help........................................................................................................................................4
Chapter 2 Board Specification .........................................................................................................5
C
Ch ha ap pt te er r 2 2.............................................................................................................................................5
2.1 Layout and Components.....................................................................................................................5
2.2 Block Diagram....................................................................................................................................6
Chapter 3 System Interface ............................................................................................................. 9
C
Ch ha ap pt te er r 3 3.............................................................................................................................................9
3.1 Settings of FPGAConfiguration Mode...............................................................................................9
3.2 Configuration of Cyclone V SoC FPGA on TSoM evalu-ation kit...................................................11
3.3 Board Status Elements......................................................................................................................18
3.4 Board Reset Elements.......................................................................................................................18
Chapter 4 HPS Fabric Components ............................................................................................... 20
C
Ch ha ap pt te er r 4 4...........................................................................................................................................20
4.1 Ethernet RJ45....................................................................................................................................20
4.2 USB OTG Connector........................................................................................................................21
4.3 UART to USB...................................................................................................................................22
4.4 Micro SD Card..................................................................................................................................23
4.5 QSPI Flash (DNI) .............................................................................................................................23
4.6 Raspberry Pi 2x13 GPIO ..................................................................................................................24
Chapter 5 FPGA Fabric Components............................................................................................. 28
C
Ch ha ap pt te er r 5 5...........................................................................................................................................28
5.1 User Push-buttons, Switches and LEDs............................................................................................28

TSoM Evaluation
Kit User Manual
2
www.terasic.com
July 26, 2019
5.2 TMD Header.....................................................................................................................................30
5.3 A/D Converter and Analog Input......................................................................................................31
5.4 HDMI TX Interface ..........................................................................................................................33
Chapter 6 Examples For FPGA ..................................................................................................... 35
C
Ch ha ap pt te er r 6 6...........................................................................................................................................35
6.1 HDMI TX..........................................................................................................................................35
6.2 DDR3_RTL.......................................................................................................................................38
Chapter 7 Programming the EPCS Device..................................................................................... 41
Chapter 8 eMMC Programming ..................................................................................................... 53
Appendix 61
C
Ch ha ap pt te er r 7 7...........................................................................................................................................61
C
Ch ha ap pt te er r 8 8...........................................................................................................................................61
C
Ch ha ap pt te er r 9 9...........................................................................................................................................61
9.1 Revision History ...............................................................................................................................61

TSoM Evaluation
Kit User Manual
3
www.terasic.com
July 26, 2019
Chapter 1
Introduction
TSoM (Terasic SoC System on Module) Evaluation Kit is composed of TSoM module and Based
Board(TSoM-BB). TSoM module is small, integrated single-board computers with Cyclone® V
SoC at the core. The SoC SoM includes DDR3 memory, flash memory, power management,
common interface controllers. Users can install the TSoM based board on it through the 260-pin
edge connector, combined to a complete FPGA evaluation kit.
TSOM-BB is a based board developed based on TSoM card. The main purpose is providing
expansion interface, power and JTAG configuration function for TSoM, it connects the FPGA and
HPS fabric I/O of TSoM to many application interfaces, such as USB, Ethernet, HDMI, Micro SD
card and so on, it expanded the FPGA I/O which are connected to 260-pin edge connector to a
variety of applications. The TSoM based board also provides USB Blaster II circuit, users can
configure and debug the FPGA on TSoM through the JTAG interface. TSoM based board provides
power source to TSoM through the 260-pin edge connector. With the TSoM based board, users can
use TSoM Evaluation Kit to develop various FPGA projects.
1
1. .1 1 P Pa ac ck ka ag ge e C Co on nt te en nt ts s
Figure 1-1 shows a photograph of TSoM Evaluation Kit.
Figure 1-1 TSoM Evaluation Kit Package Contents
The TSoM Evaluation Kit package includes:
1. TSOM Module (installed)

TSoM Evaluation
Kit User Manual
4
www.terasic.com
July 26, 2019
2. TSOM Based board (TSOM-BB)
3. Quick Start Guide
4. Power DC Adapter (5V)
5. Type A to Mini-B USB Cable x2
6. MicroSD card (installed)
7. Four Silicon Footstands
1
1. .2 2 T TS So oM M D De es si ig gn n P Pa ac ck ka ag ge e
The TSoM Evaluation Kit design package contains all the documents and supporting materials
associated with TSoM Evaluation Kit, including the user manual, reference designs, and device
datasheets.
Users can download this design package from the link: http://TSoM.terasic.com/cd.
1
1. .3 3 G Ge et tt ti in ng g H He el lp p
Here are the addresses where you can get help if you encounter any problems:
Terasic Technologies
9F., No.176, Sec.2, Gongdao 5th Rd, East Dist, Hsinchu City, 30070. Taiwan
Email: [email protected]
Tel.: [phone]
Website: TSoM.terasic.com

TSoM Evaluation
Kit User Manual
5
www.terasic.com
July 26, 2019
Chapter 2
Board Specification
This chapter provides an introduction to the features and design characteristics of the board.
2
2. .1 1 L La ay yo ou ut t a an nd d C Co om mp po on ne en nt ts s
Figure 2-1 and Figure 2-2 shows a photograph of the TSoM Evaluation Kit (TSoM module
board and TSOM Based Board). It depicts the layout of the board and indicates the location of the
connectors and key components.
Figure 2-1 TSoM Evaluation Kit (Top View)

TSoM Evaluation
Kit User Manual
6
www.terasic.com
July 26, 2019
Figure 2-2 TSoM Evaluation Kit (Back View)
2
2. .2 2 B Bl lo oc ck k D Di ia ag gr ra am m
Figure 2-3 is the block diagram of the TSoM Evaluation Kit and Figure 2-4 shows the block
diagram of the TSoM Module board
Figure 2-3 Block diagram of the TsoM evaluation kit

TSoM Evaluation
Kit User Manual
7
www.terasic.com
July 26, 2019
Figure 2-4 Block diagram of the TSoM Module
Detailed information about TSoM module and TSOM based board are listed below.
TSoM Module
FPGA: Cyclone V SE 5CSEBA6U23I7NDK (110K LEs)
Interface: DDR4 Edge (include 3.3V power source)
Dimension: 50 mm x 70 mm
FPGA Fabric side:
DDR3 SDRAM 1GB, 32bit –303MHz (Soft IP)
LVDS Transmitter x15 & LVDS Receiver x17 pairs & GPIO x3 (Total GPIO x67)
EPCS64
HPS Fabric side:
Boot Selection DIP Switch: boot from eMMC or MicroSD Card
DDR3 SDRAM 1GB, 32bit - 400MHz
USB 2.0 PHY
Gigabit Ethernet PHY
3.3V GPIO x25 (Can/UART/SPI/I2C/Trace Buses)
1.5V GPI x4 (Input pins)
eMMC 8GB
TSOM based board

TSoM Evaluation
Kit User Manual
8
www.terasic.com
July 26, 2019
System:
Power source: 5V DC
on-board USB Blaster II
DDR4 socket for TSOM installation
FPGA Fabric:
LED x 2, Key x 2, Switch x 2
HDMI TX v1.4, 1080P Full-HD, Compatible with HDCP v1.4
TMD Header x2 (support 16 GPIO)
ADC, 8-channel, 12-bit, 500Ksps
HPS Fabric:
MicroSD Socket
Optional 512Mb QSPI FLASH (Need to rework Boot Selection resistor on Module)
USB to UART (USB OTG PHY, Mini-B Connector)
Ethernet (RJ45 Connector)
USB OTG (Micro-AB Connector)
2x13 GPIO (include I2C/UART/SPI), Compatible with Raspberry Pi Expansion IO

TSoM Evaluation
Kit User Manual
9
www.terasic.com
July 26, 2019
Chapter 3
System Interface
This chapter provides an instruction for the system interface of the TSoM evaluation kit.
3
3. .1 1 S Se et tt ti in ng gs s o of f F FP PG GA A C Co on nf fi ig gu ur ra at ti io on n M Mo od de e
Since the factory setting of MSEL[4:0] on the TSoM module is FPPx32 mode(See Figure 3-1). It
means that when the TSoM evaluation kit is power on, the FPGA is configured from the HPS fabric.
When the software on the HPS is running, the FPGAcan be configured via HPS.
Figure 3-1 TsoM module is setting to FPPx32 mode
As shown in the Figure 3-2, there are 3 storage devices can be supported on TSoM evaluation kit to
boot HPS: SD Card, QSPI flash and eMMC flash. The eMMC flash is embedded in the TSoM
module. The SD Card and QSPI Flash are on the TSoM based board.

TSoM Evaluation
Kit User Manual
10
www.terasic.com
July 26, 2019
Figure 3-2 Boot device for HPS on the TsoM evaluation kit
As described in section 3.1 of the TSoM module manual, the SD card shares the same HPS data bus
as the eMMC flash. Therefore, only one of these two storage devices can be used to boot HPS at the
same time. Users can switch between the two boot devices through the switch SW1 on the TSOM
module board (See Figure 3-3). The factory default boot device is SD card interface (SW1 is set to
"ON" position).
Figure 3-3 eMMC/SD Card select switch
The QSPI Flash is the option function and don’t install on the board . Users can apply it on their
own if needed. After the user installs the QSPI flash, user can adjust the SW2 on the back of the
TSoM evaluation kit (See Figure 3-4). Switch it to “ON”position that will change the HPS boot
source to QSPI flash.

TSoM Evaluation
Kit User Manual
11
www.terasic.com
July 26, 2019
Figure 3-4 QSPI flash/SD Card select switch(Setting to SD Card )
Also, if the user wants to the FPGA is configured by EPCS on TSoM evaluation kit when power on.
Then refer to section 3.1 of the TSoM module manual for EPCS part. Modify the SW2 on the
TSoM module to AS mode (See Figure 3-5).
Figure 3-5 SW2 Setting Resistors (AS Mode)
3
3. .2 2 C Co on nf fi ig gu ur ra at ti io on n o of f C Cy yc cl lo on ne e V V S So oC C F FP PG GA A o on n T TS So oM M
e
ev va al lu u- -a at ti io on n k ki it t
There are two types of programming method supported by TSoM evaluation kit:
1. JTAG programming: It is named after the IEEE standards Joint Test Action Group. The

TSoM Evaluation
Kit User Manual
12
www.terasic.com
July 26, 2019
configuration bit stream is downloaded directly into the Cyclone V SoC FPGA. The FPGA will
retain its current status as long as the power keeps applying to the board; the configuration
information will be lost when the power is off.
2. AS programming: The other programming method is Active Serial configuration. The
configuration bit stream is downloaded into the serial configuration device (EPCS64), which
provides non-volatile storage for the bit stream. The information is retained within EPCS64
even if the TSoM evaluation kit board is turned off. When the board is powered on, the
configuration data in the EPCS64 device is automatically loaded into the Cyclone V SoC
FPGA.
JTAG Chain on TSoM Evaluation Kit
The FPGA device can be configured through JTAG interface on TSoM evaluation kit board, but the
JTAG chain must form a closed loop, which allows Quartus II programmer to the detect FPGA
device. Figure 3-6 illustrates the JTAG chain on TSoM evaluation kit board.
In addition, the TSoM evaluation kit has one external JTAG Header (J7) reserved for users to
connect to JTAG chain of the TSoM evaluation kit via external blaster. The J7 header is not
installed, so users need to solder a 2.54mm 2 x 5 male pin header if it is necessary.
Figure 3-6 Path of the JTAG chain
Configure the FPGA in JTAG Mode
There are two devices (FPGA and HPS) on the JTAG chain. The following shows how the FPGA is
programmed in JTAG mode step by step.
Open the Quartus II programmer, please Choose Tools > Programmer. The Programmer window
opens. Please click “Hardware Setup”, as circled in Figure 3-7.

TSoM Evaluation
Kit User Manual
13
www.terasic.com
July 26, 2019
Figure 3-7 Programmer Window
If it is not already turned on, turn on the DE-SoC [USB-1] option under currently selected hardware
and click “Close” to close the window. See Figure 3-8.
Figure 3-8 Hardware Setting
Return to the Quartus II programmer and click “Auto Detect”, as circled in Figure 3-9.

TSoM Evaluation
Kit User Manual
14
www.terasic.com
July 26, 2019
Figure 3-9 Detect FPGA device in JTAG mode
If the device is detected, the window of the selection device is opened, Please select detected device
associated with the board and click “OK” to close the window, as circled in Figure 3-10.
Figure 3-10 Select 5CSEBA6 device
Both FPGA and HPS are detected, as shown in Figure 3-11.

TSoM Evaluation
Kit User Manual
15
www.terasic.com
July 26, 2019
Figure 3-11 FPGAand HPS detected in Quartus programmer
Right click on the FPGA device and open the .sof file to be programmed, as highlighted in Figure
3-12.

TSoM Evaluation
Kit User Manual
16
www.terasic.com
July 26, 2019
Figure 3-12 Open the .sof file to be programmed into the FPGAdevice
Select the .sof file to be programmed, as shown in Figure 3-13.
Figure 3-13 Select the .sof file to be programmed into the FPGA device
Click “Program/Configure” check box and then click “Start” button to download the .sof file into
the FPGA device, as shown in Figure 3-14.

TSoM Evaluation
Kit User Manual
17
www.terasic.com
July 26, 2019
Figure 3-14 Program .sof file into the FPGAdevice
Configure the FPGA in AS Mode
The TSoM evaluation kit board uses a serial configuration device (EPCS64) to store configuration
data for the Cyclone V SoC FPGA. This configuration data is automatically loaded from the serial
configuration device chip into the FPGAwhen the board is powered up.
Users need to use Serial Flash Loader (SFL) to program the serial configuration device via JTAG
interface. The FPGA-based SFL is a soft intellectual property (IP) core within the FPGA that bridge
the JTAG and Flash interfaces. The SFL Megafunction is available in Quartus II. Figure 3-15
shows the programming method when adopting SFL solution.
Figure 3-15 Programming a serial configuration device with SFL solution

TSoM Evaluation
Kit User Manual
18
www.terasic.com
July 26, 2019
3
3. .3 3 B Bo oa ar rd d S St ta at tu us s E El le em me en nt ts s
In addition to the 9 LEDs that FPGA/HPS device can control, there are 6 indicators which can
indicate the board status (See Figure 3-16), please refer the details in Table 3-1.
Figure 3-16 LED Indicators on TSoM evaluation kit
Table 3-1 LED Indicators
Board Reference
LED Name
Description
LED2
3.3-V Power
Illuminate when 3.3V power is active.
LED10
5-V Power
Illuminate when 5V power is active.
LED4
JTAG_TX
Illuminate when data is transferred from JTAG to USB Host.
LED5
JTAG_RX
Illuminate when data is transferred from USB Host to JTAG.
TXD1
UART TXD
Illuminate when data is transferred from FT232R to USB Host.
RXD1
UART RXD
Illuminate when data is transferred from USB Host to FT232R.
3
3. .4 4 B Bo oa ar rd d R Re es se et t E El le em me en nt ts s
There are two HPS reset buttons on TSoM evaluation kit, HPS (cold) reset and HPS warm reset, as
shown in Figure 3-17. Table 3-2 describes the purpose of these two HPS reset buttons. Figure 3-18
is the reset tree for TSoM evaluation kit.

TSoM Evaluation
Kit User Manual
19
www.terasic.com
July 26, 2019
Figure 3-17 HPS cold and warm reset buttons on TSoM evaluation kit
Table 3-2 Description of Two HPS Reset Buttons on TSoM evaluation kit
Board Reference
Signal Name
Description
Button1(TSoM
Based board)
HPS_RESET_N
Cold reset to the HPS, Ethernet PHY and USB host device.
Active low input which resets all HPS logics that can be reset.
KEY1 (TSoM
Module board)
HPS_WARM_RST_N
Warm reset to the HPS block. Active low input affects the system
reset domain for debug purpose.
Figure 3-18 HPS reset tree on TSoM evaluation kit board