3.4. Built-in variables and constants

Table 3.4 lists the built-in variables defined by the ARM assembler.

Table 3.4. Built-in variables

{ARCHITECTURE}

Holds the name of the selected ARM architecture.

{AREANAME}Holds the name of the current AREA.
{ARMASM_VERSION}Holds an integer that increases with each version of armasm.
|ads$version|Has the same value as {ARMASM_VERSION}.

{CODESIZE}

Is a synonym for {CONFIG}.

{COMMANDLINE}Holds the contents of the command line.

{CONFIG}

Has the value 32 if the assembler is assembling ARM code, or 16 if it is assembling Thumb code.

{CPU}

Holds the name of the selected CPU. The default is “ARM7TDMI”. If an architecture was specified in the command line --cpu option, {CPU} holds the value "Generic ARM".

{ENDIAN}

Has the value “big” if the assembler is in big-endian mode, or “little” if it is in little-endian mode.

{FPIC}Has the boolean value True if /fpic is set. The default is False.
{FPU}Holds the name of the selected FPU. The default is “SoftVFP”.
{INPUTFILE}Holds the name of the current source file.
{INTER}Has the boolean value True if /inter is set. The default is False.
{LINENUM}Holds an integer indicating the line number in the current source file.

{OPT}

Value of the currently-set listing option. The OPT directive can be used to save the current listing option, force a change in it, or restore its original value.

{PC} or .

Address of current instruction.

{PCSTOREOFFSET}

Is the offset between the address of the STR pc,[…] or STM Rb,{…, pc} instruction and the value of pc stored out. This varies depending on the CPU or architecture specified.

{ROPI}Has the boolean value True if /ropi is set. The default is False.
{RWPI}Has the boolean value True if /rwpi is set. The default is False.

{VAR} or @

Current value of the storage area location counter.


Built-in variables cannot be set using the SETA, SETL, or SETS directives. They can be used in expressions or conditions, for example:

        IF {ARCHITECTURE} = "4T"

The built-in variable |ads$version| must be all in lowercase. The names of the other built-in variables can be in uppercase, lowercase, or mixed. For example:

        IF {CpU} = "Generic ARM"

Note

All built-in string variables contain case-sensitive values. See CPU names for valid values for {CPU} and {ARCHITECTURE}. See FPU names for valid values for {FPU}. Relational operations on these built-in variables will not match with strings that contain an incorrect case.

Table 3.5 lists the built-in Boolean constants defined by the ARM assembler.

Table 3.5. Built-in Boolean constants

{FALSE}

Logical constant false.

{TRUE}

Logical constant true.


Copyright © 2002-2010 ARM. All rights reserved.ARM DUI 0204J
Non-ConfidentialID101213