# Manuel de moserial v3.0.0

## Introduction

moserial est un terminal série pour le bureau GNOME, optimisé pour la journalisation et la capture de fichiers. Il est avant tout destiné aux utilisateurs techniques devant communiquer avec des systèmes embarqués, des consoles et des matériels de test électroniques.

Malgré l'orientation technique de l'audience visée, moserial est conçu pour être facile à utiliser. Un soin particulier a été apporté à ce que les opérations soient simples à exécuter, en minimisant le nombre de clics nécessaires. Le nombre d'options de configuration reste faible.

Pour accroître l'efficacité, moserial gère aussi des fichiers de profil pour conserver les configurations les plus utilisées.

## Droits d'accès aux ports systèmes

Avant d'utiliser moserial avec un port série, vous devez vous assurer que vous possédez bien les droits d'accès à ce port pour lire et écrire.

Sur d'autres systèmes, vous aurez peut-être à lancer des commandes semblables à celles-ci : « sudo chmod o+rw /dev/ttyS* » ou « sudo chmod o+rw /dev/ttyUSB* », pour obtenir les droits d'accès aux ports série en lecture et en écriture (pour tous les utilisateurs). Malheureusement, ces réglages ne sont pas toujours conservés lors d'un redémarrage.

Sinon, vous pouvez voir à quel groupe appartiennent les périphériques et ajouter votre compte comme membre de ce groupe. Avec Fedora 15, par exemple, il faut vous ajouter au groupe « dialout ».

## Utilisation de base

### Barre d'outils principale

La plupart des fonctions de moserial sont accessibles par la barre d'outils principale, affichée ci-dessous :

### Paramétrage de port

La première étape de l'utilisation de moserial est la configuration des paramètres du port série. Pour cela, cliquez sur Paramétrage de port. Dans la boîte de dialogue Paramétrage de port, vous définirez le port à utiliser, s'il doit être ouvert en lecture, en écriture, ou les deux, la vitesse de transmission en bauds, sa parité, le nombre de bits de données et d'arrêt, et la méthode de contrôle de flux. Les paramètres définis dans cette fenêtre écraseront les paramètres système définis par défaut pour ce port.

La boîte de dialogue Paramétrage de port de moserial n'énumère que les ports /dev/ttySnn, /dev/ttyUSBnn et /dev/rfcommnn effectivement présents sur le système, où les valeurs « nn » sont comprises entre 0 et 31.

Un écho local peut être activé dans cette boîte de dialogue. Dans ce cas, toutes les données que moserial reçoit seront répétées dans le périphérique d'envoi. Cette option devrait normalement être désactivée, car elle peut être cause de comportements anormaux, surtout si elle est également activée dans le périphérique distant (risque d'écho en boucle infinie).

### Ouverture de la connexion

L'étape suivante pour communiquer avec le périphérique distant est de cliquer sur Connecter, ce qui ouvre le port. Si vous n'avez pas les droits d'accès à ce port, une erreur sera émise.

Cette étape est facultative. Si vous l'omettez, moserial tentera de se connecter automatiquement quand ce sera nécessaire.

Une fois connecté, le bouton Connecter se change en bouton Déconnecter. Le fait de cliquer sur Déconnecter ferme le port et réinitialise les compteurs TX et RX.

### Entrée et sortie de base

Une fois le port ouvert, tout texte reçu depuis le périphérique distant s'affiche dans la zone de texte ASCII reçu. Si moserial détecte un grand nombre de caractères non imprimables, il passera automatiquement en visualisation HEX reçu.

Pour basculer entre les visualisations HEX et ASCII, cliquez simplement sur les onglets correspondants.

Pour envoyer des données au périphérique distant, tapez le texte dans la boîte uni-ligne Sortant et cliquez sur le bouton Envoyer. Votre ligne de texte se terminera par la séquence sélectionnée dans la liste déroulante tout à droite du bouton Envoyer. Si vous n'êtes pas sûr de cette séquence de terminaison, essayez d'abord « CR+LF end ». Le bouton ASCII/HEX doit être sur ASCII pour envoyer du texte.

Si le bouton ASCII/HEX est sur HEX, ne saisissez pas de texte dans la zone Sortant. À la place, saisissez des caractères hexadécimaux sous la forme « 1234ABCD.... ».

Après transmission des données, un enregistrement de ces données se trouvera dans les zones de texte ASCII envoyé et HEX envoyé. Ces zones de texte ne sont pas modifiables.

Le périphérique distant peut faire écho aux données envoyées. Si moserial détecte un texte répété dans la zone de texte ASCII reçu, il mettra le texte répété en surbrillance (en utilisant la couleur de surbrillance définie dans la boîte de dialogue des préférences).

La barre d'état, en bas de la fenêtre principale, affiche l'état du port ainsi que le compte des octets envoyés (TX) et reçus (RX). Si certaines des données ne peuvent être affichées, le compte de ces données est néanmoins présenté.

## Enregistrement des entrées et des sorties

moserial peut enregistrer dans un fichier les données envoyées et reçues. Cette fonction est également utile pour recevoir et enregistrer directement des données binaires déversées depuis un périphérique distant. C'est le cas de certains oscilloscopes qui dirigent des captures d'écran vers un port série, sans recourir à un protocole de correction d'erreurs (tel le Tektronix 11801).

