MICEpack/SLD-ADS328 V1.2

Changes in Version 1.2
----------------------
1. SLD now can support the ADI port communication.

Changes in Version 1.1
----------------------
1. SLD now can support the serial port communication in 57600 baud.

Host System Requirements
------------------------
The following host computer requirements and recommendations apply:
1. An Intel 386DX, Intel 486, or Intel Pentium(tm)-based PC or 100% 
   compatible system.
2. At least 6 Megabytes of RAM.
3. 4.5 Megabytes of available disk space.
4. VGA or Super VGA graphics card and color monitor (A graphics 
   accelerator card will boost performance, and a monitor capable 
   of at least 800x600 operation is highly recommended).
5. Mouse.
6. MSDOS 3.3, 5.0, or 6.x.
7. Windows 3.1 running in 386-enhanced mode.
8. 4 Megabytes or greater swap file (permanent swap file recommended).
9. Minimum: Files=30  Buffers=30

MICEpack/SLD-ADS328 Configuration Guidelines
------------------------------------------
* Use a disk cache such as smartdrive for improved Windows performance.
* Be sure you have a swap file of at least 4 Megabytes (a permanent 
  swap file is recommended).
* MICEpack/SLD requires a minimum of 5 Megabytes of free memory after
  Windows is loaded.  More memory is better, especially if you run
  other applications at the same time.  If memory is low, close other 
  applications to regain memory.
* While the emulator runs, status messages are sent from the chassis to 
  the host PC.  If you are running a DOS shell at the same time, give it
  a low priority via the .PIF file settings, or stop the emulator.
* One GP fault that showed up in MICEpack/SLD was traced to a faulty
  video device driver of the Diamond Stealth ISA 1M VRAM card (version
  2.31) in 1024 X 768 mode.  The problem went away by reducing the 
  resolution to 800 X 600.  Another problem exists with the Genoa 256-
  color small font driver.  The symptom is the load-progress indicator
  is not updated completely at the completion of a load. If you encounter
  a fault in a driver file (*.DRV), try installing a more current device 
  driver.

Toolchain Notes
---------------
* Enumerated types do not display symbolic values.
* Enums, structs and unions are limited to 256 elements.
* The fatal error "Out of object pointers" indicates that MICEpack/SLD 
  has exhausted system display resources.  If you frequently encounter 
  this error condition, try the following:
    - close windows that are not in use.
    - reduce the size of windows.
    - decrease the number of saved transcript lines and history commands 
       in the shell window.
    - when loading, select "On Demand Symbol Loading".
    - include symbols in only the modules that are being actively debugged.

MICEpack/SLD-ADS328 supports the IEEE695 and S-Record file format.  Testing 
has confirmed, however, that there are numerous interpretations of the 
IEEE695 specifications.  MICEpack/SLD-68K has been tested with these 
toolchains: 

    MRI 4.2, MRI C++ 1.1 
    Intermetrics Intertools 8.2.5
    Sierra C 3.0
    Introl 3.07
    Green Hills' C Cross 68K Ver 1.8.7b

All compiler switches, please refer to Compiler Information appendix in 
MICEpack/SLD-68K User's Manual.

Default Radix in Addresses Input
--------------------------------
All addresses input from dialog box or Shell commands are assumed to be
hexadecimal. The default radix for data continues to be decimal, with
hexadecimal values indicated by a "0x" prefix.  For example:

     shell command           interpretation
     -------------           --------------
     reg pc 55;              set register pc to 55 hexadecimal
     dump 400;               dump memory at address 400 hexadecimal
     write 500 0x33;         write 33 hexadecimal to location 500 hexadecimal

Initialization Script in MICEPACK.INI
-------------------------------------
* Communication Selection

MICEpack/SLD-ADS328 can be set up the communication port and its COM port in       "Comm" and "Serial" sections of MICEPACK.INI file.  For example:
    [Comm]
    type=serial

    [Serial]
    comport=com{1|2|3|4}
    baudrate={19200|57600}

The selection of communication port can be set by accessing MP/Setup 
application. 
    
* Emulated Target CPU Selection

MICEpack/SLD-ADS328 can be set up the emulated target CPU in "SystemInfo"
section of MICEPACK.INI file. For example:
    [SystemInfo]
    MICEpack=68328

* Running Auto-initialization Script.
MICEpack/SLD can be set up to run an auto-initialization script. 
The script sets up the emulator to your requirements each time you run
MICEpack/SLD.  The product is shipped with an include file that describes
how to do this.  The file is named "include.me". To create your own script
file, create a file with the commands you want for initialization. 
BE SURE TO END EACH COMMAND WITH A SEMICOLON. Edit the MICEPACK.INI file 
(in your windows directory), and change the "script=include.me" line, 
replacing "include.me" with your initialization file.  Be sure to include
the full path, including drive letter if necessary.  For example:
    script=c:\mpez328\reset.inc

You can also run the same initialization file in the Shell window. 
For example: include "c:\mpez328\reset.inc";

* Shell command history
You can access the Shell command history with Ctrl-uparrow
and Ctrl-downarrow keys.