Absolute List File - Epson S5U1C62000A Manual

CHAPTER 6: LINKER

6.8 Absolute List File

The absolute list file is an assembly source file that carries the absolute addresses and object codes added
to the first half of each line. It is delivered only when the -l option is specified. Its file format is a text file,
and the file name is <file name>.als. (The <file name> is the same as that of the output object file.) While
a relocatable list file can be made for each assembly source file, the absolute list file is made as a single
file integrating all the linked objects and their according sources.
Sample absolute list file
Linker 62 ver x.xx Absolute list file "TEST.ALS" Sat May 30 07:53:14 1998
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
11:
12:
13:
14:
15:
16:
17:
18:
19:
20: 0100 e08
21: 0101 fe0
22: 0102 e00
23: 0103 ff0
24: 0104 e42 (+)
25: 0105 400
26:
27: 0106 e00
28: 0107 e10
29:
30: 0108 e42 (+)
31: 0109 406
32: 010a 008
: : :
Contents of absolute list file
The format of each line of the absolute list file is as follows:
Line No. Absolute address
Line No. Indicates the line number from the top of the file.
Address Indicates the absolute address after the instruction is allocated.
Code Indicates the object code.
Source The contents of the assembly source file are delivered.
Results of automatic pset insertion/deletion/correction
As the result of automatic pset insertion/deletion/correction, the pset instruction may be coded
without accordance to the source part. To show the result of such code optimizations clearly, the
following description will be made on an absolute list file.
When "pset" is inserted:
"(+)" is placed to the right of the code part. There is no original source for the code but the disas-
sembled "pset <bank/page number>" is delivered at the source part.
When "pset" is deleted:
"(-)" is placed to the left of the original source part. The original statement appears at the source
part in the list file but no code is delivered.
When the operand of "pset" is corrected:
"(*)" is placed to the left of the source statement.
Instructions preprocessed in the assembler
The instructions expanded in the assembler (macros, include sources, JPM instruction and CALLM
instruction) are listed with a "+".
98
; main.s
; test program (main routine)
;
;***** INITIAL SP ADDRESS DEFINITION *****
#define SP_INIT_ADDR 0x80
;***** MACRO DEFINITION
#macro CL_AB
ld a,0
ld b,0
#endm
;***** BOOT, LOOP *****
.global
.global
.org 0x100
BOOT:
ld a,SP_INIT_ADDR>>4
ld sph,a
ld a, SP_INIT_ADDR&0xf
ld spl,a
pset 0x2
call INIT_RAM_BLK1
CL_AB
+ ld a,0
+ ld b,0
LOOP:
pset 0x2
call INC_RAM_BLK1
jp LOOP
:
Code Source statement
EPSON
;SP init addr = 0x80
INIT_RAM_BLK1 ; subroutine
INC_RAM_BLK1 ; subroutine
; set SP
; initialize RAM block 1
;
; increment RAM block 1
; infinity loop
(S1C60/62 FAMILY ASSEMBLER PACKAGE)
CL_AB
S5U1C62000A MANUAL