Altera Nios II - Manual (Page 16)

3–2 Chapter 3: Using the Flash Programmer from the Command Line
nios2-flash-programmer
Nios II Flash Programmer User Guide © March 2014 Altera Corporation
nios2-flash-programmer
The nios2-flash-programmer utility programs a preformatted file into a specified
flash memory. The input is an industry-standard S-record file, normally created by
one of the conversion utilities, sof2flash, elf2flash, or bin2flash.
nios2-flash-programmer
can use any S-record file as an input, provided that the
addresses specified in the S-record file represent offsets from the beginning of flash
memory. The Nios II Flash Programmer GUI creates flash programmer files with a
.flash
extension.
The nios2-flash-programmer utility is capable of programming, erasing, or reading
from any CFI-compatible flash memory or EPCS/EPCQ serial configuration device in
the hardware target design.
The nios2-flash-programmer command-line syntax is as follows:
nios2-flash-programmer [--help] [--cable=]\
[--device=] [--instance=]\
[--sidp=
1
Before you can program flash memory on your board, you must configure your FPGA
with a flash programmer target design that contains at least the minimum component
set specified in
Table 1–1 on page 1–3 .
f For instructions to configure the FPGA, refer to the Quartus II Programmer chapter in
volume 3 of the Quartus II Handbook.
Table 3–2 lists the parameters commonly used with nios2-flash-programmer.
Table 3–2. nios2-flash-programmer Parameters (Part 1 of 3)
Name Required Description
General Parameters
--cable= Required if there are
multiple download
cables connected to the
host computer. Specifies which download cable to use. (1)
--device= Required if there are
multiple devices in the
JTAG chain. Specifies the FPGA's device number in the JTAG
chain. The device index specifies the device where
the flash programmer looks for the Nios II JTAG
debug module. JTAG devices are numbered relative
to the JTAG chain, starting at 1.
(2)
--instance= Required if there are
multiple Nios II
processors with JTAG
debug modules in the
target design on the
FPGA. Specifies which Nios II JTAG debug module to look
at in the FPGA. The instance ID specifies the JTAG
debug module that is used for programming flash
memory.
(3)
--sidp= Optional; required for
system ID validation. Contains the base address of the System ID
component in your system. This value is in
hexadecimal format (for example, 0x01000000)
(4)