Assembly Language Translators pdf

ASSEMBLY LANGUAGE TRANSLATORS

i!k)z z7y)i rrrvr

_tixji

_--

Z-System Tools

USER'S GUIDE

by

Robert

_Doolittle

ITOZ, TZOI, ITOT and TTOI

_{are Copyright}

1982, 1985 by RD

SOFTWARE. No

_part

_of

_this

_{document may} be _reproduced

_in

_{any way}

or

by any means

without

prior

written

permission of publisher.

Address

_{requests to}

Echelon,

_Inc.,

101

_First

_Street,

Los

_Altos,

TABLE' OF CONTENTS

Paqe

Author's

P'ote

...

_{... ii}

ITOZ _and ZTOI USER'S GUIDE _{. .}

..

.

_{.. .. ..}

. . . .

_..

. . .

_{.. .. ..}

1

COMMAX"D _{LINE FORMAT}

. . . 2

INPUT _FILE FORMAT RULES

.. ..

. . .

..

. .

..

. . . .

..

.

..

.

..

3

EXECUTION _{. . . .}

. . . _. . . . 5

ADNAME _{. . . .}

. . . _. . . . L)

EXTEXDED 8080 VERSUS ZILOG _Z-80 MNEMOYIC TABLE

.. ..

7

rrcvr and trrrn

_user's

guide _{. . . .}

..

. . . _. 9

com1A.\'D LINE FORMAT _{. . . .}

. . . 10

IR'PLJT _FILE FORMAT RULES _{. .}

.

_{.. .. .. ..}

. _.

..

. . .

.. .. .. ..

11

EXECUTION _{. . . .} 13

ADNAP1F

. . . 14

EXTENDED 8080 VERSUS TDL/CDL MNEMONIC TABLE _{. .}

.. ..

15

-Author's Note

These _programs have been _{thoroughly tested} arid _{are belíeved to} be

_correct.

_If

_you

_find

soE:_ething not t.o your 1ikiñ9

let

us know. We welcorne _your comments, _{criticjs!Tls or}

quest-i

ons, Please

call

_{or m"ite}

if

you experience arre probien"is.

Robert

_Doolittle

Echelon Team Member 1290 Mouu1Tíertt _Street Telephone 213/454-8270

Pacific Palisades, CA ₉₀₂₇₂

—1

I-* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

* *

* _{ITÍ)Z and} ZTOI USER'S GUIDE *

:k *

* _{Copyright 1982,} 1985 by RD SOFTWARE *

* *

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

These programs

translate

assembly _source code from

_Intel

extended 8080 tQ

_Ztlog

Z-80 mnemonics (ITOZ) and x:

ice

versa

(ZTQI). The output- source

file

is wri-tten

to disk

and

i

5

ccmµletely formatted and _ready

_for

_assembly. The _extended 8080

set is that defined

by

_Digital

Research

_in

_their

_macro

_library

Z8U.LIB

_furnished

wit.h

_their

_{macro assembler} MAC. Please not-e

that

_if

your source programs use only the 8080 subset-

of

the Z-80 inst-

_ructions

then _you need not be concerned

_{with the}

Z80.LIB extensions.

The _{use of} ITOZ _and ZTOI _{are nearly}

_identical.

_Therefore

_in

what- _{fcAlows we}

_{shall just refer to}

ITOZ

_with

the understanding

that

_it

also applies

_to

ZTOI _except where noted.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

* *

* _{comAND LINE} K)RMAT *

* *

* * * * * * * * * * * * * * * * * * * * * * jk _{* * * *} jAe _{* * * *}

To _{execute ITOZ}

_{for translation}

_of

_{an 8080 source program}

to Zilog

Z-80 _mnemonícs

_the

Z-System (and CP/M) command Ji-ne

format

_is:

A_'ITOZ

if

j lenamel

_f

_ijetype]

