Tool usage, Tool usage -18 – Altera SoC Embedded Design Suite User Manual

Page 183

Advertising
background image

Figure 7-5: Header Format

Simple Checksum

Program Length

Reserved (0x0)

Flags

Version

Validation Word (0x31305341)

0x48
0x44
0x40

Tool Usage

The preloader image tool has three usage models:
1. Single image creation

2. Quad image creation

3. Single or quad image decoding
If an error is found during the make image process, the tool stops and reports the error. Possible error

conditions include:
• The input image size is equal to or less than 80 bytes

• The input image size is equal to or greater than 60 kilobytes (KB)
mkpimage invokes the preloader image tool; invoking the tool with the

--help

option provides a tool

description and tool usage and option information.

$ mkpimage --help
mkpimage version 14.1 (build 182)

Description: This tool creates an Altera BootROM-compatible image of Second
Stage Boot Loader (SSBL). The input and output files are in binary format.
It can also decode and check the validity of previously generated image.

Usage:
Create quad image:
mkpimage [options] -hv <num> -o <outfile> <infile> <infile> <infile> <infile>
Create single image:
mkpimage [options] -hv <num> -o <outfile> <infile>
Decode single/quad image:
mkpimage -d [-a <num>] <infile>

Options:
-a (--alignment) <num> : Address alignment in kilobytes, valid value
starts from 64, 128, 256 etc, default to 64 for
header version 0 and 256 for header version 1,
override if the NAND flash has a larger block
size
-d (--decode) : Flag to decode the header information from
input file and display it
-f (--force) : Flag to force decoding even if the input file
is an unpadded image
-h (--help) : Display this help message and exit
-hv (--header-version) <num> : Header version to be created (Arria/Cyclone V =
0, Arria 10 = 1)
-o (--output) <outfile> : Output file, relative and absolute path
supported
-off (--offset) <num> : Program entry offset relative to start of
header (0x40), default to 0x14. Used for header
version 1 only
-v (--version) : Display version and exit

7-18

Tool Usage

ug-1137

2013.05.03

Altera Corporation

HPS Preloader User Guide

Send Feedback

Advertising