CoyoteFlash Instructions (1.4)

Introduction
------------

CoyoteFlash is a program designed for the individual Computers FlashROM
card. It allows the user to freely modify the contents of the flash
chips on board.

Requirements
------------

The program should work on all Amiga's with at least Kickstart 2.04 or
up. An individual Computers Kickflash OS4 card is required as well.

Installation
------------

Use the supplied installer or drag the CoyoteFlash drawer to any place on
your harddisk. It should work from both Workbench and the CLI, without the
need of any external files except asl.library.

Usage
-----

* (Flash) Load

Allows the user to load the contents of the FlashROM to a mirror file in
memory. The entire 1024KB will be loaded.

* (Flash) Save

Will save the mirror file to the flash card. If the filesystem is
recognized, it will only save the part which is in use. Elsewise, it will
save the complete 1024KB.

* (Image) Load

Allows the user to load a mirror file rom disk. This file can easily be 
edited or written using the Flash Save button.

* (Image) Save

Saves an entire image to disk. Handy to backup the contents of a flash
card at once.

* (Other) Firmware

Replaces the firmware of the flashcard or mirror with a new one. Make
sure that the firmware selected is an official one. A bad firmware can
crash the machine on bootup!

When the firmware is written it will ask if the card should only install
modules when KickStart 3.1 is present. This is only useful for people who
are using another KickStart remapper and do not have KickStart 3.1 ROM 
chips. In this case the firmware will skip the ROM module install process 
when KS3.1 is not available yet. 

IMPORTANT: If you are using the 512KB Kickstart remapping feature for 
Cyberstorm MK1, MK2, MK3, CSPPC, BlizzardPPC or A3640 cards, please 
answer NO to this question!

* (Other) Format

This button contains two different modes:

1. Format

Allows the user to format the mirror file or flashcard. The entire mirror
file or flashcard will be emptied and an empty filesystem will be added.

2. Diagnostics

Shows some information about the flashcard and its contents. The firmware
version is displayed and the sector protection. Sector protection is a
hardware process which can not be modified from software. Therefore all
the sectors should always be write enabled. When a 'X' is present, the
sector is protected.

* (Other) Add ROM

Allows the user to add a KickStart ROM or AmigaOS ROM Updates. They are
always added to the mirror file (not to flash) and can be saved using the
Flash Save button. It will automatically tell if the firmware supports
KickStart remapping or not and will ignore the file on bootup if remapping
is not supported. The only way to remove the KickStart file is to click on
the 'ROMK Kickstart ROM' line of the programs file browser. To use the
Retro Kickstart remapping feature of firmware 1.6 or higher, simply
add the 34.005 Kickstart file to the ROMK slot or if you would like to use
the 512KB Kickstart remapping as well, join the files. For example typing
the following in the CLI:

join devs:rom34.005 devs:rom3.1 TO newrom

will create a 768KB file which can be added to make use of both features.
The order of joining makes no difference.

Coyote Flux or Individual Computers will NOT send Kickstart ROM files to 
anybody, so please do not bother asking us!

AmigaOS ROM Updates can be added, Setpatch should autodetect the modules 
if everything is installed correctly. Since the early bootup can be very
dependent on different hardware, please report any problems to the authors
and leave a message about the hardware on which it fails.

CoyoteFlash will automatically ask which modules you want to install or
not. 

Like with the KickStart ROM, the only way to remove the AmigaOS ROM modules
is by clicking the 'ROMU AmigaOS ROM Update' line of the program's
file browser.

* File/Module adding

When the board is unused, the first file present will be CoyoteDiskBlock.
This file is the actual data written to disk on bootup. Removing this file 
is required, but it will remove the functionality of saving on bootup.
Since version 1.52, the firmware for saving has been added to the 
Coyote Flash archive saved to the floppy disk. When the CoyoteDiskBlock 
file is added to the Kickflash card, it must always be in the first "FILE" 
slot to be recognized and saved to disk on bootup.

Nearly any kind of resident module should work now, just make sure not to
install two different modules with the same name at once (such as both the 
scsi.device from the AmigaOS ROM Update as well as another seperate file). 
The OpenOXYPPort CLI command from Oxyron's OxyPatcher can be added as well 
for installation directly from the Flash card.

Adding and removing files is easy. Just press on any slot and it will add
a file when the slot is empty. If the slot it set, it will ask if you would
like to remove the file. Added files are ALWAYS loaded to the first slot
available and will only affect the mirror file until Flash Save is used.

Since CoyoteFlash 1.4, you can also press the Add File button to add files.
This is the only way to add files if the first nine file slots are already
in use.



