Using the SDRAM on Altera’s

DE1-SoC Board with Verilog Designs

For Quartus Prime 16.0

1 Introduction
This tutorial explains how the SDRAM chip on Altera’s DE1-SoC Development and Education board can be used
with a Nios II system implemented by using the Altera Qsys tool. The discussion is based on the assumption that
the reader has access to a DE1-SoC board and is familiar with the material in the tutorial Introduction to the Altera
Qsys System Integration Tool.

The screen captures in the tutorial were obtained using the Quartus® Prime version 16.0; if other versions of the
software are used, some of the images may be slightly different.

Contents:

• Example Nios II System

• The SDRAM Interface

• Using the Qsys tool to Generate the Nios II System

• Integration of the Nios II System into the Quartus Prime Project

• Using the Clock Signals IP Core

Altera Corporation - University Program 1

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

2 Background
The introductory tutorial Introduction to the Altera Qsys System Integration Tool explains how the memory in a
Cyclone series FPGA chip can be used in the context of a simple Nios II system. For practical applications it is
necessary to have a much larger memory. The Altera DE1-SoC board contains an SDRAM chip that can store 64
Mbytes of data. The memory is organized as 8M x 16 bits x 4 banks. The SDRAM chip requires careful timing
control. To provide access to the SDRAM chip, the Qsys tool implements an SDRAM Controller circuit. This circuit
generates the signals needed to deal with the SDRAM chip.

3 Example Nios II System

As an illustrative example, we will add the SDRAM to the Nios II system described in the Introduction to the Altera
Qsys System Integration Tool tutorial. Figure 1 gives the block diagram of our example system.

Host computer

USB-Blaster
Reset_n Clock interface

FPGA chip

JTAG Debug JTAG UART

Nios II processor interface
module

Avalon switch fabric

Switches LEDs
On-chip SDRAM
memory controller parallel input parallel output
interface interface

SW7 SW0 LEDR7 LEDR0

SDRAM
chip

Figure 1. Example Nios II system implemented on the DE1-SoC board.

2 Altera Corporation - University Program

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

The system realizes a trivial task. Eight toggle switches on the DE1-SoC board, SW 7 − 0, are used to turn on or
off the eight red LEDs, LE DR7 − 0. The switches are connected to the Nios II system by means of a parallel I/O
interface configured to act as an input port. The LEDs are driven by the signals from another parallel I/O interface
configured to act as an output port. To achieve the desired operation, the eight-bit pattern corresponding to the state
of the switches has to be sent to the output port to activate the LEDs. This will be done by having the Nios II
processor execute an application program. Continuous operation is required, such that as the switches are toggled
the lights change accordingly.

The introductory tutorial showed how we can use the Qsys tool to design the hardware needed to implement this
task, assuming that the application program which reads the state of the toggle switches and sets the red LEDs
accordingly is loaded into a memory block in the FPGA chip. In this tutorial, we will explain how the SDRAM chip
on the DE1-SoC board can be included in the system in Figure 1, so that our application program can be run from
the SDRAM rather than from the on-chip memory.

Doing this tutorial, the reader will learn about:

• Using the Qsys tool to include an SDRAM interface for a Nios II-based system

• Timing issues with respect to the SDRAM on the DE1-SoC board

Please note that the SDRAM interface described in this tutorial should also work when the user changes to use the
Arm-A9 Processor instead of Nios II Processor in the system.

4 The SDRAM Interface

The SDRAM chip on the DE1-SoC board has a capacity of 512 Mbits (64 Mbytes). Each chip is organized as 8M x
16 bits x 4 banks. The signals needed to communicate with a chip are shown in Figure 2. All of the signals, except
the clock, can be provided by the SDRAM Controller that can be generated by using the Qsys tool. The clock signal
is provided separately. It has to meet the clock-skew requirements as explained in section 7. Note that some signals
are active low, which is denoted by the suffix N.

Figure 2. The SDRAM signals.

Altera Corporation - University Program 3

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

5 Using the Qsys tool to Generate the Nios II System

Our starting point will be the Nios II system discussed in the Introduction to the Altera Qsys System Integration Tool
tutorial, which we implemented in a project called lights. We specified the system shown in Figure 3.

Figure 3. The Nios II system defined in the introductory tutorial.

