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"!)