Output File Controls

9

refer to the page specified in the table.

Defines public symbols on the command

line.

–

323

Generate bank switch code for Infineon

TV TEXT devices SDA555x and

SDA30C16x.

NAME

323

Specifies a module name for the object

file.

NOAJMP

325

Generate bank switch code without

AJMP instructions.

NOINDIRECTCALL

327

Do not generate by default bank switch

code for indirectly called functions.

–

328

Do not generate bank switch code.

NOTYPE

327

Specifies a module name for the object

file.

OBJECTCONTROLS

325

Excludes debug information from the

330

object file.

322

Chapter 9. Linker/Locator

ASSIGN

9

Restriction:

This control is available in LX51 and L251 only.

Abbreviation:

AS

Arguments:

ASSIGN (symname (value) , ... )

Default:

None

Description:

ASSIGN defines a PUBLIC symbol whit a numeric value at

Lx51 linker/locater level. The PUBLIC symbol is handled

Example:

In this example the public symbols FUNC and BITVAR are

defined. The value 0x2000 is given as value for FUNC.

The value 20H.2 is used as bit-address for BITVAR.

324

Chapter 9. Linker/Locator

NAME

9

Abbreviation:

NA

Arguments:

NAME (modulename)

Default:

Module name of the first object file in the input list is used.

µVision2 Control:

Options – Lx51 Misc – Misc Controls – enter the control.

Description:

Use the NAME control to specify a module name for the

absolute object module that the BL51 linker/locator

Example:

In this example BIGPROG is the module name stored in the

object file.

Default:

The Lx51 linker/locater generates for code banking

applications an inter-bank jump table. This bank switch

table is used for jumps into a code bank from a different

code bank or the common area. Depending on the table size,

the linker uses AJMP or LJMP instructions within this bank

switch table.

µVision2 Control: Options – Lx51 Misc – Misc Controls – enter the control.

Description:

With the NOAJMP control you can disable the AJMP

instruction in the inter-bank jump table. This option is

required for 8051 derivatives that are not supporting the

AJMP instruction.

See Also:

IBANKING, NOINDIRECTCALL, NOJMPTAB,

BANKAREA

Example:

BL51 MYPROG.OBJ NOAJMP

326

9

Restriction:

Abbreviation:

Default:

Description:

See Also:

Example:

9

Default:

In code banking applications, the Lx51 linker/locater inserts

an interbank CALL for each function that is indirectly called

via a function pointer. This is done (by the linker) to ensure

that functions which are invoked through a function pointer

are available to all code banks.

See Also:

IBANKING, NOAJMP, NOJMPTAB, BANKAREA

Example:

328

Chapter 9. Linker/Locator

NOJMPTAB

9

Restriction:

This control is available in BL51 only.

Abbreviation:

NOJT

Default:

The Lx51 linker/locater generates for code banking

automatically an inter-bank jump table or bank switch table.

For each function that is located in a code bank and is called

from a different code bank or the common area the linker

inserts a bank switch code into the inter-bank jump table

redirects the function call to this table.

Description:

When the NOJMPTAB control is stated, BL51 no longer

inserts inter-bank calls for program calls. This feature is

implemented to use the user-defined bank switch mechanism

for code banking. The NOJMPTAB directive modifies the

following features of BL51:

The linker no longer needs the bank switch configuration

file: L51_BANK.OBJ.

The linker does not modify any jump call instructions.

The linker does not generate any warnings if a jump/call is

made to another bank. The user must ensure that the proper

bank is selected before a call is made since the BL51

linker/locator no longer selects the bank automatically.

See Also:

IBANKING, NOAJMP, NOINDIRECTCALL,

BANKAREA

Example:

BL51 MYPROG.OBJ NOJMPTAB

NOTYPE

NOTY

Include complete type information in the output file.

Options – Lx51 Misc – Misc Controls – enter the control.

The NOTYPE control removes symbol type information for

debug symbols from the output file. The symbol type

information is only required for program debugging and has

no influence on the executable code.

NOTE

Symbol type information in the absolute object file is used

for symbolic debugging in the µVision2 debugger or in-

circuit emulator. The Cx51 compiler generates complete

symbol information up to structure members and parameter

passing values. If you exclude symbol type information, you

might no be able to display variables during debugging.

OBJECTCONTROL, PURGE

9

Restriction:

This control is available in LX51 and L251 only.

Abbreviation:

OC

Arguments:

OBJECTCONTROLS (subcontrol , … )

Default:

Include complete debug information in the output file.

Description:

The OBJECTCONTROLS control allows you to remove

specific debug information from the object output file. The

subcontrol option can be one or more of the following

parameters:

NOLINES

NOPUBLICS

NOSYMBOLS

NOSYMBOLS, OBJECTCONTROLS, PURGE

Example: