Epson S1C62 Family 4.6.2Macro-definitions, CNT, SBC, A,1, ENDM, ENDM, WAIT, LOOP, LOOP, ENDM, MACRO, LOCAL, A,CNT, ■LOCAL, NZ,LOOP, LD X,ADDR, LD REG,MX, ■MACRO ~ ENDM

CROSS ASSEMBLER ASM62XX

4.6.2Macro-definitions

The macro-definition should be done by using the MACRO and the ENDM instructions (pseudo-instruc- tion).

■MACRO ~ ENDM<Macro-name>_ MACRO_ [<Dummy-argument>, ...] 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 regarding 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,ADDRLD X,ADDRLD REG,MXENDM

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_<Label-name>[,<Label-name>...]

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	←	Replaces LOOP with ??nnnn at expansion.
LOOP	SBC	A,1
	JP	NZ,LOOP
	ENDM

III-16	EPSON	S1C62 FAMILY
		DEVELOPMENT TOOL REFERENCE MANUAL