brltty - справочное руководство, опции, примеры команд

ИМЯ

brltty - обновляемый драйвер дисплея Брайля для Linux/Unix

СИНТАКСИС

brltty [option ...]

ОПИСАНИЕ

brltty — это фоновый процесс (демон), который обеспечивает доступ к экрану консоли (в текстовом режиме) для слепых, использующих обновляемый дисплей Брайля. Он управляет дисплеем Брайля и обеспечивает полную функциональность просмотра экрана. Также были включены некоторые речевые возможности.

ПАРАМЕТРЫ

Параметры можно передать в brltty несколькими способами. От наиболее влиятельных к наименее влиятельным, это:

Параметры командной строки
Параметры загрузки
Переменные среды (если действует параметр -E (--environment-variables))
Файл конфигурации
Встроенные значения по умолчанию

Параметры командной строки

Опции обрабатываются последовательно слева направо. Если опция указана более одного раза или в случае конфликта, самая правая спецификация имеет приоритет.

Поддерживаются следующие параметры:

-a table (--attributes-table=)

Путь к таблице атрибутов. Относительные пути привязаны к /usr/share/brltty/Attributes. Расширение .atb указывать необязательно. Встроенное значение по умолчанию: left_right.atb.

-b driver,...|auto (--braille-driver=)

Драйвер для дисплея Брайля (см. Спецификацию драйвера). Встроенное значение по умолчанию — auto.

-c table (--contraction-table=)

Путь к таблице сокращений. Относительные пути привязаны к /usr/share/brltty/Contraction. Расширение .ctb не является обязательным.

-d device,... (--braille-device=)

Устройство, к которому подключен дисплей Брайля. Встроенное значение по умолчанию: usb:,bluetooth:.

Общая форма спецификации устройства Брайля: квалификатор:данные. Для обратной совместимости с более ранними выпусками, если квалификатор опущен, предполагается serial:. Поддерживаются следующие типы устройств:

Bluetooth: Для устройства Bluetooth укажите bluetooth:адрес. Адрес должен состоять из шести двузначных шестнадцатеричных чисел, разделенных двоеточием, например 01:23:45:67:89:АВ.
Serial: Для последовательного устройства укажите serial:device. Квалификатор serial: является необязательным (для обратной совместимости). Если задан относительный путь, то он привязан к /dev/ (обычное место, где определяются устройства в Unix-подобной системе). Все следующие спецификации устройства относятся к основному последовательному устройству в Linux: serial:ttyS0, serial:/dev/ttyS0, ttyS0, serial:/dev/ttyS0 >/dev/ttyS0.
USB: Для USB-устройства укажите usb:. brltty выполнит поиск первого USB-устройства, соответствующего используемому драйверу дисплея Брайля. Если этого недостаточно, т.е. если у вас более одного USB-дисплея Брайля, для которого требуется один и тот же драйвер, вы можете уточнить спецификацию устройства, добавив к нему серийный номер дисплея, например usb:12345. N.B.: Функция «идентификация по серийному номеру» не работает для некоторых моделей, потому что некоторые производители либо вообще не устанавливают дескриптор серийного номера USB, либо задают для него не уникальное значение.

Можно указать список устройств Брайля, разделенных запятыми. Если это сделано, то автоопределение выполняется последовательно на каждом из перечисленных устройств. Эта функция особенно полезна, если у вас есть дисплей Брайля с более чем одним интерфейсом, например. как последовательный, так и USB-порт.

-e (--standard-error)

Записывайте журналы в стандартную ошибку, а не в системный журнал (полезно для отладки).

-f file (--configuration-file=)

Путь к файлу конфигурации. Относительные пути привязаны к текущему рабочему каталогу. По умолчанию используется /etc/brltty.conf.

-h (--help)

Распечатайте сводку по использованию командной строки (только часто используемые параметры), а затем выйдите.

-i name (--speech-input=)

Объект файловой системы (FIFO, именованный канал, именованный сокет и т. д.), который предоставляет другим приложениям доступ к речевому драйверу brltty для преобразования текста в речь. Он создается при запуске и удаляется при завершении. Относительные пути привязаны к текущему рабочему каталогу. По умолчанию объект файловой системы не создается.

-k table (--keyboard-table=)

Путь к таблице клавиатуры. Относительные пути привязаны к /usr/share/brltty/Keyboard. Расширение .ktb указывать необязательно.

-l level (--log-level=)

Минимальный уровень серьезности сообщений, записываемых в журнал. Можно указать любой из следующих номеров или любую аббревиатуру их соответствующих имён:

0: экстренная ситуация
1: оповещение
2: критично
3: ошибка
4: предупреждение
5: уведомление
6: информация
7: отладка

По умолчанию используется уведомление.

-m device (--midi-device=)

Устройство, используемое для цифрового интерфейса музыкальных инструментов. Для ALSA это клиент:порт, где каждый может быть либо числом, либо подстрокой его имени с учетом регистра. Для других интерфейсов это полный путь к соответствующему системному устройству. Встроенное значение по умолчанию:

Linux/ALSA: первый доступный порт вывода MIDI
Linux/OSS: /dev/sequencer

-n (--no-daemon)

Оставайтесь на переднем плане (полезно для отладки).

-o name=value,... (--override-preference=)

Переопределить настройку предпочтения. Расположение файла настроек см. в описании параметра -F (--preferences-file).

-p device (--pcm-device=)

Устройство для цифрового звука. Для ALSA это имя[:аргумент,...]. Для других интерфейсов это полный путь к соответствующему системному устройству. Встроенное значение по умолчанию:

FreeBSD: /dev/dsp
Linux/ALSA: чс:0,0
Linux/OSS: /dev/dsp
NetBSD: /dev/аудио
OpenBSD: /dev/аудио
Qnx: предпочтительное устройство вывода PCM
Solaris: /dev/аудио

-q (--quiet)

Подавить начальные сообщения. Это делается путем снижения уровня журнала по умолчанию (см. параметр -l (--log-level=)) до предупреждение ( >информация, если либо -v (--verify), либо -V (--version ) также указывается).

-r (--release-device)

Отпустите устройство, к которому подключен дисплей Брайля, когда текущий экран или окно не могут быть прочитаны.

-s driver,...|auto (--speech-driver=)

Драйвер синтезатора речи (см. Спецификацию драйвера). Встроенное значение по умолчанию — auto.

-t table (--text-table=)

Путь к текстовой таблице. Относительные пути привязаны к /usr/share/brltty/Text. Расширение .ttb не является обязательным. Встроенное значение по умолчанию: en-nabcc.ttb (Североамериканский компьютерный код Брайля).

-v (--verify)

Распечатайте начальные сообщения и затем выйдите. Сюда всегда входят версии самого brltty, серверной части его интерфейса прикладного программирования и каждого из выбранных драйверов Брайля и речи. Если параметр -q (--quiet) также не указан, он также включает значения параметров после рассмотрения всех источников. Если указано более одного драйвера Брайля и/или более одного устройства Брайля, выполняется автоматическое определение дисплея Брайля. Если указано более одного речевого драйвера, выполняется автоопределение речевого синтезатора.

-x driver (--screen-driver=)

Драйвер экрана. Встроенное значение по умолчанию соответствует операционной системе.

-A name=value,... (--api-parameters=)

Параметры интерфейса прикладного программирования. Если один и тот же параметр указан более одного раза, используется самая правая спецификация. Названия параметров могут быть сокращены.

-B [driver:]name=value,... (--braille-parameters=)

Параметры драйвера дисплея Брайля. Если один и тот же параметр указан более одного раза, используется самая правая спецификация. Названия параметров могут быть сокращены. Если назначение параметра квалифицировано с помощью идентификационного кода драйвера, то оно обрабатывается только в том случае, если используется этот драйвер дисплея Брайля.

-D directory (--drivers-directory=)

Путь к каталогу, содержащему динамически загружаемые объекты драйвера. По умолчанию используется /usr/lib/brltty.

-E (--environment-variables)

Распознавать переменные среды.

-F file (--preferences-file=)

Путь к файлу настроек. Относительные пути привязаны к /var/lib/brltty. Встроенное значение по умолчанию: brltty.prefs.

-H (--full-help)

Распечатайте сводку по использованию командной строки (все параметры) и выйдите.

-I (--install-service)

(Только для Windows) Установите brltty в качестве службы BrlAPI, чтобы она автоматически запускалась при загрузке системы и чтобы приложения знали, что BrlAPI< сервер работает.

-K arg (--keyboard-properties=)

Свойства клавиатуры.

-L file (--log-file=)

Файл, в который записываются сообщения журнала. Относительные пути привязаны к текущему рабочему каталогу. По умолчанию сообщения журнала отправляются в системный журнал.

-M csecs (--message-delay=)

Время удержания сообщения в сотых долях секунды. Встроенное значение по умолчанию: 400 (4 секунды).

-N (--no-api)

Не запускайте интерфейс прикладного программирования.

-P file (--pid-file=)