[ _{,'0] [ofijename} ]

[filetype]

where the parameters

_in

_square bracket s _are

optional

.

if

ilename=input _source

_f

_íle

name

of

ilename=output _source

_f

_ii

e name

/O=options _{as described} below

To _maintain

_{compatibility}

_w.ith some assemblers t".wo _switch

options _are

_available.

The _slash ( .l')

must immediately

_follow

the input

_file

name _or

filetype

if

used. Oríjy one slash

is

_necessary

for either

or both options.

The "c"

_option

_will

add a

colon

after

a

label

if

_{one does}

not

_{already exist.}

The "s"

_option

_will

_{convert asterisks,}

used

as comrnent

line delimiters,

to

semicolons i-n the output

file.

To invoke both options,

_for

example, the format would be:

,/c's _or ,/sc

If

you are

translat-ing

a

file

that- _uses a double

colon

t-o

represent a

public label

do not _{use the} "c" swit-c:h.

An

_optional

output-file

name

is also permit-ted

_on

the

command

_line.

If

this optional

name

is omitted

then the

default

out-put-

_file

_name

_for

ITOZ

_is

ZLG.ASM and

_for

ZTOI

_is

X80.ASN.

CP'"M

i

5 a regí stered trademark

of Digi-tal

Research; Z-Syster.i

is

a

* * * * * * * * * * * * * * * * * * * * :k _{* * * * * * * * * * *}

* :k

* INPUT _FILE FORMAT RULES *

* *

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

Certain

_input

_source

_{f lle}

format-

_rules

must be

_{followed to}

obtain

a successful

translation.

Many

of

these _are

dictated

by

common assembler syntax

rules.

The

rules

_{are as}

follows:

1. Only one

instruction

per

line is

permitted

2.

_{All instructions}

must be

_in

_{upper case}

3. Each

_line

_{must terminate}

_in

_a

_{carriage returri}

and

_line

_feed

4. No

_line

_{numbers are permitted}

_{in this}

version 3. Lines must be _{less than} 128 _{characters long}

i.ncluding comments

6.

_{All labels}

must

_{start in}

column one

7

. The mnemonic or

instruct

ion

f

ield

must be preceded

by _at

_least

_{one space or tab}

if

no label

is

present.

8

. There must: be at

least

one space or tab between the

end

_of

_{a label} and _{the beginning of} t.he _{instrtlct-j.c)r)}

unless the label ends

_in

a colon

9. EQTJ _{and SET pseudo-op}

statements may beg in in arr," colurnri

10. Other pseudo-ops _{or macro} names must _{begin as}

defined

_{fur instructions}

_in

Rule 7

li

. Comment

lines

must be preceded by a semicolori or

asterisk

and _{may begin}

_in

_{any colunrí}

12 _. Comments

_{following instructions}

_{on the same}

_line

must also begin

_with

a semicolon _or

asterisk

arid must- be _{preceded by at}

_least

_{one space or tab only}

if

the

_asterisk

i-s used

Blank

_lines,

_as

_well

_as

_{blank lines}

_following

_a

_label,

_{a re}

supported _.

Due

_to

_the

_{variety of}

_{ass3errlbler pseudo-ops} sorne compromises

had

_to

be _{made. There}

_is

_a

_logical

_{problem wit-h pseudo-ops}

starting

with

an

asterisk

and comment

lines delimited

by an

asterisk.

This

_is

solved

_in

these

_translators

by the

_following

additional

rule:

13.

_If

pseudo-ops _{are used which}

_{start with}

an

asterisk

then a label must be used on the same

line.

The

label

, "- of course, _may be _a dummy _. Id

addition,

actual comment

lines following

a label must be delirni-t.ed by a

sem-zcol _{on .}

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

* *

* EXECUTION *

* *

* * * * * * * * * * * * * * * * gt _{* * * *} X _{* * * * * * * * * *}

When _{program execution begins} ITOZ

_will

_prirít

a message on

the

_{terminal indicating}

_that

the t

_{ranslation is}

uríderway.

_If

an

unrecognizable

_{inst ruction is}

encourit.ered a syntax

_error

message

is displayed at

the console ale-mg

_with

_a

_line

_number

_indicator.

This

_{line is}

also flagged

_in

the output

_file

by the comment

_line

"FOLLOWING INSTRUCTION NOT RECOGNIZED." The

_translator

makes _no

attempt to

_{translate this line}

but simply copies

_it

_to

the cmtput

file.

_{yj c)}

