Cambridge Z88 Files

                      ______ ___    ___
                     |___  // _ \  / _ \
                        / /| (_) || (_) |
                       / /  > _ <  > _ <
                      / /__| (_) || (_) |
                     /_____|\___/  \___/  _      _
        /\                               | |    | |
       /  \    ___  ___   ___  _ __ ___  | |__  | |  ___  _ __
      / /\ \  / __|/ __| / _ \| '_ ` _ \ | '_ \ | | / _ \| '__|
     / ____ \ \__ \\__ \|  __/| | | | | || |_) || ||  __/| |
    /_/    \_\|___/|___/ \___||_| |_| |_||_.__/ |_| \___||_|
  __          __           _     _                         _
  \ \        / /          | |   | |                       | |
   \ \  /\  / /___   _ __ | | __| |__    ___  _ __    ___ | |__
    \ \/  \/ // _ \ | '__|| |/ /| '_ \  / _ \| '_ \  / __|| '_ \
     \  /\  /| (_) || |   |   < | |_) ||  __/| | | || (__ | | | |
      \/  \/  \___/ |_|   |_|\_\|_.__/  \___||_| |_| \___||_| |_|


----------------------------------------------------------------------------
Cambridge Z88 Assembler Workbench Tools for "OZ" and application development
----------------------------------------------------------------------------

We have provided ready-made executable tools for Linux, Mac OS X and Windows
platforms, distributed under the terms of the GNU GPL v2 license.

The overall procedure is

1. Download appropriate software install for your platform
2. Execute the installer in a preferred location on your filing system
3. Follow the Readme, specific for each platform.

Mac OSX: Unzip Zip the archive first, then run the app installer.

Linux:
Apply executable permission on *.run files with chmod +x, then run ./xxx
Use the appropriate installer for either 32bit or 64 bit Linux.

Linux for Arm7hf:
Extract bzip2 archive, then run ./istall.sh script. It will install the 
tools in $HOME/bin/xxx. PATH is auto updated for shell environment.

Windows:
Two installers are available, Windows Xp (32bit) and Windows 7 (64bit)
The Windows7 version contains 64bit programs that runs on all later versions

The installers ensures that the PATH environment variable for the 'z88card'
and 'mpm' tools is set up for new command shell sessions.

Then, you can execute the tools from anywhere on your file system, so the 
compile scripts for OZ ROM and Z88 applications will work.

The AWB tools require git command line tool. Git must be installed separately 
on your desktop OS. Fetch from https://git-scm.com/


Source code is available at the following Git repositories:

https://bitbucket.org/cambridge/z88       (Z88 Applications and utilities)
https://bitbucket.org/cambridge/oz        ("OZ" - Cambridge Z88 ROM)
https://gitlab.com/bits4fun/mpm.git       (Z80 Assembler utility)
https://gitlab.com/bits4fun/dzasm.git     (Z80 Disassembler utility)
https://gitlab.com/z88/z88card.git        (Z88 Application Card Manager)
https://gitlab.com/z88/mthtoken.git       (Text compression for OZ MTH)