Полный путь к файлу идентификатора процесса. Если указан этот параметр, brltty записывает свой идентификатор процесса (pid) в указанный файл при запуске. Файл удаляется, когда brltty завершает работу.

-R (--remove-service)

(Только для Windows) Удалите службу BrlAPI, чтобы brltty не запускался автоматически при загрузке системы и чтобы приложения знали, что BrlAPI не работает. сервер работает.

-S [driver:]name=value,... (--speech-parameters=)

Параметры драйвера синтезатора речи. Если один и тот же параметр указан более одного раза, используется самая правая спецификация. Названия параметров могут быть сокращены. Если назначение параметра уточняется идентификационным кодом драйвера, то оно обрабатывается только в том случае, если используется этот драйвер синтезатора речи.

-T directory (--tables-directory=)

Путь к каталогу, содержащему текст, сокращение, атрибуты, клавиатуру и таблицы ввода. Встроенное значение по умолчанию — /usr/share/brltty.

-U directory (--updatable-directory=)

Путь к каталогу, содержащему файлы, которые можно обновить. Встроенное значение по умолчанию: /var/lib/brltty.

-V (--version)

Распечатайте версии самого brltty, серверной части его интерфейса прикладного программирования и тех драйверов, которые были настроены во время сборки, а затем выйдите. Если параметр -q (--quiet) также не указан, также печатается информация об авторских правах.

-W directory (--writable-directory=)

Путь к каталогу, в который можно выполнить запись. По умолчанию используется /run/brltty.

-X name=value,... (--screen-parameters=)

Параметры драйвера экрана. Если один и тот же параметр указан более одного раза, используется самая правая спецификация. Названия параметров могут быть сокращены.

-Y text (--start-message=)

Текст, который будет отображаться при запуске драйвера Брайля и произноситься при запуске речевого драйвера. Встроенная версия по умолчанию — BRLTTY 6.5.

-Z text (--stop-message=)

Текст, отображаемый при остановке драйвера Брайля. Встроенное значение по умолчанию: BRLTTY остановлен.

Переменные среды

Следующие переменные среды распознаются, если указан параметр -E (--environment-variables):

BRLTTY_API_PARAMETERS=name=value,...: Параметры интерфейса прикладного программирования. Подробнее см. параметр -A (--api-parameters=).
BRLTTY_ATTRIBUTES_TABLE=table: Таблица атрибутов. Подробнее см. параметр -a (--attributes-table=).
BRLTTY_BRAILLE_DEVICE=device,...: Устройство, к которому подключен дисплей Брайля. Подробнее см. параметр -d (--braille-device=).
BRLTTY_BRAILLE_DRIVER=driver,...|auto: Драйвер для брайлевского дисплея. Подробнее см. параметр -b (--braille-driver=).
BRLTTY_BRAILLE_PARAMETERS=[driver:]name=value,...: Параметры драйвера дисплея Брайля. Подробнее см. параметр -B (--braille-parameters=).
BRLTTY_CONFIGURATION_FILE=file: Файл конфигурации. Подробнее см. параметр -f (--configuration-file=).
BRLTTY_CONTRACTION_TABLE=table: Таблица сокращений. Подробнее см. параметр -c (--contraction-table=).
BRLTTY_MIDI_DEVICE=device: Устройство, используемое для цифрового интерфейса музыкальных инструментов. Подробнее см. параметр -m (--midi-device=).
BRLTTY_PCM_DEVICE=device: Устройство для цифрового звука. Подробнее см. параметр -p (--pcm-device=).
BRLTTY_PREFERENCES_FILE=file: Файл настроек. Подробнее см. параметр -F (--preferences-file=).
BRLTTY_RELEASE_DEVICE=on|off: Отпустите устройство, к которому подключен дисплей Брайля, когда текущий экран или окно не могут быть прочитаны. Подробнее см. параметр -r (--release-device).
BRLTTY_SCREEN_DRIVER=driver: Драйвер экрана. Подробнее см. параметр -x (--screen-driver=).
BRLTTY_SCREEN_PARAMETERS=name=value,...: Параметры драйвера экрана. Подробнее см. параметр -X (--screen-parameters=).
BRLTTY_SPEECH_DRIVER=driver,...|auto: Драйвер для синтезатора речи. Дополнительные сведения см. в описании параметра -s (--speech-driver=).
BRLTTY_SPEECH_INPUT=name: Объект файловой системы, предоставляющий другим приложениям доступ к речевому драйверу brltty для преобразования текста в речь. Подробнее см. параметр -i (--speech-input=).
BRLTTY_SPEECH_PARAMETERS=[driver:]name=value,...: Параметры драйвера синтезатора речи. Подробнее см. параметр -S (--speech-parameters=).
BRLTTY_TEXT_TABLE=table: Текстовая таблица. Подробнее см. параметр -t (--text-table=).

