Mercurial > hg > Members > kono > os9 > sbc09
annotate README-os9.txt @ 191:d0f5894e9b3a default tip
some how load: confilicts in gmake
author | kono |
---|---|
date | Thu, 07 Dec 2023 09:37:15 +0900 |
parents | 0eb94a8e4d0d |
children |
rev | line source |
---|---|
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 | |
183
0eb94a8e4d0d
Apple clang version 13.1.6 (clang-1316.0.21.2.5)
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents:
131
diff
changeset
|
43 src/v09 -rom os9/os9v1.rom -v os9/level1 -0 os9/OS9.dsk -1 os9/WORK.dsk |
0eb94a8e4d0d
Apple clang version 13.1.6 (clang-1316.0.21.2.5)
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents:
131
diff
changeset
|
44 src/v09c -rom os9/os9v2.rom -v os9/level2 -0 os9/OS9.dsk -1 os9/WORK.dsk |
57 | 45 |
131 | 46 use -nt for trace debug without timmer interrupt. |
47 | |
183
0eb94a8e4d0d
Apple clang version 13.1.6 (clang-1316.0.21.2.5)
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents:
131
diff
changeset
|
48 OS9> dir |
0eb94a8e4d0d
Apple clang version 13.1.6 (clang-1316.0.21.2.5)
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents:
131
diff
changeset
|
49 OS9> dir /d0/cmds |
0eb94a8e4d0d
Apple clang version 13.1.6 (clang-1316.0.21.2.5)
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents:
131
diff
changeset
|
50 OS9> mdir |
0eb94a8e4d0d
Apple clang version 13.1.6 (clang-1316.0.21.2.5)
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents:
131
diff
changeset
|
51 OS9> mfree |
0eb94a8e4d0d
Apple clang version 13.1.6 (clang-1316.0.21.2.5)
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents:
131
diff
changeset
|
52 |
57 | 53 |
54 Structure | |
55 --------- | |
56 | |
57 src/ | |
58 a09.c | |
59 The 6809 assembler. It's fairly portable (ANSI) C. It works on Unix | |
60 | |
61 Features of the assembler: | |
62 - os9 directives | |
63 - Statements MACRO, PUBLIC, EXTERN IF/ELSE/ENDIF INCLUDE not yet | |
64 implemented. | |
65 | |
66 v09.c | |
67 engine.c | |
68 io.c | |
69 trace.c | |
70 The 6809 single board simulator/emulator v09. | |
71 -DUSE_MMU to use MMU | |
72 vdisk.c | |
73 mount current directory on /v0 using VRBF | |
74 | |
75 d09.c | |
76 6809 disassembler with os9 feature | |
77 | |
78 os9/ | |
79 makerom.c make rom for level1 and level2 | |
80 os9mod.c check os9 module | |
81 -s skip fill bytes | |
82 crc.c os9 crc checker | |
83 level1 os9 level1 module | |
84 clock.asm | |
85 d0.asm | |
86 d1.asm | |
87 v0.asm | |
88 init.asm | |
89 pdisk.asm | |
90 printer.asm | |
91 pty-dd.asm | |
92 pty.asm | |
93 level2 os9 level2 module | |
94 boot.asm | |
95 defsfile | |
96 init.asm | |
97 clock.asm | |
98 sysgo.asm | |
99 vector.asm | |
100 vrbf.asm virtual rbf manager | |
101 v0.asm | |
102 | |
103 v09/v09c feature | |
104 | |
105 Usage: v09 [-rom rom-image] [-t tracefile [-tl addr] [-nt][-th addr] ] [-e escchar] | |
106 [-0 diskImage0] [-1 diskImage1] | |
107 | |
88 | 108 with Coco MMU |
109 Usage: v09c [-rom rom-image] [-t tracefile [-tl addr] [-nt][-th addr] ] [-e escchar] | |
57 | 110 [-0 diskImage0] [-1 diskImage1] |
111 | |
112 -nt start with trace on | |
113 -rom options use irq ( not firq ) timer, timer will not start until timer IO command | |
114 vrbf default is a current directory | |
115 | |
116 v09 tracing command ( may be very slow ) | |
117 | |
118 v09>h | |
119 s [count] one step trace (default) | |
120 n step over call or os9 system call | |
121 f finish this call (until stack pop) (unreliable) | |
122 b [adr] set break / watch point (on current physical address) | |
123 it stoped on pc==adr or value of adr was changed | |
124 B break / watch point list | |
125 d [n] delte break point list | |
126 c [count] continue; | |
127 x disassemble on pc | |
128 x [adr] [count] dump | |
129 xp page [adr] [count] mmu page dump | |
130 xi [adr] [count] disassemble | |
131 0 file disk drive 0 image | |
132 1 file disk drive 1 image | |
133 L file start log to file | |
134 S file set input file | |
135 X exit | |
136 q exit | |
137 U file upload from srecord file | |
138 D file download to srecord file | |
139 R do reset (unreliable) | |
140 h,? print this | |
141 | |
142 to see GIME | |
143 x 0xff90 | |
144 | |
145 a09 Assembler for os9 | |
146 ------------- | |
147 | |
148 mod eom,name,tylg,atrv,start,size define os9 mod with crc | |
149 . data pointer ( same as *, only works just after the mod ) | |
150 * code pointer | |
151 emod | |
152 | |
153 os9 os9 system call | |
154 end | |
155 | |
156 fcs generates os9 string with 8th bit on termination | |
157 | |
158 use use os9 sources ( subsequent use/lib follow the directories ) | |
159 | |
160 accepts some more chars in names such as $ . _ | |
161 | |
162 | |
88 | 163 os9 command |
164 ------------- | |
165 src/os9/level1/cmds | |
166 src/os9/level2/cmds | |
167 | |
168 sbc09 sbc09 emulator on os9 | |
131 | 169 OS9: sbc09 kernel09.s |
170 OS9: sbc09 basic.s | |
88 | 171 |
172 Todo ( program load command on game09 and forth ) | |
173 | |
131 | 174 ================ |
175 | |
176 Micro C | |
177 ------------- | |
178 src/os9/mc09 | |
179 only working on level2 | |
180 | |
181 OS9: mc09/mc-s -Mtestcp test/cp.c | |
182 | |
183 % src/a09 crtos9.asm -l c.lst -o testcp | |
184 | |
185 | |
186 GAME09 | |
187 ------------- | |
188 game09 | |
189 src/os9/level[12]/game09 | |
190 | |
191 OS9: game09 | |
192 | |
193 > \LD "game09/asm09.game" | |
194 > #=1 | |
195 | |
196 TL/1 | |
197 ------------- | |
198 TL/1 | |
199 | |
200 OS9: tl1 tl1/test/t1.tl1 | |
201 | |
202 | |
57 | 203 Links/References |
204 ================ | |
205 | |
206 | |
207 Project: | |
208 https://github.com/6809/sbc09 | |
209 Maintained by the original author and others. | |
210 | |
211 Source: | |
212 http://groups.google.com/group/alt.sources/browse_thread/thread/8bfd60536ec34387/94a7cce3fdc5df67 | |
213 Autor: Lennart Benschop lennart@blade.stack.urc.tue.nl, | |
214 lennartb@xs4all.nl (Webpage, Subject must start with "Your Homepage"!) |