
This disc contains all you need to make version 3.29 of the Perth keyboard
controller software. The files on this disc are as follows:-

    ak                - Obey file to make the object

    AAsm              - The ARM assembler, used just as a macro assembler.

    Hdr               - Directory containing header files.

        Def           - Source file defining symbols involving the
                        communication protocol between the ARM and the
                        keyboard controller.

        Hardware      - Source file defining symbols for (mainly)
                        hardware addresses specific to this application.

        Macros8051    - Source file defining macros which form the 8051
                        cross-assembler.

        SFRs          - Source file defining symbols for hardware addresses
                        applicable to any 8051 application (special function
                        registers).

    Kbd               - Main source file, consisting chiefly of 8051
                        instructions, assembled by means of AAsm macros.

    KbdTran           - Source file containing the translation table from
                        keyboard matrix addresses or PC keycodes into key
                        codes to be sent to the ARM. 
                        Also contains the tables which convert from the
                        mouse quadrature signals into X and Y mouse movements
                        (including hysteresis).

KbdObj                - The final object code.

ReadMe                - This document.

To make the image file, you need a machine running RISC OS 2.00 or later,
with at least 640K of free memory.
Assembly should be invoked from the * prompt, not via desktop/F12.
