# moserial-Handbuch V3.0.0

## Einführung

moserial ist ein serielles Terminal für den GNOME-Desktop, optimiert auf Protokollierung und Dateiaufzeichnung. moserial richtet sich in erster Linie an technisch orientierte Benutzer, die ein Kommunikationsinstrument für eingebettete Systeme, Konsolen und elektronische Testumgebungen benötigen.

Ungeachtet der technischen Orientierung des Zielpublikums wurde moserial daraufhin entworfen, benutzerfreundlich zu sein. Besonderer Wert wurde darauf gelegt, dass Operationen durch eine Verminderung der Zahl der benötigten Mausklicks einfach ausführbar sind. Ebenso wurde die Zahl der Einstellungsoptionen bewusst klein gehalten.

Um die Effizienz weiter zu verbessern, unterstützt moserial auch Profile, um häufig benutzte Konfigurationen zu speichern.

## Zugriffsrechte der Systemports

Bevor Sie moserial mit einem seriellen Port verwenden können, müssen Sie sicherstellen, dass Sie Lese- und/oder Schreibrechte auf diesem Port haben.

Auf einigen Systemen müssen Sie etwas wie »sudo chmod o+rw /dev/ttyS*« und »sudo chmod o+rw /dev/ttyUSB*« aufrufen, um Lese- und Schreibrechte für alle Benutzer auf den seriellen Ports zu erhalten. Unglücklicherweise bleibt diese Einstellung nach einem Neustart des Systems nicht erhalten.

Alternativ sehen Sie, welcher Gruppe dieses Gerät angehört und können Ihr Benutzerkonto als Mitglied dieser Gruppe zuordnen. In Fedora 15 beispielsweise sollten Sie sich selbst der Gruppe »dialout« zuordnen.

## Grundlagen der Benutzung

### Die Hauptwerkzeugleiste

Die meisten Funktionen von moserial sind über die Hauptwerkzeugleiste erreichbar, wie unten angezeigt:

### Port-Einstellung

Der erste Schritt bei der Benutzung von moserial ist die Konfiguration der Parameter des seriellen Ports. Klicken Sie dazu auf Port-Einstellungen. Im Dialog der Port-Einstellungen stellen Sie den zu verwendenden Port ein, ob der Port zum Lesen, Schreiben oder für beides geöffnet werden soll, dessen Baudrate, die Parität, die Anzahl der Daten- und Stoppbits und die Handshaking-Methode. Die Einstellungen in diesem Dialog überschreiben alle systemweit definierten Einstellungen für diesen Port.

Der Port-Einstellungsdialog von moserial listet nur die Ports /dev/ttySnn, /dev/ttyUSBnn und /dev/rfcommnn auf, die gegenwärtig auf Ihrem System vorhanden sind, wobei »nn« Werte zwischen 0 und 31 annehmen kann.

Über diesen Dialog können Sie auch ein lokales Echo aktivieren. Bei aktiviertem Echo werden alle von moserial empfangenen Daten an das sendende Gerät zurückgegeben. Dies sollte normalerweise deaktiviert sein, weil es unerwartete Folgen haben kann. Besonders in dem Fall, wenn auf dem sendenden Gerät ebenfalls ein Echo aktiviert ist, führt das zu einer Endlosschleife von Echos!

### Öffnen der Verbindung

Der nächste Schritt in der Kommunikation mit Ihrem entfernten Gerät ist das Anklicken von Verbinden. Dadurch wird der Port geöffnet. Falls Sie nicht über die nötigen Rechte verfügen, um diesen Port zu öffnen, erscheint eine Fehlermeldung.

Dieser Schritt ist optional. Falls Sie ihn überspringen, versucht moserial eine Verbindung automatisch herzustellen, falls nötig.

Sobald Sie verbunden sind, ändert sich die Beschriftung des Knopfes von Verbinden in Trennen. Klicken Sie auf Trennen, um den Port zu schließen und die TX- und RX-Zähler zurückzusetzen.

### Grundlagen der Eingabe und Ausgabe

