U1timate 1MB/Incognito/1088XEL Firmware
=======================================

Copyright (c) 2015-2020 Jonathan Halliday <fjc@atari8.co.uk>

Please read LICENSE for licensing details. Visit atari8.co.uk/firmware/ for updates.


CONTENTS
========

In the archive you will find the following files, stand-alone and on the FIRMWARE.ATR disk images.

Files (U1MB/1088XEL):

FIRMWARE.ROM (64K firmware ROM to be flashed to 'Firmware' slot)
ULTIMATE.ROM (Complete 512K ROM, including 192K SpartaDOS X, WIP GOS, OS ROMs, BASIC ROMs, XEGS ROMs and firmware)
ULTNOGOS.ROM (Complete 512K ROM, including 320K SpartaDOS X, OS ROMs, BASIC ROMs, XEGS ROMs and firmware)
SDXUL192.ROM (192K SpartaDOS X ROM)
SDXUL256.ROM (256K SpartaDOS X ROM)
SDXUL320.ROM (320K SpartaDOS X ROM)
LICENSE
Loader changelog
Main BIOS changelog
PBI BIOS changelog
readme
UFLASH.XEX   (flashing tool)

Files (Incognito):

IBIOS.ROM       (Incognito main BIOS ROM)
ILOADER.ROM     (Incognito SIDE Loader ROM)
IPBI.ROM        (Incognito PBI BIOS ROM)
INCOG.ROM       (Complete 512K ROM, including 192K SpartaDOS X, WIP GOS, OS ROMs, BASIC ROMs, XEGS ROMs and firmware)
INNOGOS.ROM     (Complete 512K ROM, including 320K SpartaDOS X, OS ROMs, BASIC ROMs, XEGS ROMs and firmware)
SDXIN192.ROM    (192K SpartaDOS X ROM)
SDXIN256.ROM    (256K SpartaDOS X ROM)
SDXIN320.ROM    (320K SpartaDOS X ROM)
LICENSE
Loader changelog
Main BIOS changelog
PBI BIOS changelog
readme
UFLASH.XEX      (flashing tool)

FIRMWARE.ATR also includes a plugin folder, which contains the following U1MB plugins:

1088RAPP.ROM    (1088XEL/XLD Rapidus plugin)
1088XELP.ROM    (1088XEL/XLD default XEL-CF plugin)
CARTRSTP.ROM    (Cartridge reset plugin for U1MB; supports Covox, SIDE, Stereo POKEY)
RAPIDUSP.ROM    (Rapidus plugin for U1MB; supports Covox, SIDE, Stereo POKEY)
SIDEP.ROM       (Default U1MB plugin; supports Covox, SIDE, Stereo POKEY)
VGATECP.ROM     (Cartridge reset plugin for U1MB; supports VGate, Covox, SIDE, Stereo POKEY)
VGATEP.ROM      (VGate plugin for U1MB; supports Covox, SIDE, Stereo POKEY)
XELP.ROM        (Default 1088XEL/XLD plugin)
XELSIDEP.ROM    (1088XEL/XLD plugin with SIDE support instead of XEL-CF; users should also flash the standard U1MB SIDE Loader and SIDE PBI BIOS)

The SIDE/SIDE2 ROMs are distributed on ATRs whose naming convention follows the name of the ROM file:

Files (SIDE/SIDE2):

OSS.ROM         (SIDE Loader and four patched OSS language ROMs)
SDXSIDE.ROM     (SpartaDOS X ROM for SIDE)
SDXSIDE2.ROM    (SpartaDOS X ROM for SIDE2)
SIDELOAD.ROM    (SIDE Loader ROM for SIDE and SIDE2)
SIDE.ROM        (Complete 512K ROM for SIDE, including SpartaDOS X and SIDE Loader)
SIDE2.ROM       (Complete 512K ROM for SIDE2, including SpartaDOS X and SIDE Loader)
SIDEOSS.ROM     (Complete 512K ROM for SIDE, including SpartaDOS X, SIDE Loader and OSS ROMs)
SIDE2OSS.ROM    (Complete 512K ROM for SIDE2, including SpartaDOS X, SIDE Loader and OSS ROMs)
UFLASH.XEX      (flashing tool)

INSTALLATION NOTES
==================

FIRMWARE.ROM is a 64KB firmware image which you should flash to the 'Firmware' slot using UFLASH if you just want to update the firmware on its own and leave SDX, operating systems, etc, intact. Since the Incognito firmware cannot yet be bundled into a single file, it is supplied as three separate files: IBIOS.ROM, ILOADER.ROM and IPBI.ROM. These files should be flashed to the 'Main BIOS', 'Loader', and 'PBI BIOS' slots in the listed order.

ULTIMATE/ULTNOGOS.ROM and INCOG/INNOGOS.ROM are complete flash images with a selection of operating systems, BASIC ROMs, and either a 192KB version of SpartaDOS X and a demo of the WIP Graphical OS, or a 320KB version of SDX and no Graphical OS. Unless one is interested in testing the Graphical OS, the complete ROM with the 320KB SDX build is probably the most useful, since it preserves a complete set of MAN files on the CAR: device.

The rest of the ROMs (whose names begin 'SDX') are SpartaDOS X ROMs which include the APT FDISK partition editor and the LSDEV and LSDSK tools pre-installed on the CAR: volume. These same SDX ROMs are present in the 'complete' 512KB flash ROM images.

SIDE ROMs should be flashed after booting SDX from the cartridge (with the SIDE switch in the lower 'SDX' position). U1MB owners should disable the PBI HDD and turn off SpartaDOS X. 'Complete' ROMs should be flashed to the top slot (the name of the flash chip), SDX ROMs to the SpartaDOS X slot, and loader/OSS ROMs to the 'External Cartridge' slot.

INTELLECTUAL PROPERTY
=====================

Note that while the this firmware is closed-source freeware (as described in LICENSE), it includes a modified version of the GPL licensed High-Speed SIO driver by Matthias Reichl. Special permission was sought and granted to incorporate Matthias' code into this closed-source project. Matthias deserves creadit and recognition for his remarkable work in the area of high-speed SIO on the 8-bit Atari, and the 'alt' U1MB firmware is richer for the inclusion of his driver.

Aside from the aforementioned high-speed SIO driver and the customised SpartaDOS X ROMs included in the archive, all components are the wholly original work of the author and consititute a 'ground-up' rewrite of the original firmware. See the user manual and developers' technical documentation for further details.


ACKNOWLEDGEMENTS
================

As well as the aforementioned Hias, thanks to Micheal St Pierre, Marlin Bates, and everyone in the 1088XEL beta testers discussion. Thanks to Avery Lee, Marius Diepenhorst, Lotharek, Candle O'Sin, TheMontezuma, and many others for your vital contributions and support.


DONATIONS
=========

Since the amount of time required to develop and maintain this firmware is considerable (and at times unmanageable), donations are most welcome and may be made via www.paypal.me/flashjazzcat.


FEEDBACK
========

The author welcomes feedback, suggestions and bug reports.

Enjoy!



FJC April 2020