If you saved the lights project, then open this project in the Quartus Prime software and then open the Qsys tool.
Otherwise, you need to create and implement the project, as explained in the introductory tutorial, to obtain the
system shown in the figure.

To add the SDRAM, in the window of Figure 3 select Memory Interfaces and Controllers > SDRAM > SDRAM
Controller and click Add. A window depicted in Figure 4 appears. Set the Data Width parameter to 16 bits, the
Row Width to 13 bits, the Column Width to 10 bits, and leave the default values for the rest. Since we will not
simulate the system in this tutorial, do not select the option Include a functional memory model in the system
testbench.

4 Altera Corporation - University Program

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

Figure 4. Add the SDRAM Controller.

Select the Timing tab to get to the window in Figure 5. Configure the SDRAM timing parameters by setting Issue one
refresh command every to 7.8125 microseconds, Duration of precharge command (t_rp) to 15.0 nanoseconds,
ACTIVE to READ or WRITE delay (t_rcd) to 15.0 nanoseconds, and Access time (t_ac) to 5.4 nanoseconds.
Click Finish.

Figure 5. SDRAM Timings

Now, in the window of Figure 3, there will be an sdram controller module added to the design. Rename this module
to sdram. Connect the SDRAM to the rest of the system in the same manner as the on-chip memory, and export the
SDRAM wire port. Double-click on the Base Address of the sdram and enter the value 0x08000000 to produce the

Altera Corporation - University Program 5

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

assignment shown in Figure 6.

Figure 6. The expanded Nios II system.

To make use of the SDRAM, we need to configure the reset vector and exception vector of the Nios II processor.
Right-click on the nios2_processor and then select Edit to reach the window in Figure 7. Select sdram to be
the memory device for both reset vector and exception vector, as shown in the figure. Click Finish to return to the
System Contents tab and regenerate the system.

6 Altera Corporation - University Program

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

Figure 7. Define the reset vector and the exception vector.

The augmented Verilog module generated by the Qsys tool is in the file nios_system.v in the nios_system\synthesis
directory of the project. Figure 8 depicts the portion of the code that defines the input and output signals for the
module nios_system. As in our initial system that we developed in the introductory tutorial, the 8-bit vector that is
the input to the parallel port Switches is called switches_export. The 8-bit output vector is called leds_export. The
clock and reset signals are called clk_clk and reset_reset_n, respectively. A new module, called sdram, is included.
It involves the signals indicated in Figure 2. For example, the address lines are referred to as the output vector
sdram_wire_addr[12:0]. The data lines are referred to as the inout vector sdram_wire_dq[15:0]. This is a vector of
the inout type because the data lines are bidirectional.

Altera Corporation - University Program 7

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

Figure 8. A part of the generated Verilog module.

6 Integration of the Nios II System into the Quartus Prime Project

Now, we have to instantiate the expanded Nios II system in the top-level Verilog module, as we have done in the
tutorial Introduction to the Altera Qsys System Integration Tool. The module is named lights, because this is the
name of the top-level design entity in our Quartus Prime project.

A first attempt at creating the new module is presented in Figure 9. The input and output ports of the module use the
pin names for the 50-MHz clock, CLOCK_50, pushbutton switches, KEY, toggle switches, SW, and red LEDs, LEDR,
as used in our original design. They also use the pin names DRAM_CLK, DRAM_CKE, DRAM_ADDR, DRAM_BA,
DRAM_CS_N, DRAM_CAS_N, DRAM_RAS_N, DRAM_WE_N, DRAM_DQ, DRAM_UDQM, and DRAM_LDQM,
which correspond to the SDRAM signals indicated in Figure 2. All of these names are those specified in the DE1-
SoC User Manual and included in the file called DE1_SoC.qsf, which can be found on Altera’s DE1-SoC web page
at https://www.altera.com/support/training/university/boards.html

Finally, note that we tried an obvious approach of using the 50-MHz system clock, CLOCK_50, as the clock signal,
DRAM_CLK, for the SDRAM chip. This is specified by the assign statement in the code. This approach leads to
a potential timing problem caused by the clock skew on the DE1-SoC board, which can be fixed as explained in
section 7.

8 Altera Corporation - University Program

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

// Implements the augmented Nios II system for the DE1-SoC board.

