/[projet1]/public/pc/tools/osdk/main/Osdk/_final_/Oricutron/ReadMe.txt
Defence Force logotype

Contents of /public/pc/tools/osdk/main/Osdk/_final_/Oricutron/ReadMe.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1002 - (show annotations)
Sun Dec 8 10:50:26 2013 UTC (6 years ago) by dbug
File MIME type: text/plain
File size: 7207 byte(s)
Resynchronized my own changes to the OSDK with what was in the depot.
From now on I will continue the changes directly with the depot version, and try to update more regularly.
The reason I had this big change is that I had two computers with local changes done in demo parties when working on demos, where I did the fixes to handle Euphoric and Oricutron, plus new tools, modified tools, etc... giant mess.
I do not guarantee that what is on the depot is bug free, but it's the version I'm using right now (My OSDK var points to the public\pc\tools\osdk\main\Osdk\_final_ folder.
1 Oricutron 0.9
2 -------------
3
4 (c)2009-2012 Peter Gordon (pete@petergordon.org.uk)
5
6 This is a work in progress.
7
8
9 Current status
10 ==============
11
12 6502: 100% done (apart from any unknown bugs :)
13 VIA: 95% done.
14 AY: 99% done.
15 Video: 100% done
16 Tape: 99% done (.TAP, .ORT and .WAV supported)
17 Disk: Reading/Writing sectors works. No track read/write.
18
19 Telestrat emulation is included, but is far from finished and doesn't currently
20 work well enough to be useful.
21
22
23 Credits
24 =======
25
26 Programming
27 -----------
28
29 Peter Gordon
30
31
32 Additional Programming
33 ----------------------
34
35 Francois Revol
36 Alexandre Devert
37 Stefan Haubenthal
38 Ibisum
39 Kamel Biskri
40
41
42 Amiga & Windows ports
43 ---------------------
44
45 Peter Gordon
46
47
48 MacOS X port
49 ------------
50
51 Francois Revol
52 Kamel Biskri
53
54
55 MorphOS & AROS port
56 -------------------
57
58 Stefan Haubenthal
59
60
61 Linux port
62 ----------
63
64 Francois Revol
65 Ibisum
66 Alexandre Devert
67
68
69 Pandora port
70 ------------
71
72 Ibisum
73
74
75 Thanks
76 ======
77
78 Thanks to DBug and Twilighte for letting me distribute their demos and
79 games with Oricutron.
80
81 Thanks to DBug, Twilighte, Chema, kamelito, Yicker, JamesD, Algarbi, ibisum,
82 jede, thrust26 and everyone else for their help and feedback!
83
84
85
86 AVI export notes
87 ================
88
89 The AVI export uses the MRLE codec. Your favourite player might not support
90 it, but MPlayer plays it, ffmpeg converts it and you can upload it directly
91 to youtube.
92
93 Note that the MRLE codec shows up some endian-issues on the Amiga OS4 port
94 of MPlayer, so it will sound crappy and have wrong colours until those bugs
95 are fixed :-(
96
97
98 Command line
99 ============
100
101 You can specify certain options on the command line. All options have
102 both short and long versions. For example:
103
104 -mblah
105
106 or
107
108 --machine blah
109
110 Is the same thing. Note that the short version doesn't have a space, but
111 the long version does.
112
113 Here are all the options:
114
115
116 -m / --machine = Specify machine type. Valid types are:
117
118 "atmos" or "a" for Oric atmos
119 "oric1" or "1" for Oric-1
120 "o16k" for Oric-1 16k
121 "telestrat" or "t" for Telestrat
122 "pravetz", "pravetz8d" or "p" for Pravetz 8D
123
124 -d / --disk = Specify a disk image to use in drive 0
125 -t / --tape = Specify a tape image to use
126 -k / --drive = Specify a disk drive controller. Valid types are:
127
128 "microdisc" or "m" for Microdisc
129 "jasmin" or "j" for Jasmin
130
131 -s / --symbols = Load symbols from a file
132 -f / --fullscreen = Run oricutron fullscreen
133 -w / --window = Run oricutron in a window
134 -R / --rendermode = Render mode. Valid modes are:
135
136 "soft" for software rendering
137 "opengl" for OpenGL
138
139 -b / --debug = Start oricutron in the debugger
140 -r / --breakpoint = Set a breakpoint
141 -h / --help = Print command line help and quit
142
143
144 Examples:
145
146 oricutron --machine atmos --tape "tape files/foo.tap" --symbols "my files/symbols"
147 oricutron -m1 -tBUILD/foo.tap -sBUILD/symbols -b
148 oricutron --drive microdisc --disk demos/barbitoric.dsk --fullscreen
149 oricutron -ddemos/barbitoric.dsk -f
150
151
152
153 Keys
154 ====
155
156 In emulator
157 -----------
158
159 F1 - Bring up the menu
160 F2 - Go to debugger/monitor
161 F3 - Reset button (NMI)
162 F4 - Hard reset
163 Shift+F4 - Jasmin reset
164 F5 - Toggle FPS
165 F6 - Toggle warp speed
166 F7 - Save all modified disks
167 Shift+F7 - Save all modified disks to new disk images
168 F9 - Save tape output
169 F10 - Start/Stop AVI capture
170 Help - Show guide
171
172
173 In menus
174 --------
175
176 Cursors - Navigate
177 Enter - Perform option
178 Backspace - Go back
179 Escape - Exit menus
180 (or use the mouse)
181
182
183 In Debugger/Monitor
184 -------------------
185
186 F2 - Return to the emulator
187 F3 - Toggle console/debug output/memwatch
188 F4 - Toggle VIA/AY information
189 F9 - Reset cycle count
190 F10 - Step over code
191 F11 - Step over code without tracing into
192 subroutines.
193 F12 - Skip instruction
194
195
196 In the console:
197 ---------------
198
199 Up/Down - Command history
200
201
202 In memwatch:
203 ------------
204
205 Up/Down - Scroll (+shift for page up/down)
206 Page Up/Page Down - Page up/down
207 Hex digits - Enter address
208 S - Toggle split mode
209 Tab - Switch windows in split mode
210
211
212 Monitor instructions
213 ====================
214
215 In the monitor, number arguments are decimal by default, or prefixed with $ for
216 hex or % for binary. Pretty much everything is output in hex.
217
218 In most places where you can enter a number or address, you can pass a CPU or
219 VIA register. (VIA registers are prefixed with V, e.g. VDDRA). Anywhere you can
220 pass an address, you can also use a symbol.
221
222 Commands:
223
224 ? - Help
225 a <addr> - Assemble
226 bc <bp id> - Clear breakpoint
227 bcm <bp id> - Clear mem breakpoint
228 bl - List breakpoints
229 blm - List mem breakpoints
230 bs <addr> - Set breakpoint
231 bsm <addr> [rwc] - Set mem breakpoint
232 bz - Zap breakpoints
233 bzm - Zap mem breakpoints
234 d <addr> - Disassemble
235 df <addr> <end> <file>- Disassemble to file
236 m <addr> - Dump memory
237 mm <addr> <value> - Modify memory
238 mw <addr> - Memory watch at addr
239 nl <file> - Load snapshot
240 ns <file> - Save snapshot
241 r <reg> <val> - Set <reg> to <val>
242 q, x or qm - Quit monitor
243 qe - Quit emulator
244 sa <name> <addr> - Add or move user symbol
245 sk <name> - Kill user symbol
246 sc - Symbols not case-sensitive
247 sC - Symbols case-sensitive
248 sl <file> - Load user symbols
249 sx <file> - Export user symbols
250 sz - Zap user symbols
251 wm <addr> <len> <file>- Write mem to disk
252
253
254
255 Breakpoints
256 ===========
257
258 There are two types of breakpoints. "Normal" breakpoints trigger when the CPU
259 is about to execute an instruction at the breakpoint address. "Memory" breakpoints
260 trigger when the breakpoint address is accessed or modified.
261
262 There are three ways a memory breakpoint can be triggered; when the CPU is about
263 to read the address (r), and the CPU is about to write the address (w), or after the
264 value at the address changes for any reason (c).
265
266 You specify which ways you'd like the breakpoint to trigger when you set the memory
267 breakpoint:
268
269 bsm r $0c00 <-- Break when the CPU is about to read from $0c00
270 bsm rw $0c00 <-- Break when the CPU is about to access $0c00
271 bsm c $0c00 <-- Break after then contents of $0c00 change
272 bsm rwc $0c00 <-- Break just before the CPU accesses $0c00, or just after it
273 changes for any reason.

  ViewVC Help
Powered by ViewVC 1.1.26