COMMANDS (activated by the mouse)


File                    Help, load, save, shell and quit commands.

        Help            Displays helptexts, use arrows, PgUp, PgDn, Home, End
                        and Enter to scroll the helptext, use Esc to exit.

        Load prog       Loads a 6809 program in Motorola, Intel, IAR Symbolic
                        or IAR Typed format. Default extension is ".A09".
                        Old labels are not deleted.

        Load simdef     Loads a simulation definition file, which defines
                        the RAM, ROM, I/O addresses and labels. Default
                        extension is ".SIM". Old labels are not deleted.

        Load status     Loads earlier saved status, containing register and
                        eventtable (breakpoints) values. Default extension
                        is ".STA".

        Save status     Saves status, see above, overwrites without question.

        Load memory     Loads earlier saved memory area. Default extension
                        is ".MEM".

        Save memory     Saves memory, see above, overwrites without question.

        Load record     Loads earlier saved recordtables for redefined keys.
                        Default extension is ".STA". Existing redefinitions
                        are deleted.

        Save record     Saves record, see above, overwrites without question.

        Shell           Executes COMMAND.COM.

        Quit            Quit the SIM6809.EXE program and return to DOS.


Enter                   Enter (writes) data into memory or I/O.
Dump                    Dump (reads, displays) data in memory or I/O.
Watch                   Watch in window of data in memory or I/O.
        Byte            8-bit hexadecimal
        Word            16-bit hexadecimal (High byte first)
        Long            32-bit hexadecimal (High byte first)
        Ascii           8-bit (IBM) ASCII
        Single          IEEE Single Precision Binary Real Format (32-bit)
        Double          IEEE Double Precision Binary Real Format (64-bit)
        Float48         IEEE compatible 48-bit binary real format
        I/O             default is 8-bit hexadecimal, under userprogram
                        control.


Signal                  Simulates a hardware signal to the 6809 MPU.
        Reset           Reset
        IRQ             Interrupt Request
        FIRQ            Fast Interrupt Request
        NMI             Non Maskable Interrupt


Misc                    Miscellaneous commands
        To location     New location in "memory" or "tracebuffer"
        Memory          Selects "memory"
        Tracebuffer     Selects "tracebuffer"
        I/O action      Change/display I/O action on read/write
                        I/O action is mem, con or a filename.
                        For filenames the default extension is ".IOR"
                        respectively ".IOW". See I/O ACTION.
        Clear label     Clears labeltable
        Clear trace     Clears tracebuffer
        Fill memory     Fill memory with constant
        Message         Displays the startup message
        Swi             Change number of bytes after the SWI instruction
        Swi2            Change number of bytes after the SWI2 instruction
        Swi3            Change number of bytes after the SWI3 instruction


Up!     Left button     Scroll "memory" or "tracebuffer" up one line.
        Right button    Scroll "memory" or "tracebuffer" up one page.

Down!   Left button     Scroll "memory" or "tracebuffer" down one line.
        Right button    Scroll "memory" or "tracebuffer" down one page.

PC!                     Change location in "memory" or "tracebuffer" to PC.

Trace!  Left button     Trace single step to the next instruction.
        Right button    Go until the instruction on the next line, useful
                        to step over subroutines and loops.

Go!     Left button     Go (for ever) until event, or user press Esc.
        Right button    Go until address, asks for address.

Rec!                    Records a command sequence and associate it with a key.
                        The recording can be turned off by a second Rec!
                        command or by pressing Ctrl-C (valid also during
                        "Pause"). Record and playback are temporary turned off
                        if an error or event occurs, so called "Pause".

Cycles                  A 32-bit clock cycles counter in decimal. One cycle is
                        equal to one E period. Point at counter with the mouse
                        and press and release a mouse button to reset this
                        counter.

Registers/Flags         Point at a register or a flagbit with the mouse to
                        change value.

Eventtable              Table of events E1 to E9 under user control.
        Column 1        Read/Write/Fetch Enablebits
        Column 2        Address value
        Column 3        Count value (in hexadecimal) to ignore the event

Memory window           Displays the memory contents in assembly format.
        Left button     Sets a fetch event at pointed address.
        Right button    Go until pointed address.

Tracebuffer window      Displays the tracebuffer in assembly format.
                        The first value on each line is the tracebuffer index.
                        No commands can be given here.

Watch window            Displays watch data in different formats (see Watch).
        Any button      Remove pointed watchline.



PAUSE


During record or playback a window with the text "Pause" may be opened.

Pause during Record     If the key Ctrl-PrtSc is pressed "Pause" will appear
                        for about one second, to indicate that it is recorded.
                        If an error or an event occurs, "Pause" will appear
                        and the program waits for a non recording keystroke.
                        If the pressed key is Ctrl-C the recording is turned
                        off.

Pause during Playback   If the key Ctrl-PrtSc is found in the record or if
                        an error or an event occurs, "Pause" will appear and
                        the program waits for a keystroke. If the pressed key
                        is Ctrl-C or Esc the playback is turned off.



ARGUMENTS ON THE COMMAND LINE


sim6809 [prog [simdef [record]]]

prog    Pathname to a program file (see Load prog)
simdef  Pathname to a simulation definition file (see Load simdef)
record  Pathname to a record file (see Load record)



SYNTAX FOR THE SIMULATION DEFINITION FILE


Line 1:         Name of an user program file or the text: no user program
Line 2:         List of RAM areas, example: 0000-1FFF 3000-3FFF
Line 3:         List of ROM areas, example: 8000-9FFF F000-FFFF
Line 4:         Number of bytes after SWI, SWI2 and SWI3, example: 0 1 1

