Creating OZ

 

The Info screen showing build number

 

 

 

 

 

 

Info

Whether you already have a copy of OZ or not the instructions here has to assume that a new copy is made. You can only use the built-in OZ to create or update an existing copy of OZ.

Which version to use?

Users are able to download the version that the developers have issued or download the version that Rakewell supply which have these extra applications 

OZ 4.5 with extra programs screen1

OZ 4.5 with extra programs Screen 2

and these files in the file area.

Extra filles

to blow it into their own Flash cards.

There are two ways to upgrade your Flashcard

  1. Get in touch with Rakewell who offer the service of
    upgrading or supplying Flashcards pre-installed with OZ.
  2. Do it yourself

Prerequisites

Preparing the Z88

IMPORTANT INFO

The Z88 needs to be running off the internal OZ supplied with the Z88. To ensure that this happens all existing information on the Z88 will be lost after following this procedure. Backup any important files beforehand.

Note: Decision Time

Before you start, you need to decide whether to use the Imp-Export or Eazylink mode. If you choose Eazylink, then you will either have a 32K EPROM card, or it will be blown into the 512K/512K Flash RAM card. See the previous section Creating Eazylink/Flashstore.

Hard Reset

With no cards in the Z88 at all, give the Z88 a Hard Reset.

Open the card flap
Insert the cards in the following configurations:- 

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

Imp-Export Mode 512K

Imp-Export Mode 1M Flash cards

Eazylink Mode - ROM in Slot 1

Eazylink Mode - ROM in Slot 2

Eazylink Mode - ROM in Slot 2

Eazylink Mode - ROM in Slot 2 with Blank flash card in Slot 3

If the values shown in the RAM do not display these values, take all the cards out again give the Z88 a Hard Reset and go round the loop again until the values are correct.

Press  to return to the main screen.

Main INDEX Page

Set Default Device

Set the default device to the RAM that is being used by selecting the Panel S. Move the cursor 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 a 1.

RAM in slot 1

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.

Preparing the Desktop

Downloading Files

Download from the project file area the files needed to transfer to the Z88. If they are zipped, unzip all the files on the Desktop Computer and save them all in a directory.

Note - File name changes

 512K Flash512K Flash1M Flash
OZ 4.5
ozs1-90a181d
oz45exoz45ex
OZ 4.6.1
ozs1-eb06239
oz461exoz461ex
OZ 4.6.2   

The extension (i.e. .52 .53 ...) remain the same.

DO NOT USE

Rakewell's OZ 4.6.2 is currently being updated. Do NOT use 512K EXTRA or 1M EXTRA as this still contains OZ 4.6.1. WAIT until this message has been removed.

Download Location
  OZ V4.x Release Notes512K EXTRA1M EXTRA
 OZ 4.5OZ 4.5 EXTRA
 512K Flash512K Flash1M Flash
Files
Required 
 ozs1-90a181d.52
ozs1-90a181d.53
ozs1-90a181d.54
ozs1-90a181d.55
ozs1-90a181d.56
ozs1-90a181d.57
ozs1-90a181d.58
ozs1-90a181d.59
ozs1-90a181d.60
ozs1-90a181d.61
ozs1-90a181d.62
ozs1-90a181d.63
readme.txt
romupdate.bas
romupdate.cfg
romupdate.cli
romupdate.crc
oz45ex.32
oz45ex.33
oz45ex.34
oz45ex.35
oz45ex.36
oz45ex.47
oz45ex.48
oz45ex.49
oz45ex.50
oz45ex.51
oz45ex.52
oz45ex.53
oz45ex.54
oz45ex.55
oz45ex.56
oz45ex.57
oz45ex.58
oz45ex.59
oz45ex.60
oz45ex.61
oz45ex.62
oz45ex.63
romupdate.bas
romupdate.cfg
romupdate.cli
romupdate.crc

oz45ex.0
oz45ex.1
oz45ex.2
oz45ex.3
oz45ex.4
oz45ex.47
oz45ex.48
oz45ex.49
oz45ex.50
oz45ex.51
oz45ex.52
oz45ex.53
oz45ex.54
oz45ex.55
oz45ex.56
oz45ex.57
oz45ex.58
oz45ex.59
oz45ex.60
oz45ex.61
oz45ex.62
oz45ex.63
romupdate.bas
romupdate.cfg
romupdate.cli
romupdate.crc

Imp/Export20 minutes 45 seconds  
Eazylink8 minutes 55 seconds.  
OZ 4.5 + CRC5 minutes 28 seconds10 minutes 36 seconds 

Using Imp/Export Mode

Start Eazylink2.

If you want to use the Eazylink Mode, go to Using Eazylink Mode

For convenience This section has been copied from the Eazylink2 User Guide.

