summaryrefslogtreecommitdiff
path: root/emulators/sim6811/files/patch-sim6811.1
blob: 58b932f662eedbef60231137db76fe12ff9bc02a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
*** sim6811.1~	Wed Sep  6 10:58:03 1995
--- sim6811.1	Wed Sep  6 10:59:11 1995
***************
*** 0 ****
--- 1,71 ----
+ .Dd June 5, 1993
+ .Dt sim6811 1
+ .Os BSD 4
+ .Sh NAME
+ .Nm sim6811
+ .Nd very simple and crude simulator for the 6811
+ .Sh SYNOPSIS
+ .Nm sim6811
+ .Ar s19-file
+ .Sh DESCRIPTION
+ .Ar s19-file
+ is a Motorola s19 assembler output file
+ 
+ some instructions aren't there yet (notably converning multiplication
+ and interrupts) and the interface only allows stepping.  this should
+ be easily rectifiable, however, and the simple structure should make
+ grafting on a graphical interface quite simple.
+ 
+ to run the simulator, just provide the name of an object file on the
+ command line.  the object file must be in s19 format, and must include
+ a reset vector in order to tell the simulator where to start
+ execution.  simulation proceeds one instruction at a time, with a
+ register and page zero memory dump being performed at each step.
+ 
+ several simple commands are supported, but additional commands to
+ modify memory, cause interrupts and simulate the special registers
+ would all be nice, and relatively easy to add.
+ 
+ .Sh COMMANDS
+ 
+ The current
+ .Nm sim6811
+ command set includes
+ 
+ .Bl -tag -width Ds
+ 
+ .Nm l [address [n]]
+ .br
+ .ti 8
+ disassemble n instructions starting at address
+ 
+ .Nm g [address [n]]
+ .br
+ .ti 8
+ go starting at address for n steps.  
+ 
+ .Nm s [n]
+ .br
+ .ti 8
+ step n times (n=1 default)
+ 
+ .Nm b [address[cnt]]
+ .br
+ .ti 8
+ set a breakpoint, which will stop cnt times
+ 
+ .Nm t [address[cnt]]
+ .br
+ .ti 8
+ set a temporary breakpoint.
+ 
+ .Nm <empty-line>
+ .br
+ .ti 8
+ step once
+ 
+ .Sh HISTORY
+ .Nm sim6811
+ was written by Ted Dunning <ted@nmsu.edu>. This manual page was created out of
+ various C-sources by Eric L. Hernes <erich@rrnet.com>.  Some example sources
+ and s19 files can be found in ftp://crl.nmsu.edu/pub/non-lexical/6811