          @@@   @@@@@@@  @@@@@@@@   @@@@@@    @@@@@@@   @@@@@@@@            
          @@!  !@@       @@!       @@!  @@@  !@@        @@!                 
          !!@  !@!       @!!!:!    @!@!@!@!  !@! @!@!@  @!!!:!              
          !!:  :!!       !!:       !!:  !!!  :!!   !!:  !!:                 
          :     :: :: :  : :: :::   :   : :   :: :: :   : :: :::            
                                                                            
                    Presents: IAS Version 1.3.6 Build 970708                
                    =*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*                
                                                                            
           URL  : http://wkweb4.cableinet.co.uk/toril/iceage                
           EMail: mail://iceage@cableinet.co.uk                             


[1]...Disclaimer
[2]...Overview
[3]...Installation
[4]...Changing Defaults
[5]...Sending Images
[6]...Receiving Images
[7]...Changing Rom Sizes
[8]...Applying IPS Patches
[9]...Endian Swapping
[10]...CRC (Re)Generation
[11]..Dealing with Compressed Images
[12]..Bios Modification
[13]..Obtaining Rom Information
[14]..Obtaining Updates


**************************

Whats New in Version 1.3.6

**************************

    Finalised support for Bubba's Bios.
    Added core routines for SP support. (Not yet enabled)
    Added default options.
    Images that IAS will work with must now be in Doctor64 format (ie.
        little endian). Images destined for Bubba's Bios and SP units
        are byte-flipped on-the-fly as they are being sent.
        This is to standardize the types of files will be accepted
        as valid workable images.
    IPS2 is now supported.
    Fixed all of the nasty Bios bugs.



[1]...Disclaimer
The authors of this program make no warranty, express or implied about 
its usefulness for any purpose. The end user, YOU, take full 
responsibility for any legal actions against the use of this program.  
The authors do not endorse or condone the copying of any software 
titles that you do not own, except in the interest of protecting your 
investment in titles which you have purchased. The authors will not be 
responsible for the use or misuse of this program, or any illegal or 
'grey-area' activities which are facilitated by the use or misuse of 
this program. This program is meant to be an educational and 
experimental tool only, for personal, non-corporate uses. Any other use 
constitutes copyright infringement.



[2]...Overview
IAS is a command line driven utility designed to be used with specialist
console hardware and provide the developer with a simple to use, yet
powerful utility. IAS provides the user with the facility to transfer
his/her creations to the aforementioned hardware and apply a vast range
of other facilities that may be needed.

IAS supports the following bios' :-
	Bung 		(up to version 1.22)	
	Bung 		(version 1.30 upwards)	
	R.Bubba's Bios	

Minimum Specs:-
IAS requires a minimum processor specification of a Intel '386 to
operate. Please bear in mind that this is the *minimum* specification to
work. The recommended spec. is a machine equipped with a Pentium class
processor. IAS also uses varying amounts of disk space as its working,
depending on the functions used. The maximum allowable space required is
equal to the size of the file being worked on. I.e. If you are working
with a 16Mbyte image, then a maximum of 16Mb swap space will be used. If
you are working with a 32Mbyte file and have 4Mb free space - you're
going to have problems.

Please note that IAS (Dos Version) also requires the file CWSDPMI.EXE to
be present in a directory in the PATH statement.



[3]...Installation
To install IAS, simply unzip (or untar) the archive into a chosen
directory and run. Please note that the DOS version will also require
access to CWSDMPI.EXE (included in the DOS archive) to be either in the
same directory or included in a directory in the PATH statement.


[4]...Setting/Viewing Defaults
IAS now has the facility to set/view the internal defaults.
To view/set them use the following command:-

Syntax: IAS M

Commandline breakdown:-

    IAS M       -   invoke IAS with view default command.

At this point IAS will display which LPT port is being used,
which BIOS is currently active and which unit is being sent to.
You will noe be asked if you wish to change the defaults. Press
'Y' to modify them.