The rest in the file defines the I/O in definition blocks (many lines) or
the labelfiles to use. One I/O definition block looks like this (line values
are offsets):

Line 1:         The '#' character followed by a four digit hexadecimal base
                address value.

Line 2 to n:    The 'R' for Read, the 'W' for Write or the 'B' character for
                Read and Write, followed by an one digit hexadecimal offset
                address. An user name (not label) for the I/O register/port
                (max 21 characters, may contain spaces if surrounded by
                quotation marks) and default I/O action (mem, con or a
                filename of max 15 characters, see I/O ACTION). For type 'B'
                the user name are ignored, it is copied from the last 'R' type.

To include a labelfile, the '%' character is used followed by a filename to
a labelfile, default extension is ".LBL", example: %prog

One label definition line in the labelfile contains a four digit hexadecimal
address followed by the label (only the first 14 characters are used).

Note, if you are using a linker who can produce IAR Symbolic or Typed format
it's hardly likely that you need to use any labelfiles. This feature is
included for users that use Motorola or Intel formats and produce labelfiles
manually, or automaticly with a program, from crossreference lists.



I/O ACTION


I/O action:     Read:                           Write:

mem             No action, read value           No action, write value to the
                from the I/O register.          I/O register.

con             Ask for read value, default     Display the write value and
                is current register value.      write it to the I/O register.

filename        Read value from file at         Write the write value at the
                current file position.          end of the file and write it
                The file must contain           to the I/O register.
                one hexadecimal value on
                each line.

All file positions are given in byte offset from the start of the file.



PRERECORDED KEYS IN SIM6809.REC


The SIM6809.REC is always loaded (if found) when the SIM6809 program starts.

F1              Help
F2              Clear cycle counter
F3              Memory
F4              Tracebuffer
F5              Go
F6              To location
F7              Go until address
F8              Trace
F9              PC
F10             Trace to next line
Up-arrow        Scroll up one line (if mouse is used)
Down-arrow      Scroll down one line (if mouse is used)
PgUp            Scroll up one page (if mouse is used)
PgDn            Scroll down one page (if mouse is used)
Alt-S           Shell
Alt-Q           Quit (Quit cannot be recorded with the Rec! command)
F               File menu
E               Enter menu
D               Dump menu
W               Watch menu
S               Signal menu
M               Misc menu
X               Cancel menu and place the mouse in the register/event window



MOUSE SIMULATION


If no mouse driver is installed or if 'mouse enable' is cleared with the
SET6809.EXE program, an internal mouse simulator is used. The following
keys are used to simulate a mouse (and can therefore not be playbacked):

Home            Move mouse cursor up and to left
Up-arrow        Move mouse cursor up
PgUp            Move mouse cursor up and to left
Left-arrow      Move mouse cursor to left
Right-arrow     Move mouse cursor to right
End             Move mouse cursor down and to left
Down-arrow      Move mouse cursor down
PgDn            Move mouse cursor down and to right
Ins or Enter    Press (and release) mouse left button
Del or Esc      Press (and release) mouse right button

If a move cursor key is repeated within 385 ms a fast move is done.



INPUT OF VALUES AND STRINGS


During input of integer values the following keys have special meaning:

Enter (Left button)     End input
Esc (Right button)      End input, and ignore it (terminate command)
Backspace               Move cursor to left
Left arrow              Move cursor to left
Right arrow             Move cursor to right
Home                    Move cursor to start of field
End                     Move cursor to end of field
Ctrl-Home               Rewrite the default value (restart)
L or R                  Valid only for inputs of hexadecimal values.
                        Opens a window and asks for label or register
                        Valid register names are X,Y,U,S,PC,A,B,DP and D.

During input of strings and floating-point values the following keys, beyond
the above listed, have special meaning:

Backspace               Move cursor to left and delete character
Ins                     Insert toggle
Del                     Delete character and moves characters to left
Ctrl-Left arrow         Move cursor to previous word
Ctrl-Right arrow        Move cursor to next word
Ctrl-End                Delete all characters in entire field



        AnDan Software SIM6809 Version 1.01a
        Copyright (c) AnDan Software 1987-1989

        Shareware: SIM6809 may be copied if no fee is charged and if no
        changes are done. The source codes supplied with SIM6809 may only
        be copied for use with SIM6809. SIM6809 may not be shipped with
        other products, without permission from AnDan Software.

        Please help us distribute SIM6809 by copying it in it's
        unmodified form. Please make a contribution to us for using this
        program. We recommend a contribution of $20 for students, $50 for
        private use and $100 for companies, for each copy of SIM6809.
        Send an international check or money order to:

                      Seffle Instrument AB
                      P.O. Box 25
                      S-661 00  SÄFFLE
                      SWEDEN

                      Telephone +46 533 17250

        Mark the payment with "AnDan Software SIM6809 Version 1.01a". You
        may use Visa or MasterCard if you write a letter with your
        payment, card number, expiration date, and your signature.

        For Swedish users:      Telefon:        0533-17250
                                Postgiro:       509517-9
                                Bankgiro:       720-6733

        If you have questions, comments or find bugs in the program,
        please send electronic mail to the author, Anders Danielsson
        FidoNet 2:203/101. You may call AnDan BBS, where the newest
        versions and other AnDan Software programs always are
        downloadable for all users. Telephone 46-31-307364, CCITT V.22
        and Bell 212A (1200 bps), V.22bis (2400 bps) and USR HST 9600
        bps, MNP Level 5, 8 databits, no parity, and 1 stopbit.
