# Podręcznik programu moserial 3.0.0

## Wprowadzenie

moserial to terminal szeregowy dla środowiska GNOME, zoptymalizowany do nagrywania i przechwytywania plików. moserial jest przeznaczony głównie dla doświadczonych użytkowników, którzy potrzebują komunikować się z osadzonymi komputerami, konsolami i wyposażeniem do testowania elektronicznego.

Chociaż jest przeznaczony dla doświadczonych użytkowników, moserial jest zaprojektowany pod kątem łatwości użycia. Jego autorzy postarali się, aby działania były proste do wykonania, z minimalną liczbą kliknięć. Liczba opcji konfiguracji także jest mała.

Aby zwiększyć wydajność, moserial obsługuje także pliki profilów, aby przechowywać często używane konfiguracje.

## Uprawnienia portów systemowych

Przed użyciem programu moserial z portem szeregowym należy upewnić się, że użytkownik ma uprawnienia do odczytu i zapisu do portu.

W niektórych systemach należy wykonać polecenie podobne do „sudo chmod o+rw /dev/ttyS*” i „sudo chmod o+rw /dev/ttyUSB*”, aby uzyskać uprawnienia odczytu/zapisu (dla wszystkich użytkowników) na portach szeregowych. Niestety, może się to nie zachować po ponownym uruchomieniu.

Można także sprawdzić, do której grupy należy urządzenie, i ustawić swoje konto jako członka tej grupy. Na przykład w Fedorze 15 należy dodać się do grupy „dialout”.

## Podstawy

### Główny pasek narzędziowy

Większość funkcji programu moserial jest dostępnych przez główny pasek narzędziowy, pokazany poniżej:

### Konfiguracja portu

Pierwszym krokiem podczas używania programu moserial jest skonfigurowanie parametrów portu szeregowego. Kliknij przycisk Ustawienia portu, aby to zrobić. W oknie ustawień portu należy ustawić port do użycia, czy port ma być otwarty do odczytów, zapisów lub obu, jego prędkość w baudach, parzystość, liczbę bitów danych i zatrzymania oraz metodę powitania. Ustawienie określone w tym oknie zastępują wszelkie domyślne ustawienia systemu dla portu.

Okno ustawień portu programu moserial wyświetla tylko porty /dev/ttySnn, /dev/ttyUSBnn i /dev/rfcommnn, które istnieją w systemie, dla wartości „nn” między 0 a 31.

W tym oknie można włączyć lokalne powtarzanie. Jeśli jest włączone, wszystkie dane odbierane przez moserial będą powtarzane z powrotem do urządzenia nadającego. To zwykle powinno być wyłączone, jako że może powodować nieoczekiwane zachowanie, zwłaszcza jeśli zdalne urządzenie także ma włączone powtarzanie (co spowoduje nieskończoną pętlę powtórzeń!).

### Otwieranie połączenia

Następnym krokiem podczas komunikacji ze zdalnym urządzeniem jest kliknięcie przycisku Połącz. Otworzy to port. Jeśli użytkownik nie ma wymaganych uprawnień do otwarcia portu, to zgłoszony zostanie błąd.

Ten krok jest opcjonalny. Jeśli zostanie pominięty, to moserial będzie łączył się automatycznie w razie potrzeby.

Po połączeniu przycisk Połącz zostanie zmieniony na przycisk Rozłącz. Kliknięcie przycisku Rozłącz zamyka port i przywraca liczniki wysyłania i odbierania.

### Podstawy wejścia i wyjścia

Po otwarciu portu tekst odebrany ze zdalnego urządzenia będzie wyświetlany w obszarze tekstowym Odebrane ASCII. Jeśli moserial wykrywa dużą liczbę niedrukowalnych znaków, to zostanie automatycznie przełączony na widok Odebrane HEX.

Aby przełączyć między widokiem HEX a ASCII, kliknij odpowiednią kartę.

Aby wysłać dane do zdalnego urządzenia, można wpisać tekst w jednowierszowym polu tekstowym Wychodzące i kliknąć przycisk Wyślij. Wiersz tekstu zostanie zakończony sekwencją wybraną w obszarze po prawej od przycisku Wyślij. Jeśli nie ma pewności, która sekwencja zakończenia jest najlepsza, to można zacząć od „CR+LF kończy”. Przycisk ASCII/HEX musi być ustawiony na ASCII, aby wysłać tekst.

Jeśli przycisk ASCII/HEX jest ustawiony na HEX, to nie wpisuj tekstu w obszarze Wychodzące. Zamiast tego wpisz liczby szesnastkowe w formie „1234ABCD…”.

Po przesłaniu danych ich zapis będzie znajdował się w obszarach tekstowych Wysłane ASCII i Wysłane HEX. Nie można ich modyfikować.

Zdalne urządzenie może powtarzać wysłane dane. Jeśli moserial wykryje powtórzony tekst w obszarze tekstowym Odebrane ASCII, to wyróżni powtórzony tekst (za pomocą koloru wyróżnienia określonego w oknie preferencji).

Pasek stanu na dole głównego okna wyświetla stan portu oraz liczbę wysłanych i odebranych bajtów. Jeśli część odebranych danych jest niedrukowalnych, to wyświetlona będzie także ich liczba.

## Nagrywanie wejścia i wyjścia

