Atarimax "Maxflash" Flash MultiCarts

Preliminary Documentation, 07/10/2003

©2003 Steven J Tucker

Important Notice!

The software described below has been superceded by the new Maxflash Studio software application.

This software is still supported for advanced users, but all new users should try the Maxflash Studio suite located here before attempting to use these programs and scripts.

Chapter 7: Emulator Support.

Table of Contents

  1. Introduction
  2. Changes to Atari800Win PLus 3.1
  3. Downloading the Emulator
  4. Running the Emulator
  5. Emulator Help
  6. Testing a -EXEPACKER (Multi-cart) or -MEMPACKER (A8S) Flash Cartridge image in the emulator.
  7. Testing a -DISKPACKER (Disk-cart) Flash Cartridge image in the emulator.

Introduction

MaxFlash cartridges images are fully supported by the Atari800Win Plus emulator supplied.

If you plan on making your own flash cart images, its recommended you always pre-test your images in the emulator first before burning them onto a real cartridge.

You can create a new flash cart image and test it in the emulator in just a few seconds. This saves a lot of time over testing images using the real cartridge.

While none of the Atari emulators are 100% perfect, you will be able to find out if you made any mistakes made during cartridge image creation pretty quickly.

Changes to Atari800Win PLus 3.1

The version of the Atari800WinPlus emulator provided here is derived from the version 3.1 sources and has the following features added.

Any changes to the original source code are provided under the same GNU license as the rest of the package.

See gpl.txt in each archive for a copy of the full GNU Public License.

Downloading the Emulator

The Atari800Win PLus emulator is GNU licensed software.

You can download here.

Running the Emulator

To run the emulator you will have to also download or dump a copy of the Atari 800 or XL/XE OS rom.

These ROMs are likely copyrighted and cannot be distributed with the GNU licensed emulator.

Search at Google for 800XL rom images.

Its probably only legal to download these ROMs if you actually own an Atari computer. Use your own judgment of course.

Emulator Help

I did not write the Atari800Win or PLus emulators and don't offer support for them, but you can get documentation and help at these web sites.

Web home of Atari800Win PLus

Web home of Atari800Win

Testing a -EXEPACKER (Multi-cart) or -MEMPACKER (A8S) Flash Cartridge image in the emulator

Setting Emulator Options

Start the modified Atari800Win emulator and select the following configuration.

Machine TypeXL/XE Recommended
Memory Type64k Recommended
Disable BASICENABLED
SIO Patchn/a
Video Systemn/a

Selecting the Cartridge Image

When you generate a flash cartridge image using the maxflash.pl script, you will get .bin and/or .car files as a result.

.bin files are raw, unwrapped binary images of the flash cartridge contents.

.car files are Atari800Win 'CART' images, which contain the raw binary image, a cartridge type identifier and a checksum.

To load the .bin or .car image, select the 'Atari' menu item, then 'ROM Images'. In the ROM Images dialog, press the 'Cartridge' button and select the target image.

If you select a .car image, Atari800Win will determine the correct cartridge size and type from the contents of the file. If you select a .bin image, you will be prompted to select the correct cartridge type.

To the right of the cartridge filename box there is a drop down box that will say either 'Detached' or 'Attached'. You need to 'attach' the cartridge before Atari800Win will use it. If this dialog says 'Detached' change it to 'Attached'.

For .bin images of 1Mb Flash Cartridges, select 'Atarimax 1Mb Flash Cartridge' from the drop down menu that will pop up after attaching the image.

Press 'OK' to return to the main emulator screen.

Starting the Cartridge

The default configuration of Atari800Win PLus is to restart emulation when a new cartridge image is attached.

You may need to coldstart the emulator to get it to start the cartridge, depending on your configuration. If nothing seems to happen after attaching the cartridge press Shift+F5 to coldstart the virtual Atari computer.

Testing a -DISKPACKER (Disk-cart) Flash Cartridge image in the emulator

Setting Emulator Options

Start the modified Atari800Win emulator and select the following configuration.

Machine TypeXL/XE REQUIRED
Memory Type64k REQUIRED
Disable BASICENABLED
SIO PatchDISABLED
Video Systemn/a

Selecting the Cartridge Image

When you generate a flash cartridge image using the maxflash.pl script, you will get .bin and/or .car files as a result.

.bin files are raw, unwrapped binary images of the flash cartridge contents.

.car files are Atari800Win 'CART' images, which contain the raw binary image, a cartridge type identifier and a checksum.

To load the .bin or .car image, select the 'Atari' menu item, then 'ROM Images'. In the ROM Images dialog, press the 'Cartridge' button and select the target image.

If you select a .car image, Atari800Win will determine the correct cartridge size and type from the contents of the file. If you select a .bin image, you will be prompted to select the correct cartridge type.

To the right of the cartridge filename box there is a drop down box that will say either 'Detached' or 'Attached'. You need to 'attach' the cartridge before Atari800Win will use it. If this dialog says 'Detached' change it to 'Attached'.

For .bin images of 1Mb Flash Cartridges, select 'Atarimax 1Mb Flash Cartridge' from the drop down menu that will pop up after attaching the image.

Press 'OK' to return to the main emulator screen.

Starting the Cartridge

The default configuration of Atari800Win PLus is to restart emulation when a new cartridge image is attached.

You may need to coldstart the emulator to get it to start the cartridge, depending on your configuration. If nothing seems to happen after attaching the cartridge press Shift+F5 to coldstart the virtual Atari computer.

If you get nothing but a buzz or a bright-white cursor after the virtual Atari restarts, go back and check that the 'SIO Patch' option is disabled in the Atari800Win configuration.