# Підручник з moserial, версія 3.0.0

## Вступ

moserial — послідовний термінал для стільниці GNOME, оптимізований для ведення журналу та отримання файлів. moserial призначено передусім для користувачів-інженерів, у яких виникає потреба в обміні даними із вбудованими системами, консолями та електронним вимірювальним обладнанням.

Незважаючи на технологічне призначення програми, moserial створено зручною у користуванні. Автори подбали про простоту виконання дій, мінімізувавши кількість потрібних для їхнього виконання клацань кнопками миші. Також мінімізовано кількість параметрів налаштовування.

Для удосконалення ефективності у moserial передбачено файли профілів для зберігання налаштувань, якими найчастіше користуються.

## Права доступу до портів системи

Перш ніж користуватися moserial для послідовного порту, вам слід переконатися, що ви маєте права доступу до читання і/або запису до порту.

У деяких системах вам слід віддати подібну до «sudo chmod o+rw /dev/ttyS*» або «sudo chmod o+rw /dev/ttyUSB*» команду для отримання прав доступу на читання або запис (для усіх користувачів) до послідовних портів. На жаль, такі права доступу може бути скинути після перезавантаження системи.

Крім того, ви можете дізнатися, якій групі належать пристрої, і додати ваш обліковий запис до переліку учасників цієї групи. Наприклад, у Fedora 15, вам слід додати ваш обліковий запис до групи «dialout».

## Основні прийоми користування

### Головна панель інструментів

Доступ до більшості функціональних можливостей moserial можна отримати за допомогою панелі інструментів, яку показано нижче:

### Налаштування порту

Першим кроком у користуванні moserial є налаштовування параметрів послідовного порту. Для цього скористайтеся Налаштування порту. У діалоговому вікні налаштовування ви зможете вказати порт, яким слід скористатися, те, чи буде відкрито порт для читання, запису або в обох напрямках, вказати швидкість передавання даних, контроль парності та кількість бітів даних та стоп-бітів, а також спосіб узгодження з'єднання. Параметри, які вказано у цьому діалоговому вікні, матимуть пріоритет над будь-якими типовими параметрами системи для цього порту.

У вікні налаштовування порту moserial буде показано лише ті порти /dev/ttySnn, /dev/ttyUSBnn і /dev/rfcommnn, які насправді існують у системі для значень «nn» від 0 до 31.

За допомогою цього діалогового вікна можна увімкнути локальну луну. Якщо луну увімкнено, усі дані, які отримує moserial, буде надіслано відлунням на пристрій, з якого вони надходять. Зазвичай, таку луну вимикають, оскільки вона може спричинити хибну поведінку пристрою, особливо, якщо луну увімкнено на віддаленому пристрої. (Це спричинить нескінченну циклічну луну!)

### Відкриття з'єднання

Наступним кроком у обміні даними з вашим віддаленим пристроєм є натискання кнопки З'єднатися. Після цього порт буде відкрито. Якщо у вас немає достатніх прав доступу для відкриття порту, програма повідомить про помилку.

Цей крок не є обов'язковим. Якщо ви пропустите його, moserial спробує встановити з'єднання автоматично, коли у цьому виникне потреба.

Після встановлення з'єднання напис на кнопці З'єднатися буде замінено на Від'єднатись. Натискання кнопки Від'єднатись закриє порт і скине лічильники TX і RX.

### Основи введення і виведення даних

Після відкриття порту будь-який текст, який буде отримано з віддаленого пристрою буде показано у текстовому полі Отримано ASCII. Якщо moserial буде виявлено велику кількість непридатних до друку символів, програма автоматично перемкнеться на панель перегляду Отримано HEX.

Для перемикання між панелями перегляду HEX і ASCII просто натисніть на заголовку потрібної вам вкладки.

Щоб надіслати дані на віддалений пристрій, ви можете ввести текст до однорядкового текстового поля Вихідні і натиснути кнопку Надіслати. Ваш рядок тексту буде завершено послідовністю, яку вибрано у області, розташованій праворуч від кнопки Надіслати. Якщо ви не знаєте, яку послідовність слід вибрати, почніть з «Завершення CR+LF». Для надсилання тексту кнопку ASCII/HEX має бути встановлено у позицію ASCII.

Якщо кнопку ASCII/HEX встановлено у позицію HEX, не слід вводити до області Вихідні текст. Замість цього, слід ввести шістнадцяткові числа у форматі «1234ABCD....».

Щойно ваші дані буде передано, їхній запис буде показано на текстовій панелі Надіслано ASCII або Надіслано HEX. Редагувати текст на цих панелях не можна.

Віддалений пристрій може відлунювати надіслані вами дані. Якщо moserial буде виявлено відлунений текст у області тексту Отримано ASCII, програма підсвітить відлунений текст (з використанням кольору підсвічування, який визначено у діалоговому вікні налаштувань).

На смужці стану у нижній частині головного вікна буде показано стан порту та кількість надісланих (TX) і отриманих (RX) байтів. Якщо деякі з отриманих даних виявляться символами, які не є придатними до друку, буде також показано кількість таких символів.

## Записування вхідних і вихідних даних