First option : Which parallel port to use (1/2/3)
Second option: Which Bios or unit to use (Bung/Bubba/SP64)


[5]...Sending images.
IAS now supports both Bungs Bios and the Bios created by R.Bubba and
will communicate with either bios.

Syntax : IAS S<port><bios> <filename>

Commandline breakdown:-

	IAS S		-	invoke IAS with the (S)end command.

	<port> 		-	define which hardware port is to be used from the following list :-
                                1       - Hardware port 1  (0x378)
                                2       - Hardware port 2  (0x278)
				etc....

	<bios>		-	define which Bios is being used .
                                blank   - Use Bung bios handshaking routines.
                                'r'     - Use R.Bubba's bios routines.

	<filename>	-	The name of the file to be transferred.
	
Examples:-
        Send demo.bin to hardware using defaults. (bung bios, port 1)
        IAS S demo.bin

        Send demo.bin to hardware using R.Bubba's Bios and port 1.
        IAS S1r demo.bin

        Send demo.bin to hardware using Bung bios, port 2.
        IAS S2 demo.bin

        Send demo.bin to hardware using R.Bubba's bios, port 2.
        IAS S2r demo.bin


[6]...Receiving Images
IAS also supports retrieval of images. Please not that retrieving an
image you do not legally own is in violation of copyright law.

Syntax : IAS R <filename>

Commandline breakdown:-

	IAS R		-	Invoke IAS with (R)eceive command.

	<filename>	-	The filename of the stored image.

The retrieval process is done in two steps, detailed below:-
	
Step 1: (only applicable for Bungs Bios 1.22 or below)
For a *64* Mbit image press 'FR' and 'FF' simultaneously.
For a *128* Mbit image press 'CH', 'FR' and 'FF' simultaneously.
	
Step 2: Type in :-
	IAS R <filename>
	
Note: If you are retrieving a 128Mbit image you will need to hold down
'CH' as you press ENTER.


	
[7]...Changing Image Sizes.
Occasionally you will need to modify the size of the image you are
creating for one reason or another. Bungs Bios *before* version 1.30
will only accept 64Mbit and 128Mbit images, so you'll need to pad your
files if you are sending to an older bios. Bungs Bios version 1.30
upwards and R.Bubba's Bios will accept any multiple of 2Mbit and so the
file padding needed will not be as extreme as is needed with 1.22.

Syntax : IAS Exxx <filename> where xxx is a multiple of 2Mbit in the
         range 2 - 256Mbits.

Commandline Breakdown:-

	IAS E		-	Invoke IAS using (E)xtend/truncate command.

	Xxx		-	New filesize in Mbits.


Examples:-
	
	Truncate 'demo.bin' to 96Mbit		-	IAS E96 demo.bin
	Truncate 'Sram_Mgr.bin' to 16Mbit	-	IAS E16 Sram_mgr.bin
	Pad 'demo.bin' to 32Mbit		-	IAS E32 demo.bin


  
[8]...Applying IPS Patches
As with all the Rtool family, IAS supports IPS (version 1) patching,
allowing IPS (International Patching Standard) patches to be applied to
files.

Syntax : IAS P <filename> <IPS File>

Commandline Breakdown:-

	IAS P		-	Invoke IAS using IPS (P)atch command

	<filename>	-	The file that will be patched.

	<IPS File>	-	The .IPS file that will be applied to the file.



[9]...Endian Swapping.
IAS has the facility to swap the endian of the file or 'byte-flip' it.
This allows you to search through images looking for text, cheats etc...
IAS will also detect if an image has already been byte-flipped and
accommodate for this on-the-fly when sending to a particular Bios.

Syntax : IAS F <filename>

Commandline breakdown:-

	IAS F		-	Invoke IAS with Byte (F)lip command.
	<filename>	-	The filename of the file to be byte flipped.

[10]...CRC (re)Generation
IAS is also capable of checking the CRC (cyclic redundancy check) for a
rom image and repairing it if necessary. If the assembler (or whatever)
you are using to create files does not support CRC generation then you
will need to fix the CRC of your file before transferring it.