// Inputs: SW7−0 are parallel port inputs to the Nios II system.
// CLOCK_50 is the system clock.
// KEY0 is the active-low system reset.
// Outputs: LEDR7−0 are parallel port outputs from the Nios II system.
// SDRAM ports correspond to the signals in Figure 2; their names are those
// used in the DE1-SoC User Manual.
module lights (SW, KEY, CLOCK_50, LEDR, DRAM_CLK, DRAM_CKE,
DRAM_ADDR, DRAM_BA, DRAM_CS_N, DRAM_CAS_N, DRAM_RAS_N,
DRAM_WE_N, DRAM_DQ, DRAM_UDQM, DRAM_LDQM);
input [7:0] SW;
input [0:0] KEY;
input CLOCK_50;
output [7:0] LEDR;
output [12:0] DRAM_ADDR;
output [1:0] DRAM_BA;
output DRAM_CAS_N, DRAM_RAS_N, DRAM_CLK;
output DRAM_CKE, DRAM_CS_N, DRAM_WE_N;
output DRAM_UDQM;
output DRAM_LDQM;
inout [15:0] DRAM_DQ;
// Instantiate the Nios II system module generated by the Qsys tool
nios_system NiosII (
.clk_clk (CLOCK_50),
.reset_reset_n (KEY[0]),
.switches_export (SW),
.leds_export (LEDR),
.sdram_wire_addr (DRAM_ADDR),
.sdram_wire_ba (DRAM_BA),
.sdram_wire_cas_n (DRAM_CAS_N),
.sdram_wire_cke (DRAM_CKE),
.sdram_wire_cs_n (DRAM_CS_N),
.sdram_wire_dq (DRAM_DQ),
.sdram_wire_dqm ({DRAM_UDQM,DRAM_LDQM}),
.sdram_wire_ras_n (DRAM_RAS_N),
.sdram_wire_we_n (DRAM_WE_N)
);
assign DRAM_CLK = CLOCK_50;
endmodule

Figure 9. A first attempt at instantiating the expanded Nios II system.

Altera Corporation - University Program 9

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

As an experiment, you can enter the code in Figure 9 into a file called lights.v. Add this file and all the nios_system.qip
file produced by the Qsys tool to your Quartus Prime project. Compile the code and download the design into the
Cyclone V FPGA on the DE1-SoC board. Use the application program from the tutorial Introduction to the Altera
Qsys System Integration Tool, which is shown in Figure 10.

.equ Switches, 0x00002010

.equ LEDs, 0x00002000
.global _start
_start:
movia r2, Switches
movia r3, LEDs
loop: ldbio r4, 0(r2)
stbio r4, 0(r3)
br loop

Figure 10. Assembly language code to control the lights.

Use the Altera Monitor Program, which is described in the tutorial Altera Monitor Program, to assemble, download,
and run this application program. If successful, the lights on the DE1-SoC board will respond to the operation of the
toggle switches.

Due to the clock skew problem mentioned above, the Nios II processor may be unable to properly access the SDRAM
chip. A possible indication of this may be given by the Altera Monitor Program, which may display the message
depicted in Figure 11. To solve the problem, it is necessary to modify the design as indicated in the next section.

Figure 11. Error message in the Altera Monitor Program that may be due to the SDRAM clock skew problem.

10 Altera Corporation - University Program

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

7 Using the Clock Signals IP Core

The clock skew depends on physical characteristics of the DE1-SoC board. For proper operation of the SDRAM
chip, it is necessary that its clock signal, DRAM_CLK, leads the Nios II system clock, CLOCK_50, by 3 nanoseconds.
This can be accomplished by using a phase-locked loop (PLL) circuit which can be manually created using the IP
Catalog. It can also be created automatically using the Clock Signals IP core provided by the Altera University
Program. We will use the latter method in this tutorial.

To add the Clock Signals IP core, in the Qsys tool window of Figure 5 select University Program > Clock >
System and SDRAM Clocks for DE-Series Boards and click Add. A window depicted in Figure 12 appears.
Select DE1-SoC from the DE Board drop-down list. Click Finish to return to the window in Figure 5.

Figure 12. Clock Signals IP Core

