O2EM(1)

NAME
o2em - Emulator for Odyssey II and VideoPac+ systems

SYNOPSIS
o2em <file> [-options]

DESCRIPTION
O2EM is an open source Odyssey2 / Videopac console emulator.

OPTIONS

file
    Cartridge ROM image.
    NOTE: Unlike most programs, o2em requires the file argument first, before any options.

-help
    Help display

-wsize=n
    Window size (1-4)

-fullscreen
    Full screen mode

-help
    Show help

-scanlines
    Enable scanlines

-nosound
    Turn off sound emulation

-novoice
    Turn off voice emulation

-svolume=n
    Set sound volume (0-100)

-vvolume=n
    Set voice volume (0-100)

-filter
    Enable low-pass audio filter

-debug
    Start the emulator in debug mode

-speed=n
    Relative speed (100 = original)

-nolimit
    Turn off speed limiter

-bios=file
    Set the O2 bios file name/dir

-biosdir=path
    Set the O2 bios path (default= bios/)

-romdir=path
    Set the O2 roms Path (default= roms/)

-scshot=file
    Set the screenshot file name/template

-euro
    Use European timing / 50Hz mode

-exrom
    Use special 3K program/ 1K data ROM mode Use 3K rom mapping mode

-s<n>=mode/keys
    Define stick n mode/keys (n=1-2, see o2em.txt)

-c52
    Start the emulator with french Odyssey 2 BIOS

-g7400
    Start the emulator with VP+ BIOS

-jopac
    Start the emulator with french VP+ bios

-scoretype=m
    Set Scoretype to m (see o2em.txt)

-scoreadr=n
    Set Scoreaddress to n (decimal value)

-scorefile=file
    Set Output-Scorefile to file (highscore.txt)

-score=n
    Set Highscore to n

-savefile=file
    Load/Save State from/to file

KEY BINDINGS
These are the default key bindings, and can be changed on the command line or in the config file.

Arrow keys + L
    Default joystick 1 emulation

W,D,S,A + Space
    Default joystick 2 emulation

ESC or F12
    Leave the emulator

F1  Pause/Information

F2  Save State-File

F3  Load State-File

F4  Enter debugger

F5  Reset emulator (same as pressing the reset on the O2 keyboard)

F6  Inject Highscore

F8  Make a screen shot

Caps Lock
    Enables/Disables the O2 keyboard input of the keys used by joystick emulation

FILES

/usr/bin/o2em
    Shell script wrapper. Sets up ~/.o2em if needed, runs the actual binary. This is required because o2em was ported from DOS, and expects to be run in its own directory; with the wrapper, it behaves like a proper UNIX program (run anywhere, writes only to ~/.o2em).

/usr/libexec/o2em.bin
    The actual o2em binary. Normally, you don't want to run this directly (let the wrapper run it for you).

/usr/share/o2em/bios
    BIOS ROM images. At minimum, o2rom.bin must exist. To use the -c52, -jopac, or -g7400 options, the appropriate BIOS image must be located here (see below). The emulator checks the CRC of the ROM images, and will refuse to start with an image it doesn't recognize. The correct files are:

c52.bin (md5sum f1071cdb0b6b10dde94d3bc8a6146387)
g7400.bin (md5sum c500ff71236068e0dc0d0603d265ae76)
jopac.bin (md5sum 279008e4a0db2dc5f1c048853b033828)
o2rom.bin (md5sum 562d5ebf9e030a40d6fabfc2f33139fd)

These are the same files used by MESS, except o2rom.bin is called o2bios.rom by MESS.

/usr/share/o2em/voice
    Voice samples, used to emulate the Odyssey2's speech synthesis chip.

~/.o2em/
    Working directory for o2em. Will be created by shell script wrapper the first time it's run. All save-state and screenshot files will be written here. The BIOS image, cartridge images, and voice samples will be symlinked into this directory by the wrapper script.

~/.o2em/o2em_def.cfg
    Config file (optional). See o2em.txt for details.

/usr/doc/o2em-$VERSION/o2em.txt
    Full documentation for o2em.

AUTHORS
o2em was originally created by Daniel Boris, and has been developed by Andre de la Rocha since version 0.80 and Arlindo M. de Oliveira since version 1.16.

This manual page was written by B. Watson for the SlackBuilds.org project (but may be used by anyone for any reason).

Wrapper script also by B. Watson.