Mode d'emploi
De la construction au premier programme chargé : les commandes, les touches et le menu qui remplace la plupart des options pendant que la machine tourne.
Dans cette page
Construire
# Debian ou Ubuntu
sudo apt-get install build-essential libsdl2-dev
make # avec SDL2 : image, son, clavier (le défaut)
make SDL2=0 # sans affichage, pour l'automatisation ; ne tourne qu'en --headless
make tools # les outils de conversion
| Option de construction | Ajoute |
|---|---|
DEBUG=1 | symboles de débogage, sans optimisation |
HTTPAPI=1 | l’API HTTP de pilotage |
CAST=1 | la diffusion vers un Chromecast (demande OpenSSL) |
MIDI=1 | un port MIDI de l’hôte (ALSA, CoreMIDI, WinMM) |
TUI=1 | le débogueur en mode texte (ncurses) |
WIN=1 | une construction Windows avec MinGW-w64 |
Sous macOS : brew install sdl2 pkg-config, puis make. make wasm construit la version
navigateur (voir Dans le navigateur).
Lancer
./oric1-emu # Oric-1 nu, ROM roms/basic10.rom
./oric1-emu -m atmos # Atmos, ROM roms/basic11b.rom
./oric1-emu -r roms/basic11b.rom -t jeu.tap -f # une cassette, chargée d'un coup
./oric1-emu -r roms/basic10.rom -t jeu.tap --tape-signal # une cassette au signal
./oric1-emu -r roms/basic10.rom --disk-rom roms/microdis.rom -d SEDORIC.DSK # Sedoric
Sans -r, Phosphoric démarre un Oric-1 nu sur roms/basic10.rom, cherchée dans le dossier courant
puis à côté de l’exécutable, sans aucune carte d’extension. --no-rom laisse la zone $C000-$FFFF
vide.
Les options principales
| Thème | Options |
|---|---|
| Machine | -r ROM, -m oric1 ou atmos, --no-rom |
| Cassette | -t FICHIER, -f (injection), --tape-signal |
| Disquettes | --disk-rom ROM, -d puis --disk1 à --disk3, --disk-writeback, --fdc-timing real ou fast, --bad-sector |
| Sauvegardes | --save-state, --load-state |
| Manette, imprimante | -j keys ou gamepad, -p FICHIER, --printer-type mcp40 |
| Clavier | --keyboard azerty, --type-keys CYCLES:TEXTE, --type-keys-when ADR:VAL:TEXTE |
| Affichage | --scale 1 à 4, --headless, --cycles N |
| Captures | --screenshot, --screenshot-at, --screenshot-when, --screenshot-text, --video |
| Son | --audio-wav FICHIER, --psg-trace FICHIER |
| Cartes | --loci, --serial, --dtl2000, --mageco, --oricon, --jasmin-rom, --sp0256-rom, --mea8000, --hostfs |
| Débogage | -D, --break ADR, --symbols, --tui, --gdb, --control, --http-api |
./oric1-emu --help donne la liste complète, avec l’aide de chaque carte.
La frappe automatique
--type-keys tape du texte dans l’Oric, avec des séquences d’échappement :
| Séquence | Touche |
|---|---|
\n | Retour |
\e | Échap |
\u, \d, \l, \r | flèches |
\Cx, \Fx | Ctrl + x, Funct + x |
\Lx, \Rx | Maj gauche ou droite + x |
\pN | une pause de N secondes émulées |
La frappe suit le vrai balayage du clavier par la ROM : aucune touche n’est perdue. Avec -f sur un
programme BASIC, le RUN automatique n’est annulé que si vos propres touches tombent dans sa fenêtre.
Les touches
| Touche | Fonction |
|---|---|
| F1 | le menu des périphériques |
| F2, F4 | sauvegarde et chargement rapides de l’état |
| F3 | changer l’agrandissement (×1 à ×4) |
| F5 | reset |
| Maj + F5 | NMI : le bouton sous l’Oric (redémarrage à chaud par la ROM) |
| F6 | changer de cassette ou de disquette à chaud |
| F7 | vider les 64 Ko de RAM dans un fichier daté |
| F8 | le bouton Action du LOCI : court, menu ; long (2 s), ROM de diagnostic |
| Ctrl + Alt + M, Ctrl + Alt + D | le même bouton, court ou long, quand F8 est pris par le bureau |
| F9 | entrer dans le débogueur |
| F10 | quitter |
| F11 | plein écran |
| F12 | capture PNG |
Le menu F1
--menu-screenshot.Pendant que le menu est ouvert, la machine est figée et le son coupé ; elle reprend exactement où elle en était. Le menu règle :
- les disquettes A à D : insérer (un sélecteur de fichiers), éjecter (Suppr), protéger en écriture (→ puis Entrée). La disquette va à la carte disque présente : Microdisc, Jasmin ou LOCI ; sans carte disque, rien ne se monte ;
- la cassette : insérer, éjecter, rembobiner ;
- les instantanés : sauvegarder ou reprendre un état (
snapshots/etatNNNN.ost) ; - l’imprimante (coupée, texte, table traçante), la manette (aucune, flèches, manette), le clavier (QWERTY ou AZERTY), et le mode de la cassette au lancement ;
- les cartes d’extension : chaque carte a sa page, qui explique ce qu’elle fait et chacun de ses réglages. « Appliquer et redémarrer » relance l’émulateur avec ces cartes.
Le quatrième bouton change la langue de tout le menu, entre français et anglais.
| Touche dans le menu | Effet |
|---|---|
| ↑ ↓ | changer de ligne |
| ← → | passer d’une colonne ou d’un bouton à l’autre |
| Entrée | activer |
| Suppr | éjecter, ou remettre un réglage par défaut |
| Échap ou F1 | reprendre la machine |
| une lettre | dans le sélecteur, aller au fichier suivant qui commence par elle |
Le fichier phosphoric.cfg
« Enregistrer la configuration » écrit phosphoric.cfg, une ligne clé=valeur par réglage :
lecteurs (a= à d=), protections, cassette, imprimante, manette, clavier, langue, et les cartes
(carte.<id>=oui ou non, puis leurs réglages). Il est relu au lancement suivant ; la ligne de
commande l’emporte toujours. Sans affichage, il n’est lu que si on le donne (--config FICHIER).
--no-config ou PHOSPHORIC_NO_CONFIG=1 l’ignorent, ce que fait la suite de tests.