moserial можна скористатися для запису надісланих та отриманих даних до файла. Ця функціональна можливість також корисна для отримання та збереження необроблених двійкових дампів даних з віддаленого пристрою. Наприклад, деякі осцилографи надсилають знімки екрана на послідовний порт без використання протоколів виправлення помилок (прикладом таких приладів є Tektronix 11801).

Коли ви будете готові до запису даних до файла, просто натисніть кнопку Записати, виберіть бажані дані для запису (вхідні і/або вихідні) у полі для вибору Потік даних для запису і введіть назву файла у полі вибору файла.

Коли розпочнеться записування, напис Записати на кнопці буде замінено на Припинити запис. Вам слід натиснути цю кнопку, якщо ви захочете припинити запис. Якщо ви не натиснете цю кнопку, ви отримаєте увесь двійковий файл.

moserial може, якщо хочете, відкрити записаний файл у типовій програмі для цього типу файлів, коли записування буде завершено. Також запис може бути перервано, якщо програма виявить період неактивності. Для вмикання або вимикання відповідних можливостей можете скористатися діалоговим вікном Параметри.

Зауважте, що якщо ви хочете отримати файли за допомогою протоколу виправлення помилок (xmodem, ymodem або zmodem), вам слід скористатися функціональною можливістю Отримати файл. На відміну від функціональної можливості Записати, функціональна можливість Отримати файл може автоматично визначати, коли отримання файла буде завершено.

## Надсилання файлів

moserial може передавати файли у форматі простого двійкового потоку даних, а також може надсилати файли за допомогою протоколів виправлення помилок xmodem, ymodem і zmodem. Під час перенесення даних файла надіслані дані не записуватимуться у текстових областях Надіслано ASCII або Надіслано HEX.

Коли ви будете готові до надсилання файла, просто натисніть кнопку Надіслати файл, виберіть бажаний файл для надсилання. Вам також слід нижче вибрати відповідний протокол.

Щойно буде розпочато запис, на смужці поступу буде показано стан передавання файла.

У moserial не реалізовано безпосередньо xmodem, ymodem і zmodem. Для надсилання і отримання даних програма покладається на стандартні програми rz і sz. Ці програми є частиною пакунка lrzsz, який має бути встановлено у вашій системі.

## Отримання файлів

moserial може отримувати надіслані файли у форматі простого двійкового потоку даних, а також може отримувати файли за допомогою протоколів виправлення помилок xmodem, ymodem і zmodem. Під час перенесення даних файла отримані дані не записуватимуться у текстових областях Надіслано ASCII або Надіслано HEX.

Щоб отримати необроблений потік двійкових даних, скористайтеся можливістю Записати замість можливості Отримати файл.

Щоб отримати файли з використанням протоколів виправлення помилок xmodem, ymodem і zmodem, скористайтеся функціональною можливістю Отримати файл.

Коли ви будете готові до отримання файла, просто натисніть кнопку Отримати файл і виберіть теку для зберігання отриманого файла. Вам також слід нижче вибрати відповідний протокол.

Щойно буде розпочато запис, на смужці поступу буде показано стан отримання файла.

У moserial не реалізовано безпосередньо xmodem, ymodem і zmodem. Для надсилання і отримання даних програма покладається на стандартні програми rz і sz. Ці програми є частиною пакунка lrzsz, який має бути встановлено у вашій системі.

## Інші налаштування

У moserial передбачено декілька параметрів, налаштувати які можна за допомогою діалогового вікна Параметри.

Можна налаштувати кольори тексту, тла та підсвічування, а також гарнітуру і розмір шрифту.

Якщо позначено пункт Запустити записані файли, записаний файл буде відкрито негайно після збереження за допомогою програми, яку пов'язано із цим типом файлів. Типова програма визначається стільничним середовищем.

Якщо позначено пункт Увімкнути час очікування, записування буде автоматично зупинено після вказаного періоду неактивності з моменту останнього отримання якихось даних. Moserial очікуватиме протягом необмеженого періоду часу на запис першого байта даних, перш ніж активувати таймер бездіяльності.

## Користування профілями

moserial може завантажувати параметри програми з файла профілю або зберігати ці параметри до файла профілю. Таким чином, ви можете зберігати і відновлювати бажані для вас налаштування. Щоб зберегти профіль, скористайтеся пунктом меню Файл Зберегти або Файл Зберегти як. Щоб завантажити профіль, скористайтеся пунктом меню Файл Відкрити.

У результаті завантаження профілю буде автоматично від'єднано усі з'єднані порти.

При виході з moserial поточні використані значення параметрів буде записано до файла типового профілю. Ці значення буде автоматично завантажено під час наступного запуску moserial.

## Спеціалізовані комбінації клавіш

Клавіатурне скорочення | Опис
Ctrl C | Копіює текст. Цим можна скористатися на будь-яких текстових панелях.
Ctrl X | Вирізає текст. Ця комбінацію працює лише у однорядковому текстовому полі Вихідні.
Ctrl V | Вставляє текст до однорядкового текстового поля Вихідні і пересуває фокус на це текстове поле.
Esc | Пересуває фокус на однорядкове текстове поле Вихідні.