AminetAminet
Search:
81066 packages online
About
Recent
Browse
Search
Upload
Setup
Services

misc/emu/oricutron.lha

Mirror:Random
Showing:m68k-amigaosppc-amigaosppc-morphosi386-arosi386-amithlonppc-warpupppc-powerupgeneric
No screenshot available
Short:Oric-1/Atmos/Telestrat/Pravetz 8D emul.
Author:pete at petergordon.org.uk (Peter Gordon), MorphOS port by uploader
Uploader:polluks sdf lonestar org (Stefan Haubenthal)
Type:misc/emu
Version:1.1
Requires:PowerSDL
Architecture:ppc-morphos
URL:http://code.google.com/p/oriculator/
Date:2013-12-08
Download:http://aminet.net/misc/emu/oricutron.lha - View contents
Readme:http://aminet.net/misc/emu/oricutron.readme
Downloads:2730
Oricutron 1.1
-------------

(c)2009-2013 Peter Gordon (pete at petergordon.org.uk)

This is a work in progress.


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.



Credits
=======

  Programming
  -----------

  Peter Gordon


  Additional Programming
  ----------------------

  Francois Revol
  Alexandre Devert
  Stefan Haubenthal
  Ibisum
  Kamel Biskri
  Iss


  Amiga & Windows ports
  ---------------------

  Peter Gordon


  MacOS X port
  ------------

  Francois Revol
  Kamel Biskri


  MorphOS & AROS ports
  --------------------

  Stefan Haubenthal


  Linux port
  ----------

  Francois Revol
  Ibisum
  Alexandre Devert


  Pandora port
  ------------

  Ibisum


  Pravetz disk support
  --------------------

  Iss




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!



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 :-(


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



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
  F9       - Save tape output
  F10      - Start/Stop AVI capture
  F11      - Copy text screen to clipboard (only BeOS)
  F12      - Paste (only BeOS, Linux & Windows)
  Help     - Show guide (Amiga, MorphOS and AROS)


  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


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



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 r $0c00        <-- Break when the CPU is about to read from $0c00
bsm rw $0c00       <-- Break when the CPU is about to access $0c00
bsm c $0c00        <-- Break after then contents of $0c00 change bsm rwc $0c00  
   <-- Break just before the CPU accesses $0c00, or just after it               
        changes for any reason.


Contents of misc/emu/oricutron.lha
PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                 4524    4648  97.3% -lh5- 100c Dec  8 16:50 Oricutron.info
[generic]                 4983   11689  42.6% -lh5- 8ee1 Dec  8 16:50 Oricutron/ChangeLog.txt
[generic]                 7157    7290  98.2% -lh5- 1d22 Dec  8 16:50 Oricutron/ChangeLog.txt.info
[generic]                    0       0 ****** -lh0- 0000 Dec  8 16:50 Oricutron/disks/
[generic]                  565     824  68.6% -lh5- d8e4 Dec  8 16:50 Oricutron/images/avirec.bmp
[generic]                  207     952  21.7% -lh5- 19c7 Dec  8 16:50 Oricutron/images/disk_active.bmp
[generic]                  359     952  37.7% -lh5- f18b Dec  8 16:50 Oricutron/images/disk_ejected.bmp
[generic]                  207     952  21.7% -lh5- d98a Dec  8 16:50 Oricutron/images/disk_idle.bmp
[generic]                  264     952  27.7% -lh5- c981 Dec  8 16:50 Oricutron/images/disk_modactive.bmp
[generic]                  263     952  27.6% -lh5- 09cc Dec  8 16:50 Oricutron/images/disk_modified.bmp
[generic]                  272   30776   0.9% -lh5- f3bb Dec  8 16:50 Oricutron/images/statusbar.bmp
[generic]                  344    1016  33.9% -lh5- 2e01 Dec  8 16:50 Oricutron/images/tape_ejected.bmp
[generic]                  305    1016  30.0% -lh5- 32c4 Dec  8 16:50 Oricutron/images/tape_pause.bmp
[generic]                  349    1016  34.4% -lh5- 3caa Dec  8 16:50 Oricutron/images/tape_play.bmp
[generic]                  337    1016  33.2% -lh5- c8f4 Dec  8 16:50 Oricutron/images/tape_record.bmp
[generic]                  272    1016  26.8% -lh5- 9e31 Dec  8 16:50 Oricutron/images/tape_stop.bmp
[generic]                  898    3128  28.7% -lh5- 44e2 Dec  8 16:50 Oricutron/images/winicon.bmp
[generic]               159366  412688  38.6% -lh5- f82d Dec  8 16:50 Oricutron/oricutron
[generic]                 1527    4048  37.7% -lh5- 856c Dec  8 16:50 Oricutron/oricutron.cfg
[generic]                 3096    8259  37.5% -lh5- 66bf Dec  8 16:50 Oricutron/Oricutron.guide
[generic]                 7157    7290  98.2% -lh5- 1d22 Dec  8 16:50 Oricutron/Oricutron.guide.info
[generic]                 1551    1551 100.0% -lh0- c640 Dec  8 16:50 Oricutron/Oricutron.info
[generic]                    0       0 ****** -lh0- 0000 Dec  8 16:50 Oricutron/pravdisks/
[generic]                 2924    7569  38.6% -lh5- ea2e Dec  8 16:50 Oricutron/ReadMe.txt
[generic]                 7157    7290  98.2% -lh5- 1d22 Dec  8 16:50 Oricutron/ReadMe.txt.info
[generic]                  353     512  68.9% -lh5- 48c7 Dec  8 16:50 Oricutron/roms/8dos.rom
[generic]                   16      16 100.0% -lh0- f2b8 Dec  8 16:50 Oricutron/roms/8dos.sym
[generic]                  845    2037  41.5% -lh5- 624c Dec  8 16:50 Oricutron/roms/Bas122de.pch
[generic]                  844    2037  41.4% -lh5- d44b Dec  8 16:50 Oricutron/roms/Bas122fr.pch
[generic]                  845    2037  41.5% -lh5- cb64 Dec  8 16:50 Oricutron/roms/Bas122uk.pch
[generic]                  838    2016  41.6% -lh5- fc26 Dec  8 16:50 Oricutron/roms/basic10.pch
[generic]                  845    2037  41.5% -lh5- cb64 Dec  8 16:50 Oricutron/roms/basic11b.pch
[generic]                12830   16384  78.3% -lh5- 7c1e Dec  8 16:50 Oricutron/roms/basic11b.rom
[generic]                 1603    2863  56.0% -lh5- 0d17 Dec  8 16:50 Oricutron/roms/basic11b.sym
[generic]                  199     313  63.6% -lh5- 16b9 Dec  8 16:50 Oricutron/roms/cumana.sym
[generic]                  331    2048  16.2% -lh5- 6b40 Dec  8 16:50 Oricutron/roms/jasmin.rom
[generic]                  182     315  57.8% -lh5- d982 Dec  8 16:50 Oricutron/roms/jasmin.sym
[generic]                 3113    8192  38.0% -lh5- 8ecd Dec  8 16:50 Oricutron/roms/microdis.rom
[generic]                  112     157  71.3% -lh5- 2f29 Dec  8 16:50 Oricutron/roms/microdis.sym
[generic]                  845    2037  41.5% -lh5- cb64 Dec  8 16:50 Oricutron/roms/pravetzt.pch
[generic]                 1603    2863  56.0% -lh5- 0d17 Dec  8 16:50 Oricutron/roms/pravetzt.sym
[generic]                 1034    2141  48.3% -lh5- 8459 Dec  8 16:50 Oricutron/roms/sedoric.sym
[generic]                  154     218  70.6% -lh5- 2214 Dec  8 16:50 Oricutron/roms/telmon24.pch
[generic]                  145     194  74.7% -lh5- 11d1 Dec  8 16:50 Oricutron/roms/telmon24.sym
[generic]                    0       0 ****** -lh0- 0000 Dec  8 16:50 Oricutron/snapshots/
[generic]                    0       0 ****** -lh0- 0000 Dec  8 16:50 Oricutron/tapes/
[generic]                    0       0 ****** -lh0- 0000 Dec  8 16:50 Oricutron/teledisks/
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        47 files  230821  565307  40.8%            Dec  8 19:49

Aminet © 1992-2014 Urban Müller and the Aminet team. Aminet contact address: <aminetaminet net>