This can be difficult to do initially because Eazylink2 is expecting the pop-down to be running on the Z88. Just keep waiting until  you receive the Reading Z88 Devices Command Failed!

eazylink_hello_command_failed

Choose 'Ignore.'

What you really need to see is the Eazylink Menu not being greyed out.

Select the Directory to be used

Here is a picture of the blank screen you should see. The left-hand window (normally used to show the Z88 side) is not used in this Imp-Export Mode. The right-hand side window showing the Desktop side is used. Select which Directory is to be used here. The selection of the files are made in a different window later.

Send to the Z88

On the top menu bar, Select Z88

  • Select - Send files to Z88 Imp-Export popdown

If 'Show Details...' is selected, you will be presented with a help screen listing instructions (without the screen shots) on how to use the Z88. 

Send files to the Z88

1. Start Z88

2. Select Imp-Export X

Scroll down to the next instruction. 3.

the Imp-Export Menu will be displayed

Type 'b' and then press the  key.

Now you can click 'Yes' to 'Is Z88 ready?'

The Desktop will now display a window for you to select which file(s) to send.

Mark the desired files. These are:-

Note - File name changes

 512K Flash512K Flash1M Flash
OZ 4.5
ozs1-90a181d
oz45exoz45ex
OZ 4.6.1
ozs1-eb06239
oz461exoz461ex

The extension (i.e. .52 .53 ...) remain the same.

OZ 4.5OZ 4.5 EXTRA
512K Version
OZ 4.5 EXTRA
1M Version
 ozs1-90a181d.52
ozs1-90a181d.53
ozs1-90a181d.54
ozs1-90a181d.55
ozs1-90a181d.56
ozs1-90a181d.57
ozs1-90a181d.58
ozs1-90a181d.59
ozs1-90a181d.60
ozs1-90a181d.61
ozs1-90a181d.62
ozs1-90a181d.63
readme.txt
romupdate.bas
romupdate.cfg
romupdate.cli
romupdate.crc
oz45ex.32
oz45ex.33
oz45ex.34
oz45ex.35
oz45ex.36
oz45ex.47
oz45ex.48
oz45ex.49
oz45ex.50
oz45ex.51
oz45ex.52
oz45ex.53
oz45ex.54
oz45ex.55
oz45ex.56
oz45ex.57
oz45ex.58
oz45ex.59
oz45ex.60
oz45ex.61
oz45ex.62
oz45ex.63
romupdate.bas
romupdate.cfg
romupdate.cli
romupdate.crc

oz45ex.0
oz45ex.1
oz45ex.2
oz45ex.3
oz45ex.4
oz45ex.47
oz45ex.48
oz45ex.49
oz45ex.50
oz45ex.51
oz45ex.52
oz45ex.53
oz45ex.54
oz45ex.55
oz45ex.56
oz45ex.57
oz45ex.58
oz45ex.59
oz45ex.60
oz45ex.61
oz45ex.62
oz45ex.63
oz45ex1M.bin
romupdate.bas
romupdate.cfg
romupdate.cli
romupdate.crc

Note

There are more files sent than needed. This is the standard developers listing. Select all the files needed for slot 1 xxxxx.52 to xxxxx.63 and all the 'romupdate' files.

 Warnings will be given for invalid file-names selected. e.g. howto-install-oz.gif

Select the Z88's destination storage slot (in this case Slot 2).

After press OK the Z88 screen will show

Using remote name:  :RAM.1/the_filename
(Incrementing numbers on this row)
End of file

This will repeat itself until all the files are transferred.

Press  on the Z88 to return to the Imp-Export Menu.

Files are download on the desktop

RAM and Flashcards are set up

Eazylink is on the Z88

Using Eazylink Mode

For convenience This section has been copied from the Eazylink2 User Guide.

Start Eazylink2.

Start Screen

Here is a picture of the blank screen you should see. The left-hand window is used to show the files on Z88 side. There are no files on this Z88, hence the blank screen, but that will change soon.

Eazylink Main Screen

Running for the first time

Follow this procedure:-

Quick Menu

Most of the following commands can be selected from this menu. Select

EazyLink Hello

The first time Eazylink is connected to the Z88 the Com Port window is displayed. This can also be selected with the

Serial Port Settings

Get Serial Port Settings

Com Port Settings

An intelligent guess is made at which Serial Port is being used. Here is your chance to check that the correct one has been selected. In this case Windows is using COM 5.

 

If the Eazylink pop-down is running under OZ 4.5, selecting the "Use 38400 BPS High Speed Transfer" will enable this. 

Command Error

You may initially get this screen

eazylink_hello_command_failed

Choose 'Ignore.' and try again.

Select Z88 Device

As :RAM.1 is set as the Default Device on the Z88. :RAM.1 is selected. If the files are to be saved to a different device, select the Tab now.