Sobald der Port geöffnet ist, wird jeglicher vom entfernten Gerät empfangener Text im Textfeld Empfangenes ASCII angezeigt. Falls moserial einen hohen Anteil an nicht druckbaren Zeichen erkennt, wechselt die Anwendung automatisch in die Ansicht Empfangenes HEX.

Um zwischen der HEX- und der ASCII-Ansicht zu wechseln, klicken Sie einfach auf die entsprechenden Reiter.

Um Daten zum entfernten Gerät zu senden, geben Sie den Text in das einzeilige Textfeld Ausgehend ein und klicken auf Senden button. Ihre Textzeile wird mit der gewählten Sequenz abgeschlossen, die im Bereich rechts neben dem Senden-Knopf angezeigt wird. Falls Sie nicht sicher sind, welche Abschlusssequenz geeignet ist, sollten Sie »CR+LF« wählen. Der Knopf ASCII/HEX sollte zum Senden von Text auf ASCII gesetzt sein.

Falls der Knopf ASCII/HEX auf HEX gesetzt ist, geben Sie bitte keinen Text in Ausgehend ein. Verwenden Sie stattdessen Hexadezimalzahlen in der Form »1234ABCD....«.

Sobald Ihre Daten übertragen wurden, erscheint eine Aufzeichnung in den Textfeldern Gesendetes ASCII und Gesendetes HEX. Diese Texte sind nicht bearbeitbar.

Das entfernte Gerät kann ein Echo Ihrer gesendeten Daten zurückgeben. Falls moserial zurückgegebenen Text im Textbereich Empfangenes ASCII erkennt, wird der Echo-Text in der im Einstellungsdialog dafür festgelegten Farbe hervorgehoben.

Die Statuszeile am unteren Rand des Hauptfensters zeigt den Status des Ports an sowie die Anzahl der gesendeten (TX) und empfangenen (RX) Bytes. Falls einige der empfangenen Daten aus nicht druckbaren Zeichen bestehen, wird auch die Anzahl dieser Objekte angezeigt.

## Aufzeichnen von Eingabe und Ausgabe

Mit moserial können Sie die gesendeten und empfangenen Daten in einer Datei speichern. Diese Funktion ist auch nützlich für das Empfangen und Speichern eines kontinuierlichen Datenstroms von einem entfernten Gerät. Beispielsweise geben einige Oszilloskope Bildschirmfotos über den seriellen Port aus, unter Umgehung eventueller Fehlerkorrekturprotokolle (wie Tektronix 11801).

Wenn Sie zur Aufzeichnung in eine Datei bereit sind, klicken Sie auf Aufzeichnen, wählen die gewünschten Daten im Auswahlfeld Aufzuzeichnender Datenstrom aus (Eingehend/Ausgehend) und geben den Dateinamen im Dateiauswahldialog ein.

Sobald die Aufzeichnung beginnt, ändert sich die Beschriftung des Knopfes von Aufzeichnen in Aufzeichnung anhalten. Sie müssen darauf klicken, falls Sie die Aufzeichnung anzuhalten wünschen oder wenn Sie die gesamte Binärdatei empfangen haben, die Sie herunterladen wollten.

moserial kann wahlweise die aufgezeichnete Datei mit der für diesen Dateityp vorgegebenen Anwendung öffnen, sobald die Aufzeichnung beendet ist. Die Aufzeichnung kann auch nach einer inaktiven Zeitspanne beendet werden. Benutzen Sie den Einstellungsdialog, um diese Funktionsmerkmale zu aktivieren oder zu deaktivieren.

Beachten Sie, dass Sie für den Empfang von Dateien unter Verwendung eines Fehlerkorrekturprotokolls (xmodem, ymodem oder zmodem) die Funktion Datei empfangen benutzen müssen. Im Gegensatz zur Funktion Aufzeichnen kann die Funktion Datei empfangen automatisch erkennen, wann das Herunterladen der Datei abgeschlossen ist.

## Senden von Dateien

moserial kann Dateien in einem kontinuierlichen binären Datenstrom übertragen sowie Dateien unter Verwendung der Fehlerkorrekturprotokolle xmodem, ymodem und zmodem versenden. Während der Dateiübertragung werden die gesendeten Daten in den Textfeldern Gesendetes ASCII und Gesendetes HEX nicht protokolliert.

