Epson S1C62 Family - Manual (Page 46)

CROSS ASSEMBLER ASM62XX
III-16 EPSON S1C62 FAMILY
DEVELOPMENT TOOL REFERENCE MANUAL
4.6.2 Macro-definitions
The macro-definition should be done by using the MACRO and the ENDM instructions (pseudo-instruc-
tion).
■ MACRO ~ ENDM
_ MACRO_ [, ...]
Statement
:
ENDM
The statement block enclosed by a MACRO pseudo-instruction and an ENDM pseudo-instruction is
defined as a macro. Any name can be assigned to the macro as long as it conforms to the rules regard-
ing the characters, length, and label field.
A macro can have an argument passed to it when it is called. In this case, any symbol can be used as a
dummy argument in the macro definition where the actual argument is to be substituted and the same
symbol must be written after the MACRO pseudo-instruction. Multiple dummy arguments must be
separated by commas (,).
Be sure to write the ENDM statement at the end of a macro-definition.
Example: This macro loads data from the memory location specified by ADDR into the A or B register specified
by REG. Sample call: LDM A,10H
LDM MACRO REG,ADDR
LD X,ADDR
LD REG,MX
ENDM
These dummy arguments are replaced by actual arguments when the macro is expanded.
■ LOCAL
If a macro having a label is expanded at multiple locations, the label duplicates, causing an error. The
LOCAL pseudo-instruction prevents this error occurring.
LOCAL_[,...]
The label specified by the LOCAL pseudo-instruction is replaced by "??nnnn" when the macro is
expanded. Field nnnn is a four-digit decimal field, to which values 0001 to 9999 are assigned
sequentially.
The LOCAL pseudo-instruction must be written at the beginning of the macro. The LOCAL pseudo-
instruction is ignored if another instruction precedes it.
Example:
WAIT MACRO CNT
LOCAL LOOP
LD A,CNT
LOOP SBC A,1
←
Replaces LOOP with ??nnnn at expansion.
JP NZ,LOOP
ENDM