s t- o

f

_t

h e _common

pseudo-ops

a

_r

e imc-luded

in

t.he

translator's intrrríal

tables.

_If

voLt₄ get a syñtcíx

_{error for}

a

pseudo-op _{or macro} narne which _appears irí _your :

i-nput source

_f

.lle you should then run the

utility,

ADNAME.COM _as

_described

bt")ow.

This

w

ill

preverit-

_{future occurrences of}

thi-s

_error.

As _not ed

below,

_this

_utility

does not

_translate

_or,

_more

_accurat-ely,

.it-results

in

a one-to-oríe

_{trarislatiorí}

(exact copy)

_of

ent-ire I .i-nt".

In

_all

CPU

_instructions

_that

_involve

ar. index

register

disp!arement-, the

_translators

_will

_interpret-

the

_explicit

lack of

a di-sµ1acernent _argument

_to

imply the value-" O.

0

* * * * * * * * * * * * * * * * * * * * * * * * * :k _{* * * * * *}

* *

" ADNAME.COM *

* *

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

This

_utility

permits the _user

_to

add cust-om _{macro names or}

pseudo-ops

_to

the

_translator's

_internal

_tabj

_es.

_It

_will

operat.e

on

either

ITOZ.COM

_or

ZTOI.CO31.

It

will

also operate

on

either

of

t-hese

_files

_if

_they

have been renamed. Please note

_that

_no

translatiurí

occurs

for

these names. The use

of

ADNAME

_permits

the

_translators

_{to recognize}

these _{names and}

_to

_copy

_{the line}

from

_{the input}

_file

t-o _t-he

_output

file

without

generating

aíi

error

message.

If

you experience

difficulty

wit.h assembly

of

a

translated

_file

_it

may be _necessary

to edit

the

translated

fije

to correct for

the

_particular

pseudo-ops _{used by your assembler.}

The coinmand

_line

_format

_for

ADNAME

_is:

A.'ADNANIF

_{f i}

_i

ename .COM

where

_'f

ilenarne'

_is

ITOZ, ZTOI,

_or

whater"er ycm may harí·

reríamed them. The _program

_will

_{then prompt you}

_for

_{the ríew names}

to

he _entered. Each

_{entry is}

_{terminated by a}

_{carriage return.}

A

blank line

(CR)

_{terminates the}

_{program. The}

_old

file

is

renamed wit: h the sanie filename and

with

a

fi.letype of

BAK. The new

file

is

renamed

_with

the _same

_filename

and

_with

a

filetype

of

COM. The _new COM

_{file will}

_{include your} new names.

If

_{you wish you} may

erase the BAK

file.

We

strongly

recommend, however,

that

you

a l_ways keep a backup copy cif the

original

files.

The _space

_{allocated in}

_the

_translators

_{for this function is}

2()0

_bytes.

If

N

_is

_{the number}

_of

_new

names and C

is the

_total

nunber of characters

_in

the new names t.hen 2*N"C must: be ': = _200.

Atternr't: s t-o _exceed

_this

_number

_will

_not be _accepted and _{a warning}

message

will

be issued.

ADNAYF. may be used on

the currerit

COM

file

_as

often

_{as you}

please.

Any new _names

will

be added

to

those

already included

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

* *

* EXTENDED 8080 VERSUS ZIIÁJG _Z-80 MNEMONIC TABLE *

* *

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

These

_translat-ors

_use an extended 8080 mnemonic set which

is

similar

to the Technical

Design

_Laboratories

(TDL) mnemonics.

Al!

Trít-ei 8080 mnemonics _are

_preserved.

The Z-80

_peculiar

inst"ruc't ions dNífer

from

_the

ZILOG _{mnemonics as shown}

_{in the}

accompanyi-ng

_table.

_This

mnemonic set

_{is identi.cal}

t-o

that-released

by

_Digital

Research _{as Z80.I.IB}

_to

be _used

_with

_their

cp,"yj "MAC" _{Macro Assembler.} The

_followiríg

_corívent i_ons _{are used}

irí

the