Quand vous êtes prêt à enregistrer vers un fichier, cliquez simplement sur Enregistrer, sélectionnez les données que vous voulez enregistrer (entrantes et/ou sortantes) dans la boîte de sélection du Flux à enregistrer et saisissez le nom de fichier.

Quand l'enregistrement commence, le bouton Enregistrer devient Arrêter l'enregistrement. Vous devez cliquer sur ce bouton quand vous souhaitez arrêter l'enregistrement ou quand vous avez reçu la totalité du fichier binaire que vous souhaitiez télécharger.

moserial peut éventuellement lancer le fichier enregistré, avec l'application par défaut pour son type de fichier, quand l'enregistrement est fini. Il peut aussi interrompre l'enregistrement après une période d'inactivité. Utilisez les Préférences pour activer ou désactiver ces options.

Notez que si vous souhaitez recevoir des fichiers en utilisant un protocole de correction d'erreurs (xmodem, ymodem ou zmodem), vous devez utilisez la fonction Recevoir un fichier. Contrairement à la fonction Enregistrer, la réception de fichier peut automatiquement détecter la fin d'un téléchargement de fichier.

## Envoi de fichiers

moserial peut transmettre des fichiers dans un flux de données binaires direct, mais il peut aussi les transmettre en passant par les protocoles de correction d'erreurs xmodem, ymodem et zmodem. Pendant la transmission de fichier, les données envoyées ne sont pas reliées aux zones de texte ASCII envoyé ou HEX envoyé.

Quand vous êtes prêt à envoyer un fichier, cliquez simplement sur Envoyer un fichier. Vous devrez aussi sélectionner le protocole approprié en bas de la fenêtre.

Pendant l'enregistrement, une barre de progression affiche l'état de transmission du fichier.

moserial n'applique pas les protocoles xmodem, ymodem ou zmodem directement. Il dépend des utilitaires standards rz et sz pour envoyer et recevoir des données. Ces utilitaires font partie du paquet lrzsz, qui doit être installé sur votre système.

## Réception de fichiers

moserial peut recevoir des fichiers dans un flux direct de données binaires, mais il peut aussi les recevoir en passant par les protocoles de correction d'erreurs xmodem, ymodem et zmodem. Pendant la transmission de fichier, les données reçues ne sont pas reliées aux zones de texte ASCII reçu ou HEX reçu.

Pour recevoir des flux de données binaires directs, utilisez la fonction Enregistrer plutôt que la fonction Recevoir un fichier.

Pour recevoir des fichiers envoyés avec les protocoles de correction d'erreurs xmodem, ymodem ou zmodem, utilisez la fonction Recevoir un fichier.

Quand vous êtes prêt à recevoir un fichier, cliquez simplement sur Recevoir un fichier et sélectionnez un dossier pour y enregistrer le fichier reçu. Vous devrez également sélectionner le protocole approprié en bas de la fenêtre.

Pendant l'enregistrement, une barre de progression affiche l'état de réception du fichier.

moserial n'applique pas les protocoles xmodem, ymodem ou zmodem directement. Il dépend des utilitaires standards rz et sz pour envoyer et recevoir des données. Ces utilitaires font partie du paquet lrzsz, qui doit être installé sur votre système.

## Autres préférences

moserial possède plusieurs options qui peuvent être configurées depuis la boîte de dialogue Préférences.

Vous pouvez configurer les couleurs de premier plan et d'arrière-plan des zones de texte, la couleur de la surbrillance, ainsi que la couleur, le type et la taille de la police.

Si l'option Lancer les fichiers enregistrés est activée, le fichier enregistré sera ouvert aussitôt après sa sauvegarde, en utilisant l'application par défaut pour le type du fichier. L'application par défaut est définie par l'environnement de bureau.

Si l'option Activer le délai de connexion est cochée, l'enregistrement s'arrêtera automatiquement après une durée d'inactivité ajustable, si la réception de données est interrompue. C'est-à-dire que moserial attendra indéfiniment d'enregistrer les premières données avant d'activer le compteur d'inactivité.

## Utilisation de profils

moserial peut enregistrer ses paramètres dans un fichier de profil et les charger à partir de ce profil. Vous pouvez ainsi sauvegarder et rappeler vos configurations les plus utilisées. Pour enregistrer un profil, faites appel à la boîte de dialogue Fichier Enregistrer la configuration ou Fichier Enregistrer les paramètres sous. Pour charger un profil, utilisez la boîte de dialogue Fichier Ouvrir les paramètres.

Le chargement d'un profil déconnecte automatiquement tout port connecté.

Quand vous quittez moserial, les paramètres en cours sont enregistrés dans un fichier de profil par défaut. Ces paramètres seront automatiquement rappelés lors du prochain lancement de moserial.

## Touches spéciales

Raccourci clavier | Description
Ctrl C | Copie le texte. Peut être utilisé dans toutes les zones de texte.
Ctrl X | Coupe le texte. Ne marche que pour la zone de texte uni-ligne Sortant.
Ctrl V | Colle le texte dans la zone de texte uni-ligne Sortant et déplace le pointeur dans cette zone.
Esc | Positionne le pointeur dans la zone de texte uni-ligne Sortant.