place at directive

In this section:

Syntax

[ "name": ]
place [ noload ] [ ram|rom ] at { address address | 
      start of region_expr [ with mirroring to mirror_address ] |
      end of region_expr [ with mirroring to mirror_address ] }
      
{
  extended-selectors
}
[ except
 {
   section-selectors
 } ];

For information about extended selectors and except clauses, see Section selection.

Parameters

`name`	Optional. If it is specified, it is part of the name of any ELF output sections resulting from the directive, is used in the map file, and in some log messages. (There is no connection to names used in the application.)
`noload`	Optional. If it is specified, it prevents the sections in the directive from being loaded to the target system. To use the sections, you must put them into the target system in some other way. `noload` can only be used when a `name` is specified.
`ram\|rom`	Optional. If `ram` or `rom` is specified, this directive interacts with the `build for rom` directive to ensure that read-only content can only be placed on ROM addresses, and that read/write content cannot be placed on ROM addresses. If `build for ram` has been specified, the `place at` directive has no effect on it. Note that if no `build for` directive has been specified, `build for ram` is used by default. See build for directive.
`address`	The start address for the placement.
`start of` `region_expr`	A region expression that results in a single-internal region. The start of the interval is used.
`end of` `region_expr`	A region expression that results in a single-internal region. The end of the interval is used.
`mirror_address`	If `place at ... with mirroring to` is specified, the contents of any sections are assumed to be mirrored to a memory range starting at this address. Debug information and symbols will appear in the mirrored area, but the actual content bytes are placed as if `with mirroring to` was not specified. Note: `place at ... with mirroring to` supports a hardware feature that allows access to ROM constants as if they were placed in RAM. If your target device does not support this mechanism, mirroring will not be useful. `place at ... with mirroring to` cannot be used for copy initialization of code or data (see instead initialize directive).

Description

The place at directive places sections and blocks either at a specific address or, at the beginning or the end of a region. The same address cannot be used for two different place at directives. It is also not possible to use an empty region in a place at directive. If placed in a region, the sections and blocks will be placed before any other sections or blocks placed in the same region with a place in directive.

Note

with mirroring to can be used only together with start of and end of.

Example

/* Place the RO section .startup at the start of code_region */
"START": place at start of ROM { readonly section .startup };

IAR Embedded Workbench for Arm 9.70.x

place at directive

Syntax

Parameters

Description

Example

See also

Search results