
    ,o888888o.   8888888888',8888' `888b           ,8' ,8.       ,8.
 . 8888     `88.        ,8',8888' 8.`888b         ,8' ,888.     ,888.
,8 8888       `8b      ,8',8888'  `8.`888b       ,8' .`8888.   .`8888.
88 8888        `8b    ,8',8888'    `8.`888b     ,8' ,8.`8888. ,8.`8888.
88 8888         88   ,8',8888'      `8.`888b   ,8' ,8'8.`8888,8^8.`8888.
88 8888         88  ,8',8888'        `8.`888b ,8' ,8' `8.`8888' `8.`8888.
88 8888        ,8P ,8',8888'          `8.`888b8' ,8'   `8.`88'   `8.`8888.
`8 8888       ,8P ,8',8888'            `8.`888' ,8'     `8.`'     `8.`8888.
 ` 8888     ,88' ,8',8888'              `8.`8' ,8'       `8        `8.`8888.
    `8888888P'  ,8',8888888888888        `8.` ,8'         `         `8.`8888.



============================================================================
Introduction to OZvm - the Cambridge Z88 emulator
============================================================================

Why the "OZvm" name?

It is a combination of "OZ" - the name of the Cambridge Z88 operating system
and "vm" - the shortcut for virtual machine.

OZvm is principally a hardware emulation of the Cambridge Z88 portable
computer - a Z80 CPU system with 4Mb addressable memory, a monochrome 640x64
LCD and RS-232 serial port. It allows to install any ROM or application card
binary that also runs on a real Cambridge Z88.

OZvm is part of the Z88 Workbench tool-chain used to build software for the
Cambridge Z88. It has been implemented using Java SE V1.6 or later. You only
need to have latest Java Runtime installed on your desktop system. OZvm is
100% compatible with OpenJDK.

============================================================================
V1.2 Changelog
============================================================================

Release Notes - Z88 Emulator - "OZvm" - Version V1.2



** Bug
    * [OZVM-107] - Wrong OS_ API display in debug view
    * [OZVM-110] - When 512K/512K Flash/RAM card is removed, file size saved
                   is 1024K rather than 512K
    * [OZVM-116] - Keyboard layout is not correctly restored when snapshot
                   is loaded

** New Feature
    * [OZVM-59] - Add ability to control speed
    * [OZVM-100] - Emulate Battery Low Interrupt
    * [OZVM-103] - Optional display of the Rubber keyboard (save screen space)
    * [OZVM-108] - Pressing of both Z88 SHIFT keys via menu (and a via an
                   alternative function key)


** Task
    * [OZVM-99] - Add OZ v4.5 ROM and install as default when running OZvm
    * [OZVM-104] - Add OZ v4.6 ROM and install as default when running OZvm
    * [OZVM-120] - Add OZ V4.7 ROM and install as default when running OZvm

** Improvement
    * [OZVM-28]  - Revisit the Blink implementation and fix missing & relevant
                   interrupt implementations
    * [OZVM-76]  - Add new OZ V4.5 system calls to be recognized by
                   disassembler
    * [OZVM-94]  - Request for 'real-time' speed.
    * [OZVM-96]  - Default configuration persistance
    * [OZVM-97]  - Improve debug mode display
    * [OZVM-101] - Accidentally entered debugger - no obvious way to leave
    * [OZVM-102] - Make a copy of romupdate.cfg every time a card is removed
                   and files saved as 16K blocks.
    * [OZVM-111] - Display Java & system information in About popup
    * [OZVM-112] - Re-write keyboard scanning for multiple host keyboard
                   layouts
    * [OZVM-113] - Update disassembler for OZ v4.7 API
    * [OZVM-114] - Map F6 to press both Shift keys
    * [OZVM-115] - Preserve double screen size state in snapshot; center align
                   Gui windows
    * [OZVM-117] - Preserve new V1.2 settings in snapshot file
    * [OZVM-118] - Add the feature to reset Z88 Keyboard Matrix via Keyboard
                   menu
    * [OZVM-119] - Update disassembler for OZ v5.0 API


============================================================================
The OZvm Project resources
============================================================================
https://cambridgez88.jira.com/browse/OZVM          (Project issues)
https://cambridgez88.jira.com/wiki/display/OZVM    (Project wiki)
http://sourceforge.net/projects/z88/files/emulator (Latest releases)
https://cambridgez88.jira.com/wiki/                (Cambridge Z88 wiki)



============================================================================
Using the Desktop Installer for 32bit Linux and Windows
============================================================================
OZvm is available as a Desktop Installer available for Linux and Windows,
requiring no Java Runtime environment pre-installed. OZvm has been compiled
as a native application for Intel 32bit Linux and Windows OS using Excelsior
JET V7.6 (http://www.excelsior-usa.com). The Mac OS X version is a bundled
Java application that requires a JVM to be installed.

The installer will provide icons on your desktop for running the Cambridge
Z88 emulator.

Only V1.1 or later version are available as compiled binaries - earlier
releases are provided only as executable JAR files (JRE requirement).



============================================================================
Compiling OZvm
============================================================================
You can always check out the bleeding edge repository (see above) and
compile the latest version into a Java executable, a JAR file.

To compile the Java application you need the Java Runtime V1.6 Environment
installed on your desktop operating system.

To get OZvm compiled into an executable program on your operating system,
execute the makejar script:

    makejar.bat (or ./makejar.sh)

This will create the z88.jar executable Java file, z88.jar

Run OZvm with

    java -jar z88.jar

Windows users may create an EXE program (a Java JAR file wrapper). You need
to install Launch4J (http://launch4j.sourceforge.net/), and edit your PATH
environment variable to include the <launch4j install directory>. The
following script both compiles the Jar file and makes a z88.exe program:

    makeexe.bat



============================================================================
Register as a user with us, to follow or participate
============================================================================
All our work is GPV V2 licensed. Register with us (its completely free) and
follow our work. You're always welcome to participate, of course:

https://cambridgez88.jira.com/wiki

Your account details are only visible for registered users.
