# Manual de moserial V3.0.0

## Introducción

moserial es una terminal serie para el escritorio GNOME, optimizada el registro y la captura de archivos. moserial está pensado principalmente para usuarios técnicos que necesitan comunicarse con sistemas empotrados, consolas y equipos electrónicos de pruebas.

A pesar de la orientación técnica de su público, moserial está diseñado para ser amigable. Se ha tenido cuidado de asegurar que las operaciones son sencillas de ejecutar, minimizando el número de pulsaciones necesarias. También se ha mantenido un número pequeño de opciones de configuración.

Para mejorar aún mas la eficiencia, moserial también soporta archivos de perfil para almacenar las configuraciones usadas más habitualmente.

## Permisos del sistema de puertos

Antes de usar moserial con un puerto serie, debe asegurarse de que actualmente tiene permisos para leer y/o escribir en el puerto.

En algunos sistemas, puede necesitar hacer algo como «sudo chmod o+rw /dev/ttyS*» y «sudo chmod o+rw /dev/ttyUSB*» para obtener permisos de lectura/escritura (para todos los usuarios) en los puertos serie. Lamentablemente, estos cambios no se guardar después de reiniciar.

Alternativamente, puede ver a qué grupo de dispositivos pertenece, y hacer que su cuenta pertenezca a este grupo. En Fedora 15, por ejemplo, debe pertenecer al grupo «dialout».

## Uso básico

### La barra de herramientas principal

A la mayoría de las funciones de moserial se accede a través de la barra de herramientas principal, como se muestra a continuación:

### Configuración del puerto

El primer paso para usar moserial es configurar los parámetros del puerto serie. Pulse Configuración del puerto para hacerlo. En el diálogo de configuración del puerto que usar, indique si el puerto se debe abrir para lectura, escritura o ambas, su velocidad en baudios, el número de bits de datos y de parada y el método de negociación. La configuración especificada en este diálogo invalidará cualquier configuración predeterminada del sistema para el puerto.

El diálogo de configuración de puertos de moserial sólo los puertos /dev/ttySnn, /dev/ttyUSBnn, y /dev/rfcommnn que existen actualmente en el sistema, para valores de «nn» entre 0 y 31.

Se puede activar el eco local desde este diálogo. Si está activado, todos los datos que moserial reciba se enviarán como eco al dispositivo emisor. Normalmente, esto debería estar desactivado, ya que puede causar un comportamiento inesperado, especialmente si el dispositivo remoto también tiene el eco activado (Esto causaría un bucle de ecos infinito.)

### Abrir la conexión

El siguiente paso para comunicarse con su dispositivo remoto es pulsar en Conectar. Esto abre el puerto. Si no tiene los permisos necesario para abrir el puerto, ocurrirá un error.

Este paso es opcional. Si lo omite, moserial intentará conectar automáticamente cuando se necesite.

Una vez que ha conectado, el botón Conectar. cambiará al botón Desconectar. Pulsar en Desconectar, cierra el puerto y reinicia los contadores TX y RX.

### Entrada y salida básica

Una vez que el puerto se ha abierto, cualquier texto recibido desde el dispositivo remoto se mostrará en el área de texto ASCII recibido. Si moserial detecta muchos caracteres no imprimibles, cambiará automáticamente a la vista HEX recibido.

Para cambiar entre las vistas HEX y ASCII, simplemente pulse en las pestañas apropiadas.

Para enviar datos al dispositivo remoto, puede escribir texto en la caja de texto de Salida de una sola línea y pulsar el botón Enviar. Su línea de texto terminará con la secuencia seleccionada en el área de la derecha del botón Enviar. Si no está seguro qué secuencia de terminación es la mejor, empiece con «CR+LF end». El botón ASCII/HEX debería establecerse a «ASCII» para enviar texto.

Si el botón ASCII/HEX está establecido a HEX, no introduzca texto en el área Salida. En su lugar, introduzca números hexadecimales de la forma «1234ABCD...».

Una vez que sus datos se han transmitido, existirá un registro en las áreas de texto ASCII enviado y HEX enviado. Estas áreas de texto no son editables.

El dispositivo remoto puede hacer eco de sus datos enviados. Si moserial detecta que se ha hecho eco del texto en el área de texto ASCII recibido, lo resaltará (usando el color de resaltado definido en el diálogo de preferencias).

La barra de estado de la parte inferior de la ventana principal muestra el estado de un puerto y un contador de los bytes enviados (TX) y recibidos (RX). Si alguno de los datos recibidos no es imprimible, también se mostrará un contador de estos elementos.

## Grabar la entrada y la salida

