# moserial Manual V3.0.0

2009 Michael J. Chudobiak
2009 Daniel Nylander (po@danielnylander.se)
Dokumentationsprojekt för GNOME

Tillstånd att kopiera, distribuera och/eller modifiera detta dokument ges under villkoren i GNU Free Documentation License (GFDL), version 1.1 eller senare, utgivet av Free Software Foundation utan standardavsnitt och omslagstexter. En kopia av GFDL finns att hämta på denna länk eller i filen COPYING-DOCS som medföljer denna handbok.

Denna handbok utgör en av flera GNOME-handböcker som distribueras under villkoren i GFDL. Om du vill distribuera denna handbok separat från övriga handböcker kan du göra detta genom att lägga till en kopia av licensavtalet i handboken enligt instruktionerna i avsnitt 6 i licensavtalet.

Flera namn på produkter och tjänster är registrerade varumärken. I de fall dessa namn förekommer i GNOME-dokumentation - och medlemmarna i GNOME-dokumentationsprojektet är medvetna om dessa varumärken - är de skrivna med versaler eller med inledande versal.

DOKUMENTET OCH MODIFIERADE VERSIONER AV DOKUMENTET TILLHANDAHÅLLS UNDER VILLKOREN I GNU FREE DOCUMENTATION LICENSE ENDAST UNDER FÖLJANDE FÖRUTSÄTTNINGAR:

1. DOKUMENTET TILLHANDAHÅLLS I "BEFINTLIGT SKICK" UTAN NÅGRA SOM HELST GARANTIER, VARE SIG UTTRYCKLIGA ELLER UNDERFÖRSTÅDDA, INKLUSIVE, MEN INTE BEGRÄNSAT TILL, GARANTIER ATT DOKUMENTET ELLER EN MODIFIERAD VERSION AV DOKUMENTET INTE INNEHÅLLER NÅGRA FELAKTIGHETER, ÄR LÄMPLIGT FÖR ETT VISST ÄNDAMÅL ELLER INTE STRIDER MOT LAG. HELA RISKEN VAD GÄLLER KVALITET, EXAKTHET OCH UTFÖRANDE AV DOKUMENTET OCH MODIFIERADE VERSIONER AV DOKUMENTET LIGGER HELT OCH HÅLLET PÅ ANVÄNDAREN. OM ETT DOKUMENT ELLER EN MODIFIERAD VERSION AV ETT DOKUMENT SKULLE VISA SIG INNEHÅLLA FELAKTIGHETER I NÅGOT HÄNSEENDE ÄR DET DU (INTE DEN URSPRUNGLIGA SKRIBENTEN, FÖRFATTAREN ELLER NÅGON ANNAN MEDARBETARE) SOM FÅR STÅ FÖR ALLA EVENTUELLA KOSTNADER FÖR SERVICE, REPARATIONER ELLER KORRIGERINGAR. DENNA GARANTIFRISKRIVNING UTGÖR EN VÄSENTLIG DEL AV DETTA LICENSAVTAL. DETTA INNEBÄR ATT ALL ANVÄNDNING AV ETT DOKUMENT ELLER EN MODIFIERAD VERSION AV ETT DOKUMENT BEVILJAS ENDAST UNDER DENNA ANSVARSFRISKRIVNING;

