forked from pete-gordon/oricutron
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Oricutron.guide
454 lines (327 loc) · 12.9 KB
/
Oricutron.guide
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
@database ""
@author "ReadMe2Guide"
@node Main "Main"
@toc Contents
@$VER: Oricutron 1.2.0 (08.11.14)
Oricutron 1.2
-------------
(c)2009-2014 Peter Gordon (pete\@petergordon.org.uk)
This is a work in progress.
@endnode
@node Currentstatus "Current status"
@toc Contents
Current status
==============
6502: 100% done (apart from any unknown bugs :)
VIA: 95% done.
AY: 99% done.
Video: 100% done
Tape: 99% done (.TAP, .ORT and .WAV supported)
Disk: Reading/Writing sectors works. No track read/write.
@endnode
@node Credits "Credits"
@toc Contents
Credits
=======
Programming
-----------
Peter Gordon
Additional Programming
----------------------
Francois Revol
Alexandre Devert
Stefan Haubenthal
Ibisum
Kamel Biskri
Iss
Christian from defence-force forum
Amiga & Windows ports
---------------------
Peter Gordon
BeOS/Haiku port
---------------
Francois Revol
MacOS X port
------------
Francois Revol
Kamel Biskri
Patrice Torguet
MorphOS & AROS ports
--------------------
Stefan Haubenthal
Linux port
----------
Francois Revol
Ibisum
Alexandre Devert
Pandora port
------------
Ibisum
ACIA & Pravetz disk support
---------------------------
Iss
@endnode
@node Thanks "Thanks"
@toc Contents
Thanks
======
Thanks to DBug and Twilighte for letting me distribute their demos and
games with Oricutron.
Thanks to DBug, Twilighte, Chema, kamelito, Yicker, JamesD, Algarbi, ibisum,
jede, thrust26 and everyone else for their help and feedback!
@endnode
@node AVIexportnotes "AVI export notes"
@toc Contents
AVI export notes
================
The AVI export uses the MRLE codec. Your favourite player might not support
it, but MPlayer plays it, ffmpeg converts it and you can upload it directly
to youtube.
Note that the MRLE codec shows up some endian-issues on the Amiga OS4 port
of MPlayer, so it will sound crappy and have wrong colours until those bugs
are fixed :-(
@endnode
@node Commandline "Command line"
@toc Contents
Command line
============
You can specify certain options on the command line. All options have
both short and long versions. For example:
-mblah
or
--machine blah
Is the same thing. Note that the short version doesn't have a space, but
the long version does.
Here are all the options:
-m / --machine = Specify machine type. Valid types are:
"atmos" or "a" for Oric atmos
"oric1" or "1" for Oric-1
"o16k" for Oric-1 16k
"telestrat" or "t" for Telestrat
"pravetz", "pravetz8d" or "p" for Pravetz 8D
-d / --disk = Specify a disk image to use in drive 0
-t / --tape = Specify a tape image to use
-k / --drive = Specify a disk drive controller. Valid types are:
"microdisc" or "m" for Microdisc
"jasmin" or "j" for Jasmin
-s / --symbols = Load symbols from a file
-f / --fullscreen = Run oricutron fullscreen
-w / --window = Run oricutron in a window
-R / --rendermode = Render mode. Valid modes are:
"soft" for software rendering
"opengl" for OpenGL
-b / --debug = Start oricutron in the debugger
-r / --breakpoint = Set a breakpoint
-h / --help = Print command line help and quit
--turbotape on|off = Enable or disable turbotape
--lightpen on|off = Enable or disable lightpen
--vsynchack on|off = Enable or disable VSync hack
--scanlines on|off = Enable or disable scanline simulation
NOTE: If you are not sure what machine or drive type is required for a disk or
tape image, just pass the filename without any options and Oricutron will
try and autodetect for you.
Examples:
oricutron tapes/tape_image.tap
oricutron disks/disk_image.dsk
oricutron --machine atmos --tape "tape files/foo.tap" --symbols "my files/symbols"
oricutron -m1 -tBUILD/foo.tap -sBUILD/symbols -b
oricutron --drive microdisc --disk demos/barbitoric.dsk --fullscreen
oricutron -ddemos/barbitoric.dsk -f
oricutron --turbotape off tapes/hobbit.tap
@endnode
@node Keys "Keys"
@toc Contents
Keys
====
In emulator
-----------
F1 - Bring up the menu
F2 - Go to debugger/monitor
F3 - Reset button (NMI)
F4 - Hard reset
Shift+F4 - Jasmin reset
F5 - Toggle FPS
F6 - Toggle warp speed
F7 - Save all modified disks
Shift+F7 - Save all modified disks to new disk images
F8 - Toggle fullscreen
F9 - Save tape output
F10 - Start/Stop AVI capture
F11 - Copy text screen to clipboard (BeOS, Linux & Windows)
F12 - Paste (BeOS, Linux & Windows)
Help - Show guide (Amiga, MorphOS and AROS)
AltGr - Additional modifier
In menus
--------
Cursors - Navigate
Enter - Perform option
Backspace - Go back
Escape - Exit menus
(or use the mouse)
In Debugger/Monitor
-------------------
F1 - Go to the menu
F2 - Return to the emulator
F3 - Toggle console/debug output/memwatch
F4 - Toggle VIA/AY/disk information
F9 - Reset cycle count
F10 - Step over code
F11 - Step over code without tracing into
subroutines.
F12 - Skip instruction
In the console:
---------------
Up/Down - Command history
In memwatch:
------------
Up/Down - Scroll (+shift for page up/down)
Page Up/Page Down - Page up/down
Hex digits - Enter address
S - Toggle split mode
Tab - Switch windows in split mode
@endnode
@node Monitorinstructions "Monitor instructions"
@toc Contents
Monitor instructions
====================
In the monitor, number arguments are decimal by default, or prefixed with $ for
hex or % for binary. Pretty much everything is output in hex.
In most places where you can enter a number or address, you can pass a CPU or
VIA register. (VIA registers are prefixed with V, e.g. VDDRA). Anywhere you can
pass an address, you can also use a symbol.
Commands:
? - Help
a <addr> - Assemble
bc <bp id> - Clear breakpoint
bcm <bp id> - Clear mem breakpoint
bl - List breakpoints
blm - List mem breakpoints
bs <addr> - Set breakpoint
bsm <addr> [rwc] - Set mem breakpoint
bz - Zap breakpoints
bzm - Zap mem breakpoints
d <addr> - Disassemble
df <addr> <end> <file>- Disassemble to file
m <addr> - Dump memory
mm <addr> <value> - Modify memory
mw <addr> - Memory watch at addr
nl <file> - Load snapshot
ns <file> - Save snapshot
r <reg> <val> - Set <reg> to <val>
q, x or qm - Quit monitor
qe - Quit emulator
sa <name> <addr> - Add or move user symbol
sk <name> - Kill user symbol
sc - Symbols not case-sensitive
sC - Symbols case-sensitive
sl <file> - Load user symbols
sx <file> - Export user symbols
sz - Zap user symbols
wm <addr> <len> <file>- Write mem to disk
@endnode
@node Breakpoints "Breakpoints"
@toc Contents
Breakpoints
===========
There are two types of breakpoints. "Normal" breakpoints trigger when the CPU
is about to execute an instruction at the breakpoint address. "Memory" breakpoints
trigger when the breakpoint address is accessed or modified.
There are three ways a memory breakpoint can be triggered; when the CPU is about
to read the address (r), and the CPU is about to write the address (w), or after the
value at the address changes for any reason (c).
You specify which ways you'd like the breakpoint to trigger when you set the memory
breakpoint:
bsm $0c00 r <-- Break when the CPU is about to read from $0c00
bsm $0c00 rw <-- Break when the CPU is about to access $0c00
bsm $0c00 c <-- Break after then contents of $0c00 change
bsm $0c00 rwc <-- Break just before the CPU accesses $0c00, or just after it
changes for any reason.
@endnode
@node InternationalKeyboardsunderLinuxandMacOSX "International Keyboards under Linux and Mac OS X"
@toc Contents
International Keyboards under Linux and Mac OS X
================================================
There are lots of problems with some international keyboards under Linux and Mac OS X.
The best way to cope with them is to install an UK or US keyboard definition and to
switch to it @{b}before@{ub} starting oricutron.
Under Mac OS X you can do that in the "System Preferences", "Keyboard", "Input sources".
Click on the + and search for the UK or US keyboard.
Under Ubuntu you can do that in the System menu, select Preferences, and then select
Keyboard. In the Keyboard Preferences dialog, select the Layouts tab, and click Add.
For a better solution look under "Visual Keyboard" down here.
@endnode
@node VisualKeyboard "Visual Keyboard"
@toc Contents
Visual Keyboard
===============
Oricutron can display a visual keyboard which also adds a keyboard mapping redefinition feature.
It's accessible through a submenu called "Keyboard options".
In the submenu you can find:
- a toggle that shows/hides the visual keyboard (you can click on the keyboard keys to enter key presses/releases) ;
- a toggle that gets you in the key mapping definition mode (you can then click on a visual keyboard key ; press a real key on your keyboard and the mapping will work) ;
- a toggle that allows mod keys (ctrl, shift, funct) to be sticky (ie you first click on a key to press it and then either re-click it to release it or click on another key and it will generate a modded key press - e.g. a Ctrl-T instead of T - and then auto release the key) ;
- an option to save a keyboard mapping (.kma file) ;
- an option to load a keyboard mapping ;
- an option that resets the keyboard mapping to the default one.
You can also add the following in your oricutron.cfg to autoload a keyboard
mapping (here Test.kma in the keymap directory found in Oricutron's directory):
; automatically load a keyboard mapping file
autoload_keyboard_mapping = 'keymap/Test.kma'
Other options let you display the keyboard and activate sticky mod keys automatically:
show_keyboard = yes
sticky_mod_keys = yes
@endnode
@node Serialcard(ACIA)emulation "Serial card (ACIA) emulation"
@toc Contents
Serial card (ACIA) emulation
============================
Oricutron can emulate ACIA at address #31C (standard address for Telestrat).
The emulation works for Oric, Atmos, Telestrat and Pravetz and can be used
together with any disk type.
The emulated ACIA communicates with the out-side world trough back-ends.
Back-ends can be configured from 'oricutron.cfg' or from command line
(see default 'oricutron.cfg' for usage).
Back-ends are:
- none - disables ACIA support
- loopback - every transmitted byte is returned to receive buffer (for testing purposes)
- com - Oricutron uses any real or virtual COM port in the host machine and communicates with the hardware attached to this serial port
- modem - unites ACIA with attached modem linked to internet with server and client sockets
In 'modem' mode are available folowing 'AT' commands:
AT - returns 'OK'
ATZ - initialize the modem
AT&F - initialize the modem
ATS0=0 - disable auto answering (close sever socket)
ATS0=1 - enable auto answering (open sever socket and start listening on selected port (default is telnet port 23))
ATA - same as 'ATS0=1'
ATS0? - returns 'AUTOANSWER OFF' or 'AUTOANSWER ON' depend on current sever socket state
ATH0 - disconnect currently connected sockets
+++ - if connected switches to command mode
ATO - returns from command mode to online
ATD ip:port - connects as client to ip:port. 'ip' can be any host name (ex.:localhost) or the real IP (ex.:127.0.0.1) on LAN or in Internet. ADTP and ATDT are alternative for compatibility.
@endnode
@node ROMpatchfiles "ROM patch files"
@toc Contents
ROM patch files
===============
For detailed usage see included '.pch' files in roms subdirectory.
Additionaly unlimited number of binary patches can be added:
$XXXX:00112233445566778899AABBCCDDEEFF....
$YYYY:AA55AA55....
$ZZZZ:FF00FF00....
where XXXX,YYYY,ZZZZ - are hex addresses relative to ROM start address
(i.e. to set byte at C000 to 00 use: $0000:00)
@endnode
@node Contents
@{"Current status" link Currentstatus}
@{"Credits" link Credits}
@{"Thanks" link Thanks}
@{"AVI export notes" link AVIexportnotes}
@{"Command line" link Commandline}
@{"Keys" link Keys}
@{"Monitor instructions" link Monitorinstructions}
@{"Breakpoints" link Breakpoints}
@{"International Keyboards under Linux and Mac OS X" link InternationalKeyboardsunderLinuxandMacOSX}
@{"Visual Keyboard" link VisualKeyboard}
@{"Serial card (ACIA) emulation" link Serialcard(ACIA)emulation}
@{"ROM patch files" link ROMpatchfiles}
@endnode