************************************************************************* * * * VXLShell v1.3 (20-Jun-1994) by Per-Olof Yliniemi * * * * Copyright © 1993 - All Rights Reserved * * * ************************************************************************* * * * DISCLAIMER: No responsibility can be taken on the part of the author * * for any consequences that may occur as a result of using this * * program. Every part of the program has been thoroughly tested to * * to its specified limits and any known specific limitations of the * * the program are stated within this documentation. * * * ************************************************************************* * * * COPYRIGHT: This program is DISKWARE. If you use it, send me one or * * more disk(s) with freely distributable programs (PD, Shareware, * * Freeware, ???ware). The program may be freely distributed as long * * as all files are distributed and unmodified. * * * * The program may not be sold for any profit (a nominal fee for * * copying is accepted). * * * * This program may not be used as a part of any commercial packages * * without my permission. The source code for this program may not be * * reproduced by disassembling or reversing the development process in * * any way. * * * ************************************************************************* About this program: --------------------- This program is for you out there who have a Microbotics VXL-30 turbo board attached to your computer. This program is only a graphical interface for the SetVXL program. It uses the SetVXL software that came along with the accelerator board, but can be used for Cache/Burst control for 68030 without it. Installation: --------------- This package should contain the following files: VXLShell11 The old version of the executable (4864 bytes) VXLShell13 The new executable (3084 bytes) VXLShell13.info The icon for the executable VXLShell13.doc This documentation (8276 bytes) VXLShell13.doc.info The icon for the doc file Copy the SetVXL command to C: and this program and its icon to another drawer. If you are installing the old version (1.1) of this program, do a copy of the VXLShell13.info file and name it VXLShell11.info. The program can be executed from CLI or Workbench and opens a window with some gadgets. Gadgets: ---------- The right side of the window contains a group of four gadgets for Cache/Burst control and do not require the SetVXL software. The left side of the window also contains a group of four gadgets, to select which arguments to send to SetVXL. The bottom of the window contains three gadgets. The one in the middle is used by SetVXL. Memory Control Cache & Burst Control |-------------| |-------------| |-------------| |-------------| | @ | MapHigh | | FastROM | | ICache | | IBurst | |-------------| |-------------| |-------------| |-------------| |-------------| |-------------| |-------------| |-------------| | @ | MBROM | | AddMem | | DCache | | DBurst | |-------------| |-------------| |-------------| |-------------| Processor |-------------| |-------------| |-------------| | USE | | @ | 68030 | | QUIT | |-------------| |-------------| |-------------| Due to a little bug in intuition the cycle gadgets have a little weird behaviour. When pressed, the window contents disappears a short time and is then redrawn to update the gadget imagery (I'm using one of the methods described in the RKM:Libraries manual). The RefreshGList routine didn't work correct with my gadgets for this program (borders...). This could have been solved by replacing all gadgets with images, but I did the opposite when this program went from v1.1 to v1.2 (larger gadgets). For those of you who don't like this way of updating the gadget images, use the old version of this program that is included with this version. Memory Control (explained from top left to bottom right): ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ MapHigh / MapLow cycle gadget: For the MapHigh / MapLow arguments to SetVXL. This gadget selects which address the RAM-32 memory should be placed at when it is added to the system. Defaults to MapHigh when the program is started. FastROM gadget: For the FastROM option in the SetVXL program. Copies the active ROM to 512k of the 32-bit RAM attached to the VXL-30 board. Default = OFF. SetVXL equivalent: FastROM / NoFastROM. MBROM / VXLROM cycle gadget: Selects which ROM chip that should be used. The RAM-32 board has a socket for a ROM-chip. This gadget selects if the computer should use the ROM in the socket on the RAM-32 board or the ROM on the motherboard. Defaults to MBROM when the program is started. AddMem gadget: This gadget tells SetVXL to add the memory on the RAM-32 board to the system. The address is selected with the MapHigh/MapLow cycle gadget. SetVXL equivalent: AddMem. Default = OFF. Cache & Burst Control (explained from top left to bottom right): ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ All these gadgets are only available when the Processor gadget is set to 68030. The default values for these gadgets are the current state. ICache: Controls the instruction cache of the processor. SetVXL equivalent: InstCache/NoInstCache. IBurst: Controls the memory instruction burst mode. SetVXL equivalent: InstBurst/NoInstBurst. DCache: Controls the data cache of the processor. SetVXL equivalent: DataCache/NoDataCache. DBurst: Controls the memory data burst mode. SetVXL equivalent: DataBurst/NoDataBurst. The bottom row of gadgets (explained from left to right): ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ USE: Uses the settings selected with the gadgets. Does the reboot within 5 seconds (as with SetVXL) if necessary. 68030/68000: Selects which processor to use. Defaults to the processor that is in use. SetVXL equivalent: 68030 / 68000. QUIT: Ignores all changes and exits the program immediatly. --------------------------------------------------------------------------- All kinds of freely distributable programs (new software...) are accepted as a contribution for this program. If you are a programmer, send me some of your own code. Contributions for this program and bug reports should be sent to: Per-Olof Yliniemi Muoniovaara S-980 64 Muodoslompolo SWEDEN Note 1: If you want to have the source code for this program, and maybe use it in your own programs, send me some equivalent assembly language program that YOU have written (about 1000 lines of source, 3k exe). Note 2: Everything that appears to be a bug in this program that occurs AFTER the USE gadget has been pressed is a bug in the SetVXL software. I know that there is some, but I don't remember 'em right now... ---------------------------------------------------------------------------