Cartridge Dumper 2.01
---------------------
(c) 2001 Jindroush
Latest version could be found at http://www.asw.cz/~kubecj


Purpose:
--------
Dumps cartridge content to disk (best virtual thru APE). There is need for
any device which intercepts cartridge mapping when using diskette version.


Usage (cartsave.atr):
---------------------
1) Boot the diskette.
2) 'Turn on' the cartridge.
3) If the cartridge is mapped in, first character on third line will turn
	into '!' characters.

TAB key selects left or right columns.
Arrows selects values.
Return saves banks.

In right column you can select:
1) Free mode. Only in this mode you can go left with TAB key. While in left
	column, you can use up and down arrows for changing the value which
	is stored in D5xx and use left and right arrow for changing the
	register. In free mode whole 8000-BFFF area is saved.

2) ROM8. Saves A000-BFFF area.

3) ROM16. Saves 8000-BFFF area.

4) XEGS. Tries to find the correct length of the cartridge. If it does, saves
	all the banks to the disk. If not, will report an error. The possible
	reasons are: it's blue XEGS cartridge, but it's only 16KB. Or it has
	some different bankswitching unknown to me.

5) OSS. Not working yet.

The resulting diskimage must be extracted by hand by person which knows the
format (only me :-)


Usage (casgen.atr):
-------------------
Boot the casgen.atr from APE. Insert empty cassette and save the dumper
program to it. Mark tape as usual.


Usage (taped CartSave program):
-------------------------------
1) Insert cartridge (computer must be off!)
2) Turn on computer while holding START key.
3) If there's a beep, that's good. If the cartridge boots, that's bad and
	such cartridge can't be dumped this way. If the cartridge allows
	diskette boot, use diskette version instead.
4) Boot the tape with the dumper.
5) Insert medium density ATR (133KB) into D1: of APE
6) The other steps are same as in the diskversion.


Known bugs:
-----------
Will not work on 400/800 computers. But, I you press the trigger on stick 3...

I've got one report, that it hangs while writing. I can't say why and I'm
also unable to repeat such result. I would recommend checking the SIO2PC
connection.

License:
--------
Permission to use, copy, modify, and distribute this program for any 
purpose is hereby granted without fee, subject to the following license:

1. Any copy or modification of this program must include the above
copyright notice and this license.

2. Jindroush makes no warranty or representation that the operation 
of the software will be error-free, and is under no obligation to 
provide any services, by way of maintenance, update, or otherwise.  

THE SOFTWARE AND ANY DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT EXPRESS 
OR IMPLIED WARRANTY INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT WILL 
JINDROUSH BE LIABLE FOR DIRECT, INCIDENTAL OR CONSEQUENTIAL DAMAGES, 
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.