*************************************************************
**  Z8 GUI Emulator Software README.TXT File               **
**  Release Version:  3.02                                 **
**  Release Date   :  July 26, 1996                        **
**                                                         **
*************************************************************
**  Please see changes on this version under revision      **
**  history summary.                                       **
*************************************************************


I. INTRODUCTION
=============================================================
Congratulations on receiving Zilog's latest Z8 Graphical User 
Interface (GUI)  emulator  software  for  controlling Zilog's 
ICEBOX (tm)   and  single-board  emulator  products!  If  you 
received this GUI bundled with a hardware product, everything 
has  been  upgraded already.  If  you  are not sure about the 
status of your hardware,  please  install GUI 3.00 (or later) 
and  run  it with your hardware.  The  GUI  will  detect  and 
report when a hardware upgrade is necessary.  Please read the 
UPGRADE.TXT file  for  the  proper procedure  to  perform the 
upgrade.  For  a  list of enhancements for this version,  see 
the  "Revision History Summary"  section  at  the end of this 
file.

II. FILES SHIPPED FOR THIS VERSION
=============================================================
   README.TXT      This text file you are reading
   UPGRADE.TXT     Hardware upgrade procedure text file
   Z8ICE.EXE       Z8 ICEBOX GUI executable file
   ICEHELP.HLP     Windows help file for Z8ICE.EXE
   BROM300.HEX     Object code file for Boot ROM 3.00

   Z8CFG.BSC       Bisync firmware initialization file
   Z8EM_C12.BSC    On-board Bisync firmware for Z86C12 ICEBOX
   Z8EM_C27.BSC    On-board Bisync firmware for Z86C27 ICEBOX
   Z8EM_C50.BSC    On-board Bisync firmware for Z86C50 ICEBOX
   Z8EM_C62.BSC    On-board Bisync firmware for Z86C62 ICEBOX
   Z8EM_C65.BSC    On-board Bisync firmware for Z89C65 ICEBOX
   Z8EM_C67.BSC    On-board Bisync firmware for Z89C67 ICEBOX
   Z8EM_C84.BSC    On-board Bisync firmware for Z86C84 ICEBOX
   Z8EM_C93.BSC    On-board Bisync firmware for Z86C93 ICEBOX
   Z8EM_L7X.BSC    On-board Bisync firmware for Z86L7X ICEBOX
   Z8EM_209.BSC    On-board Bisync firmware for Z90209 ICEBOX
   Z8EM_CCP.BSC    On-board Bisync firmware for Z86CCP,
                     Z86318, and Z86C15 ICEBOX

   *.O             Old  firmware  files  used by BOOTROM 1.3.
                   Required for  backwards compatibility with
                   non-upgraded emulator hardware.

   ZCONVERT.EXE    Zilog object file  utility  for converting
                   an object file to other formats, splitting
                   a file into two (one containing high bytes
                   and another containing low bytes), merging
                   two files (one with high bytes and another
                   with low bytes)  into one,  and  comparing
                   two  object  files.  Useful  for  ROM CODE
                   submission verification.
   ZCONVERT.HLP    Windows help file for ZCONVERT.EXE 

   PL695TOZ.EXE    A DOS-based utility  for  extracting debug
                   symbols  from  a  PLC IEEE695  object file
                   (*.LOD) into a Zilog GUI compatible symbol
                   file (*.SYM)
   PL695TOZ.TXT    Documentation for PL695TOZ.EXE utility
   PL695.BAT       Batch file for PL695TOZ.EXE in DOS
   PL695.PIF       Control file for PL695TOZ.EXE in Windows

NOTES:
   1. Z86C27 ICEBOX  : GUI comes up as C12 in the Window's caption.
   2. Z86C15 ICEBOX  : GUI comes up as CCP in the Window's caption.
   3. Z86318 ICEBOX  : GUI comes up as CCP in the Window's caption.
   4. Z86116 ICEBOX  : GUI comes up as C50 in the Window's caption.


