README.TXT file   8 May 87

   This document includes information on new and altered
features of the UniLab II software, release 3.31.

There are sections on each of the following topics:
- New words added to version 3.12 & 3.2
- Changes from version 3.2
- Changes in version 3.30
- Changes in version 3.31

Keep in touch with us!  Send in your comments on software, hardware, wishes,
gripes, etc.  We are interested in what you are doing.  The next edition of
the Orion Express user publication will be out shortly.  Make sure you are
registered with us so you will receive this on a regular basis.  

We now have available a number of emulation modules which
simplify cable hookup.  These modules are special cables terminated
in a small pod to plug into the target processors socket on your
board.  Contact us for details.

* * * * * * * * * * * * * * * * * * * * *
* New words added in version 3.12 & 3.2 *
* * * * * * * * * * * * * * * * * * * * *

=WAIT - Used to set a pause after startup so long resets won't
give
" No Analyzer Clock" .  See on-line Glossary

SSAVE - Screen save. See glossary.

<TST> - Word to configuring for advanced tests.  You can type 
 1  '  <TST>  !   to set to test mode.  This has the effect of
suppressing some error messages.  It will also leave numbers on
the
stack for M? and MM? rather showing them immediately. Also some
DEBUG words will leave value on stack rather than displaying
them,
such as INP in the Z80.  This is for macro testing words.  Return
to normal with  0  '  <TST>  !  .  Only available OPERATOR mode (see below).

TX - List textfile from line number n.  
   Example:   50 TX
This will list the currently open textfile ( opened with TEXTFILE
command ) from line number 50H.  This command was in previous
versions, but was not documented.


* * * * * * * * * * * * * * * * * * * *
*  Changes & new words added to 3.30  *
* * * * * * * * * * * * * * * * * * * *

MODIFY - This is a great new command for displaying and altering memory.  For
most cases it should completely replace the use of ORG, M, MM, MDUMP, etc. 
These words are still available, but usually you'll find it more convenient
to use MODIFY.

Type  <adr> MODIFY  to get a full window memory dump.  Use the cursor keys
to move to the location you wish to change and type in a new value.  Note
that the right half of the window shows the equivalent dump in ASCII values. 
You can enter things in ASCII if you want to change embedded strings or text
in your code by pressing   Ctrl-Right Arrow  .  This puts the cursor over in
the ASCII section.  Just type in whatever you want to change.  Equivalent hex
will show in the left hex dump.  Use Arrow Up and Arrow Down to get a new
line in from the top or bottom, or use Pg Up and Pg Dn to dump the next or
previous area of memory.  

Memory that is changed and scrolled off the screen is modified.  Memory that
is changed on the screen can be "undone" by pressing the Esc key to exit. 
Otherwise, use End to save modifications.  MODIFY works on both emulation
memory and target ram (as long as you can establish DEBUG).


* * * * * * * * * * * * * *
* OPERATOR & MACRO modes  *
* * * * * * * * * * * * * *

OPERATOR - The system can now be configured in the OPERATOR mode which
"hides" many of the Forth words.  This means that the beginning user, or the
user who does not wish to use the Forth system can avoid confusion. 
For instance, this prevents the user from accidentally typing in WORD rather
than WORDS, leading to unexpected results.

It also shields the user from accidentally entering the compile mode or from
causing disastrous crashes from unknowingly using Forth commands.  The "ok"
prompt in lower case indicates the OPERATOR mode. 

In the OPERATOR mode you can use all of the UniLab commands that are in the
manuals, the menus, and the on-line help, but you cannot make macros.

MACRO - The system as delivered comes up in the OPERATOR mode.   To get in
the MACRO mode, type MACRO and then you will be asked to save the system. 
You will be in MACRO mode and a number of advanced UniLab commands will be
available, and the entire Forth system can be used.  You must be in the MACRO
mode to make macros. You can extend the system, and return to OPERATOR mode
by typing OPERATOR and saving the system. The "OK" prompt in upper case
indicates the MACRO mode.

You can use SAVE-SYS to save the system in the MACRO mode, and the next time
you enter the system you will be in the MACRO mode.

If you want to make macros and save the system in an OPERATOR mode, you must
use the MAKE-OPERATOR command.  This word will first save the system in the
MACRO mode, asking you for a file name, then will re-configure for the
OPERATOR mode, again asking you for a file name.  Use the same file name if
you want, or make different names in order to have both an OPERATOR and MACRO
system available on entry to the system. 

The MAKE-OPERATOR command actually uses our compiler and has some features
for advanced users.  Two commands can be used to determine whether a newly
defined macro will be available in the OPERATOR mode.  The new commands are
NOV-HDS and EXP-HDS.  

Whenever you type NOV-HDS (the default mode), the macros defined afterward
will be available in both OPERATOR and MACRO mode (after using MAKE-
OPERATOR).

Whenever you type EXP-HDS, the macros defined afterward will be available
only in the MACRO mode.

Here is an example:

          EXP-HDS

          : SUB BINLOAD MYOWN.BIN ;
          : SUB2 0 10 DM ;

          NOV-HDS

          : DOIT SUB SUB2 ;

          EXP-HDS

          : DO3 DOIT DOIT DOIT ;