Programu moserial można używać do nagrywania wysłanych i odebranych danych do pliku. Ta funkcja jest przydatna także do odbierania i przechowywania bezpośrednich danych binarnych zrzuconych ze zdalnego urządzenia. Na przykład, niektóre oscyloskopy zrzucają zrzuty ekranu do portu szeregowego bez użycia żadnych protokołów korekcji błędów (np. Tektronix 11801).

W chwili gotowości na nagranie pliku kliknij przycisk Nagraj, wybierz dane do nagrania (przychodzące lub wychodzące) w polu wyboru Potok do nagrania i wpisz nazwę pliku w obszarze wyboru pliku.

Po rozpoczęciu nagrywania przycisk Nagraj zmieni się na przycisk Zatrzymaj nagrywanie. Należy go kliknąć, aby zatrzymać nagrywanie lub kiedy odebrano cały plik binarny.

moserial może opcjonalnie uruchomić nagrany plik za pomocą domyślnego programu dla jego typu po ukończeniu nagrywania. Może także zakończyć nagrywanie po okresie nieaktywności. Użyj okna Preferencje, aby włączyć lub wyłączyć te funkcje.

Zauważ, że aby odbierać pliki za pomocą protokołu korekcji błędów (xmodem, ymodem lub zmodem), to należy użyć funkcji Odbierz plik zamiast tego. W przeciwieństwie do funkcji Nagraj, funkcja Odbierz plik może automatycznie wykryć, kiedy pobieranie pliku zostało ukończone.

## Wysyłanie plików

moserial może przesyłać pliki w bezpośrednim potoku danych binarnych, a także wysyłać pliki za pomocą protokołów korekcji błędów xmodem, ymodem i zmodem. Podczas przesyłania plików wysyłane dane nie są zapisywane w obszarach tekstowych Wysłane ASCII lub Wysłane HEX.

W chwili gotowości na wysłanie pliku kliknij przycisk Wyślij plik i wybierz plik do wysłania. Należy także wybrać odpowiedni protokół poniżej.

Po rozpoczęciu nagrywania pasek postępu będzie wyświetlał stan przesyłania pliku.

moserial nie implementuje protokołów xmodem, ymodem i zmodem bezpośrednio. Używa standardowych narzędzi rz i sz do wysyłania i odbierania danych. Te narzędzia, będące częścią pakietu lrzsz, muszą być zainstalowane na komputerze.

## Odbieranie plików

moserial może odbierać pliki w bezpośrednim potoku danych binarnych, a także odbierać pliki za pomocą protokołów korekcji błędów xmodem, ymodem i zmodem. Podczas przesyłania plików wysyłane dane nie są zapisywane w obszarach tekstowych Wysłane ASCII lub Wysłane HEX.

Aby odebrać bezpośrednie potoki danych binarnych, użyj funkcji Nagraj zamiast funkcji Odbierz plik.

Aby odebrać pliki wysłane za pomocą protokołów korekcji błędów xmodem, ymodem lub zmodem, użyj funkcji Odbierz plik.

W chwili gotowości na odebranie pliku kliknij przycisk Odbierz plik i wybierz katalog do przechowania odebranego pliku. Należy także wybrać odpowiedni protokół poniżej.

Po rozpoczęciu nagrywania pasek postępu będzie wyświetlał stan odbioru pliku.

moserial nie implementuje protokołów xmodem, ymodem i zmodem bezpośrednio. Używa standardowych narzędzi rz i sz do wysyłania i odbierania danych. Te narzędzia, będące częścią pakietu lrzsz, muszą być zainstalowane na komputerze.

## Inne preferencje

moserial ma kilka opcji, które można skonfigurować w oknie Preferencje.

Można skonfigurować kolor czcionki, tła i wyróżniania obszarów tekstowych, a także typ i rozmiar czcionki.

Jeśli opcja Uruchamianie nagranych plików jest włączona, to nagrany plik zostanie otwarty od razu po jego zapisaniu za pomocą domyślnego programu dla jego typu. Domyślny program jest określany przez środowisko.

Jeśli opcja Włączenie czasu oczekiwania jest włączona, to nagrywanie będzie automatycznie zatrzymywane po podanym okresie nieaktywności po odebraniu danych. Tzn. moserial będzie czekał bez ograniczenia czasowego na nagranie pierwszego bajtu danych przed aktywacją licznika nieaktywności.

## Używanie profili

moserial może wczytywać i zapisywać swoje ustawienia z plików profili, aby można było przechowywać i wywoływać często używane konfiguracje. Aby zapisać profil, użyj okien Plik Zapisz lub Plik Zapisz jako. Aby wczytać profil, użyj okna Plik Otwórz.

Wczytanie profilu automatycznie rozłączy wszystkie połączone porty.

Po zakończeniu programu moserial obecnie używane ustawienia są przechowywane w domyślnym pliku profilu. Te ustawienia są automatycznie wywoływane po następnym uruchomieniu programu moserial.

## Klawisze specjalne

Skrót klawiszowy | Opis
Ctrl C | Kopiuje tekst. Można tego używać we wszystkich obszarach tekstowych.
Ctrl X | Wycina tekst. Działa tylko w jednowierszowym polu tekstowym Wychodzące.
Ctrl V | Wkleja tekst do jednowierszowego pola tekstowego Wychodzące i przenosi aktywność do niego.
Esc | Przenosi aktywność do jednowierszowego pola tekstowego Wychodzące.