III. SOFTWARE INSTALLATION
====================================================================
To install this software, see the User Manual, Product, Information, 
or the UPGRADE.TXT file.


IV. ELECTRONIC INFORMATION SERVICES
===================================
1. The Zilog Bulletin Board Service (ZBBS) can be 
   accessed  as follows:

     408/370-8024  (located in Campbell, CA   USA)
     Up to 28.8K baud
     8 bits/no parity, 1 stop bit (8-N-1)
     Use ANSI/BBS terminal emulation setup.
     Follow on-screen instructions.

2. The Zilog Internet Home Page address is as follows:

     http:\\www.zilog.com


V. PRECAUTIONS
=============================================================
1.  GUI software versions prior to 3.00 are incompatible with 
    hardware  containing BOOTROM 3.00.  The GUI software  may 
    still boot, but will fail at some later point.

2.  When device serialization  is  enabled  in the OTP dialog, 
    the GUI copies the current serial number  to  code memory 
    immediately before performing a VERIFY operation. If this 
    behavior is undesirable, then device serialization should 
    be disabled prior to invoking the VERIFY operation.

3.  The  status  color bar  in  the  OTP dialog box  will  be 
    cleared in the area where a new window opens on top of it.

4.  Although the "OTP!" option is active when running the GUI 
    with  C27 ICEBOX,  the  user  should be  aware  that this 
    option is not supported by the hardware.

5.  For some 386 PCs, the user is cautioned  to  set the baud 
    rate to 19.2K or less because  the Windows' communication 
    driver does not guarantee "reliable" operation above 9600 
    baud.  It is possible that  on  some slower  386 machines, 
    selecting  a  high  baud rate  would  crash  the  Windows' 
    environment or result in excessive communication errors.

6.  Do not press hardware reset when the ICEBOX is in  the OTP 
    dialog for programming.  If reset is pressed while the GUI 
    is doing OTP programming, the user would need to close the 
    OTP dialog box and reopen  it  to  reload  the information 
    back to the hardware.  NOTE:  Although  the Command Status 
    shows "Processing" after the GUI re-establishes  the commu-
    nication link when "Retry"  was  selected  in  the "Out of 
    Synchronization with the Emulator" dialog box,  the ICEBOX 
    is really sitting idle.

7.  For L71, booting the  GUI  without  resetting  the ICEBOX 
    may cause the GUI to identify  an incorrect ICEBOX. Always 
    reset the L71 ICEBOX before running the GUI.

8.  When simultaneously running two different GUI versions  on 
    two  different  Communication  Ports,  the former executed 
    version  is  used  for  both  emulators. This is a Windows 
    O/S bugs. 

9.  When using the C50 ICEBOX for OTP READ/EXAMINE for the 86E40
    PDIP, incorrect data may appear on address 0000H.  This  is 
    not true for other devices/packages.

10. Reading  the option bits of the new E30/E31/E40 SL187X (C50, 
    CPP emulators) will display invalid data if the "Eprom Protect" 
    option bit was previously programmed.



VI. LIMITATIONS
=============================================================
1.  Typing into the File Name box in order to change the drive 
    in the file download and  load symbol  dialog boxes is not 
    anticipated by the GUI.  Instead,  use  the mouse  in  the 
    Directories box as the workaround.

2.  Switching  ICEBOXes   without  quitting  the  GUI  is  not 
    supported and may cause unexpected results.

3.  The maximum loadable symbols  is  32,768 provided there is 
    enough system resource (memory).

4.  The keyboard and mouse will lock up  if  the  screen saver 
    supplied by Windows 3.1 times out while  the  GUI software 
    is waiting for the user  to complete  entering  a  line of 
    assembly code in the Debug window.  To  recover,  the user 
    must reset the computer.  The "Totally Twisted  After Dark 
    Screen Saver" version 3.2 and the Windows 95  screen saver 
    both work fine.  The workaround is to either  turn off the 
    screen saver, set the screen saver to much longer time out 
    value, finish the line of code before the  time-out occurs 
    (press ENTER),  or  use  a  different screen saver such as 
    "After Dark".  This problem may also exist at other points 
    in the GUI that request input from the user.

