This directory contains the FORTH source code for a simple RTX2000 resident
debug monitor.  The monitor is ASCII character based and requires hardware 
specific I/O routines to be added for character input and output. 

If the target system supports serial I/O, an Amiga or IBM PC based terminal
emulation program can be used to communicate with the monitor.  The same
computer can host the fc compiler.  Once the monitor is in place and hooked
up to the AMIGA or PC, software can be developed and downloaded to run on 
the RTX2000.  The debug monitor supports download of the software and 
execution of programs on the RTX2000 system.  

Using the debug monitor, fc, and your favorite text editor and terminal 
emulation programs, you will have a simple RTX2000/RTX2010 development system.
      
     Definition files required for building the debug monitor:
       rtx2000.f -- defines rtx2000 register as ASIC bus locations
       logic.f -- definitions for TRUE and FALSE
       equal.f -- a definition of =
       shift.f -- definitions of shift instructions 


     Source ( code defintions ) files required for build:
       main -- Main loop and calls out required modules for build
       debugger -- Actual debugger code
       util -- Support routines for debugger
       gp -- Commonly used FORTH words
       io -- I/O module ( includes user supplied io routines )
  
     Instructions for use:

        1- Write I/O specific routines for key, emit, and initio 
           ( See io module for details )

        2- Set the heap and code addresses located in "main" to
           control addresses for code and variables

        3- Compile all files together using the command

              fc -lexs main

           to generate files compatiable with a DATAIO programmer

        4- Program PROMS or EEPROMs and install into system

        5- Application programs can now be downloaded from a host
           to the RTX2000 system using the monitor.  These application
           programs may call certain routines in the monitor if they
           inclued the file main.x generated when compiling the 
           monitor.
     

  Debugger commands:
     A hex_address                              Alter Memory
     C hex_address_a hex_address_b hex_count    Copy Memory a to Memory b
     D hex_address hex_count                    Dump Memory
     G hex_address                              Go to Address
     S                                          Print stack pointer register
     X                                          Enter Download mode

     Download mode accepts a .ols file generated by the fc complier when fc
     is invoked with the -o option.  Download mode accepts the ascii/hex file 
     and loads it into memory. Once download mode is entered, the monitor 
     remains in download mode until an escape character is received.  When 
     an escape is received, the monitor will print out a check sum that 
     should be zero after error free download. 
