Appendix D. M1750 Simulator Options

Table of Contents
D.1. The Command Line
D.2. Command Line Switches
D.3. Examples of Simulator Use
D.4. How to Customize the Simulator

D.1. The Command Line

The simulator command line has the form:

$ m1750-coff-run switches files

You can get a summary of the options using the help option, as shown in the following example:

Example D-1. Simulator Help

$ m1750-coff-run -h
age: m1750-coff-run [options] [file...] 
Options:
  -a "ARGS", --args "ARGS"    Pass ARGS to simulator
  -B,   --branch-report       Print branch coverage report
  -b,   --branch-summary      Print branch coverage summary
  -C,   --coverage-report     Print coverage report
  -c,   --coverage-summary    Print coverage summary
  -d T, --delay T             Delay trace for T uSec
  -f MOD, --file FILE         Report coverage for this source file only
  -h,   --help                Print this message
  -i I, --pending I           Trigger trace on pending interrupt I
  -I I, --interrupt I         Trigger trace on interrupt level I
  -l T, --limit T             Time limit T uSec
  -m,   --trace-memory        Trace data memory cycles
  -M,   --trace-memory-wide   Trace data and instruction memory cycles
  -p,   --perf                Print performance summary
  -P PC, --pc PC              Trigger trace on pc = PC (use 0x for hex)
  -r,   --ram-tags-report     Print RAM tags report with large blocks
  -R,   --RAM-tags-report     Print RAM tags report with small blocks
  -s,   --stats               Print execution statistics
  -t,   --trace               Trace instructions using 70 columns
  -T,   --trace-wide          Trace instructions using wide format
  -u U, --resolution U        Set task trace resolution to U uSec
  -v,   --verbose             Print additional information
  -V,   --version             Print version number
  -w,   --wide                Widen a trace or report
  -y,   --nosys               Don't pass system calls to host
  -z,   --tasking-report      Print task switching report
  -Z,   --tasking-report-wide Print task switching report wide format
Simulator options are:
  -freq F           Set clock frequency to F MHz (default 10 MHz)
  -sof              Stop on fault (default)
  -nosof            Don't stop on fault, call handler
  -cpu 1750a        Simulate Generic 1750A (default)
  -cpu ma31750      Simulate Dynex MA31750
  -cpu mas281       Simulate Dynex MAS281
  -cpu pace         Simulate Pace 1750
  -cpu f9450        Simulate Fairchild F9450
  -cpu gvsc         Simulate Honeywell GVSC 
IO library options are:
  -uart1 DEV        Connect serial interface 1 to DEV
  -uart2 DEV        Connect serial interface 2 to DEV
  -slow             Run uarts at 9600 bps (default UNIX speed)
70 col trace format is:
     142.000 cpzn 0 0 1 0000 0000 0000 023456: l      r1,2,r14
           |    | | | |    |    |    |      |  |
           |    | | | |    |    |    |      |  `- Disassembled insn
           |    | | | |    |    |    |      `- Program counter (byte)
           |    | | | |    |    |    `- Pending Interrupt Register
           |    | | | |    |    `- Interrupt Mask
           |    | | | |    `- Fault register
           |    | | | `- Address state (hex)
           |    | | `- Processor state (hex)
           |    | `- Page bank (1750B)
           |    `- Condition codes
           `- CPU time in microseconds
  (status reported before execution)

Report problems to <support@xgc.com>