5.  Although GUI 3.00  and  later support  baud  rates  up  to 
    57.6K baud,  the actual maximum usable rate  may  be  less 
    due to limitations  of the  users hardware  and  or system 
    software setup. The maximum usable rate  is  determined by 
    the users tolerance  of the  frequency  of  communication 
    errors.

6.  The initial blue Zilog screen  can be  distorted  by other 
    active windows. This only affects  the appearance, not the 
    functionality of the GUI.

7.  Although GUI displays two timers (T0,T1) for Z86E02/C02/L02,  
    only Timer 1 is valid for these devices.

8.  Due  to  a  hardware limitation,  the  C12 ICEBOX   cannot 
    program  the  "WDT Enable"  and   the  "Test Mode Disable" 
    options  of  new E02  (shown  in  the TopMark selection as 
    Standard  or  SL1903),  new  E04  (shown  in  the  TopMark 
    selection as PEC/SEC, SL186X  or SL1903) and E08 (shown in
    in the TopMark selection  as PEC/SEC,  SL186X  or  SL1903)
    devices. Use a CCP Emulator or a C50 ICEBOX as a workaround.

9.  Expanded Register Bank is not supported for Z86E02/C02/L02  
    in C12 ICEBOXES.

VII. REVISION HISTORY SUMMARY
=============================================================
Unless otherwise stated, changes are cumulative.

-------------------------------------------------------------------
Version 3.02
---------------------------------------------------------------------
1.  Added a Topmark device selection for OTP programming

2.  Added  a machine state logging  capability.  Using  the  "Logging 
    Options..."  command  from  the "Run" menu,  the  user  specifies 
    which machine resources (registers) to log,  the  format in which 
    to log them, and the name of the log file. Resources may be logged 
    linearly  or  circularly. Linear logging treats the log file as a 
    circular buffer with finite capacity.

    The "Log Execution" command on the "Run" menu enables or disables 
    logging. When  enabled, the  user-specified machine resources are 
    logged to the user-specified  file each time  emulation halts (at 
    a breakpoint, after single-step, etc.).

3.  Added SL1903 selection for Z86E02/E04/E08 OTP programming.

4.  Added support for Z86E02/C02/L02 to the Z8 CCP/C12/C50 ICEBOXES.

5.  Added support for the following devices to the Z86L7X ICEBOX :

    Z86L81
    Z86L86/C86
    Z86L87
    Z86L88
    Z86L89                

6.  Changed the "READ OPTIONS" command  on the OTP dialog to display 
    a pop-up dialog box showing the current options programmed  into  
    the device.  GUI 3.01  merely  displayed  the option  byte as a 
    hexadecimal value on the OTP dialog. This change affects the CCP 
    and C50 ICEBOXes and for Z86E30/E31 and E40 SL187X only.

    When the "Eprom Protect" is programmed,  the "READ OPTIONS" will
    result to invalid data.

7.  Corrected a bug  in  file downloading: that assumed 'C:' was the 
    default drive (Z8 and DSP GUI).
                                                                     
8.  Disabled the "WDT Enable" option for the Z86E03  and  Z86E06 on 
    the OTP dialog for the CCP, C12, and C50.  (Due  to  a  device 
    problem, programming this option permanently disables the WDT).

9.  Fixed bug in C65 ICEBOX  communications where  a communications 
    error could  occur when downloading to the DSP code memory.

10. Fixed L7X ROM sizes as per Superintegration Products Guide.

11. Fixed  Z86E02 ROM size for  program/verify  and  examine.  