Wenn Sie zum Senden einer Datei bereit sind, klicken Sie auf Datei senden und wählen die gewünschte Datei aus. Sie müssen außerdem das entsprechende Protokoll auswählen.

Wenn eine Aufzeichnung beginnt, zeigt eine Fortschrittsleiste den Status der Dateiübertragung an.

moserial implementiert die Protokolle »xmodem«, »ymodem« oder »zmodem« nicht direkt. Es benutzt die Standardwerkzeuge »rz« und »sz« zum Senden und Empfangen von Daten. Diese Werkzeuge sind Bestandteil des Pakets »lrzsz«, das auf Ihrem System installiert sein muss.

## Empfangen von Dateien

moserial kann Dateien in einem kontinuierlichen binären Datenstrom empfangen sowie auch Dateien unter Verwendung der Fehlerkorrekturprotokolle xmodem, ymodem und zmodem empfangen. Während der Dateiübertragung werden die empfangenen Daten in den Textfeldern Gesendetes ASCII und Gesendetes HEX nicht protokolliert.

Um kontinuierliche binäre Datenströme zu empfangen, verwenden Sie die Funktion Aufzeichnen anstelle der Funktion Datei empfangen.

Für den Empfang von Dateien, die unter Verwendung der Fehlerkorrekturprotokolle xmodem, ymodem, oder zmodem gesendet werden, benutzen Sie die Funktion Datei empfangen.

Wenn Sie zum Empfang einer Datei bereit sind, klicken Sie auf Datei empfangen und wählen die gewünschte Datei aus. Sie müssen außerdem das entsprechende Protokoll auswählen.

Wenn eine Aufzeichnung beginnt, zeigt eine Fortschrittsleiste den Status des Dateiempfangs an.

moserial implementiert die Protokolle »xmodem«, »ymodem« oder »zmodem« nicht direkt. Es benutzt die Standardwerkzeuge »rz« und »sz« zum Senden und Empfangen von Daten. Diese Werkzeuge sind Bestandteil des Pakets »lrzsz«, das auf Ihrem System installiert sein muss.

## Weitere Einstellungen

moserial verfügt über verschiedene Optionen, die im Dialog Einstellungen bearbeitet werden können.

Die Farben des Vorder- und Hintergrunds der Textfelder, die Hervorhebung sowie die Schriftart und -größe können an Ihre Erfordernisse angepasst werden.

Falls Aufgezeichnete Dateien starten aktiviert ist, werden aufgezeichnete Dateien unmittelbar nach der Speicherung mit der für diesen Dateityp festgelegten Standardanwendung geöffnet. Die Standardanwendung ist von den Einstellungen der Arbeitsumgebung abhängig.

Falls Abbrechen nach aktiviert ist, dann werden Aufzeichnungen automatisch nach einer einstellbaren inaktiven Zeitspanne nach dem Empfang von Daten abgebrochen. Die Anwendung wartet allerdings auf den Empfang des ersten Daten-Bytes, bevor die Zeitspanne der Inaktivität ausgelöst wird.

## Verwenden von Profilen

moserial kann seine Einstellungen aus Profildateien laden und auch wieder in diese speichern, so dass Sie häufig verwendete Konfigurationen immer wieder aufrufen können. Zum Speichern eines Profils wählen Sie Datei Speichern oder Datei Speichern unter. Um ein Profil zu laden, verwenden Sie den Dialog Datei Öffnen.

Beim Laden eines Profils wird automatisch jeder geöffnete Port geschlossen.

Wenn Sie moserial beenden, werden die gegenwärtig benutzten Einstellungen in der vorgegebenen Profildatei gespeichert. Diese Einstellungen werden automatisch aufgerufen, wenn Sie moserial das nächste Mal starten.

## Tastenkürzel

Tastenkürzel | Beschreibung
Strg C | Text wird kopiert. Dies kann in jedem der Textbereiche verwendet werden.
Strg X | Schneidet Text aus. Das funktioniert nur im einzeiligen Textfeld Ausgehend.
Strg V | Fügt Text in das einzeilige Textfeld Ausgehend ein und aktiviert dieses Textfeld.
Esc | Aktiviert das einzeilige Textfeld Ausgehend.