How to use it

From building to the first program loaded: the commands, the keys, and the menu that replaces most options while the machine runs.

Building

# Debian or Ubuntu
sudo apt-get install build-essential libsdl2-dev

make            # with SDL2: picture, sound, keyboard (the default)
make SDL2=0     # no display, for automation; only runs with --headless
make tools      # the conversion tools

On macOS: brew install sdl2 pkg-config, then make. make wasm builds the browser version (see In the browser).

Starting

./oric1-emu                                   # bare Oric-1, ROM roms/basic10.rom
./oric1-emu -m atmos                          # Atmos, ROM roms/basic11b.rom
./oric1-emu -r roms/basic11b.rom -t game.tap -f            # a tape, loaded at once
./oric1-emu -r roms/basic10.rom -t game.tap --tape-signal  # a tape at signal level
./oric1-emu -r roms/basic10.rom --disk-rom roms/microdis.rom -d SEDORIC.DSK   # Sedoric

Without -r, Phosphoric starts a bare Oric-1 on roms/basic10.rom, looked for in the current folder then next to the executable, with no expansion card. --no-rom leaves the $C000-$FFFF area empty.

The main options

./oric1-emu --help gives the full list, with each card’s help.

Automatic typing

--type-keys types text into the Oric, with escape sequences:

Typing follows the ROM’s real keyboard scan: no key is lost. With -f on a BASIC program, the automatic RUN is only cancelled if your own keys fall inside its window.

The keys

The F1 menu

While the menu is open, the machine is frozen and the sound muted; it resumes exactly where it was. The menu sets:

• floppies A to D: insert (a file selector), eject (Del), write-protect (→ then Enter). The floppy goes to the disk card present: Microdisc, Jasmin or LOCI; with no disk card, nothing is mounted;
• the tape: insert, eject, rewind;
• snapshots: save or resume a state (snapshots/etatNNNN.ost);
• the printer (off, text, plotter), the joystick (none, arrows, gamepad), the keyboard (QWERTY or AZERTY), and the tape mode at launch;
• expansion cards: each card has its page, which explains what it does and each of its settings. “Apply and restart” relaunches the emulator with those cards.

The fourth button switches the language of the whole menu between French and English.

The phosphoric.cfg file

“Save configuration” writes phosphoric.cfg, one key=value line per setting: drives (a= to d=), protections, tape, printer, joystick, keyboard, language, and the cards (carte.<id>=oui or non, then their settings). It is read at the next launch; the command line always wins. With no display, it is only read if given (--config FILE). --no-config or PHOSPHORIC_NO_CONFIG=1 ignore it, which the test suite does.

Sources in the repository : README.md, docs/user-guide/MENU-F1.md, docs/user-guide/README.md, docs/macos.md.