Файл конфигурации

Пустые строки игнорируются. Если символ # встречается в какой-либо строке, все символы от него до конца этой строки рассматриваются как комментарий.

Поддерживаются следующие директивы конфигурации:

api-parameters name=value,...: Параметры интерфейса прикладного программирования. Подробнее см. параметр -A (--api-parameters=).
attributes-table table: Таблица атрибутов. Подробнее см. параметр -a (--attributes-table=).
braille-device device,...: Устройство, к которому подключен дисплей Брайля. Подробнее см. параметр -d (--braille-device=).
braille-driver driver,...|auto: Драйвер для брайлевского дисплея. Подробнее см. параметр -b (--braille-driver=).
braille-parameters [driver:]name=value,...: Параметры драйвера дисплея Брайля. Подробнее см. параметр -B (--braille-parameters=).
contraction-table table: Таблица сокращений. Подробнее см. параметр -c (--contraction-table=).
midi-device device: Устройство, используемое для цифрового интерфейса музыкальных инструментов. Подробнее см. параметр -m (--midi-device=).
pcm-device device: Устройство для цифрового звука. Подробнее см. параметр -p (--pcm-device=).
preferences-file file: Файл настроек. Подробнее см. параметр -F (--preferences-file=).
release-device on|off: Отпустите устройство, к которому подключен дисплей Брайля, когда текущий экран или окно не могут быть прочитаны. Подробнее см. параметр -r (--release-device).
screen-driver driver: Драйвер экрана. Подробнее см. параметр -x (--screen-driver=).
screen-parameters name=value,...: Параметры драйвера экрана. Подробнее см. параметр -X (--screen-parameters=).
speech-driver driver,...|auto: Драйвер для синтезатора речи. Дополнительные сведения см. в описании параметра -s (--speech-driver=).
speech-input me: Объект файловой системы, предоставляющий другим приложениям доступ к речевому драйверу brltty для преобразования текста в речь. Подробнее см. параметр -i (--speech-input=).
speech-parameters [driver:]name=value,...: Параметры драйвера синтезатора речи. Подробнее см. параметр -S (--speech-parameters=).
text-table table: Текстовая таблица. Подробнее см. параметр -t (--text-table=).

Спецификация драйвера

Драйвер дисплея Брайля или синтезатора речи должен быть указан через его идентификационный код:

al
Альва
an
Андроид
at
Альбатрос
ba
БрлАФИ
bc
БрайлКомм
bd
Брауди
bl
БрайльLite
bm
Баум
bn
БрайляПримечание
cb
Комбинированный шрифт Брайля
ce
Себра
cn
Канут
ec
ЭкоБрайль
en
eSpeak-NG
es
eSpeak
eu
Евробрайль
fa
ФрэнкАудиодата
fl
FestivalLite
fs
FreedomНаучная
fv
фестиваль
gs
GenericSay
hd
Он делает
hm
ЕГО
ht
ХэндиТек
hw
HumanWare
ir
Ирис
ic
Инцептор
lb
Либбрайль
lt
Логтекст
mb
Мультибрайль
md
МДВ
mm
Памятка Брайля
mn
Мини-Брайль
mp
Микропухе
mt
Метек
no
нет водителя
np
Девять точек
pg
Пегас
pm
Папенмайер
sd
ВыступлениеДиспетчер
sk
Сейка
sw
Быстрый
th
Тета
tn
TechniBraille Systems Inc.
ts
Телесенсорные Системы Инк.
vd
Видео со шрифтом Брайля
vo
Voyager, Part232 (последовательный адаптер), ручка BraillePen/EasyLink
vs
VisioBraille
vv
ViaVoice
xs
Внешняя речь

Можно указать список драйверов через запятую. Если это сделано, то автоопределение выполняется последовательно с использованием каждого из перечисленных драйверов. Возможно, вам придется поэкспериментировать, чтобы определить наиболее надежный порядок, поскольку некоторые драйверы автоматически определяют лучше, чем другие.
Если указано одно слово auto, то автоопределение выполняется с использованием только тех драйверов, которые заведомо надежны для этой цели.

СМОТРИТЕ ТАКЖЕ

For full documentation, see brltty's on-line manual at [http://brltty.app/documentation.html].