
*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *
*  This document includes information about the features *
*        of the UniLab 8620 software, release 4.0e.      *
*  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *  *

This is the first release of the Orion model 8620 UniLab.
A new manual is being prepared and will be shipped to you as 
soon as it is ready.  In the meantime, a UniLab 8420 manual 
is included.  The differences are noted in this document.

* * * * * * * * * * * * * * * * * 
*  Topics covered in this file  *
* * * * * * * * * * * * * * * * * 

      --  Hooking up the unit  
      --  Software for UniLab 8620   
      --  The Utilities Diskette  
      --  Loader  Ver 1.2

*  *  *  *  *  *  *  *  *
*  Hooking up the unit  *
*  *  *  *  *  *  *  *  *

1. Turn power off your PC and open it up.  Insert slot card.
2. Close computer back up. Put cable into slot card at
     the rear of your computer.  Red wire should be up.
3. Plug cable into bottom of 8620.  It exits toward the
     rear of the box with the red side to the left
     side of the box (same side as power switch)
4. Copy the software on to a floppy or (preferably) hard disk.  
    (See installation instructions on Disk insert). 
    Note that your software is on three diskettes 
    (four if you also purchased the PPA). 
    The Utilities diskette contains files which are optional for 
    the operation of the UniLab 8620.  See below for details on 
    what these files are for.
5. Type ULxxx (where xxx is your target, such as ULZ80, UL86, etc.)
    to get into 8620 4.0B operating system.  The software will spend 
    several seconds reading from the disk.  Then the opening help screen 
    will appear.
6. If the cables are properly connected, the 8620 will be initialized.
    If the cable is not connected or improperly connected, you'll get a 
    "Unit not responding" message. Type INIT if you have to re-connect 
    or turn off the power to the UniLab.

*  *  *  *  *  *  *  *  *  *  *
*  Software for UniLab 8620   *
*  *  *  *  *  *  *  *  *  *  *

Type MESSAGE to see current info or last minute changes.

The on-line help should be most of what you need to get
started.  Try F1 and Ctrl-F1 for basic help text. Alt-F3 
will show the assignments to all the function keys.
Press Alt-F1 for DEBUG help.

The 8620 emphasizes the function rather than the command
name.  Except for the DEBUG words like RB, GB, etc., most
things can be handled by either a function key or a mode 
panel switch. 

Documentation: The command set of the 8420 can be used on the
8620 (with exceptions listed below). 
(See the on-line glossary for more information on these words)
 
=PORT
=STROBE
EDIT_MACROS (Shift-F10)
EMSTAT 
See FIND-XXXX for usage of the following words:
  FIND-ADR 
  FIND-CONT 
  FIND-DATA 
  FIND-HADR 
  FIND-HDATA 
  FIND-LADR 
  FIND-MISC 
  FIND-WDATA
FIND-XXXX 
INSIGHT (currently available on Z80 only.  Updates for all
    processors will be ready soon, and you will receive an
    update.)
 
See the entry for EDIT_MACROS (Shift-F10) 
  for usage of the following words:
  MACRO_2
  MACRO_3
  MACRO_4
  MACRO_5
  MACRO_6
  MACRO_7
  MACRO_8
  MACRO_9
EMMOVE0
EMMOVE1
HELP_DEBUG
NX
READ-ROM
SET-EM       (Alt-F7)
SET-TRIG     (F6)
SHOW_MACROS  (Shift-F1)
USEC?
WRITE-EPROM

These words, which are also in the 8420 command set have
different functions:

     DN - needs no parameter. A small menu comes waiting for an
          address or page/line down.

     FKEY? - Display is graphical, showing all 40 assignments.

     N   (F3) is now equivalent to STEP-OVER, and all references to N should
          be changed to STEP-OVER.

     NMI (F4) is now equivalent to STEP-INTO and all references to NMI
          should be changed to STEP-INTO.

Some things have been expanded:
     MODE now allows turning COLOR on and off. (A new word COLOR'
          is added).
     MENUs have changed slightly.  F5 from main menu calls INSIGHT 
          (currently, Z80 only).
          Analyzer menu has the SET-TRIG menu available, and
          as a result the second analyzer menu is eliminated.
     TSTAT looks different.
     Messages are improved, especially for no INIT, for failed
          RB, for waiting RB, for waiting trigger with S, for
          no analyzer clock.
     MEMO has it own separate file, and the screen editor 
          has been improved.

These 8420 functions have been eliminated from the 8620:

COM1         COM2
AUX1         AUX2
ASEG         HEXRCV
LOG          LOG'
HDG          HDG'


*  *  *  *  *  *  *  *  *  *
*  The Utilities Diskette  *
*  *  *  *  *  *  *  *  *  *