12. Improved the Z86E40 SL187x OTP programming/verify and Read of the 
    CCP and  C50  emulators.  However, in  order to have reliable OTP 
    programming operations, a 0.1uF ceramic  capacitor must  be added 
    as follows:

    a. C50/CCP daughter board                                                
       a.1 VPP  to  GND  of Z86E40 OTP  programming socket. This can be 
           solered at the solder side of the board on pin#18 and pin#31.
       a.2 VCC  to  GND  of Z86E40  OTP  programming socket. This can be 
           soldered at the solder side of the board on pin#11 and pin#31.
       a.3 VPP  to  GND  of Z86E30  OTP  programming socket. This can be 
           soldered at the solder side of the board on pin#13 and pin#22.
       a.4 VCC  to  GND  of Z86E30  OTP  programming socket. This can be 
           soldered at the solder side of the board on pin#8  and pin#22.
       a.5 VPP  to  GND  of Z86E08  OTP  programming socket. This can be 
           soldered at the solder side of the board on pin#10 and pin#14.
       a.6 VCC  to  GND  of Z86E08  OTP  programming socket. This can be 
           soldered at the solder side of the board on pin#5  and pin#14.
      
       Note : This is mandatory to the C50 ICEBOX,  while it is only 
              recommended for the CCP ICEBOX.
    
    b. Programming Adapters                                                  
       b.1 VPP to GND and VCC to GND.

13. Improved Z86E40 SL187x programming time.

14. Modified VCC level when  programming the Low Noise option bit for 
    the new E06/E08. This applies for C50, CCP and C12 ICEBOXES.                      

15. Modified  the programming  pulse  from 1 mS X 100  to single 200 mS 
    pulse for option bits of E06/E08. This applies for C50, CCP and C12 
    ICEBOXES.

16. OTP support for E30/E31 187X has been added to CCP, C50. 

17. Removed E40 OTP support from L7X ICEBOX.

18. Renamed the "Z86E40DA" device to "Z86E40 SL187x" on the OTP dialog for 
    the CCP and C50 ICEBOXes.

19. Added support for new Z90209 ICEBOX.

        
----------------------------------------------------------------------------
Version 3.01
----------------------------------------------------------------------------
1. Added OTP programming support for the new Z86E40 (die 
   rev. DA) to CCP and C50 Emulators.

2. Added a "READ OPTIONS" button to OTP dialog for the 
   new Z86E40 (die rev. DA) to CCP and C50 Emulators, as 
   this device can actually read the option bits to 
   determine what has been programmed.

3. Changed the Zilog Symbol File load function to support 
   addresses longer than eight (8) digits.  The address 
   field in the symbol file may now contain an arbitrary 
   number of hexadecimal digits.  Addresses are truncated to 
   16-bit values without warning.

4. Changed the Save Code Memory dialog to default to a 
   file extension of .HEX for Intel Hex format files.  This 
   makes the upload dialog box consistent with the download 
   dialog box.

5. Fixed the PLC symbol file loading to allow long path 
   names and path names containing periods.

6. Changed the Ports window to display "??" for port 
   values when the emulator is running, since they cannot be 
   read in this state.

7. Added device configuration selection support to the 
   following GUI firmware:

      C50 ICEBOX:     Z86C43, Z86233, Z86243, Z86L29
      CCP Emulator:   Z86C43, Z86233, Z86243, Z86L29,
                      Z86318, Z86319

8. Changed OTP device naming in the OTP dialog for the 
   CCP, C12, and C50 emulators as indicated below to reflect 
   new top marks of these new die revision devices.  See the 
   on-line Help file for more information.

      GUI 3.00         GUI 3.01
      -------------    --------------
      Z86E04DB 1840    Z86E04 186X
                       Z86E04 PEC/SEC
      Z86E08DB 1840    Z86E08 186X
                       Z86E08 PEC/SEC

9. Changed the OTP option naming on all OTP dialogs as 
   follows for clarity.

      GUI 3.00         GUI 3.01
      -----------      --------------
      Autolatch        Autolatch Disable
      EPM              Test Mode Disable
      WDT              WDT Enable

