aboutsummaryrefslogtreecommitdiff
tmu45tools v0.0.2 - Tools for controlling tfhh's 512K SRAM memory
upgrade (v4.5), or the 576K 600XL upgrade (v2).

Atari .xex executables are available here:
- Zip file:  https://slackware.uk/~urchlay/repos/tmu45tools/plain/tmu45tools-0.0.2.zip
- ATR image: https://slackware.uk/~urchlay/repos/tmu45tools/plain/tmu45tools-0.0.2.atr

Information on the upgrade can be found at:
https://forums.atariage.com/topic/277204-some-new-not-really-hardware-made-by-tfhh/
http://www.van-radecke.de/SRAM/512_KB_SRAM_memory_expansion.pdf
http://www.van-radecke.de/STUFF/tfhh_HW_info.pdf

The original setmem.xex tool can be downloaded from:
http://www.van-radecke.de/SRAM/SETMEM.XEX

The source for these tools, including a reverse-engineered source for
SETMEM.XEX, can be found at https://slackware.uk/~urchlay/repos/tmu45tools

Usage: under "regular" Atari DOSes (Atari DOS 2.x, MyDOS, etc), use:

- UOFF.XEX to disable the memory upgrade.

- U256.XEX to put the upgrade in 256K/Compy-shop/XE mode (separate
ANTIC bank access).

- U512.XEX to put the upgrade in 512K/RAMBO mode (*no* separate ANTIC
bank access).

These can be run standalone, or they can be prepended to some other
executable. This is useful if e.g. you normally use RAMBO mode, but
have a few demos/games that require separate ANTIC access. In this
case, you'd make a copy of u256.xex, then append the game or demo to
that copy to create an executable that changes the upgrade's mode,
then loads/runs the game.

Note that it's a *terrible* idea to change the upgrade's mode while
a RAMdisk driver is loaded, especially if it's a 512KB RAMdisk
and you're changing to 256K mode! Even worse would be disabling the
upgrade... anyway there's no reason to change modes while a RAMdisk is
active. Software that uses the extra RAM already wouldn't work with a
RAMdisk, so you'd have to disable it anyway.

For SpartaDOS X users:

It's impossible to change the upgrade's mode under SDX without
crashing the OS. Instead of the above, use UOFFX.XEX, U256X.XEX,
U512X.XEX. These versions of the tools work the same as above, except
they reboot (coldstart) the Atari after changing the mode. Also, they
allow you to exit the tool without changing the mode or rebooting (to
avoid accidents). It should also go without saying that the "prepend
to a game" technique won't work with these.

Reverse-Logic:

The versions with "R" in the filename (U256R.XEX, U512R.XEX,
U256RX.XEX, U512RX.XEX) are intended for users whose SRAM upgrade has
"reverse logic", with the default mode being 256K/Compy-shop. The
"RX" ones are coldstart versions. Unless you specifically ordered the
upgrade like this, you don't need these (and you should probably just
delete them to avoid confusion). The prompts are all that's different
in the "R" versions, so you won't be missing anything useful.

SETMEM:

tf_hh's original SETMEM.XEX is included, too. Also included are
reverse-logic and coldstarting patched versions (SETMEMR.XEX,
SETMEMX.XEX, SETMEMRX.XEX). The original SETMEM.XEX crashes on exit
under SpartaDOS X, so the coldstart version should be useful there.

License:

The U*.XEX tools and their source are licensed under the WTFPL.

See http://www.wtfpl.net/txt/copying/ for details.

SETMEM.XEX and its patched versions SETMEMR.XEX, SETMEMX.XEX, and
SETMEMRX.XEX are the property of tf_hh. Since I can't find a license
or copyright notice for SETMEM.XEX, I have to assume it's proprietary
code.