ttytest(1)

TTYTEST(1) ttytest TTYTEST(1)

NAME

ttytest - асинхронный тест чтения-записи и логическая заглушка для терминальных линий

SYNOPSIS

ttytest [параметры] <tty_dev>

ОПИСАНИЕ

ttytest это маленький и простой консольный тест терминальных линий (соединений между двумя последовательными устройствами). Идея теста состоит в асинхронной записи тестовой последовательности в поседовательное устройство и в одновременном чтении этой последовательности из того-же устройства с выводом данных на терминал (TTY). Для создания обратной петли данных можно использовать стандартную аппаратную заглушку на последовательном порту или пару последовательных портов, связанных с нульмодемным кабелем, в последнем случае на одной из сторон необходимо запустить ttytest в режиме заглушки- stub (см. опцию - mode ). В случае положительного результата ttytest печатает на стандартный вывод "лестницу" тестовой последовательности вида:


test test test test test
test test test test test
test test test test test
test test test test test
test test test test test
test test test test test
test test test test test
test test test test test

ОПЦИИ

ttytest поддерживает короткий и "длинный" варианты POSIX опций.

-h --help
Показать справку по командной строке.
-V --version
Информация о версии.
-v --verbose
Больше информации (отладочный вывод).
-dСТРОКА, --data-string=СТРОКА
Пользовательский вариант тестовой СТРОКИ. Значение по умолчанию: "test test test test test"

ПРИМЕР: ttytest --data-string="В ЧАЩАХ ЮГА ЖИЛ-БЫ ЦИТРУС. ДА, НО ФАЛЬШИВЫЙ ЭКЗЕМПЛЯР!"

-e, --enum-strings
Если эта опция данных строк перечислил перед написать устройства. Последовательность имеет вид:


1 test test test test test
2 test test test test test
3 test test test test test
4 test test test test test

-u, --no-offset
этой опцией отключается автовставка периодического смещения ( "лестница") перед тестовой строкой.


test test test test test
test test test test test
test test test test test
test test test test test

-pСЕКУНД, --pause=СЕКУНД
Опция устанавливает время "засыпания" передатчика в СЕКУНДАХ (может быть использована десятичная нотация) перед началом теста (без паузы по умолчанию)
-mРЕЖИМ, --mode=РЕЖИМ
Вариант установки запустить РЕЖИМ работы ttytest. РЕЖИМ может быть установлен в следующие значения: "loopback ", "read ", "stub ", "terminal " и "write ". Значение РЕЖИМА является регистро-нечувствительным.

loopback: в этом (по умолчанию) режиме ttytest создает два асинхронных потока для приемника и передатчика. Поток передатчика ttytest непрерывно пишет тестовую СТРОКУ сконфигурированую опциями -D, , -U в последовательное устройство (<tty_dev>). Процессом передачи можно управлять с помощью -a, -w и -q опций. Одновременно поток приемника производит чтение из того-же устройства с выводом принятых данных на стандартный вывод программы.

stub: В этом режиме ttytest реализует "логическую заглушку". Программа читает данные из устройства (<tty_dev>) и записывает эти данные обратно. Так-же как и в loopback режиме, принятые данные выводятся на стандартный вывод программы.

terminal: режим простого терминала - аналогичный loopback, но вместо передатчика используется получение входных данных со стандартного ввода (клавиатуры) с передачей в последовательное устройство (<tty_dev>).

read: в этом режиме работает только приемник.

write: в этом режиме работают только передатчик.

-a, --adaptive-tx
Если установлена данная опция, то передатчик поддерживает выходную очередь в максимально пустом состоянии. Для контроля за размером очереди, передатчик использует статистику, взвращаемую
TIOCGICOUNT IOCTL. Если установлены -q или -w - данная опция не имеет эффекта.
-w, --wait-tx
Если данная опция установлена передатчик ожидает (используется tcdrain функция) полной передачи данных после каждой записи тестовой СТРОКИ
-qКОЛИЧЕСТВО, --queue-size=КОЛИЧЕСТВО
этот опция устанавливает максимальное КОЛИЧЕСТВО символов в выходой очереди передатчика. Для контроля размера очереди передатчика используется возврат TIOCOUTQ IOCTL.
-sСЕКУНД, --send-interval=СЕКУНД
опцией устанавливается интервал времени в СЕКУНДах между передачей двух тестовых СТРОК (может быть использована десятичная нотация) По умолчанию, отправляется непрерывный поток.
-x, --hex-dump
Если установлена эта опция, то прочитанные из устройства (<tty_dev>) данные печатаются на стандартном выводе в виде шестнадцатиричного дампа. Опция имеет эффект только в sttub режиме.
-BСКОРОСТЬ, --tty-baud=СКОРОСТЬ
Опцией устанавливается СКОРОСТЬ передачи данных (50, 100, 200 ...)
-WКОЛИЧЕСТВО_БИТ, --tty-databits=КОЛИЧЕСТВО_БИТ
Опция устанавливает КОЛИЧЕСТВО_БИТ данных (1 .. 8)
-SКОЛИЧЕСТВО_СТОПОВ, --tty-stopb=КОЛИЧЕСТВО_СТОПОВ
Опция устанавливает КОЛИЧЕСТВО_СТОПОВых бит в потоке (1, 1,5, 2)
-PЧЕТНОСТЬ, --tty-parity=ЧЕТНОСТЬ
Опцией устанавливается контроль ЧЕТНОСТИ. Значение ЧЕТНОСТИ может быть одним из: "no", "odd","even", "mark" и "space"
-R, --tty-crtscts
Опция предписывает использовать RTS/CTS управление потоком.
-C, --tty-codepage
Опция устанавливает кодовую страницу удаленной стороны в стиле, используемом программой iconv . Может быть указана кодировка MTK-2 .
-N, --tty-nonprint_show
Если опция установлена то ttytest отображает в выводе символы переключения регистров кода MTK-2
-U, --mtk-rprefix
Если опция установлена то символы переключения регистров кода MTK-2 префиксируются как управляющие последовательности терминала .
-X, --tty-xonxoff
Опция предписывает использовать XON/XOFF управление потоком.
-D, --tty-dsr
Опция устанавливает чувствительность приемника к DSR.

ПРИМЕРЫ

Быстрое использование:


Соединить COM1 и COM2 порты нульмодемным кабелем.
Открыть две консоли
Запустить на одной консоли команду
ttytest --mode=stub /dev/ttyS1
Запустить на второй консоли команду
ttytest --mode=loop /dev/ttyS0


Или


Установить аппаратную заглушку на порт COM1
Открыть консоль и выполнить команду
ttytest /dev/ttyS0


Наблюдать на консолях "лестницу" из тестовых СТРОК.

СМОТРИ ТАКЖЕ

stty(1) ioctl_list(2) iconv(1)

26 ноября 2008 года ttytest 1.1