10. Fixed a problem where multiple option bits for the 
    new Z86E04 and Z86E08 devices (die rev. DB) would not 
    program successfully in the CCP, C12 and C50 emulators.

11. Added support for C84 ICEBOX (Bisync) and 318 
    Emulator.

12. Reduced OTP programming time for the new Z86E04/08 
    "186X", "PEC", and "SEC" devices.

13. Changed the OTP programming dialog VERIFY button 
    function so that it does not program the option bits 
    checked.  The option bits are only programmed when the 
    PROGRAM function is selected.  This change affects the 
    CCP, C12, C50, and L7X emulators.

14. Fixed a problem with the 'animate' mode in the Debug 
    window when running at 57.6K baud that would cause the 
    animation to stop due to a GUI communications error.

Version 3.00
------------
1. Communications
   A. Bisync binary protocol implemented to provide 
      automatic error-correction capability for improved 
      communication reliability between the ICEBOX and the host 
      computer.
   B. Support for baud rates from 9600 to 57.6K (requires 
      BOOTROM 3.00).

2. OTP Programming
   The OTP window has the following new features (features 
   marked with "*" require BOOTROM 3.00):

   A. The customer can program a serial number into the OTP 
      device.  The length and address of the serial number will 
      be specified by the customer; it may be changed at any 
      time before it is programmed into a device.  The 
      generated serial number will be, at the customer's 
      discretion, a sequential number or a pseudo random 
      number.  For sequential mode, the software increments the 
      serial number by one after each device is programmed.  In 
      pseudo random mode, the serial number is generated 
      according to the following algorithm.

               r[i+1] = (a * r[i] + b) mod 2^N

         where r[i+1] is the new serial number
               r[i] is the last serial number
               a = 1909
               b = 221 571
               N = number of bits in the serial number

       Example:
         If a user enters 1000 at Address, selects
         4-Bytes as Serial Number Size, and enters
         12345678 at Serial Number, the GUI will put
         the serial number in memory as shown below:

               %1000 = %12
               %1001 = %34
               %1002 = %56
               %1003 = %78

   B.* The OTP dialog now has a "RAM CHECKSUM" option.  The 
       algorithm is the same as the "OTP CHECKSUM" so that the 
       user may manually compare the two values for correctness.

   C.* The "PROGRAM" and "VERIFY" options report the address 
       of the first programming or verification failure, along 
       with the anticipated and actual values at the failing 
       address.

   D.* The GUI is no longer sensitive to OTP device data and 
       checksum values due to the improved protocol.

3. Supports 2500AD and PLC/IEEE695 object module formats.

4. Status Indicators
   The ICEBOX front panel LEDs act as status indicators 
   (some emulators, such as CCP, do not have any LEDs).

     LED A: ON       = Emulator powered up and passed the
                       self-test
            OFF      = Emulator power off
            BLINKING = ICEBOX in self-testing mode

     LED B: ON       = Communicating in Bisync mode, and
                       waiting for command
            OFF      = Communicating in ASCII mode, or
                       executing Bisync command

     LED C: ON       = Running user code
            OFF      = Not running user code

     LED D: ON       = Accessing OTP device
            OFF      = No OTP operation

5. The on-line help file was updated to include the new 
   features and fill in all missing sections.

Version 2.5
-----------
Added support for C84 ICEBOX (preliminary), L71 ICEBOX 
Upgrade for 16 MHz, and Z86L79/80 on L71 ICEBOX.

Version 2.22
------------
Added support for Z86E03/06 OTP and option bits 
programming on C12 ICEBOX, C50 ICEBOX, and CCP Emulator.

Version 2.21
------------
"Engineering Use Only" to support Z86E03/06 programming 
on C12 ICEBOX, C50 ICEBOX, and CCP Emulator.

Version 2.2
-----------
Added support for the CCP Emulator.

** END **