_table.

r

_-

any

register

or memory

rr

- any

register pair

or stack

pointer

nn _- 8

bit

immediate data (O

to

255) d

-

8 bN: signed displacement- (-128

to

127)

nnnn

_-

16

bit

address _or immediate data (O

to

6553!!Á b

-

bit

number (O

to

7, 7

is

most

5ignificar)t)

addr _- 16

_bit

_address

_within

PC+127 _through PC-128

In

cases

involving

a displacement., d,

t-his

parameter

is

always

last

one

iri

operand

field.

EXT 8080 ZILOG EXT 8080 ZILCG

LD\"

r

,d LD

_r,(lX"d)

LDIR LDIR

LDY _{r ,d} I,T) _{í-,(IY+dl LDD LDIJ}

STX _{r ,d} LD

_UX"d),r

LDDR LDDH

STY _{r ,d} LD

_{(Iv-d) ,r}

CCI CPI

M\'IX nn ,d LD

_(Ix"d)

_,nn CCIR CPIR

P1\'IY _{rín ,d} LD _{(1Y"d) ,nn} CCD CPI)

LDAI LD A, T _{CCDR CPDR}

LIJAR LD A ,R ADDX d ADD _(Ix+d)

STAT LD

_I

,A ADDY d ADD _(IYTd)

star

ld

_r

,a adcx d _adc

ax-a

LXIX nnnn LD _{IX ,nnnn} ADCY d ADC _(1Y"d)

LXIY nnnn LD _{IV ,nnnri} SUBX d SUB _(IX-d)

LBCD nnnn LD BC, (_{nnnn) SIJBY d SUB (Í9'+d)}

LDED nnnn LD DE, _(nnnn) SBBX d SBC (IX+CÍ)

LSPD nnnn LD SF', _(nnnn) SBBY d SBC (j"Y"+d)

LIXD nnnn LD _{IX, (rinnn)} ANAX d AND _(lX+d)

LIYD nnnn LD _{IY, (nnnn)} ANAY d AND (1Y"d)

SBCD _nnnn LD _(nnnn ) _{,BC XRAX d XOR}

(Ix±d)

SDED _nnnn LD _(nnnn ) _{,DE XRAY d XOR}

(1Y+d)

SSPD _nnnn LD _(nnnn) ,SP ORAX d OR _(IX"CÍ)

SIXD _nnnn LD _{(nnnn) ,IX} ORAY d OR _(1Y+d)

SIYD nnnri LD _{(nnnrí) , IV} CMPX d CP _(IX+dl

SPIX LD _SP,IX CP1PY _{d CP (1Y+d)}

SPIY LD _SP,IY INRX d INC _(IX+dl

PCSHIX _{push IX INRY} d INC _(Tjí-d)

PUSHIY PUSH _IY DCRX d DEC UX+-D

POPIX POP _IX DCRY d DEC _(1Y"d)

POPIY POP _IV NEG NEG

EXAF EX AF _,AF' IMÚ _IN Ó

EXX EXX IM1 _IM

l

XTTX EX (SP) _,IX IM2 IM 2

XTIY EX (SI?) _,IY DADC

rr

ADC FIL,

rr

LDI LDT DSBC

rr

SBC FIL,

rr

DADX

_rr

ADD

_IX,rr

OIJTI OUTI

DADY

rr

ADD IY,

rr

OUTIR OTIR

INXIX INC _IX IND IND

INXI-Y INC TY INDR INDR

DCXIX DEC _IX OUTD OL'TD

DCXIY DEC _IY OUTDR OTDR

BIT b,

_r

_{BIT b, r} RLCR

r

RLC

r

SETB _{b, r} SET _b,

_r

RLCX d RLC _(IX-uji)

RES _b,

r

RES b,

r

RLCY d RLC (IY+CÍ)

BITX _{b,d BIT b,(lX+d)} RALR

r

_rl

r

BITY b

_A

_BIT

_b,(IY+D

RALX d RL (JX-¢J)

SETX b,d SET b,(1x+d) RALY d RL (IY"Á)

sety b, d _{set b,(IY+¿j)}

rrcr

r

_{rrc r}

RESX _b,d RES b,(1k"-d) RRCX d RRC (IX-ól)

RFSY _b, d RES _b,

_lIY"d)

RRCY d RRC (jYm¿j)

JR addr JR addr RARR

r

RR

r

JRC addr JR C _{,addr RARX d RR}

(Ix-d)

JRNC _addr JR INC _{,addr RARY} d RR _(1Y+¿j)

JR7, addr JR Z _{,addr SLAR}

r

SLA

r

JR?'Z addr JR !"Z ,addr SLAX d SLA _(Tx+d)

DJNZ _addr DJNZ _, addr SLAY d SLA

_(Iv-d)

pcí X" _{JP (IX) SRAR}

r

SRA

r

PCIY JP (lV) SRAX d SRA (IX"d)

RE'TI RETI SRAY d SRA (IY+d)

RETK RETN SRLR

_r

SRL

_r

II'I?

_r

IN

_r,

(C) SRLX d SRL (IX+CÍ)

OL'TP

_r

OUT

_(C),r

SRLY d SRL _(1Y"d)

INI INT RLD RLD

INIF'. I.ClEé RRD RRD

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

* :k

* IIYJT _{and TK)I} USER'S GUIDE *

* *

* _{Copyright 1982,} 1985 _by RD SOFTWARE *

* *

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

These programs

translate

assembly _source code from

_Int.el

extended 8080

_to

TDL,"CDL _{(Xitan) mnemonics (ITOT)} and

_vice

_versa

(TTÜI). The

_output

_source

_file

_{is written}

_{to disk}

and

i-s

completely formatted and ready

_for

assembly. The _extended 8080

set is that defined

by

_Digital

Research

_in

_their

_macro

_library

Z80.LIB

_{furnished with}

_their

_macro assembler MAC. _{Please note}

that

_if

your source programs use only the 8080 subset

of

the Z-80

inst-ructions

then _you need not be concerned

_{with the}

Z80.LI13

ext.ensions .

The _use

_of

ITOT _and TTOI _{are nearly}

_identical.

_Therefore

_in

what

_follows

we

shall just refer to

ITOT

_with

_the understanding

that

_it

also

_{applies to}

TTOI _{except where noted.}

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

9:

*

* COMMAND _LINE FORMAT *

* _*

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * To _execute ITOT

_{for translation}

_{of an} 8080 _source

program t-o TDL/'CDL _{mnemonics the Z-System (and} CP "M) command

_line

_format

_is:

A ITOT

if

ilename!

_filetypel

_lofi

leriame]

_Ifiletype)

where t.he _parameters

_in

_{square brackets}

arr

opt.ional .

ifilename=input

source

file

name

of ílename=output _source

_{f íle}

name The c-)l")tiona] _output

file

name default-s

_to

X80.ASY

for

TTOT _arid t-cj TDL.ASM

_for

TTOT

ITOT

_will

_{automatically}

:

insert

colons

_after

_labels,

_if

rint

present, since the TDL/CDL _{assembler requires them.}

It

will

also ccmvert _any

_asterisks,

used as commerít

delimiters,

t-o semic: olons

* * * * * * * IK _{* * * * * * * * * * * * * * * * * * * * * * * *}

* *

* INPUT _FILE FORMAT RULES *

* *

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

Cert-ain

_input

_source

_{f lie}

format

_rules

must be

_{followed to}

obtain

a successful

translation.

Many

of

these _are

dictated

by

common assembler syntax

rules.

The

rules

_{are as}

follows:

1. Only one

instruction

per

line is

permitted

2.

_{All instructions}

must be

_in

_{upper case}

3. Each

_line

_{must terminate}

_in

_a

_{carriage returrl}

and

lime feed

4. No

_line

_{numbers are permitted}

_{in this}

_versiorí

5. Lines must be _{less than} 128 _{characters long}

inc hiding comments

6.

_{All labels}

must

_{start in}

column one

7. The mnemonic _{or iríst-ruc'tion}

_{f ield}

_must be _preceded by at"

_least

one _{space or tab}

if

no label 15 present

8. There must be

_{at least}

_{one space or tab between the} end

of

a labol and the beginning

of

the

instruction

unless

thr

label ends i-n _{a colon}

9. EQL' _{and SET pseudo-op statements}

may begin

in

cíny col umn

l0.

Other pjseLld(")-ops _{or macro names} must _{begiri as defined}

fur instructions

in

Rule 7

li.

Comment

_lines

_must be _{preceded by a semicolon or}

_asterisk

and _{may begin}

_in

_{any column.} (See _{also Rule}

_U)

1.2

. Comments

following instruct

ions on the same I ine must

also begin

_with

a semicolon _or

asterisk

and must- be

preceded by at

_least

one _{space or tab only}

if

the

asterisk is

used

Blank

_lines,

_as

_well

_as

_{blank lines}

_following

a

label

, are

supported.

Due _{to the}

_{variety of}

assembler pseudo-ops some compromises

had

_to

be made. There

_is

a

logical

problem

with

pseudo-ops

starting

with

an

asterisk

and comment

lines delimited

by an

asterisk.

This

_is

solved

_in

these

_translators

by the

_followiríg

additional rule:

13.

_If

pseudo-ops _{are used which}

_{start with}

an

asterisk

then

-- a label must be used on the same

line.

The

label

may,

of course, be _a dummy. _In

_addition,

_actual comment. _limes

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

* *

* EXECUTION *

* *

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * When _{program execution begins} ITOT

_will

_print

a _message on

the

_{terminal indicating that}

the

_translation

_is

underway.

_If

an

unrecognizable

_instruction

_is

encountered a syntax

_error

message

is displayed at

the

_console

along

_with

a

line

number

indicator.

This

_{line is}

also flagged

_in

the output

_file

by _the comment

_line

"FOLLOWING INSTRUCTION NOT RECOGNIZED." The

_translator

makes _no

attempt

_{to translate this line}

but simply copies

_it

_to

the output

file.

Most o

f t

h e coInmQr)

pseudo-ops

a

_r

e

included

i

n

t

h e

translator's

internal

tables.

_If

you get a syntax

_{error for}

a

pseud(")-c)p _{or macro name which appears}

_in

_{your input source}

_{f lle}

you should then run

the

utility,

ADNAME.COP1 _as

_described

below.

This

_will

_{prevent future occurrences of}

_this

_error.

As _noted

below,

_this

_utility

does nut.

_translate

_or,

more

accurately,

it-results

in

a

one-to-one translation

(exact

copy)

of the eritire

line

.

These

_translators

do not support. the TDL _.DEFINE (MACRO)

pseudo-op

_{since there is not, in general,}

a unique

translation.

These _can

_usuallv

be _handled

_after

_translat.ion

_with

_an

_editor.

-L

The _.EXIT (EXITM) _pseudo-op

_is

_{included, however.}

All

arithmetic

and

_logical

_{operators of the}

TDL

_set

_are

supported

_with

the exception _{of the unary}

_radix

change.

Three of the

_conditional

assembly pseudo-ops of the TDL set.

are

supported.

These

_are:

.IFN

_(IF)

which

_{is false}

_if

_{i t}

s

argument

_{evaluates to}

_zero and

_{true otherwise,}

.IFB

_(IF

NUI.)

which

_{is true}

_if

_it.s

argument

_{is blank,}

and .IFNB (IF NOT NUT.)

which

_{is true}

_if

_its

argument

_is

ríüt

_blank.

The ELSE

_construct

is

a]sc)

_supported.

No

_{part of the}

_body

_{of the}

_IF

or

ELSE

_is

perrnit-ted on the same

line

_{as the} IF statement

_itself.

_Left

and

right

square

brackets

must- _{surround the arguments}

_of

_{.IFB arid}

* * * :k _{* *} X _{* * *} X X _{* * * * * * * * * * * * * * * * * *} 9r 9t

* *

* ADNAME _.COM _*

* *

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

This

_utility

permits

the _user

_to

add custom _{macro names}

_or

pseudo-ops to the

_translator's

_internal

_tables.

_{It will}

operate

on

either

ITOT.COM

_or

TTOT.CO.Y.

It

will

also operate

on

either

of

these

_fijes

_if

_they

have been renamed. Please note

_that

no

translation

occurs

for

these names. The use

of

ADNAP1E

_permits

the

t:

_ranslators

_{to recognize}

_{these names and}

_to

_copy

_{the line}

from

_{the input}

_file

_to

the

_output

_file

_without

_generating

_an

error

message.

If

you experience

difficulty

with

assembly

of

a

translated

_fije

_it

may be _necessary

to edit

the

translated

file

to correct for

the

_particular

pseudo-ops _{used by your assembler.}

The command

_line

_format

_for

ADNAME

_is:

MADNAME _filename

where

_{'filename' is}

ITOT, TTOI _{or whatever you} may havc' renamed

them. A

_filetype

_of

COM

_{is automatically}

_{assigned by} ADNAME. The

program

will

then prompt you

for

the new _names

to

be

entered.

Each

_{entry is}

_{terminated by a}

_{carriage return.}

A _blank

_line

(CR)

terminates the

program. The

old

file

is

renamed

with the

same

filename

and

_with

a

filetype

of

BAK. The new

file

is

renamed

wit-h the same filename and

with

a

fi-letype of

COM. The _new COM

file

wAl

include _your new names.

If

_{you wish you} may _erase the

E3AK

f

i

le. We

_strongly

_{recommend, however,}

that

you always keeE"' a

backup _copy

_{of the original}

_files.

_{The space}

_allocated

_in

the

translators

for this function is

200 _bytes.

If

N

is

the rmmber

_of

new names and C

is the

_total

number

_{of characters}

_in

the new

names then 2*K'"C must be q = 200. Attempts

_to

exceed

this

number

wíll

not- be _accepted and _{a warning message}

_will

be _issued.

AM"AME may be used on t.he

current

COM

file

_as

ofterí

_as

you

please.

Any new _names

will

be added

to

those

already

included and _{a new} COM

* * * Ik _{* * * * * * * * * * * *} :k _{* * * * * * * * * * * * * * *}

* *

* EXTENDED 8080 VERSUS TDL/CDL MNEMONIC TABLE *

* *

* * * * * * * * * * * * * * * * * * * * * * * * * :k _{* * * * * *}

The Z-80

_peculiar

_instructions

_for

TDL

_differ

_from

_the

extended 8080

_set

_{as used here.} The extended 8080 mnemonic set

is identical

to that released

by Di-g-ital Research _{as Z80.LIB}

_to

be used

_with

_their

CP/M "MAC" _{.'lacro Assembler. The}

_following

convent.ions _are used

_in

the

_table.

r

- any

register

or memory

rr

-

any

regíster pair

or stack

pointer

nn _- 8

bit

immediate data (O

to

255) d

- 8

bit

signed displacement (-128

to

127)

nnnn

_-

16

bit

address _{or immediate} data (O

to

65535) b

-

bit

number (O

to

7, 7

is

most

significant-)

addr

_-

16

_bit

_address

_within

PC+127 _through PC-12R

In

cases

involving

a

displacement,

d,

this

parameter

_is

always

the

_last

_one

_in

operand

_field.

EXT 8080 TDL EXT 8080 TDL

LDX

_r

_,d MOV

r,d(X)

LDIR LDIR

LDY

r

,d MOV _r,óÍ(Y) I,DD LDD

STX

r

,d MOV _{dl X)}

,r

LDDR LDDR

STY

r

,d MOL' Óí(fí)

,r

CCI CCI

.YIVIX _{rin ,d} YIVI CÍ(X) _,r"írj CCIR CCTR

!'1\"IY _{rirí ,d} M'JI _d(Y),nn CCD CCD

LDAI LDAI CCDR CCDR

LDAR LIJAR ADDX d ADD _d(X)

STAI STAI ADDY d ADD _d(Y)

STAR STAR ADCX d ADC _d(x)

LXIX nnnn LXl X,nnnn ADCY d ADC _d(v)

LXIY nrínn IJXI Y

,nnnn SUBX d SUB _d(x)

LBCD _nnnn LBCD _nnnn SUBY d SUB _d(Y)

LDED nnnn LDED nnnrí SBBX d SBB _d(x)

I,SPD _nnnn LSPD nnnn SBBY d SBB _d(Yl

LIXD nrínn LIXD nnnn ANAX d ANA _d(x)

LIYD nnnn LIYD nnnn ANAY d ANA _d(Yl

SBCD _nnnn SBCD nnnn XRAX d XRA _d(X)

SDED nrínn SDED nnrín XRAY d XRA _d(Y)

SSPD _nnnn SSPD nnnn ORAX d ORA _d(X)

SIXD nnnn SIXD _nnnn ORAY d ORA _d(Y)

SIYD _nnnn SIYD _nnnn CMPX d CMP _d(x)

SPIX SPIX CMPY d CMP _d(Y)

SPIY SPIY INRX d INR _d(X)

PUSHIX PUSH X _{INRY d INR d(Y)}

PUSHIY PUSH Y DCRX d DCR _d(X)

POPIX POP X _{DCRY d DCR}

d(Y)

POPIY POP Y _{NEG NEG}

EXAF EXAF IMO IMO

EXX Ek"X _IPll 1-¶1

XTIX _XTlX IP12 IM2

XTJY XTIY DADC

rr

DADC r-r

LDI LDI DSBC

rr

DSBC

rr

DADX

rr

DADX

_rr

OUTI OÜTI

DADY

rr

DADY

rr

OUTIR OUTIR

INXIX INX X _{IND IND}

INXIY INX y INDR INDR

DCXIX DCX X _{OUTD OUTD}

DCXIY DCX Y _{OUTDR OUTDR}

BIT -b,

r

BIT b,

r

RLCR

r

RLCR

r

SETB _b,

r

SET b,

r

RLCX d RLCR d(X)

RES _b,

r

RES b,

r

RLCY d RLCR CÍ(Y)

BITX b,d BIT b,d(X) RALR

r

ralr

r

BITY b,d BIT b,dci") RALX d RALR _d(Xj

SETX _b,d SET

_b,d(x)

_raly

d RALR _d(V)

SETY b _{,d set b,dcv)} RRCR

r

RRCR

r

RESX b_,d RES

_b,d(x)

RRCX d RRCR _d(X)

resy b,d RES _b,d(Y)

_rrcy

d

rrcr

&Y)

JR _addr JMPR _addr RARR

r

RARR

r

JRC _addr JRC _addr RARX d RARR d(X"l

JRNC _addr JRNC _addr RARY d RARR _dlY)

JRZ _addr JRZ _addr SLAR

_r

SLAR

_r

JRNZ _addr JRNZ _addr SLAX d SLAR CÍ(X)

DJNZ _addr DJNZ _addr SLAY d SLAR C1(Y)

pcI!í" PCIX SRAR

_r

SRAR

r

PCJ y PCIY SRAX d SRAR _d(jO

RETI RETI SRAY d SRAR CJ(Y)

RETIV RETN SRLR

r

SRLR

_r

IM'

_r

INF'

r

SRLX d SRLR d(X)

OLTP _r OUTP

r

SRLY d SRLR d(Y)

TKT _INI RI.D RL.D

For TTOI _the

_{following additional translations}

_are

_valid:

JPE _nnnn JO nnnn JPO nnnn JNO nnnn

CPE nnnn CO _{ñññrj CPO nnnn CNO nnnn}

RPE RO _{RPO RNO}

The

_following

_pseudo-ops and _{operators are also included}

_in

both

_{translat-ors:}

SET = EQIJ

PAGE .PAGE _{TITLE .TITLE}

IF .IFN END .END

IF NEIL _{.IFB IF} NOT NUL _.IFNB

DS(2) .BLKW DW _.WORD

DB .BYTE DB _.ASCII

DS .BLKB ORG .LOC

ENTRY .ENTRY EXTRP' .EXTERN

ELSE _]{ ENDTF ]

RADIX .RADIX _{LIST .LIST}

XLIST .XLIST EXIT _.EXIT

$

. NOT #

ylor-) @

or

!

XOR "" _AND &

SHR < SHL ..>

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *