The CPCEMU Amstrad CPC Firmware Guide

Originally by Bob Taylor and Thomas Defoe, 1992
Electronic version scanned and formatted by David Cantrell, 1994

Introduction

    Computer programming is one of  the  most satisfying hobbies as it
is a rare opportunity to invent, develop,  and test your own ideas and
see them come to fruition.  Competent  programming is a skill which is
not easy to master, but once learnt,  it will give hours of pleasure -
there are many people  who  spend  hours  inventing new coding tricks,
solving complex problems, or just trying out an idea.
    Fortunately, when Amstrad developed  the  CPC  and PLUS computers,
they let the user access many  of  the computer's routines and use the
Firmware in their own programs.  Experienced programmers will no doubt
write faster routines which are  more  efficient, or have some special
feature, yet these extra facilities can easily be patched in using the
Firmware Jumpblock.
    For many years,  Amstrad  produced  the  definitive  guide  to the
insides of the CPC but sale  of  this  was stopped almost 3 years ago.
[Note - 3 yrs ago means  1989  here].   Since then the Firmware Manual
has been regarded as an antique  by  those who are fortunate enough to
own a copy.   Nevertheless,  the  original  guide  had some omissions,
notably the abscence of information  on  the  system variables and the
Z80 microprocessor inside every CPC or Plus.
    This guide is not intended  to  explain  how to program in machine
code, but we hope that it  will  supply the information needed to make
the most of the Amstrad's capabilities when writing your own programs.

                  Bob Taylor and Thomas Defoe, 1992


This Conversion ...

    In August 1994, I phoned  the  original  authors, asking whether I
could distribute an electronic  version  of  their  firmware guide, to
complement the Amstrad  emulator  CPCEMU,  which  has  been written by
Marco Vieth for IBM compatible PCs.  They replied that I could, and so
I am making this available to  everyone  who wants it.  Of course, Bob
Taylor and Thomas Defoe still own  the  copyright.  They are no longer
distributing the paper version, so won't  lose out by the existence of
an electronic version.
    To get the text into a  computer, I used a Hewlett-Packard Scanjet
flatbed scanner, and Omnipage Professional  OCR  software.  (or was it
Deskscan? - I forget now).  Of course,  the OCR software fucked up the
formatting.   Additionally,  it  couldn't  recognize  ampersands  (&),
converted 'm's to 'rn', lots of 'rn's to 'm', IX to I~Y, and all sorts
of other silliness.
    It's taken me 5 months to get  it  sorted out, doing a few pages a
week.  It's VERY boring!  I used PROTEXT  version 6 to reformat it, as
it's the only word-processor  with  powerful enough search-replace and
ruler setting facilities, yet  is  still  easy  to  use.   Mind you, I
suppose I think that  because  I'm  used  to  it!  It was particularly
useful for the list of Z80 instructions  towards the end of this file.
(This section was 3 roughly instructions per line, with a single space
between each field after  being  scanned.   The  original was arranged
with all instructions alphabetically in to  columns.  This one has all
instructions arranged in one column, alphabetically.  Protext did most
of the reformatting/sorting automagically)

    I've tried to reproduce the layout of the original book as closely
as possible, but there are a few changes:

    In the plain ASCII version of this, I can't put in bold and italic
text, different fonts, and point sizes.
    With a limit of 70 characters  per  line for most of the document,
I've put in more line-wraps than the original.
    I've indented some  parts  of  the  document  differently.  In the

original, things were made clearer by  using  boldface, but I can't so
have had to change the layout slightly.

    This document is available  in  two  forms - FIRMWARE.TXT contains
the plain ASCII version.   FIRMWARE.PTX  contains the PROTEXT version.
This includes the ruler lines, soft spaces and returns, etc...  If you
want to format it yourself (you want  to do what?!?!?), write to me at
the snail-mail address given in  the CPCEMU documentation.  Of course,
to do this, you'll need PROTEXT 6 yourself.

    Of course, I disclaim any  responsibility  for  any errors in this
document.  I have NOT checked every single letter in it, including the
memory addresses and values given  in  various places, although I have
corrected a few of the scanners  HUGE errors.  When using the original
paper-based version of the Firmware Guide,  I had no problems, but the
scanner has probably put in a few errors.

                    David Cantrell, December 1994

  *** ADVERT FOR ARNOR *** ADVERT FOR ARNOR *** ADVERT FOR ARNOR ***

Protext version 6 is available for PCs running MSDOS, from:

                              Arnor Ltd,
                           611 Lincoln Road
                             Peterborough
                               PE1 3HA
                               England

                         Phone +44 1733 68909


      *** END OF ADVERT *** END OF ADVERT *** END OF ADVERT ***

Use of memory by the Operating System

    The following list of  memory  addresses  and  their uses has been
compiled over a number of  years,  mainly from personal investigation.
It does not claim to be definitive,  since no accurate source seems to
be available to the average computer user, and so may be inaccurate or
deficient at certain points; also,  some  of  the areas described have
uses additional to those listed.  We have tried to make it as accurate
as possible, to enable  others  to  use  to  the full those facilities
which present themselves via this information.

      щ Addresses and values are present  in  memory with the low byte
        first.  The Z80 processor represents  all 16-bit values in the
        order lo-byte hi-byte.

      щ The term 'above' means higher in memory.

      щ Areas with numbers of  bytes  of  either  &00  or &FF given in
        brackets, may be safe to use for machine code routines etc, as
        may the tape area, and the  Sound  ENT  and ENT areas if these
        are unused.

      щ The first column given is  the  address  (for the 6128) of the
        memory being considered,  while  the  second  column gives the
        equivalent 464 address -  unfortunately  the  464 differs from
        the 6128 for most addresses, so if one address is omitted, the
        system variable is not available for that machine.

      щ The next column gives the  size allocated in bytes.  Addresses
        on the right hand  side  enclosed  in  brackets  are of System
        Variables which hold the address of the bytes being explained.
        With addresses or values anywhere in the text, the value shown
        is for the 6128; a value in italics is for the 464 only.

Overview of the CPC's memory

    In the following tables, the following symbols are used:

    <>  means 'not the value or bit which follows'
    *   means 'this applies to all machine with a disk drive fitted'
    b0  means bit 0
    b1  means bit 1
    ...
    b15 means bit 15
    HB  means 'most significant byte, hi-byte'
    LB  means 'least significant byte, lo-byte'

    When addresses are given in the  comments, they apply to the 6128.
When the 464's address is different, it  is given in brackets, such as
at the comment for &B763.



Please note that this section of the  guide  has been set out with all
the addresses in the  leftmost  column  in  the  correct order for the
6128.  However, a Conversion Chart specifically for the 464 is printed
in Appendix C.