If these macros are defined and MAKE-OPERATOR is invoked, only the word DOIT
will be available in the OPERATOR system.  SUB, SUB2, DOIT and DO3 will be
available in the MACRO system. 



* * * * * * * * * * * *
* Command Line Editor *
* * * * * * * * * * * *

Command Line Editor - You can now edit the command line.  This means if
you are typing in a long command or trigger spec and realize that you made a
mistake anywhere on the line, you can back up correct the mistake and then
enter the entire command without retyping.  Use the Left and Right Arrow keys
to move the cursor (or use Ctrl S and Ctrl D).  Use the Del key or the back
arrow to wipe out a character. You are always in the "insert" mode.
Characters typed in will cause the line to expand.  The cursor position must
be at the end of the command you want executed.  Use Ctrl Right Arrow to move
to the end of the line before you hit Enter to execute the command.  Use Ctrl
Left Arrow to move to the beginning of the line for editing.

You can use Ctrl Pg Up and Ctrl Pg Dn to move the cursor up or down on the
screen.  The cursor will be placed at the end of the line.  This allows you
to go back and edit a command which you entered incorrectly without retyping
the entire line. Using the Up Arrow to retrieve lines from screen history,
this should save lots of time. 

If you are used to some common word processor cursor keys, note that Ctrl A
and Ctrl F are the same as Ctrl Right and Left Arrows.  Ctrl E and Ctrl X are
equivalent to Ctrl Pg Up and Ctrl Pg Dn.

* * * * *
* RES-  *
* * * * *

RES- - This command is now on Shift F9.  You can issue a forced constant low
reset via the RES- output line to your processor.  This is good for those
cases where accessing emulation memory from the host causes your processor to
act up.  Enter RES- or press Shift F9 to put your target in a held reset
state, then download code via BINLOAD, examine memory, whatever, the
processor will ignore the disruptions to the bus since its Reset line is
being held low.  Starting the analyzer will release it from reset.


*   *   *   *   *   *   *   *   *   *   *   *
*  Changes over previous version (3.2)   *
*   *   *   *   *   *   *   *   *   *   *   *

An 8086/88 related problem due to setting addresses greater than 16 bits is
fixed.

A number of words which, if called from the menus, would cause system crashes
are now protected, and cannot be executed from the menu mode.  These words
include ?FREE, SSAVE, TSAVE, TSHOW, TCOMP, MODE and others.

These things were cleaned up:
An error in the line-by-line assembler no longer forces you out of the
assembler.  You will stay on the same line and be able to re-enter the
instruction.  Branch out of ranges will also be handled in this manner.

Emulation memory operations moving data should not cause any difficulties
across the 32K boundaries.

The screen is redrawn after leaving the MODE panel.

Disassembling large areas from emulation memory will no longer show periodic
errors.

Mode switch settings are now saved with SAVE-SYS.

A message is displayed after using HELP <cmd> or WORDS to show that more text
can be displayed with the Pg Dn key.

The RES- is added internally to all DDB packages to prevent "glitches" on the
target's bus when during startup.  If you have had problems with target ram
being overwritten on startup, this should no longer be a problem.

RES-' command will disable the above feature.  It does not turn of the reset
signal, but disables the long reset while we are doing our patches to
emulation memory when the target syste is started. This is only useful if
your reset circuit is a single-shot which might allow the processor's reset
pin to go high before our reset signal does.  RES- will re-enable this
feature.

* * * * * * * * * * *
*  Changes in 3.31  *
* * * * * * * * * * *

1. DOS now does a couple of extra carriage returns so that the command itself
will not get overwritten.  The command line editor can be used on the line if
a mistake is made.

2. SYMSET command is added.  This is available in the MACRO mode for those
who wish to configure the symbol conversion set by SYMTYPE and used by
SYMFILE.  The syntax is <n> SYMSET, where <n> is a number equivalent to these
symbol types:
        
1   2500AD SOFTWARE
2   2500AD SOFTWARE (abbreviated)
3   ALLEN ASHLEY
4   INTEL ISIS-II (MCS-51 only )
5   MICROTEK FORMAT (New Micro, not Microtec-2500AD can make this format
                     and it is usually more convenient than declaring
                     all symbols global just to get them into a symbol
                     file in their other formats)
6   OTHER FIXED FORMAT  (Use SYMFIX directly, since this is
                         just a menu-driven setting of SYMFIX)
7   MANX AZTEC C  (value, variable length name)
8   AVOCET        (variable length name, value)

3. The prom programming/reading words are made available in the OPERATOR
mode.

4. MODIFY had problems when dealing with target ram displays larger than 80
hex bytes.  This has been corrected.

5. Symbols read in by SYMFILE are now always converted to upper case.

6. Disk full error handling improved.

7. VLIST now shows all available commands.

8. HEXLOAD now works when loading Intel Extended Hex files to different
EMSEGs.

9. The PPA has be changed slightly to protect it from getting RS-232 errors
when transmitting data to the host.

10. 27512 reading/programming in 16bit mode is now working in menu mode.