Blog from December, 2017

Fresh developer builds of OZ ROM
Gunther Strube posted on Dec 06, 2017

We provide automated builds of OZ ROM from /develop and /master branches, freshly generated per commit, see here: https://bitbucket.org/cambridge/oz/downloads/.

Binaries are built to work on 512K flash EPROM in either slot 0 or slot 1. For slot 1, hybrid cards with 512K RAM and 512K flash EPROM are needed.

The pre-made ROM binaries are archived in Zip files, containing ROM images for both slot 0 and 1. You no longer need to install Z88 Assembler Workbench build tools to get installable bleeding edge OZ ROM binaries.

These Zip files contains mostly developer snapshot and pre-releases. They are not considered public releases. Use them for testing and feedback to the development team.

After each commit, three zip files are generated:

       ozs0-<release>-<commitid>.zip     binaries for slot 0, 512K Flash internal chip target
       ozs1h-<release>-<commitid>.zip   binaries for slot 1, 512K Flash/RAM card target
       ozs1m-<release>-<commitid>.zip  binaries for slot 1, 1024K Flash card target

The following ROM releases are available:

ozsxx-master-<commitid>.zip (public stable releases, V4.7 and later)
ozsxx-develop-<commitid>.zip (beta development builds, V5.0 and later)
ozsxx-xxxxxx-<commitid>.zip (bleeding edge testing builds, V5.0 and later)

Unzip any selected archive and you will find the following structure of files (example):

oz.bin              ozs0-fde21e8.44     ozs1-fde21e8.53
oz.epr              ozs0-fde21e8.45     ozs1-fde21e8.54
ozs0-fde21e8.32     ozs0-fde21e8.46     ozs1-fde21e8.55
ozs0-fde21e8.33     ozs0-fde21e8.48     ozs1-fde21e8.56
ozs0-fde21e8.34     ozs0-fde21e8.49     ozs1-fde21e8.57
ozs0-fde21e8.35     ozs0-fde21e8.63     ozs1-fde21e8.58
ozs0-fde21e8.36     ozs0-fde21e8.upd    ozs1-fde21e8.59
ozs0-fde21e8.37     ozs1-fde21e8.32     ozs1-fde21e8.60
ozs0-fde21e8.38     ozs1-fde21e8.33     ozs1-fde21e8.61
ozs0-fde21e8.39     ozs1-fde21e8.47     ozs1-fde21e8.62
ozs0-fde21e8.40     ozs1-fde21e8.48     ozs1-fde21e8.63
ozs0-fde21e8.41     ozs1-fde21e8.50     ozs1-fde21e8.upd
ozs0-fde21e8.42     ozs1-fde21e8.51
ozs0-fde21e8.43     ozs1-fde21e8.52

oz.bin and oz.epr for OZvm emulator

Use oz.bin to load a ROM image in slot 0. Use oz.epr when you want to insert a 512K Flash/RAM card in slot 1.

ozs0-xxxx-.upd, ozs1h-xxxx- and ozs1m-xxxx-.upd files

Installation procedure for slot 0 or slot 1 (Cambridge Z88 with slot 0 using AMD 512K FLASH as ROM). Follow these steps:

OZ V4.7 or later must be running in slot 0 or slot 1 on your Cambridge Z88.

  1. Select the correct zip file to upload:-
    1. If an internal 512K Flash chip is used, unzip files from an ozs0-xxxx.zip file.
    2. If a 512K Flash/RAM card is used, unzip files from an ozs1h-xxxx.zip file.
    3. If a 1M Flash card is used, unzip files from an ozs1m-xxxx.zip file.
  2. unzip files on your desktop computer and put them in a Directory.
  3. Make sure that the Panel Default Device points to expanded RAM, typically :RAM.1 for 512K or :RAM.2 for 1M.
  4. Upload all the binaries (as above) files to default RAM on your Z88, using EazyLink2
  5. Put fresh batteries in your Z88 or use mains adapter when updating slot 0 ROM or flash card in slot 1
  6. From the INDEX execute the <>UPD command, it will automatically find the ozs0 or 1-XXXXX.upd file
  7. All binaries are CRC-32 checked if a supported 512K chip is found in slot 0 or slot 1.
  8. The Screen is turned off. Wait with patience for approx 1 min. The Z88 may soft reset and boot, if it doesn't after 3 minutes go to step 9.
  9. A popup and a bleep should display the updated OZ ROM commit release ID is displayed for slot 0 or slot 1. If it doesn't after 3 minutes go to step 10.
  10. Issue a hard reset and your Z88 is now running latest OZ from slot 0 or 1!

Using RomUpdate.bas

If the update procedure failed or you are running an older OZ ROM (OZ V4.6 or earlier) in slot 1 and have and earlier OZ in slot 1 on a flash card, use romupdate.bas on your Z88.

  1. Remove OZ ROM Card from slot 1, to slot 3, have expanded RAM in slot 1 or slot 0. Make sure that the Panel Default Device points to expanded RAM, typically :RAM.1
  2. Select the correct zip file to upload:-
    1. If an internal 512K Flash chip is used, unzip files from an ozs0-xxxx.zip file.
    2. If a 512K Flash/RAM card is used, unzip files from an ozs1h-xxxx.zip file.
    3. If a 1M Flash card is used, unzip files from an ozs1m-xxxx.zip file.
  3. upload this archive romupdate.zip utility
  4. unzip both sets of files on your desktop computer and put them in a Directory.
  5. Delete the existing romupdate.cfg file. This assumes the Flash update is in Slot 1 not Slot 3.
  6. With a text editor, edit ozs0-xxxx.upd or ozs1-xxxx.upd change the Slot number from 1 to 3
    1. CFG.V3
      ; OZ ROM for slot 1 and total of 23 banks to update.
      OZ.1,23
    2. CFG.V3
      ; OZ ROM for slot 3 and total of 23 banks to update.
      OZ.3,23
  7. Rename ozs0-xxxx.upd or ozs1-xxxx.upd to romupdate.cfg
  8. Upload all the binaries (as above) files to default RAM on your Z88, using EazyLink2
  9. Put fresh batteries in your Z88 or use mains adapter when updating slot 0 ROM or flash card in slot 1
  10. From the FILER execute the romupdate.cli file with <>EX command. The program will instruct what to do.
  11. The OZ card is then flashed in slot 3. The display may start to flash about - this is normal.
  12. After ROMupdate has completed put the updated flash card from slot 3 into slot 1 and RAM card in slot 2 (if you have one).
  13. Hard reset your Z88.

Now your Z88 is running latest OZ ROM either from slot 0 or slot 1!