The System Variables

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &0000 і &0000 і &40  і Restart block:
     &0000 і &0000 і      і RST0: complete machine reset
     &0008 і &0008 і      і RST 1: LOWJUMP: in-line two byte address:
           і       і      і b0 to b13=address; b14=Low ROM disabled;
           і       і      і b15=Upper ROM disabled
     &000B і &000B і      і LOW PCHL: HL has address as RST 1
     &000E і &000E і      і 'JMP BC': BC has address to jump to
     &0010 і &0010 і      і RST 2: SIDE CALL: inline two byte address:
           і       і      і b0 to b13=address-&C000; bl4 to b15=offset
           і       і      і to required ROM (used between sequenced
           і       і      і Foreground ROMs)
     &0013 і &0013 і      і SIDE PCHL: HL has address as RST 2
     &0016 і &0016 і      і 'JMP DE': DE has address to jump to
     &0018 і &0018 і      і RST 3: FAR CALL: inline three byte address
           і       і      і block: bytes 1 and 2 hold the address;
           і       і      і byte 3 holds the ROM select address
     &001B і &001B і      і FAR PCHL: as RST 3, but HL has address;
           і       і      і C has ROM select
     &001E і &001E і      і 'JMP HL': HL has address to jump to
     &0020 і &0020 і      і RST 4: RAM LAM: LD A,(HL) from RAM with
           і       і      і ROMs disabled
     &0023 і &0023 і      і FAR CALL: as RST 3, but HL has address of
           і       і      і three byte address block
     &0028 і &0028 і      і RST 5: FIRM JUMP: inline two byte address
           і       і      і to jump to
     &0030 і &0030 і      і RST 6: User restart; default to RST 0
     &0038 і &0038 і      і RST 7: Interrupt entry (KB/Time etc)
     &003B і &003B і      і External interrupt (default to RET)
     &0040 і &0040 і &130 і ROM lower foreground area: BASIC input
           і       і      і area (tokenised)
     &016F і &016F і      і end of BASIC input
     &0170 і &0170 і      і BASIC working area for program, variables,
           і       і      і etc...
     &0170 і &0170 і      і Program area
           і       і      і Variables and DEF FNs area
           і       і      і Arrays area
           і       і      і Free space
           і       і      і   end of free space
           і       і      і Strings area
           і       і      і   end of Strings area (=HIMEM)
           і       і      і Space for user machine code routines
           і       і      і   end of user space, byte before user
           і       і      і   defined graphics area
           і       і n*8  і User defined graphics area
           і       і      і   end of UDG area
           і       і      і ROM Upper reserved area, expandible during
           і       і      і   KL ROM WALK, including:
           і       і r*4  і ROM chaining blocks (arranged as follows):
     &A6FC і &A6FC і 4    і AMSDOS chain,ing block:
     &A6FC і &A6FC і 2    і address of next ROM block in chain (or
           і       і      і   &0000 if the last in chain)
     &A6FE і &A6FE і 1    і ROM Select address
     &A6FF і &A6FF і 1    і &00
     ДДДДДДБДДДДДДДБДДДДДДБДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A700 і &A700 і &500 і AMSDOS reserved area
           і       і      і   This area is moved down if any ROMs have
           і       і      і   numbers greater than eight (6128 only)
     &A700 і &A700 і 1    і Current drive number (0=A; 1=B)
     &A701 і &A701 і 1    і Current USER number
     &A702 і &A702 і 1    і flag?
     &A703 і &A703 і 2    і address?
     &A705 і &A705 і 1    і flag?
     &A706 і &A706 і 2    і address?
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A708 і &A708 і 1    і OPENIN flag (&FF=closed; <>&FF=opened)
     &A709 і &A709 і &20  і Copy of current or last Disc Directory
           і       і      і   entry for OPENIN/LOAD:
     &A709 і &A709 і 1    і USER number
     &A70A і &A70A і 8    і filename (padded with spaces)
     &A712 і &A712 і 3    і file extension (BAS, BIN, BAK, etc)
           і       і      і   including:
     &A712 і &A712 і 1    і b7 set = Read Only
     &A713 і &A713 і 1    і b7 set = System (ie not listed by CAT or
           і       і      і   DIR)
     &A715 і &A715 і 1    і 16K block sequence nurnber for this
           і       і      і   directory entry (0 for first block; if
           і       і      і   <>0 part of a larger file)
     &A716 і &A716 і 2    і unused
     &A718 і &A718 і 1    і length of this block in 128 byte records
     &A719 і &A719 і 16   і sequence of Disc Block nurnbers containing
           і       і      і   file - &00 as end marker
     &A729 і &A729 і 1    і number of 128 byte records loaded so far;
           і       і      і   before loading proper: &00 for ASCII (ie
           і       і      і   nothing loaded yet); &01 for BIN or BAS
           і       і      і   files (ie header record loaded)
     &A72A і &A72A і 1    і
     &A72B і &A72B і 1    і
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A72C і &A72C і 1    і OPENOUT flag (&FF=closed; <>&FF=opened)
     &A72D і &A72D і &20  і Copy of current or last Disc Directory
           і       і      і   entry for OPENOUT/SAVE:
     &A72D і &A72D і 1    і USER number
     &A72E і &A72E і 8    і filename (padded with spaces)
     &A736 і &A736 і 3    і file extension ($$$ while open; correct
           і       і      і   extension when finished)
     &A739 і &A739 і 1    і flag (&00=open; &FF=closed, ie finished)
     &A73A і &A73A і 1    і
     &A73B і &A73B і 1    і flag (&00=open; &FF=closed)
     &A73C і &A73C і 1    і number of 128 byte records saved so far
     &A73D і &A73D і 16   і sequence of Disc Block numbers containing
           і       і      і   file - &00 as end marker
     &A74D і &A74D і 1    і number of 128 byte records saved so far
     &A74E і &A74E і 1    і
     &A74F і &A74F і 1    і
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A750 і &A750 і 1    і flag (&00=OPENIN; &01=In Char;
           і       і      і   &02=In Direct (whole file))
     &A751 і &A751 і 2    і address of 2K buffer for ASCII, or of
           і       і      і   start of current/last block if BIN or
           і       і      і   BAS file
     &A753 і &A753 і 2    і address of next byte to read for ASCII, or
           і       і      і   of 2K buffer for BAS or BIN file

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A755 і &A755 і &45  і first &45 bytes of BAS/BIN file (extended
           і       і      і   header) or of extended header made for
           і       і      і   ASCII file
     &A755 і &A755 і 1    і USER number
     &A756 і &A756 і 8    і filename (padded)
     &A75E і &A75E і 3    і extension
     &A761 і &A761 і 6    і unused
     &A767 і &A767 і 1    і file type (&00=BASIC; &01=protected BASIC;
           і       і      і &02=Binary; &16=ASCII)
     &A768 і &A768 і 2    і unused
     &A76A і &A76A і 2    і address to load file into (=actual
           і       і      і   destination), or buffer for an ASCII
           і       і      і   file
     &A76C і &A76C і 1    і unused for disc
     &A76D і &A76D і 2    і length of file in bytes (&0000 for ASCII
           і       і      і   files)
     &A76F і &A76F і 2    і execution address fora BIN file
     &A770 і &A770 і &25  і unused
     &A795 і &A795 і 3    і length of actual file in bytes (as &A76D)
           і       і      і   -BAS and BIN only
     &A798 і &A798 і 2    і simple checksum of first 67 bytes of
           і       і      і   header (LB first) - BAS and BIN only
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A79A і &A79A і 1    і flag (&00=OPENOUT; &01=Out Char;
           і       і      і   &02=Out Direct(whole file))
     &A79B і &A79B і 2    і address of 2K block if an ASCII file, or
           і       і      і   of current/last block saved if a BAS
           і       і      і   or BIN file
     &A79D і &A79D і 2    і address of next byte to write for ASCII
           і       і      і   files, or of 2K buffer for BAS and BIN
           і       і      і   files
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A79F і &A79F і &45  і first &45 bytes of BAS/BIN file (ie
           і       і      і   extended header)
     &A79F і &A79F і 1    і USER number
     &A7A0 і &A7A0 і 8    і filename (padded)
     &A7A8 і &A7A8 і 3    і extension
     &A7AB і &A7AB і 1    і flag (&00=Open)
     &A7AC і &A7AC і 1    і
     &A7AD і &A7AD і 1    і flag (&00=Open)
     &A7AE і &A7AE і 3    і unused
     &A7B1 і &A7Bl і 1    і file type (&00=BASIC; &01=protected BASIC;
           і       і      і   &02=Binary; &16=ASCII)
     &A7B2 і &A7B2 і 2    і unused
     &A7B4 і &A7B4 і 2    і address to save file from (for BAS or BIN
           і       і      і   files), or of buffer for ASCII files
     &A7B6 і &A7B6 і 1    і unused for disc
     &A7B7 і &A7B7 і 2    і length of file in bytes
     &A7B9 і &A7B9 і 2    і execution address for BIN files
     &A7BB і &A7BB і &25  і unused
     &A7DF і &A7DF і 3    і length of actual file in bytes (as at
           і       і      і   &A7B7) - BAS and BIN only
     &A7E2 і &A7E2 і 2    і simple checksum of first 67 bytes of
           і       і      і   header (LB first) - BAS and BIN only
     &A7E4 і &A7E4 і &80  і buffer area for records sent to or loaded
           і       і      і   from Disc, or used in forming filename
           і       і      і   and extension
     &A864 і &A864 і 14*3 і Tape Jumpblock is stored here by AMSDOS
           і       і      і   - is moved to &BC77 etc after |TAPE
     &A88B і &A88B і 3    і far address used by AMSDOS RST 3s at &BC77
           і       і      і   etc (&CD30,&07)
     ДДДДДДБДДДДДДДБДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A890 і &A890 і &19  і Drive A Extended Disc Parameter Block
           і       і      і   (XDPB):
     &A890 і &A890 і 2    і number of 128 byte records per track
     &A892 і &A892 і 1    і log2(Block size)-7 (&03=1024 bytes;
           і       і      і   &04=2048 bytes)
     &A893 і &A893 і 1    і (Block size)/128-1 (&07=1024 bytes;
           і       і      і   &0F=2048 bytes)
     &A894 і &A894 і 1    і (Block size)/1024 (if total of blocks
           і       і      і   <256, else /2048)-1
     &A895 і &A895 і 2    і number of blocks per disc side (excluding
           і       і      і   reserved tracks)
     &A897 і &A897 і 2    і number of (directory entries)-1
     &A899 і &A899 і 2    і bit signiflcant value of number of blocks
           і       і      і   for directory (&0080=1; &00C0=2)
     &A89B і &A89B і 2    і number of bits in checksum
           і       і      і   =((&A894)+ 1)/4
     &A89D і &A89D і 2    і number of reserved tracks (&00=Data;
           і       і      і   &01=IBM; &02=System)
     &A89F і &A89F і 1    і number of first sector (&01=IBM;
           і       і      і   &41=System; &C1=Data)
     &A8A0 і &A8A0 і 1    і number of sectors per track (Data=9;
           і       і      і   System=9; IBM=8)
     &A8A1 і &A8Al і 1    і gap length (Read/Write)
     &A8A2 і &A8A2 і 1    і gap length (Format)
     &A8A3 і &A8A3 і 1    і format filler byte (&E5)
     &A8A4 і &A8A4 і 1    і log2(sector size)-7 (&02=512; &03=1024)
     &A8A5 і &A8A5 і 1    і records per sector
     &A8A6 і &A8A6 і 1    і current track (not for use)
     &A8A7 і &A8A7 і 1    і 0=not aligned (not for use)
     &A8A8 і &A8A8 і 1    і Auto select flag (&00=Auto select;
           і       і      і   &FF= don't alter)
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A8A9 і &A8A9 і      і
     &A8B9 і &A8B9 і      і
     &A8D0 і &A8D0 і &19  і Drive B Extended Disc Parameter Block
           і       і      і   (arranged as at &A890)
     &A8E9 і &A8E9 і      і (&17 bytes of &FF)
     &A8F9 і &A8F9 і      і
     &A900 і &A900 і      і (&12 bytes of &00)
     &A910 і &A910 і      і
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &A918 і &A918 і 2    і address of area for reading directory
           і       і      і   entries for Drive A
     &A91A і &A91A і 2    і address of Drive A XDPB
     &A91C і &A91C і 2    і address of the byte after the end of
           і       і      і   Drive A XDPB
     &A91E і &A91E і 2    і
     &A920 і &A920 і      і (8bytes of &00)
     &A928 і &A928 і 2    і address of area for reading directory
           і       і      і   entries for Drive B
     &A92A і &A92A і 2    і address of Drive B XDPB
     &A92C і &A92C і 2    і address of the byte after the end of
           і       і      і   Drive B XDPB
     &A92E і &A92E і 2    і
     &A930 і &A930 і &80  і block of directory entries, including last
           і       і      і   file loaded
     &A9B0 і &A9B0 і &200 і buffer for loading; usually contains last
           і       і      і   sector loaded
     &ABB0 і &ABB0 і      і (&50 bytes of &00)

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &AC00 і &AC00 і      і Start of BASIC Operating System reserved
           і       і      і   area:
     &AC00 і &AC00 і 1    і program line redundant spaces flag
           і       і      і   (0=keep extra spaces; <>0=remove)
           і &AC01 і 9*3  і groups of 3 RET bytes (&C9) called by the
           і       і      і   Upper ROM
     &AC01 і &AC1C і 1    і AUTO flag (0=off; <>0=on)
     &AC02 і &AC1D і 2    і number of the next line (6128) or of the
           і       і      і current line (464) for AUTO
     &AC04 і &AC1F і 2    і step distance for AUTO
     &AC06 і &AC21 і 1    і
     &AC07 і &AC22 і 1    і
     &AC08 і       і 1    і
           і &AC23 і 1    і
     &AC09 і &AC24 і 1    і WIDTH (&84=132)
     &AC0A і &AC25 і      і
     &AC0B і       і      і
     &AC0C і &AC26 і 1    і FOR/NEXT flag (0=NEXT not yet used;
           і       і      і   <>0=used)
     &ACOD і &AC27 і 5    і FOR start value (real).  Only 2 bytes are
           і       і      і   used if % or DEFINT variable
     &AC12 і &AC2C і 2    і address of ': ' or of the end of program
           і       і      і   line byte after a NEXT command
     &AC14 і &AC2E і 2    і address of LB of the line number
           і       і      і   containing WEND
     &AC16 і &AC30 і 1    і WHILE/WEND flag (&41=WEND not yet used;
           і       і      і   &04=used)
     &AC17 і &AC31 і      і
     &AC18 і &AC32 і 2    і
     &AClA і &AC34 і 2    і
     &AC1C і &AC36 і 2    і address of location holding ROM routine
           і       і      і   address for KB event block
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &AC1E і &AC38 і &0C  і Event Block for ON SQ(l):
     &AC1E і &AC38 і 2    і chain address to next event block; &0000
           і       і      і   if last in chain, but &FFFF if unused
     &AC20 і &AC3A і 1    і count
     &AC21 і &AC3B і 1    і class: Far address, highest (ON SQ)
           і       і      і   priority, Normal & Synchronous event
     &AC22 і &AC3C і 2    і routine address (in BASIC ROM)
     &AC24 і &AC3E і 1    і ROM Select number (&FD ie ROM 0 enabled,
           і       і      і   Lower ROM disabled)
     &AC25 і &AC3F і 1    і (first byte of user field)
     &AC26 і &AC40 і 2    і address of the end of program line byte or
           і       і      і   ':' after 'ON SQ(x) GOSUB line number'
           і       і      і   statement
     &AC28 і &AC42 і 2    і address of the end of program line byte of
           і       і      і   the line before the GOSUB routine
     &AC2A і &AC44 і &0C  і Event block for ON SQ(2), arranged as
           і       і      і   &AC1E onwards - second ON SQ priority
     &AC36 і &AC50 і &0C  і Event block for ON SQ(4), arranged as
           і       і      і   &AC1E onwards - lowest ON SQ priority

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &AC42 і &AC5C і &12  і Ticker and Event Block for AFTER/EVERY
           і       і      і   Timer 0
     &AC42 і &AC5C і 2    і chain address to next event block (usually
           і       і      і   to another timer or &00FF)
     &AC44 і &AC5E і 2    і 'count down' count
     &AC46 і &AC60 і 2    і  recharge count (for EVERY only - &0000 if
           і       і      і   AFTER)
     &AC48 і &AC62 і 2    і chain address to next ticker block
     &AC4A і &AC64 і 1    і count
     &AC4B і &AC65 і 1    і class: Far address, lowest (timer)
           і       і      і   priority, Normal and Synchronous event
     &AC4C і &AC66 і 2    і Routine address (in BASIC ROM)
     &AC4E і &AC68 і 1    і ROM Select No (&FD ie ROM 0 enabled, Lower
           і       і      і   ROM disabled)
     &AC4F і &AC69 і 1    і (first byte of user field)
     &AC50 і &AC6A і 2    і address of the end of prograrn line byte
           і       і      і   or ':' after statement in use when the
           і       і      і   timer 'timed-out'
     &AC52 і &AC6C і 2    і address of tbe end of prograrn line byte
           і       і      і   of tbe line before the GOSUB routine
     &AC54 і &AC6E і &12  і Ticker and Event Block for AFTER/EVERY
           і       і      і   Timer 1 (3rd Timer priority) arranged as
           і       і      і   at &AC42
     &AC66 і &AC80 і &12  і Ticker and Event Block for AFTER/EVERY
           і       і      і   Timer 2 (2nd Timer priority) arranged as
           і       і      і   at &AC42
     &AC78 і &AC92 і &12  і Ticker and Event Block for AFTER/EVERY
           і       і      і   Timer 3 (highest priority) arranged as
           і       і      і   at &AC42
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &AC8A і &ACA4 і &100 і BASIC input area for lines (as typed in
           і       і      і   and not tokenised) or for INPUT
     &AD8C і &ADA6 і 2    і address of line number LB in line
           і       і      і   containing error
     &AD8E і &ADA8 і 2    і address of byte before statement
           і       і      і   containing error - ie of ':' or of
           і       і      і   HB of Line No
     &AD90 і &ADAA і 1    і ERR (Error No)
     &AD91 і       і 1    і DERR (Disc Error No)
     &AD92 і &ADAB і 2    і as &AD8E if error is in a program (ie not
           і       і      і   if in Direct Command Mode)
     &AD94 і &ADAD і 2    і as &AD8C if error is in a program (ie not
           і       і      і   if in Direct Command Mode)
     &AD96 і &ADAF і 2    і address of the length LB of line specified
           і       і      і   by the 'ON ERROR GOTO' command
     &AD98 і &ADB1 і 1    і

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &AD99 і &ADB2 і &09  і Current SOUND parameter block (see
           і       і      і   Firmware Jump &BCAA)
     &AD99 і &ADB2 і 1    і channel andrendezvous status
     &AD9A і &ADB3 і 1    і amplitude envelope (ENV) number
     &AD9B і &ADB4 і 1    і tone envelope (ENT) number
     &AD9C і &ADB5 і 2    і tone period
     &AD9E і &ADB7 і 1    і noise period
     &AD9F і &ADB8 і 1    і initial amplitude
     &ADA0 і &ADB9 і 2    і duration, or envelope repeat count
     &ADA2 і &ADBB і &10  і Current Amplitude or Tone Envelope
           і       і      і   parameter bloc (see &BCBC or &BCBF)
     &ADA2 і &ADBB і 1    і number of sections    (+&80 for a negative
           і       і      і   ENT number, ie the envelope is run until
           і       і      і   end of sound
     &ADA3 і &ADBC і 3    і first section of the envelope:
     &ADA3 і &ADBC і 1    і step count (if <&80) otherwise envelope
           і       і      і   shape (not tone envelope)
     &ADA4 і &ADBD і 1    і step size (if step count<&80) otherwise
           і       і      і   envelope period (not tone envelope)
     &ADA5 і &ADBE і 1    і pause time (if step count<&80) otherwise
           і       і      і   envelope period (not tone envelope)
     &ADA6 і &ADBF і 3    і second section of the envelope, as &ADA3
     &ADA9 і &ADC2 і 3    і third section of the envelope, as &ADA3
     &ADAC і &ADC5 і 3    і fourth section of the envelope, as &ADA3
     &ADAF і &ADC8 і 3    і fifth section of the envelope, as &ADA3
     &ADB2 і &ADCB і 5    і
     &ADB7 і &ADD0 і &36  і
     &ADEB і &AE04 і 2    і
     &ADED і &AE06 і 6    і
           і       і      і
     &ADF3 і &AE0C і 26*1 і table of DEFINT (&02), DEFSTR (&03) or
           і       і      і   DEFREAL default (&05), for variables 'a'
           і       і      і   to 'z'
     &AE0D і &AE26 і      і
     &AE0E і &AE27 і 2    і
     &AE10 і &AE29 і 2    і
     &AE12 і &AE2B і 2    і
     &AE14 і &AE2D і 1    і
     &AE15 і &AE2E і 2    і address of line number LB of last BASIC
           і       і      і   line (or &FFFF)
     &AE17 і &AE30 і 2    і address of byte before next DATA item (eg
           і       і      і   comma or space)
     &AE19 і &AE32 і 2    і address of next space on GOSUB etc stack,
           і       і      і   (see also &B06F)
     &AE1B і &AE34 і 2    і address of byte before current statement
           і       і      і   (&003F if in Direct Command mode)
     &AE1D і &AE36 і 2    і address of line nurnber LB of line of
           і       і      і   current statement (&0000 if in Direct
           і       і      і   Command mode)
     &AE1F і &AE38 і 1    і trace flag (0=TROFF; <>0=TRON)
     &AE20 і &AE39 і 1    і flag used with Trace (&00 if in Direct
           і       і      і   Command mode; &01 if in a program)

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &AE21 і &AE3A і      і
     &AE22 і &AE3B і 2    і
     &AE24 і &AE3D і 2    і
     &AE26 і &AE3F і 2    і address to load cassette file to
     &AE28 і &AE41 і      і
     &AE29 і &AE42 і 1    і file type from cassette header
     &AE2A і &AE43 і 2    і file length from cassette header
     &AE2C і &AE45 і 1    і program protection flag (<>0 hides program
           і       і      і   as if protected)
     &AE2D і &AE46 і 17   і buffer used to form binary or hexadecimal
           і       і      і   numbers before printing etc
     &AE3A і &AE53 і 5    і start of buffer used to form hexadecimal
           і       і      і   numbers before printing etc
     &AE3A і &AE53 і 1    і Key Number used with INKEY (providing the
           і       і      і   Key Number is written as a decimal)
     &AE3E і &AE57 і 1    і last byte (usually &00 or &20) of the
           і       і      і   formed binary or hexadecimal number
     &AE43 і &AE5D і 13   і buffer used to form decimal numbers before
           і       і      і   printing etc
     &AE4E і &AE68 і 1    і last byte (usually &00 or &20) of the
           і       і      і   formed decimal number
           і &AE6B і 3    і
     &AE51 і       і 1    і
     &AE52 і &AE6E і 2    і
     &AE54 і       і 1    і
           і &AE70 і 2    і temporary store for address after
           і       і      і   using (&AE68)
           і       і      і
     &AE55 і &AE72 і 2    і address of last used ROM or RSX JUMP
           і       і      і   instruction in its Jump Block
     &AE57 і &AE74 і 1    і ROM Select number if address above is in
           і       і      і   ROM
     &AE58 і &AE75 і 2    і BASIC Parser position, moved on to ': ',
           і       і      і   or the end of program line byte after a
           і       і      і   CALL or an RSX
     &AE5A і &AE77 і 2    і the resetting address for machine Stack
           і       і      і   Pointer after a CALL or an RSX
     &AE5C і &AE79 і 2    і ZONE value
     &AE5D і       і 1    і
           і &AE7A і 1    і
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &AE5E і &AE7B і 2    і HIMEM (set by MEMORY)
           і &AE7D і 2    і address of the byte before the UDG area
           і       і      і   (the end of the user M/C routine area or
           і       і      і   the Strings area) if the UDG area is
           і       і      і   still present, otherwise the highest
           і       і      і   byte of Program etc area
     &AE60 і 2     і      і address of highest byte of free RAM (ie
           і       і      і   last byte of UDG area)
     &AE62 і &AE7F і 2    і address of start of ROM lower reserved
           і       і      і   area (used for tokenised lines)
     &AE64 і &AE81 і 2    і address of end of ROM lower reserved area
           і       і      і   (byte before Program area)
     &AE66 і &AE83 і 2    і as &AE68
     &AE68 і &AE85 і 2    і address of start of Variables and DEF FNs
           і       і      і   area
     &AE6A і &AE87 і 2    і address of start of Arrays area (where
           і       і      і   next Variable or DEF FN entry is placed)
     &AE6C і &AE89 і 2    і address of start of free space (where
           і       і      і   next Array entry is placed)
     &AE6E і       і 1    і

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &AE70 і &AE8C і &1FF і GOSUB, FOR and WHILE stack.  Entries are
           і       і      і   added above any existing ones in use
           і       і      і   (mixed as encountered) at address given
           і       і      і   by &B06F and must be used up in the
           і       і      і   opposite order.  Completed entries are
           і       і      і   not deleted, just overwitten by the
           і       і      і   next new entry:
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
           і       і      і GOSUB (84 max capacity):
           і       і 1    і (byte of &00)
           і       і 2    і address of end of program line byte or ':'
           і       і      і   after GOSUB statement (the point to
           і       і      і   RETURN to)
           і       і 2    і address of line number HB of line
           і       і      і   containing GOSUB
           і       і 1    і byte of &06, ie the length of the GOSUB
           і       і      і   entry
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
           і       і      і FOR (21 max for Real FORs,31 max for
           і       і      і   Integer FORs):
           і       і 2    і address of current value of control
           і       і      і   variable (in Variables area)
           і       і 5    і value of limit (ie the TO value) - there
           і       і      і   are two bytes only for Integer FORs
           і       і 5    і value of STEP - two bytes for Integer FORs
           і       і 1    і sign byte (&00 for positive; &01 for
           і       і      і   negative)
           і       і 2    і address of the end of program line byte,
           і       і      і   or ':' after the FOR statement (ie the
           і       і      і   address for the NEXT loop to restart at)
           і       і 2    і address of line number LB of line
           і       і      і   containing FOR
           і       і 2    і address of byte after NEXT statement (ie
           і       і      і   the address to continue at when the
           і       і      і   limit is exceeded)
           і       і 2    і address of byte after NEXT statement again
           і       і 1    і length byte (&16 for Real FORs; &10 for
           і       і      і   Integer FORs)
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
           і       і      і WHILE (66 max capacity):
           і       і 2    і address of line number LB of line
           і       і      і   containing WHILE
           і       і 2    і address of the end of program line byte or
           і       і      і   ':' after WEND statement (ie the address
           і       і      і   to continue at when the condition is
           і       і      і   false)
           і       і 2    і address of condition after the WHILE
           і       і      і   command
           і       і 1    і length byte of &07 - end of WHILE entry
           і       і      і   proper but:
           і       і +5   і value of condition (0 or -1 as a floating
           і       і      і   point value) only while the WHILE entry
           і       і      і   is the last on the stack
     &B06F і &B08B і 2    і address of the next space on the GOSUB etc
           і       і      і   stack (see also &AE19)
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     NB: The free space on the stack is also used as a workspace by
         various routines for values and addresses and for Variable
         names

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B071 і &B08D і 2    і address of end of free space (the byte
           і       і      і   before the Strings area)
     &B073 і &B08F і 2    і address of end of Strings area (=HIMEM)
     &B075 і       і 1    і
           і &B091 і 1    і
           і &B092 і 2    і
     &B076 і &B094 і 2    і
     &B078 і &B096 і 2    і address of the highest byte of free RAM
           і       і      і   disregarding UDGs (usually &A6FB)
     &B07A і &B098 і 2    і
     &B07C і &B09A і 2    і address for the next entry in the String
           і       і      і   Concatenation area
     &B07E і &B09C і 10*3 і concatenation area holding descriptors of
           і       і      і   strings being used
     &B09C і &B0BA і 1    і length of last String used
     &B09D і &B0BB і 2    і address of last String used
           і &B0BD і 2    і
           і &BOBF і 2    і
     &B09F і &BOC1 і 1    і type byte used with the Virtual
           і       і      і   Accumulator (&02=Integer; &03=String;
           і       і      і   &05=Real)
     &B0A0 і &B0C2 і 5    і Virtual Accurnulator used by the maths
           і       і      і   routines (two bytes for an Integer
           і       і      і   value; three bytes for a String
           і       і      і   Descriptor; five bytes for a Real
           і       і      і   value)
     &B0A0 і &B0C2 і 2    і
     &B0A2 і &B0C4 і 1    і
     &B0A3 і &B0C5 і 2    і
     &B0A5 і &B0C7 і &5B  і (&39 bytes on 464) bytes of &FF
     &B100 і &B8E4 і 2    і &07, &C6
     &B102 і &B8E6 і 2    і &65, &89
     &B104 і &B8E8 і 5    і
     &B109 і &B8ED і 5    і
     &B10E і &B8F2 і 5    і
     &B113 і &B8F7 і 1    і DEG/RAD flag (&00=RAD; &FF=DEG)
     &B114 і &B8DC і 1    і
     &B115 і &B8DD і 1    і
     &B116 і &B8DE і 1    і
     &B117 і &B8DF і 1    і
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B118 і &B800 і &D2  і Area used for Cassette handling:
     &B118 і &B800 і 1    і cassette handling messages flag
           і       і      і   (0=enabled; <>O=disabled)
     &B119 і &B801 і 1    і
     &B11A і &B802 і 1    і file IN flag (&00=closed; &02=IN file;
           і       і      і   &03=opened; &05=IN char)
     &B11B і &B803 і 2    і address of 2K buffer for directories
     &B11D і &B805 і 2    і address of 2K buffer for loading blocks of
           і       і      і   files - often as &B11B

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B11F і &B807 і &40  і IN Channel header
     &B11F і &B807 і &10  і filename (padded with NULs)
     &B12F і &B817 і 1    і number of block being loaded, or next to
           і       і      і   be loaded
     &B130 і &B818 і 1    і last block flag (&FF=last block; &00=not)
     &B131 і &B819 і 1    і file type (&00=BASIC; &01=Protected BASIC;
           і       і      і   &02=Binary; &08=Screen; &16=ASCII)
     &B132 і &B81A і 2    і length of this block
     &B134 і &B81C і 2    і address to load this or the next block
           і       і      і   at,or the address of the byte after last
           і       і      і   one loaded
     &B136 і &B81E і 1    і first block flag (&FF=first block;
           і       і      і   &00=not)
     &B137 і &B81F і 2    і total length of file (all blocks)
     &B139 і &B821 і 2    і execution address for BIN files (&0000 if
           і       і      і   not saved as such)
     &B13B і &B823 і &24  і not allocated
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B15F і &B847 і 1    і file OUT flag (&00=closed; &02=IN file;
           і       і      і   &03=opened; &05=IN char)
     &B160 і &B848 і 2    і address to start the next block save from,
           і       і      і   or the address of the buffer if it is
           і       і      і   OPENOUT
     &B162 і &B84A і 2    і address of start of the last block saved,
           і       і      і   or the address of the buffer if it is
           і       і      і   OPENOUT
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B164 і &B84C і &40  і OUT Channel Header (details as IN Channel
           і       і      і   Header):
     &B164 і &B84C і &10  і filename
     &B174 і &B85C і 1    і number of the block being saved, or next
           і       і      і   to be saved
     &B175 і &B85D і 1    і last block flag (&FF=last block; &00=not)
     &B176 і &B85E і 1    і file type (as at &B131
     &B177 і &B85F і 2    і length saved so far
     &B179 і &B861 і 2    і address of start of area to save, or
           і       і      і   address of buffer if it is an OPENOUT
           і       і      і   instruction
     &B17B і &B863 і 1    і first block flag (&FF=first block;
           і       і      і   &00=not)
     &B17C і &B864 і 2    і total length of file to be saved
     &B17E і &B866 і 2    і execution address for BIN files (&0000 if
           і       і      і   parameter not supplied)
     &B180 і &B868 і &24  і not allocated
     &B1A4 і &B88C і &40  і used to construct IN Channel header:
     &B1B5 і &B89D і 1    і
     &B1B7 і &B89F і 2    і
     &B1B8 і &B8A3 і 1    і
     &B1BE і &B8A6 і 1    і
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B1B9 і &B51D і      і base address for calculating relevant
           і       і      і   Sound Channel block
     &B1BC і &B520 і      і base address for calculating relevant
           і       і      і   Sound Channel ?
     &B1BE і &B522 і      і base address for calculating relevant
           і       і      і   Sound Channel ?
     &B1D5 і &B539 і      і base address for calculating relevant
           і       і      і   Sound Channel ?
     &B1E4 і &B8CC і 1    і

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B1E5 і &B8CD і 1    і synchronisation byte
     &B1E6 і &B8CE і 2    і &55, &62
     &B1E8 і &B8D0 і 1    і
     &B1E9 і &B8D1 і 1    і cassette precompensation (default &06;
           і       і      і   SPEED WRITE 1 &0C @4жs)
     &B1EA і &B8D2 і 1    і cassette 'Half a Zero' duration (default
           і       і      і   &53; SPEED WRITE 1 &29 @ 4жS)
     &B1EB і &B8D3 і 2    і
           і &B550 і 1    і used by sound routines
           і &B551 і 1    і used by sound routines
     &B1ED і       і 1    і used by sound routines
     &B1EE і &B552 і 1    і used by sound routines
     &B1F0 і &BB54 і 1    і used by sound routines
           і &BB55 і 7    і used by sound and cassette routines
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B1F8 і &B55C і &3F  і Sound Channel A (1) data:
     &B212 і &B576 і 1    і number of sounds still queuing
     &B213 і &B577 і 1    і number of sounds originally queuing
     &B217 і &B57B і 8    і first or fifth sound in Channel 1 (A)
           і       і      і   queue:
     &B217 і &B57B і 1    і status: b0 to b2 = rendezvous with channel
           і       і      і   1, 2 or 4; b3 = Hold; b4 = Flush
     &B218 і &B57C і 1    і b0 to b3 = tone envelope number;
           і       і      і   b4 to b7 = volume envelope number (ie
           і       і      і   ENV nurnber*16)
     &B219 і &B57D і 2    і pitch
     &B21B і &B57F і 1    і noise
     &B21C і &B580 і 1    і volume
     &B21D і &B581 і 2    і duration (in 0.01 seconds)
     &B21F і &B583 і 8    і second sound in Channel 1 queue (as &B217)
     &B227 і &B58B і 8    і third sound in Channel 1 queue (as &B217)
     &B22F і &B593 і 8    і fourth sound in Channel 1 queue (as &B217)
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B237 і &B59B і &3F  і Sound Channel B (2) data - as described at
           і       і      і   &B1F8
     &B256 і &B5BA і 8    і first or fifth sound in Channel 2 queue
           і       і      і   (as &B217)
     &B25E і &B5C2 і 8    і second sound in Channel 2 queue (as &B217)
     &B266 і &B5CA і 8    і third sound in Channel 2 queue (as &B217)
     &B26E і &B5D2 і 8    і fourth sound in Channel 2 queue (as &B217)
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B276 і &B5DA і &3F  і Sound Channel C (4) data - as described at
           і       і      і   &B1F8
     &B295 і &B5F9 і 8    і first or fifth sound in Channel 4 queue
           і       і      і   (as   &B217)
     &B29D і &B601 і 8    і 2nd sound in Channel 4 queue (as &B217)
     &B2A5 і &B609 і 8    і 3rd sound in Channel 4 queue (as &B217)
     &B2AD і &B611 і 8    і 4th sound in Channel 4 queue (as &B217)


     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B2A6 і &B60A і      і base address for calculating relevant ENV
           і       і      і   parameter block
     &B2B6 і &B61A і 15*16і ENV parameter block area (each arranged as
           і       і      і   &ADA2):
     &B2B6 і &B61A і &10  і ENV 1
     &B2C6 і &B62A і &10  і ENV 2
     &B2D6 і &B63A і &10  і ENV 3
     &B2E6 і &B64A і &10  і ENV 4
     &B2F6 і &B65A і &10  і ENV 5
     &B306 і &B66A і &10  і ENV 6
     &B316 і &B67A і &10  і ENV 7
     &B326 і &B68A і &10  і ENV 8
     &B336 і &B69A і &10  і ENV 9
     &B346 і &B6AA і &10  і ENV 10
     &B356 і &B6BA і &10  і ENV 11
     &B366 і &B6CA і &10  і ENV 12
     &B376 і &B6DA і &10  і ENV 13
     &B386 і &B6EA і &10  і ENV 14
     &B396 і &B6FA і &10  і ENV 15
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B396 і &B6FA і      і base address for calculating relevant ENT
           і       і      і   parameter block
     &B3A6 і &B70A і 15*16і ENT parameter block area (each arranged as
           і       і      і   &ADA2):
     &B3A6 і &B70A і &10  і ENT 1
     &B3B6 і &B71A і &10  і ENT 2
     &B3C6 і &B72A і &10  і ENT 3
     &B3D6 і &B73A і &10  і ENT 4
     &B3E6 і &B74A і &10  і ENT 5
     &B3F6 і &B75A і &10  і ENT 6
     &B406 і &B76A і &10  і ENT 7
     &B416 і &B77A і &10  і ENT 8
     &B426 і &B78A і &10  і ENT 9
     &B436 і &B79A і &10  і ENT 10
     &B446 і &B7AA і &10  і ENT 11
     &B456 і &B7BA і &10  і ENT 12
     &B466 і &B7CA і &10  і ENT 13
     &B476 і &B7DA і &10  і ENT 14
     &B486 і &B7EA і &10  і ENT 15


     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B496 і &B34C і &50  і Normal Key Table:
           і       і      і Cur U Cur R Cur D f9    f6    f3    Enter f.
           і       і      і Cur L Copy  f7    f8    f5    f1    f2    f0
           і       і      і Clr   [     Ret   ]     f4          \
           і       і      і ^     -     @     p     ;     :     /     .
           і       і      і 0     9     o     i     l     k     m     j
           і       і      і 8     7     u     y     h     j     n     Space
           і       і      і 6     5     r     t     g     f     b     v
           і       і      і 4     3     e     w     s     d     c     x
           і       і      і 1     2     Esc   q     Tab   a     Caps  z
           і       і      і [VT]  [LF]  [BS]  [TAB] Fire2 Fire1       Del
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B4E6 і &B39C і &50  і Shifted Key Table:
           і       і      і Cur U Cur R Cur D f9    f6    f3    Enter f.
           і       і      і Cur L Copy  f7    f8    f5    f1    f2    f0
           і       і      і Clr   {     Ret   }     f4          `
           і       і      і њ     =     |     P     +     *     ?     >
           і       і      і _     )     O     I     L     K     M     <
           і       і      і (     '     U     Y     H     J     N     Space
           і       і      і &     %     R     T     G     F     B     V
           і       і      і $     #     E     W     S     D     C     X
           і       і      і !     "     Esc   Q     ->    A     Caps  Z
           і       і      і [VT]  [LF]  [BS]  [TAB] Fire2 Fire1       Del
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B536 і &B3EC і &50  і Control Key Table:
           і       і      і Cur U Cur R Cur D f9    f6    f3    Enter f.
           і       і      і Cur L Copy  f7    f8    f5    f1    f2    f0
           і       і      і Clr   (ESC) Ret   (GS)  f4          (FS)
           і       і      і (RS)        (NUL) (DLE)
           і       і      і (US)        (SI)  (HT)  (FF)  (VT)  (CR)
           і       і      і             (NAK) (EM)  (BS)  (LF)  (SO)
           і       і      і             (DC2) (DC4) (BEL) (ACK) (STX) (SYN)
           і       і      і             (ENQ) (ETB) (DC3) (EOT) (ETX) (CAN)
           і       і      і       ~     Esc   (DC1) Ins   (SOH) S-lck (SUB)
           і       і      і                                     Del
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B586 і &B43C і 10   і KB repeats table (each byte/bit applies to
           і       і      і   all three key tables): 1 byte is used
           і       і      і   per line of the tables; b0 to b7 give
           і       і      і   the columns (left to right), repeat if
           і       і      і   set
     &B590 і &B446 і &98  і DEF KEY's definition area (for Keys &80 to
           і       і      і   &9F in sequence): each definition has
           і       і      і   either a single byte of &00 if it is
           і       і      і   unused/unaltered, or:
           і       і      і  byte 1: length of definition
           і       і      і  bytes 2 to x: definition, either a single
           і       і      і   key or a string of keys
     &B628 і &B4DE і 1    і Byte after end of DEF KEY area
     &B629 і &B4DF і 1    і
     &B62A і &B4E0 і 1    і
     &B62B і &B4E1 і 2    і address of DEF KEY area
     &B62D і &B4E3 і 2    і address of byte after end of DEF KEY area
     &B62F і &B4E5 і 1    і
     &B630 і &B4E6 і 1    і
     &B631 і &B4E7 і 1    і Shift lock flag (&00=off; &FF=on)
     &B632 і &B4E8 і 1    і Caps lock flag (&00=off; &FF=on)
     &B633 і &B4E9 і 1    і KB repeat period (SPEED KEY - default &02
           і       і      і   @ 0.02 seconds)
     &B634 і &B4EA і 1    і KB delay period (SPEED KEY - default &1E
           і       і      і   @ 0.02 seconds)

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B635 і &B4EB і 2*10 і Tables used for key scanning; bits 0 to 7
           і       і      і   give the table columns (from left to
           і       і      і   right):
     &B635 і &B4EB і 1    і Cur U Cur R Cur D f9    f6    f3    Enter f.
     &B636 і &B4EC і 1    і Cur L Copy  f7    f8    f5    f1    f2    f0
     &B637 і &B4ED і 1    і Clr   [     Ret   ]     f4    Shift \     Ctrl
     &B638 і &B4EE і 1    і ^     -     @     p     ;     :     /     .
     &B639 і &B4EF і 1    і 0     9     o     i     l     k     m     j
     &B63A і &B4F0 і 1    і 8     7     u     y     h     j     n     Space
     &B63B і &B4F1 і 1    і Down  Up    Left  Right Fire2 Fire1 (Joystick 1)
     &B63B і &B4F1 і 1    і 6     5     r     t     g     f     b     v
     &B63C і &B4F2 і 1    і 4     3     e     w     s     d     c     x
     &B63D і &B4F3 і 1    і 1     2     Esc   q     Tab   a     Caps  z
     &B63E і &B4F4 і 1    і Down  Up    Left  Right Fire2 Fire1 (Joystick 2)
     &B63E і &B4F4 і 1    і                                           Del
           і       і      і
     &B63F і &B4F5 і 1    і complement of &B635
     &B640 і &B4F6 і 1    і complement of &B636
     &B641 і &B4F7 і 1    і complement of &B637
     &B642 і &B4F8 і 1    і complement of &B638
     &B643 і &B4F9 і 1    і complement of &B639
     &B644 і &B4FA і 1    і complement of &B63A
     &B645 і &B4FB і 1    і complement of &B63B
     &B646 і &B4FC і 1    і complement of &B63C
     &B647 і &B4FD і 1    і complement of &B63D
     &B648 і &B4FE і 1    і complement of &B63E
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B64B і &B501 і      і
     &B653 і &B509 і 1    і
     &B654 і &B5OA і 1    і
     &B655 і &B50B і 1    і
     &B656 і &B50C і 1    і
     &B657 і &B50D і 7    і event block for Keyboard handling,
           і       і      і   comprises:
     &B657 і &B50D і 2    і chain address
     &B659 і &B50F і 1    і count
     &B65A і &B510 і 1    і class: express event
     &B65B і &B511 і 2    і ROM routine address: &C492
     &B65D і &B513 і 1    і ROM select number: &FD
     &B65E і &B514 і 20*2 і store for last keys pressed and each entry
           і       і      і   is as follows:
           і       і      і   byte 1: +0 to +10=key tables' line
           і       і      і   number; if bit 5 is set then Shift is
           і       і      і   pressed; bit 7=Control is pressed
           і       і      і   byte 2: b0 to b7=key tables' column
           і       і      і   number - see &B496 etc
     &B67F і &B67F і 2    і vestige from the 464?
     &B686 і &B53C і 1    і
     &B687 і &B53D і 1    і accumulated count of the number of keys
           і       і      і   pressed (MOD 20)
     &B688 і &B53E і 1    і number of keys left in key buffer
     &B689 і &B53F і 1    і accumulated count of the number of keys
           і       і      і   removed from the buffer (MOD 20)
     &B68A і &B540 і 1    і
     &B68B і &B541 і 2    і address of the normal key table
     &B68D і &B543 і 2    і address of the shifted key table
     &B68F і &B545 і 2    і address of the control key table
     &B691 і &B547 і 2    і address of the KB repeats table

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B692 і       і 1    і
     &B693 і &B328 і 2    і ORIGIN x
     &B695 і &B32A і 2    і ORIGIN y
     &B697 і &B32C і 2    і graphics text x position (pixel)
     &B699 і &B32E і 2    і graphics text y position(pixel)
     &B69B і &B330 і 2    і graphics window x of one edge (pixel)
     &B69D і &B332 і 2    і graphics window x of other edge (pixel)
     &B69F і &B334 і 2    і graphics window y of one side (pixel)
     &B6A1 і &B336 і 2    і graphics window y of other side (pixel)
     &B6A3 і &B338 і 1    і GRAPHICS PEN
     &B6A4 і &B339 і 1    і GRAPHICS PAPER
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B6A5 і &B33A і 8/14 і (This area is 14 bytes on the 464) Used by
           і       і      і   line drawing (and other) routines, as
           і       і      і   follows:
     &B6A7 і &B33A і 2    і x+1()
     &B6A9 і &B33C і 2    і y/2+1()
     &B6AB і &B33E і 2    і y/2-x()
     &B6AD і &B340 і 2    і
           і &B342 і 2    і
     &B6AF і &B344 і 1    і
     &B6B0 і &B345 і 1    і
     &B6B1 і &B346 і 1    і
     &B6B2 і       і 1    і first point on drawn line flag (<>0=to be
           і       і      і   plotted; 0=don't plot)
     &B6B3 і       і 1    і line MASK
     &B6B4 і       і 1    і
           і &B207 і 2    і
     &B6B5 і &B20C і 1    і current stream number
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B6B6 і &B20D і 14/15і (These areas are 15 bytes on the 464)
           і       і      і   Stream (window) 0 parameter block.
           і       і      і   These areas are arranged as &B726
     &B6C4 і &B21C і 14/15і stream (window) 1 parameter block
     &B6D2 і &B22B і 14/15і stream (window) 2 parameter block
     &B6E0 і &B23A і 14/15і stream (window) 3 parameter block
     &B6EE і &B249 і 14/15і stream (window) 4 parameter block
     &B6FC і &B258 і 14/15і stream (window) 5 parameter block
     &B70A і &B267 і 14/15і stream (window) 6 parameter block
     &B718 і &B276 і 14/15і stream (window) 7 parameter block

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B726 і &B285 і 14/15і Current Stream (Window) parameter block:
     &B726 і &B285 і 1    і cursor y position (line) with respect to
           і       і      і   the whole screen (starting from 0)
     &B727 і &B286 і 1    і cursor x position (column) with respect to
           і       і      і   the whole screen (starting from 0)
     &B728 і &B287 і      і
     &B729 і &B288 і 1    і window top line (y) with respect to the
           і       і      і   whole screen (starting from 0)
     &B72A і &B289 і 1    і window left column (x) with respect to the
           і       і      і   whole screen (starting from 0)
     &B72B і &B28A і 1    і window bottom line (y) with respect to the
           і       і      і   whole screen (starting from 0)
     &B72C і &B28B і 1    і window right colwnn (x) with respect to
           і       і      і   the whole screen (starting from 0)
     &B72D і &B28C і 1    і scroll count
     &B72E і &B28D і 1    і cursor flag (&01=disable; &02=off; &FD=on;
           і       і      і   &FE=enable)
           і &B28E і 1    і
     &B72F і &B28F і 1    і current PEN number (encoded, not its INK
           і       і      і   number)
     &B730 і &B290 і 1    і current PAPER number (encoded, not its INK
           і       і      і   number)
     &B731 і &B291 і 2    і address of text background routine:
           і       і      і   opaque=&1392; transparent=&13A0
     &B733 і &B293 і 1    і graphics character writing flag (0=off;
           і       і      і   <>0=on)
     &B734 і &B294 і 1    і ASCII number of the first character in
           і       і      і   User Defined Graphic (UDG) matrix table
     &B735 і &B295 і 1    і UDG matrix table flag (&00=non-existent;
           і       і      і   &FF=present)
     &B736 і &B296 і 2    і address of UDG matrix table
     &B738 і &B298 і 2    і
     &B758 і &B2B8 і 1    і
     &B759 і &B2B9 і 1    і

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B763 і &B2C3 і 32*3 і Control Code handling routine table - each
           і       і      і   code's entry comprises:
           і       і      і   byte 1: +0 to +9=number of parameters;
           і       і      і   +&80=re-run routine at a System Reset
           і       і      і   bytes 2 and 3: address of the control
           і       і      і     code's handling routine
     &B763 і &B2C3 і 3    і ASC 0:  &80,&1513: NUL
     &B766 і &B2C6 і 3    і ASC 1:  &81,&1335: Print control code
           і       і      і     chararacter [,char]
     &B769 і &B2C9 і 3    і ASC 2:  &80,&1297: Disable cursor
     &B76C і &B2CC і 3    і ASC 3:  &80,&1286: Enable cursor
     &B76F і &B2CF і 3    і ASC 4:  &81,&0AE9: Set mode [,mode]
     &B772 і &B2D2 і 3    і ASC 5:  &81,&1940: Print character using
           і       і      і     graphics mode [,char]
     &B775 і &B2D5 і 3    і ASC 6:  &00,&1459: Enable VDU
     &B778 і &B2D8 і 3    і ASC 7:  &80,&14E1: Beep
     &B77B і &B2DB і 3    і ASC 8:  &80,&1519: Back-space
     &B77E і &B2DE і 3    і ASC 9:  &80,&151E: Step-right
     &B781 і &B2E1 і 3    і ASC 10: &80,&1523: Linefeed
     &B784 і &B2E4 і 3    і ASC 11: &80,&1528: Previous line
     &B787 і &B2E7 і 3    і ASC 12: &80,&154F: Clear window and locate
           і       і      і     the cursor at position  1,1
     &B78A і &B2EA і 3    і ASC 13: &80,&153F: RETURN
     &B78D і &B2ED і 3    і ASC 14: &81,&12AB: Set paper [,pen]
     &B790 і &B2F0 і 3    і ASC 15: &81,&12A6: Set pen [,pen]
     &B793 і &B2F3 і 3    і ASC 16: &80,&155E: Delete the character at
           і       і      і     the cursor position
     &B796 і &B2F6 і 3    і ASC 17: &80,&1599: Clear the line up to
           і       і      і     the current cursor position
     &B799 і &B2F9 і 3    і ASC 18: &80,&158F: Clear from the cursor
           і       і      і     position to the end of the line
     &B79C і &B2FC і 3    і ASC 19: &80,&1578: Clear from start of the
           і       і      і     window to the cursor position
     &B79F і &B2FF і 3    і ASC 20: &80,&1565: Clear from the cursor
           і       і      і     position to the end of a window
     &B7A2 і &B302 і 3    і ASC 21: &80,&1452: Disable VDU
     &B7A5 і &B305 і 3    і ASC 22: &81,&14EC: Set text write mode
           і       і      і     [,mode]
     &B7A8 і &B308 і 3    і ASC 23: &81,&0C55: Set graphics draw mode
           і       і      і     [,mode]
     &B7AB і &B30B і 3    і ASC 24: &80,&12C6: Exchange pen and paper
     &B7AE і &B30E і 3    і ASC 25: &89,&150D: Define user defined
           і       і      і     character [,char,8 rows of char]
     &B7B1 і &B311 і 3    і ASC 26: &84,&1501: Define window
           і       і      і     [,left,right,top,bottom]
     &B7B4 і &B314 і 3    і ASC 27: &00,&14EB: ESC (=user)
     &B7B7 і &B317 і 3    і ASC 28: &83,&14F1: Set the pen inks
           і       і      і     [,pen,ink 1,ink 2]
     &B7BA і &B31A і 3    і ASC 29: &82,&14FA: Set border colours
           і       і      і     [,ink,ink2]
     &B7BD і &B31D і 3    і ASC 30: &80,&1539: Locate the text cursor
           і       і      і     at position 1,1
     &B7C0 і &B320 і 3    і ASC 31: &82,&1547: Locate the text cursor
           і       і      і     at [,column,line]

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B7C3 і &B1C8 і 1    і MODE number
     &B7C4 і &B1C9 і 2    і screen offset
     &B7C6 і &B1CB і 1    і screen base HB (LB taken as &00)
     &B7C7 і &B1CC і 3    і graphics VDU write mode indirection -
           і       і      і   JP &0C74
           і &B1CF і 8    і list of bytes having only one bit set,
           і       і      і   from b7 down to b0
     &B7D2 і &B1D7 і 1    і first flash period (SPEED INK - default
           і       і      і   &0A @ 0.02 seconds)
     &B7D3 і &B1D8 і 1    і second flash period (SPEED INK - default
           і       і      і   &0A @ 0.02 seconds)
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B7D4 і &B1D9 і 1+16 і Border and Pens' First Inks (as hardware
           і       і      і   numbers):
     &B7D4 і &B1D9 і 1    і hw &04 = sw 1    (blue)            border
     &B7D5 і &B1DA і 1    і hw &04 = sw 1    (blue)            pen 0
     &B7D6 і &B1DB і 1    і hw &0A = sw 24   (bright yellow)   pen 1
     &B7D7 і &B1DC і 1    і hw &13 = sw 20   (bright cyan)     pen 2
     &B7D8 і &B1DD і 1    і hw &0C = sw 6    (bright red)      pen 3
     &B7D9 і &B1DE і 1    і hw &0B = sw 26   (bright white)    pen 4
     &B7DA і &B1DF і 1    і hw &14 = sw 0    (black)           pen 5
     &B7DB і &B1E0 і 1    і hw &15 = sw 2    (bright blue)     pen 6
     &B7DC і &B1E1 і 1    і hw &0D = sw 8    (bright magenta)  pen 7
     &B7DD і &B1E2 і 1    і hw &06 = sw 10   (cyan)            pen 8
     &B7DE і &B1E3 і 1    і hw &1E = sw 12   (yellow)          pen 9
     &B7DF і &B1E4 і 1    і hw &1F = sw 14   (pale blue)       pen 10
     &B7E0 і &B1E5 і 1    і hw &07 = sw 16   (pink)            pen 11
     &B7E1 і &B1E6 і 1    і hw &12 = sw 18   (bright green)    pen 12
     &B7E2 і &B1E7 і 1    і hw &19 = sw 22   (pale green)      pen 13
     &B7E3 і &B1E8 і 1    і hw &04 = sw 1    (blue)            pen 14
     &B7E4 і &B1E9 і 1    і hw &17 = sw 11   (sky blue)        pen 15
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B7E5 і &B1EA і 1+16 і Border and Pens' Second Inks (as hardware
           і       і      і   numbers):
     &B7E5 і &B1EA і 1    і hw &04 = sw 1    (blue)            border
     &B7E6 і &B1EB і 1    і hw &04 = sw 1    (blue)            pen 0
     &B7E7 і &B1EC і 1    і hw &0A = sw 24   (bright yellow)   pen 1
     &B7E8 і &B1ED і 1    і hw &13 = sw 20   (bright cyan)     pen 2
     &B7E9 і &B1EE і 1    і hw &0C = sw 6    (bright red)      pen 3
     &B7EA і &B1FF і 1    і hw &0B = sw 26   (bright white)    pen 4
     &B7EB і &B1F0 і 1    і hw &14 = sw 0    (black)           pen 5
     &B7EC і &B1F1 і 1    і hw &15 = sw 2    (bright blue)     pen 6
     &B7ED і &B1F2 і 1    і hw &0D = sw 8    (bright magenta)  pen 7
     &B7EE і &B1F3 і 1    і hw &06 = sw 10   (cyan)            pen 8
     &B7EF і &B1F4 і 1    і hw &1E = sw 12   (yellow)          pen 9
     &B7F0 і &B1F5 і 1    і hw &1F = sw 14   (pale blue)       pen 10
     &B7F1 і &B1F6 і 1    і hw &07 = sw 16   (pink)            pen 11
     &B7F2 і &B1F7 і 1    і hw &12 = sw 18   (bright green)    pen 12
     &B7F3 і &B1F8 і 1    і hw &19 = sw 22   (pale green)      pen 13
     &B7F4 і &B1F9 і 1    і hw &04 = sw 1    (bright yellow)   pen 14
     &B7F5 і &B1FA і 1    і hw &17 = sw 11   (pink)            pen 15

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B7F6 і &B1FB і 1    і
     &B7F7 і &B1FC і 1    і
     &B7F8 і &B1FD і 1    і
     &B7F9 і &BlFE і 2    і
     &B7FB і &B200 і 2    і
     &B7FD і       і      і
     &B802 і       і 1+1  і
     &B804 і       і 1    і number of entries in the Printer
           і       і      і   Translation Table (normally 10)
     &B805 і       і 20*2 і Printer Translation Table; each entry
           і       і      і   comprises:
           і       і      і   byte 1: screen code
           і       і      і   byte 2: pnnter code
     &B805 і       і 2    і screen &A0 printer &5E (acute accent)
     &B807 і       і 2    і screen &A1 printer &5C (\)
     &B809 і       і 2    і screen &A2 printer &7B ({)
     &B80B і       і 2    і screen &A3 printer &23 (#)
     &B80D і       і 2    і screen &A6 printer &40 (@)
     &B80F і       і 2    і screen &AB printer &7C (|)
     &B811 і       і 2    і screen &AC printer &7D (})
     &B813 і       і 2    і screen &AD printer &7E (~)
     &B815 і       і 2    і screen &AE printer &5D (])
     &B817 і       і 2    і screen &AF printer &SE ([)
     &B819 і       і 20   і room for ten more translations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B82D і &B100 і 1    і
     &B82E і &B101 і 1    і
     &B82F і &B102 і 2    і
     &B831 і &B104 і 1    і
     &B832 і &B105 і 2    і temporary store for stack pointer (SP)
           і       і      і   during interrupt handling
     &B834 і &B107 і &70  і temporary machine stack (from &B8B3
           і       і      і   downwards) during interrupt handling
     &B8B4 і &B187 і 4    і TIME (stored with the LB first - four
           і       і      і   bytes give >166 days; three bytes give
           і       і      і   >15 hours)
     &B8B8 і &B18B і 1    і
     &B8B9 і &B18C і 2    і
     &B8BB і &B18E і 2    і
     &B8BD і &B190 і 2    і address of the first ticker block in chain
           і       і      і   (if any)
     &B8BF і &B192 і 1    і Keyboard scan flag (&00=scan not needed;
           і       і      і   &01=scan needed)
     &B8C0 і &B193 і 2    і address of the first event block in chain
           і       і      і   (if any)
     &B8C2 і &B195 і 1    і
     &B8C3 і &B196 і &10  і buffer for last RSX or RSX command name
           і       і      і   (last character has bit 7 set)
     &B8D3 і &B1A6 і 2    і address of first ROM or RSX chaining block
           і       і      і   in chain
     &B8D5 і       і 1    і RAM bank number
     &B8D6 і &B1A8 і 1    і Upper ROM status (eg select number)
     &B8D7 і &B1A9 і 2    і entry point of foreground ROM in use (eg
           і       і      і   &C006 for BASIC ROM)
     &B8D9 і &B1AB і 1    і foreground ROM select address (0 for the
           і       і      і   BASIC ROM)

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B8DA і       і 16*2 і ROM entry IY value (ie the address table)
           і       і      і   - the 6128 has ROMs numbered from 0 to
           і       і      і   15:
           і &B1AC і 7*2  і ROM entry IY value (ie the address table)
           і       і      і   -the 464 has ROMs 1 to 7 only:
     &B8DA і       і 2    і ROM 0  IY (not for the 464)
     &B8DC і &B1AC і 2    і ROM 1  IY
     &B8DE і &B1AE і 2    і ROM 2  IY
     &B8E0 і &B1B0 і 2    і ROM 3  IY
     &B8E2 і &B1B2 і 2    і ROM 4  IY
     &B8E4 і &B1B4 і 2    і ROM 5  IY
     &B8E6 і &B1B6 і 2    і ROM 6  IY
     &B8E8 і &B1B8 і 2    і ROM 7  IY (usually &A700 for AMSDOS/CPM
           і       і      і   ROM)
     &B8EA і       і 2    і ROM 8  IY (not 464)
     &B8EC і       і 2    і ROM 9  IY (not 464)
     &B8EE і       і 2    і ROM 10 IY (not 464)
     &B8F0 і       і 2    і ROM 11 IY (not 464)
     &B8F2 і       і 2    і ROM 12 IY (not 464)
     &B8F4 і       і 2    і ROM 13 IY (not 464)
     &B8F6 і       і 2    і ROM 14 IY (not 464)
     &B8F8 і       і 2    і ROM 15 IY (not 464)
     &B8FA і       і 6    і 6  bytes of &FF
           і &B1BA і 14   і 14 bytes of &00
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &B900 і &B900 і 12*3 і High Kernel Jumpblock (on the 464 this
           і       і      і   block is 11*3 bytes in size)
     &B924 і &B921 і &1C0 і routines used by the High Kernel
           і       і      і   Jumpblock (on the 464 this is &1C8 bytes
           і       і      і   in size)
     &BAE4 і &BAE9 і      і bytes of &FF (&1C bytes on 6128, &17 bytes
           і       і      і   on 464)
     &BB00 і &BB00 і 26*3 і Key Manager Jumpblock
     &BB4E і &BB4E і 36*3 і Text VDU Jumpblock
     &BBBA і &BBBA і 23*3 і Graphics VDU Jumpblock
     &BBFF і &BBFF і 34*3 і Screen Pack Jumpblock
     &BC65 і &BC65 і 22*3 і Cassette (and Disc if fitted) Manager
           і       і      і   Jumpblock
     &BCA7 і &BCA7 і 11*3 і Sound Manager Jumpblock
     &BCC8 і &BCC8 і 25*3 і Kernel Jumpblock
     &BD13 і &BD13 і 26*3 і Machine Pack Jumpblock (on the 464 this
           і       і      і   block is 14*3 bytes in size)
     &BD61 і &BD3D і 32*3 і Maths Jumpblock (on the 464 this block is
           і       і      і   48*3 bytes in size)
     &BDCD і &BDCD і 14*3 і Firmware Indirections (on the 464 this
           і       і      і   block is 13*3 bytes in size
     &BDF7 і &BDF4 і      і bytes of &00 (&09 bytes on 6128, &0C bytes
           і       і      і   on the 464) the lower limit of Machine
           і       і      і   Stack if no Disc Drive
     &BE00 і &BE00 і &40  і &40 bytes of &FF

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &BE40 і &BE40 і &4x  і used by the AMSDOS ROM if a disc drive is
           і       і      і   fitted (otherwise &4x bytes of &FF)
     &BE40 і &BE40 і 2    і (address &A910)
     &BE42 і &BE42 і 2    і address of drive A XDPB
     &BE44 і &BE44 і 9    і Disc Set Up timing block:
     &BE44 і &BE44 і 2    і motor on period (default &0032; fastest
           і       і      і   &0023 @ 20mS)
     &BE46 і &BE46 і 2    і motor off period (default &00FA; fastest
           і       і      і   &00C8 @ 20mS)
     &BE48 і &BE48 і 1    і write current off period (default &AF
           і       і      і   @ 10жS)
     &BE49 і &BE49 і 1    і head settle time (default &0F @ 1mS)
     &BE4A і &BE4A і 1    і step rate period (default &0C; fastest &0A
           і       і      і   @ 1mS)
     &BE4B і &BE4B і 1    і head unload delay (default &01)
     &BE4C і &BE4C і 1    і b0=non DMA mode; b1 to b7=head load delay
           і       і      і   (default &03)
     &BE4D і &BE4D і 2    і
     &BE4F і &BE4F і 1    і Drive Header Information Block:
     &BE4F і &BE4F і 1    і last track used
     &BE50 і &BE50 і 1    і head number (&00)
     &BE51 і &BE51 і 1    і last sector used
     &BE52 і &BE52 і 1    і log2(sector size)-7
     &BE53 і &BE53 і 1    і
     &BE54 і &BE54 і 1    і
     &BE55 і &BE55 і 1    і
     &BE56 і &BE56 і 1    і
     &BE58 і &BE58 і 1    і
     &BE59 і &BE59 і 1    і
     &BE5D і &BE5D і 1    і
     &BE5E і &BE5E і 1    і
     &BE5F і &BE5F і 1    і disc motor flag (&00=off;&01=on
           і       і      і   - strangely reversed)
     &BE60 і &BE60 і 2    і address of buffer for directory entries
           і       і      і   block (&A930)
     &BE62 і &BE62 і 2    і as &BE76 (ie&A9B0)
     &BE64 і &BE64 і 2    і
     &BE66 і &BE66 і 1    і disc retries (default &10)

     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &BE67 і &BE67 і &11  і AMSDOS Ticker and Event Block:
     &BE67 і &BE67 і 2    і ticker chaining address
     &BE69 і &BE69 і 2    і tick count
     &BE6B і &BE6B і 2    і recharge count
     &BE6D і &BE6D і 2    і event chaining address
     &BE6F і &BE6F і 1    і count
     &BE70 і &BE70 і 1    і class (asynchronous event)
     &BE71 і &BE71 і 2    і ROM routine address (&C9D6)
     &BE73 і &BE73 і 1    і ROM select number (&07 ie the AMSDOS/CPM
           і       і      і   ROM)
     &BE74 і &BE74 і 1    і last sector number used
     &BE75 і &BE75 і 1    і
     &BE76 і &BE76 і 2    і address of «K buffer, or of header info
           і       і      і   block (for WRlTE SECTOR etc)
     &BE78 і &BE78 і 1    і disc error message flag (&00=on; &FF=off
           і       і      і   - reversed again)
     &BE7D і &BE7D і 2    і address of AMSDOS reserved area (&A700)
     &BE7F і &BE7F і x    і area used by AMSDOS to copy routines into
           і       і      і   RAM for running
     &BE80 і &BE80 і &80  і &80 bytes of &FF (limit of machine stack
           і       і      і   if disc drive fitted)
     &BF00 і &BF00 і xy   і &xy bytes of &00)
     &BFxy і       і      і machine stack (in theory this stack could
           і       і      і   extend down much further)
     &BFFF і &BFFF і      і upper limit of machine stack

    The area from &C000 to &FFFF  is  taken  up by the screen memory -
the layout of which is  illustrated  on  the next page.  Printed below
are diagrams which show how the CPC uses the bytes of screen memory in
the different MODEs.  For each byte:

in MODE 2 (where there are two colours only, each pixel needs only one
           bit - either on or off)

    bit7 bit6 bit5 bit4 bit3 bit2 bit1 bit0
     p0   p1   p2   p3   p4   p5   p6   p7

(the pixels are arranged with p0 being the leftmost one, etc)

in MODE 1 (where four colours are available and so two bits are needed
           for each pixel - 1 byte represents 4 pixels)
    bit7  bit6  bit5  bit4  bit3  bit2  bit1  bit0
    p0(1) p1(1) p2(1) p3(1) p0(0) p1(0) p2(0) p3(0)

(each pixel is twice as wide as in MODE 2)

in MODE 0 (where sixteen colours are possible and four bits are needed
           for each pixel - 1 byte represents 2 pixels)

    bit7  bit6  bit5  bit4  bit3  bit2  bit1  bit0
    p0(0) p1(0) p0(2) p1(2) p0(1) p1(1) p0(3) p1(3)

(each pixel is four times as wide as in MODE 2)

NB: the numbers in brackets show  which  bit of the pixel's pen number
the screen byte bit refers  to.   For  example  in  MODE 1, the 4 most
significant bits of the byte hold bit  1  of the pixel's pen value and
the 41east signifcant bits hold bit 0 of the pen value.


     6128  і 464   і Size і Comments on the memory locations
     ДДДДДДЕДДДДДДДЕДДДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДДД
     &C000   &C000   &4000  normal (upper) screen area.  The
                              alternative (lower) screen area is from
                              &4000 to &7FFF.  The addresses of the
                              starts of lines and rows in the normal
                              screen area after a MODE instruction
                              are:

    LINE    R0W0   R0W1   R0W2   R0W3   R0W4   R0W5   R0W6   R0W7
    1       C000   C800   D000   D800   E000   E800   F000   F800
    2       C050   C850   D050   D850   E050   E850   F050   F850
    3       C0A0   C8A0   D0A0   D8A0   E0A0   E8A0   F0A0   F8A0
    4       C0F0   C8F0   D0F0   D8F0   E0F0   E8F0   F0F0   F8F0
    5       C140   C940   D140   D940   E140   E940   F140   F940
    6       C190   C990   D190   D990   E190   E990   F190   F990
    7       C1E0   C9E0   D1E0   D9E0   E1E0   E9E0   F1E0   F9E0
    8       C230   CA30   D230   DA30   E230   EA30   F230   FA30
    9       C280   CA80   D280   DA80   E280   EA80   F280   FA80
    10      C2D0   CAD0   D2D0   DAD0   E2D0   EAD0   F2D0   FAD0
    11      C320   CB20   D320   DB20   E320   EB20   F320   FB20
    12      C370   CB70   D370   DB70   E370   EB70   F370   FB70
    13      C3C0   CBC0   D3C0   DBC0   E3C0   EBC0   F3C0   FBC0
    14      C410   CC10   D410   DC10   E410   EC10   F410   FC10
    15      C460   CC60   D460   DC60   E460   EC60   F460   FC60
    16      C4B0   CCB0   D4B0   DCB0   E4B0   ECB0   F4B0   FCB0
    17      C500   CD00   D500   DD00   E500   ED00   F500   FD00
    18      C550   CD50   D550   DD50   E550   ED50   F550   FD50
    19      C5A0   CDA0   D5A0   DDA0   E5A0   EDA0   F5A0   FDA0
    20      C5F0   CDF0   D5F0   DDF0   E5F0   ED50   F550   FD50
    21      C640   CE40   D640   DE40   E640   EE40   F640   FE40
    22      C690   CE90   D690   DE90   E690   EE90   F690   FE90
    23      C6E0   CEE0   D6E0   DEE0   E6E0   EEE0   F6E0   FEE0
    24      C730   CF30   D730   DF30   E730   EF30   F730   FF30
    25      C780   CF80   D780   DF80   E780   EF80   F780   FF80

spare start C7D0   CFD0   D7D0   DFD0   E7D0   EFD0   F7D0   FFD0
 spare end  C7FF   CFFF   D7FF   DFFF   E7FF   EFFF   F7FF   FFFF

    Once the whole screen  has  been  scrolled  in any direction, the
above table will  become  incorrect.   On  scrolling,  all  the above
addresses will have an offset (MOD &800) added, derived as follows:

+&02 per scroll to the left (=2, 1 or « character in MODE 2, MODE 1
     or MODE 0 respectively)
-&02 per scroll to the right (=2, 1 or « character in MODE 2, MODE 1
     or MODE 0 respectively)
+&50 per scroll up one line
-&50 per scroll down one line

    If  scrolled  far  enough,  a  screen  row  may  sit  across  the
boundaries of the screen memory area, whose bottom end will then wrap
around to join up with the  top  (ie  byte  &FFFF will be followed by
byte &C000 assuming the  normal  screen  area).   If before scrolling
however, a window had been set up  smaller than the whole screen then
the table will remain accurate despite any scrolling.

The 'spare' areas of  screen  memory  are  filled  with  bytes of the
relevant PAPER value each time there  is  a  full screen CLS, and are
not really available for other uses.  After scrolling the spare areas
may be used as screen with other bytes becoming spare.

FIRMWARE SUMMARY

   The Firmware Jumpblock is the  recommended method of communicating
with the routines in the lower  ROM  -  it  is  used by BASIC, and it
should also be used  by  other  programs.  The  reason  for using the
jumpblock is that  the  routines  in  the  lower  ROM  are located at
different positions on the  different  machines.   The entries in the
jumpblock, however, are all in the  same  place - the instructions in
the jumpblock redirect the computer to the correct place in the lower
ROM.  Thus, providing a program uses the jumpblock, it should work on
any CPC computer. By altering  the  firmware jumpblock it is possible
to make the computer run a different routine from normal.  This could
either be a different routine in the lower or upper ROM, or a routine
written by the user - this is  known as 'patching the jumpblock'.  It
is worth noting that because BASIC  uses the firmware jumpblock quite
heavily, it is possible to  alter  the  effect of BASIC commands. The
following example will change  the  effect  of  calling  SCR SET MODE
(&BCOE) - instead of changing  the  mode,  any calls to this location
will print the letter 'A'.  The first  thing to do is to assemble the
piece of code that will be used to print the letter - this is printed
below and starts at &4000.

ORG &4000
LD A,65      ; 65 IS ASCII FOR 'A'
CALL &BB5A   ; TXT OUTPUT
RET          ; RETURN FROM SUBROUTINE

   The jumpblock entry for SCR  SET  MODE  is  now patched so that it
reroutes all calls to &BC0E away from the lower ROM and to our custom
routine at &4000.  This is done by changing the bytes at &BC0E, &BC0F
and &BC10 to &C3, &00, &40 respectively  (ie JP &4000).  Any calls to
&BC0E or MODE  commands  will  now  print  the  letter  A  instead of
changing mode.  The indirections jumpblock contains a small number of
routines which are called by the  rest  of the firmware.  By altering
this jumpblock, it is possible to alter the way in which the firmware
operates on a large scale - thus  it is not always necessary to patch
large numbers of entries  in  the  firmware  jumpblock. There are two
jumpblocks which are to do with the Kemel (ie the high and low Kernel
jumpblocks).  The high jumpblock allows  ROM states and interrupts to
be altered, and also  controls  the  introduction  of  RSXs.  The low
jumpblock contains general  routines  and  restart instructions which
are used by the computer for its own purposes.

THE FIRMWARE IN DETAIL

 Low Kernel Jumpblock

000   &0000   RESET ENTRY (RST 0)
      Action: Resets the computer as if it has just been switched on
      Entry:  No entry conditions
      Exit:   This routine is never returned from
      Notes:  After initialisation  of  the  hardware  and  firmware,
              control is handed over to ROM 0 (usually BASIC)

001   &0008   LOW JUMP (RST 1)
      Action: Jumps to a routine in either the lower ROM or low RAM
      Entry:  No entry conditions - all  the  registers are passed to
              the destination routine unchanged
      Exit:   The registers are as set  by  the  routine in the lower
              ROM or RAM or are returned unaltered
      Notes:  The RST 1 instruction  is  followed  by  a two byte low
              address, which is defmed as follows:
                if bit 15 is set, then the upper ROM is disabled
                if bit 14 is set, then the lower ROM is disabled
                bits 13 to 0 contain the address of the routine to
                  jump to
              This command is used by the  majority of entries in the
              main firmware jumpblock

002   &000B   KL LOW PCHL
      Action: Jumps to a routine in either the lower ROM or low RAM
      Entry:  HL contains the low  address  -  all  the registers are
              passed to the destination routine unchanged
      Exit:   The registers are as set  by  the  routine in the lower
              ROM or RAM or are returned unaltered
      Notes:  The two byte low  address  in  the  HL register pair is
              defined as follows:
                if bit 15 is set, then the upper ROM is disabled
                if bit 14 is set, then the lower ROM is disabled
                bits 13 to 0 contain the address of the routine to
                  jump to

003   &000E   PCBC INSTRUCTION
      Action: Jumps to the specified address
      Entry:  BC contains the address to jump  to - all the registers
              are passed to the destination routine unaltered
      Exit:   The registers are as set  by the destination routine or
              are returned unchanged

004   &0010   SIDE CALL (RST 2)
      Action: Calls a routine  in  ROM,  in  a  group  of  up to four
              foreground ROMs
      Entry:  No entry conditions - all  the  registers apart from IY
              are passed to the destination routine unaltered
      Exit:   IY is corrupt, and the  other  registers  are as set by
              the destination routine or are returned unchanged
      Notes:  The RST 2 instruction is  followed  by  a two byte side
              address, which is defined as follows:
                bits 14 and 15 give a number between 0 and 3, which
                  is added to the main foreground ROM select address
                  - this is then used as the ROM select address
                bits 0 to 13 contain the address to which is added
                  &C000 - this gives the address of the routine to be
                  called

005   &0013   KL SIDE PCHL
      Action: Calls a routine in another ROM
      Entry:  HL contains the side address  - all the registers apart
              from IY are passed to the destination routine unaltered
      Exit:   IY is corrupt, and the  other  registers  are as set by
              the destination routine or are returned unchanged
      Notes:  The two byte side address is defined as follows:
                bits 14 and 15 give a number between 0 and 3, which
                  is added to the main foreground ROM select address
                  - this is then used as the ROM select address
                bits 0 to 13 contain the address to which is added
                  &C000 - this gives the address of the routine to be
                  called

006   &0016   PCDE INSTRUCTION
      Action: Jumps to the specified address
      Entry:  DE contains the address to jump  to - all the registers
              are passed to the destination routine unaltered
      Exit:   The registers are as set  by the destination routine or
              are returned unchanged

007   &0018   FAR CALL (RST 3)
      Action: Calls a routine anywhere in ROM or ROM
      Entry:  No entry conditions - all  the  registers apart from IY
              are passed to the destination routine unaltered
      Exit:   IY is preserved, and the other  registers are as set by
              the destination routine or are returned unchanged
      Notes:  The RST 3 instruction is followed by a two byte in-line
              address.  At this address,  there  is  a three byte far
              address, which is defined as follows:
                bytes 0 and 1 give the address of the routine to be
                  called
                byte 2 is the ROM select byte which has values as
                  follows:
                  &00 to &FB-- select the given upper ROM, enable the
                  upper ROM and disable the lower ROM
                  &FC - no change to the ROM selection, enable the
                  upper and lower ROMs
                  &FD - no change to the ROM selection, enable the
                  upper ROM and disable the lower ROM
                  &FE - no change to the ROM selection, disable the
                  upper ROM and enable the lower ROM
                  &FF - no change to the ROM selection, disable the
                  upper and lower ROMs
              When it is retumed  from,  the  ROM selection and state
              are restored to their settings before the RST 3 command

008   &001B   KL FAR PCHL
      Action: Calls a routine, given by  the  far  address in HL & C,
              anywhere in RAM or ROM
      Entry:  HL holds the address of the routine to be called, and C
              holds the ROM select  byte  -  all  the registers apart
              from IY are passed to the destination routine unaltered
      Exit:   IY is preserved, and the other  registers are as set by
              the destination routine or are returned unchanged
      Notes:  See FAR CALL (RST 3) above  for more details on the ROM
              select byte

009   &001E   PCHL INSTRUCTION
      Action: Jumps to the specified address
      Entry:  HL contains the address to jump  to - all the registers
              are passed to the destination routine unaltered
      Exit:   The registers are as set  by the destination routine or
              are returned unchanged

010   &0020   RAM LAM
      Action: Puts the contents of a  RAM  memory location into the A
              register
      Entry:  HL contains the address of the memory location
      Exit:   A holds the contents  of  the  memory location, and all
              other registers are preserved
      Notes:  This routine always reads from  RAM,  even if the upper
              or lower ROM is enabled

011   &0023   KL FAR CALL
      Action: Calls a routine anywhere in RAM or ROM

      Entry:  HL holds the address of the three byte far address that
              is to be used -  all  the  registers  apart from IY are
              passed to the destination routine unaltered
      Exit:   IY is preserved, and the other  registers are as set by
              the destination routine or are returned unchanged
      Notes:  See FAR CALL above for  more  details on the three byte
              far address

012   &0028   FIRM JUMP (RST 5)
      Action: Jumps to a  routine  in  either  the  lower  ROM or the
              central 32K of RAM
      Entry:  No entry conditions - all  the  registers are passed to
              the destination routine unchanged
      Exit:   The registers are as set  by  the  routine in the lower
              ROM or RAM or are returned unaltered
      Notes:  The RST  5  instruction  is  followed  by  a  two  byte
              address, which is the  address  to  jump to; before the
              jump is made, the lower ROM is enabled, and is disabled
              when the destination routine is returned from

013   &0030   USER RESTART (RST 6)
      Action: This is an RST instruction that may be set aside by the
              user for any purpose
      Entry:  Defined by the user
      Exit:   Defined by the user
      Notes:  The bytes from &0030  to  &0037  are  available for the
              user to put their own code in if they wish

014   &0038   INTERRUPT ENTRY (RST 7)
      Action: Deals with normal interrupts
      Entry:  No entry conditions
      Exit:   All registers are preserved
      Notes:  The RST 7 instruction must not be used by the user; any
              external interrupts that are  generated  by hardware on
              the expansion  port  will  be  dealt  with  by  the EXT
              INTERRUPT routine (see  Low  Kernel  Jumpblock, routine
              015)

015   &003B   EXT INTERRUPT
      Action: This area  is  set  aside  for  dealing  with  external
              interrupts that are generated by any extra hardware
      Entry:  No entry conditions
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  If any external hardware  is  going to generate interr-
              upts, then the user must  patch  the area from &003B to
              &003F so that the computer  can  deal with the external
              interrupt; when an external interrupt occurs, the lower
              ROM is disabled and the  code  at  &003B is called; the
              default external  interrupt  routine  at  &003B  simply
              returns, and  this  will  cause  the  computer  to hang
              because the interrupt will continue to exist

High Kernel Jumpblock

000   &B900   KL U ROM ENABLE
      Action: Enables the current upper ROM
      Entry:  No entry conditions
      Exit:   A contains the previous state of the ROM, the flags are
              corrupt, and all other registers are preserved
      Notes:  After this routine has  been  called,  all reading from
              addresses between &C000 and  &FFFF  refers to the upper
              ROM, and not the top  16K  of  RAM which is usually the
              screen memory; any  writing  to  these  addresses still
              affects the  RAM  as,  by  its  nature,  ROM  cannot be
              written to

001   &B903   KL U ROM DISABLE
      Action: Disables the upper ROM
      Entry:  No entry conditions
      Exit:   A contains the previous state of the ROM, the flags are
              corrupt, and all other registers are preserved
      Notes:  After this routine has  been  called,  all reading from
              addresses between &C000 and ~F~FF refers to the top 16K
              of RAM which is usually the screen memory

002   &B906   KL L ROM ENABLE
      Action: Enables the lower ROM
      Entry:  No entry conditions
      Exit:   A contains the previous state of the ROM, the flags are
              corrupt, and all other registers are preserved
      Notes:  After this routine has  been  called,  all reading from
              addresses between &0000 and  &4000  refers to the lower
              ROM, and not the  bottom  16K  of  RAM;  any writing to
              these addresses still affects the  RAM  as a ROM cannot
              be written to; the  lower  ROM is automatically enabled
              when a firmware routine is called, and is then disabled
              when the routine returns

003   &B909   KL L ROM DISABLE
      Action: Disables the lower ROM
      Entry:  No entry conditions
      Exit:   A contains the previous state of the ROM, the flags are
              corrupt, and all other registers are preserved
      Notes:  After this routine has  been  called,  all reading from
              addresses between &0000 and &4000  refers to the bottom
              16K of RAM; the lower ROM is automatically enabled when
              a firmware routine is called, and is then disabled when
              the routine returns

004   &B90C   KL ROM RESTORE
      Action: Restores the ROM to its previous state
      Entry:  A contains the previous state of the ROM
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  The previous four routines all  return  values in the A
              register which are suitable for use by KL ROM RESTORE

005   &B90F   KL ROM SELECT
      Action: Selects an upper ROM and also enables it
      Entry:  C contains the ROM select address of the required ROM
      Exit:   C contains the ROM select  address of the previous ROM,
              and B contains the state of the previous ROM

006   &B912   KL CURR SELECTION
      Action: Gets the ROM select address of the current ROM
      Entry:  No entry conditions
      Exit:   A contains the ROM select  address  of the current ROM,
              and all other registers are preserved

007   &B915   KL PROBE ROM
      Action: Gets the class and version of a specified ROM
      Entry:  C contains the ROM select address of the required ROM
      Exit:   A contains the class of  the  ROM,  H holds the version
              number, L holds me  mark  number,  B  and the flags are
              corrupt, and all other registers are preserved
      Notes:  The ROM class may be one of ine following:
                 &00 - a foregroumd ROM
                 &01 - a background ROM
                 &02 - an extension foreground ROM
                 &80 - the built in ROM (ie the BASIC ROM)

008   &B918   KL ROM DESELECT
      Action: Selects the previous upper ROM and sets its state
      Entry:  C contains me  ROM  select  address  of  the  ROM to be
              reselected, and B contains  the  state  of the required
              ROM
      Exit:   C contains the ROM select address  of me current ROM, B
              is corrupt, and all others are preserved
      Notes:  This routine reverses the acoon  of  KL ROM SELECT, and
              uses the values that it returns in B and C

009   &B91B   KL LDIR
      Action: Switches off the  upper  and  lower  ROMs,  and moves a
              block of memory
      Entry:  As for a standard  LDIR  instruction  (ie  DE holds the
              destination location, HL points to the first byte to be
              moved, and BC  holds  the  length  of  the  block to be
              moved)
      Exit:   F, BC,  DE  amd  HL  are  set  as  for  a  normal  LDIR
              instruction, and all other registers are preserved

010   &B91E   KL LDDR
      Action: Switches off the  upper  and  lower  ROMs,  amd moves a
              block of memory
      Entry:  As for a standard  LDDR  instruction  (ie  DE holds the
              first desination location,  HL  points  to  the highest
              byte lit in memory to be moved, amd BC holds the number
              of bytes to be moved)
      Exit:   F, BC,  DE  amd  HL,  are  set  as  for  a  nommal LDDR
              instruction, and all other registers are preserved

011   &B921   KL POLL SYNCHRONOUS
      Action: Tests whether an event with  a higher priority than the
              current event is waiting to be dealt with
      Entry:  No entry conditions
      Exit:   If there is  a  higher  priority  event,  then Carry is
              false; if there is no higher priority event, then Carry
              is true; in either  case,  A  and  the  other flags are
              corrupt, and all other registers are preserved

014   &B92A   KL SCAN NEEDED
      Action: Ensures that the  keyboard  is  scanned  when  the next
              ticker interrupt occurs
      Entry:  No entry conditions
      Exit:   AF amd HL  are  corrupt,  amd  all  other registers are
              preserved
      Notes:  This routine is useful  for  scanning the keyboard when
              interrupts are disabled and normal  key scanning is not
              occuring

The Key Manager

000   &BB00   KM INITIALISE
      Action: Initialises the Key Manager  and  sets up everything as
              it is when the computer  is  first switched on; the key
              buffer is emptied, Shift  and  Caps  lock are tumed off
              amd all the expansion and  translation tables are reset
              to normal; also see the routine KM RESET below
      Entry:  No entry conditions
      Exit:   AF, BC, DE and HL corrupt,  and all other registers are
              preserved

001   &BB03   KM RESET
      Action: Resets the Key Manager; the  key  buffer is emptied and
              all current keys/characters are ignored
      Entry:  No entry conditions
      Exit:   AF, BC, DE and HL  are  corrupt and all other registers
              are preserved
      Notes:  See also KM INITIALISE above:  on  the 664 or 6128, the
              key buffer can also  be  cleared  separately by calling
              the KM FLUSH routine

002   &BB06   KM WAIT CHAR
      Action: Waits for the next character from the keyboard buffer
      Entry:  No entry conditions
      Exit:   Carry is true, A holds  the  character value, the other
              flags  are  corrupt,  and   all   other  registers  are
              preserved

003   &BB09   KM READ CHAR
      Action: Tests to see  if  a  character  is  available  from the
              keyboard buffer, but  doesn't  wait  for  one to become
              available
      Entry:  No entry conditions
      Exit:   If a character was available, then Carry is true, and A
              contains the character; otherwise Carry is false, and A
              is corrupt; in  both  cases,  the  other  registers are
              preserved

004   &BB0C   KM CHAR RETURN
      Action: Saves a character for the next  use  of KM WAIT CHAR or
              KM READ CHAR
      Entry:  A contains the ASCII code  of  the  character to be put
              back
      Exit:   All registers are preserved

005   &BB0F   KM SET EXPAND
      Action: Assigns a string to a key code
      Entry:  B holds the key code; C holds the length of the string;
              HL contains the address of the string (must be in RAM)
      Exit:   If it is OK,  then  Carry  is  true; otherwise Carry is
              false; in either case, A,  BC,  DE  and HL are corrupt,
              and all other registers rlre preserved

006   &BB12   KM GET EXPAND
      Action: Reads a character from an expanded string of characters
      Entry:  A holds an expansion token (ie  a key code) and L holds
              the character position number (starts from 0)
      Exit: If it is  OK,  then  Carry  is  true,  and  A  holds  the
              character; otherwise Carry is false,  and A is corrupt;
              in either case, DE and flags are corrupt, and the other
              registers are preserved

007   &BB15   KM EXP BUFFER
      Action: Sets  aside  a  buffer  area  for  character  expansion
              strings
      Entry:  DE holds the address  of  the  buffer  and HL holds the
              length of the buffer
      Exit:   If it is OK,  then  Carry  is  true; otherwise Carry is
              false; in either case, A, BC, DE and HL are corrupt
      Notes:  The buffer must be in the  central  32K of RAM and must
              be at least 49 bytes long

008   &BB18   KM WAIT KEY
      Action: Waits for a key to be  pressed  - this routine does not
              expand any expansion tokens
      Entry:  No entry conditions
      Exit:   Carry is  true,  A  holds  the  character  or expansion
              token, and all other registers are preserved

009   &BB1B   KM READ KEY
      Action: Tests whether a key is available from the keyboard
      Entry:  No entry conditions
      Exit:   If a key  is  available,  then  Carry  is  true,  and A
              contains the character; otherwise Carry is false, and A
              is corrupt; in  either  case,  the  other registers are
              preserved
      Notes:  Any expansion tokens are not expanded

010   &BB1E   KM TEST KEY
      Action: Tests if a  particular  key  (or  joystick direction or
              button) is pressed
      Entry:  A contains the key/joystick nurnber
      Exit:   If the requested key  is  pressed,  then Zero is false;
              otherwise Zero is true for  both,  Carry is false A and
              HL are corrupt.  C holds  the  Sbift and Control status
              and others are preserved
      Notes:  After calling this, C will hold  the state of shift and
              control - if bit 7 is set then Control was pressed, and
              if bit 5 is set then Shift was pressed

011   &BB21   KM GET STATE
      Action: Gets the state of the Shift and Caps locks
      Entry:  No entry conditions
      Exit:   If L holds &FF then  the  shift  lock  is  on, but if L
              holds &00 then the Shift  lock  is  off; if H holds &FF
              then the caps lock is on,  and  if H holds &00 then the
              Caps lock is off; whatever  the  outcome, all the other
              registers are preserved

012   &BB24   KM GET JOYSTICK
      Action: Reads the present state of any joysticks attached
      Entry:  No entry conditions
      Exit:   H and A contains the state  of joystick 0, L holds that
              state of joystick 1, and all others are preserved
      Notes:  The joystick states  are  bit  significant  and  are as
              follows: Bit 0 - Up Bit
                           1 - Down Bit
                           2 - Left Bit
                           3 - Right Bit
                           4 - Fire2 Bit
                           5 - Fire1 Bit
                           6 - Spare Bit
                           7 - Always zero
              The bits are  set  when  the  corresponding  buttons or
              directions are operated

013   &BB27   KM SET TRANSLATE
      Action: Sets the token or character  that  is assigned to a key
              when neither Shift nor Control are pressed
      Entry:  A contains the key number and  B contains the new token
              or character
      Exit:   AF and HL  are  corrupt,  and  all  other registers are
              preserved
      Notes:  Special values for B are as follows:
                 &80  to  &9F  -  these   values  correspond  to  the
              expansion tokens
                 &FD - this causes the caps lock to toggle on and off
                 &FE - this causes the  shift  lock  to toggle on and
              off
                 &FF - causes this key to be ignored

014   &BB2A   KM GET TRANSLATE
      Action: Finds out what token or character will be assigned to a
              key when neither Shift nor Control are pressed
      Entry:  A contains the key number
      Exit:   A contains the token/character that is assigned, HL and
              flags are corrupt, and all others are preserved
      Notes:  See KM SET TRANSLATE  for  special  values  that can be
              returned

015   &BB2D   KM SET SHIFT
      Action: Sets the token or character that  will be assigned to a
              key when Shift is pressed as well
      Entry:  A contains the key number and  B contains the new token
              or character
      Exit:   AF and HL are corrupt, and all others are preserved
      Notes:  See KM SET TRANSLATE for special values that can be set

016   &BB30   KM GET SHIFT
      Action: Finds out what token/character  will  be  assigned to a
              key when Shift is pressed as well
      Entry:  A contains the key number
      Exit:   A contains the token/character that is assigned, HL and
              flags are corrupt, and all others are preserved
      Notes:  See KM SET TRANSLATE  for  special  values  that can be
              returned

017   &BB33   KM SET CONTROL

      Action: Sets the token or character that  will be assigned to a
              key when Control is pressed as well
      Entry:  A contains  the  key  number  and  B  contains  the new
              token/character
      Exit:   AF and HL are corrupt, and all others are preserved
      Notes:  See KM SET TRANSLATE for special values that can be set

018   &BB36   KM GET CONTROL
      Action: Finds out what token or character will be assigned to a
              key when Control is pressed as well
      Entry:  A contains the key number
      Exit:   A contains the token/character that is assigned, HL and
              flags are corrupt and all others are preserved
      Notes:  See KM SET TRANSLATE for special values that can be set

019   &BB39   KM SET REPEAT
      Action: Sets whether a key may repeat or not
      Entry:  A contains the key number B contains &00 if there is no
              repeat and &FF is it is to repeat
      Exit:   AF, BC and HL are corrupt, and all others are preserved

020   &BB3C   KM GET REPEAT
      Action: Finds out whether a key is set to repeat or not
      Entry:  A contains a key number
      Exit:   If the key repeats, then Zero is false; if the key does
              not repeat, then Zero is  true;  in  either case, A, HL
              and flags are corrupt,  Carry  is  false, and all other
              registers are preserved

021   &BB3F   KM SET DELAY
      Action: Sets the time that elapses before the first repeat, and
              also set the repeat speed
      Entry:  H contains the  time  before  the  first  repeat, and L
              holds the time between repeats (repeat speed)
      Exit:   AF is corrupt, and all others are preserved
      Notes:  The values for the times  are  given in 1/5Oth seconds,
              and a value of 0 counts as 256

022   &BB42   KM GET DELAY
      Action: Finds out the time that elapses before the first repeat
              and also the repeat speed
      Entry:  No entry conditions
      Exit:   H contains the  time  before  the  first  repeat, and L
              holds the time  between  repeats,  and  all  others are
              preserved

023   &BB45   KM ARM BREAK
      Action: Arms the Break mechanism
      Entry:  DE holds the address of  the  Break handling routine, C
              holds the ROM select address for this routine
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all  the other
              registers are preserved

024   &BB48   KM DISARM BREAK
      Action: Disables the Break mechanism
      Entry:  No entry conditions
      Exit:   AF and HL are corrupt, and  all the other registers are
              preserved

025   &BB4B   KM BREAK EVENT
      Action: Generates a Break interrupt if a Break routine has been
              specified by KM ARM BREAK
      Entry:  No entry conditions
      Exit:   AF and HL  are  corrupt,  and  all  other registers are
              preserved

The Text VDU

026   &BB4E   TXT INITIALISE

      Action: Initialise the  text  VDU  to  its  settings  when  the
              computer is switched  on,  includes  resetting  all the
              text VDU indirections,  selecting  Stream  0, resetting
              the text paper to pen  0  and  the  text  pen to pen 1,
              moving the cursor to the top  left corner of the screen
              and setting the writing mode to be opaque
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved

027   &BB51   TXT RESET
      Action: Resets the text VDU  indirections  and the control code
              table
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all  the other
              registers are preserved

028   &BB54   TXT VDU ENABLE
      Action: Allows characters to be  printed  on  the screen in the
              current stream
      Entry:  No entry conditions
      Exit:   AF is corrupt, and all other registers are preserved

029   &BB57   TXT VDU DISABLE
      Action: Prevents characters from being  printed  to the current
              stream
      Entry:  No entry conditions
      Exit:   AF  is  corrupt,  and  al1   the  other  registers  are
              preserved

030   &BB5A   TXT OUTPUT
      Action: Output a character or control code  (&00 to &1F) to the
              screen
      Entry:  A contains the character to output
      Exit:   All registers are preserved
      Notes:  Any control codes are obeyed  and nothing is printed if
              the VDU is disabled;  characters  are printed using the
              TXT OUT  ACTION  routine;  if  using  graphics printing
              mode, then control codes are printed and not obeyed

031   &BB5D   TXT WR CHAR
      Action: Print a character  at  the  current  cursor  position -
              control codes are printed and not obeyed
      Entry:  A contains the character to be printed
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Notes:  This routine uses the TXT WRITE CHAR indirection to put
              the character on the screen

032   &BB60   TXT RD CHAR
      Action: Read a character from the  screen at the current cursor
              position
      Entry:  No entry conditions
      Exit:   If it was successful then A contains the character that
              was read from the screen  and  Carry is true; otherwise
              Carry is false, and  A  holds  0;  in  either case, the
              other  flags  are  corrupt,   and   all  registers  are
              preserved
      Notes:  This routine uses the TXT UNWRITE indirection

033   &BB63   TXT SET GRAPHIC
      Action: Enables or disables graphics print character mode
      Entry:  To switch graphics printing  mode  on,  A  must be non-
              zero; to turn it off, A must contain zero
      Exit:   AF corrupt, and all other registers are preserved
      Notes:  When turned  on,  control  codes  are  printed  and not
              obeyed; characters are printed by GRA WR CHAR

034   &BB66   TXT WIN ENABLE

      Action: Sets the boundaries of the  current  text window - uses
              physical coordinates
      Entry:  H hoIds the column  number  of  one  edge,  D holds the
              column number of  the  other  edge,  L  holds  the line
              number of one edge, and E  holds the line number of the
              other edge Exit: AF, BC, DE and HL are corrupt
      Notes:  The window is not cleared  but  the  cursor is moved to
              the top left corner of the window

035   &BB69   TXT GET WINDOW
      Action: Returns the  size  of  the  current  window  -  returns
              physical coordinates
      Entry:  No entry conditions
      Exit:   H holds the column number of the left edge, D holds the
              column number of  the  right  edge,  L  holds  the line
              number of the top edge, E  holds the line number of the
              bottom edge, A is corrupt, Carry is false if the window
              covers the entire screen,  and  the other registers are
              always preserved

036   &BB6C   TXT CLEAR WINDOW
      Action: Clears the window (of the current stream) and moves the
              cursor to the top left corner of the window
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  alI others are
              preserved

037   &BB6F   TXT SET COLUMN
      Action: Sets the cursor's horizontal position
      Entry:  A contains the logical column number to move the cursor
              to
      Exit:   AF and HL are corrupt, and  all the other registers are
              preserved
      Notes:  See also TXT SET CURSOR

038   &BB72   TXT SET ROW
      Action: Sets the cursor's vertical position
      Entry:  A contains the logical line  number  to move the cursor
              to
      Exit:   AF and HL are corrupt, and all others are preserved
      Notes:  See also TXT SET CURSOR

039   &BB75   TXT SET CURSOR
      Action: Sets the cursor's vertical and horizontal position
      Entry:  H contains the logical column number and L contains the
              logical line number
      Exit:   AF and HL are corrupt, and all the others are preserved
      Notes:  See also TXT SET COLUMN and TXT SET ROW

040   &BB78   TXT GET CURSOR
      Action: Gets the cursor's current position
      Entry:  No entry conditions
      Exit:   H holds the logical column  number, L holds the logical
              line number, and A contains  the  roll count, the flags
              are corrupt, and all the other registers are preserved
      Notes:  The roll count is increased when the screen is scrolled
              down, and is decreased when it is scrolled up

041   &BB7B   TXT CUR ENABLE
      Action: Allows the  text  cursor  to  be  displayed  (if  it is
              allowed by TXT CUR ON) - intended for use by the user
      Entry:  No entry conditions
      Exit:   AF is corrupt, and all other registers are preserved

042   &BB7E   TXT CUR DISABLE
      Action: Prevents the text cursor from being displayed -intended
              for use by the user
      Entry:  No entry conditions
      Exit:   AF is corrupt, and all others are preserved

043   &BB81   TXT CUR ON
      Action: Allows the text cursor to  be  displayed - intended for
              use by the operating system
      Entry:  No entry conditions
      Exit:   All registers and flags are preserved

044   &BB84   TXT CUR OFF
      Action: Prevents the text cursor from being displayed -intended
              for use by the operating system
      Entry:  No entry conditions
      Exit:   All registers and flags are preserved

045   &BB87   TXT VALIDATE
      Action: Checks whether a cursor position  is within the current
              window
      Entry:  H contains the logical  column  number  to check, and L
              holds the logical line number
      Exit:   H holds  the  logical  column  number  where  the  next
              character will be  printed,  L  holds  the logical line
              number; if printing  at  this  position  would make the
              window scroll up, then Carry is  false and B holds &FF;
              if printing at  this  position  would  make  the window
              scroll down, then Carry is false and B contains &00; if
              printing at the  specified  cursor  position  would not
              scroll the window, then Carry is true and B is corrupt;
              always, A and  the  other  flags  are  corrupt, and all
              others are preserved

046   &BB8A   TXT PLACE CURSOR
      Action: Puts a 'cursor  blob'  on  the  screen  at  the current
              cursor position
      Entry:  No entry conditions
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  It is possible to have more than one cursor in a window
              (see also TXT DRAW  CURSOR);  do  not use this  routine
              twice without using TXT REMOVE CURSOR between

047   &BB8D   TXT REMOVE CURSOR
      Action: Removes  a  'cursor  blob'   from  the  current  cursor
              position
      Entry:  No entry conditions
      Exit:   AF is corrupt, and all the others are preserved
      Notes:  This should be used only  to  remove cursors created by
              TXT PLACE CURSOR, but see also TXT UNDRAW CURSOR

048   &BB90   TXT SET PEN
      Action: Sets the foreground PEN for the current stream
      Entry:  A contams the PEN number to use
      Exit:   AF and HL  are  corrupt,  and  all  other registers are
              preserved

049   &BB93   TXT GET PEN
      Action: Gets the foreground PEN for the current stream
      Entry:  No entry conditions
      Exit:   A contains the PEN number,  the  flags are corrupt, and
              all other registers are preserved

050   &BB96   TXT SET PAPER
      Action: Sets the background PAPER for the current stream
      Entry:  A contains the PEN number to use
      Exit:   AF and HL  are  corrupt,  and  all  other registers are
              preserved

051   &BB99   TXT GET PAPER
      Action: Gets the background PAPER for the current stream
      Entry:  No entry conditions
      Exit:   A contains the PEN number,  the  flags are corrupt, and
              all other registers are preserved

052   &BB9C   TXT INVERSE
      Action: Swaps the current PEN  and  PAPER  colours over for the
              current stream
      Entry:  No entry conditions
      Exit:   AF and HL are corrupt, and all others are preserved

053   &BB9F   TXT SET BACK
      Action: Sets the  character  write  mode  to  either  opaque or
              transparent
      Entry:  For transparent mode, A  must  be  non-zero; for opaque
              mode, A has to hold zero
      Exit:   AF and HL  are  corrupt,  and  all  other registers are
              preserved
      Notes:  Setting the character write mode  has no effects on the
              graphics VDU

054   &BBA2   TXT GET BACK
      Action: Gets the character write mode for the current stream
      Entry:  No entry conditions
      Exit:   If in transparent mode, A  is non-zero; in opaque mode,
              A is zero; in either case DE, HL and flags are corrupt,
              and the other registers are preserved

055   &BBA5   TXT GET MATRIX
      Action: Gets the address of a character matrix
      Entry:  A contains the character whose matrix is to be found
      Exit:   If it is a user-defined matrix,  then Carry is true; if
              it is in the lower ROM  then  Carry is false; in either
              event, HL contains the  address  of  the  matrix, A and
              other flags are corrupt, and others are preserved
      Notes:  The character matrix is  stored  in  8 bytes; the first
              byte is for the top row  of the character, and the last
              byte refers to the bottom  row  of the character; bit 7
              of a byte refers to the  leftmost  pixel of a line, and
              bit 0 refers to the rightmost pixel in Mode 2.

056   &BBA8   TXT SET MATRIX
      Action: Installs a matrix for a user-defined character
      Entry:  A contains the character which  is being defined and HL
              contains the address of the matrix to be used
      Exit:   If the character is user-definable  then Carry is true;
              otherwise Carry is false,  and  no  action is taken; in
              both cases AF, BC, DE and HL are corrupt, and all other
              registers are preserved

057   &BBAB   TXT SET M TABLE
      Action: Sets the address of a user-defined matrix table
      Entry:  DE is the first character  in  the  table and HL is the
              table's address (in the central 32K of RAM)
      Exit:   If there are no  existing  tables  then Carry is false,
              and A and HL are both corrupt; otherwise Carry is true,
              A is the first character and HL is the table's address;
              in both cases BC, DE and the other flags are corrupt

058   &BBAE   TXT GET M TABLE
      Action: Gets the address of a user-defined matrix table
      Entry:  No entry conditions
      Exit:   See TXT SET M  TABLE  above  for  details of the values
              that can be returned

059   &BBB1   TXT GET CONTROLS
      Action: Gets the address of the control code table
      Entry:  No entry conditions
      Exit:   HL contains the address  of  the  table, and all others
              are preserved
      Notes:  The table has  32  entries,  and  each  entry has three
              bytes: byte 1 is the number of parameters needed by the
              control code, bytes 2  and  3  are  the  address of the
              routine, in the Lower ROM, to execute the control code

060   &BBB4   TXT STR SELECT
      Action: Selects a new VDU text stream
      Entry:  A contains the value of the stream to change to
      Exit:   A contains the previously  selected  stream, HL and the
              flags are corrupt, and all others are preserved

061   &BBB7   TXT SWAP STREAMS
      Action: Swaps the states of two stream attribute tables
      Entry:  B contains a stream  number,  and  C contains the other
              stream number
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  The foreground pen  and  paper,  the  window  size, the
              cursor position, the character  write  mode and graphic
              character  mode  are  all  exchanged  between  the  two
              streams

The Graphics VDU

062   &BBBA   GRA INITIALISE
      Action: Initialises the graphics VDU to  its default set-up (ie
              its set-up when the computer is switched on)
      Entry:  No entry conditions
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  Sets the graphics indirections  to their defaults, sets
              the graphic paper to text pen  0 and the graphic pen to
              text pen 1,  reset  the  graphics  origin  and move the
              graphics cursor to the bottom left of the screen, reset
              the graphics window and write mode to their defaults

063   &BBBD   GRA RESET
      Action: Resets the graphics VDU
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Notes:  Resets the graphics indirections and the graphics write
              mode to their defaults

064   &BBC0   GRA MOVE ABSOLUTE
      Action: Moves  the  graphics  cursor   to  an  absolute  screen
              position
      Entry:  DE contains the user X-coordinate and HL holds the user
              Y-coordinate
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved

065   &BBC3   GRA MOVE RELATIVE
      Action: Moves the graphics cursor  to  a  point relative to its
              present screen position
      Entry:  DE contains the X-distance to move  and HL holds the Y-
              distance
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved

066   &BBC6   GRA ASK CURSOR
      Action: Gets the graphics cursor's current position
      Entry:  No entry conditions
      Exit:   DE holds the user X-coordirlate,  HL  holds the user Y-
              coordinate, AF is corrupt, and all others nre preserved

067   &BBC9   GRA SET ORIGIN
      Action: Sets the graphics user origin's screen position
      Entry:  DE contains the standard X-coordinate  and HL holds the
              standard Y-coordinate
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved

068   &BBCC   GRA GET ORIGIN
      Action: Gets the graphics user origin's screen position
      Entry:  No entry conditions
      Exit:   DE contains the standard X-coordinate  and HL holds the
              standard Y-coordinate, and all others are preserved

069   &BBCF   GRA WIN WIDTH
      Action: Sets the left and right edges of the graphics window
      Ently:  DE contains the standard  X-coordinate  of one edge and
              HL holds the standard X-coordinate of the other side
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all  the other
              registers are preserved
      Notes:  The default window  covers  the  entire  screen  and is
              restored to its default when  the mode is changed; used
              in conjunction with GRA WIN HEIGHT

070   &BBD2   GRA WIN HEIGHT
      Action: Sets the top and bottom edges of the graphics window
      Entry:  DE contains the standard  Y-coordinate  of one side and
              HL holds the standard Y-coordinate of the other side
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Notes:  See GRA WIN WIDTH for further details

071   &BBD5   GRA GET W WIDTH
      Action: Gets the left and right edges of the graphics window
      Entry:  No entry conditions
      Exit:   DE contains the standard X-coordinate  of the left edge
              and HL contains the standard  Y-coordinate of the right
              edge, AF  is  corrupt,  and  all  other  registers  are
              preserved

072   &BBD8   GRA GET W HEIGHT
      Action: Gets the top and bottom edges of the graphics window
      Entry:  No entry conditions
      Exit:   DE contains the standard  Y-coordinate  of the top edge
              and HL contains the standard Y-coordinate of the bottom
              edge, AF  is  corrupt,  and  all  other  registers  are
              preserved

073   &BBDB   GRA CLEAR WINDOW
      Action: Clears the graphics window to the graphics paper colour
              and moves the cursor back to the user origin
      Entry:  No entry conditions
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved

074   &BBDE   GRA SET PEN
      Action: Sets the graphics PEN
      Entry:  A contains the required text PEN number
      Exit:   AF is corrupt, and all other registers are preserved

075   &BBE1   GRA GET PEN
      Action: Gets the graphics PEN
      Entry:  No entry conditions
      Exit:   A contains the text PEN  number, the flags are corrupt,
              and all other registers are preserved

076   &BBE4   GRA SET PAPER
      Action: Sets the graphics PAPER
      Entry:  A contains the required text PEN number
      Exit:   AF corrupt, and all others are preserved

077   &BBE7   GRA GET PAPER
      Action: Gets the graphics PAPER
      Entry:  No entry conditions
      Exit:   A contains the text PEN  number, the flags are corrupt,
              and all others are preserved

078   &BBEA   GRA PLOT ABSOLUTE
      Action: Plots a point at an absolute user coordinate, using the
              GRA PLOT indirection

      Entry:  DE contains the user X-coordinate and HL holds the user
              Y-coordinate
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved

079   &BBED   GRA PLOT RELATIVE
      Action: Plots a point at  a  position  relative  to the current
              graphics cursor, using the GRA PLOT indirection
      Entry:  DE contains the relative  X-coordinate  and HL contains
              the relative Y-coordinate
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved

080   &BBF0   GRA TEST ABSOLUTE
      Action: Moves to an  absolute  position,  and  tests  the point
              there using the GRA TEST indirection
      Entry:  DE contains the user X-coordinate and HL holds the user
              Y-coordinate for the point you wish to test
      Exit:   A contains the pen at  the  point,  and  BC, DE, HL and
              flags are corrupt, and all others are preserved

081   &BBF3   GRA TEST RELATIVE
      Action: Moves to a position  relative  to the current position,
              and  tests  the  point   there   using   the  GRA  TEST
              indirection
      Entry:  DE contains the relative  X-coordinate  and HL contains
              the relative Y-coordinate
      Exit:   A contains the pen at  the  point,  and  BC, DE, HL and
              flags are corrupt, and all others are preserved

082   &BBF6   GRA LlNE ABSOLUTE
      Action: Draws a line from the  current  graphics position to an
              absolute position, using GRA LINE
      Entry:  DE contains the user X-coordinate and HL holds the user
              Y-coordinate of the end point
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Notes:  The line will be  plotted  in  the current graphics pen
              colour (may be masked  to  produce  a  dotted line on a
              6128)

083   &BBF9   GRA LINE RELATIVE
      Action: Draws a line from  the  current  graphics position to a
              relative screen position, using GRA LINE
      Entry:  DE contains the relative  X-coordinate  and HL contains
              the relative Y-coordinate
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  See GRA LINE ABSOLUTE above for details of how the line
              is plotted

084   &BBFC   GRA WR CHAR
      Action: Writes a  character  onto  the  screen  at  the current
              graphics position
      Entry:  A contains the character to be put onto the screen
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all  the other
              registers are preserved
      Notes:  As in BASIC, all characters including control codes are
              printed; the character  is  printed  with  its top left
              comer at the  current  graphics  position; the graphics
              position is moved one character  width  to the right so
              that it is ready for another character to be printed

The Screen Pack

085   &BBFF   SCR INITIALISE
      Action: Initialises the Screen Pack to  the default values used
              when the computer is first switched on
      Entry:  No entry conditions

      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Notes:  All screen indirections are  restored  to their default
              settings, as are inks and  flashing speeds; the mode is
              switched to MODE 1 and  the  screen is cleared with PEN
              0; the screen address is moved  to &C000 and the screen
              offset is set to zero

086   &BC02   SCR RESET
      Action: Resets the Screen Pack's  indirections, flashing speeds
              and inks to their default values
      Entry:  No entry conditions
      Exit:   AF, BC, DE r1nd HL are corrupt, and all other registers
              are preserved

087   &BC05   SCR SET OFFSET
      Action: Sets the screen offset to  the  specified values - this
              can cause the screen to scroll
      Entry:  HL contains the required offset, which should be even
      Exit:   AF and HL are corrupt, and alI others are preserved
      Notes:  The screen offset is reset  to  0  whenever its mode is
              set, or it is  cleared  by  SCR  CLEAR (but not BASIC's
              CLS)

088   &BC08   SCR SET BASE
      Action: Sets the location in memory of the screen - effectively
              can only be &C000 or &4000
      Entry:  A contains the  most  significant  byte  of  the screen
              address required
      Exit:   AF and HL  are  corrupt,  and  all  other registers are
              preserved
      Notes:  The screen memory can only be  set at 16K intervals (ie
              &0000, &4000, &8000, &C000)  and  when  the computer is
              first switched on the 16K  of  screen memory is located
              at &C000)

089   &BC0B   SCR GET LOCATION
      Action: Gets the location of  the  screen  memory  and also the
              screen offset
      Entry:  No entry conditions
      Exit:   A  holds  the  most  significant  byte  of  the  screen
              address, HL holds the  current  offset,  and all others
              are preserved

090   &BC0E   SCR SET MODE
      Action: Sets the screen mode
      Entry:  A contains the mode number -  it has the same value and
              characteristics as in BASIC
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Notes:  The windows are set to  cover  the whole screen and the
              graphics origin is set to the bottom left corner of the
              screen; in addition, the current stream is set to zero,
              and the screen offset is zeroed

091   &BC11   SCR GET MODE
      Action: Gets the current screen mode
      Ently:  No entry conditions
      Exit:   If the mode is 0,  then  Carry  is true, Zero is false,
              and A contains 0;  if  the  mode  is  1,  then Carry is
              false, Zero is true, and A  contains  1; if the mode is
              2, then Carry is false,  Zero  is false, and A contains
              2; in all cases the other flags are corrupt and all the
              other registers are preserved

092   &BC14   SCR CLEAR
      Action: Clears the whole of the screen
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved

093   &BC17   SCR CHAR LIMITS
      Action: Gets the size  of  the  whole  screen  in  terms of the
              numbers of characters that can be displayed
      Entry:  No entry conditions
      Exit:   B contains the number of  characters across the screen,
              C contains the number of characters down the screen, AF
              is corrupt, and all other registers are preserved

094   &BC1A   SCR CHAR POSITION
      Action: Gets the memory address  of  the  top  left corner of a
              specified character position
      Entry:  H contains the character physical column and L contains
              the character physical row
      Exit:   HL contains the memory address of the top left comer of
              the  character,  B  holds  the  width  in  bytes  of  a
              character in the present mode,  AF  is corrupt, and all
              other registers are preserved

095   &BC1D   SCR DOT POSITION
      Action: Gets the memory  address  of  a  pixel  at  a specified
              screen position
      Entry:  DE contains the base X-coordinate  of the pixel, and HL
              contains the base Y-coordinate
      Exit:   HL contains the memory address of the pixel, C contains
              the bit mask for this  pixel,  B contains the number of
              pixels stored in a byte minus 1, AF and DE are corrupt,
              and all others are preserved

096   &BC20   SCR NEXT BYTE
      Action: Calculates the screen address of  the byte to the right
              of the specified screen  address  (may  be  on the next
              line)
      Entry:  HL contains the screen address
      Exit:   HL holds the screen address of the byte to the right of
              the original screen address, AF  is corrupt, all others
              are preserved

097   &BC23   SCR PREV BYTE
      Action: Calculates the screen address of  the  byte to the left
              of the  specified  screen  address  (this  address  may
              actually be on the previous line)
      Entry:  HL contains the screen address
      Exit:   HL holds the screen address of  the byte to the left of
              the original address,  AF  is  corrupt,  all others are
              preserved

098   &BC26   SCR NEXT LINE
      Action: Calculates the screen  address  of  the  byte below the
              specified screen address Ently:  HL contains the screen
              address
      Exit:   HL contains the screen  address  of  the byte below the
              original screen address,  AF  is  corrupt,  and all the
              other registers are preserved

099   &BC29   SCR PREV LINE
      Action: Calculates the screen  address  of  the  byte above the
              specified screen address
      Entry:  HL contains the screen address
      Exit:   HL holds the  screen  address  of  the  byte  above the
              original address, AF  is  corrupt,  and  all others are
              preserved

100   &BC2C   SCR INK ENCODE
      Action: Converts a PEN to provide a mask which, if applied to a
              screen byte, will convert all of the pixels in the byte
              to the appropriate PEN
      Entry:  A contains a PEN number
      Exit:   A contains the encoded value of  the PEN, the flags are
              corrupt, and all other registers are preserved
      Notes:  The mask returned is  different  in  each of the screen
              modes

101   &BC2F   SCR INK DECODE
      Action: Converts a PEN mask into  the  PEN  number (see SCR INK
              ENCODE for the re~ erse process)
      Entry:  A contains the encoded value of the PEN
      Exit:   A contains the PEN number,  the  flags are corrupt, and
              all others are preserved

102   &BC32   SCR SET INK
      Action: Sets the colours of a PEN  - if the two values supplied
              are different then the colours will alternate (flash)
      Entry:  contains the PEN number,  B  contains the first colour,
              and C holds the second colour
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved

103   &BC35   SCR GET INK
      Action: Gets the colours of a PEN
      Entry:  A contains the PEN nurnber
      Exit:   B contains the first colour, C holds the second colour,
              and AF, DE  and  HL  are  corrupt,  and  all others are
              preserved

104   &BC38   SCR SET BORDER
      Action: Sets the colours of the border - again if two different
              values are supplied, the border will flash
      Entry:  B contains the first colour,  and C contains the second
              colour
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved

105   &BC3B   SCR GET BORDER
      Action: Gets the colours of the border
      Entry:  No entry conditions
      Exit:   B contains the first colour, C holds the second colour,
              and AF, DE  and  HL  are  corrupt,  and  all others are
              preserved

106   &BC3E   SCR SET FLASHING
      Action: Sets the  speed  with  which  the  border's  and  PENs'
              colours flash
      Entry:  H holds the time that the  first colour is displayed, L
              holds the time the second colour is displayed for
      Exit:   AF and HL  are  corrupt,  and  all  other registers are
              preserved
      Notes:  The length  of  time  that  each  colour  is  shown  is
              measured in 1/5Oths of a  second,  and  a value of 0 is
              taken to mean 256 * 1/50 seconds - the default value is
              10 * 1/50 seconds

107   &BC41   SCR GET FLASHING
      Action: Gets the periods with which  the  colours of the border
              and PENs flash
      Entry:  No entry conditions
      Exit:   H holds the duration of  the  first colour, L holds the
              duration of the second colour,  AF  is corrupt, and all
              other registers are preserved  -  see  SCR SET FLASHING
              for the units of time used

108   &BC44   SCR FILL BOX
      Action: Fills an area of the  screen  with  an  ink - this only
              works for 'character-sized' blocks of screen
      Entry:  A contains the mask for the  ink  that is to be used, H
              contains the left hand colurnn  of  the area to fill, D
              contains the right hand column,  L  holds the top line,
              and E holds the bottom line of the area (using physical
              coordinates)

      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved

109   &BC17   SCR FLOOD BOX
      Action: Fills an area of the  screen  with  an  ink - this only
              works for 'byte-sized' blocks of screen
      Entry:  C contains the  encoded  PEN  that  is  to  be used, HL
              contains the screen address of the top left hand corner
              of the area to fill, D  contains  the width of the area
              to be filled in bytes, and E contains the height of the
              area to be filled in screen lines
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  The whole of the  area  to  be  filled  must lie on the
              screen otherwise unpredictable results may occur

110   &BC4A   SCR CHAR INVERT
      Action: Inverts a character's colours; all  pixels in one PEN's
              colour are printed in  another  PEN's  colour, and vice
              versa
      Entry:  B contains  one  encoded  PEN,  C  contains  the  other
              encoded PEN, H contains the physical column number, and
              L contains the physical  line  number  of the character
              that is to be inverted
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  alI  the other
              registers are preserved

111   &BC4D   SCR HW ROLL
      Action: Scrolls the entire screen  up  or  down  by eight pixel
              rows (ie one character line)
      Entry:  B holds the  direction  that  the  screen  will roll, A
              holds the encoded PAPER which  the new line will appear
              in
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Notes:  This alters the screen  offset;  to  roll  down, B must
              hold zero, and to roll upwards B must be non-zero

112   &BCS0   SCR SW ROLL
      Action: Scrolls part of the screen  up  or  down by eight pixel
              lines - only for 'character-sized' blocks of the screen
      Entry:  B holds the direction to  roll  the screen, A holds the
              encoded PAPER which  the  new  line  will  appear in, H
              holds the left column of  the  area  to scroll, D holds
              the right colurnn, L holds  the  top  line, E holds the
              bottom line
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  The area of the screen is  moved by copying it; to roll
              down, B must hold zero, and  to  roll upwards B must be
              non-zero; this routine uses physical roordinates

113   &BC53   SCR UNPACK
      Action: Changes a character matrix from its eight byte standard
              form into a set of  pixel  masks which are suitable for
              the current mode - four *8  bytes are needed in mode 0,
              two *8 bytes in mode l, and 8 bytes in mode 2
      Entry:  HL contains the address of  the matrix, and DE contains
              the address where the masks are to be stored
      Exit:   AF. BC, DE and HL are  corrupt, and all other registers
              are preserved

114   &BC56   SCR REPACK
      Action: Changes a set of  pixel  masks  (for  the current mode)
              into a standard eight byte character matrix
      Entry:  A contains the  encoded  foreground  PEN  to be matched
              against (ie the PEN that is to be regarded as being set
              in the character), H holds  the  physical column of the
              character to be `repacked',  L  holds the physical line

              of the character, and  DE  contains  the address of the
              area where the character matrix will be built
      Exit:   AF, BC, DE amd HL are  corrupt,  and all the others are
              preserved

115   &BC59   SCR ACCESS
      Action: Sets the screen write mode for graphics
      Entry:  A contains the write mode (0=Fill, 1=XOR, 2=AND, 3=OR)
      Exit:   AF. BC, DE and HL are  corrupt, amd all other registers
              are preserved
      Notes:  The fill mode  means  that  the  ink  that plotting was
              requested in is the ink that  appears on the screen; in
              XOR mode, the specified ink  is  XORed with ink that is
              at that point on the  screen already before plotting; a
              simiIar situation occurs with the AND and OR modes

116   &BC5C   SCR PIXELS
      Action: Puts a pixel or pixels on  the screen regardless of the
              write mode specified by SCR ACCESS above
      Entry:  B contains the mask  of  the  PEN  to  be drawn with, C
              contains the  pixel  mask,  and  HL  holds  the  screen
              address of the pixel
      Exit:   AF is corrupt, amd all others are preserved

117   &BC5F   SCR HORIZONTAL
      Action: Draws a honzontal line on  the screen using the current
              graphics write mode
      Entry:  A contains  the  encoded  PEN  to  be  drawn  with,  DE
              contains the base  X-coordinate  of  the  start  of the
              line, BC contains  the  end  base  X-coordinate, and HL
              contains the base Y-coordinate
      Exit:   AF, BC, DE and HL  are  conupt, and all other registers
              are preserved
      Notes:  The start X-coordinate must  be  less  than  the end X-
              coordmate

118   &BC62   SCR VERTICAL
      Action: Draws a vertical line on  the  screen using the current
              graphics write mode
      Entry:  A contains  the  encoded  PEN  to  be  drawn  with,  DE
              contains the base X-coordinate  of  the  line, HL holds
              the start base Y-coordinate,  and  BC  contains the end
              base Y-coordinate - the  start  coordinate must be less
              than the end coordinate
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all  the other
              registers are preserved

The Cassette/AMSDOS Manager

NOTE: Some of  these  routines  are  only  applicable  to the cassette
manager; where a disc version  exists  it  is indicated by an asterisk
(*) next to  the  command  name.   These  disc  version jumpblocks are
automatically installed by the Operating System on switch on.

119   &BC65   CAS INITIALISE
      Action: Initialises the cassette manager
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all  the other
              registers are preserved
      Notes:  Both read and write  streams  are closed; tape messages
              are switched on; the default speed is reselected

120   &BC68   CAS SET SPEED
      Action: Sets the speed  at  which  the  cassette  manager saves
              programs
      Entry:  HL holds  the  length  of  'half  a  zero'  bit,  and A
              contains the amount of precompensation
      Exit:   AF and HL are corrupt
      Notes:  The value in HL is the length  of time that half a zero
              bit is written as; a one  bit  is twice the length of a
              zero bit; the default values (ie SPEED WRITE 0) are 333
              microseconds (HL) and  25  microseconds  (A)  for SPEED
              WRITE 1, the values are  given  as 107 microseconds and
              50 microseconds respectiveIy

121   &BC6B   CAS NOISY
      Action: Enables or disables  the  display  of cassette handling
              messages
      Entry:  To enable the messages then A  must be 0, otherwise the
              messages are disabled
      Exit:   AF is corrupt, and all other registers are preserved

122   &BC6E   CAS START MOTOR
      Action: Switches on the tape motor
      Entry:  No entry conditions
      Exit:   If the motor operates properly  then  Carry is true; if
              ESC was pressed then Carry is  false; in either case, A
              contains the  motor's  previous  state,  tbe  flags are
              corrupt, and all others are preserved

123   &BC71   CAS STOP MOTOR
      Action: Switches off the tape motor
      Entry:  No entry conditions
      Exit:   If the motor turns off then  Carry  is true; if ESC was
              pressed then Carry is false; in both cases, A holds tbe
              motor's previous state,  the  other  flags are corrupt,
              all others are preserved

124   &BC74   CAS RESTORE MOTOR
      Action: Resets the tape motor to its previous state
      Entry:  A contains the previous state of the motor (eg from CAS
              START MOTOR or CAS STOP MOTOR)
      Exit:   If the motor operates properly  then  Carry is true; if
              ESC was pressed then Carry  is  false;  in all cases, A
              and the other  flags  are  corrupt  and  all others are
              preserved

125   &BC77   *CAS IN OPEN
      Action: Opens an input buffer and reads  the first block of the
              file
      Entry:  B contains the length of  the filename, HL contains the
              filename's address, and DE contains  the address of the
              2K buffer to use for reading the file
      Exit:   If the file  was  opened  successfully,  then  Carry is
              true, Zero is false, HL  holds  the address of a buffer
              contauling the file header  data,  DE holds the address
              of the destination  for  the  file,  BC  holds the file
              length, and A holds the  file  type; if the read stream
              is already  open  then  Carry  and  Zero  are  false, A
              contains an error nurnber  (664/6128  only)  and BC, DE
              and HL are corrupt;  if  ESC  was  pressed by the user,
              then Carry is false,  Zero  is  true,  A holds an error
              number (664/6128 only) and BC,  DE  and HL are corrupt;
              in all cases, IX and  the  other flags are corrupt, and
              the others are preserved
      Notes:A filename of zero length  means  'read  the neXt file on
              the tape'; the stream remains  open  until it is closed
              by either CAS IN CLOSE or CAS IN ABANDON
      Disc:   Similar to tape except that  if  there  is no header on
              the file, then a fake header is put into memory by this
              routine

126   &BC7A   *CAS IN CLOSE
      Action: Closes an input file
      Entry:  No entry conditions
      Exit:   If the file was closed successfully, then Carry is true
              and A is corrupt; if the read stream was not open, then
              Carry is false, and  A  holds  an  error code (664/6128
              only); in both cases, BC,  DE,  HL  and the other flags
              are all corrupt
      Disc:   All the above applies, but  also  if the file failed to
              close for any other reason,  then  Carry is false, Zero
              is true and A contains  an  error  number; in all cases
              the drive motor is turned off immediately

127   &BC7D   *CAS IN ABANDON
      Action: Abandons an input file
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Disc:   All the above applies for the disc routine

128   &BC80   *CAS IN CHAR
      Action: Reads in a single byte from a file
      Entry:  No entry conditions
      Exit:   If a byte was read, then  Carry is true, Zero is false,
              and A contains the byte read  from the file; if the end
              of file was reached, then  Carry  and Zero are false, A
              contains an error number (664/6128  only) or is corrupt
              (for the 464); if ESC was pressed, then Carry is false,
              Zero is true, and  A  holds  an  error number (664/6128
              only) or is corrupt (for the 464); in all cases, IX and
              the  other  flags  are  corrupt,  and  all  others  are
              preserved
      Disc:   All the above applies for the disc routine

129   &BC83   *CAS IN DIRECT
      Action: Reads an entire file directly into memory
      Entry:  HL contains the address where the file is to be  placed
              in RAM
      Exit:   If the operation was  successful,  then  Carry is true,
              Zero is false, HL contains  the  entry address and A is
              corrupt; if it was not  open,  then  Carry and Zero are
              both false, HL is corrupt,  and  A  holds an error code
              (664/6128) or is  corrupt  (464);  if  ESC was pressed,
              Carry is false, Zero  is  true,  HL  is  corrupt, and A
              holds an error code (664/6128  only); in all cases, BC,
              DE and IX and  the  other  flags  are  corrupt, and the
              others are preserved
      Notes:  This routine cannot be used  once  CAS IN CHAR has been
              used
      Disc:   All the above applies to the disc routine

130   &BC86   *CAS RETURN
      Action: Puts the last byte read  back  into the input buffer so
              that it can be read again at a later time
      Entry:  No entry conditions
      Exit:   All registers are preserved
      Notes:  The routine can only return  the  last byte read and at
              least one byte must have been read
      Disc:   All the above applies to the disc routine

131   &BC89   *CAS TEST EOF
      Action: Tests whether the end of file has been encountered
      Entry:  No entry conditions
      Exit:   If the end of  file  has  been  reached, then Carry and
              Zero are false, and A  is  corrupt;  if the end of file
              has not been encountered, then  Carry  is true, Zero is
              false, and A is corrupt; if  ESC was pressed then Carry
              is false, Zero is true  and  A contains an error number
              (664/6128 only); in all cases,  IX  and the other flags
              are corrupt, and all others are preserved
      Disc:   All the above applies to the disc routine

132   &BC8C   *CAS OUT OPEN
      Action: Opens an output file
      Entry:  B contains the length of  the filename, HL contains the
              address of the filename,  and  DE  holds the address of
              the 2K buffer to be used

      Exit:   If the file was opened  correctly,  then Carry is true,
              Zero is false,  HL  holds  the  address  of  the buffer
              containing the file header data that will be written to
              each block, and A is  corrupt;  if  the write stream is
              already open, then Carry and Zero are false, A holds an
              error nurnber (66~/6128) and HL  is corrupt; if ESC was
              pressed then Carry is false,  Zero  is true, A holds an
              error number  (664/6128)  and  HL  is  corrupt;  in all
              cases, BC, DE, IX and the  other flags are corrupt, and
              the others are preserved
      Notes:  The buffer is used  to  store  the  contents  of a file
              block before it is actually written to tape
      Disc:   The same as for tape  except  that the filename must be
              present in its usual AMSDOS format

133   &BC8F   *CAS OUT CLOSE
      Action: Closes an output file
      Entry:  No entry conditions
      Exit:   If the file  was  closed  successfully,  then  Carry is
              true, Zero is false,  and  A  is  corrupt; if the write
              stream was not open, then Carry  and Zero are false and
              A holds an  error  code  (664/6128  only);  if  ESC was
              pressed then  Carry  is  false,  Zero  is  true,  and A
              contains an error code  (664/6128  only); in all cases,
              BC, DE, HL, IX and the other flags are all corrupt
      Notes:  The last block of  a  file  is  written  only when this
              routine is  called;  if  writing  the  file  is  to  be
              abandoned, then CAS OUT ABANDON should be used instead
      Disc:   All the above applies to the disc routine

134   &BC92   *CAS OUT ABANDON
      Action: Abandons an output file
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Notes:  When using this routine, the  current last block of the
              file is not written to the tape
      Disc:   Similar to the tape routine; if more than 16K of a file
              has been written to the disc, then the first 16K of the
              file will exist on the  disc  with  a file extension of
              .$$$ because each 16K  section  of  the file requires a
              separate directory entry

135   &BC95   *CAS OUT CHAR
      Action: Writes a single byte to a file
      Entry:  A contains the byte to  be  written  to the file output
              buffer
      Exit:   If a byte was  written  to  the  buffer,  then Carry is
              true, Zero is false, and A  is corrupt; if the file was
              not open, then Carry and Zero are false, and A contains
              an error number (664/6128 only)  or  is corrupt (on the
              464); if ESC was pressed, then  Carry is false, Zero is
              true, and A contains an error number (664/6128 only) or
              it is corrupt (on the  464);  in  all cases, IX and the
              other flags are corrupt, and all others are preserved
      Notes:  If the 2K buffer is full of  data then it is written to
              the tape before  the  new  character  is  placed in the
              buffer; it is important to call  CAS OUT CLOSE when all
              the data has been sent  to  the  file  so that the last
              block is written to the tape
      Disc:   All the above applies to the disc routine

136   &BC98   *CAS OUT DIRECT
      Action: Writes an entire file directly to tape
      Entry:  HL contains the address  of  the  data  which  is to be
              written to tape, DE contains  the  length of this data,
              BC contains the e~ecution  address,  and A contains the
              file type
      Exit:   If the operation was  successful,  then  Carry is true,
              Zero is false, and A  is  corrupt;  if the file was not
              open, Carry and Zero are false, A holds an error number
              (664/6128) or is  corrupt  (464);  if  ESC was pressed,
              then Carry is false, Zero is true, and A holds an error
              code (664/6128 only); in all  cases  BC, DE, HL, IX and
              the  other  flags  are  corrupt,  and  the  others  are
              preserved
      Notes:  This routine cannot be used once  CAS OUT CHAR has been
              used
      Disc:   All the above applies to the disc routine

137   &BC9B   *CAS CATALOG
      Action: Creates a catalogue of all the files on the tape
      Entry:  DE contains the address of the  2K buffer to be used to
              store the information
      Exit:   If the operation was  successful,  then  Carry is true,
              Zero is false, and A is  corrupt; if the read stream is
              already being used, then Carry  and Zero are false, and
              A holds an error code (664/6128  or is corrupt (for the
              464); in all cases, BC, DE,  HL, IX and the other flags
              are corrupt and all others are preserved
      Notes:  This routine is only left  when  the ESC key is pressed
              (cassette only) and is identical to BASIC's CAT command
      Disc:   All tbe above applies,  except  that  a  sorted list of
              files is displayed; system files are not listed by this
              routine

138   &BC9E   CAS WRITE
      Action: Writes data to the tape in one  long file (ie not in 2K
              blocks)
      Entry:  HL contains the address of  the  data  to be written to
              tape, DE contains the length of the data to be written,
              and A contains the sync character
      Exit:   If the operation was successful, then Carry is true and
              A is corrupt; if an error  occurred then Carry is false
              and A contains an error code; in both cases, BC, DE, HL
              and  lX  are  corrupt,  and  all  other  registers  are
              preserved
      Notes:  For header records the sync  character  is &2C, and for
              data it is  &16;  this  routine  starts  and  stops the
              cassette motor  and  also  tums  off  interrupts whilst
              writing data

139   &BCA1   CAS READ
      Action: Reads data from  the  tape  in  one  long  file  (ie as
              originally written by CAS WRITE only)
      Entry:  HL holds the address to  place  the  file, DE holds the
              length of the  data,  and  A  holds  the  expected sync
              character
      Exit:   If the operation was successful, then Carry is true and
              A is corrupt; if an error  occurred then Carry is false
              and A contains an error code; in both cases, BC, DE, HL
              and  IX  are  corrupt,  and  all  other  registers  are
              preserved
      Notes:  For header records the sync  character  is &2C, and for
              data it is  &16;  this  routine  starts  and  stops the
              cassette motor and turns  off interrupts whilst reading
              data

140   &BCA4   CAS CHECK
      Action: Compares the contents of memory  with a file record (ie
              header or data) on tape
      Entry:  HL contains  the  address  of  the  data  to  check, DE
              contains the length of the  data  and  A holds the sync
              character that was used  when  the  file was originally
              written to the tape
      Exit:   If the two are identical, then  Carry  is true and A is
              corrupt; if an error occurred then Carry is false and A
              holds an error code; in all  cases,  BC, DE, HL, IX and
              other flags are corrupt,  and  all  other registers are
              preserved
      Notes:  For header records the sync  character  is &2C, and for
              data it is  &16;  this  routine  starts  and  stops the
              cassette motor and turns  off interrupts whilst reading
              data; does not have to read  the whole of a record, but
              must start at the beginning

The Sound Manager

141   &BCA7   SOUND RESET
      Action: Resets the sound manager  by  clearing the sound queues
              and abandoning any current sounds
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved

142   &BCAA   SOUND QUEUE
      Action: Adds a sound to the sound queue of a channel
      Entry:  HL contains the  address  of  a  series  of bytes which
              define the sound and are  stored  in the central 32K of
              RAM
      Exit:   If the sound was successfully  added to the queue, then
              Carry is true and HL  is  corrupt;  if one of the sound
              queues  was  full,  then  Carry  is  false  and  HL  is
              preserved; in either case, A, BC,  DE, IX and the other
              flags are corrupt, and all others are preserved
      Notes:  The bytes required to define  the sound are as follows:
              byte 0 - channel status byte
              byte 1 - volume envelope to use
              byte 2 - tone envelope to use
              bytes 3&4 - tone period
              byte 5 - noise period
              byte 6 - start volume
              bytes 7&8 - duration of  the  sound, or envelope repeat
              count

143   &BCAD   SOUND CHECK
      Action: Gets the status of a sound channel
      Entry:  A contains the channel to test  -  for channel A, bit 0
              set; for channel B, bit 1 set; for channel C, bit 2 set
      Exit:   A contains the channel status, BC, DE, HL and flags are
              corrupt, and all others are preserved
      Notes:  The channel  status  returned  is  bit  significant, as
              follows:
              bits 0 to 2  - the  number  of free spaces in the sound
              queue
              bit 3 - trying to rendezvous with channel A
              bit 4 - trying to rendezvous with channel B
              bit 5 - trying to rendezvous with channel C
              bit 6 - holding the channel
              bit 7 - producing a sound

144   &BCB0   SOUND ARM EVENT
      Action: Sets up an event which  will  be activated when a space
              occurs in a sound queue
      Entry:  A contains the channel  to  set  the  event up for (see
              SOUND CHECK for the bit  values  this can take), and HL
              holds the address of the event block
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  The event block must  be  initialised  by KL INIT EVENT
              and is disarmed when the event itself is run

145   &BCB3   SOUND RELEASE
      Action: Allows the playing of sounds  on specific channels that
              had been stopped by SOUND HOLD
      Entry:  A contains the sound channels to be released (see SOUND
              CHECK for the bit values this can take)
      Exit:   AF, BC, DE, HL and IX  are  corrupt, and all others are
              preserved

146   &BCB6   SOUND HOLD
      Action: Immediately stops all sound output (on all channels)
      Entry:  No entry conditions
      Exit:   If a sound was being  made,  then  Carry is true; if no
              sound was being  made,  then  Carry  is  false;  in all
              cases, A, BC, HL and  other  flags are corrupt, and all
              others are preserved
      Notes:  When the sounds  are  restarted,  they  will begin from
              exactly the same place that they were stopped

147   &BCB9   SOUND CONTINUE
      Action: Restarts all sound output (on all channels)
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  IX  are  corrupt,  and  all others are
              preserved

148   &BCBC   SOUND AMPL ENVELOPE
      Action: Sets up avolume envelope
      Entry:  A holds an envelope number (from 1 to 15), HL holds the
              address of a block of data for the envelope
      Exit:   If it was set up properly,  Carry is true, HL holds the
              data block address + 16, A  and  BC are corrupt; if the
              envelope number is invalid, then Carry is false, and A,
              B and HL are  preserved;  in  either  case,  DE and the
              other flags are corrupt,  and  all  other registers are
              preserved
      Notes:  All the rules of  enevelopes  in  BASIC also apply; the
              block of  the  data  for  the  envelope  is  set  up as
              follows:
              byte 0 - number of sections in the envelope
              bytes 1 to 3 - first section of the envelope
              bytes 4 to 6 - second section of the envelope
              bytes 7 to 9 - third section of the envelope
              bytes 10 to 12 - fourth section of the envelope
              bytes 13 to 15 - fifth section of the envelope
              Each section of the envelope has three bytes set out as
              follows:
              byte 0 - step count (with bit 7 set)
              byte 1 - step size
              byte 2 - pause time
              or if it  is  a  hardware  envelope,  then each section
              takes the following form:
              byte 0 - envelope shape (with bit 7 not set)
              bytes 1 and 2 - envelope period
              See also SOUND TONE ENVELOPE below

149   &BCBF   SOUND TONE ENVELOPE
      Action: Sets up a tone envelope
      Entry:  A holds an envelope number (from 1 to 15), HL holds the
              address of a block of data for the envelope
      Exit:   If it was set up properly,  Carry is true, HL holds the
              data block address + 16, A and BC are corrupt; Ў if the
              envelope number is invalid, then Carry is false, and A,
              B and HL are  preserved;  in  either  case,  DE and the
              other flags are corrupt,  and  all  other registers are
              preserved
      Notes:  All the rules of  envelopes  in  BASIC  also apply; the
              block of  the  data  for  the  envelope  is  set  up as
              follows:
              byte 0 - number of sections in the envelope
              bytes 1 to 3 - first section of the envelope
              bytes 4 to 6 - second section of the envelope
              bytes 7 to 9 - third section of the envelope
              bytes 10 to 12 - fourth section of the envelope
              bytes 13 to 15 - fifth section of the envelope
              Each section of the envelope has three bytes set out as
              follows:
              byte 0 - step count
              byte 1 - step size
              byte 2 - pause time
              See also SOUND AMPL ENVELOPE above

150   &BCC2   SOUND A ADDRESS
      Action: Gets the address of  the  data  block associated with a
              volume envelope
      Entry:  A contains an envelope number (from 1 to 15)
      Exit:   If it was found, then Carry  is true, HL holds the data
              block's address,  and  BC  holds  its  length;  if  the
              envelope number is invalid, then  Carry is false, HL is
              corrupt and BC is preserved;  in  both cases, A and the
              other flags are corrupt, and all others are preserved

151   &BCC5   SOUND T ADDRESS
      Action: Gets the address of  the  data  block associated with a
              tone envelope
      Entry:  A contains an envelope number (from 1 to 15)
      Exit:   If it was found, then Carry  is true, HL holds the data
              block's address,  and  BC  holds  its  length;  if  the
              envelope number is invalid, then  Carry is false, HL is
              corrupt and BC is preserved;  in  both cases, A and the
              other flags are corrupt, and all others are preserved

The Kernel

152   &BCC8   KL CHOKE OFF
      Action: Clears all  event  queues  and  timer  lists,  with the
              exception of keyboard scanning and sound routines
      Entry:  No entry conditions
      Exit:   B contains the foreground ROM  select address (if any),
              DE contains the  ROM  entry  address,  C  holds the ROM
              select address for a RAM  foreground program, AF and HL
              are corrupt, and all others are preserved

153   &BCCB   KL ROM WALK
      Action: Finds and initialises all background ROMs
      Entry:  DE holds  the  address  of  the  first  usable  byte of
              memory, HL holds the address of the last usable byte
      Exit:   DE holds the address of  the  new  first usable byte of
              memory, HL holds the  address  of  the  new last usable
              byte, AF and BC  are  corrupt,  and all other registers
              are preserved
      Notes:  This routine looks at the  ROM  select addresses from 0
              to l5 (1 to 7 for the 464) and calls the initialisation
              routine of any ROMs present; these routines may reserve
              memory by adjusting DE and  HL before returning control
              to KL ROM WALK, and the  ROM  is then added to the list
              of command handling routines

154   &BCCE   KL INIT BACK
      Action: Finds and initialises a specific background ROM
      Entry:  C contains the ROM select address  of the ROM, DE holds
              the address of  the  first  usable  byte  of memorv, HL
              holds the address of the last usable byte of memory
      Exit:   DE holds the address  of  the  new  first usaUe byte of
              memory, HL holds the  address  of  the  new last usable
              byte.  AF and B  are  corrupt,  and all other registers
              are preserved
      Notes:  The ROM select address must be in  the range of 0 to 15
              (or 1 to 7 for the  464)  although address 7 is tor the
              AMSDOS/CPM ROM if  present.   The  ROM's initialisation
              routine is then called and  some memory may be reserved
              for the ROM by adjusting the values of DE and HL before
              returning control to KL INlT BACK

155   &BCD1   KL LOG EXT
      Action: Logs on a new RSX to the firmware
      Entry:  BC contains the address of  the RSX's command table, HL
              contains the address of four  bytes exclusively for use
              by the firmware
      Exit:   DE is corrupt, and all other registers are preserved

156   &BCD4   KL FIND COMMAND
      Action: Searches an RSX, background  ROM  or foreground ROM, to
              find a command in its table
      Entry:  HL contains the address  of  the  command  name (in RAM
              only) which is being searched for
      Exit:   If the narne was found in  a RSX or background ROM then
              Carry is true, C contains  the  ROM select address, and
              HL contains the address of  the routine; if the command
              was not found,  then  Carry  is  false,  C  and  HL are
              corrupt; in either case, A,  B  and DE are corrupt, and
              all others are preserved
      Notes:  The command names should be in  upper case and the last
              character should have &80 added  to it; the sequence of
              searching is RSXs, then ROMs  with lower numbers before
              ROMs with higher numbers

157   &BCD7   KL NEW FRAME FLY
      Action: Sets up a frame flyback event block which will be acted
              on whenever a frame flyback occurs
      Entry:  HL contains the  address  of  the  event  block  in the
              central 32K of  RAM,  B  contains  the  event class.  C
              contains the  ROM  select  address  (if  any),  and  DE
              contains the address if the event routine
      Exit:   AF, DE and HL are corrupt,  and all other registers are
              preserved

158   &BCDA   KL ADD FRAME FLY
      Action: Adds an existing but deleted  frame flyback event block
              to the list of routines run when a frame flyback occurs
      Entry:  HL contains the  address  of  the  event  block (in the
              central 32K of RAM)
      Exit:   AF, DE and HL are corrupt, and all others are preserved

159   &BCDD   KL DEL FRAME FLY
      Action: Removes a frame flyback  event  block  from the list of
              routines which are mn when a frame flyback occurs
      Entry:  HL contains the address of the event block
      Exit:   AF, DE and HL are corrupt, and all others are preserved

160   &BCE0   KL NEW FAST TICKER
      Action: Sets up a fast  ticker  event  block  which will be run
              whenever the l/300th second ticker interrupt occurs
      Entry:  HL contains the  address  of  the  event  block (in the
              central 32K of  RAM),  B  contains  the  event class, C
              contains the  ROM  select  address  (if  any),  and  DE
              contains the address of the event routine
      Exit:   AF, DE and HL are corrupt,  and all other registers are
              preserved

161   &BCE3   KL ADD FAST TICKER
      Action: Adds an existing but deleted fast ticker event block to
              the list of routines which are run when the l/300th sec
              ticker interrupt occurs
      Entry:  HL contains the address of the event block
      Exit:   AF, DE and HL are corrupt,  and all the other registers
              are preserved

162   &BCE6   KL DEL FAST TICKER
      Action: Removes a fast  ticker  event  block  from  the list of
              routines run  when  the  l/300th  sec  ticker interrupt
              occurs
      Entry:  HL contains the address of the event block
      Exit:   AF, DE and HL are corrupt, and all others are preserved

163   &BCE9   KL ADD TICKER
      Action: Sets up a ticker event block which will be run whenever
              a 1/50th second ticker interrupt occurs
      Entry:  HL contains the  address  of  the  event  block (in the
              central 32K of RAM), DE  contains the initial value for
              the counter, and BC  holds  the  value that the counter
              will be given whenever it reaches zero
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all  the other
              registers are preserved
      Notes:  Every 1/50th of a second all the tick blocks are looked
              at and  their  counter  is  decreased  by  1;  when the
              counter reaches zero,  the  event  is  'kicked' and the
              counter is loaded with the value  in BC; any tick block
              with a counter of 0  is  ignored,  and therefore if the
              value in BC is 0,  the  event  will be kicked only once
              and ignored after that

164   &BCEC   KL DEL TICKER
      Action: Removes a ticker event block  from the list of routines
              that are run when a l/50th sec ticker interrupt occurs
      Entry:  HL contains the address of the event block
      Exit:   If the event block was  found,  then Carry is true, and
              DE holds the value  remaining  of  the  counter; if the
              event block was not found, then  Carry is false, and DE
              is corrupt; in both cases,  A,  HL  and the other flags
              are corrupt, and all other registers are preserved

165   &BCEF   KL INIT EVENT
      Action: Initialises an event block
      Entry:  HL contains the  address  of  the  event  block (in the
              central 32K of RAM), B contains the class of event, and
              C contains the ROM  select  address,  and  DE holds the
              address of the event routine
      Exit:   HL holds the  address  of  the  event  block+7, and all
              other registers are preserved
      Notes:  The event class is derived as follows:
              bit 0 -indicates a near address
              bits 1 to 4 - hold the synchronous event priority
              bit 5 - always zero
              bit 6 - if bit 6 is set, then it is an express event
              bit 7 - if bit  7  is  set,  then it is an asynchronous
              event.  Asynchronous events do  not have priorities; if
              it is an  express  asynchronous  event,  then its event
              routine is called from the  interrupt  path; if it is a
              normal asynchronous event,  then  its  event routine is
              called just before returning from  the interrupt; if it
              is an express synchronous event,  then  it has a higher
              priority than normal synchronous events, and it may not
              be disabled through use  of  KL  EVENT  DISABLE; if the
              near address bit is set, then the routine is located in
              the central 32K  of  RAM  and  is  called  directly, so
              saving time; no event may have a priority of zero

166   &BCF2   KL EVENT
      Action: Kicks an event block
      Ently:  HL contains the address of the event block
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved

167   &BCF5   KL SYNC RESET
      Action: Clears the synchronous event queue
      Entry:  No entry conditions
      Exit:   AF and HL  are  corrupt,  and  all  other registers are
              preserved
      Notes:  When using this routine, all events that are waiting to
              be dealt with are simply discarded

168   &BCF8   KL DEL SYNCHRONOUS
      Action: Removes a synchronous event from the event queue
      Entry:  HL contains the address of the event block
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved

169   &BCFB   KL NEXT SYNC

      Action: Finds out if there is a synchronous event with a higher
              priority
      Entry:  No entry conditions
      Exit:   If there is an  event  to  be  processed, then Carry is
              true, HL contains the address of the event block, and A
              contains the priority of  the  previous event; if there
              is no event to be processed, then Carry is false, and A
              and HL are corrupt; in either  case, DE is corrupt, and
              all other registers are preserved

170   &BCFE   KL DO SYNC
      Action: Runs a synchronous event routine
      Entry:  HL contains the address of the event block
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  See KL DONE SYNC below

171   &BD01   KL DONE SYNC
      Action: Finishes running a synchronous event routine
      Entry:  A contains the priority of  the  previous event, and HL
              contains the address of the event block
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  When an event that is waiting  to be processed has been
              found by KL NEXT SYNC, the  event routine should be run
              by KL DO SYNC; after this KL DONE SYNC should be called
              so that the event  counter  can  be  decreased - if the
              counter is greater than zero  then  the event is placed
              back on the synchronous event queue

172   &BD04   KL EVENT DISABLE
      Action: Disables norrnal synchronous events
      Entry:  No entry conditions
      Exit:   HL is corrupt, and all other registers are preserved

173   &BD07   KL EVENT ENABLE
      Action: Enables normal synchronous events
      Entry:  No entry conditions
      Exit:   HL is corrupt, and all other registers are preserved

174   &BD0A   KL DISARM EVENT
      Action: Disarrns a specific event and stops it from occurring
      Entry:  HL contains the address of the event block
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  This routine should be used to disarm only asynchronous
              events; see also KL DEL SYNCHRONOUS

175   &BD0D   KL TIME PLEASE
      Action: Returns the time that  has  elapsed  since the computer
              was switched on or reset (in 1/300ths of a second)
      Entry:  No entry conditions
      Exit:   DEHL contains the four byte  count of the time elapsed,
              and all other registers are preserved
      Notes:  D holds the most signifilcant byte of the time elapsed,
              and L holds the least  significant; the four byte count
              overflows after approximately l66 days have elapsed.

176   &BD10   KL TIME SET
      Action: Sets the elapsed time (in lЎ300ths of a second)
      Entry:  DEHL contains the four byte count of the time to set
      Exit:   AF is corrupt, and all other registers are preserved

The Machine Pack

177   &BD13   MC BOOT PROGRAM
      Action: Loads a program into RAM and then executes it
      Entry:  HL contains the address of the routine which is used to
              load the program
      Exit:   Control is  handed  over  to  the  program  and  so the
              routine is not returned from
      Notes:  All events, sounds and  interrupts  are turned off, the
              fiImware indirections  are  returned  to  their default
              settings, and the stack  is  reset;  the routine to run
              the program should be in  the  central block of memory,
              and should obey the  following  exit conditions: if the
              program was loaded  successfully,  then  Carry is true,
              and HL  contains  the  prograrn  entry  point;  if  the
              program failed to load, then Carry  is false, and HL is
              corrupt; in either case,  A,  BC,  DE,  IX,  IY and the
              other flags are all corrupt  Should the program fail to
              load, control is  returned  to  the previous foreground
              program

178   &BD16   MC START PROGRAM
      Action: Runs a foreground program
      Entry:  HL contains the  entry  point  for  the  program, and C
              contains the ROM selection number
      Exit:   Control is handed  over  to  the  prograrn  and  so the
              routine is not returned from

179   &BD19   MC WAIT FLYBACK
      Action: Waits until a frame flyback occurs
      Entry:  No entry conditions
      Exit:   All registers are preserved
      Notes:  When the frame flyback occurs  the  screen is not being
              written to and so the  screen c~n be manipulated during
              this period without any  flickering  or ghosting on the
              screen

180   &BD1C   MC SET MODE
      Action: Sets the screen mode
      Entry:  A contains the required mode
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  Although this routine changes  the  screen mode it does
              not inform the routines which  write to the screen that
              the mode has  been  changed;  therefore  these routines
              will write to the screen  as  if  the mode had not been
              changed; however as  the  hardware  is now interpreting
              these signals differently, unusual effects may occur

181   &BD1F   MC SCREEN OFFSET
      Action: Sets the screen offset
      Entry:  A contains the screen base,  and HL contains the screen
              offset
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  As with MC SET MODE,  this routine changes the hardware
              setting without telling the routines  that write to the
              screen; therefore these  routines  may cause unpredict-
              able effects if called; the default screen base is &C0

182   &BD22   MC CLEAR INKS
      Action: Sets all the PENs  and  the  border  to  one colour, so
              making it seem as if the screen has been cleared
      Entry:  DE contains the address of the ink vector
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  The ink vector takes the following form:
              byte 0 - holds the colour for the border
              byte 1 - holds  the  colour  for  all  of  the PENs The
              values for the colours are all given as hardware values

183   &BD25   MC SET INKS
      Action: Sets the colours of all the PENs and the border
      Entry:  DE contains the address of the ink vector
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  The ink vector takes the following form:
              byte 0 - holds the colour for the border
              byte 1 - holds the colour for PEN 0...
              ... byte 16 - holds the colour for PEN 15
              The values for the  colours  are  all given as hardware
              values; the routine sets all sixteen PEN's

184   &BD28   MC RESET PRINTER
      Action: Sets the MC WAIT  PRINTER  indirection  to its original
              routine
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved

185   &BD2B   MC PRINT CHAR
      Action: Sends a character to the  printer  and detects if it is
              busy for too long (more than 0.4 seconds)
      Entry:  A contains the character to  be  printed - only charac-
              ters upto ASCII 127 can be printed
      Exit:   If the character was sent properly, then Carry is true;
              if the printer was busy, then Carry is false; in either
              case, A and the other flags  are corrupt, and all other
              registers are preserved
      Notes:  This routine uses the MC WAIT PRINTER indirection

186   &BD2E   MC BUSY PRINTER
      Action: Tests to see if the printer is busy
      Entry:  No entry conditions
      Exit:   If the printer is  busy,  then  Carry  is  true; if the
              printer is not  busy,  then  Carry  is  false;  in both
              cases, the  other  flags  are  corrupt,  and  all other
              registers are preserved

187   &BD31   MC SEND PRINTER
      Action: Sends a character to  the  printer,  which  must not be
              busy
      Entry:  A contains tlle character to  be printed - only charac-
              ters up to ASCII 127 can be printed
      Exit:   Carry is true, A and  the  other flags are corrupt, and
              all other registers are preserved

188   &BD34   MC SOUND REGISTER
      Action: Sends data to a sound chip register
      Entry:  A contains the  register  nurnber,  and  C contains the
              data to be sent
      Exit:   AF and BC  are  corrupt,  and  all  other registers are
              preserved

189   &BD37   JUMP RESTORE
      Action: Restores the jumpblock to its default state
      Entry:  No entry conditions
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  This routine does  not  affect  the  indirections jump-
              block, but restores all entries in the main jumpblock

 664 and 6128 only

190   &BD3A   KM SET LOCKS
      Action: Turns the shift and caps locks on and off
      Entry:  H contains the  caps  lock  state,  and  L contains the
              shift lock state
      Exit:   AF is corrupt, and all others are preserved
      Notes:  In this routine, &00  means  turned  off, and &FF means
              turned on

191   &BD3D   KM FLUSH
      Action: Empties the key buffer
      Entry:  No entry conditions
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  This routine also discards any current expansion string

192   &BD40   TXT ASK STATE
      Action: Gets the VDU and cursor state
      Entry:  No entry conditions

      Exit:   A contains the  VDU  and  cursor  state,  the flags are
              corrupt, and all others are preserved
      Notes:  The value in  the  A  register  is  bit significant, as
              follows:
              if bit 0 is set, then the cursor is disabled, otherwise
              it is enabled
              if bit  1  is  set,  then  the  cursor  is  turned off,
              otherwise it is on
              if bit 7 is set, then  the VDU is enabled, otherwise it
              is disabled

193   &BD43   GRA DEFAULT
      Action: Sets the graphics VDU to its default mode
      Entry:  No entry conditions
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  Sets the background to opaque,  the first point of line
              is plotted, lines aren't dotted,  and the write mode is
              force

194   &BD46   GRA SET BACK
      Action: Sets the graphics background  mode  to either opaque or
              transparent
      Entry:  A holds zero if opaque mode  is wanted, or holds &FF to
              select transparent mode
      Exit:   All registers are preserved

195   &BD49   GRA SET FIRST
      Action: Sets whether the first point  of  a  line is plotted or
              not
      Entry:  A holds zero if the first  point  is not to be plotted,
              or holds &FF if it is to be plotted
      Exit:   All registers are preserved

196   &BD4C   GRA SET LINE MASK
      Action: Sets how the points in a  line are plotted - ie defines
              whether a line is dotted or not
      Entry:  A contains the line mask that will be used when drawing
              lines
      Exit:   All registers are preserved
      Notes:  The first point in the line corresponds to bit 7 of the
              line mask and after bit 0 the mask repeats; if a bit is
              set then that point will be plotted; the mask is always
              applied from left to right, or from bottom to top

197   &BD4F   GRA FROM USER
      Action: Converts user coordinates into base coordinates
      Entry:  DE contains the user X  coordinate, and HL contains the
              user Y coordinate
      Exit:   DE holds the base X coordinate, and HL holds the base Y
              coordinate, AF is corrupt, and all others are preserved

198   &BD52   GRA FILL
      Action: Fills an area of the  screen  starting from the current
              graphics position and extending until it reaches either
              the edge of the window or a pixel set to the PEN
      Entry:  A holds a PEN to fill with, HL holds the address of the
              buffer, and DE holds the length of the buffer
      Exit:   If the area was filled properly, then Carry is true; if
              the area was not filled, then Carry is false; in either
              case, A, BC, DE, HL  and  the  other flags are corrupt,
              and all others are preserved
      Notes:  The buffer is  used  to  store  complex  areas to fill,
              which are remembered and  filled  when  the basic shape
              has been done;  each  entry  in  the  buffer uses seven
              bytes and so the more complex  the shape the larger the
              buffer; if it runs out of  space to store these complex
              areas, it will fill what  it  can  and then return with
              Carry false

199   &BD55   SCR SET POSITION
      Action: Sets the screen  base  and  offset  without telling the
              hardware
      Entry:  A contains the screen base,  and HL contains the screen
              offset
      Exit:   A contains the masked screen  base, and HL contains the
              masked screen offset, the  flags  are  corrupt, and all
              other registers are preserved

200   &BD58   MC PRINT TRANSLATION
      Action: Sets how ASCII  characters  will  be  translated before
              being sent to the printer
      Entry:  HL contains the address of the table
      Exit:   If the table is too long,  then Carry is false (ie more
              than 20 entries); if  the  table  is correctly set out,
              then Carry is true; in either  case,  A, BC, DE, HL and
              the  other  flags  are  corrupt,  and  all  others  are
              preserved
      Notes:  The first byte in the  table  is the number of entries;
              each entry requires two bytes, as follows:
              byte 0 - the character to be translated
              byte 1 -  the  character  that  is  to  be  sent to the
              printer If the character to  be  sent to the printer is
              &FF, then the character is ignored and nothing is sent

201   &BD5B   KL BANK SWITCH (6128 only)
      Action: Sets which RAM banks are being accessed by the Z80
      Entry:  A contains the organisation that is to be used
      Exit:   A contains the  previous  organisation,  the  flags are
              corrupt, and all other registers are preserved

The Firmware Indirections

000   &BDCD   TXT DRAW CURSOR
      Action: Places the cursor  on  the  screen,  if  the  cursor is
              enabled
      Entry:  No entry conditions
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  The cursor is  an  inverse  blob  which  appears at the
              current text position

001   &BDD0   TXT UNDRAW CURSOR
      Action: Removes the cursor from  the  screen,  if the cursor is
              enabled
      Entry:  No entry conditions
      Exit:   AF  is  corrupt,  and  all   the  other  registers  are
              preserved

002   &BDD3   TXT WRITE CHAR
      Action: Writes a character onto the screen
      Entry:  A holds  the  character  to  be  wntten,  H  holds  the
              physical column number, and  L  holds the physical line
              number
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved

003   &BDD6   TXT UNWRITE
      Action: Reads a character from the screen
      Entry:  H contains the physical  column  number, and L contains
              the physical line number to read from
      Exit:   If a character was  found,  then  Carry  is true, and A
              contains the character; if no character was found, then
              Carry is false, and  A  contains  zero; in either case,
              BC, DE, HL and  the  other  nags  are  corrupt, and all
              other registers are preserved Notes: This routine works
              by comparing the image on the screen with the character
              matrices; therefore if the character matrices have been
              altered the routine may not find a readable a character

004   &BDD9   TXT OUT ACTION
      Action: Writes a character to  the  screen  or  obeys a control
              code (&00 to &1F)
      Entry:  A contains the character or code
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  Control codes may take  a  maximum  of nine parameters;
              when a control code  is  found,  the required number of
              parameters is read into  the  control  code buffer, and
              then the control code  is  acted  upon; if the graphics
              character wnte mode  is  enabled,  then  characters and
              codes are printed using  the  graphics  VDU; when using
              the graphics VDU  control  codes  are  printed  and not
              obeyed

005   &BDDC   GRA PLOT
      Action: Plots a point in the current graphics PEN
      Entry:  DE contains the user X  coordinate, and HL contains the
              user Y coordinate of the point
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  This routine uses the  SCR  WRITE  indirection to write
              the point to the screen

006   &BDDF   GRA TEST
      Action: Tests a point and finds out what PEN it is set to
      Entry:  DE contains the user X  coordinate, and HL contains the
              user Y coordinate of the point
      Exit:   A contains the PEN that the point is written in, BC, DE
              and HL are corrupt, and all others are preserved
      Notes:  This routine uses the  SCR  READ  indirection to test a
              point on the screen

007   &BDE2   GRA LINE
      Action: Draws a line  in  the  current  graphics  PEN, from the
              current graphics position to the specified point
      Entry:  DE contains the user X  coordinate, and HL contains the
              user Y coordinate for the endpoint
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all others are
              preserved
      Notes:  This routine uses the  SCR  WRITE  indirection to write
              the points of the line on the screen

008   &BDE5   SCR READ
      Action: Reads a pixel from the screen  and returns its decode a
              PEN
      Entry:  HL contains the  screen  address  of  the  pixel, and C
              contains the mask for the pixel
      Exit:   A contains the decoded PEN of  the pixel, the flags are
              corrupt, and all others are preserved
      Notes:  The mask should be for a single pixel, and is dependent
              on the screen mode

009   &BDE8   SCR WRITE
      Action: Writes one or more pixels to the screen
      Entry:  HL contains the screen address of the pixel, C contains
              the mask, and B contains the encoded PEN
      Exit:   AF is corrupt, and all other registers are preserved
      Notes:  The mask should determine  which  pixels  in the screen
              byte are to be plotted

010   &BDEB   SCR MODE CLEAR
      Action: Fills the entire screen  memory  with &00, which clears
              the screen to PEN 0
      Entry:  No entry conditions
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all  the other
              registers are preserved

011   &BDEE   KM TEST BREAK
      Action: Tests if  the  ESC  key  has  been  pressed,  and  acts
              accordingly
      Entry:  C contains  the  Shift  and  Control  key  states,  and
              interrupts must be disabled
      Exit:   AF and HL  are  corrupt,  and  all  other registers are
              preserved
      Notes:  If bit 7 of C is set,  then the Control key is pressed;
              if bit 5 of C is set, then the Shift key is pressed; if
              ESC, Shift and Control are  pressed  at the sarne time,
              then it initiates a system  reset; otherwise it reports
              a break event

012   &BDF1   MC WAIT PRINTER
      Action: Sends a character to the printer if it is not busy
      Entry:  A contains the character to be sent to the printer
      Exit:   If the character was  printed  successfully, then Carry
              is true; if the  printer  was  busy  for too long (more
              than 0.4 seconds), then Carry is false; in either case,
              A and BC  are  corrupt,  and  all  other  registers are
              preserved

013   &BDF4   KM SCAN KEYS
      Action: Scans the  keyboard  every  1/50th  of  a  second,  and
              updates the status of all keys
      Entry:  All interrupts must be disabled
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved

The Maths Firmware

000   &BDC1   MOVE REAL (&BD3D for the 464)
      Action: Copies the five bytes that are  pointed to by DE to the
              location held in HL
      Entry:  DE points to the source  real  value,  and HL points to
              the destination
      Exit:   HL points to the real  value  in the destination, Carry
              is true if the move  went  properly,  F is corrupt, and
              all other registers are preserved
      Notes:  For the 464 only, A holds the exponent byte of the real
              value when the routine is exited

001   &BD64   INTEGER TO REAL (&BD40 for the 464)
      Action: Converts an integer value into a real value
      Entry:  HL holds the integer  value,  DE  points  to the desti-
              nation for the real value, bit 7 of A holds the sign of
              the integer value - it is taken to be negative if bit 7
              is set
      Exit:   HL points to the real value  in the destination, AF and
              DE are corrupt, and all others are preserved

002   &BD67   BINARY TO REAL (&BD43 for the 464)
      Action: Converts a four byte binary value  into a real value at
              the same location
      Entry:  HL points to the binary  value,  bit  7  of A holds the
              sign of the binary value - negative if it is set
      Exit:   HL points to the real  value  in  lieu of the four byte
              binary  value,  AF  is  corrupt,  and  all  others  are
              preserved
      Notes:  A four byte binary value  is  an unsigned integer up to
              &FFFFFFFF and is stored with the least significant byte
              first, and with the most significant byte last

003   &BD6A   REAL TO INTEGER (&BD46 for the 464)
      Action: Converts a real  value,  rounding  it  into an unsigned
              integer value held in HL
      Entry:  HL points to the real value
      Exit:   HL holds  the  integer  value,  Carry  is  true  if the
              conversion worked successfully, the Sign flag holds the
              sign of the integer (negative if it is set).  A, IX and
              the other flags are  corrupt,  and  all other registers
              are preserved

      Notes:  This rounds the decimal part  down  if  it is less than
              0.5, but rounds up if it  is  greater than, or equal to
              0.5

004   &BD6D   REAL TO BINARY (&BD49 for the 464)
      Action: Converts a real value,  rounding  it  into  a four byte
              binary value at the same location
      Entry:  HL points to the real value
      Exit:   HL points to  the  binary  value  in  lieu  of the real
              value, bit 7 of B holds  the  sign for the binary value
              (it is negative if bit  7  is  set),  AF,  B and IX are
              corrupt, and all other registers are preserved
      Notes:  See REAL TO INTEGER for  details  of how the values are
              rounded up or down

005   &BD70   REAL FIX (&BD4C for the 464)
      Action: Performs an equivalent  of  BASIC's  FIX  function on a
              real value, leaving the  result  as  a four byte binary
              value at the same location
      Entry:  HL points to the real value
      Exit:   HL points to  the  binary  value  in  lieu  of the real
              value, bit 7 of B has the  sign of the binary value (it
              is negative if bit 7 is set), AF, B and IX are corrupt,
              and all others are preserved
      Notes:  FIX removes any  decimal  part  of  the value, rounding
              down whether  positive  or  negative  -  see  the BASIC
              handbook for more details on the FIX command

006   &BD73   REAL INT (&BD4F for the 464)
      Action: Performs an equivalent  of  BASIC's  INT  function on a
              real value, leaving the  result  as  a four byte binary
              value at the same location
      Entry:  HL points to the real value
      Exit:   HL points to  the  binary  value  in  lieu  of the real
              value, bit 7 of B has the  sign of the binary value (it
              is negative if bit 7 is set), AF, B and IX are corrupt,
              and all others are preserved
      Notes:  INT removes any  decimal  part  of  the value, rounding
              down if the nurnber is positive,  but rounding up if it
              is negative

007   &BD76   INTERNAL SUBROUTINE - not useful (&BD52 for the 464)

008   &BD79   REAL *10^A (&BD55 for the 464)
      Action: Multiplies a real value by 10 to the power of the value
              in the A  register,  leaving  the  result  at  the same
              location
      Entry:  HL points to the real value,  and  A holds the power of
              10
      Exit:   HL points to the  result,  AF,  BC,  DE,  IX and IY are
              corrupt

009   &BD7C   REAL ADDITION (&BD58 for the 464)
      Action: Adds two real values, and leaves  the result in lieu of
              the first real number
      Entry:  HL points to the first real value, and DE points to the
              second real value
      Exit:   HL points to the  result,  AF,  BC,  DE,  IX and IY are
              corrupt

010   &BD82   REAL REVERSE SUBTRACTION (&BD5E for the 464)
      Action: Subtracts the first  real  value  from  the second real
              value, and leaves  the  result  in  lieu  of  the first
              number
      Entry:  HL points to the first real value, and DE points to the
              second real value
      Exit:   HL points to the  result  in  place  of  the first real
              value, AF, BC, DE, IX and IY are corrupt

011   &BD85   REAL MULTIPLICATION (&BD61 for the 464)
      Action: Multiplies two real  values  together,  and  leaves the
              result in lieu of the first number
      Entry:  HL points to the first real value, and DE points to the
              second real value
      Exit:   HL points to the  result  in  place  of  the first real
              value, AF, BC, DE, IX and IY are corrupt

012   &BD88   REAL DIVISION (&BD64 for the 464)
      Action: Divides the first real value  by the second real value,
              and leaves the result in lieu of the first number
      Entry:  HL points to the first real value, and DE points to the
              second real value
      Exit:   HL points to the  result  in  place  of  the first real
              value, AF, BC, DE, IX and IY are corrupt

013   &BD8E   REAL COMPARISON (&BD6A for the 464)
      Action: Compares two real values
      Entry:  HL points to the first real value, and DE points to the
              second real value
      Exit:   A holds the result of  the  comparison process, IX, IY,
              and the other flags  are  corrupt,  and  all others are
              preserved
      Notes:  After this routine  has  been  called,  the  value in A
              depends on the result of the comparison as follows:
              if the first real  number  is  greater  than the second
              real number, then A holds &01
              if the first real number is the same as the second real
              number, then A holds &00  if  the second real number is
              greater than the first real number, then A holds &FF

014   &BD91   REAL UNARY MINUS (&BD6D for the 464)
      Action: Reverses the sign of a real value
      Entry:  HL points to the real value
      Exit:   HL points to the new value of the real number (which is
              stored in place of  the  original  number),  bit 7 of A
              holds the sign of the result  (it  is negative if bit 7
              is set), AF and IX are corrupt, and all other registers
              are preserved

015   &BD94   REAL SIGNUM/SGN (&BD70 for the 464)
      Action: Tests a real value, and compares it with zero
      Entry:  HL points to the real value
      Exit:   A holds the result of  this  comparison process, IX and
              the  other  Ўlags  are  corrupt,  and  all  others  are
              preserved
      Notes:  After this routine  has  been  called,  the  value in A
              depends on the result of the comparison as follows:
              if the real number is greater than 0, then A holds &01,
              Carry is false, and Zero is false
              if the real number is the same  as 0, then A holds &00,
              Carry is false, and Zero is true
              if the real number is smaller than 0, then A holds &FF,
              Carry is true, and Zero is false

016   &BD97   SET ANGLE MODE (&BD73 for the 464)
      Action: Sets the angular  calculation  mode  to  either degrees
              (DEG) or radians (RAD)
      Entry:  A holds the mode setting  -  0  for  RAD, and any other
              value for DEG
      Exit:   All registers are preserved

017   &BD9A   REAL PI (&BD76 for the 464)
      Action: Places the real value of pi at a given memory location
      Entry:  HL holds the address at which the  value of pi is to be
              placed
      Exit:   AF and DE  are  corrupt,  and  all  other registers are
              preserved

018   &BD9D   REAL SQR (&BD79 for the 464)

      Action: Calculates the square root of a real value, leaving the
              result in lieu of the real value
      Entry:  HL points to the real value
      Exit:   HL points to the result of the calculation, AF, BC, DE,
              IX and IY are corrupt

019   &BDA0   REAL POWER (&BD7C for the 464)
      Action: Raises the first real value to  the power of the second
              real value, leaving the  result  in  lieu  of the Ўirst
              real value
      Entry:  HL points to the first real value, and DE points to the
              second real value
      Exit:   HL points to the result of the calculation, AF, BC, DE,
              IX and IY are corrupt

020   &BDA3   REAL LOG (&BD7F for the 464)
      Action: Returns the naperian logarithm  (to  base  e) of a real
              value, leaving the result in lieu of the real value
      Entry:  HL points to the real value
      Exit:   HL points to the  logarithrn  that has been calculated,
              AF, BC, DE, LY and IY are corrupt

021   &BDA6   REAL LOG 10 (&BD82 for the 464)
      Action: Returns the logarithm (to  base  10)  of  a real value,
              leaving the result in lieu of the real value
      Entry:  HL points to the real value
      Exit:   HL points to the  logarithrn  that has been calculated,
              AF, BC, DE, IX and IY are corrupt

022   &BDA9   REAL EXP (&BD85 for the 464)
      Action: Returns the antilogarithm  (base  e)  of  a real value,
              leaving the result in lieu of the real value
      Entry:  HL points to the real value
      Exit:   HL points  to  the  antilogarithm  that  has  been cal-
              culated, AF, BC, DE, IX and IY are corrupt
      Notes:  See the BASIC handbook for details of EXP

023   &BDAC   REAL SINE (&BD88 for the 464)
      Action: Returns the sine of a real value, leaving the result in
              lieu of the real value
      Entry:  HL points to the real value (ie all angle)
      Exit:   HL points to the sine  value  that has been calculated,
              AF, BC, DE, IX and IY are corrupt

024   &BDAF   REAL COSINE (&BD8B for the 464)
      Action: Returns the cosine  of  a  real  value,  leaving  a the
              result in lieu of the real value
      Entry:  HL points to the real value (ie an angle)
      Exit:   HL points to the cosine value that has been calculated,
              AF, BC, DE, IX and IY are corrupt

025   &BDB2   REAL TANGENT (&BD8E for the 464)
      Action: Returns the tangent of a real value, leaving the result
              in lieu of the real value
      Entry:  HL points to the real value (ie an angle)
      Exit:   HL points to  the  tangent  value  that  has  been cal-
              culated, AF, BC, DE, IX and IY are corrupt

026   &BDB5   REAL ARCTANGENT (&BD91 for the 464)
      Action: Returns the arctangent  of  a  real  value, leaving the
              result in lieu of the real value
      Entry:  HL points to the real value (ie an angle)
      Exit:   HL  points  to  the  arctangent  value  that  has  been
              calculated, AF, BC, DE, IX and IY are corrupt

         All of the above routines to calculate sine, cosine, tangent
              and
                        arctangent are slightly inaccuarate

027   &BDB8   INTERNAL SUBROUTINE - not useful (&BD94 for the 464)

028   &BDBB   INTERNAL SUBROUTINE - not useful (&BD97 for the 464)

029   &BDBE   INTERNAL SUBROUTINE - not useful (&BD9A for the 464)

Maths Routines for the 464 only

      &BD5B   REAL SUBTRACTION
      Action: Subtracts the second  real  value  from  the first real
              value, and leaves  the  result  in  lieu  of  the first
              number
      Entry:  HL points to the first real value, and DE points to the
              second real value
      Exit:   HL points to the  result  in  place  of  the first real
              value, AF, BC, DE, IX and IY are corrupt

      &BD67   REAL EXPONENT ADDITION
      Action: Adds the value of the  A  register to the exponent byte
              of a real number
      Entry:  HL points to the real value,  and  A holds the value to
              he added
      Exit:   HL points to the  result  in  place  of  the first real
              value, AF  and  IX  are  corrupt,  and  all  others are
              preserved

      &BD9D   INTERNAL SUBROUTINE - not useful

      &BDA0   INTERNAL SUBROUTINE - not useful

      &BDA3   INTERNAL SUBROUTINE - not useful

      &BDA6   INTERNAL SUBROUTINE - not useful

      &BDA9   INTERNAL SUBROUTINE - not useful

      &BDAC   INTEGER ADDITION
      Action: Adds two signed integer values
      Entry:  HL holds the  first  integer  value,  and  DE holds the
              second integer value
      Exit:   HL holds the result  of  the  addition,  A holds &FF if
              there is an overflow  but  is  preserved otherwise, the
              flags Z  are  corrupt,  and  all  other  registers  are
              preserved

      &BDAF   INTEGER SUBTRACTION
      Action: Subtracts the  second  signed  integer  value  from the
              first signed integer value
      Entry:  HL holds the  first  integer  value,  and  DE holds the
              second integer value
      Exit:   HL holds the result of the  subtraction, A holds &FF if
              there is an overflow  but  is  preserved othenvise, the
              flags are corrupt,  and  all  the  other  registers are
              preserved

      &BDB2   INTEGER REVERSE SUBTRACTION
      Action: Subtracts the  first  signed  integer  value  from  the
              second signed integer value
      Entry:  HL holds the  first  integer  value,  and  DE holds the
              second integer value
      Exit:   HL holds the result of  the  subtraction, AF and DE are
              corrupt, and all others are preserved

      &BDB5   INTEGER MULTIPLICATION
      Action: Multiplies two  signed  integer  values  together,  and
              leaves the result in lieu of the first number
      Entry:  HL holds the  first  integer  value,  and  DE holds the
              second integer value
      Exit:   HL holds the result of  the multiplication, A holds &FF
              if there is an overflow but is corrupted otherwise, the

              flags, BC and DE are  corrupt,  and the other registers
              are preserved
      Notes:  Multiplication of signed integers  does not produce the
              sarne result as with unsigned integers

      &BDB8   INTEGER DIVISION
      Action: Divides the first signed  integer  value  by the second
              signed integer value
      Entry:  HL holds the  first  integer  value,  and  DE holds the
              second integer value
      Exit:   HL holds the  result  of  the  division,  DE  holds the
              remainder, AF and BC  are  corrupt,  and all others are
              preserved
      Notes:  Division of signed integers  does  not produce the same
              result as with unsigned integers

      &BDBB   INTEGER DIVISION 2
      Action: Divides the first signed  integer  value  by the second
              signed integer value
      Entry:  HL holds the  first  integer  value,  and  DE holds the
              second integer value
      Exit:   DE holds the  result  of  the  division,  HL  holds the
              remainder, AF and BC  are  corrupt,  and all others are
              preserved
      Notes:  Division of signed integers  does  not produce the same
              result as with unsigned integers

      &BDBE   INTERNAL SUBROUTINE - not useful

      &BDC1   INTERNAL SUBROUTINE - not useful

      &BDC4   INTEGER COMPARISON
      Action: Compares two signed integer values
      Entry:  HL holds the  first  integer  value,  and  DE holds the
              second integer value
      Exit:   A holds the result of the comparison process, the flags
              are corrupt, and all others are preserved
      Notes:  After this routine  has  been  called,  the  value in A
              depends on the result of the comparison as follows:
              if the first real  number  is  greater  than the second
              real number, then A holds &01
              if the first real  number  is  the  sarne as the second
              real number, then A holds &00
              if the second real  number  is  greater  than the first
              real number, then A holds &FF
              With signed integers,  the  range  of  values runs from
              &8000 (-32768) via zero  to  &7FFF  (+32767) and so any
              value which is  greater  than  &8000  is  considered as
              being less than a value of &7FFF or less

      &BDC7   INTEGER UNARY MINUS
      Action: Reverses the sign of  an  integer value (by subtracting
              it from &10000)
      Entry:  HL holds the integer value
      Exit:   HL holds the new  value  of  the  integer number, AF is
              corrupt, cmd all other registers are preserved

      &BDCA   INTEGER SIGNUM/SGN
      Action: Tests a signed integer value
      Entry:  HL holds the integer value
      Exit:   A holds the  result  of  this  comparison  process, the
              flags are corrupt, and all others are preserved
      Notes:  After this routine  has  been  called,  the  value in A
              depends on the result of the comparison as follows:
              if the integer number  is  greater  than  0 and is less
              than &8000, then A holds &01
              if the integer number is  the  same  as 0, then A holds
              &00
              if the integer number  is  greater  than &7FFF and less
              than or equal to &FFFF, then A holds &FF
              See INTEGER COMPARISON for more details on the way that
              signed integers are laid out

Maths Subroutines for the 664 and 6128 only

      &BD5E   TEXT INPUT
      Action: Allows  upto  255  characters  to  be  input  from  the
              keyboard into a buffer
      Entry:  HL points to the start of  the buffer - a NUL character
              must be placed after any characters already present, or
              at the start of the buffer if there is no text
      Exit:   A has the last key pressed,  HL  points to the start of
              the buffer, the flags are  corrupt,  and all others are
              preserved
      Notes:  This routine prints any existing contents of the buffer
              (upto the NUL character) and then echoes any keys used;
              it allows full line  editing  with  the cursor keys and
              DEL, etc; it is exited only by use of ENTER or ESC

      &BD7F   REAL RND
      Action: Creates a new RND real  value  at a location pointed to
              by HL
      Entry:  HL points to the destination for the result
      Exit:   HL points to the RND value, AF, BC, DE and IX registers
              are corrupt; and all others are preserved

      &BD8B   REAL RND(0)
      Action: Returns the last RND value  created,  and  puts it in a
              location pointed to by HL
      Entry:  HL points  to  the  place  where  the  value  is  to be
              returned to
      Exit:   HL points to  the  value  created,  AF,  DE  and IX are
              corrupt, and all other registers are preserved
      Notes:  See the BASIC handbook for more details on RND(0)

AMSDOS and BIOS Firmware

A     &C033   BIOS SET MESSAGE
      Action: Enables or disables disc error messages
      Entry:  To enable messages, A holds &00; to disable messages, A
              holds &FF
      Exit:   A holds  the  previous  state,  HL  and  the  flags are
              corrupt, and all others are preserved
      Notes:  Enabling  and  disabling  the   messages  can  also  be
              achieved by poking &BE78 with &00 or &FF

B     &C036   BIOS SETUP DISC
      Action: Sets the parameters which effect the disc speed
      Entry:  HL holds the address of  the  nine  bytes which make up
              the parameter block
      Exit:   AF, BC, DE and HL are  corrupt, and all other registers
              are preserved
      Notes:  The parameter block is arranged as follows:
              bytes 0&1 -  the  motor  on  time  in  20ms  units; the
              default is &0032; the fastest is &0023
              bytes 2&3 -  the  motor  off  time  in  20ms units; the
              default is &00FA; the fastest is &00C8
              byte 4 - the write off  time in l0жs units; the default
              is &AF; should not be changed
              byte 5 - the head settle time in 1ms units; the default
              is &0F; should not be changed
              byte 6 - the step rate  time  in 1ms units; the default
              is &0C; the fastest is &0A
              byte 7 - the  head  unload  delay;  the default is &01;
              should not be changed
              byte 8  -  a  byte  of  &03  and  this  should  be left
              unaltered

C     &C039   BIOS SELECT FORMAT
      Action: Sets a format for a disc
      Entry:  A holds the type of format that is to be selected
      Exit:   AF, BC, DE  and  HL  are  corrupt,  and  all  the other
              registers are preserved
      Notes:  To select one of the normal disc formats, the following
              values should be put into the A register:
              Data format - &C1
              System format - &41 - Used by CP/M
              IBM format - &01 - compatible with CP/M-86
              This routine sets  the  extended  disc  parameter block
              (XDPB) at &A890 to &A8A8  -  to  set other formats, the
              XDPB must be altered directly

D     &C03C   BIOS READ SECTOR
      Action: Reads a sector from a disc into memory
      Entry:  HL holds the address in memory where the sector will be
              read to, E holds the drive number (&00 for drive A, and
              &01 for drive B), D holds the track number, and C holds
              the sector number
      Exit:   If the sector was read properly,  then Carry is true, A
              holds 0, and HL is preserved;  if the read failed, then
              Carry is false, A  holds  an  error  number,  and HL is
              corrupt; in either case,  the  other flags are corrupt,
              and all other registers are preserved

E     &C03F   BIOS WRITE SECTOR
      Action: Writes a sector from memory onto disc
      Entry:  HL holds the address of memory which will be written to
              the disc, E holds the  drive  number  (&00 for drive A,
              and &01 for drive B), D  holds  the track number, and C
              holds the sector number
      Exit:   If the sector was written properly, then Carry is true,
              A holds 0, and HL  is  preserved;  if the write failed,
              then Carry is false, A holds an error number, and HL is
              corrupt; in either case,  the  other flags are corrupt,
              and all other registers are preserved

F     &C042   BIOS FORMAT TRACK
      Action: Formats a complete  track,  inserts  sectors, and fills
              the track with bytes of &E5
      Entry:  HL contains  the  address  of  the  header  information
              buffer which holds  the  header  information  blocks, E
              contains the drive number (&00 for drive A, and &01 for
              drive B), and D holds the track number
      Exit:   if the formatting process was successful, then Carry is
              true, A holds 0, and HL is preserved; if the formatting
              process failed, then Carry is  false,  A holds an error
              number, and HL is  corrupt;  in  either case, the other
              flags are corrupt,  and  all  the  other  registers are
              preserved
      Notes:  The header information block is laid out as follows:
              byte 0 - holds the track number
              byte 1 - holds the head number (set to zero)
              byte 2 - holds the sector number
              byte 3 - holds  log2(sector  size) -7  (usually  either
              &02=512 bytes, or &03=1024  bytes).  Header information
              blocks must be set up  contiguously for every sector on
              the track, and in the same sequence that they are to be
              laid down (eg &C1, &C6,  &C2,  &C7, &C3, &C8, &C4, &C9,
              &C5)

G     &C045   BIOS MOVE TRACK
      Action: Moves the disc drive head to the specified track
      Entry:  E holds the drive number (&00  for drive A, and &01 for
              drive B), and D holds the track number
      Exit:   If the head was moved successfully, then Carry is true,
              A holds 0, and  HL  is  preserved;  if the move failed,
              then Carry is false, A holds an error number, and HL is
              corrupt; in both cases,  the  other  flags are corrupt,
              and all other registers are preserved

      Notes:  There is normally no need to  call this routine as READ
              SECTOR, WRITE  SECTOR  and  FORMAT  TRACK automatically
              move the head to the correct position

H     &C048   BIOS GET STATUS
      Action: Returns the status of the specified drive
      Entry:  A holds the drive number (&00  for drive A, and &01 for
              drive B)
      Exit:   If Carry is true, then A  holds the status byte, and HL
              is preserved; if Carry is false, then A is corrupt, and
              HL holds the  address  of  the  byte  before the status
              byte; in either case,  the  other  flags are preserved,
              and all other registers are preserved
      Notes:  The  status  byte  indicates   the  drive's  status  as
              follows:
              if bit 6 is set, then  either  the write protect is set
              or the disc is missing
              if bit 5 is set, then  the  drive is ready and the disc
              is fitted (whether the disc is formatted or not)
              if bit 4 is set, then the head is at track 0

I     &C04B   BIOS SET RETRY COUNT
      Action: Sets the number of  times  the  operation is retried in
              the event of disc error
      Entry:  A holds the number of retries required
      Exit:   A holds the  previous  number  of  retries,  HL and the
              flags are corrupt, and all others are preserved
      Notes:  The default setting is &10,  and the minimum setting is
              &01; the number  of  retries  can  also  be  altered by
              poking &BE66 with the required value

J     &C56C   GET SECTOR DATA
      Action: Gets the data of a sector on the current track
      Entry:  E holds the drive number
      Exit:   If a formatted disc is present, then Carry is true, and
              HL is preserved; if an  unforrnatted disc is present or
              the disc is missing, then Carry  is false, and HL holds
              the address of  the  byte  before  the  status byte; in
              either case, A and the other flags are corrupt, and all
              other registers are preserved
      Notes:  The track number is held  at  &BE4F, the head number is
              held at &BE50, the sector number  is held at &BE51, and
              the log2(sector size)-7 is  held  at  &BE52; disc para-
              meters do not need to be set to the format of the disc;
              this routine is best used  with the disc error messages
              turned off

Instruction Set for the Z80 Microprocessor

    The following list contains all  the  normal machine code instruc-
tions for the microprocessor, plus a number of undocumented ones.  The
latter comprise those which operate on  the  high  or low bytes of the
Index registets (IX and lY) which  are  notated  here as HIX, LIX, HIY
and LIY - some assemblers may use  the  form  IXH,  etc - and a set of
rotation instructions complementary to SRL, which are designated SLL.

The Opcodes and T states

    Within the instructions, a number of abbreviations are used:
d ...... displacement (a value from -128 (&80) to +127 (&7F))
n ...... a single byte value (from 0 (&00) to 255 (&FF))
hilo ... a double byte  value  (from  -32769  (&8000)  via  0 to 65535
         (&FFFF))
addr ... an address value (from 0  (&0000)  to  65535 (&FFFF)) (in the
         sequence of opcode bytes, 'addr'  and  'hilo' are entered low
         byte first)

    The next two colurnns  detail  the  number  of bytes applicable to
each instruction, and the number of  T states (clock pulses) that each
requires - some have two figures which are distinguised as follows:

f ...... means 'the number of T states  required when the condition is
         false'
t ...... means 'the number of T  states  needed  when the condition is
         true'
= ...... means 'the number of T states  needed when either BC=0 and/or
         A matches the contents of HL'
# ...... means 'the number of T  states  required  when both the above
         conditions are false'
z ...... means 'the number of T states needed when B=0'
nz ..... means 'the number of T states requrred when B<>0'

The Flag Register

    The last columns give  the  effect  on  the  flag  bits which each
instruction causes:

? ...... means the setting of the bit is unpredicatable
- ...... means the setting of the bit is unchanged
0 ...... means that the flag bit is reset to zero
1 ...... means that the flag bit is set to one
         In addition, the Sign flag (bit 7) is also set:
7 ...... if bit 7 of the A register is set
15 ..... if bit 15  of  the  HL  register  pair  (ie  bit  7  of the H
         register) is set
=7 ..... if bit 7 of the  A  register  would  be set by subtraction in
         lieu of CP
         The Zero flag (bi6 6) is also set:
z ...... if the A register or the HL register pair equals zero
= ...... if the A register matches the compared register or value
=A ..... if the A register matches the contents of the address pointed
         to by HL
<>B .... if the B register holds zero
<>b .... if the bit tested is zero
         The Parity/Overflow flag (bit 2) is also set:
p ...... if the register concemed contains an even number of set bits
v ...... if an overflow has occured in Two's Complement arithrnetic
BC ..... if BC is not zero
A80 .... if the  A  register  was  &80  before  this  instruction  was
         perforrned
i ...... to the contents of  the  rnicroprocessor's internal interrupt
         register
         The Carry flag (bit 0) is also set:
c ...... if an addition resulted  in  a  carry  out  of  bit  7 (for a
         register) or bit 15 (for a register pair)
b ...... if a  subtraction  required  a  borrow  from  bit  7  (for  a
         register) or bit 15 (for a register pair)
< ...... if the A register is less than  the value or register that is
         being compared
r0 ..... by the bit rotated in from bit 0 of the register concerned
r7 ..... by the bit rotated in from bit 7 of the register concerned
x ...... if the Carry was reset (ie  zero) before this instruction was
         performed
A0 ..... if tbe  A  register  was  &00  before  this  instruction  was
         performed

Z80 OPCODES

Instruction  і Opcode     і B і Ticks і S  і Z і P   і C
ДДДДДДДДДДДДДЕДДДДДДДДДДДДЕДДДЕДДДДДДДЕДДДДЕДДДЕДДДДДЕДД
ADC A,(HL)   і 8E         і 1 і 7     і 7  і z і v   і c
ADC A,(IX+d) і DD 8E d    і 3 і 19    і 7  і z і v   і c
ADC A,(IY+d) і FD 8E d    і 3 і 19    і 7  і z і v   і c
ADC A,A      і 8F         і 1 і 4     і 7  і z і v   і c
ADC A,B      і 88         і 1 і 4     і 7  і z і v   і c
ADC A,C      і 89         і 1 і 4     і 7  і z і v   і c
ADC A,D      і 8A         і 1 і 4     і 7  і z і v   і c
ADC A,E      і 8B         і 1 і 4     і 7  і z і v   і c
ADC A,H      і 8C         і 1 і 4     і 7  і z і v   і c
ADC A,HIX    і DD 8C      і 2 і 8     і 7  і z і v   і c
ADC A,HIY    і FD 8C      і 2 і 8     і 7  і z і v   і c
ADC A,L      і 8D         і 1 і 4     і 7  і z і v   і c
ADC A,LIX    і DD 8D      і 2 і 8     і 7  і z і v   і c
ADC A,LIY    і FD 8D      і 2 і 8     і 7  і z і v   і c
ADC A,n      і CE n       і 2 і 7     і 7  і z і v   і c
ADC HL,BC    і ED 4A      і 2 і 15    і 15 і z і v   і c
ADC HL,DE    і ED 5A      і 2 і 15    і 15 і z і v   і c
ADC HL,HL    і ED 6A      і 2 і 15    і 15 і z і v   і c
ADC HL,SP    і ED 7A      і 2 і 15    і 15 і z і v   і c
ADD A,(HL)   і 86         і 1 і 7     і 7  і z і v   і c
ADD A,(IX+d) і DD 86 d    і 3 і 19    і 7  і z і v   і c
ADD A,(IY+d) і FD 86 d    і 3 і 19    і 7  і z і v   і c
ADD A,A      і 87         і 1 і 4     і 7  і z і v   і c
ADD A,B      і 80         і 1 і 4     і 7  і z і v   і c
ADD A,C      і 81         і 1 і 4     і 7  і z і v   і c
ADD A,D      і 82         і 1 і 4     і 7  і z і v   і c
ADD A,E      і 83         і 1 і 4     і 7  і z і v   і c
ADD A,H      і 84         і 1 і 4     і 7  і z і v   і c
ADD A,HIX    і DD 86 84   і 2 і 8     і 7  і z і v   і c
ADD A,HIY    і FD 86 84   і 2 і 8     і 7  і z і v   і c
ADD A,L      і 85         і 1 і 4     і 7  і z і v   і c
ADD A,LIX    і DD 86 85   і 2 і 8     і 7  і z і v   і c
ADD A,LIY    і FD 86 85   і 2 і 8     і 7  і z і v   і c
ADD A,n      і C6 n       і 2 і 7     і 7  і z і v   і c
ADD HL,BC    і 09         і 1 і 11    і -  і - і -   і c
ADD HL,DE    і 19         і 1 і 11    і -  і - і -   і c
ADD HL,HL    і 29         і 1 і 11    і -  і - і -   і c
ADD HL,SP    і 39         і 1 і 11    і -  і - і -   і c
ADD IX,BC    і DD 09      і 2 і 15    і -  і - і -   і c
ADD IX,DE    і DD 19      і 2 і 15    і -  і - і -   і c
ADD IX,HL    і DD 29      і 2 і 15    і -  і - і -   і c
ADD IY,BC    і FD 09      і 2 і 15    і -  і - і -   і c
ADD IY,DE    і FD 19      і 2 і 15    і -  і - і -   і c
ADD IY,HL    і FD 29      і 2 і 15    і -  і - і -   і c
ADD IY,SP    і FD 39      і 2 і 15    і -  і - і -   і c
ADD LY,SP    і DD 39      і 2 і 15    і -  і - і -   і c
AND (HL)     і A6         і 1 і 7     і 7  і z і p   і c
AND (IX+d)   і DD A6 d    і 3 і 19    і 7  і z і p   і c
AND (IY+d)   і FD A6 d    і 3 і 19    і 7  і z і p   і c
AND A        і A7         і 1 і 4     і 7  і z і p   і c
AND B        і A0         і 1 і 4     і 7  і z і p   і c
AND C        і A1         і 1 і 4     і 7  і z і p   і c
AND D        і A2         і 1 і 4     і 7  і z і p   і c
AND E        і A3         і 1 і 4     і 7  і z і p   і c
AND H        і A4         і 1 і 4     і 7  і z і p   і c
AND HIX      і DD A4      і 2 і 8     і 7  і z і v   і c
AND HIY      і FD A4      і 2 і 8     і 7  і z і v   і c
AND L        і A5         і 1 і 4     і 7  і z і p   і c
AND LIX      і DD A5      і 2 і 8     і 7  і z і v   і c
AND LIY      і FD A5      і 2 і 8     і 7  і z і v   і c
AND n        і E6 n       і 2 і 7     і 7  і z і p   і c
BIT 0,(HL)   і CB 46      і 2 і 12    і ?  і <>b ?   і -
BIT 0,(IX+d) і CB DD 46 d і 4 і 20    і ?  і <>b ?   і -
BIT 0,(IY+d) і CB FD 46 d і 4 і 20    і ?  і <>b ?   і -
BIT 0,A      і CB 47      і 2 і 8     і ?  і <>b ?   і -
BIT 0,B      і CB 40      і 2 і 8     і ?  і <>b ?   і -
BIT 0,C      і CB 41      і 2 і 8     і ?  і <>b ?   і -
BIT 0,D      і CB 42      і 2 і 8     і ?  і <>b ?   і -
BIT 0,E      і CB 43      і 2 і 8     і ?  і <>b ?   і -
BIT 0,H      і CB 44      і 2 і 8     і ?  і <>b ?   і -
BIT 0,L      і CB 45      і 2 і 8     і ?  і <>b ?   і -
BIT 1,(HL)   і CB 4E      і 2 і 12    і ?  і <>b ?   і -
BIT 1,(IX+d) і CB DD 4E d і 4 і 20    і ?  і <>b ?   і -
BIT 1,(IY+d) і CB FD 4E d і 4 і 20    і ?  і <>b ?   і -
BIT 1,A      і CB 1F      і 2 і 8     і ?  і <>b ?   і -
BIT 1,B      і CB 48      і 2 і 8     і ?  і <>b ?   і -
BIT 1,C      і CB 49      і 2 і 8     і ?  і <>b ?   і -
BIT 1,D      і CB 4A      і 2 і 8     і ?  і <>b ?   і -
BIT 1,E      і CB 4B      і 2 і 8     і ?  і <>b ?   і -
BIT 1,H      і CB 4C      і 2 і 8     і ?  і <>b ?   і -
BIT 1,L      і CB 4D      і 2 і 8     і ?  і <>b ?   і -
BIT 2,(HL)   і CB 56      і 2 і 12    і ?  і <>b ?   і -
BIT 2,(IY+d) і CB FD 56 d і 4 і 20    і ?  і <>b ?   і -
BIT 2,(LY+d) і CB DD 56 d і 4 і 20    і ?  і <>b ?   і -
BIT 2,A      і CB 57      і 2 і 8     і ?  і <>b ?   і -
BIT 2,B      і CB 50      і 2 і 8     і ?  і <>b ?   і -
BIT 2,C      і CB 51      і 2 і 8     і ?  і <>b ?   і -
BIT 2,D      і CB 52      і 2 і 8     і ?  і <>b ?   і -
BIT 2,E      і CB 53      і 2 і 8     і ?  і <>b ?   і -
BIT 2,H      і CB 54      і 2 і 8     і ?  і <>b ?   і -
BIT 2,L      і CB 55      і 2 і 8     і ?  і <>b ?   і -
BIT 3,(HL)   і CB 5E      і 2 і 12    і ?  і <>b ?   і -
BIT 3,(IX+d) і CB DD 5E d і 4 і 20    і ?  і <>b ?   і -
BIT 3,(IY+d) і CB FD 5E d і 4 і 20    і ?  і <>b ?   і -
BIT 3,A      і CB 5F      і 2 і 8     і ?  і <>b ?   і -
BIT 3,B      і CB 58      і 2 і 8     і ?  і <>b ?   і -
BIT 3,C      і CB 59      і 2 і 8     і ?  і <>b ?   і -
BIT 3,D      і CB 5A      і 2 і 8     і ?  і <>b ?   і -
BIT 3,E      і CB 5B      і 2 і 8     і ?  і <>b ?   і -
BIT 3,H      і CB 5C      і 2 і 8     і ?  і <>b ?   і -
BIT 3,L      і CB 5D      і 2 і 8     і ?  і <>b ?   і -
BIT 4,(HL)   і CB 66      і 2 і 12    і ?  і <>b ?   і -
BIT 4,(IY+d) і CB FD 66 d і 4 і 20    і ?  і <>b ?   і -
BIT 4,(LY+d) і CB DD 66 d і 4 і 20    і ?  і <>b ?   і -
BIT 4,A      і CB 67      і 2 і 8     і ?  і <>b ?   і -
BIT 4,B      і CB 60      і 2 і 8     і ?  і <>b ?   і -
BIT 4,C      і CB 61      і 2 і 8     і ?  і <>b ?   і -
BIT 4,D      і CB 62      і 2 і 8     і ?  і <>b ?   і -
BIT 4,E      і CB 63      і 2 і 8     і ?  і <>b ?   і -
BIT 4,H      і CB 64      і 2 і 8     і ?  і <>b ?   і -
BIT 4,L      і CB 65      і 2 і 8     і ?  і <>b ?   і -
BIT 5,(HL)   і CB 6E      і 2 і 12    і ?  і <>b ?   і -
BIT 5,(IX+d) і CB DD 6E d і 4 і 20    і ?  і <>b ?   і -
BIT 5,(IY+d) і CB FD 6E d і 4 і 20    і ?  і <>b ?   і -
BIT 5,A      і CB 6F      і 2 і 8     і ?  і <>b ?   і -
BIT 5,B      і CB 68      і 2 і 8     і ?  і <>b ?   і -
BIT 5,C      і CB 69      і 2 і 8     і ?  і <>b ?   і -
BIT 5,D      і CB 6A      і 2 і 8     і ?  і <>b ?   і -
BIT 5,E      і CB 6B      і 2 і 8     і ?  і <>b ?   і -
BIT 5,H      і CB 6C      і 2 і 8     і ?  і <>b ?   і -
BIT 5,L      і CB 6D      і 2 і 8     і ?  і <>b ?   і -
BIT 6,(HL)   і CB 76      і 2 і 12    і ?  і <>b ?   і -
BIT 6,(IX+d) і CB DD 76 d і 4 і 20    і ?  і <>b ?   і -
BIT 6,(IY+d) і CB FD 76 d і 4 і 20    і ?  і <>b ?   і -
BIT 6,A      і CB 77      і 2 і 8     і ?  і <>b ?   і -
BIT 6,B      і CB 70      і 2 і 8     і ?  і <>b ?   і -
BIT 6,C      і CB 71      і 2 і 8     і ?  і <>b ?   і -
BIT 6,D      і CB 72      і 2 і 8     і ?  і <>b ?   і -
BIT 6,E      і CB 73      і 2 і 8     і ?  і <>b ?   і -
BIT 6,H      і CB 74      і 2 і 8     і ?  і <>b ?   і -
BIT 6,L      і CB 75      і 2 і 8     і ?  і <>b ?   і -
BIT 7,(HL)   і CB 7E      і 2 і 12    і ?  і <>b ?   і -
BIT 7,(IX+d) і CB DD 7E d і 4 і 20    і ?  і <>b ?   і -
BIT 7,(IY+d) і CB FD 7E d і 4 і 20    і ?  і <>b ?   і -
BIT 7,A      і CB 7F      і 2 і 8     і ?  і <>b ?   і -
BIT 7,B      і CB 78      і 2 і 8     і ?  і <>b ?   і -
BIT 7,C      і CB 79      і 2 і 8     і ?  і <>b ?   і -
BIT 7,D      і CB 7A      і 2 і 8     і ?  і <>b ?   і -
BIT 7,E      і CB 7B      і 2 і 8     і ?  і <>b ?   і -
BIT 7,H      і CB 7C      і 2 і 8     і ?  і <>b ?   і -
BIT 7,L      і CB 7D      і 2 і 8     і ?  і <>b ?   і -
CALL addr    і CD dr ad   і 3 і 17    і -  і - і -   і -
CALL c,addr  і DC dr ad   і 3 і t17f10і -  і - і -   і -
CALL m,addr  і FC dr ad   і 3 і t17f10і -  і - і -   і -
CALL nc,addr і D4 dr ad   і 3 і t17f10і -  і - і -   і -
CALL nz,addr і C4 dr ad   і 3 і t17f10і -  і - і -   і -
CALL p,addr  і F4 dr ad   і 3 і t17f10і -  і - і -   і -
CALL p<>,addrі E4 dr ad   і 3 і t17f10і -  і - і -   і -
CALL pe,addr і EC dr ad   і 3 і t17f10і -  і - і -   і -
CALL z,addr  і CC dr ad   і 3 і t17f10і -  і - і -   і -
CCF          і 3F         і 1 і 4     і -  і - і -   і x
CP (HL)      і BE         і 1 і 7     і =7 і = і v   і <
CP (IX+d)    і DD BE d    і 3 і 19    і =7 і = і v   і <
CP (IY+d)    і FD BE d    і 3 і 19    і =7 і = і v   і <
CP A         і BF         і 1 і 4     і =7 і = і v   і <
CP B         і B8         і 1 і 4     і =7 і = і v   і <
CP C         і B9         і 1 і 4     і =7 і = і v   і <
CP D         і BA         і 1 і 4     і =7 і = і v   і <
CP E         і BB         і 1 і 4     і =7 і = і v   і <
CP H         і BC         і 1 і 4     і =7 і = і v   і <
CP HIX       і DD BC      і 2 і 8     і =7 і = і v   і <
CP HIY       і FD BC      і 2 і 8     і =7 і = і v   і <
CP L         і BD         і 1 і 4     і =7 і = і v   і c
CP LIX       і DD BD      і 2 і 8     і =7 і = і v   і <
CP LIY       і FD BD      і 2 і 8     і =7 і = і v   і <
CP n         і FE n       і 2 і 7     і =7 і = і v   і <
CPD          і ED A9      і 2 і 16    і ?  і =Aі BC  і -
CPDR         і ED B9      і 2 і =16#21і ?  і =Aі BC  і -
CPI          і ED A1      і 2 і 16    і ?  і =Aі BC  і -
CPIR         і ED B2      і 2 і =16#21і ?  і =Aі BC  і -
CPL          і 2F         і 1 і 4     і -  і - і -   і -
DAA          і 27         і 1 і 4     і 7  і z і p   і c
DEC (HL)     і 35         і 1 і 11    і 7  і z і v   і -
DEC (IX+d)   і DD 35 d    і 3 і 23    і 7  і z і v   і -
DEC (IY+d)   і FD 35 d    і 3 і 23    і 7  і z і v   і -
DEC A        і 3D         і 1 і 4     і 7  і z і v   і -
DEC B        і 05         і 1 і 4     і 7  і z і v   і -
DEC BC       і 0B         і 1 і 6     і -  і - і -   і -
DEC C        і 0D         і 1 і 4     і 7  і z і v   і -
DEC D        і 15         і 1 і 4     і 7  і z і v   і -
DEC DE       і 1B         і I і 6     і -  і - і -   і -
DEC E        і 1D         і 1 і 4     і 7  і z і v   і -
DEC H        і 25         і 1 і 4     і 7  і z і v   і -
DEC HIX      і DD 25      і 2 і 8     і 7  і z і v   і -
DEC HIY      і FD 25      і 2 і 8     і 7  і z і v   і -
DEC HL       і 2B         і 1 і 6     і -  і - і -   і -
DEC IX       і DD 2B      і 2 і 10    і -  і - і -   і -
DEC IY       і FD 2B      і 2 і 10    і -  і - і -   і -
DEC L        і 2D         і 1 і 4     і 7  і z і v   і -
DEC LIX      і DD 2D      і 2 і 8     і 7  і z і v   і -
DEC LIY      і FD 2D      і 2 і 8     і 7  і z і v   і -
DEC SP       і 3B         і 1 і 6     і -  і - і -   і -
DI           і F3         і 1 і 4     і -  і - і -   і -
DJNZ d       і 10 d       і 2 і t13f8 і -  і - і -   і -
EI           і FB         і 1 і 4     і -  і - і -   і -
EX (SP),HL   і E3         і 1 і 19    і -  і - і -   і -
EX (SP),IX   і DD E3      і 2 і 23    і -  і - і -   і -
EX (SP),IY   і FD E3      і 2 і 23    і -  і - і -   і -
EX AF,AF'    і 08         і 1 і 4     і s' і z'і p'  і c'
EX DE,HL     і EB         і 1 і 4     і -  і - і -   і -
EXX          і D9         і 1 і 4     і -  і - і -   і -
HALT         і 76         і 1 і min 4 і -  і - і -   і -
IM 0         і ED 46      і 2 і 8     і -  і - і -   і -
IM 1         і ED 56      і 2 і 8     і -  і - і -   і -
IM 2         і ED 5E      і 2 і 8     і -  і - і -   і -
IN A,(C)     і ED 78      і 2 і 12    і 7  і z і p   і 0
IN A,(n)     і DB n       і 2 і 11    і -  і - і -   і -
IN B,(C)     і ED 40      і 2 і 12    і 7  і z і p   і 0
IN C,(C)     і ED 48      і 2 і 12    і 7  і z і p   і 0
IN D,(C)     і ED 50      і 2 і 12    і 7  і z і p   і 0
IN E,(C)     і ED 58      і 2 і 12    і 7  і z і p   і 0
IN H,(C)     і ED 60      і 2 і 12    і 7  і z і p   і 0
IN L,(C)     і ED 68      і 2 і 12    і 7  і z і p   і 0
INC (HL)     і 34         і 1 і 11    і 7  і z і v   і -
INC (IX+d)   і DD 34 d    і 3 і 23    і 7  і z і v   і -
INC (IY+d)   і FD 34 d    і 3 і 23    і 7  і z і v   і -
INC A        і 3C         і 1 і 4     і 7  і z і v   і -
INC B        і 04         і 1 і 4     і 7  і z і v   і -
INC BC       і 03         і 1 і 6     і -  і - і -   і -
INC C        і 0C         і 1 і 4     і 7  і z і v   і -
INC D        і 14         і 1 і 4     і 7  і z і v   і -
INC DE       і 13         і 1 і 6     і -  і - і -   і -
INC E        і 1C         і 1 і 4     і 7  і z і v   і -
INC H        і 24         і 1 і 4     і 7  і z і v   і -
INC HIX      і DD 24      і 2 і 8     і 7  і z і v   і -
INC HIY      і FD 24      і 2 і 8     і 7  і z і v   і -
INC HL       і 23         і 1 і 6     і -  і - і -   і -
INC IX       і DD 23      і 2 і 10    і -  і - і -   і -
INC IY       і FD 23      і 2 і 10    і -  і - і -   і -
INC L        і 2C         і 1 і 4     і 7  і z і v   і -
INC LIX      і DD 2C      і 2 і 8     і 7  і z і v   і -
INC LIY      і FD 2C      і 2 і 8     і 7  і z і v   і -
INC SP       і 33         і 1 і 6     і -  і - і -   і -
IND          і ED AA      і 2 і 16    і ?  і <>B ?   і -
INDR         і ED BA      і 2 і z16nz21 ?  і 1 і ?   і -
INI          і ED A2      і 2 і 16    і ?  і <>B ?   і -
INIR         і ED B2      і 2 і z16nz21 ?  і 1 і ?   і -
JP (HL)      і E9         і 1 і 4     і -  і - і -   і -
JP (IX)      і DD E9      і 2 і 8     і -  і - і -   і -
JP (IY)      і FD E9      і 2 і 8     і -  і - і -   і -
JP addr      і C3 dr ad   і 3 і 10    і -  і - і -   і -
JP c,addr    і DA dr ad   і 3 і 10    і -  і - і -   і -
JP m,addr    і FA dr ad   і 3 і 10    і -  і - і -   і -
JP nc,addr   і D2 dr ad   і 3 і 10    і -  і - і -   і -
JP nz,addr   і C2 dr ad   і 3 і 10    і -  і - і -   і -
JP p,addr    і F2 dr ad   і 3 і 10    і -  і - і -   і -
JP p<>,addr  і E2 dr ad   і 3 і 10    і -  і - і -   і -
JP pe,addr   і EA dr ad   і 3 і 10    і -  і - і -   і -
JP z,addr    і CA dr ad   і 3 і 10    і -  і - і -   і -
JR c,d       і 38 d       і 2 і t12f7 і -  і - і -   і -
JR d         і 18 d       і 2 і 12    і -  і - і -   і -
JR nc,d      і 30 d       і 2 і t12f7 і -  і - і -   і -
JR nz,d      і 20 d       і 2 і t12f7 і -  і - і -   і -
JR z,d       і 28 d       і 2 і t12f7 і -  і - і -   і -
LD (addr),A  і 32 dr ad   і 3 і 13    і -  і - і -   і -
LD (addr),BC і ED 43 dr adі 4 і 20    і -  і - і -   і -
LD (addr),DE і ED 53 dr adі 4 і 20    і -  і - і -   і -
LD (addr),HL і 22 dr ad   і 3 і 16    і -  і - і -   і -
LD (addr),HL і ED 63 dr adі 4 і 20    і -  і - і -   і -
LD (addr),IX і DD 22 dr adі 4 і 20    і -  і - і -   і -
LD (addr),IY і FD 22 dr adі 4 і 20    і -  і - і -   і -
LD (addr),SP і ED 73 dr adі 4 і 20    і -  і - і -   і -
LD (BC),A    і 02         і 1 і 7     і -  і - і -   і -
LD (DE),A    і 12         і 1 і 7     і -  і - і -   і -
LD (HL),A    і 77         і 1 і 7     і -  і - і -   і -
LD (HL),A    і 77         і 1 і 7     і -  і - і -   і -
LD (HL),B    і 70         і 1 і 7     і -  і - і -   і -
LD (HL),C    і 71         і 1 і 7     і -  і - і -   і -
LD (HL),D    і 72         і 1 і 7     і -  і - і -   і -
LD (HL),E    і 73         і 1 і 7     і -  і - і -   і -
LD (HL),H    і 74         і 1 і 7     і -  і - і -   і -
LD (HL),L    і 75         і 1 і 7     і -  і - і -   і -
LD (HL),n    і 36 n       і 2 і 10    і -  і - і -   і -
LD (IX+d),A  і DD 77 d    і 3 і 19    і -  і - і -   і -
LD (IX+d),B  і DD 70 d    і 3 і 19    і -  і - і -   і -
LD (IX+d),C  і DD 71 d    і 3 і 19    і -  і - і -   і -
LD (IX+d),D  і DD 72 d    і 3 і 19    і -  і - і -   і -
LD (IX+d),E  і DD 73 d    і 3 і 19    і -  і - і -   і -
LD (IX+d),H  і DD 71 d    і 3 і 19    і -  і - і -   і -
LD (IX+d),L  і DD 75 d    і 3 і 19    і -  і - і -   і -
LD (IX+d),n  і DD 36 d n  і 4 і 19    і -  і - і -   і -
LD (IY+d),A  і FD 77 d    і 3 і 19    і -  і - і -   і -
LD (IY+d),B  і FD 70 d    і 3 і 19    і -  і - і -   і -
LD (IY+d),C  і FD 71 d    і 3 і 19    і -  і - і -   і -
LD (IY+d),D  і FD 72 d    і 3 і 19    і -  і - і -   і -
LD (IY+d),E  і FD 73 d    і 3 і 19    і -  і - і -   і -
LD (IY+d),H  і FD 74 d    і 3 і 19    і -  і - і -   і -
LD (IY+d),L  і FD 75 d    і 3 і 19    і -  і - і -   і -
LD (IY+d),n  і FD 36 d n  і 4 і 19    і -  і - і -   і -
LD A,(addr)  і 3A dr ad   і 3 і 13    і -  і - і -   і -
LD A,(BC)    і 0A         і 1 і 7     і -  і - і -   і -
LD A,(DE)    і 1A         і 1 і 7     і -  і - і -   і -
LD A,(HL)    і 7E         і 1 і 7     і -  і - і -   і -
LD A,(HL)    і 7E         і 1 і 7     і -  і - і -   і -
LD A,(IX+d)  і DD 7E d    і 3 і 19    і -  і - і -   і -
LD A,(IY+d)  і FD 7E d    і 3 і 19    і -  і - і -   і -
LD A,A       і 7F         і 1 і 4     і -  і - і -   і -
LD A,B       і 78         і 1 і 4     і -  і - і -   і -
LD A,C       і 79         і 1 і 4     і -  і - і -   і -
LD A,D       і 7A         і 1 і 4     і -  і - і -   і -
LD A,E       і 7B         і 1 і 4     і -  і - і -   і -
LD A,H       і 7C         і 1 і 4     і -  і - і -   і -
LD A,HIX     і DD 7C      і 2 і 8     і -  і - і -   і -
LD A,HIY     і FD 7C      і 2 і 8     і -  і - і -   і -
LD A,I       і ED 57      і 2 і 9     і 7  і z і i   і 0
LD A,L       і 7D         і 1 і 4     і -  і - і -   і -
LD A,LIX     і DD 7D      і 2 і 8     і -  і - і -   і -
LD A,LIY     і FD 7D      і 2 і 8     і -  і - і -   і -
LD A,n       і 3E n       і 2 і 7     і -  і - і -   і -
LD A,R       і ED 5F      і 2 і 9     і 7  і z і i   і 0
LD B,(HL)    і 46         і 1 і 7     і -  і - і -   і -
LD B,(IX+d)  і DD 46 d    і 3 і 19    і -  і - і -   і -
LD B,(IY+d)  і FD 46 d    і 3 і 19    і -  і - і -   і -
LD B,A       і 47         і 1 і 4     і -  і - і -   і -
LD B,B       і 40         і 1 і 4     і -  і - і -   і -
LD B,C       і 41         і 1 і 4     і -  і - і -   і -
LD B,D       і 42         і 1 і 4     і -  і - і -   і -
LD B,E       і 43         і 1 і 4     і -  і - і -   і -
LD B,H       і 44         і 1 і 4     і -  і - і -   і -
LD B,HIX     і DD 44      і 2 і 8     і -  і - і -   і -
LD B,HIY     і FD 44      і 2 і 8     і -  і - і -   і -
LD B,L       і 45         і 1 і 4     і -  і - і -   і -
LD B,LIX     і DD 45      і 2 і 8     і -  і - і -   і -
LD B,LIY     і FD 45      і 2 і 8     і -  і - і -   і -
LD B,n       і 06 n       і 2 і 7     і -  і - і -   і -
LD BC,(addr) і ED 4B dr adі 4 і 20    і -  і - і -   і -
LD BC,hilo   і 01 lo hi   і 3 і 10    і -  і - і -   і -
LD C,(HL)    і 4E         і 1 і 7     і -  і - і -   і -
LD C,(IX+d)  і DD 4E d    і 3 і 19    і -  і - і -   і -
LD C,(IY+d)  і DD 4E d    і 3 і 19    і -  і - і -   і -
LD C,A       і 4F         і 1 і 4     і -  і - і -   і -
LD C,B       і 48         і 1 і 4     і -  і - і -   і -
LD C,C       і 49         і 1 і 1     і -  і - і -   і -
LD C,D       і 4A         і 1 і 1     і -  і - і -   і -
LD C,E       і 4B         і 1 і 4     і -  і - і -   і -
LD C,H       і 4C         і 1 і 4     і -  і - і -   і -
LD C,HIX     і DD 4C      і 2 і 8     і -  і - і -   і -
LD C,HIY     і FD 4C      і 2 і 8     і -  і - і -   і -
LD C,L       і 4D         і 1 і 4     і -  і - і -   і -
LD C,LIX     і DD 4D      і 2 і 8     і -  і - і -   і -
LD C,LIY     і FD 4D      і 2 і 8     і -  і - і -   і -
LD C,n       і 0E n       і 2 і 7     і -  і - і -   і -
LD D,(HL)    і 56         і 1 і 7     і -  і - і -   і -
LD D,(IX+d)  і DD 56 d    і 3 і 19    і -  і - і -   і -
LD D,(IY+d)  і FD 56 d    і 3 і 19    і -  і - і -   і -
LD D,A       і 57         і 1 і 4     і -  і - і -   і -
LD D,B       і 50         і 1 і 4     і -  і - і -   і -
LD D,C       і 51         і 1 і 4     і -  і - і -   і -
LD D,D       і 52         і 1 і 4     і -  і - і -   і -
LD D,E       і 53         і 1 і 4     і -  і - і -   і -
LD D,H       і 54         і 1 і 4     і -  і - і -   і -
LD D,HIX     і DD 54      і 2 і 8     і -  і - і -   і -
LD D,HIY     і FD 54      і 2 і 8     і -  і - і -   і -
LD D,L       і 55         і 1 і 4     і -  і - і -   і -
LD D,LIX     і DD 55      і 2 і 8     і -  і - і -   і -
LD D,LIY     і FD 55      і 2 і 8     і -  і - і -   і -
LD D,n       і 16 n       і 2 і 7     і -  і - і -   і -
LD DE,(addr) і ED 5B dr adі 4 і 20    і -  і - і -   і -
LD DE,hilo   і 11 lo hi   і 3 і 10    і -  і - і -   і -
LD E,(HL)    і 5E         і 1 і 7     і -  і - і -   і -
LD E,(IX+d)  і DD 5E d    і 3 і 19    і -  і - і -   і -
LD E,(IY+d)  і FD 5E d    і 3 і 19    і -  і - і -   і -
LD E,A       і 5F         і 1 і 4     і -  і - і -   і -
LD E,B       і 58         і 1 і 4     і -  і - і -   і -
LD E,C       і 59         і 1 і 4     і -  і - і -   і -
LD E,D       і 5A         і 1 і 4     і -  і - і -   і -
LD E,E       і 5B         і 1 і 4     і -  і - і -   і -
LD E,H       і 5C         і 1 і 4     і -  і - і -   і -
LD E,HIX     і DD 5C      і 2 і 8     і -  і - і -   і -
LD E,HIY     і FD 5C      і 2 і 8     і -  і - і -   і -
LD E,L       і 5D         і 1 і 4     і -  і - і -   і -
LD E,LIX     і DD 5D      і 2 і 8     і -  і - і -   і -
LD E,LIY     і FD 5D      і 2 і 8     і -  і - і -   і -
LD E,n       і 1E n       і 2 і 7     і -  і - і -   і -
LD H,(HL)    і 66         і 1 і 7     і -  і - і -   і -
LD H,(IX+d)  і DD 66 d    і 3 і 19    і -  і - і -   і -
LD H,(IY+d)  і FD 66 d    і 3 і 19    і -  і - і -   і -
LD H,A       і 67         і 1 і 4     і -  і - і -   і -
LD H,B       і 60         і 1 і 4     і -  і - і -   і -
LD H,C       і 61         і 1 і 4     і -  і - і -   і -
LD H,D       і 62         і 1 і 4     і -  і - і -   і -
LD H,E       і 63         і 1 і 4     і -  і - і -   і -
LD H,H       і 64         і 1 і 4     і -  і - і -   і -
LD H,L       і 65         і 1 і 4     і -  і - і -   і -
LD H,n       і 26 n       і 2 і 7     і -  і - і -   і -
LD HIX,A     і DD 67      і 2 і 8     і -  і - і -   і -
LD HIX,B     і DD 60      і 2 і 8     і -  і - і -   і -
LD HIX,C     і DD 61      і 2 і 8     і -  і - і -   і -
LD HIX,D     і DD 62      і 2 і 8     і -  і - і -   і -
LD HIX,E     і DD 63      і 2 і 8     і -  і - і -   і -
LD HIX,HIX   і DD 64      і 2 і 8     і -  і - і -   і -
LD HIX,LIX   і DD 65      і 2 і 8     і -  і - і -   і -
LD HIX,n     і DD 26 n    і 3 і 11    і -  і - і -   і -
LD HIY,A     і FD 67      і 2 і 8     і -  і - і -   і -
LD HIY,B     і FD 60      і 2 і 8     і -  і - і -   і -
LD HIY,C     і FD 61      і 2 і 8     і -  і - і -   і -
LD HIY,D     і FD 62      і 2 і 8     і -  і - і -   і -
LD HIY,E     і FD 63      і 2 і 8     і -  і - і -   і -
LD HIY,HIY   і FD 64      і 2 і 8     і -  і - і -   і -
LD HIY,LIY   і FD 65      і 2 і 8     і -  і - і -   і -
LD HIY,n     і FD 26 n    і 3 і 11    і -  і - і -   і -
LD HL,(addr) і 2A dr ad   і 3 і 16    і -  і - і -   і -
LD HL,(addr) і ED 6B dr adі 4 і 20    і -  і - і -   і -
LD HL,hilo   і 21 lo hi   і 3 і 10    і -  і - і -   і -
LD I,A       і ED 47      і 2 і 9     і -  і - і -   і -
LD IX,(addr) і DD 2A dr adі 4 і 20    і -  і - і -   і -
LD IX,hilo   і DD 2A lo hiі 4 і 14    і -  і - і -   і -
LD IY,(addr) і FD 2A dr adі 4 і 20    і -  і - і -   і -
LD IY,hilo   і FD 21 lo hiі 4 і 14    і -  і - і -   і -
LD L,(HL)    і 6E         і 1 і 7     і -  і - і -   і -
LD L,(IX+d)  і DD 6E d    і 3 і 19    і -  і - і -   і -
LD L,(IY+d)  і FD 6E d    і 3 і 19    і -  і - і -   і -
LD L,A       і 6F         і 1 і 4     і -  і - і -   і -
LD L,B       і 68         і 1 і 4     і -  і - і -   і -
LD L,C       і 69         і 1 і 4     і -  і - і -   і -
LD L,D       і 6A         і 1 і 4     і -  і - і -   і -
LD L,E       і 6B         і 1 і 4     і -  і - і -   і -
LD L,H       і 6C         і 1 і 4     і -  і - і -   і -
LD L,L       і 6D         і 1 і 4     і -  і - і -   і -
LD L,n       і 2E n       і 2 і 7     і -  і - і -   і -
LD LIX,A     і DD 6F      і 2 і 8     і -  і - і -   і -
LD LIX,B     і DD 68      і 2 і 8     і -  і - і -   і -
LD LIX,C     і DD 69      і 2 і 8     і -  і - і -   і -
LD LIX,D     і DD 6A      і 2 і 8     і -  і - і -   і -
LD LIX,E     і DD 6B      і 2 і 8     і -  і - і -   і -
LD LIX,HIX   і DD 6C      і 2 і 8     і -  і - і -   і -
LD LIX,LIX   і DD 6D      і 2 і 8     і -  і - і -   і -
LD LIX,n     і DD 2E n    і 3 і 11    і -  і - і -   і -
LD LIY,A     і FD 6F      і 2 і 8     і -  і - і -   і -
LD LIY,B     і FD 68      і 2 і 8     і -  і - і -   і -
LD LIY,C     і FD 69      і 2 і 8     і -  і - і -   і -
LD LIY,D     і FD 6A      і 2 і 8     і -  і - і -   і -
LD LIY,E     і FD 6B      і 2 і 8     і -  і - і -   і -
LD LIY,HIY   і FD 6C      і 2 і 8     і -  і - і -   і -
LD LIY,LIY   і FD 6D      і 2 і 8     і -  і - і -   і -
LD LIY,n     і FD 2E n    і 3 і 11    і -  і - і -   і -
LD R,A       і ED 4F      і 2 і 9     і -  і - і -   і -
LD SP,(addr) і ED 7B dr adі 4 і 20    і -  і - і -   і -
LD SP,hilo   і 31 lo hi   і 3 і 10    і -  і - і -   і -
LD SP,HL     і F9         і 1 і 6     і -  і - і -   і -
LD SP,IX     і DD F9      і 2 і 10    і -  і - і -   і -
LD SP,IY     і FD F9      і 2 і 10    і -  і - і -   і -
LDD          і ED A8      і 2 і 16    і -  і - і BC  і -
LDDR         і ED B8      і 2 і z16nz21 -  і - і 0   і -
LDI          і ED A0      і 2 і 16    і -  і - і BC  і -
LDIR         і ED B0      і 2 і zI6nz21 -  і - і 0   і -
NEG          і ED 44      і 2 і 8     і 7  і z і A80 і A0
NOP          і 00         і 1 і 4     і -  і - і -   і -
OR (HL)      і B6         і 1 і 7     і 7  і z і P   і 0
OR (IX+d)    і DD B6 d    і 3 і 19    і 7  і z і p   і 0
OR (IY+d)    і FD B6 d    і 3 і 19    і 7  і z і p   і 0
OR A         і B7         і 1 і 4     і 7  і z і p   і 0
OR B         і B0         і 1 і 4     і 7  і z і p   і 0
OR C         і B1         і 1 і 4     і 7  і z і p   і 0
OR D         і B2         і 1 і 4     і 7  і z і p   і 0
OR E         і B3         і 1 і 4     і 7  і z і p   і 0
OR H         і B4         і 1 і 4     і 7  і z і p   і 0
OR HIX       і DD B4      і 2 і 8     і 7  і z і p   і 0
OR HIY       і FD B4      і 2 і 8     і 7  і z і p   і 0
OR L         і B5         і 1 і 4     і 7  і z і p   і 0
OR LIX       і DD B5      і 2 і 8     і 7  і z і p   і 0
OR LIY       і FD B5      і 2 і 8     і 7  і z і p   і 0
OR n         і F6 n       і 2 і 7     і 7  і z і p   і 0
OTDR         і ED BB      і 2 і z16nz21 ?  і 1 і ?   і -
OTIR         і ED B3      і 2 і zI6nz21 ?  і I і ?   і -
OUT (C),A    і ED 79      і 2 і 12    і -  і - і -   і -
OUT (C),B    і ED 41      і 2 і 12    і -  і - і -   і -
OUT (C),C    і ED 49      і 2 і 12    і -  і - і -   і -
OUT (C),D    і ED 51      і 2 і 12    і -  і - і -   і -
OUT (C),E    і ED 59      і 2 і 12    і -  і - і -   і -
OUT (C),H    і ED 61      і 2 і 12    і -  і - і -   і -
OUT (C),L    і ED 69      і 2 і 12    і -  і - і -   і -
OUT (n),A    і D3 n       і 2 і 11    і -  і - і -   і -
OUTD         і ED AB      і 2 і 16    і ?  і <>B ?   і -
OUTI         і ED A3      і 2 і 16    і ?  і <>B ?   і -
POP AF       і F1         і 1 і 10    і [POP flags]  і
POP BC       і C1         і 1 і 10    і -  і - і -   і -
POP DE       і D1         і 1 і 10    і -  і - і -   і -
POP HL       і E1         і 1 і 10    і -  і - і -   і -
POP IX       і DD E1      і 2 і 14    і -  і - і -   і -
POP IY       і FD E1      і 2 і 14    і -  і - і -   і -
PUSH AF      і F5         і 1 і 11    і -  і - і -   і -
PUSH BC      і C5         і 1 і 11    і -  і - і -   і -
PUSH DE      і D5         і 1 і 11    і -  і - і -   і -
PUSH HL      і E5         і 1 і 11    і -  і - і -   і -
PUSH IX      і DD E5      і 2 і 15    і -  і - і -   і -
PUSH IY      і FD E5      і 2 і 15    і -  і - і -   і -
RES 0,(HL)   і CB 86      і 2 і 15    і -  і - і -   і -
RES 0,(IX+d) і DD CB d 86 і 4 і 23    і -  і - і -   і -
RES 0,(IY+d) і FD CB d 86 і 4 і 23    і -  і - і -   і -
RES 0,A      і CB 87      і 2 і 8     і -  і - і -   і -
RES 0,B      і CB 80      і 2 і 8     і -  і - і -   і -
RES 0,C      і CB 81      і 2 і 8     і -  і - і -   і -
RES 0,D      і CB 82      і 2 і 8     і -  і - і -   і -
RES 0,E      і CB 83      і 2 і 8     і -  і - і -   і -
RES 0,H      і CB 81      і 2 і 8     і -  і - і -   і -
RES 0,L      і CB 85      і 2 і 8     і -  і - і -   і -
RES 1,(HL)   і CB 8E      і 2 і 15    і -  і - і -   і -
RES 1,(IX+d) і DD CB d 8E і 4 і 23    і -  і - і -   і -
RES 1,(IY+d) і FD CB d 8E і 4 і 23    і -  і - і -   і -
RES 1,A      і CB 8F      і 2 і 8     і -  і - і -   і -
RES 1,B      і CB 88      і 2 і 8     і -  і - і -   і -
RES 1,C      і CB 89      і 2 і 8     і -  і - і -   і -
RES 1,D      і CB 8A      і 2 і 8     і -  і - і -   і -
RES 1,E      і CB 8B      і 2 і 8     і -  і - і -   і -
RES 1,H      і CB 8C      і 2 і 8     і -  і - і -   і -
RES 1,L      і CB 8D      і 2 і 8     і -  і - і -   і -
RES 2,(HL)   і CB 96      і 2 і 15    і -  і - і -   і -
RES 2,(IX+d) і DD CB d 96 і 4 і 23    і -  і - і -   і -
RES 2,(IY+d) і FD CB d 96 і 4 і 23    і -  і - і -   і -
RES 2,A      і CB 97      і 2 і 8     і -  і - і -   і -
RES 2,B      і CB 90      і 2 і 8     і -  і - і -   і -
RES 2,C      і CB 91      і 2 і 8     і -  і - і -   і -
RES 2,D      і CB 92      і 2 і 8     і -  і - і -   і -
RES 2,E      і CB 93      і 2 і 8     і -  і - і -   і -
RES 2,H      і CB 94      і 2 і 8     і -  і - і -   і -
RES 2,L      і CB 95      і 2 і 8     і -  і - і -   і -
RES 3,(HL)   і CB 9E      і 2 і 15    і -  і - і -   і -
RES 3,(IX+d) і DD CB d 9E і 4 і 23    і -  і - і -   і -
RES 3,(IY+d) і FD CB d 9E і 4 і 23    і -  і - і -   і -
RES 3,A      і CB 9F      і 2 і 8     і -  і - і -   і -
RES 3,B      і CB 98      і 2 і 8     і -  і - і -   і -
RES 3,C      і CB 99      і 2 і 8     і -  і - і -   і -
RES 3,D      і CB 9A      і 2 і 8     і -  і - і -   і -
RES 3,E      і CB 9B      і 2 і 8     і -  і - і -   і -
RES 3,H      і CB 9C      і 2 і 8     і -  і - і -   і -
RES 3,L      і CB 9D      і 2 і 8     і -  і - і -   і -
RES 4,(HL)   і CB A6      і 2 і 15    і -  і - і -   і -
RES 4,(IX+d) і DD CB d A6 і 4 і 23    і -  і - і -   і -
RES 4,(IY+d) і FD CB d A6 і 4 і 23    і -  і - і -   і -
RES 4,A      і CB A7      і 2 і 8     і -  і - і -   і -
RES 4,B      і CB A0      і 2 і 8     і -  і - і -   і -
RES 4,C      і CB A1      і 2 і 8     і -  і - і -   і -
RES 4,D      і CB A2      і 2 і 8     і -  і - і -   і -
RES 4,E      і CB A3      і 2 і 8     і -  і - і -   і -
RES 4,H      і CB A4      і 2 і 8     і -  і - і -   і -
RES 4,L      і CB A5      і 2 і 8     і -  і - і -   і -
RES 5,(HL)   і CB AE      і 2 і 15    і -  і - і -   і -
RES 5,(IX+d) і DD CB d AE і 4 і 23    і -  і - і -   і -
RES 5,(IY+d) і FD CB d AE і 4 і 23    і -  і - і -   і -
RES 5,A      і CB AF      і 2 і 8     і -  і - і -   і -
RES 5,B      і CB A8      і 2 і 8     і -  і - і -   і -
RES 5,C      і CB A9      і 2 і 8     і -  і - і -   і -
RES 5,D      і CB AA      і 2 і 8     і -  і - і -   і -
RES 5,E      і CB AB      і 2 і 8     і -  і - і -   і -
RES 5,H      і CB AC      і 2 і 8     і -  і - і -   і -
RES 5,L      і CB AD      і 2 і 8     і -  і - і -   і -
RES 6,(HL)   і CB B6      і 2 і 15    і -  і - і -   і -
RES 6,(IX+d) і DD CB d B6 і 4 і 23    і -  і - і -   і -
RES 6,(IY+d) і FD CB d B6 і 4 і 23    і -  і - і -   і -
RES 6,A      і CB B7      і 2 і 8     і -  і - і -   і -
RES 6,B      і CB B0      і 2 і 8     і -  і - і -   і -
RES 6,C      і CB B1      і 2 і 8     і -  і - і -   і -
RES 6,D      і CB B2      і 2 і 8     і -  і - і -   і -
RES 6,E      і CB B3      і 2 і 8     і -  і - і -   і -
RES 6,H      і CB B4      і 2 і 8     і -  і - і -   і -
RES 6,L      і CB B5      і 2 і 8     і -  і - і -   і -
RES 7,(HL)   і CB BE      і 2 і 15    і -  і - і -   і -
RES 7,(IX+d) і DD CB d BE і 4 і 23    і -  і - і -   і -
RES 7,(IY+d) і FD CB d BE і 4 і 23    і -  і - і -   і -
RES 7,A      і CB BF      і 2 і 8     і -  і - і -   і -
RES 7,B      і CB B8      і 2 і 8     і -  і - і -   і -
RES 7,C      і CB B9      і 2 і 8     і -  і - і -   і -
RES 7,D      і CB BA      і 2 і 8     і -  і - і -   і -
RES 7,E      і CB BB      і 2 і 8     і -  і - і -   і -
RES 7,H      і CB BC      і 2 і 8     і -  і - і -   і -
RES 7,L      і CB BD      і 2 і 8     і -  і - і -   і -
RET          і C9         і 1 і 10    і -  і - і -   і -
RET C        і D8         і 1 і t11f8 і -  і - і -   і -
RET M        і F8         і 1 і t11f8 і -  і - і -   і -
RET NC       і D0         і 1 і t11f8 і -  і - і -   і -
RET NZ       і C0         і 1 і t11f8 і -  і - і -   і -
RET P        і F0         і 1 і t11f8 і -  і - і -   і -
RET PE       і E8         і 1 і t11f8 і -  і - і -   і -
RET PO       і E0         і 1 і t11f8 і -  і - і -   і -
RET Z        і C8         і 1 і t11f8 і -  і - і -   і -
RETI         і ED 4D      і 2 і 14    і -  і - і -   і -
RETN         і ED 45      і 2 і 14    і -  і - і -   і -
RL (HL)      і CB 16      і 2 і 15    і 7  і z і p   і r7
RL (IX+d)    і DD CB d 16 і 4 і 23    і 7  і z і p   і r7
RL (IY+d)    і FD CB d 16 і 4 і 23    і 7  і z і p   і r7
RL A         і CB 17      і 2 і 8     і 7  і z і p   і r7
RL B         і CB 10      і 2 і 8     і 7  і z і p   і r7
RL C         і CB 11      і 2 і 8     і 7  і z і p   і r7
RL D         і CB 12      і 2 і 8     і 7  і z і p   і r7
RL E         і CB 13      і 2 і 8     і 7  і z і p   і r7
RL H         і CB 14      і 2 і 8     і 7  і z і p   і r7
RL L         і CB 15      і 2 і 8     і 7  і z і p   і r7
RLA          і 17         і 1 і 4     і -  і - і -   і r7
RLC (HL)     і CB 06      і 2 і 15    і 7  і z і p   і r7
RLC (IX+d)   і DD CB d 06 і 4 і 23    і 7  і z і p   і r7
RLC (IY+d)   і FD CB d 06 і 4 і 23    і 7  і z і p   і r7
RLC A        і CB 07      і 2 і 8     і 7  і z і p   і r7
RLC B        і CB 00      і 2 і 8     і 7  і z і p   і r7
RLC C        і CB 01      і 2 і 8     і 7  і z і p   і r7
RLC D        і CB 02      і 2 і 8     і 7  і z і p   і r7
RLC E        і CB 03      і 2 і 8     і 7  і z і p   і r7
RLC H        і CB 04      і 2 і 8     і 7  і z і p   і r7
RLC L        і CB 05      і 2 і 8     і 7  і z і p   і r7
RLCA         і 07         і 1 і 4     і -  і - і -   і r7
RLD          і ED 6F      і 2 і 18    і 7  і z і p   і -
RR (HL)      і CB 1E      і 2 і 15    і 7  і z і p   і r0
RR (IX+d)    і DD CB d 1E і 4 і 23    і 7  і z і p   і r0
RR (IY+d)    і FD CB d 1E і 4 і 23    і 7  і z і p   і r0
RR A         і CB 1F      і 2 і 8     і 7  і z і p   і r0
RR B         і CB 18      і 2 і 8     і 7  і z і p   і r0
RR C         і CB 19      і 2 і 8     і 7  і z і p   і r0
RR D         і CB 1A      і 2 і 8     і 7  і z і p   і r0
RR E         і CB 1B      і 2 і 8     і 7  і z і p   і r0
RR H         і CB 1C      і 2 і 8     і 7  і z і p   і r0
RR L         і CB 1D      і 2 і 8     і 7  і z і p   і r0
RRA          і 1F         і 1 і 4     і -  і - і -   і r0
RRC (HL)     і CB 0E      і 2 і 15    і 7  і z і p   і r0
RRC (IX+d)   і DD CB d 0E і 4 і 23    і 7  і z і p   і r0
RRC (IY+d)   і FD CB d 0E і 4 і 23    і 7  і z і p   і r0
RRC A        і CB 0F      і 2 і 8     і 7  і z і p   і r0
RRC B        і CB 08      і 2 і 8     і 7  і z і p   і r0
RRC C        і CB 09      і 2 і 8     і 7  і z і p   і r0
RRC D        і CB 0A      і 2 і 8     і 7  і z і p   і r0
RRC E        і CB 0B      і 2 і 8     і 7  і z і p   і r0
RRC H        і CB 0C      і 2 і 8     і 7  і z і p   і r0
RRC L        і CB 0D      і 2 і 8     і 7  і z і p   і r0
RRCA         і 0F         і 1 і 4     і -  і - і -   і r0
RRD          і ED 67      і 2 і 18    і 7  і z і p   і -
RST 0        і C7         і 1 і 11    і -  і - і -   і -
RST 1,addr   і CF dr ad   і 3 і (11)  і -  і - і -   і -
RST 2,addr   і D7 dr ad   і 3 і (11)  і -  і - і -   і -
RST 3,addr   і DF dr ad   і 3 і (11)  і -  і - і -   і -
RST 4        і E7         і 1 і 11    і -  і - і -   і -
RST 5,addr   і EF dr ad   і 3 і (11)  і -  і - і -   і -
RST 6        і F7         і 1 і 11    і -  і - і -   і -
RST 7        і FF         і 1 і 11    і -  і - і -   і -
SBC A,(HL)   і 9E         і 1 і 7     і 7  і z і v   і b
SBC A,(IX+d) і DD 9E d    і 3 і 19    і 7  і z і v   і b
SBC A,(IY+d) і FD 9E d    і 3 і 19    і 7  і z і v   і b
SBC A,A      і 9F         і 1 і 4     і 7  і z і v   і b
SBC A,B      і 98         і 1 і 4     і 7  і z і v   і b
SBC A,C      і 99         і 1 і 4     і 7  і z і v   і b
SBC A,D      і 9A         і 1 і 4     і 7  і z і v   і b
SBC A,E      і 9B         і 1 і 4     і 7  і z і v   і b
SBC A,H      і 9C         і 1 і 4     і 7  і z і v   і b
SBC A,HIX    і DD 9C      і 2 і 8     і 7  і z і v   і b
SBC A,HIY    і FD 9C      і 2 і 8     і 7  і z і v   і b
SBC A,L      і 9D         і 1 і 4     і 7  і z і v   і b
SBC A,LIX    і DD 9D      і 2 і 8     і 7  і z і v   і b
SBC A,LIY    і FD 9D      і 2 і 8     і 7  і z і v   і b
SBC A,n      і DE n       і 2 і 7     і 7  і z і v   і b
SBC HL,BC    і ED 42      і 2 і 15    і 15 і z і v   і b
SBC HL,DE    і ED 52      і 2 і 15    і 15 і z і v   і b
SBC HL,HL    і ED 62      і 2 і 15    і 15 і z і v   і b
SBC HL,SP    і ED 72      і 2 і 15    і 15 і z і v   і b
SCF          і 37         і 1 і 4     і -  і - і -   і 1
SET 0,(HL)   і CB C6      і 2 і 15    і -  і - і -   і -
SET 0,(IX+d) і DD CB d C6 і 4 і 23    і -  і - і -   і -
SET 0,(IY+d) і FD CB d C6 і 4 і 23    і -  і - і -   і -
SET 0,A      і CB C7      і 2 і 8     і -  і - і -   і -
SET 0,B      і CB C0      і 2 і 8     і -  і - і -   і -
SET 0,C      і CB C1      і 2 і 8     і -  і - і -   і -
SET 0,D      і CB C2      і 2 і 8     і -  і - і -   і -
SET 0,E      і CB C3      і 2 і 8     і -  і - і -   і -
SET 0,H      і CB C4      і 2 і 8     і -  і - і -   і -
SET 0,L      і CB C5      і 2 і 8     і -  і - і -   і -
SET 1,(HL)   і CB CE      і 2 і 15    і -  і - і -   і -
SET 1,(IX+d) і DD CB d CE і 4 і 23    і -  і - і -   і -
SET 1,(IY+d) і FD CB d CE і 4 і 23    і -  і - і -   і -
SET 1,A      і CB CF      і 2 і 8     і -  і - і -   і -
SET 1,B      і CB C8      і 2 і 8     і -  і - і -   і -
SET 1,C      і CB C9      і 2 і 8     і -  і - і -   і -
SET 1,D      і CB CA      і 2 і 8     і -  і - і -   і -
SET 1,E      і CB CB      і 2 і 8     і -  і - і -   і -
SET 1,H      і CB CC      і 2 і 8     і -  і - і -   і -
SET 1,L      і CB CD      і 2 і 8     і -  і - і -   і -
SET 2,(HL)   і CB D6      і 2 і 15    і -  і - і -   і -
SET 2,(IX+d) і DD CB d D6 і 4 і 23    і -  і - і -   і -
SET 2,(IY+d) і FD CB d D6 і 4 і 23    і -  і - і -   і -
SET 2,A      і CB D7      і 2 і 8     і -  і - і -   і -
SET 2,B      і CB D0      і 2 і 8     і -  і - і -   і -
SET 2,C      і CB D1      і 2 і 8     і -  і - і -   і -
SET 2,D      і CB D2      і 2 і 8     і -  і - і -   і -
SET 2,E      і CB D3      і 2 і 8     і -  і - і -   і -
SET 2,H      і CB D4      і 2 і 8     і -  і - і -   і -
SET 2,L      і CB D5      і 2 і 8     і -  і - і -   і -
SET 3,(HL)   і CB DE      і 2 і 15    і -  і - і -   і -
SET 3,(IX+d) і DD CB d DE і 4 і 23    і -  і - і -   і -
SET 3,(IY+d) і FD CB d DE і 4 і 23    і -  і - і -   і -
SET 3,A      і CB DF      і 2 і 8     і -  і - і -   і -
SET 3,B      і CB D8      і 2 і 8     і -  і - і -   і -
SET 3,C      і CB D9      і 2 і 8     і -  і - і -   і -
SET 3,D      і CB DA      і 2 і 8     і -  і - і -   і -
SET 3,E      і CB DB      і 2 і 8     і -  і - і -   і -
SET 3,H      і CB DC      і 2 і 8     і -  і - і -   і -
SET 3,L      і CB DD      і 2 і 8     і -  і - і -   і -
SET 4,(HL)   і CB E6      і 2 і 15    і -  і - і -   і -
SET 4,(IX+d) і DD CB d E6 і 4 і 23    і -  і - і -   і -
SET 4,(IY+d) і FD CB d E6 і 4 і 23    і -  і - і -   і -
SET 4,A      і CB E7      і 2 і 8     і -  і - і -   і -
SET 4,B      і CB E0      і 2 і 8     і -  і - і -   і -
SET 4,C      і CB E1      і 2 і 8     і -  і - і -   і -
SET 4,D      і CB E2      і 2 і 8     і -  і - і -   і -
SET 4,E      і CB E3      і 2 і 8     і -  і - і -   і -
SET 4,H      і CB E4      і 2 і 8     і -  і - і -   і -
SET 4,L      і CB E5      і 2 і 8     і -  і - і -   і -
SET 5,(HL)   і CB EE      і 2 і 15    і -  і - і -   і -
SET 5,(IX+d) і DD CB d EE і 4 і 23    і -  і - і -   і -
SET 5,(IY+d) і FD CB d EE і 4 і 23    і -  і - і -   і -
SET 5,A      і CB EF      і 2 і 8     і -  і - і -   і -
SET 5,B      і CB E8      і 2 і 8     і -  і - і -   і -
SET 5,C      і CB E9      і 2 і 8     і -  і - і -   і -
SET 5,D      і CB EA      і 2 і 8     і -  і - і -   і -
SET 5,E      і CB EB      і 2 і 8     і -  і - і -   і -
SET 5,H      і CB EC      і 2 і 8     і -  і - і -   і -
SET 5,L      і CB ED      і 2 і 8     і -  і - і -   і -
SET 6,(HL)   і CB F6      і 2 і 15    і -  і - і -   і -
SET 6,(IX+d) і DD CB d F6 і 4 і 23    і -  і - і -   і -
SET 6,(IY+d) і FD CB d F6 і 4 і 23    і -  і - і -   і -
SET 6,A      і CB F7      і 2 і 8     і -  і - і -   і -
SET 6,B      і CB F0      і 2 і 8     і -  і - і -   і -
SET 6,C      і CB F1      і 2 і 8     і -  і - і -   і -
SET 6,D      і CB F2      і 2 і 8     і -  і - і -   і -
SET 6,E      і CB F3      і 2 і 8     і -  і - і -   і -
SET 6,H      і CB F4      і 2 і 8     і -  і - і -   і -
SET 6,L      і CB F5      і 2 і 8     і -  і - і -   і -
SET 7,(HL)   і CB FE      і 2 і 15    і -  і - і -   і -
SET 7,(IX+d) і DD CB d FE і 4 і 23    і -  і - і -   і -
SET 7,(IY+d) і FD CB d FE і 4 і 23    і -  і - і -   і -
SET 7,A      і CB FF      і 2 і 8     і -  і - і -   і -
SET 7,B      і CB F8      і 2 і 8     і -  і - і -   і -
SET 7,C      і CB F9      і 2 і 8     і -  і - і -   і -
SET 7,D      і CB FA      і 2 і 8     і -  і - і -   і -
SET 7,E      і CB FB      і 2 і 8     і -  і - і -   і -
SET 7,H      і CB FC      і 2 і 8     і -  і - і -   і -
SET 7,L      і CB FD      і 2 і 8     і -  і - і -   і -
SLA (HL)     і CB 26      і 2 і 15    і 7  і z і p   і r7
SLA (IX+d)   і DD CB d 26 і 4 і 23    і 7  і z і p   і r7
SLA (IY+d)   і FD CB d 26 і 4 і 23    і 7  і z і p   і r7
SLA A        і CB 27      і 2 і 8     і 7  і z і p   і r7
SLA B        і CB 20      і 2 і 8     і 7  і z і p   і r7
SLA C        і CB 21      і 2 і 8     і 7  і z і p   і r7
SLA D        і CB 22      і 2 і 8     і 7  і z і p   і r7
SLA E        і CB 23      і 2 і 8     і 7  і z і p   і r7
SLA H        і CB 24      і 2 і 8     і 7  і z і p   і r7
SLA L        і CB 25      і 2 і 8     і 7  і z і p   і r7
SLL (HL)     і CB 36      і 2 і 15    і 7  і z і p   і r7
SLL (IX+d)   і DD CB d 36 і 4 і 23    і 7  і z і p   і r7
SLL (IY+d)   і FD CB d 36 і 4 і 23    і 7  і z і p   і r7
SLL A        і CB 37      і 2 і 8     і 7  і z і p   і r7
SLL B        і CB 30      і 2 і 8     і 7  і z і p   і r7
SLL C        і CB 31      і 2 і 8     і 7  і z і p   і r7
SLL D        і CB 32      і 2 і 8     і 7  і z і p   і r7
SLL E        і CB 33      і 2 і 8     і 7  і z і p   і r7
SLL H        і CB 34      і 2 і 8     і 7  і z і p   і r7
SLL L        і CB 35      і 2 і 8     і 7  і z і p   і r7
SRA (HL)     і CB 2E      і 2 і 15    і 7  і z і p   і r0
SRA (IX+d)   і DD CB d 2E і 4 і 23    і 7  і z і p   і r0
SRA (IY+d)   і FD CB d 2E і 4 і 23    і 7  і z і p   і r0
SRA A        і CB 2F      і 2 і 8     і 7  і z і p   і r0
SRA B        і CB 28      і 2 і 8     і 7  і z і p   і r0
SRA C        і CB 29      і 2 і 8     і 7  і z і p   і r0
SRA D        і CB 2A      і 2 і 8     і 7  і z і p   і r0
SRA E        і CB 2B      і 2 і 8     і 7  і z і p   і r0
SRA H        і CB 2C      і 2 і 8     і 7  і z і p   і r0
SRA L        і CB 2D      і 2 і 8     і 7  і z і p   і r0
SRL (HL)     і CB 3E      і 2 і 15    і 7  і z і p   і r0
SRL (IX+d)   і DD CB d 3E і 4 і 23    і 7  і z і p   і r0
SRL (IY+d)   і FD CB d 3E і 4 і 23    і 7  і z і p   і r0
SRL A        і CB 3F      і 2 і 8     і 7  і z і p   і r0
SRL B        і CB 38      і 2 і 8     і 7  і z і p   і r0
SRL C        і CB 39      і 2 і 8     і 7  і z і p   і r0
SRL D        і CB 3A      і 2 і 8     і 7  і z і p   і r0
SRL E        і CB 3B      і 2 і 8     і 7  і z і p   і r0
SRL H        і CB 3C      і 2 і 8     і 7  і z і p   і r0
SRL L        і CB 3D      і 2 і 8     і 7  і z і p   і r0
SUB (HL)     і 96         і 1 і 7     і 7  і z і v   і b
SUB (IX+d)   і DD 96 d    і 3 і 19    і 7  і z і v   і b
SUB (IY+d)   і FD 96 d    і 3 і 19    і 7  і z і v   і b
SUB A        і 97         і 1 і 4     і 7  і z і v   і b
SUB B        і 90         і 1 і 4     і 7  і z і v   і b
SUB C        і 91         і 1 і 4     і 7  і z і v   і b
SUB D        і 92         і 1 і 4     і 7  і z і v   і b
SUB E        і 93         і 1 і 4     і 7  і z і v   і b
SUB H        і 94         і 1 і 4     і 7  і z і v   і b
SUB HIX      і DD AC      і 2 і 8     і 7  і z і v   і b
SUB HIY      і FD AC      і 2 і 8     і 7  і z і v   і b
SUB L        і 95         і 1 і 4     і 7  і z і v   і b
SUB LIX      і DD AD      і 2 і 8     і 7  і z і v   і b
SUB LIY      і FD AD      і 2 і 8     і 7  і z і v   і b
SUB n        і D6 n       і 2 і 7     і 7  і z і v   і b
XOR (HL)     і AE *       і 1 і 7     і 7  і z і p   і 0
XOR (IX+d)   і DD AC d    і 3 і 19    і 7  і z і p   і 0
XOR (IY+d)   і FD AC d    і 3 і 19    і 7  і z і p   і 0
XOR A        і AF         і 1 і 4     і 7  і z і p   і 0
XOR B        і A8         і 1 і 4     і 7  і z і p   і 0
XOR C        і A9         і 1 і 4     і 7  і z і p   і 0
XOR D        і AA         і 1 і 4     і 7  і z і p   і 0
XOR E        і AB         і 1 і 4     і 7  і z і p   і 0
XOR H        і AC         і 1 і 4     і 7  і z і p   і 0
XOR HIX      і DD AC      і 2 і 8     і 7  і z і p   і 0
XOR HIY      і FD AD      і 2 і 8     і 7  і z і p   і 0
XOR L        і AD         і 1 і 4     і 7  і z і p   і 0
XOR LIX      і DD AC      і 2 і 8     і 7  і z і p   і 0
XOR LIY      і FD AD      і 2 і 8     і 7  і z і p   і 0
XOR n        і EE n       і 2 і 7     і 7  і z і p   і 0

* - the opcode given for XOR (HL) in the paper version of the guide is
      AC, the same as that given for XOR H.
    The code for XOR (HL) should be AE, according to Rodnay Zaks' book
      "PROGRAMMING THE Z80", (pub Sydex, ISBN 0-89588-069-5)

The flag register is bit significant, and is defined as follows:
bit 7 - Sign
    6 - Zero
    5 - unused
    4 - Half Carry (cannot test)
    3 - unused
    2 - Parity/Overflow
    1 - Add/Subtract (cannot test)
    0 - Carry


Snippets

To unerase files - Poke &A701 with &E5,  CAT the disc, and try to load
the file you want.  Save it back to  USER 0 if it loads correctly.  If
it fails to load, it is probably that it has already been written over
by another file.

To disable ESC - Poke &BDEE with  &C9.   To restore ESC, poke the same
address with &C3


The CRTC Registers

To change the value of these  registers, the register number should be
output on address &BCxx and then the data output on &BDxx

             Reg і Function               і Default value
             ДДДДЕДДДДДДДДДДДДДДДДДДДДДДДДЕДДДДДДДДДДДДДД
             R0  і Horizontal Total       і 63
             R1  і Horizontal Displayed   і 40
             R2  і Horizontal Sync Pos.   і 46
             R3  і Sync Width             і 112
             R4  і Vertical Total         і 38
             R5  і Vertical Total Adjust  і 0
             R6  і Vertical Displayed     і 25
             R7  і Vertical Sync Position і 30
             R8  і Interlace and Skew     і 0
             R9  і Maximum Raster Addr    і 7
             R10 і Cursor Start Raster    і 0
             R11 і Cursor End Raster      і 0
             R12 і Start Address (H)      і 48
             R13 і Start Address (L)      і 0
             R14 і Cursor Register (H)    і 192
             R15 і Cursor Register (L)    і 07