2. UNDER INGA OMSTÄNDIGHETER ELLER INOM RAMEN FÖR NÅGON LAGSTIFTNING, OAVSETT OM DET GÄLLER KRÄNKNING (INKLUSIVE VÅRDSLÖSHET), KONTRAKT ELLER DYLIKT, SKA FÖRFATTAREN, DEN URSPRUNGLIGA SKRIBENTEN ELLER ANNAN MEDARBETARE ELLER ÅTERFÖRSÄLJARE AV DOKUMENTET ELLER AV EN MODIFIERAD VERSION AV DOKUMENTET ELLER NÅGON LEVERANTÖR TILL NÅGON AV NÄMNDA PARTER STÄLLAS ANSVARIG GENTEMOT NÅGON FÖR NÅGRA DIREKTA, INDIREKTA, SÄRSKILDA ELLER OFÖRUTSEDDA SKADOR ELLER FÖLJDSKADOR AV NÅGOT SLAG, INKLUSIVE, MEN INTE BEGRÄNSAT TILL, SKADOR BETRÄFFANDE FÖRLORAD GOODWILL, HINDER I ARBETET, DATORHAVERI ELLER NÅGRA ANDRA TÄNKBARA SKADOR ELLER FÖRLUSTER SOM KAN UPPKOMMA PÅ GRUND AV ELLER RELATERAT TILL ANVÄNDNINGEN AV DOKUMENTET ELLER MODIFIERADE VERSIONER AV DOKUMENTET, ÄVEN OM PART SKA HA BLIVIT INFORMERAD OM MÖJLIGHETEN TILL SÅDANA SKADOR.

Michael Chudobiak

     mjc@svn.gnome.org

3.0.0
April 2009

Michael J. Chudobiak

Dokumentationsprojekt för GNOME

This is manual describes version 3.0.0 of moserial

moserial är en seriell terminal för GNOME-skrivbordet, optimerad för loggning och filfångst.

## Introduktion

moserial är en seriell terminal för GNOME-skrivbordet, optimerad för loggning och filfångst. moserial är primärt tänkt för tekniska användare som behöver kommunicera med inbäddade system, konsoller och elektronisk testutrustning.

Despite the technical orientation of the intended audience, moserial is designed to be user-friendly. Care has been taken to ensure that operations are simple to execute, by minimizing the number of clicks needed. The number of configuration options has also been kept small.

To further improve efficiency, moserial also supports profile files to store frequently-used configurations.

## System Port Permissions

Before using moserial with a serial port, you need to make sure that you actually have permission to read and/or write to the port.

On some systems, you may need to do something like "sudo chmod o+rw /dev/ttyS*" and "sudo chmod o+rw /dev/ttyUSB*" to obtain read/write permissions (for all users) on the serial ports. Unfortunately, this may not be persistent after reboots.

Alternatively, you can see what group the devices belong to, and make your account a member of that group. In Fedora 15, for example, you should add yourself to the "dialout" group.

## Basic Usage

### The Main Toolbar

Most moserial functions are accessed through the main toolbar, shown below:

### Port Setup

The first step in using moserial is to configure the serial port parameters. Click Port Setup to do this. In the port setup dialog, you will set the port to use, whether the port should be open for reads, writes, or both, its baud rate, its parity, the number of data and stop bits, and the handshaking method. The settings specified in this dialog will override any system default settings for the port.

The moserial port setup dialog will only list the /dev/ttySnn, /dev/ttyUSBnn, and /dev/rfcommnn ports that actually exist on the system, for values of "nn" between 0 and 31.

A local echo can be enabled from this dialog. If enabled, all data that moserial receives will be echoed back to the sending device. This should normally be disabled, as it can cause unexpected behaviour, especially if the remote device also has echo enabled. (This would cause an infinite loop of echoes!)

### Öppna anslutningen

The next step in communicating with your remote device is to click Connect. This opens the port. If you do not have the necessary privileges to open the port, an error will be reported.

This step is optional. If you skip it, moserial will try to connect automatically when needed.

Once you have connected, the Connect button will change into a Disconnect button. Clicking Disconnect closes the port, and resets the TX and RX counters.

### Basic Input and Output

Once the port has been opened, any text received from the remote device will be displayed in the Received ASCII text area. If moserial detects a large number of unprintable characters, it will switch automatically to the Received HEX view.

To switch between HEX and ASCII views, simply click on the appropriate tabs.

To send data to the remote device, you can type text into the Outgoing single-line text box, and click the Send button. Your line of text will be terminated with the sequence selected in the area to the right of the Send button. If you aren't sure which termination sequence is best, start with "CR+LF end". The ASCII/HEX button should be set to ASCII to send text.

If the ASCII/HEX button is set to HEX, do not enter text in the Outgoing area. Instead, enter hexadecimal numbers in the form "1234ABCD....".

