Keil™, An ARM® Company

RealView Linker and Utilities Guide

Specifying an image memory map

3.1.3. Specifying an image memory map

An image can consist of any number of regions and output sections. Any number of these regions can have different load and execution addresses. To construct the memory map of an image, armlink must have information about:

Grouping

How input sections are grouped into output sections and regions.

Placement

Where image regions are to be located in the memory maps.

Depending on the complexity of the memory maps of the image, there are two ways to pass this information to armlink:

Using command‑line options

The following options can be used for simple cases where an image has only one or two load regions and up to three execution regions:

  • ‑‑ro‑base

  • ‑‑rw‑base

  • ‑‑ropi

  • ‑‑rwpi

  • ‑‑split

  • ‑‑rosplit

The options listed above provide a simplified notation that gives the same settings as a scatter‑loading description for a simple image. For more information, see Using command-line options to create simple images.

Using a scatter‑loading description file

A scatter‑loading description file is used for more complex cases where you require complete control over the grouping and placement of image components. To use scatter-loading, specify ‑‑scatter filename at the command‑line. This is described in full in Chapter 5 Using Scatter-loading Description Files.

Copyright © 2007 ARM Limited. All rights reserved.ARM DUI 0377A