Technical documentation

Phosphoric Oric emulator · authoritative source on GitHub

This page organises all of Phosphoric's documentation by topic. Entries marked hosted are reproduced here on the site; the others link to the reference documentation kept up to date in the GitHub repository. For an overview of what the emulator can do, see the full feature list.

Getting started

• Browser build (WebAssembly) hosted

  Build and deploy the emulator for the browser: Emscripten prerequisites, make wasm, the security policy (CSP), the web interface, ?media= deep links, and byte-for-byte fidelity verification.

  Source: docs/wasm.md

• User guide

  Full usage guide: launching, loading programs, options, shortcuts, troubleshooting.

  Source: docs/user-guide/README.md

• Software compatibility

  Tested titles and demos, compatibility status, edge cases.

  Source: docs/COMPATIBILITY.md

Peripherals & I/O

• LOCI (sodiumlb interface) hosted

  MIA bus, 36-op API, flash/USB/SD storage, Action button (F8), bus timing, known deviations.

  Source: docs/loci.md

• SEDORIC (floppies) hosted

  MFM_DISK container, system sectors, file descriptors, tap2sedoric/sedoric-info tools, multi-file injection, validated machine-code recipes.

  Source: docs/SEDORIC.md

• Digitelec DTL 2000 (V23 modem)

  PIA 6821 + ACIA 6850 card, OCR-verified registers, historical context and a usage example (Minitel / BBS).

  Source: docs/digitelec-dtl2000/

• Orictel modem & Hayes AT

  Orictel serial guide, Hayes AT command set, release notes.

  Source: docs/orictel-modem-hayes.md

• Signal-level cassette

  --tape-signal playback: real VIA CB1 waveform for custom/protected loaders.

  Source: docs/sprint90-cassette-signal.md

Development & control

• Remote GDB debugging

  Debug the 6502 from gdb / lldb / VS Code over the RSP stub (--gdb).

  Source: docs/gdb_remote.md

• IPC control protocol

  stdin/stdout text protocol for the OricForge IDE: 30 commands, 3 events, reference Python client.

  Source: docs/control_protocol.md

• HTTP API (REST)

  Control over HTTP/JSON: endpoints, file sandbox, remote keyboard typing.

  Source: docs/http-api.md

• Record / replay (movies)

  Bit-deterministic input capture and replay (--record / --replay): TAS, bug repro, CI regressions.

  Source: docs/movie_replay.md

• Internal API

  Documentation of the internal interfaces (emulator, subsystems).

  Source: docs/api/README.md

Video, hardware & architecture

• ULA-NG (next-gen)

  Guide and specification for the next-generation ULA: sprites, 80 columns, chunky 4bpp, copper — a reference toward an FPGA implementation.

  Sources: README-ULA-NG.md · ULA-NG-SPEC.md

• Hardware conformance

  Line-by-line audit of the cores against manufacturer datasheets (WD1793, VIA 6522, PSG…), with documented, assumed deviations.

  Source: docs/HARDWARE_CONFORMANCE.md

• Internal architecture

  The I/O bus (io_device_t), LOCI “glue” separation, architecture audit.

  Source: docs/architecture/

Further documents (technical reports, research notes) live in the repository's docs/ folder. Non-hosted entries can be reproduced on the site on request.

← Back to Phosphoric · Full feature list →