Source Listings - Texas Instruments TMS320C54x User Manual

3.12 Source Listings

A source listing shows source statements and the object code they produce.
To obtain a listing file, invoke the assembler with the –l (lowercase L) option.
Two banner lines, a blank line, and a title line are at the top of each source list-
ing page. Any title supplied by a .title directive is printed on the title line; a page
number is printed to the right of the title. If you don't use the .title directive, the
name of the source file is printed. The assembler inserts a blank line below the
title line.
Each line in the source file may produce a line in the listing file that shows a
source statement number, an SPC value, the object code assembled, and the
source statement. A source statement may produce more than one word of
object code. The assembler lists the SPC value and object code on a separate
line for each additional word. Each additional line is listed immediately
following the source statement line.
Field 1: Source Statement Number
Line Number
The source statement number is a decimal. The assembler numbers
source lines as it encounters them in the source file; some state-
ments increment the line counter but are not listed. (For example,
.title statements and statements following a .nolist are not listed.)
The difference between two consecutive source line numbers indi-
cates the number of intervening statements in the source file that are
not listed.
Include File Letter
The assembler may precede a line with a letter; the letter indicates
that the line is assembled from an included file.
Nesting Level Number
The assembler may precede a line with a number; the number indi-
cates the nesting level of macro expansions or loop blocks.
Field 2: Section Program Counter
This field contains the section program counter (SPC) value, which
is hexadecimal. All sections (.text, .data, .bss, and named sections)
maintain separate SPCs. Some directives do not affect the SPC and
leave this field blank.
Source Listings
Assembler Description 3-31