Working with the serial console (Français)
Une machine sous Arch Linux peut être configurée pour des connexions via le port de console série, ce qui permet d'administrer une machine même si aucun clavier, souris, moniteur ou réseau ne lui est attaché.
L'installation d'Arch Linux est également possible via la console série.
Un environnement de base pour ce scénario est constitué de deux machines connectées à l'aide d'un câble série (câble de connexion à 9 broches). La machine administratrice peut être n'importe quelle machine Unix/Linux ou Windows avec un programme émulateur de terminal (PuTTY ou Minicom, par exemple).
Les instructions de configuration ci-dessous permettront de sélectionner le menu du chargeur d'amorçage, les messages de démarrage et le transfert de terminal vers la console série.
Configurer l'accès à la console sur la machine cible
Chargeur d'amorçage
GRUB
Lorsque vous utilisez GRUB avec un grub.cfg généré, éditez /etc/default/grub et activez la prise en charge des entrées et sorties série :
/etc/default/grub
... GRUB_TERMINAL_INPUT="console serial" ... GRUB_TERMINAL_OUTPUT="gfxterm serial" ... ...
Ajoutez ensuite la variable GRUB_SERIAL_COMMAND et définissez les options pour la connexion série. Pour COM1 (/dev/ttyS0) avec une vitesse de transmission de 115200 bit/s :
/etc/default/grub
... GRUB_SERIAL_COMMAND="serial --unit=0 --speed=115200"
Lisez le manuel de GRUB sur Utilisation de GRUB via un port série et la commande série pour une explication détaillée des options disponibles.
GRUB Legacy
Editez le fichier de configuration GRUB Legacy /boot/grub/menu.lst et ajoutez ces lignes dans la zone générale de la configuration :
serial --unit=0 --speed=9600 terminal --timeout=5 serial console
terminal --timeout=5 serial console est ajoutée à votre menu.lst, votre séquence de démarrage affichera désormais une série de messages Press any key to continue. Si aucune touche n'est enfoncée, le menu de démarrage s'affichera sur le périphérique (série ou console) apparaissant en premier dans la ligne de configuration terminalrEFInd
rEFInd prend en charge la console série uniquement en mode texte. Editez refind.conf et décommentez textonly.
Syslinux
Pour activer la console série dans Syslinux (Français), éditez syslinux.cfg et ajoutez SERIAL comme première directive dans le fichier de configuration.
Pour COM1 (/dev/ttyS0) avec un débit en bauds de 115200 bit/s :
SERIAL 0 115200
Les paramètres série sont codés en dur à 8 bits, sans parité et 1 bit d'arrêt [1]. Lisez Wiki Syslinux:Config#SERIAL pour les options.
Kernel
La sortie du noyau peut être envoyée à la console série en définissant le console= paramètre du noyau. Le dernier console= spécifié sera défini comme /dev/console.
console=tty0 console=ttyS0,115200
Consultez https://docs.kernel.org/admin-guide/serial-console.html.
getty
Au démarrage, systemd-getty-generator(8) démarre une instance getty pour chaque console spécifiée dans la ligne de commande du noyau.
Si vous n'avez pas configuré console= dans la ligne de commande du noyau démarrez serial-getty@device.service. Pour /dev/ttyS0 (COM1), ce serait serial-getty@ttyS0.service. Activez le service pour le démarrer au démarrage.
Sauf indication contraire dans la ligne de commande du noyau, getty attendra un débit en bauds de 38400 bit/s, 8 bits de données, pas de parité et un bit d'arrêt.
Faire des connexions
Connexion à l'aide d'un programme émulateur de terminal
uucp. Sinon, vous aurez besoin de l'autorisation de root pour établir une connexion :
# gpasswd -a username uucpConsultez Users and groups (Français)#Groupes d'utilisateurs pour plus de détails.
Effectuez ces étapes sur la machine utilisée pour connecter la console distante.
dterm
dtermAUR[broken link: package not found] est un petit programme de communication série. Si vous l'invoquez sans paramètres, il se connectera à /dev/ttyS0 à 9600 bauds par défaut. L'exemple suivant se connecte à /dev/ttyS0 à 115200 bauds, avec 8 bits de données, aucun bit de parité et 1 bit d'arrêt :
$ dterm 115200 8 n 1
Consultez sa page d'accueil [2][dead link 2023-05-06 ⓘ] pour plus d'exemples.
Minicom
minicom peut être obtenu à partir des dépôts officiels. Démarrez Minicom en mode configuration :
$ minicom -s
En utilisant le menu de navigation textuel, modifiez les paramètres du port série comme suit :
Serial Device : /dev/ttyS0 Bps/Par/Bits : 9600 8N1
Appuyez sur Entrée pour quitter les menus (l'appui sur Echap n'enregistrera pas les changements).
Supprimez les chaînes Init et Reset du modem, car nous ne nous connectons pas à un modem. Pour ce faire, dans le menu Modem and Dialing, supprimez les chaînes Init et Reset. Vous pouvez également sauvegarder la configuration en choisissant save setup as dfl dans le menu principal.
Redémarrez minicom avec le câble série connecté à la machine cible.
Pour terminer la session, appuyez sur Ctrl+A suivi de Ctrl+X.
picocom
picocom est un petit programme d'émulation de terminaux muets qui ressemble beaucoup à minicom, mais au lieu de mini, c'est pico. L'exemple suivant se connecte à ttyS0 à 9600 bps :
$ picocom -b 9600 /dev/ttyS0
--omap delbsConsultez son manuel pour une utilisation détaillée.
Screen
GNU Screen est capable de se connecter à un port série. Il se connectera à 9600 bauds par défaut :
$ screen /dev/ttyS0
Une vitesse de transmission différente (par exemple 115200) peut être spécifiée sur la ligne de commande.
$ screen /dev/ttyS0 115200
Pour terminer la session, appuyez sur Ctrl+a suivi de K. Vous pouvez également appuyer sur Ctrl+a, taper :quit et confirmer en appuyant sur Enter.
Serialclient
Serialclient [3] est un client CLI pour la connexion série écrit en ruby. Installez le paquet ruby, puis installez-le avec ce qui suit :
# gem install serialclient
Ensuite, vous pouvez l'utiliser comme ceci :
$ serialclient -p /dev/ttyS0
Interfaces graphiques
- cutecom — Un moniteur série avec interface graphique.
- PuTTY — Un client SSH/Telnet avec un terminal intégré.
- moserial — Un terminal série basé sur GTK, principalement destiné aux utilisateurs techniques et aux bricoleurs informatiques qui ont besoin de communiquer avec des systèmes embarqués, des équipements de test et des consoles série.
Clients Windows
Sur les machines Windows, connectez-vous au port série à l'aide de programmes comme PuTTY [4] ou Terminalbpp [5].
Installation d'Arch Linux à l'aide de la console série
ttyS0/COM1) à 115200 bps, avec 8 bits de données, aucun bit de parité et 1 bit d'arrêt.- Connectez-vous à la machine cible en utilisant la méthode décrite ci-dessus.
- Démarrez la machine cible en utilisant le medium d'installation d'Arch Linux.
- Lorsque le chargeur d'amorçage s'affiche, sélectionnez Boot Arch Linux (<arch>) et appuyez sur
Tabpour éditer. - Ajoutez
console=ttyS0,115200et appuyez surEnter. - Maintenant systemd devrait détecter ttyS0 et lancer un getty en série dessus. Connectez-vous en tant que
rootet démarrez l'installation comme d'habitude.
- Une fois l'installation terminée, les paramètres de la console ne seront pas sauvegardés sur la machine cible ; afin d'éviter d'avoir à connecter un clavier et un moniteur, configurez l'accès à la console sur la machine cible avant de redémarrer.
- Bien qu'une vitesse de port de 9600 soit utilisée dans la plupart des exemples de ce document, il est recommandé de travailler avec des valeurs plus élevées (la liste des vitesses disponibles est affichée dans Minicom en appuyant sur
Ctrl+apuisp)
Déboguer une machine qui ne répond pas en utilisant une console série
Bien que [7] ne contienne que des instructions brutes et laconiques, il présente un bon résumé. Il est important de noter qu'ici, la machine testée a perdu sa réactivité de manière reproductible. Et que cela s'est produit pendant un fonctionnement normal. On pouvait donc y accéder normalement avant de devoir la déboguer. Cependant, en général, la console série est également utile pour déboguer les problèmes de démarrage. Peut-être en configurant le chargeur d'amorçage à la main au moment du démarrage de la machine. Notez également la mention netconsole dans le paragraphe P.S. du lien externe de cette section.
Dépannage
Ctrl+c et Minicom
Si vous avez des difficultés à envoyer une commande Ctrl+c via minicom, vous devez désactiver le contrôle de flux matériel dans les paramètres du périphérique (minicom -s), ce qui active alors l'interruption.
Redimensionnement d'un terminal
Contrairement à ssh, les connexions série n'ont pas de mécanisme pour transférer quelque chose comme SIGWINCH lorsqu'un terminal est redimensionné. Cela peut causer des problèmes étranges avec certains programmes plein écran (par exemple, less) lorsque vous redimensionnez la fenêtre de votre émulateur de terminal.
Le redimensionnement du terminal via stty est une solution de contournement :
$ stty rows lignes cols colonnes.
Cependant, cela vous oblige à saisir manuellement la géométrie appropriée. Les méthodes suivantes devraient être plus simples.
1. Il existe un utilitaire moins connu appelé resize, fourni avec xterm, qui peut résoudre ce problème. Appelez-le sans paramètres après avoir redimensionné la fenêtre de l'émulateur de terminal :
$ resize
2. Si vous ne souhaitez pas installer xterm, il est possible d'effectuer le même travail via une fonction shell. Placez la fonction suivante dans votre zshrc et invoquez-la sans paramètres après avoir redimensionné la fenêtre de l'émulateur de terminal :
rsz() {
if [[ -t 0 && $# -eq 0 ]];then
local IFS='[;' escape geometry x y
print -n '\e7\e[r\e[999;999H\e[6n\e8''.
read -sd R escape geometry
x=${geometry##*;} y=${geometry%%;*}
if [[ ${COLUMNS} -eq ${x} && ${LINES} -eq ${y} ]];then
print "${TERM} ${x}x${y}"
else
print "${COLUMNS}x${LINES} -> ${x}x${y}"
stty cols ${x} lignes ${y}
fi
else
[[ -n ${commandes[repo-elephant]} ]] && repo-elephant || print 'Usage : rsz' ## oeuf de Pâques ici :)
fi
}
Ports manquants sur les cartes d'extension multi-ports
Le nombre de ports série utilisant le pilote générique 8250 dans la configuration par défaut du noyau est fixé à 4 au moment de l'exécution avec un maximum de 32. Cela empêchera la création de /dev/ttyS4 et plus. En comptant le port série intégré typique sur la carte mère, cela empêche l'utilisation du 4ème port série sur une carte d'extension à 4 ports.
Ceci peut être annulé par le paramètre du noyau 8250.nr_uarts. Par exemple
8250.nr_uarts=5