Le but du projet PicoTel est de créer un système complètement autonome autour du terminal Minitel.
Par autonomie, il faut comprendre:
- Gestion de fichier (done with minishell)
- Editeur de code
- Execution de code (done with REPL thanks to
import module_name) - Transfert avec un ordinateur (done, tanks to Pico USB and MPRemote or ThonnyIDE)
Hacking or not hacking
Bien que cela ne soit pas nécessaire pour profiter des bienfait de MicroPython sur votre Minitel 2... l'idée de pouvoir hacker le Minitel reste quelque-chose de très captivant. Les développements du hacking fait l'objet d'une page séparée.
Connecteur UART côté minitel:
Attention: le signal Device Ready (aussi appelé PT) n'est actif que durant le mode vidéotexte. En mode Terminal, ce signal est ignoré!
Fiche DIN 5 positions:
Avant quoi que ce soit d'autre, il faut pouvoir configurer le Minitel en mode terminal.
Cela se fait avec les combinaisons de touches décrites ci-dessous. Un signe "+" indique que les touches doivent être pressées en même temps. Le "-->" indique une séquence de touches (ou séquence de combinaisons de touches) à suivre.
Passage en mode terminal
- Fnct+Sommaire : passage du mode Répertoire au mode Terminal
- Fnct+T --> A : Mode périphérique USA
- Fnct+T , F : Mode périphérique Français (pas toujours fonctionnel)
- Fnct+T , E : désactiver l'ECHO local
- Fnct+P , 4 : débit 4800 bauds (toujours disponible)
- Fnct+P , 9 : débit 9600 bauds (Minitel 2 uniquement)
Voyez le document readme_fnct.md pour plus de combinaisons de touches.
Le Pico doit exécuter une version de MicroPython implémentant os.dupterm() dans le firmware MicroPython.
- Ouvrir une session REPL sur le Pico à l'aide de ThonnyIDE ou RShell ou MPRemote
- Saisir le code suivant dans la session REPL. Si la fonction
dupterm()existe alors microPython doit simplement nous dire que c'est une fonction:
>>> import os
>>> # ne pas inclure les parenthèses!
>>> os.dupterm
<function>
>>>Super! La fonction dupterm() est bien disponible dans le firmware :-)
Si REPL retourne une erreur alors il faut installer une version de MicroPython avec le support dupterm().
Dans la version MicroPython 1.18 (jan 2022), dupterm() n'est pas encore inclus. J'ai donc recompilé un "MicroPython + DupTerm pour RaspberryPi Pico" inclus dans ce dépôt.
- Télécharger et décompresser le fichier _firmware/pico-dupterm-uf2.zip --> Le fichier
firmware.uf2est maintenant disponible. - Presser le bouton "Boot0" du pico en le mettant sous tension --> Le Pico affiche un système de fichiers sur l'ordinateur (comme une Clé USB).
- Copier le fichier
firmware.uf2(par glissé/déposé) dans le lecteur de Pico.
Après quelques secondes, le Pico redémarre et le lecteur disparaît.
Cette implémentation fonctionne correctement mais nécessite néanmoins un temps de pause (500 ms) après chaque opération print() pour éviter de surcharger le l'UART du Minitel.
Il faut maintenant permettre au Pico de dialoguer avec le terminal du Minitel.
Voici comment tester cette connexion:
- Etablir une session REPL avec le Raspberry-Pi Pico (via USB avec Thonny IDE, MPRemote ou RShell)
- Initialiser UART du Pico raccorder raccorder sur le Minitel
- Repliquer la session REPL sur l'UART.
$ mpremote
Connected to MicroPython at /dev/ttyACM0
Use Ctrl-] to exit this shell
>>> from machine import UART
>>> ser = UART( 0, 9600, bits=7, parity=2, stop=1 )
>>> from os import dupterm
>>> dupterm( ser )
Il est maintenant possible de saisir des commandes Python directement sur le Minitel.
Attention: l'envoi massif de texte (avec CR/LF) peut perturber le terminal Minitel et provoquer un écrasement de texte sur l'écran.
La classe PicoTelUart (picotel.py) s'insère entre l'uart matériel et le dupterm(). PicoTelUart insère un délai de 2ms après envoi de chaque trame de données vers le minitel de sorte qu'il n'y a plus d'écrasement de l'affichage sur le minitel.
Voici comment cela fonctionne:
$ mpremote
Connected to MicroPython at /dev/ttyACM0
Use Ctrl-] to exit this shell
>>> from picotel import PicoTelUart
>>> ser = PicoTelUart( 0, 9600, bits=7, parity=2, stop=1 )
>>> from os import dupterm
>>> dupterm( ser )
Le signal "Device Ready" n'est pas utilisé par le firmware Minitel en mode Terminal (uniquement le mode VideoText).
Par conséquent, il n'existe aucun moyen de gérer le flux de transmission (ni XON-XOFF, ni matériel) :-(
Pour créer un système autonome, il faut pouvoir faire toutes les opérations nécessaires depuis le Minitel lui-même.
Cela inclus:
- Manipulation du système de fichier
- Edition de texte/script
- transfert avec un ordinateur
Voici les différentes éléments mis en oeuvre.
Le fichier boot.py proposé ici, initialise automatiquement l'UART en 9600 bauds sur le Pico du fait un dupterm() sur l'UART.
Le script boot.py utilise également un switch (RunApp, sur le GPIO16) permettant d'inhiler/activer la création de l'UART et le réplication de REPL. Cela permet de récupérer la main sur le Raspberry-Pi Pico depuis un ordinateur même si quelque-chose se passe mal.
La LED sur GPIO 25 du Pico s'allume lorsque REPL est répliqué sur l'UART.
Le fichier principal exécuté par le Pico juste après l'initialisation (boot.py).
Dans le cas du PicoTel, le script principal vérifie l'état du switch RunApp avant de démarrer mshell (voir ci-dessous).
Le projet MiniShell (mshell pour les intimes) est une ligne de commande de type Linux, un shell minimaliste, lui-même écrit en MycroPython. MShell est conçu pour apporter un support rudimentaire de gestion de fichiers. Avec mshell is est possible de créer/effacer/voir/copier/déplacer les fichiers directement depuis la session REPL.
Depuis la création de PicoTel, MiniShell (alias mshell) a fortement évolué au point de disposer de son propre dépôt (micropython-minishell](https://github.com/mchobby/micropython-minishell)
Un fois MiniShell / MShell copié dans le le sous-répertoire lib/, il peut-être démarré depuis REPL en saississant import mshell (ou redémarré avec mshell.run() ).
L'image d'accueil de ce readme présente justement l'utilisation de MShell sur le Minitel, résultant des saisies suivantes:
MPY: soft reboot
Running PicoTel
MicroPython v1.18-420-g1e72580fd-dirty on 2022-05-10; Raspberry Pi Pico with RP2040
Type "help()" for more information.
>>> import mshell
=== Welcome to mini shell 0.0.2 ===
Supports: help, append, cat, cp, df, exit, ls, mv, rm, touch, uname
Use mshell.run() to restart!
$ cat coca.txt
__ ___ __ .ama ,
,d888a ,d88888888888ba. ,88"I) d
a88']8i a88".8"8) `"8888:88 " _a8'
.d8P' PP .d8P'.8 d) "8:88:baad8P'
,d8P' ,ama, .aa, .ama.g ,mmm d8P' 8 .8' 88):888P'
,d88' d8[ "8..a8"88 ,8I"88[ I88' d88 ]IaI" d8[
a88' dP "bm8mP8'(8'.8I 8[ d88' `" .88
,88I ]8' .d'.8 88' ,8' I[ ,88P ,ama ,ama, d8[ .ama.g
[88' I8, .d' ]8, ,88B ,d8 aI (88',88"8) d8[ "8. 88 ,8I"88[
]88 `888P' `8888" "88P"8m" I88 88[ 8[ dP "bm8m88[.8I 8[
]88, _,,aaaaaa,_ I88 8" 8 ]P' .d' 88 88' ,8' I[
`888a,. ,aadd88888888888bma. )88, ,]I I8, .d' )88a8B ,d8 aI
"888888PP"' `8""""""8 "888PP' `888P' `88P"88P"8m"
$
pye est un éditeur VT100 écrit en MicroPython développé par robert-hh (lien GitHub). Celui-ci a testé avec succès sur le Minitel 2.
Cet editeur de texte est intégré à mshell (commande edit, version 0.0.3) pour rapidement éditer un fichier ou script.
Il est également possible de démarrer un éditeur dans vos propres scripts avec le code suivant:
import pye
with open( 'coca.txt' ) as f:
content = f.read().splitlines()
pye.pye( content )Voici la liste des raccourcis claviers supportés par l'éditeur de texte.
L'interface USB-Serie du Raspberry-Pi Pico reste totalement accessible et fonctionnelle.
Il est donc possible de connecter le Pico sur un ordinateur et d'échanger des fichiers avec vos utilitaires habituelles sans avoir besoin de déconnecter le Pico du Minitel.
Outils pour travailler avec votre Pico.
- MPRemote
- ThonnyIDE
- RShell
- Utiliser le mode ASCII US pour voir les "#" (sinon affichés comme ""£")
Le clavier ne permet pas de saisir certains caractères:
- _ : (underscore) parfois utilisé dans les noms de fichiers
- CTRL + C : n'arrive pas jusqu'à REPL!
- [Mode d'emploi du Minitel 2 (Philips)](docs/mode-d-emploi-minitel- 2-philips.pdf) (pdf)
- [Mode d'emploi du Minitel 2 (Philips, détaillé)](docs/mode-d-emploi-minitel- 2-philips-detaille.pdf) (pdf)
- Schéma Minitel (pdf)
- RX-TX Minitel (png)
- ASCII - American Standard Code for Information Interchange (Wikipedia.fr)
Lectures complémentaires:
- Minitel branché sur mon Raspberry-Pi Pico
- univ-toulouse.fr - grundman - Modems-HOWTO-8 (ne semble plus accessible)
- From Trash to Treasure: How to Resurrect a Minitel Terminal
- DIN Audio/Video Connector, plug, 5 Pos - PS000178, MultiCom Pro available at Farnell
- Raspberry-Pi Pico @ MCHobby
- 4 bits Level Shifter @ MCHobby