ACAtool

From IndividualComputers
Jump to: navigation, search


For the ACA1221lc, ACA1221ec and all versions of the ACA1233n, there is a new combined GUI and command line tool available, ACAtool.

Acatool unifies most functionality of the ACA12xx libraries and command line utilities (with the exception of ACAGov) under a single program that can be used from Workbench, command line and startup-sequence alike. It can save the configuration into the ACA1221lc's flash memory, and it lets you activate MapROM, including loading a Kickstart ROM file without losing valuable fast ram. ACAtool also lets you activate the IDE speeder of the ACA1221lc.

Contents

Installation

No installation required. The tool can be started from anywhere. On the ACA1233n the tool copies itself to C:acatool and updates itself there when needed.


Notes

  • Notes for the ACA1233n:

When you use the graphical user interface and click "Save to Startup-Sequence", the tool copies itself to C:acatool or updates itself there. The settings will be written into a command line for S:startup-sequence. The configuration will be read from this command line, too. During system boot, when you hold the left mouse button, acatool will skip the options in this command line.

  • Notes for the ACA1221lc, ACA1221ec:

When you use the graphical user interface and click "Save to Flash & Startup-Sequence", the settings will be stored in both the card's flash memory and in S:Startup-Sequence. Most settings are stored and applied in flash memory. MapROM can also be activated later in the startup-sequence, and a ROM file can only be activated there. The MapROM jumper on the ACA1221xx cards can now be removed, as it is more convenient to control MapROM features using acatool.

  • Notes for the ACA1211:

When you use the graphical user interface and click "Save to Flash & Startup-Sequence", the settings will be stored in both the card's flash memory and in S:Startup-Sequence. Most settings are stored and applied in flash memory, but a ROM file can only be activated in the startup-sequence.

  • Additional notes for the ACA1221ec:

Remember that the jumper needs to be set in the "Unprotect" position before changes can be written to the card's flash memory. In the "Unprotect" position the card starts with fewer memory and safe defaults, so the saved configuration is not reflected in the GUI. You will almost certainly want to remove the "Unprotect" jumper after saving the configuration. The jumper can be set and removed while the computer is turned on, e.g. on an ACA500+. But using the ACA1221ec's "Unprotect" jumper in an Amiga 1200 turned out to be an annoyance, so its meaning has been changed for the ACA1221lc (see below).

  • Additional notes for the ACA1221lc:

In contrast to the ACA1221ec, the jumper is no longer needed for saving the configuration. You will need the "Failsafe" jumper only in the very rare circumstance that the computer suffered a power outage or crash amidst writing the configuration to flash. In this extraordinary case, use the "Failsafe" jumper to start with safe settings. Then save the configuration. Remove the jumper afterwards.

  • Additional notes for all Amigas:

The VBRMOVE option's impact on performance is small, while its impact on compatibility with old software can be dramatic. Decide for yourself if this is worth it.

See below for command line usage.

Command line options

Option Description
I=INFO/S Show information
S=SETSPEED/K/N Set CPU speed step
C=CURRENTSPEED/S Get current CPU speed step
M=MAXSPEED/S Get maximum CPU speed step
L=LISTSPEEDS/S List available CPU speed steps
VBRON/S Move VBR to fastmem now
VBROFF/S Restore VBR now
MAPROM/S activate MapROM
ROMFILE/K ROM file to map instead of internal ROM
MM=MEMMODE/K/N CPU switch with 0=fastmem, 3=only chipmem
IM=IDEMODE/K/N IDE acceleration mode (0,1[,2])
FLASH/S Save configuration to flash:
VBRMOVE/S Move VBR to fastmem on boot
CPUSPEED/K/N CPU speed step to set on boot
NOKEEPPCMCIA/S Do not preserve PCMCIA memory range
FORCE/S Do not ask for confirmation
CPUOFF/S Switch off card CPU
CPUON/S Switch on card CPU
SKIPONLMB/S Exit when left mouse button is held
NOERRORS/S Do not return errors, just warnings
H=HELP/S Do not open GUI, show command overview
I=INFO/S Show information about the card (model, version, MapROM, speed).
S=SETSPEED/K/N Set the speed step setting.
C=CURRENTSPEED/S Get the current speed step setting.
M=MAXSPEED/S Get the maximum speed step setting.
L=LISTSPEEDS/S List all available speed seetings; the current speed is indicated by an asterisk.
VBRON/S Move the vector base to fast memory. This takes effect immediately. Returns 5 (WARN) if the vector base is already in fast memory.
VBROFF/S Move the vector base back to lower memory. This takes effect immediately. Returns 5 (WARN) if the vector base is already in lower memory.
MAPROM/S With this option, maps the computer's inbuilt ROM into the ACA card's fast memory. If MapROM is already active, returns with return value 5 (WARN). Returns an error if the ROM cannot be mapped.

