ENCODER MANUAL - APPENDIX 3


		SUMMARY OF ASSEMBLER DIRECTIVES

	From BASIC	&A"FILENAME"/DIRECTIVES

	From MONITOR	A"FILENAME"/DIRECTIVES

Note: If FILENAME is omitted then the title NO NAME is provided.

	Assembles the current source file into machine code. The type of assembly and the 
destination of the object code is determined by the following directives.

DIRECTIVE			ACTION

/NO			No object code generated.

/NL			No assembly listing displayed.

/NS			No symbol table displayed.

/AM			Object code assembled to memory.

/LP			Assembly listing to printer.

/OL			Old labels and values retained. Allows
			chained assembly of multiple source files.

Note: If directives /AM or /NO are not used then the object code will be assembled to tape 
using the specified filename header.

EXAMPLES

	&A/AM/LP	Assembly command from BASIC. Assembly listing to printer. Object 
			code stored in memory starting at location specified by the opening 
			ORG pseudo - opcode. Stack space should be cleared below start 
			location by BASIC CLEAR 200, &H[start address in hex] statement 
			before starting the assembly.

	&A"CAR RACE"	Assembly command from BASIC. Assembly listing to screen. Object 
			code sent to tape under filename "CAR RACE".


ENCODER MANUAL - APPENDIX 4

		SUMMARY OF ASSEMBLER PSEUDO - OPCODES

PSEUDO - OP			ACTION

ORG			Set program origin

FCB			Form single byte constants

FDB			Form double byte constants

FCC			Form character string constants

RMB			Reserve memory within program

EQU			Define value for label

SET			Re-define label's value

END			Indicate end of program. May also give transfer address.

SETDP			Indicate to assembler current Direct Page default value


	These are used as though they are opcodes; the operand being tabbed and entered 
as appropriate.


ENCODER MANUAL - APPENDIX 5

		SUMMARY OF MONITOR COMMANDS

COMMAND				MEANING


OPENING AND DISPLAYING MEMORY CONTENTS

@xxxx			Displays contents of memory location xxxx.

	DOWN ARROW	Displays contents of next memory location.

	"		Displays ASCII equivalent of contents of current location.

	CHANGING CONTENTS OF MEMORY

	'TEXT'		Inserts ASCII vlaues of text enclosed between single quote marks.

	YY,ZZ etc	Inserts bytes yy and zz at current location and next location etc.

ENTER			Returns to monitor command mode.


DISASSEMBLY

Dxxxx			Disassembles 14 lines of program to screen at memory location xxxx.

	DOWN ARROW	Disassembles next 14 lines to screen.

ENTER			Returns to monitor command mode.

Dxxxx,yyyy		Disassembles lines of program to printer, starting at location xxxx
			Ends at location yyyy.
			(BREAK to quit early)


CALCULATOR

C Expression		Calculates 16 bit hex result of expression. + - / * are valid 
			numerical operators.

	The following prefixes to numbers indicate base type.

	$    HEX		NOTE that these prefixes only operate during the calculate
	@    OCTAL		MONITOR instruction and during assembly. All other MONITOR
	%    BINARY		instructions assume hex numbers in commands.
	None DECIMAL

	All calculations performed left to right. Remainders or overflows are ignored.

Note: 	Immediately after assembly, a C 'label' instruction will display the hex value of
	that label.

OTHER OPERATIONS

Gxxxx			Executes user program as subroutine (terminate with RTS instruction)
			Starts at xxxx. Direct page set to 00 before execution.

Mxxxx,yyyy/zzzz		Moves memory block starting at xxxx and finishing at yyyy to new
			location starting at zzzz.

S'ASCII'@xxxx,yyyy	Searches memory locations xxxx to yyyy for ASCII string up to 
			14 characters long. If found, opens memory at start of string.

SXX YY ZZ @AAAA,BBBB	Searches memory from location AAAA to BBBB for hex byte string
			XX YY ZZ (up to 14 bytes long). Opens memory at start of hex 
			byte string if found.

A"FILENAME"/DIRECTIVES	Assembles current source file (See assembler directives for 			options).


BREAKPOINTS

Zn@xxxx			Sets breakpoint n (insert SWI) at location xxxx. Saves byte at xxxx.
			Redirects SWI vector to display breakpoint routine.
			n is number from 1 to 8 for up to 8 breakpoints set at any time.

T			Displays table of breakpoint addresses set.

Xn			Removes breakpoint No n (from 1 to 8). Restores original byte at
			breakpoint location.

X			Removes all breakpoints and restores original bytes.

COMMANDS AVAILABLE FROM BREAKPOINT DISPLAY

Prompt is '?' and can be answered by following commands:

ENTER			Continue user program.

Q			Quit to MONITOR command mode but with stack not reset for one
			command. (Allows examination of stack for return addresses etc).

R			Displays all register contents and returns to '?' prompt.

A			Displays accumulator A contents and expects a new byte to be
			entered when it will then return to '?' prompt.

B			Displays accumulator B contents ready for new byte as above.

D			Displays direct page register contents and expects changes as above.

C			Displays condition code register contents and change as above.

X			Displays X register contents and expects new double byte before
			returnto '?' prompt.

Y			Displays Y register contents and new double byte change as above.

U			Displays U register contents and awaits double byte entry.

S			Displays S register contents and expects double byte change.

P			Displays program counter register contents and expects double byte
			change.

BREAK			Returns to MONITOR command mode with stack reset.