Syntax : IAS U[F] <filename>

Commandline breakdown:-

	IAS U[F]	-	Invokes IAS' CRC routines. 
	<filename>	-	Filename of the image to be checked.

Examples:-
	Check CRC of 'demo.bin'				-	IAS U demo.bin
	Check CRC of 'Demo.bin' and repair if invalid	-	IAS UF demo.bin


[11]..Dealing with Compressed Images.
IAS has the ability to take an image and apply a Zip-like algorithm to
it, reducing the amount of physical space taken by the file. Once
compressed IAS, as with all the Rtool family, can send these compressed
files (denoted by their .Z64 extension) directly without having to
decompress them first.

Compressing Images:
	
	Syntax : IAS Cx <filename>

	Commandline breakdown:-
	
                IAS Cx - Invoke IAS' compression commands using compression
                level x.(x can be in the range 1(fast) to 9(strong).
                If omitted '6' is assumed - this gives good compression
                coupled with decent compression speed)

                <filename> - The file to be compressed. (Wildcards can be used)

Note: Only a valid V64 image will be compressed, so you can use
wildcards to specify files and be safe in the knowledge that the .EXEs,
.ZIPs etc will not be touched.

Examples:
                Compress every valid image, max power.  -  IAS c9 *.*
                Compress demo.bin, fast                 -  IAS c1 demo.bin
                Compress demo.bin, standard compression -  IAS c demo.bin

IMPORTANT NOTE: When IAS creates compressed files it replaces the
extension with .Z64 to identify to the user that it is a compressed
file. If you have TWO files with the same name but different extensions
and compress them together you will lose a file. i.e. Demo1.001 and
Demo1.002 - if you type 'IAS c demo1.* IAS will compress the first file
creating demo1.z64 and create the second file, also called demo1.z64.

Be aware of this when compressing files - files with the same name and
different extension WILL be lost if you compress both files.......you
have been warned.


Decompressing Images:
Obviously if you have a compressed image you may, at some time, wish to
decompress it.
	
	Syntax : IAS D <filename>

	Commandline breakdown:-

		IAS D		-	Invokes IAS' decompression routines.

		<filename>	-	The filename to be decompressed.

IAS will check that the file to be decompressed is a valid IA compressed
image before attempting to decompress it.

Examples:-		
                Decompress 'demo.z64'               - IAS d demo.z64
                Decompress all IA compressed Images - IAS D *.Z64 (also use
                                                      IAS D *.*)




[12]..BIOS Manipulation.
The official BIOS has one of its features disabled when released. An 
unmodified BIOS is incapable of receiving images from the hardware. To 
circumvent this a small modification is needed to the BIOS file.  
This feature is designed to be used to retrieve images you have created, 
not commercial images. Retrieving commercial images is in violation of 
copyright law.


Bios Enabling

Syntax:		IAS BE <bios filename>

Commandline breakdown:-

		IAS BE		-	Invoke IAS's Bios enabling routines

		<filename>	-	Bios to be enabled.



Bios Disabling (returning a bios to its original state)

Syntax:		IAS BD <bios filename>

Commandline breakdown:-

		IAS BD		-	Invoke IAS's Bios disabling routines

		<filename>	-	Bios to be disabled.


Example:
                Enable Bios version 1.31 -       IAS BE V64VER1.31

                Disable Bios V.131       -       IAS BD V64VER1.31



[13]..Displaying header information.
IAS will display information stored in the cart header, displaying
information about the cart name, filesize, image size, if its
compressed, if its byte-flipped etc.

Syntax:		IAS I <filename>

Commandline breakdown:-

		IAS I		-	Invoke IAS' information routines.

		<filename>	-	file to strip info from.

Example:

		IAS I demo.bin



[14]..Obtaining updates.
The latest versions of our utilities can be accessed from the Iceage web page 
which is located at:


Http://wkweb4.cableinet.co.uk/toril/iceage


Alternatively we can be contacted via email at:

iceage@cableinet.co.uk.