Combine with the ROMFILE option to map a kickstart from a file. Combine with the FORCE option to issue the reset without confirmaton. Can be combined with the FLASH option on certain cards.

ROMFILE/K Filename of a kickstart file to be mapped into fast memory. This option implies and can replace the MAPROM option. Mapping a ROM file will always issue a reset.
MM=MEMMODE/K/N Memory configuration when switching CPUs:
0 all fastmem including $C0 memory (default)
1 fastmem but no $C0 memory
2 only $C0 memory and chip memory
3 only chip memory

This option is useful in combination with the CPUOFF and CPUON options.

IM=IDEMODE/K/N IDE speeder mode.
0 default
1 PIO3/PIO4- mode
2 PIO4/PIO4+ mode

IDE modes other than the default can cause I/O errors. This depends on various factors, such as solid state/flash vs. hard disk, PSU stability, and cable length. Please backup your data and make sure to test it thoroughly before activating it permanently. Can be combined with the FLASH option on certain cards.

FLASH/S (ACA1221ec only) Save settings in ACA1221ec's flash memory. Can be combined with VBRMOVE, CPUSPEED, NOKEEPPCMCIA, and with MAPROM, IDEMODE on certain cards.
VBRMOVE/S (ACA1221ec only) Move VBR to fastmem on boot. Use in combination with FLASH.
CPUSPEED/K/N (ACA1221ec only) CPU speed step to set on boot. Use in combination with FLASH.
NOKEEPPCMCIA/S Do not keep PCMCIA memory range intact. If you do not have both Kickstart 3.1 (v40) and a PCMCIA connector on your Amiga 600 or 1200, then you do not need to worry about this option. When you do have v40 and a PCMCIA connector, then acatool takes care of the PCMCIA memory range to remain available to PCMCIA. But if you do have v40 and a PCMCIA connector, but want to make the PCMCIA memory range available to the system - only then specify this option. It can be combined with FLASH, CPUOFF, CPUON.
FORCE/S Do not ask for confirmation. This is useful in combination with CPUOFF, MAPROM, FLASH, CPUON.
CPUOFF/S Switch off ACA card's CPU. This will cause a reset. This option can be combined with MAPROM, ROMFILE, FORCE, NOKEEPPCMCIA.
CPUON/S Switch on the ACA card's CPU. This will cause a reset. This option can be combined with MAPROM, ROMFILE, FORCE, NOKEEPPCMCIA.
SKIPONLMB/S Check for the left mouse button being held. If the mouse button is held, skip all command line options. This is useful for the Startup-Sequence, to skip acatool while booting.
NOERRORS/S Turn all return codes indicating error (10) into warnings (5), so that the startup-sequence will ignore errors and continue.
HELP/S Show the command line overview instead of opening the GUI.

Download

acatool v2.1

old versions: v2.01 v1.05 v1.02 v1.01 v1.0

Version history

2.1 - No longer issues a reset on MAPROM, making booting much quicker. Only when a ROMFILE is specified, the computer needs a reset. Changed return value to WARN when MAPROM is already active. Now saves MapROM related settings to S:startup-sequence on ACA1221xx and ACA1211 cards. This allows to toggle in/out MapROM on ACA1221xx without setting the jumper to the MapROM position, therefore the MapROM jumper can now be removed permanently. Saving MapROM related settings even works on an ACA1221ec when the jumper is not in unprotect position. "PIO4 reads" corrected to "PIO3 reads" on ACA1211 (oops).

2.01 - problems corrected with CPU switching and when reporting clock rates in the command line

2.00 - added support for ACA1211 and ACA1221lc cards

1.05 - added ROMFILE support for ACA1221xx; bug in flashing VBRMOVE via command line fixed; PCMCIA detection corrected; renamed option 1233ON to CPUON; reset procedure corrected (sysbase ptr now cleared, used previous execbase vectors with MAPROM/ROMFILE)

1.02 - changed IDE speeder terminology and valid range; Keep PCMCIA is enabled on v40 and with card.resource present only; GUI window now rejects to open if screen is too small; version display corrected for new ACA1233n; on ACA500+ now disables the fields Switch CPU, ROM File, and IDE Accel.; GUI can now start in 68ec020 mode too; 1233on option renamed to cpuon

1.01 - on switching CPUs, did not use the ROMFile field in the GUI, corrected

1.0 - initial

Personal tools
Namespaces

Variants
Actions
Navigation
Icomp
Tools
Print/export