Mercurial > hg > Members > kono > os9 > sbc09
comparison README-os9.txt @ 57:2088fd998865
sbc09 directry clean up
author | Shinji KONO <kono@ie.u-ryukyu.ac.jp> |
---|---|
date | Mon, 23 Jul 2018 16:07:12 +0900 |
parents | |
children | a7576562324d |
comparison
equal
deleted
inserted
replaced
56:4fa2bdb0c457 | 57:2088fd998865 |
---|---|
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 | |
101 Usage: v09 [-rom rom-image] [-t tracefile [-tl addr] [-nt][-th addr] ] [-e escchar] | |
102 [-0 diskImage0] [-1 diskImage1] | |
103 | |
104 -nt start with trace on | |
105 -rom options use irq ( not firq ) timer, timer will not start until timer IO command | |
106 vrbf default is a current directory | |
107 | |
108 v09 tracing command ( may be very slow ) | |
109 | |
110 v09>h | |
111 s [count] one step trace (default) | |
112 n step over call or os9 system call | |
113 f finish this call (until stack pop) (unreliable) | |
114 b [adr] set break / watch point (on current physical address) | |
115 it stoped on pc==adr or value of adr was changed | |
116 B break / watch point list | |
117 d [n] delte break point list | |
118 c [count] continue; | |
119 x disassemble on pc | |
120 x [adr] [count] dump | |
121 xp page [adr] [count] mmu page dump | |
122 xi [adr] [count] disassemble | |
123 0 file disk drive 0 image | |
124 1 file disk drive 1 image | |
125 L file start log to file | |
126 S file set input file | |
127 X exit | |
128 q exit | |
129 U file upload from srecord file | |
130 D file download to srecord file | |
131 R do reset (unreliable) | |
132 h,? print this | |
133 | |
134 to see GIME | |
135 x 0xff90 | |
136 | |
137 a09 Assembler for os9 | |
138 ------------- | |
139 | |
140 mod eom,name,tylg,atrv,start,size define os9 mod with crc | |
141 . data pointer ( same as *, only works just after the mod ) | |
142 * code pointer | |
143 emod | |
144 | |
145 os9 os9 system call | |
146 end | |
147 | |
148 fcs generates os9 string with 8th bit on termination | |
149 | |
150 use use os9 sources ( subsequent use/lib follow the directories ) | |
151 | |
152 accepts some more chars in names such as $ . _ | |
153 | |
154 | |
155 Links/References | |
156 ================ | |
157 | |
158 | |
159 Project: | |
160 https://github.com/6809/sbc09 | |
161 Maintained by the original author and others. | |
162 | |
163 Source: | |
164 http://groups.google.com/group/alt.sources/browse_thread/thread/8bfd60536ec34387/94a7cce3fdc5df67 | |
165 Autor: Lennart Benschop lennart@blade.stack.urc.tue.nl, | |
166 lennartb@xs4all.nl (Webpage, Subject must start with "Your Homepage"!) |