OricTel - Emulateur Minitel 1B pour Oric 1/Atmos

Version: 0.3.5 Date: 2026-07-03 Auteur: bmarty bmarty@mailo.com Depot public: https://github.com/benedictemarty/orictel

Description

OricTel transforme votre Oric 1 ou Oric Atmos en terminal Minitel 1B complet, capable de se connecter aux serveurs Minitel encore en activite sur Internet (PAVI 3617, MiniPavi, ...).

Accueil Teletel (PAVI 3617)	Ecran de demarrage

Modes de connexion :

1. Modem AT (unique montage materiel : LOCI + PicoWiFiModemUSB) : le Pico est un modem Hayes ; OricTel compose le serveur choisi au menu via ATD host:port. C'est la seule methode de connexion (pas de ligne V23 brute).
2. WebSocket : relais Python asyncio entre l'emulateur et un serveur Minitel WebSocket (ws://3617.fr/ws).

Voir le Manuel d'utilisation pour le guide complet cote utilisateur.

Architecture

Serveur Minitel (ex: pavi.3617.fr:3617)
         |
         | TCP (modem AT)                 ou     WebSocket (ws://3617.fr/ws)
         |                                            |
         v                                   [orictel_bridge.py]
   [Phosphoric]                                       |
  ACIA 6551 @ $0380 (LOCI)                    TCP :3615
         |                                            |
         +--------------------------------------------+
         |
         v
  [Programme OricTel sur Oric]
    +-- serial_asm.s   (driver ACIA 6551, polling pur sans IRQ)
    +-- serial_tx.c    (file d'emission non bloquante)
    +-- videotex.c     (decodeur protocole Videotex)
    +-- display.c      (rendu HIRES, heuristique couleur)
    +-- display_asm.s  (moteur de rendu cellules 6502)
    +-- keyboard.c     (clavier + mapping Minitel)
    +-- fonts.c        (G0, G1, G2)
    +-- main.c         (boucle principale, menus, modem AT)

Composants

1. Programme Oric (orictel.tap) - Terminal Minitel en 6502 (C + ASM via cc65)

   • Decodeur protocole Videotex complet (Teletel/Antiope)
   • Machine a etats : ESC, CSI (avec parametres), US, SS2, REP, SEP, PRO1/2/3
   • Rendu HIRES 40x25 : moteur de plage en assembleur (~300 cycles/cellule), dirty par plage de colonnes, budget adaptatif (clavier toujours reactif)
   • Heuristique couleur hybride : attributs serial poses sur les cellules vides avec regard-avant (couleur du texte qui suit), mosaiques en couleur solide quand l'attribut correspond, dithering par luminance en repli
   • Jeux de caracteres G0 (alphanum + accents), G1 (mosaiques 2x3, cache precalcule), G2 (CEPT etendu, accents precomposes min/maj)
   • Attributs complets : couleurs, flash, inversion, soulignement, masque global, mosaique separee, double hauteur/largeur/taille
   • Modes PRO2/PRO3 : rouleau, minuscules, aiguillages appliques au clavier, clavier etendu/curseur
   • 3 modes de rendu commutables (CTRL+D) : auto, dithering, brut
   • Splash screen avec jingle AY-3-8912 (version affichee via ORICTEL_VERSION)
   • Ecran interface (rappel du montage LOCI + PicoWiFi), menu de mode (modem AT / config WiFi) et de serveur (predefinis + saisie libre)

2. Bridge WebSocket-TCP (orictel_bridge.py) - Proxy Python asyncio

   • Ecoute TCP sur port 3615 (emulateur), connexion WebSocket vers 3617.fr
   • Relais bidirectionnel transparent, mono-client, statistiques, mode -v

Pre-requis

• cc65 (cross-compilateur 6502) >= 2.19
• Python 3.8+ avec module websockets >= 12.0 (pour le bridge uniquement)
• Emulateur Phosphoric (backend modem/picowifi, ou com: + --loci/ --acia-addr 0380 pour un LOCI/PicoWiFiModemUSB physique)
• ROMs Oric (basic11b.rom pour Atmos, basic10.rom pour Oric-1)

Compilation et tests

make                # Compile orictel.tap
make dsk            # Construit la disquette Sedoric orictel.dsk
make test           # Tests host (Videotex, ACIA/SMC, modem AT, clavier, bridge)
make fuzz           # Fuzzing du decodeur Videotex (ASAN/UBSAN, FUZZ_TIME=30)
make coverage       # Couverture host gcov (Videotex + modem AT)
make test-server    # Serveur Videotex local de demo (test manuel)
make clean          # Nettoyage

Disquette Sedoric (.dsk)

make dsk fabrique orictel.dsk, une disquette Sedoric 3 bootable (format MFM_DISK), a partir de la cassette orictel.tap :

orictel.tap --tap2dsk--> .dsk (ancien format) --old2mfm--> .dsk (MFM_DISK)

Les outils de conversion (OSDK de F.Frances) sont embarques en source dans tools/dsktools/. Le programme est stocke sous le nom ORICTEL.COM et le disque s'auto-lance au demarrage via l'init Sedoric LOAD"ORICTEL". Pour le tester dans l'emulateur (boot Microdisc) :

make run-dsk
# Equivalent a:
# oric1-emu --rom basic11b.rom --disk-rom microdis.rom -d orictel.dsk \
#     --loci --serial picowifi:OricTel --serial-buffer 4096

Utilisation

Mode modem AT (PicoWiFiModemUSB emule, serveur choisi dans le menu)

make run
# Equivalent a:
# oric1-emu --rom basic11b.rom --tape orictel.tap -f \
#     --loci --serial picowifi:OricTel --serial-buffer 4096

make run emule fidelement le PicoWiFiModemUSB : la page Config WiFi (AT$SCAN) liste les vrais reseaux de l'hote (via nmcli), et le Pico demarre deja associe au SSID indique (numerotation immediate). Pour le materiel physique, voir make run-loci (Pico en USB sur /dev/ttyACM0).

Mode WebSocket (avec bridge)

make run-ws         # lance bridge + emulateur, et arrete le bridge en sortant
# Bridge seul: make bridge
# Ou: python3 bridge/orictel_bridge.py [--tcp-port 3615] [--ws-url ws://3617.fr/ws] [-v]

Serveurs Minitel proposes au menu

• pavi.3617.fr:3617 - PAVI 3617 (recommande)
• go.minipavi.fr:516 - MiniPavi
• Saisie libre pour tout autre serveur (hostname:port)

Touches Minitel

Compatible Oric-1 (pas de touche FUNCT) et Atmos. Methode principale: CTRL+lettre (fonctionne sur les deux machines).

Fonction Minitel	Oric-1 & Atmos	Atmos seul	Codes envoyes
Envoi	RETURN		SEP $41
Retour	CTRL+R ou Fl.HAUT	FUNCT+R	SEP $42
Repetition	CTRL+E	FUNCT+E	SEP $43
Guide	CTRL+G	FUNCT+G	SEP $44
Annulation	CTRL+A ou ESC	FUNCT+A	SEP $45
Sommaire	CTRL+S	FUNCT+S	SEP $46
Correction	DELETE		SEP $47
Suite (page suiv)	CTRL+N	FUNCT+N	SEP $48
Connexion/Fin	CTRL+C	FUNCT+C	SEP $49
Fleches G/D	Fl.GAUCHE/DROITE		ESC[D / ESC[C (mode curseur PRO3)
Mode rendu	CTRL+D		(local)
Effacer ecran	CTRL+L		(local)
Reset ACIA	CTRL+F		(local)

Specifications techniques

• Affichage: HIRES 240x200, 40x25 caracteres (6x8 pixels/car), inversion video par bit 7, attributs serial Oric par scanline
• Serie: ACIA 6551 a la base LOCI ($0380), Control=$18 (1200 bauds, 8N1, horloge interne), Command=$0B (DTR, IRQ RX desactivee, TIC=10 = RTS bas sans IRQ TX). Polling pur du registre STATUS, aucune IRQ ACIA ; les ecritures registres sont protegees SEI/PLP (contrainte MIA du vrai LOCI).
• Emission: file TX logicielle non bloquante drainee par la boucle principale (prerequis vrai materiel V23)
• Memoire: TAP ~23 Ko, code+donnees sous $9800 (stack cc65 $0800), framebuffer HIRES $A000-$BF3F
• Protocole: Videotex Teletel/Antiope (STUM 1B); l'identification ENQ/ENQROM est volontairement muette (alignement miedit: les serveurs modernes echoient la reponse dans le champ de saisie)
• Performance: page complete ~0,3 s, echo de frappe ~1 ms (rendu de la cellule seule)
• Reference: emulateur JS miedit/telenet pour la validite du protocole

Documentation

• docs/MANUEL_UTILISATION.md - Manuel d'utilisation complet
• docs/ARCHITECTURE.md - Architecture technique detaillee
• docs/REVUE_QUALITE.md - Revue qualite et suivi de remediation
• docs/AGILE_PLAN.md - Plan agile et suivi des sprints
• ROADMAP - Vision et planification des versions
• CHANGELOG - Historique des modifications
• VERSION_TRACKING - Suivi des versions par composant
• CIRRUS_OS - Statut de build et plateforme cible

Licence

EUPL 1.2 (European Union Public Licence) - Voir fichier LICENSE