Due to the size of the program, ten files are included on the 
Utilities Diskette which are not required for most operating 
features of the UniLab 8620. It is recommended that these be 
left off your disk and used only when needed if you have a 
floppy-disk based computer.  If you have a hard disk, put them 
all on your \ORION directory with the rest of the UniLab 8620
software. These files do the following functions:

    1LB400.VIR
    2LB400.VIR
    3LB400.VIR  are the graphical pinout libraries.  You
                cannot use the command PINOUT or CATALOG,
                or see any pinouts from the TOOLKIT menu 
                without these files.

    EDIT.VIR
    MEMO.SCR
    UTIL.VIR  are used for the MEMO pad and are used if you
              want to use our file system for making macros.  
              You cannot call MEMO (Alt-F2) without these files.

    ASM.VIR  is the assembler for making code macros
             or extensions to UniLab program.  See the PADS 
             documentation for more details.  You will probably not 
             need this file.  It does not affect the use of the UniLab 
             8620 with the target system in any way.

    MAKE     is an executable file called from the UniLab software 
             when you use the command MAKE-OPERATOR.  You cannot use
             the command MAKE-OPERATOR without this file.

   LOADER.EXE 
   LOADER.OPR are used as described below. You cannot convert
              the symbol/object file types listed below into files 
              usable by the UniLab without these files.

* * * * * * * * * * *
*  Loader  Ver 1.2  *
* * * * * * * * * * *

Standalone processor for symbol and object code files

This section explains the standalone file processor, version
1.2.
 
INVOKING THE LOADER
The program is named LOADER.EXE.  The suggested usage is calling
it in a batch file after your linker.  Call it with command line
arguments (see below).

You can also invoke it from DOS with the command LOADER, or from
the SYMTYPE menu within the UniLab with the choice
"Additional formats supported" (function key nine). 

FORMATS PROCESSED BY LOADER
This release will load in four different types of files, as shown
by the menu:

F1 OMF51  -- Intel Object Module Format for the 8051 family.(o s)
F2 OMF86  -- Intel Object Module Format for the 88/86 family.(o s)
F3 TEKHEX -- Tektronix Hex. (o)
F4 MOTORS -- Motorola S records. (o)
F9 Go to LOADER command mode.
F10 EXIT from LOADER
       s = symbols    o = object code

The loader always makes two passes through the file, and keeps you
informed of the loading status.   

PROCESS A FILE FROM THE MENU
Press a function key -- you will be prompted for the file name. 
After the file has been processed, the LOADER program terminates,
returning you to DOS or to the UniLab system. 

Invoke the LOADER with command line arguments
The loader takes the following command line arguments:
  -O <filename>                 changes output filename
  -D                            eliminates duplicate symbols
  -E                            report all errors and warnings
  <load command> <filename>     load (process) a file

       The four load commands are:
       OMF51     OMF86     TEKHEX    MOTORS
and the load command must be the last command line argument.

For example:
       C> LOADER -O VERS02   -D   OMF51 SIEVE.OBJ 
will process file SIEVE.OBJ, eliminate duplicate symbols, and
create output files VERS02.BIN and VERS02.SYM.  

When you invoke the loader with command line arguments, it will
exit to DOS upon successful completion of the load.

PROCESS A FILE WITH COMMANDS FROM WITHIN LOADER 
You can enter any of the command line arguments after you've
entered the loader.  First, press F9 to enter command mode, then
enter any command. Command mode allows you to look back over a
record of the loading process (see next page).   Use the command
BYE to exit.

REVIEW THE LOADING -- COMMAND MODE ONLY
If you wish to review the loading process, press F5 repeatedly. 
This moves backward through a recorded buffer of the actions taken
by the loader.  Move forward again with F6.  

FILES CREATED BY LOADER
The loaders create binary files containing the object code, and,
if the file contains symbols, a symbol file.  

The symbols are saved to the file <base-name>.SYM, where 
<base-name> is ORION unless you use the -o command.

If the format can only address a single 64K segment ( OMF51,
TEKHEX), then the object code is saved in a file called
<base-name>.BIN.  

If the format can address multiple 64K segments, then a binary
file is created for each 64K emulation memory segment that is
addressed by the file.  Each of these files has a name in the form
X<base-name>.BIN, where X is the hexadecimal number of the
=EMSEG to load the file into.  For example, FORION.BIN should get 
loaded into F =EMSEG.

LOAD INTO UNILAB
After loader creates these files, it tells you where to load each
binary file.  

From within the UniLab program, enable memory in the proper emseg,
and use BINLOAD to load the binary file(s).  

The symbol file is in Orion format, and gets loaded in with
SYMLOAD.

The binary file (but not the symbol file) can be loaded into the
UDL as well.
