Terasic de10-nano User manual

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
1

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
2
CONTENTS
CHAPTER 1 ABOUT THIS GUIDE ..............................................................................................................................3
CHAPTER 2 DEVELOPMENT BOARD SETUP ........................................................................................................4
2.1 INTRODUCTION ...........................................................................................................................................................4
2.2 MSELSETTINGS.........................................................................................................................................................4
2.3 USB ,HDMI OUTPUTAND POWER CABLES................................................................................................................5
2.4 POWERING UP THE DE10-NANO BOARD WITH XFCE DESKTOP ENVIRONMENT...........................................................6
CHAPTER 3 SOFTWARE INSTALLATION ................................................................................................................8
3.1 INTRODUCTION ...........................................................................................................................................................8
3.2 INSTALLING QUARTUS II SOFTWARE............................................................................................................................8
3.3 INSTALLING INTEL SOCEMBEDDED DESIGN SUITE................................................................................................... 11
CHAPTER 4 PERFORMING A FPGA SYSTEM TEST ...........................................................................................12
4.1 INTRODUCTION .........................................................................................................................................................12
4.2 INSTALLING THE USB-BLASTER II DRIVER...............................................................................................................12
4.3 DOWNLOADING A FPGASRAM OBJECT FILE ..........................................................................................................13
CHAPTER 5 RUNNING LINUX ON THE DE10-NANO BOARD VIA UART TERMINAL ...................................19
5.1 INTRODUCTION .........................................................................................................................................................19
5.2 SETTING UP UART TERMINAL..................................................................................................................................19
5.3 RUNNING LINUX ON DE10-NANO BOARD.................................................................................................................22
5.4 CREATING A MICROSD CARD IMAGE........................................................................................................................23
CHAPTER 6 RUNNING WEB SERVER ON THE DE10-NANO ............................................................................25
6.1 INTRODUCTION .........................................................................................................................................................25
6.2 HARDWARE SETUP AND DRIVER INSTALL .................................................................................................................25
6.3 USING THE WEB SERVER...........................................................................................................................................30
6.4 ENABLE/DISABLE USB GADGET .............................................................................................................................. 34
ADDITIONAL INFORMATION .......................................................................................................................................35

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
3
Chapter 1
About this Guide
The DE10-Nano Getting Started Guide contains a quick overview of the hardware and software
setup including step-by-step procedures from installing the necessary software tools to using the
DE10-Nano board. The main topics this guide covers are listed below:
Development Board Setup: Powering on the DE10-Nano
Software Installation: Installing Quartus II and SoC EDS
Perform FPGA System Test: Downloading a FPGA SRAM Object File (.sof)
Running Linux on DE10-Nano Board via UART terminal.

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
4
Chapter 2
Development Board Setup
2.1 Introduction
The instructions in this section explain how to set up the DE10-Nano development board. The
following pictures are the board overview of DE10-Nano.
2.2 MSEL Settings
FPPx32 Mode (Default)
The FPGA Configuration Mode Switch (MSEL) shown in Figure 2-1 is by default set to 01010
(MSEL[4:0] = 01010). The setting corresponds to FPGA configured from HPS software (in the SD
Card) in FPPx32 mode. If users want to boot with Linux Xfce desktop, please setting MSEL
switch in this mode
Figure 2-1 FPGA Configuration Mode Switch set in FPPx32 Mode

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
5
AS Mode
When the board is powered on and MSEL[4:0] set to “10010” (See Figure 2-2), the FPGA is
configured from EPCS.
Figure 2-2 FPGA Configuration Mode Switch set in AS Mode
2.3 USB , HDMI Output and Power Cables
Cable connections are shown in Figure 2-3, as below:
Figure 2-3 USB, HDMI Output and Power Cables

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
6
2.4 Powering up the DE10-Nano Board with Xfce
Desktop Environment
To power-up the board and run the Xfce desktop, perform the following steps below:
1. To perform this power up test, user will need some additional parts as list in below:
i. A micro USB OTG cable.
ii. HDMI Monitor and HDMI cable.
iii. USB Mouse or Keyboard
2. Connect the provided power cord to the power supply and plug the cord into a power outlet
(verify the voltage supplied is the same as the specification on the power supply).
3. Connect the HDMI port of DE10-Nano to a monitor with HDMI input.
4. Make sure the Factory SD Card is inserted in the SD Card socket.
5. Connect the supplied DE10-Nano power adapter to the power connector (J14) on the DE10-Nano
board. At this point, you should see the 3.3V indicator LED (LED9) turned on.
6. It will take about 35 seconds to boot Linux. Finally, the screen will enter Xfce desktop on the
monitor (See Figure 2-5 ).
7. After the Xfce system is ready, connect a Mouse/Keyboard to the USB OTG port (J2) via Micro
USB OTG Cable (*1) (*2).
8. Now, user can use mouse/keyboard on the Xfce desktop.
(*1) Because the USB gadget function is enable by default in the Xfce system, any external USB
device needs to be connected to the DE10-nano AFTER the Xfce boots up. Otherwise the
external USB device will not be detected by the system. For how to enable/disable USB gadget
function in the Xfce system, please refer to the section 6.4.
(*2)Some USB mouse or keyboard may have compatibility problem with the Xfce system, if
user’s mouse or keyboard don’t get any response in the Xfce system, please re-plug the USB
cable or change to other brand’s USB mouse or keyboard.

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
7
Figure 2-4 Setup for Xfce Desktop
Figure 2-5 Xfce Desktop Environment

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
8
Chapter 3
Software Installation
3.1 Introduction
This section explains how to install the following software:
Intel Quartus II software
Intel SoC Embedded Design Suite
Note: 64-bit OS required
3.2 Installing Quartus II software
The Intel Complete Design Suite provides the necessary tools used for developing hardware and
software solutions for Intel FPGAs. The Quartus II software is the primary FPGA development tool
used to create reference designs along with the NIOS II soft-core embedded processor integrated
development environment
User can download the latest software from:
https://www.altera.com/downloads/download-center.html

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
9
If you choose to install the Standard Edition, note that a purchased license will be required.
Please go to the following link for more information regarding the Standard Edition:
https://www.altera.com/support/support-resources/download/licensing.html
Download files from Standard or Lite edition page. You must download the Quartus II
Software (includes NIOS II EDS) and Cyclone V device support (includes all variations).

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
10
After the file is downloaded, select the *.exe file, and install the software. All of the defaults
are to be used.

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
11
3.3 Installing Intel SoC Embedded Design Suite
The Intel SoC Embedded Design Suite (EDS) contains development tools, utility programs, run-time
software, and application examples to enable embedded development on the Intel SoC hardware
platform. User can use the Intel SoC EDS to develop firmware and application software.
Users can download the software from the Intel webpage: http://dl.altera.com/soceds/
Intel® SoC FPGA Embedded Development Suite (SoC EDS) is available in two editions: Standard
Edition and Pro Edition. Both Editions include ARM Development Studio 5 (DS-5) for Intel SoC
FPGAs (license-managed). Please refer to the link list in below to get the comparison chart to
compare both versions. After downloading the software, follow the corresponding guide in License
Activation to activate your license.
https://www.altera.com/products/design-software/embedded-software-developers/soc-eds/getting-sta
rted.html

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
12
Chapter 4
Performing a FPGA System Test
4.1 Introduction
This chapter shows how to install the USB-Blaster II driver and download a FPGA SRAM Object
(.sof) file to your FPGA board.
4.2 Installing the USB-Blaster II Driver
The steps below outline the step-by-step process of installing the USB-Blaster II driver.
1. Connect your computer to the development board by plugging the USB cable into the USB
connector (J13) of DE10-Nan0-SoC. (connection shown in Figure 2-3)
2. Power up the board and open the device manager in Windows. You will find an unknown device.
Figure 4-1 Unknown device on device manager
3. Select the unknown device to update the driver software. The driver file is in the \<Quartus II
installation directory>\drivers\ usb-blaster-ii directory.

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
13
4. After the driver is correctly installed, the device will be recognized as Intel USB-Blaster II, as
shown in following picture.
Figure 4-2 USB-Blaster II driver is installed correctly
4.3 Downloading a FPGA SRAM Object File
The Quartus II Programmer is used to configure the FPGA with a specific .sof file. Before
configuring the FPGA, ensure that the Quartus II software and the USB-Blaster II driver are installed
on the host computer.
If users would like to program their SRAM Object File (.sof) into the Cyclone V SOC FPGA device
on the DE10-Nano board, there are two devices (FPGA and HPS) on the JTAG Chain. The configure
flow is different from the one used with DE0-Nano. The section below shows the step-by-step
procedure of programming flow with JTAG mode.
1. Connect your computer to the DE10-Nano board by plugging the USB cable into the USB
connector (J13) of DE10-Nano and power up the board. (details shown in Chapter 2)
2. Open the Quartus II software and select Tools > Programmer. The Programmer window will
appear.

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
14
Figure 4-3 Quartus Programer
3. Click Hardware Setup.
4. If DE-SoC [USB-1] does not appear under Currently Selected Hardware, select that option
and click Close, as illustrated below.
Figure 4-4 Hardware Setup

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
15
If the USB-Blaster II does not appear under hardware options list, please confirm if the USB-Blaster
II driver has been correctly installed, and if the USB cable has been properly connected between the
DE10-Nano board and host computer.
5. Click “Auto Detect”
Figure 4-5 Auto detect FPGA device
6. Select the device associated with the board
Figure 4-6 Select FPGA device
7. FPGA and HPS devices are shown in the JTAG chain

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
16
Figure 4-7 JTAG Chain on DE10-nano board
8. Click the FPGAdevice, click “Change File..”, and then select .sof file for FPGA

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
17
Figure 4-8 Add .sof file
9. Select \<CD directory>\Demonstration\FPGA\my_first_fpga\my_first_fpga.sof
Figure 4-9 Select .sof file

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
18
10. Click “Program/Configure” check box, and then click “Start” button to download .sof file into
FPGA
Figure 4-10 Downaload .sof file

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
19
Chapter 5
Running Linux on the DE10-Nano
board via UART Terminal
5.1 Introduction
This chapter illustrates the process of setting up a UART Terminal and connecting it to DE10-Nano
Board which will be running Linux at this moment. Also, the chapter will show how to create a
Micro SD card image with another board support image (BSP), such us Linux Console. User can
download the latest SD Card image file from Terasic’s website: http://de10-nano.terasic.com/cd.
5.2 Setting Up UART Terminal
This section presents how to install the drivers for the USB to UART chip on the DE10-Nano board
and how to set up the UART terminal on your host PC. The DE10-Nano board communicates with
the PC through the micro USB connector J4. You should install the USB to UART driver and
configure the UART terminal before you run Linux on the board.
Figure 5-1 Hardware Setup for UART Terminal

DE10-Nano
Getting Started Guide
July 25, 2017
www.terasic.com.tw
20
Installing the Driver
This section explains how to install the drivers for USB to UART communication. The necessary
steps on Windows 7 are:
1. Connect your computer to the development board by plugging the USB cable into the micro
USB connector (J4) of DE10-Nano. (connection shown in Figure 2-3)
2. Power on the board and open the computer device manager in Windows. You will find an
unrecognized FT232R USB UART.
Figure 5-2 Unknown device on device manager
Select the FT232R USB UART to update the driver software. The driver can be downloaded from
http://www.ftdichip.com/Drivers/VCP.htm.
3. After the driver has been correctly installed, the USB Serial Port is recognized as a port such
as COM5 (Open the device manager to know which COM port assigned in your computer)