Documentation › User manual

OricTel — user manual

Minitel 1B terminal for the Oric 1 / Atmos · EUPL 1.2 license. This manual covers using OricTel, from launch to browsing Minitel servers. For the technical architecture, see the Architecture page.

1. Quick start

make run

This command builds if necessary then launches the Phosphoric emulator with OricTel in AT modem mode. The program loads and runs automatically (fast-load + RUN). Then:

1. Splash screen (jingle) — press a key (or wait 5 s).
2. Serial interface — a reminder screen of the only possible hardware setup (LOCI + PicoWiFiModemUSB, ACIA 6551 at $0380). No choice: press a key to continue.
3. Connection mode — type 1 (AT modem, recommended) or 2 (WiFi config). Since the PicoWiFi is a Hayes modem, connection always goes through AT.
4. Server — type 1 (PAVI 3617), 2 (MiniPavi) or 3 (free entry of a host:port, confirmed with RETURN).
5. The ATZ/ATD sequence runs (~2 s) and the server's home page appears.

Display tip: the Phosphoric window can be enlarged with F3 (cycles ×1-×4) or --scale 3. At scale 1, the inverse-video cartouches (SEND, INDEX…) are hard to read — a pixel-size limit, not a rendering fault.

2. Connection modes

Mode 1 — AT modem (the only connection method)

OricTel drives a Hayes modem via the ACIA 6551 at $0380 (PicoWiFiModemUSB, or its Phosphoric emulation --serial modem/picowifi): ATZ (reset) then ATDT host:port (dialling = TCP connection). The server is chosen from OricTel's menu, so you can switch servers without restarting the emulator. This is the only connection mode: the old “Direct” mode (raw V23 line without AT) was removed, as the target setup cannot open a direct line.

WebSocket mode (via bridge)

make run-ws launches the Python bridge (orictel_bridge.py) which relays TCP (port 3615) to the WebSocket server ws://3617.fr/ws, then the emulator. The bridge is a transparent binary relay: OricTel follows its usual AT modem flow (the AT handshake fails silently for lack of a modem on the bridge side, then the Videotex flow circulates).

2b. WiFi config (PicoWiFiModemUSB hardware)

On a real LOCI + PicoWiFiModemUSB setup, the modem must be associated with a WiFi network (with an IP address) before it can dial. Otherwise ATD fails immediately with NO CARRIER (00:00:00) (status no ip). The 2 - WiFi Config menu does the whole configuration from the Oric:

1. Scan: OricTel sends AT$SCAN; in-range 2.4 GHz networks are displayed, numbered. A red * marks a secured network.
2. Selection: type the network's number. REPEAT re-runs the scan, CANCEL returns to the menu.
3. Password: for a secured network, enter the password (masked with *), SEND confirms, CORRECTION erases.
4. Connection: OricTel sends AT$SSID= / AT$PASS= / ATC1, then waits for the DHCP IP. On success, AT&W saves the config to the Pico's NVRAM (“Connected! Config saved.”). Otherwise “IP failure. Check password.”.

Once WiFi is configured, return to the menu and choose 1 - AT modem to connect normally. Note: after an ATZ, OricTel now waits until it has an IP before dialling, which avoids the NO CARRIER caused by a still-running DHCP.

3. The screen

• Lines 1-24: the server's Videotex page (40 columns).
• Status line (top right): inverse C = data received recently (connected), F = no data for ~30 s (link likely dropped).
• Cursor: a blinking bar under the current cell when the server enables it (input fields).

4. The keyboard

OricTel runs on the Oric-1 and Atmos. Minitel function keys use CTRL+letter (both machines) or FUNCT+letter (Atmos only).

Typed characters are sent to the server, which echoes them to the screen (standard Minitel behaviour: no local echo by default). The Minitel 1B displays in UPPERCASE until the server enables lowercase mode. The left/right arrows send cursor sequences (ESC[D / ESC[C) only if the server has enabled cursor mode (PRO3), just like a real Minitel 1B.

Local shortcuts (send nothing to the server)

5. Rendering modes (CTRL+D)

The Oric cannot colour each cell individually like the Minitel: OricTel offers three hot-swappable strategies:

1. AUTO (default) — the best compromise, decided line by line: attribute colours where the line allows (coloured text, mosaics in solid colour), luminance dithering for dense multi-colour zones, white rendering for unsuitable lines (double height, no delimiter).
2. DITHERING — all density dithering: the brightness hierarchy of colours is preserved as textured “greyscale”. Useful if a page plays badly with the AUTO heuristic.
3. RAW — all white on black: maximum shape legibility, no colour.

6. Tested servers

On the PAVI home page: type a service code then SEND (RETURN). INDEX (CTRL+S) lists the services. CONNECT/END (CTRL+C) ends the session.

7. Troubleshooting

8. Known limitations

• The Minitel's per-cell colours are approximated by the Oric's serial attributes: on a line without a usable empty cell, a text's colour may be lost (rendered white).
• MIXED mode (80-column teleinformatics) is not supported.
• Terminal identification (ENQ/ENQROM) is deliberately silent: modern servers (MiniPavi) echo the reply into the input field instead of consuming it (same behaviour as miedit).
• Real V23 configuration (1200/75 baud, 7E1) for real Oric + modem hardware is on the roadmap; under the emulator the transfer is instantaneous.

Reproduced from docs/MANUEL_UTILISATION.md (authoritative, up-to-date version on GitHub).

← Documentation · Architecture →