brltty - driver de exibição braille atualizável para Linux/Unix
brltty [option ...]
brltty é um processo em segundo plano (daemon) que fornece acesso à tela do console (quando em modo de texto) para uma pessoa cega usando uma linha braille atualizável. Ele aciona a exibição em braille e fornece funcionalidade completa de revisão de tela. Alguns recursos de fala também foram incorporados.
As opções podem ser passadas para brltty de várias maneiras. Do mais ao menos influente, estes são:
Opções de linha de comando
Parâmetros de Inicialização
Variáveis de ambiente (se a opção -E (--environment-variables) estiver em vigor)
O arquivo de configuração
Padrões integrados
As opções são processadas sequencialmente da esquerda para a direita. Se uma opção for especificada mais de uma vez ou em caso de conflito, a especificação mais à direita terá precedência.
As seguintes opções são suportadas:
O caminho para a tabela de atributos. Caminhos relativos são ancorados em /usr/share/brltty/Attributes. A extensão .atb é opcional. O padrão integrado é left_right.atb.
O driver para a linha braille (consulte Especificação do driver). O padrão integrado é automático.
O caminho para a mesa de contração. Caminhos relativos são ancorados em /usr/share/brltty/Contraction. A extensão .ctb é opcional.
O dispositivo ao qual o display braille está conectado. O padrão integrado é usb:,bluetooth:.
A forma geral de especificação de um dispositivo braille é qualificador:dados. Para compatibilidade com versões anteriores, se o qualificador for omitido, será assumido serial:. Os seguintes tipos de dispositivos são suportados:
Para um dispositivo bluetooth, especifique bluetooth:endereço. O endereço deve ter seis números hexadecimais de dois dígitos separados por dois pontos, por exemplo 01:23:45:67:89:AB.
Para um dispositivo serial, especifique serial:dispositivo. O qualificador serial: é opcional (para compatibilidade com versões anteriores). Se um caminho relativo for fornecido, ele será ancorado em /dev/ (o local usual onde os dispositivos são definidos em um sistema semelhante ao Unix). Todas as especificações de dispositivo a seguir referem-se ao dispositivo serial primário no Linux: serial:ttyS0, serial:/dev/ttyS0, ttyS0, /dev/ttyS0.
Para um dispositivo USB, especifique usb:. brltty procurará o primeiro dispositivo USB que corresponda ao driver de linha braille que está sendo usado. Se isso for inadequado, por ex. se você tiver mais de um monitor braille USB que exija o mesmo driver, poderá refinar a especificação do dispositivo anexando o número de série do monitor a ele, por exemplo, usb:12345. N.B.: O recurso "identificação por número de série" não funciona para alguns modelos porque alguns fabricantes não definem o descritor de número de série USB ou o definem, mas não para um valor único.
Uma lista delimitada por vírgulas de dispositivos braille pode ser especificada. Se isso for feito, a detecção automática será executada em cada dispositivo listado em sequência. Esse recurso é particularmente útil se você tiver uma tela em braille com mais de uma interface, por exemplo, uma porta serial e uma porta USB.
Grave logs no erro padrão em vez de no log do sistema (útil para depuração).
O caminho para o arquivo de configuração. Os caminhos relativos são ancorados no diretório de trabalho atual. O padrão integrado é /etc/brltty.conf.
Imprima um resumo de uso da linha de comando (somente opções comumente usadas) e saia.
O objeto do sistema de arquivos (FIFO, pipe nomeado, socket nomeado, etc) que fornece a outros aplicativos acesso ao driver de fala do brltty para conversão de texto em fala. Ele é criado na inicialização e removido na finalização. Os caminhos relativos são ancorados no diretório de trabalho atual. O padrão integrado é que o objeto do sistema de arquivos não seja criado.
O caminho para a tabela do teclado. Caminhos relativos são ancorados em /usr/share/brltty/Keyboard. A extensão .ktb é opcional.
O nível mínimo de gravidade para mensagens gravadas no log. Qualquer um dos seguintes números, ou qualquer abreviação de seus nomes correspondentes, pode ser especificado:
emergência
alerta
crítico
erro
aviso
aviso
informações
depurar
O padrão integrado é aviso.
O dispositivo a ser usado para a interface digital de instrumento musical. Para ALSA, é client:porta, onde cada um pode ser um número ou uma substring de seu nome que diferencia maiúsculas de minúsculas. Para outras interfaces, é o caminho completo para um dispositivo de sistema apropriado. O padrão integrado é:
a primeira porta de saída MIDI disponível
/dev/sequencer
Permaneça em primeiro plano (útil para depuração).
Substituir uma configuração de preferência. Para a localização do arquivo de preferências, consulte a opção -F (--preferences-file).
O dispositivo a ser usado para áudio digital. Para ALSA é nome[:argumento,...]. Para outras interfaces, é o caminho completo para um dispositivo de sistema apropriado. O padrão integrado é:
/dev/dsp
hw:0,0
/dev/dsp
/dev/audio
/dev/audio
o dispositivo de saída PCM preferido
/dev/audio
Suprima as mensagens de inicialização. Isso é feito reduzindo o nível de log padrão (consulte a opção -l (--log-level=)) para aviso (informações se for -v (--verify) ou -V (--version ) também é especificado).
Solte o dispositivo ao qual a linha braille está conectada quando a tela ou janela atual não puder ser lida.
O driver para o sintetizador de voz (consulte Especificação do driver). O padrão integrado é automático.
O caminho para a tabela de texto. Caminhos relativos são ancorados em /usr/share/brltty/Text. A extensão .ttb é opcional. O padrão integrado é en-nabcc.ttb (o código de computador em braile norte-americano).
Imprima as mensagens de inicialização e saia. Isso sempre inclui as versões do próprio brltty, o lado do servidor de sua interface de programação de aplicativo e cada um dos drivers de fala e braille selecionados. Se a opção -q (--quiet) também não for especificada, ela também incluirá os valores das opções após todas as fontes terem sido consideradas. Se mais de um driver braille e/ou mais de um dispositivo braille for especificado, a detecção automática do display braille será executada. Se mais de um driver de fala for especificado, a detecção automática do sintetizador de fala será executada.
O driver de tela. O padrão integrado é o sistema operacional apropriado.
Parâmetros para a interface de programação do aplicativo. Se o mesmo parâmetro for especificado mais de uma vez, a especificação mais à direita será usada. Os nomes dos parâmetros podem ser abreviados.
Parâmetros para o driver do display braille. Se o mesmo parâmetro for especificado mais de uma vez, a especificação mais à direita será usada. Os nomes dos parâmetros podem ser abreviados. Se uma atribuição de parâmetro for qualificada com um código de identificação do driver, ela só será processada se o driver do display braille estiver sendo usado.
O caminho para o diretório que contém os objetos de driver carregáveis dinamicamente. O padrão integrado é /usr/lib/brltty.
Reconhecer variáveis de ambiente.
O caminho para o arquivo de preferências. Caminhos relativos são ancorados em /var/lib/brltty. O padrão integrado é brltty.prefs.
Imprima um resumo de uso da linha de comando (todas as opções) e saia.
(Somente Windows) Instale brltty como o serviço BrlAPI para que seja iniciado automaticamente quando o sistema for inicializado e para que os aplicativos saibam que uma BrlAPI< servidor está em execução.
Propriedades do teclado.
O arquivo no qual as mensagens de log são gravadas. Os caminhos relativos são ancorados no diretório de trabalho atual. O padrão é enviar mensagens de log para o log do sistema.
O tempo de espera da mensagem em centésimos de segundo. O padrão integrado é 400 (4 segundos).
Não inicie a interface de programação do aplicativo.
O caminho completo para o arquivo de identificador de processo. Se esta opção for fornecida, brltty grava seu identificador de processo (pid) no arquivo especificado na inicialização. O arquivo é removido quando brltty termina.
(Somente Windows) Remova o serviço BrlAPI para que o brltty não seja iniciado automaticamente quando o sistema for inicializado e para que os aplicativos possam saber que nenhum BrlAPI o servidor está em execução.
Parâmetros para o driver do sintetizador de voz. Se o mesmo parâmetro for especificado mais de uma vez, a especificação mais à direita será usada. Os nomes dos parâmetros podem ser abreviados. Se uma atribuição de parâmetro for qualificada com um código de identificação do driver, ela só será processada se esse driver de sintetizador de voz estiver sendo usado.
O caminho para o diretório que contém o texto, a contração, os atributos, o teclado e as tabelas de entrada. O padrão integrado é /usr/share/brltty.
O caminho para um diretório que contém arquivos que podem ser atualizados. O padrão integrado é /var/lib/brltty.
Imprima as versões do próprio brltty, o lado do servidor de sua interface de programação de aplicativo e os drivers que foram configurados no momento da compilação e, em seguida, saia. Se a opção -q (--quiet) também não for especificada, imprima também as informações de direitos autorais.
O caminho para um diretório no qual pode ser gravado. O padrão integrado é /run/brltty.
Parâmetros para o driver de tela. Se o mesmo parâmetro for especificado mais de uma vez, a especificação mais à direita será usada. Os nomes dos parâmetros podem ser abreviados.
O texto a ser mostrado quando o driver braille é iniciado e a ser falado quando o driver de fala é iniciado. O padrão integrado é BRLTTY 6.5.
O texto a ser mostrado quando o driver braille para. O padrão integrado é BRLTTY interrompido.
As seguintes variáveis de ambiente são reconhecidas se a opção -E (--environment-variables) for especificada:
Parâmetros para a interface de programação do aplicativo. Consulte a opção -A (--api-parameters=) para obter detalhes.
A tabela de atributos. Consulte a opção -a (--attributes-table=) para obter detalhes.
O dispositivo ao qual o display braille está conectado. Consulte a opção -d (--braille-device=) para obter detalhes.
O driver para a exibição em braille. Consulte a opção -b (--braille-driver=) para obter detalhes.
Parâmetros para o driver do display braille. Consulte a opção -B (--braille-parameters=) para obter detalhes.
O arquivo de configuração. Consulte a opção -f (--configuration-file=) para obter detalhes.
A mesa de contração. Consulte a opção -c (--contraction-table=) para obter detalhes.
O dispositivo a ser usado para a interface digital de instrumento musical. Consulte a opção -m (--midi-device=) para obter detalhes.
O dispositivo a ser usado para áudio digital. Consulte a opção -p (--pcm-device=) para obter detalhes.
O arquivo de preferências. Consulte a opção -F (--preferences-file=) para obter detalhes.
Solte o dispositivo ao qual a linha braille está conectada quando a tela ou janela atual não puder ser lida. Consulte a opção -r (--release-device) para obter detalhes.
O driver de tela. Consulte a opção -x (--screen-driver=) para obter detalhes.
Parâmetros para o driver de tela. Consulte a opção -X (--screen-parameters=) para obter detalhes.
O driver para o sintetizador de voz. Consulte a opção -s (--speech-driver=) para obter detalhes.
O objeto do sistema de arquivos que fornece a outros aplicativos acesso ao driver de fala do brltty para conversão de texto em fala. Consulte a opção -i (--speech-input=) para obter detalhes.
Parâmetros para o driver do sintetizador de voz. Consulte a opção -S (--speech-parameters=) para obter detalhes.
A tabela de texto. Consulte a opção -t (--text-table=) para obter detalhes.
Linhas em branco são ignoradas. Se o caractere # ocorrer em qualquer linha, todos os caracteres dele até o final dessa linha serão tratados como um comentário.
As seguintes diretivas de configuração são suportadas:
Parâmetros para a interface de programação do aplicativo. Consulte a opção -A (--api-parameters=) para obter detalhes.
A tabela de atributos. Consulte a opção -a (--attributes-table=) para obter detalhes.
O dispositivo ao qual o display braille está conectado. Consulte a opção -d (--braille-device=) para obter detalhes.
O driver para a exibição em braille. Consulte a opção -b (--braille-driver=) para obter detalhes.
Parâmetros para o driver do display braille. Consulte a opção -B (--braille-parameters=) para obter detalhes.
A mesa de contração. Consulte a opção -c (--contraction-table=) para obter detalhes.
O dispositivo a ser usado para a interface digital de instrumento musical. Consulte a opção -m (--midi-device=) para obter detalhes.
O dispositivo a ser usado para áudio digital. Consulte a opção -p (--pcm-device=) para obter detalhes.
O arquivo de preferências. Consulte a opção -F (--preferences-file=) para obter detalhes.
Solte o dispositivo ao qual a linha braille está conectada quando a tela ou janela atual não puder ser lida. Consulte a opção -r (--release-device) para obter detalhes.
O driver de tela. Consulte a opção -x (--screen-driver=) para obter detalhes.
Parâmetros para o driver de tela. Consulte a opção -X (--screen-parameters=) para obter detalhes.
O driver para o sintetizador de voz. Consulte a opção -s (--speech-driver=) para obter detalhes.
O objeto do sistema de arquivos que fornece a outros aplicativos acesso ao driver de fala do brltty para conversão de texto em fala. Consulte a opção -i (--speech-input=) para obter detalhes.
Parâmetros para o driver do sintetizador de voz. Consulte a opção -S (--speech-parameters=) para obter detalhes.
A tabela de texto. Consulte a opção -t (--text-table=) para obter detalhes.
Um display braille ou driver de sintetizador de fala deve ser especificado por meio de seu código de identificação:
- al
alva
- an
Android
- at
Albatroz
- ba
BrlAPI
- bc
BrailComm
- bd
Bráudio
- bl
Braille Lite
- bm
baum
- bn
Nota Braille
- cb
CombiBraille
- ce
Cebra
- cn
canuto
- ec
EcoBraille
- en
eSpeak-NG
- es
eSpeak
- eu
EuroBraille
- fa
FrankAudiodata
- fl
Festival Lite
- fs
FreedomScientific
- fv
Festival
- gs
GenericSay
- hd
Ele faz
- hm
ELE
- ht
HandyTech
- hw
HumanWareGenericName
- ir
Íris
- ic
Criador
- lb
Libbraille
- lt
LogText
- mb
MultiBraille
- md
MDV
- mm
BrailleMemo
- mn
MiniBraille
- mp
Mikropuhe
- mt
Metec
- no
sem motorista
- np
NinePoint
- pg
Pégaso
- pm
Papenmeier
- sd
SpeechDispatcher
- sk
Seika
- sw
Rápido
- th
teta
- tn
TechniBraille Systems Inc.
- ts
Telesensory Systems Inc.
- vd
VideoBraille
- vo
Voyager, Part232 (adaptador serial), BraillePen/EasyLink
- vs
VisioBrailleName
- vv
ViaVoice
- xs
Fala Externa
Uma lista de drivers delimitada por vírgulas pode ser especificada. Se isso for feito, a detecção automática será executada usando cada driver listado em sequência. Você pode precisar experimentar para determinar a ordem mais confiável, pois alguns drivers são detectados automaticamente melhor do que outros.
Se a única palavra auto for especificada, a detecção automática será executada usando apenas os drivers conhecidos por serem confiáveis para essa finalidade.
For full documentation, see brltty's on-line manual at [http://brltty.app/documentation.html].