The right-hand side window showing the Desktop side is used. There is a program that can be run to check that the connection is working correctly.

Eazylink Popdown Protocol Testing Program

This only works with the Eazylink popdown and is useful to check whether the hardware or USB to Serial ports are working as expected with the Z88. To use it, connect the Z88 to the Desktop and run the Eazylink popdown on the Z88.

It is selected from the Z88 Menu.

Select Protocol Popdown Testing ProgramProtocol Testing PASSFailed

A report is generated which should have all TRUE statements in it. An overall test message is displayed in the bottom left-hand corner.

If there are any FALSE statements, the test has FAILED. The serial port connection is not working correctly and help should be sought.

WARNING -No point going any further!

 

There is no point going any further until the protocol testing program passes all the tests. Go to Problem Solving Area to get some clues there.

Z88 Commands

Z88 Refresh

If the information received looks a bit suspect try using this command.

Z88 Refresh

Send files to the Z88

Z88 Select Device

As the Default Device was set to :RAM.1 on the Z88, this device is already selected. If a different device is required to save the files to, change it now by selecting a different tab.

Desktop Select Files

Select Desktop Files

In the Desktop window select the files to be transferred

Selection exceeds Device Size

Note: Notice missing file

 

Have you noticed that there is a file not marked in the list? This file is a 512K binary file for the complete space. If this was selected, there would not be RAM on the Z88 to store them. Before files are transferred, a calculation is made to check if there is enough space to save all the selected files. This is the message received (with different values) if there is not enough room.

Selection exceeds device size

Transfer Z88 <- Desk

Click on the "Select Transfer Z88 <- Desk" button

Top Menu

A prompt is given, just to make sure this is what you want to do.

Select No to save prompting,

Progress may be monitored viewing the bottom of the screen.

Progress

together with the speed of transfer and the full file name showing a very long directory tree.

Speed and Filename

At the end of this the following screen will be presented with the transferred files also shown on the Z88. 

18 files transferred

 

Upload all the files to :RAM.1

On the Z88

Using ROMupdate

Select Filer

1. Hold down the  key (at the bottom left of the keyboard) and press the F key, to enter Filer. 

Alternatively it may be selected by pressing the  key at the lower left of the keyboard and then using the  key, move the cursor down to the Filer application. 

Press  to select it.

Using 512K/512K Flash/RAM

Using 1M Flash

Add 1M Flash card in slot 3.

Select File

The file romupdate.cli needs to be selected. This file is one of the files downloaded and will displayed somewhere on the right-hand side window.

Move the cursor to the right using  key to get into that window and then the other cursor keys until the cursor is over that file name.

Select that file by pressing the  key.

Execute ROMupdate

Press EX to EXecute or move the cursor back to the left into the command window. then using the  key, move the cursor down until that command is displayed in the COMMANDS window, then press  to select it.

The .cli file will be EXecuted and will run the "romupdate.bas" program.

  • This program checks that the downloaded files are correct,

Select Slot 1

Sometimes the display looks corrupted

Sometimes the display looks corrupted. This is normal and you should just WAIT. Eventually you will see a HARD RESET and the Z88 will boot into the new copy of OZ created.


  • Displays "Select slot to write bank binaries ( to start writing):  1" Select 1 for the 512K/512K Flash/RAM card or 3 for the 1M.
  • Erases the Flash card selected slot 
  • blows the OZ ROM into the card

Romupdate end

  • finally, the card is inserted in slot 1 (if not already there), followed by a hard-reset issued by the Z88 user.
  • OZ in slot 1 is booted and is ready for use (original ROM in slot 0 is no longer running)

You can check that you have the correct version by selecting the  key and then the  cursor key to display the version screen as shown at the beginning.

IMPORTANT:

 You cannot blow the OZ ROM images to slot 1 if you're already running OZ in that slot.

Updating a Z88 with an internal Flash Chip

There may be some users out there that have a modified Z88 with an internal 512K Flash chip fitted. You can update an internal flash chip in a similar way to updating the external flash cards using ROMupdate.

Here is what you do.

1. Go to the release summary Release Summary
2. Chose the latest version (it is v4.6.1 at the time of writing this) OZ v4.6.1 Release Notes
3. Download the zip file using the download link located further down the page.
4. Unzip the files on your desktop computer
5. Before uploading the files to the Z88, make sure that the Panel Default Device points to expanded RAM, typically :RAM.1
6. Transfer the 13 binary files (ozs0-xxxxxxx.xx) and

romupdate.bas
romupdate-slot0.cfg
romupdate.cli
romupdate.crc

7. Rename romupdate-slot0.cfg to romupdate.cfg
8. From the FILER execute the "romupdate.cli" file with EX command.
9. The display will flash and do all sorts of things, this is normal, LEAVE IT ALONE AND WAIT...