Remove the system clock component clk_0. All other IP cores (including the SDRAM) should be adjusted to use
the sys_clk output of the Clock Signal core. Rename the Clock Signal core to clocks and export the sdram_clk signal
under the name sdram_clk, the ref_clk signal under the name clk, and ref_reset signal under the name reset. The
final system is shown in Figure 13. Click on Generate > Generate HDL... and regenerate the system.

Altera Corporation - University Program 11

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

Figure 13. The final Nios II system.

Next, we have to fix the top-level Verilog module, given in Figure 9, to instantiate the Nios II system with the Clock
Signals core included. The desired code is shown in Figure 14. The SDRAM clock signal sdram_clk generated by
the Clock Signals core connects to the pin DRAM_CLK. Note that the sys_clk signal is not connected since it is for
internal use only.

12 Altera Corporation - University Program

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

// Implements the augmented Nios II system for the DE1-SoC board.

// Inputs: SW7−0 are parallel port inputs to the Nios II system.
// CLOCK_50 is the system clock.
// KEY0 is the active-low system reset.
// Outputs: LEDR7−0 are parallel port outputs from the Nios II system.
// SDRAM ports correspond to the signals in Figure 2; their names are those
// used in the DE1-SoC User Manual.
module lights (SW, KEY, CLOCK_50, LEDR, DRAM_CLK, DRAM_CKE,
DRAM_ADDR, DRAM_BA, DRAM_CS_N, DRAM_CAS_N, DRAM_RAS_N,
DRAM_WE_N, DRAM_DQ, DRAM_UDQM, DRAM_LDQM);
input [7:0] SW;
input [0:0] KEY;
input CLOCK_50;
output [7:0] LEDR;
output [12:0] DRAM_ADDR;
output [1:0] DRAM_BA;
output DRAM_CAS_N, DRAM_RAS_N, DRAM_CLK;
output DRAM_CKE, DRAM_CS_N, DRAM_WE_N;
output DRAM_UDQM, DRAM_LDQM;
inout [15:0] DRAM_DQ;
// Instantiate the Nios II system module generated by the Qsys tool
nios_system NiosII (
.clk_clk (CLOCK_50),
.reset_reset (~KEY[0]),
.switches_export (SW),
.leds_export (LEDR),
.sdram_wire_addr (DRAM_ADDR),
.sdram_wire_ba (DRAM_BA),
.sdram_wire_cas_n (DRAM_CAS_N),
.sdram_wire_cke (DRAM_CKE),
.sdram_wire_cs_n (DRAM_CS_N),
.sdram_wire_dq (DRAM_DQ),
.sdram_wire_dqm ({DRAM_UDQM,DRAM_LDQM}),
.sdram_wire_ras_n (DRAM_RAS_N),
.sdram_wire_we_n (DRAM_WE_N),
.sdram_clk_clk (DRAM_CLK)
);
endmodule

Figure 14. Proper instantiation of the expanded Nios II system.

Compile the code and download the design into the Cyclone V FPGA on the DE1-SoC board. Use the application
program in Figure 10 to test the circuit.

Altera Corporation - University Program 13

May 2016
 U SING THE SDRAM ON A LTERA’ S DE1-S O C B OARD WITH V ERILOG D ESIGNS For Quartus Prime 16.0

Copyright ©1991-2016 Altera Corporation. All rights reserved. Altera, The Programmable Solutions Company, the
stylized Altera logo, specific device designations, and all other words and logos that are identified as trademarks
and/or service marks are, unless noted otherwise, the trademarks and service marks of Altera Corporation in the
U.S. and other countries. All other product or service names are the property of their respective holders. Altera
products are protected under numerous U.S. and foreign patents and pending applications, mask work rights, and
copyrights. Altera warrants performance of its semiconductor products to current specifications in accordance with
Altera’s standard warranty, but reserves the right to make changes to any products and services at any time without
notice. Altera assumes no responsibility or liability arising out of the application or use of any information, product,
or service described herein except as expressly agreed to in writing by Altera Corporation. Altera customers are
advised to obtain the latest version of device specifications before relying on any published information and before
placing orders for products or services.

This document is being provided on an “as-is” basis and as an accommodation and therefore all warranties, repre-
sentations or guarantees of any kind (whether express, implied or statutory) including, without limitation, warranties
of merchantability, non-infringement, or fitness for a particular purpose, are specifically disclaimed.

14 Altera Corporation - University Program

May 2016