57
|
1 6809 Simulator/Emulator for OS9
|
|
2 =======================
|
|
3
|
|
4 sbc09 stands for Lennart Benschop 6809 Single Board Computer.
|
|
5 It contains a assembler and simulator for the Motorola M6809 processor.
|
|
6
|
|
7 copyleft (c) 1994-2014 by the sbc09 team, see AUTHORS for more details.
|
|
8 license: GNU General Public License version 2, see LICENSE for more details.
|
|
9
|
|
10
|
|
11 Forum thread: http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=8&t=4880
|
|
12 Project: https://github.com/6809/sbc09
|
|
13
|
|
14
|
|
15 For the usage of the assembler a09 and 6809 single board system v09
|
|
16 read doc/sbc09.creole!
|
|
17
|
|
18
|
|
19 This distribution includes
|
|
20 1. The 6809 single board system as a stand alone environment built as v09
|
|
21 1. with CoCo like MMU v09c
|
|
22
|
|
23 How to make
|
|
24 ---------
|
|
25
|
|
26 make clean; make
|
|
27
|
|
28
|
|
29 How to run
|
|
30 ---------
|
|
31
|
|
32 make lv1
|
|
33
|
|
34 or
|
|
35
|
|
36 make lv2
|
|
37
|
|
38 vrbf mount current directory on /v0, put os9 command there.
|
|
39
|
|
40 You can add os9 disk image using -0 or -1 option ( ex. https://github.com/sorenroug/osnine-java.git )
|
|
41
|
|
42 src/v09 -rom src/os9/os9lv1.rom -0 OS9.dsk -1 WORK.dsk
|
|
43
|
|
44 src/v09c -rom src/os9/os9lv2.rom -0 OS9.dsk -1 WORK.dsk
|
|
45
|
|
46
|
|
47 Structure
|
|
48 ---------
|
|
49
|
|
50 src/
|
|
51 a09.c
|
|
52 The 6809 assembler. It's fairly portable (ANSI) C. It works on Unix
|
|
53
|
|
54 Features of the assembler:
|
|
55 - os9 directives
|
|
56 - Statements MACRO, PUBLIC, EXTERN IF/ELSE/ENDIF INCLUDE not yet
|
|
57 implemented.
|
|
58
|
|
59 v09.c
|
|
60 engine.c
|
|
61 io.c
|
|
62 trace.c
|
|
63 The 6809 single board simulator/emulator v09.
|
|
64 -DUSE_MMU to use MMU
|
|
65 vdisk.c
|
|
66 mount current directory on /v0 using VRBF
|
|
67
|
|
68 d09.c
|
|
69 6809 disassembler with os9 feature
|
|
70
|
|
71 os9/
|
|
72 makerom.c make rom for level1 and level2
|
|
73 os9mod.c check os9 module
|
|
74 -s skip fill bytes
|
|
75 crc.c os9 crc checker
|
|
76 level1 os9 level1 module
|
|
77 clock.asm
|
|
78 d0.asm
|
|
79 d1.asm
|
|
80 v0.asm
|
|
81 init.asm
|
|
82 pdisk.asm
|
|
83 printer.asm
|
|
84 pty-dd.asm
|
|
85 pty.asm
|
|
86 level2 os9 level2 module
|
|
87 boot.asm
|
|
88 defsfile
|
|
89 init.asm
|
|
90 clock.asm
|
|
91 sysgo.asm
|
|
92 vector.asm
|
|
93 vrbf.asm virtual rbf manager
|
|
94 v0.asm
|
|
95
|
|
96 v09/v09c feature
|
|
97
|
|
98 Usage: v09 [-rom rom-image] [-t tracefile [-tl addr] [-nt][-th addr] ] [-e escchar]
|
|
99 [-0 diskImage0] [-1 diskImage1]
|
|
100
|
88
|
101 with Coco MMU
|
|
102 Usage: v09c [-rom rom-image] [-t tracefile [-tl addr] [-nt][-th addr] ] [-e escchar]
|
57
|
103 [-0 diskImage0] [-1 diskImage1]
|
|
104
|
|
105 -nt start with trace on
|
|
106 -rom options use irq ( not firq ) timer, timer will not start until timer IO command
|
|
107 vrbf default is a current directory
|
|
108
|
|
109 v09 tracing command ( may be very slow )
|
|
110
|
|
111 v09>h
|
|
112 s [count] one step trace (default)
|
|
113 n step over call or os9 system call
|
|
114 f finish this call (until stack pop) (unreliable)
|
|
115 b [adr] set break / watch point (on current physical address)
|
|
116 it stoped on pc==adr or value of adr was changed
|
|
117 B break / watch point list
|
|
118 d [n] delte break point list
|
|
119 c [count] continue;
|
|
120 x disassemble on pc
|
|
121 x [adr] [count] dump
|
|
122 xp page [adr] [count] mmu page dump
|
|
123 xi [adr] [count] disassemble
|
|
124 0 file disk drive 0 image
|
|
125 1 file disk drive 1 image
|
|
126 L file start log to file
|
|
127 S file set input file
|
|
128 X exit
|
|
129 q exit
|
|
130 U file upload from srecord file
|
|
131 D file download to srecord file
|
|
132 R do reset (unreliable)
|
|
133 h,? print this
|
|
134
|
|
135 to see GIME
|
|
136 x 0xff90
|
|
137
|
|
138 a09 Assembler for os9
|
|
139 -------------
|
|
140
|
|
141 mod eom,name,tylg,atrv,start,size define os9 mod with crc
|
|
142 . data pointer ( same as *, only works just after the mod )
|
|
143 * code pointer
|
|
144 emod
|
|
145
|
|
146 os9 os9 system call
|
|
147 end
|
|
148
|
|
149 fcs generates os9 string with 8th bit on termination
|
|
150
|
|
151 use use os9 sources ( subsequent use/lib follow the directories )
|
|
152
|
|
153 accepts some more chars in names such as $ . _
|
|
154
|
|
155
|
88
|
156 os9 command
|
|
157 -------------
|
|
158 src/os9/level1/cmds
|
|
159 src/os9/level2/cmds
|
|
160
|
|
161 game09 VTL interpreter on os9
|
|
162 sbc09 sbc09 emulator on os9
|
|
163 OS9: sbc09 ../../../examples_forth/kernel09
|
|
164
|
|
165 Todo ( program load command on game09 and forth )
|
|
166
|
57
|
167 Links/References
|
|
168 ================
|
|
169
|
|
170
|
|
171 Project:
|
|
172 https://github.com/6809/sbc09
|
|
173 Maintained by the original author and others.
|
|
174
|
|
175 Source:
|
|
176 http://groups.google.com/group/alt.sources/browse_thread/thread/8bfd60536ec34387/94a7cce3fdc5df67
|
|
177 Autor: Lennart Benschop lennart@blade.stack.urc.tue.nl,
|
|
178 lennartb@xs4all.nl (Webpage, Subject must start with "Your Homepage"!)
|