moserial se puede usar para grabar los datos datos enviados y recibidos a un archivo. Esta función también es útil para recibir y almacenar flujos binarios de datos volcados desde un dispositivo remoto. Por ejemplo, algunos osciloscopios volcarán capturas de pantalla a un puerto serie, sin usar ningún protocolo de corrección de errores (como el Tektronix 11801).

Cuando esté preparado para recibir un archivo, simplemente pulse Grabar, seleccione los datos que quiere grabar (Entrada y/o Salida) en la casilla de selección Flujo que grabar e introduzca el nombre del archivo en el área del selector de archivos.

Cuando empieza la grabación, el botón Grabar cambia a Detener grabación. Deberá pulsarlo cuando quiera detener la grabación, o cuando haya recibido el archivo binario completo que quiera descargar.

moserial puede, opcionalmente, abrir el archivo grabado con la aplicación predeterminada para ese tipo de archivo, cuando la grabación haya terminado. La grabación también puede terminar después un período de inactividad. Use el diálogo preferencias para activar o desactivar estas características.

Tenga en cuenta que si recibe archivos usando un protocolo de corrección de errores (xmodem, ymodem, o zmodem), deberá usar la función recibir archivo en su lugar. A diferencia de la función Grabar, la función Recibir archivo puede determinar automáticamente cuando se ha terminado la descarga del archivo.

## Enviar archivos

moserial puede transmitir archivos como un flujo de datos binarios, y también puede enviar archivos usando los protocolos de corrección de errores xmodem, ymodem, y zmodem. Durante la transferencia de archivos, los datos enviados no se registran en las áreas de texto ASCII enviado o HEX enviado

Cuando esté listo para enviar un archivo, simplemente pulse Enviar archivo y seleccione el archivo que quiere enviar. También necesitará elegir a continuación el protocolo adecuado.

Cuando se inicia la grabación, una barra de progreso mostrará el estado de la transmisión del archivo.

moserial no implementa los protocolos xmodem, ymodem o zmodem directamente. Se basa en las utilidades estándar rz y sz para enviar y recibir datos. Estas utilidades, que forman parte del paquete Irzsz se deben instalar en su sistema.

## Recibir archivos

moserial puede recibir archivos como un flujo de datos binarios, y también puede recibir archivos usando los protocolos de corrección de errores xmodem, ymodem, y zmodem. Durante la transferencia de archivos, los datos enviados no se registran en las áreas de texto ASCII enviado o HEX enviado

Para recibir flujos binarios de datos, use la función grabar en lugar de la función Recibir archivo.

Recibir archivos enviados con los protocolos de corrección de errores xmodem, ymodem, o zmodem, usando la función Recibir archivo.

Cuando esté preparado para recibir un archivo, simplemente pulse Receive File y seleccione una carpeta donde almacenar el archivo recibido. También necesitará seleccionar el protocolo adecuado a continuación.

Cuando se inicia la grabación, una barra de progreso mostrará el estado de la recepción del archivo.

moserial no implementa los protocolos xmodem, ymodem o zmodem directamente. Se basa en las utilidades estándar rz y sz para enviar y recibir datos. Estas utilidades, que forman parte del paquete Irzsz se deben instalar en su sistema.

## Otras preferencias

moserial tiene varias opciones que se pueden configurar en el diálogo Preferencias.

Se puede configurar el color del área de texto de primer plano, el resaltado, y el tamaño y tipo de tipografía.

Si la opción Lanzar los archivos guardados está activada, un archivo grabado se abrirá inmediatamente después de que se haya guardado, usando la aplicación predeterminada para el tipo de archivo. La aplicación predeterminada se define en el entorno de escritorio.

Si la opción Activar el tiempo de expiración está activada, la grabación se detendrá automáticamente después de un período configurable de inactividad recibiendo datos. Esto significa que moserial esperará indefinidamente para grabar el primer byte de datos antes de activar el temporizador de inactividad.

## Usar perfiles

moserial puede cargar y guardar su configuración en archivos de perfil, por lo que puede almacenar y volver a usar las configuraciones usadas más habitualmente. Para guardar un perfil, simplemente los diálogos Archivo Guardar o File Guardar como. Para cargar un perfil, use el diálogo Archivo Abrir.

Cargar un perfil desconectará automáticamente cualquier puerto conectado.

Cuando sale de moserial, la configuración actual se guarda en un archivo del perfil predeterminado. Esta configuración se usará automáticamente la próxima vez que ejecute moserial.

## Teclas especiales

Combinaciones de teclas | Descripción
Ctrl C | Copia texto. Esto se puede usar en cualquier área de texto.
Ctrl X | Corta texto. Esto sólo funciona en la caja de texto de Salida de una sola línea.
Ctrl V | Pega texto en la caja de texto de Salida de una sola línea, y mueve el foco a esta caja de texto.
Esc | Mueve el foco a la caja de texto de Salida de una sola línea.