Once your data has been transmitted, a record of it will exist in the Sent ASCII and Sent HEX text areas. These text areas are not editable.

The remote device may echo your sent data. If moserial detects echoed text in the Received ASCII text area, it will highlight the echoed text (using the highlight color defined in the preferences dialog).

The statusbar at the bottom of the main window shows the state of port, and a count of the sent (TX) and received (RX) bytes. If some of the received data is unprintable, a count of these items is shown as well.

## Recording Input and Output

moserial can be used to record your sent and received data to a file. This function is also useful for receiving and storing straight binary data dumped from a remote device. For instance, some oscilloscopes will dump screenshots to a serial port, without using any error correction protocols (like the Tektronix 11801).

When you are ready to record to a file, simply click Record, select the desired data to record (Incoming and/or Outgoing) in the Stream to Record selection box, and enter the filename in the filechooser area.

When recording begins, the Record button will change into a Stop Recording button. You will need to click this when you wish to stop recording, or you have received the entire binary file that you wanted to download.

moserial can optionally launch the recorded file with the default application for its file type, when recording has finished. It can also terminate recording after a period of inactivity. Use the Preferences dialog to enable or disable these features.

Note that if you wish to receive files using an error correction protocol (xmodem, ymodem, or zmodem), you will need to use the Receive File function instead. Unlike the Record function, the Receive File function can automatically determine when the file download is complete.

## Skicka filer

moserial can transmit files in a straight binary data stream, and it can also send files using the xmodem, ymodem, and zmodem error correction protocols. During file transmission, the sent data is not logged to the Sent ASCII or Sent HEX text areas.

When you are ready to send a file, simply click Send File, select the desired file to send. You will also need to select the appropriate protocol below.

When recording begins, a progress bar will display the status of the file transmission.

moserial does not implement the xmodem, ymodem, or zmodem protocols directly. It relies on the standard rz and sz utilities to send and receive data. These utilities, part of the lrzsz package, must be installed on your system.

## Ta emot filer

moserial can receive files sent in a straight binary data stream, and it can also receive files using the xmodem, ymodem, and zmodem error correction protocols. During file transmission, the received data is not logged to the Sent ASCII or Sent HEX text areas.

To receive straight binary data streams, use the Record function instead of the Receive File function.

To receive files sent with the xmodem, ymodem, or zmodem error correction protocols, using the Receive File function.

When you are ready to receive a file, simply click Receive File, select a folder to store the received file. You will also need to select the appropriate protocol below.

When recording begins, a progress bar will display the status of the file reception.

moserial does not implement the xmodem, ymodem, or zmodem protocols directly. It relies on the standard rz and sz utilities to send and receive data. These utilities, part of the lrzsz package, must be installed on your system.

## Other Preferences

moserial has several options that can be configured from the Preferences dialog.

The color of the text area foreground, background, and highlighting can be configured, as can the font type and size.

If Launch recorded files is enabled, a recorded file will be opened immediately after it is saved, using the default application for the file type. The default application is defined by the desktop environment.

If Enable timeout is enabled, recording will be automatically stopped after an adjustable period of inactivity after receiving some data. That is, moserial will wait indefinitely to record the first data byte before activating the inactivity timer.

## Using Profiles

moserial can load and save its settings from profile files, so that you can store and recall commonly used configurations. To save a profile, simply use the File Save or File Save As dialogs. To load a profile, use the File Open dialog.

Loading a profile will automatically disconnect any connected port.

When you quit moserial, the settings currently in use are stored in a default profile file. These settings will automatically be recalled the next time you launch moserial.

## Special Keys

Special Keys

Keyboard Shortcut | Description
--- | ---
Ctrl C | Copies text. This can be used in any of the text areas.
Ctrl X | Cuts text. This only works in the Outgoing single-line text box.
Ctrl V | Pastes text into the Outgoing single-line text box, and moves the focus to that text box.
Esc | Moves the focus to the Outgoing single-line text box.

moserial
serie
terminal