Appendix I - Creating / Updating an Application Card

Preface

Z88 Applications

When the Z88 came out, there was no facility to 'Blow your own ROM,' This was because the Z88 Application software was supplied on an EPROM card. As larger EPROM cards became available, it was possible to make compilations but there were only a few people around who had the skills to link the applications together, writing addresses on the back of envelopes and using Hex calculators. This all changed when Garry Lancaster wrote ROMcombiner. This allowed users to combine applications themselves. When the Flash cards become available, blowing those were added, so for example, all the applications for the Z88 could be stored onto one 1M card.

Now that all the companies that wrote software for the Z88 are no longer marketing their products it is now possible to download the ROM image and blow your own.

Updating Applications and OZ

Updating Flash cards came next with ROMupdate. Fetching the new image from the internet and downloading to the Z88, allows users to update the applications and OZ versions themselves. From OZ 4.7 this facility was added, allowing the Z88 Operating System to update itself. 

Prerequisites

The Z88 needs to have the following cards as a minimum configuration.

128K

Slot 1 needs to have at least 128K and at least enough RAM to store the image.

128K is enough space to store Eazylink and Flashstore, but not enough to store an OZ update.

If you are running OZ 4.5 or above in slot 1, with 512K of RAM, that may enough RAM to store most images.

OZ 4.5 also has Eazylink installed on it so the additional Computer link pop-down may not be required.

Slot 2 may have another EPROM or Flash card with the Computer Link in it
A blank EPROM or Flash Card to store the applications or files.
(Optional) EPROM Eraser to erase the EPROM card (if required).

Connecting the Z88 to the Desktop to transfer the programs to the Z88.

See Computer Links for more details

Making an Eazylink/Flashstore ROM

If you have

  • 32K EPROM (this can be a MAC LINK or PC LINK card)
  • EPROM ERASER

consider building a copy of this first, so that you can use Eazylink to transfer the OZ image, see Creating Eazylink/Flashstore rather than using the slower Imp/Export pop-down.

If you unable to use a separate card, you can temporary use it in same flashcard that OZ will be in. The procedure would be:-

  • Save Eazylink ROM to the Flashcard
  • Download the Files to RAM
  • Delete the Eazylink image from the Flash card.
  • Save the OZ image from RAM to the Flash card.

Check List

Before doing a procedure like this it is prudent to do some preliminary checks.

Check RAM

To do these tests, please select the INDEX screen with either the  key or  I.

Main INDEX Page

If you have any extra RAM, the largest size you have should be used in Slot 1, unless you are running OZ 4.5 in which case it needs to be in Slot 2. This is to ensure that the Z88 "type" is an "Expanded Machine." This can be checked using the  INFO command.

info page

Depending on what configuration you have, the amount of RAM you have should be reflected in the following command. For example, if you had a 512K/512K Flash/RAM card running OZ4.5  in slot 1, 1M RAM in slot 2 and a 1M Flash card in slot 3.

In the INDEX check that the Z88 recognises the extra memory by giving the  CARD command. You should get the following result.

Card Display

Here are some other examples on a standard Z88.


If the values shown in the RAM do not display these values, Backup the Z88 and give the Z88 a Hard Reset.

and keep going around the loop again until the values are correct.

Press  to return to the main screen.

Index Diary

Check Default Device

Check that the default device to the RAM is correct by selecting the Panel S

Panel Default Device Slot 1

In this case the value of :RAM.1 is correct.

Press  to return to the main screen.

Index Diary

Set Default Device

Set the default device to the RAM that is being used by selecting the Panel S. Move the cursor down 3 lines () then to the end of the line () just past the 0 in :RAM.0 in the Default device field:-

Cursor just past 0

Press the  key

Delete the 0 in Default Device

and replace it with either a 1 or 2 depending which slot the RAM is in.

Select Device

Select the Filer   F . 

Press SV to Select deVice 

Move the cursor over to the right (using   , then press the  key to remove the number that is there, finally type in the RAM slot number 1 then press  to select it.

Getting the image

There are different ways of obtaining the image of an application.

  • Downloading
  • Writing your own

Download the Application

Z88 Applications are stored in 16K size files called banks. To keep these files together, they are stored in a zip file, which also compresses the collection. There are a number of steps that need to take place. These are:-

  • Download the zip file from the internet
  • Unzip the file either on the
    • Desktop or
    • Z88
  • Transfer either the zip or un-ziped files to the Z88
  • Run ROMcombiner or ROMupdate on the Z88 to blow the image into the Flash or EPROM.

The examples given here are

Application / Pop-down

Notes
Creating Eazylink/Flashstore

Use your 32K EPROM (this can be a MAC LINK or PC LINK card) and EPROM ERASER to build Eazylink fot transfer, rather than the slower Imp/Export route. Alternatively, use the Flash card temporarily, until the OZ image replaces it.

Creating OZ

Update your existing copy or build one from scratch.
Creating SpellMaster

An example of building a 3rd party software.

Writing your Own Application

If you're a developer, we have all you need too, just read the Developer's Notes on our wiki, https://cambridgez88.jira.com/wiki/display/DN/  (applies to all Z88 ROM releases, including OZ v4.5).