DOS 2.0 Utilities Disk 5 (Feb 1992) : CPUSet / CPUSet.doc

        
        CPUSet V1.5 by Nic Wilson
        -------------------------
        
        This program is ShareWare.  It may be freely distributed
        on the condition that no profit is directly or indirectly 
        gained from its distribution.  A donation is requested if 
        you find yourself using this utility.  
                
        Commercial Companies may also distribute it on their disks,
        and a donation of either goods or monies is requested.
        
        The program is hand coded in assembly language, so it 
        would be difficult if not impossible to write your own
        any faster or smaller.
        
        Progressive Peripherals & Software (USA) are exempt from all
        distribution conditions and may distribute it in any
        way they so desire.
        
        The conditions below must be adhered to if you distribute 
        this program.
        
        CONDITIONS
        
        ************************************************************
        Crunching of this program as an executable crunched file is 
        not allowed, and is considered to contravene this agreement 
        of distribution.  This has been done because the 68040 
        processor can crash if a program has been crunched.  
        
        Distribution in the form of 'LZH' file is acceptable.
        
        This program and its document file must remain intact and
        unmodified.  Your own seperate document file may accompany
        it.
        ************************************************************

HISTORY         
-------
V1.5    Due to some assembler debugging directives being left in, 
        some V2.0x code was not being written to the executable.
        This is now corrected.        
        

V1.4    Fixed a bug.  If 4 command line parameters were supplied 
        the program could hang for a while before returning.

V1.3    Added the ability to recognise 68040 and 68030 if the OS is
        incorrectly reporting under kickstart 1.2 or 1.3 and correct 
        the OS settings.  Added more error trapping for incorrect
        settings on each processor type.
        
V1.2    First version assembled with Macro68.
        
V1.1    Optimized the code.
        
V1.0    First public release.        
        
FUNCTION
--------
        To enable or disable the instruction and or data caches,
        and copyback cache on the 68040 processor.      
        
        To enable or disable the instruction and or data caches,
        instruction and or data burst on the 68030 processor.
        
        To enable or disable the instruction and or data caches
        on the 68020 processor.
        
REQUIREMENTS
------------
        
        Any model Amiga fitted with 68020, 68030 or 68040 processor.
        
        Kickstart/Workbench V1.3 or V2.0x
        
SYNOPSIS
--------

        From CLI
        --------
        68040
        
        CPUSet  [ICACHE_ON] [ICACHE_OFF] [DCACHE_ON] [DCACHE_OFF]
                [CBACK_ON] [CBACK_OFF] 
                
        68030
        
        CPUSet  [ICACHE_ON] [ICACHE_OFF] [DCACHE_ON] [DCACHE_OFF]
                [IBURST_ON] [IBURST_OFF] [DBURST_ON] [DBURST_ON]
        
        68020
        
        CPUSet  [ICACHE_ON] [ICACHE_OFF] [DCACHE_ON] [DCACHE_OFF]
                
        From Workbench
        --------------
        
        68020, 68030, 68040
                
        When the window opens the current settings of the caches
        will be shown.                          
                
        Each mode can be toggled on or off with the gadgets.
        Only the modes for the current CPU type will be available.
        
        As each gadget is clicked, its mode will be immediately
        enabled or disabled and the setting shown in the gadget. 


NOTES ON USAGE
--------------
        
        If any incorrect parameters are supplied from the CLI, CPUSet
        will ignore them.  When a parameter is accepted as valid, an
        enabled or disabled message for each parameter will be displayed 
        in the CLI window.
        
        To obtain usage from the CLI type:- CPUSet ?
        
GLOSSARY OF PARAMETERS
----------------------
        
        ICACHE_ON    -  Turns on  Instruction Cache for 68020, 68030 68040      
                     
        ICACHE_OFF   -  Turns off Instruction Cache for 68020, 68030 68040
        
        DCACHE_ON    -  Turns on  Data Cache for 68020, 68030 68040
        
        DCACHE_OFF   -  Turns off Data Cache for 68020, 68030 68040
        
        CBACK_ON     -  Turns on  Copyback Data Cache for 68040 only
        
        CBACK_OFF    -  Turns off Copyback Data Cache for 68040 only
        
        IBURST_ON    -  Turns on  Instruction Burst for 68030 only
        
        IBURST_OFF   -  Turns off Instruction Burst for 68030 only
        
        DBURST_ON    -  Turns on  Data Burst for 68030 only
        
        DBURST_ON    -  Turns off Data Burst for 68030 only