AVMACZ80: Z80 Cross-Assembler User’s Manual

AVMACZ80: Z80 CROSS-ASSEMBLER USER’S MANUAL
	Title
	Copyright
	Contents
	List of Figures
1 Introduction
	1.1 Organization of this Manual
	1.2 Whom This Manual Is Written For
		1.2.1 Hints For Novices
		1.2.2 Recommended Reading
	1.3 System Requirements
	1.4 Syntax Notation In This Manual
	1.5 Getting Started
		1.5.1 Disk Contents
		1.5.2 Installing the Software
		1.5.3 Setting up the Environment
2 Running the Assembler, the Linker, and the Utilities
	2.1 Overview
	2.2 Running the Software
		2.2.1 The Assembler, AVMACZ80
		2.2.2 The Librarian, AVLIB
		2.2.3 The Linker, AVLINK
		2.2.4 The Cross Reference Report Generator, AVREF
		2.2.5 The Hex File Formatter, HEXFORM
3 Assembler Options
	3.1 Syntax of Options
	3.2 Where You May Specify Options
	3.3 Restrictions on Option Placement
	3.4 Setting Default Options
	3.5 Options and the Command Line
	3.6 Environment Variables
	3.7 Alphabetical List of Options
4 Assembly Language Elements
	4.1 Overview
	4.2 Symbols
	4.3 Local Symbols
	4.4 Numbers
	4.5 Expressions
		4.5.1 A Note on Boolean Values
	4.6 Evaluation of Expressions
	4.7 Operator Usage
		4.7.1 Arithmetic Operators and Parentheses
		4.7.2 Comparison Operators
		4.7.3 The LOW, HIGH, and NOT Operators
	4.8 Special Character Set
	4.9 Character Constants
	4.10 Location-Counter Reference
	4.11 Forward References
	4.12 Syntax Of Statements And Operands
		4.12.1 Statements
		4.12.2 Examples Of Statements
5 Program Structure and Data Definition
	5.1 Overview
	5.2 Program Structure
		5.2.1 Modular construction of programs
		5.2.2 PUBLIC and EXTERN
		5.2.3 INCLUDE
		5.2.4 Using segments
		5.2.5 Procedures
		5.2.6 The END pseudo-op
	5.3 Data Definition
		5.3.1 EQU and TEQ
		5.3.2 DEFINE
		5.3.3 DB, DW, and DS
6 Segments and Relocation
	6.1 Overview
	6.2 Segments
		6.2.1 Defining and Entering a Segment
	6.3 Absolute Code
	6.4 Fixed Relocatable Code
		6.4.1 The ORG statement
	6.5 Relocatable Segments
		6.5.1 OVERLAID Segments
		6.5.2 Linking relocatable code
		6.5.3 Segment Attributes
		6.5.4 Relocation via AVLINK
		6.5.5 Pre-defined Segment names
7 The Linker and Librarian
	7.1 Overview
	7.2 The AVLINK Linker
		7.2.1 Linking and Segments
	7.3 Linker Options
		7.3.1 Usage of Linker Options
		7.3.2 Segment and Relocation Options
		7.3.3 Hex File Options
		7.3.4 Map File Options
		7.3.5 Symbol File Options
		7.3.6 Miscellaneous Options
	7.4 Using AVLINK with a Command File
	7.5 The AVLIB Librarian
		7.5.1 Usage of the AVLIB Librarian
8 Macros and Conditional Assembly
	8.1 Overview
	8.2 Macros
		8.2.1 Testing for the presence of parameters - %IFB and %IFNB
		8.2.2 Comparing parameters - %IFEQ and %IFNE
		8.2.3 Immediate exit from a macro - %EXITM
	8.3 Conditional Assembly
		8.3.1 %IF - %ELSEIF - %ELSE - %ENDIF
		8.3.2 %SWITCH - %CASE - %DEFAULT - %ENDSW
		8.3.3 %REPT -%ENDREPT
		8.3.4 %FOR - %ENDFOR
		8.3.5 Dummy Parameters
		8.3.6 Use of %GENSYM to Generate Unique Labels
		8.3.7 Reproducing the contents of one file in another - % INCLUDE
9 Listings and Reports
	9.1 Overview
	9.2 The Listing File
		9.2.1 Address Field
		9.2.2 Code Field
		9.2.3 Line Number Field
		9.2.4 Source Code Field
	9.3 The Map File
		9.3.1 Additional map file sections
	9.4 The Report File
		9.4.1 Usage
		9.4.2 The Report File
		9.4.3 AVREF Options
A AVMACZ80 Error Messages
B Preprocessor Error Messages
C AVLINK Warning and Error Messages
D The Z80 Instruction Set
	D.1 Instruction Mnemonics and Opcodes
E Summary of Pseudo-Ops
F Tables of Assembler Options
G Tables of AVLINK Options
H Absolute Object File Formats
	H.1 Intel Hex Format
	H.2 Motorola Hex Format
	H.3 Tektronix Hex Format
I Changing from an XASM
J Text Editors
K ASCII character codes
Index