ABSENTRY - Application entry point

Syntax
  ABSENTRY <label>
  
  
Synonym

None

Description

This directive is used to specify the application Entry Point when the Assembler directly generates an absolute file. The -FA2 assembly option - ELF/DWARF 2.0 Absolute File - must be enabled.

Using this directive, the entry point of the assembly application is written in the header of the generated absolute file. When this file is loaded in the debugger, the line where the entry point label is defined is highlighted in the source window.

This directive is ignored when the Assembler generates an object file.

Note: This instruction only affects the loading on an application by a debugger. It tells the debugger which initial PC should be used. In order to start the application on a target, initialize the Reset vector.

If the example in the following listing is assembled using the -FA2 assembler option, an ELF/DWARF 2.0 Absolute file is generated.

Listing: Using ABSENTRY to specify an application entry point

       ABSENTRY entry
       ORG   $fffe

Reset: DC.W  entry

       ORG   $70

entry: NOP

       NOP

main:  RSP

       NOP

       BRA   main

According to the ABSENTRY directive, the entry point will be set to the address of entry in the header of the absolute file.