mirror of
https://git.savannah.gnu.org/git/grub.git
synced 2026-10-28 01:59:49 +00:00
Import brltty
This commit is contained in:
1 parent
93c120754a
commit
16fba4d65d
982 files changed
+326586
No files matched your search
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,58 @@
|
||||
Adi Dascal <ad@baum.ro>
|
||||
Alex Bernier <alex.bernier@free.fr>
|
||||
Andreas Gross <andi@andi-bika.de>
|
||||
Attila Hammer <hammera@pickup.hu>
|
||||
August Hörandl <august.hoerandl@gmx.at>
|
||||
Boris Daix <Boris.Daix@insa-lyon.fr>
|
||||
Cheryl Homiak <chomiak@shellworld.net>
|
||||
Christian Comaschi <christian_comaschi@libero.it>
|
||||
Coscell Kao <coscell@molerat.net>
|
||||
Daniel Dalton <d.dalton@iinet.net.au>
|
||||
Dave Mielke <dave@mielke.cc>
|
||||
David Sauer <sauer@brailcom.cz>
|
||||
Hans Schou <chlor@schou.dk>
|
||||
Helge Havnegjerde <helge.havnegjerde@c2i.net>
|
||||
Hermann Bender <meinelisten@onlinehome.de>
|
||||
James Teh <jamie@jantrid.net>
|
||||
Jan Buchal <buchal@brailcom.org>
|
||||
Jean-Philippe Mengual <jmengual@linuxfromscratch.org>
|
||||
John J. Boyer <john.boyer@jjb-software.com>
|
||||
Kazunori Minatani <99112004@gakushuin.ac.jp>
|
||||
Lars Bjørndal <lars.bjorndal@broadpark.no>
|
||||
Lee Maschmeyer <leemer1@comcast.net>
|
||||
Luke Yelavich <themuso@ubuntu.com>
|
||||
Mario Lang <mlang@delysid.org>
|
||||
Mark Mielke <mark@mielke.cc>
|
||||
Matthew Miller <mattdm@mattdm.org>
|
||||
Michael Curran <mick@kulgan.net>
|
||||
Michel Such <michel.such@free.fr>
|
||||
Mike Pedersen <mpedersen@mindspring.com>
|
||||
Nicolas Pitre <nico@fluxnic.net>
|
||||
Olivier Bert <obert01@mistigri.org>`
|
||||
Oscar Fernandez <ofa@once.es>
|
||||
Pete De Vasto <pdevasto@incyte.com>
|
||||
Peter Lundblad <plundblad@google.com>
|
||||
Regiane Mendonça Villela <regianevillela@gmail.com>
|
||||
Rich Burridge <Rich.Burridge@Sun.COM>
|
||||
Rudolf Weeber <Rudolf.Weeber@gmx.de>
|
||||
Samuel Thibault <samuel.thibault@ens-lyon.org>
|
||||
Samuel Yang <mison@bbs.ee.ntu.edu.tw>
|
||||
Sébastien Hinderer <sebastien.hinderer@ens-lyon.org>
|
||||
Sérgio Neves <sergionevess@gmail.com>
|
||||
Simon Kainz <simon@familiekainz.at>
|
||||
Simon Meers <drmeers@gmail.com>
|
||||
Stepan Kasal <kasal@ucw.cz>
|
||||
Stephane Dalton <sdalton@videotron.ca>
|
||||
Stéphane Doyon <s.doyon@videotron.ca>
|
||||
Tapio Kelloniemi <tapio.kelloniemi@thack.org>
|
||||
Thu Trang <phamtrang2002@softhome.net>
|
||||
Timothy Spaulding <spaulding@icanbrew.com>
|
||||
Timo Matsinen <matsinen@jyu.fi>
|
||||
Tom spot Callaway <tcallawa@redhat.com>
|
||||
Tomáš Janoušek <tomi@nomi.cz>
|
||||
Tomoyuki Kudou <kudou@cypac.co.jp>
|
||||
Willi Lutzenberger <willutz@gmx.net>
|
||||
William Hubbs <w.d.hubbs@gmail.com>
|
||||
Wolfgang Astleitner <wolfgang.astleitner@liwest.at>
|
||||
Yair K. <caesium@hotpop.com>
|
||||
Yannick Plassiard <yan@mistigri.org>
|
||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,36 @@
|
||||
The BRLTTY project started in July, 1995. The initial team consisted of Nikhil
|
||||
Nair and James Bowden.
|
||||
|
||||
The first version ran with Blazie Engineering's Braille Lite. Since, at that
|
||||
time, the Braille Lite wasn't designed to be a dedicated refreshable braille
|
||||
display for a computer, its response time was far too slow. This situation has
|
||||
now been corrected.
|
||||
|
||||
The second version, BRLTTY-0.22-BETA, was released in September of 1995. It was
|
||||
the first to be released publicly. As well as the Braille Lite, it also
|
||||
supported Tieman B.V.'s CombiBraille series.
|
||||
|
||||
James Bowden stopped being an active developer, although his continued help in
|
||||
other areas (including documentation) was much appreciated. Two new members,
|
||||
Nicolas Pitre and Stéphane Doyon, joined the team. They added support for Alva
|
||||
and Telesensory Systems Inc. displays, as well as many excellent features for
|
||||
the system as a whole.
|
||||
|
||||
A stable version (1.0) was released sometime around the end of 1996.
|
||||
|
||||
Support for Papenmeier displays was contributed by a team from The Technical
|
||||
High School, Department of Electrical Engineering, Vienna, Austria. Support for
|
||||
the TSI displays was completed, and support for the EuroBraille brand was
|
||||
added. New features were also continually being added to the system.
|
||||
|
||||
Regretably, Nikhil Nair stopped working on the BRLTTY project. Nicolas Pitre
|
||||
assumed the job of maintainer.
|
||||
|
||||
Version 2.0 was released during the summer of 1998, and version 2.1 was
|
||||
released in March of 1999. It added support for EcoBraille (thanks to Oscar
|
||||
Fernandez), Alva Delphi (thanks to Terry Barnaby), and Braille Lite 18 (from
|
||||
Nikhil Nair), as well as Some small improvements and fixes.
|
||||
|
||||
Dave Mielke began to submit fixes and enhancements during 2000,
|
||||
and joined the team as the next maintainer in June of 2001.
|
||||
|
||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,135 @@
|
||||
<sect>Sujets avancés<p>
|
||||
|
||||
<sect1>Installation de plusieurs versions<label id="multiple"><p>
|
||||
Il est facile d'avoir plus d'une version de BRLTTY installée sur le même
|
||||
système en même temps. Cette possibilité vous permet de tester une nouvelle
|
||||
version avant de supprimer l'ancienne.
|
||||
|
||||
L'option de compilation <ref id="build-execute-root" name="--with-execute-root">
|
||||
vous permet d'installer la <ref id="hierarchy" name="hiérarchie des fichiers installés"> complète là où
|
||||
vous le voulez de sorte qu'elle soit totalement autonome dans son contenu.
|
||||
Tout en vous rappelant qu'il vaut mieux prendre tous les composants de
|
||||
BRLTTY dans le système de fichier racine, vous pouvez le compiler ainsi:
|
||||
<tscreen><verb>
|
||||
./configure --with-execute-root=/brltty-3.1
|
||||
make install
|
||||
</verb></tscreen>
|
||||
Vous pouvez alors l'exécuter ainsi:
|
||||
<tscreen>/brltty-3.1/bin/brltty</tscreen>
|
||||
Quand vous avez fait la version 3.2, installez-la simplement dans un
|
||||
emplacement différent et exécutez le nouvel exécutable à partir de là.
|
||||
<tscreen><verb>
|
||||
./configure --with-execute-root=/brltty-3.2
|
||||
make install
|
||||
/brltty-3.2/bin/brltty
|
||||
</verb></tscreen>
|
||||
|
||||
Jusque-là, tout cela est quelque peu maladroit pour au moins deux raisons.
|
||||
La première est que ces longs chemins sont trop difficiles à taper, et l'autre
|
||||
est que vous ne voulez pas bricoler avec
|
||||
la séquence de démarrage de votre système chaque fois que vous souhaitez aller
|
||||
à une version différente de BRLTTY.
|
||||
Ces problèmes se résolvent facilement en ajoutant un lien symbolique pour
|
||||
l'exécutable.
|
||||
<tscreen>ln -s /brltty-3.1/bin/brltty /bin/brltty</tscreen>
|
||||
Quand il est temps d'utiliser la version la plus récente, pointez de nouveau
|
||||
simplement le lien symbolique.
|
||||
<tscreen>ln -s /brltty-3.2/bin/brltty /bin/brltty</tscreen>
|
||||
|
||||
Si vous aimez vraiment faire de la fantaisie, introduisez un autre niveau
|
||||
de redirection de façon à rendre tous les fichiers de chaque version de BRLTTY
|
||||
tels qu'ils sont dans tous les emplacements standards.
|
||||
D'abord, créez un lien symbolique à travers un emplacement où on peut
|
||||
repointer aisément à partir de chacun des emplacements standards de BRLTTY.
|
||||
<tscreen><verb>
|
||||
ln -s /brltty/bin/brltty /bin/brltty
|
||||
ln -s /brltty/etc/brltty /etc/brltty
|
||||
ln -s /brltty/lib/brltty /lib/brltty
|
||||
</verb></tscreen>
|
||||
Ensuite, tout ce que vous devez faire est de pointer <tt>/brltty</tt> vers la
|
||||
version désirée.
|
||||
<tscreen>ln -s /brltty-3.1 /brltty</tscreen>
|
||||
|
||||
<sect1>Disques racines d'Installation/Secours pour Linux<p>
|
||||
BRLTTY peut s'exécuter comme un seul exécutable. Tout ce qu'il a besoin de
|
||||
savoir peut être configuré explicitement lors de la compilation (voir
|
||||
<ref id="build" name="Options de compilation">).
|
||||
Si le répertoire de données (voir les options de compilation
|
||||
<ref id="build-data-directory" name="--with-data-directory"> et
|
||||
<ref id="build-execute-root" name="--with-execute-root">) n'existe pas, BRLTTY
|
||||
cherche dans <tt>/etc</tt> les fichiers dont il a besoin.
|
||||
Même si un de ces fichiers n'existe pas, BRLTTY fonctionne encore!
|
||||
|
||||
Si, pour une raison quelconque, vous avez déjà créé le répertoire de données
|
||||
(habituellement, <tt>/etc/brltty</tt>) à la main, il est important de régler
|
||||
ses permissions de telle sorte que seul le super-utilisateur puisse y créer des
|
||||
fichiers.
|
||||
<tscreen>chmod 755 /etc/brltty</tscreen>
|
||||
|
||||
Le périphérique d'inspection du contenu de l'écran (habituellement
|
||||
<tt>/dev/vcsa</tt>) est nécessaire. Il devrait déjà exister, à moins que votre
|
||||
distribution de Linux ne soit trop vieille. Si nécessaire, vous pouvez le créer
|
||||
avec:
|
||||
<tscreen><verb>
|
||||
mknod /dev/vcsa c 7 128
|
||||
chmod 660 /dev/vcsa
|
||||
chown root.tty /dev/vcsa
|
||||
</verb></tscreen>
|
||||
|
||||
Un problème souvent rencontré lorsqu'on essaie d'utiliser BRLTTY dans un
|
||||
environnement instable, comme un disque racine ou un système incomplet, est
|
||||
qu'il pourrait ne pas trouver les bibliothèques partagées (ou des parties
|
||||
de celles-ci) dont il a besoin.
|
||||
Les disques racines utilisent souvent des versions des bibliothèques
|
||||
sous-paramétrées et/ou non à jour qui peuvent être inadéquates. La solution est de configurer BRLTTY avec l'optfon de
|
||||
compilation <ref id="build-standalone-programs" name="--enable-standalone-programs">.
|
||||
Cela supprime toutes les dépendances des bibliothèques partagées, mais
|
||||
malheureusement, crée aussi un exécutable plus gros.
|
||||
Il y a un certain nombre d'options de compilation que vous pouvez utiliser
|
||||
pour supprimer de façon sélective les possibilités de BRLTTY dont vous n'avez pas
|
||||
besoin de façon à atténuer ce problème (voir la section
|
||||
<ref id="build-features" name="possibilitéés de la compilation">).
|
||||
|
||||
L'exécutable est nettoyé pendant le
|
||||
<ref id="make-install" name="make install">. Cela réduit de façon
|
||||
significative sa taille en supprimant sa table de symboles.
|
||||
Vous obtiendrez un exécutable beaucoup plus petit, puis copiez-le de son emplacement
|
||||
d'installation.
|
||||
Cependant, si vous le copiez depuis le répertoire de compilation, n'oubliez pas de le nettoyer.
|
||||
<tscreen>strip brltty</tscreen>
|
||||
|
||||
<sect1>Avancées futures<p>
|
||||
Outre la réparation de bugs et le support de plus de types d'afficheurs
|
||||
brailles, nous espérons, si le temps nous le permet, travailler sur:
|
||||
<descrip>
|
||||
<tag>Meilleure prise en charge des attributs</tag>
|
||||
<itemize>
|
||||
<item>Poursuite des attributs.
|
||||
<item>Mode mixte texte et attributs.
|
||||
</itemize>
|
||||
<tag>Poursuite du défilement</tag>
|
||||
Alignement de la plage braille sur une ligne alors qu'elle défile à
|
||||
l'écran.
|
||||
<tag>Meilleur support de voix</tag>
|
||||
<itemize>
|
||||
<item>Braille et voix mélangés pour une lecture plus rapide du texte.
|
||||
<item>Meilleur navigation vocale.
|
||||
<item>Plus de synthèses vocales.
|
||||
</itemize>
|
||||
<tag>Sous-régions sur l'écran</tag>
|
||||
Ignorer le déplacement du curseur hors de la région, et rendre fluide les
|
||||
limites de navigation aux bords de la région.
|
||||
</descrip>
|
||||
Voir le fichier <tt>TODO</tt> pour une liste plus complète.
|
||||
|
||||
<sect1>Bogues connus<p>
|
||||
A l'heure où nous écrivons (décembre 2001), les problèmes suivants sont
|
||||
connus.
|
||||
|
||||
La routine-curseur est considérée comme un sous-processus en boucle qui s'exécute
|
||||
avec une priorité réduite pour éviter de trop utiliser le temps du processeur.
|
||||
Les chargements de systèmes différents nécessitent des réglages différents de
|
||||
ses paramètres. Ceux par défaut fonctionnent très bien dans un éditeur Unix
|
||||
classique sur un système chargé normalement, mais très mal dans d'autres
|
||||
situations, par exemple sur une liaison série lente vers un nom de machine
|
||||
supprimé.
|
||||
@@ -0,0 +1,144 @@
|
||||
<!doctype linuxdoc system[
|
||||
|
||||
<!ENTITY introduction SYSTEM "Introduction.sgml">
|
||||
<!ENTITY compilation SYSTEM "Compilation.sgml">
|
||||
<!ENTITY utilisation SYSTEM "Utilisation.sgml">
|
||||
<!ENTITY features SYSTEM "Features.sgml">
|
||||
<!ENTITY translation SYSTEM "Translation.sgml">
|
||||
<!ENTITY advanced SYSTEM "Advanced.sgml">
|
||||
<!ENTITY displays SYSTEM "Displays.sgml">
|
||||
<!ENTITY synthesizers SYSTEM "Synthesizers.sgml">
|
||||
<!ENTITY drivers SYSTEM "Drivers.sgml">
|
||||
<!ENTITY screen SYSTEM "Screen.sgml">
|
||||
<!ENTITY syntaxe SYSTEM "Syntax.sgml">
|
||||
<!ENTITY dots SYSTEM "Dots.sgml">
|
||||
<!ENTITY nabcc SYSTEM "nabcc.sgml">
|
||||
<!ENTITY fr2007 SYSTEM "fr-2007.sgml">
|
||||
<!ENTITY midi SYSTEM "Midi.sgml">
|
||||
|
||||
]>
|
||||
<article>
|
||||
|
||||
<titlepag>
|
||||
<title>Manuel de référence de BRLTTY
|
||||
<subtitle>Accès à l'écran d'une console pour les personnes non-voyantes utilisant des afficheurs braille
|
||||
<author>
|
||||
<name>Nikhil Nair <tt><htmlurl url="mailto:nn201@cus.cam.ac.uk" name="<nn201@cus.cam.ac.uk>"></tt>
|
||||
<and>
|
||||
<name>Nicolas Pitre <tt><htmlurl url="mailto:nico@fluxnic.net" name="<nico@fluxnic.net>"></tt>
|
||||
<and>
|
||||
<name>Stéphane Doyon <tt><htmlurl url="mailto:s.doyon@videotron.ca" name="<s.doyon@videotron.ca>"></tt>
|
||||
<and>
|
||||
<name>Dave Mielke <tt><htmlurl url="mailto:dave@mielke.cc" name="<dave@mielke.cc>"></tt>
|
||||
<and>
|
||||
<name>Traduction française
|
||||
<and>
|
||||
<name>
|
||||
Jean-Philippe Mengual
|
||||
<tt><htmlurl url="mailto:jmengual@linuxfromscratch.org" name="<jmengual@linuxfromscratch.org>"></tt>
|
||||
pour
|
||||
<tt><htmlurl url="http://www.traduc.org/" name="Traduc.org"></tt>
|
||||
<date>Version 4.3, oct 2011
|
||||
<abstract>
|
||||
Copyright © 1995-2012 by Les Développeurs de BRLTTY.
|
||||
BRLTTY est un logiciel libre, et n'est fourni avec AUCUNE
|
||||
GARANTIE. Il est placé sous les termes de la version 2 ou
|
||||
ultérieure de la <bf>GNU General Public License</bf> publiée par
|
||||
<bf>The Free Software Foundation</bf>.
|
||||
</abstract>
|
||||
</titlepag>
|
||||
|
||||
<toc>
|
||||
<lof>
|
||||
<lot>
|
||||
|
||||
<sect>Préambule<p>
|
||||
|
||||
<sect1>Licence<p>
|
||||
Ce programme est un logiciel libre. Vous pouvez le redistribuer et/ou
|
||||
le modifier sous les termes de la <htmlurl url="http://www.gnu.org/licenses/licenses.html#GPL" name="GNU General Public License">
|
||||
stipulée par la <htmlurl url="http://www.gnu.org/fsf/fsf.html" name="Free Software Foundation">. Vous pouvez utiliser une version 2 (ou supérieure) de la licence.
|
||||
|
||||
Vous devriez avoir reçu une copie de la licence avec le
|
||||
programme. Elle devrait être dans le fichier <tt/LICENSE-GPL/ du
|
||||
répertoire principal. Si ce n'est pas le cas, écrivez à la Free Software
|
||||
Foundation Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
|
||||
<sect1>Mise en garde<p>
|
||||
Ce programme est distribué avec l'espoir d'être utile, mais SANS
|
||||
AUCUNE GARANTIE, même pas celle d'être COMMERCIALISABLE ou
|
||||
de CONVENIR À UNE FINALITÉ EN PARTICULIER. Voir la <bf>GNU General
|
||||
Public License</bf> pour plus de détails.
|
||||
|
||||
<sect1>Contacts<label id="contact"><p>
|
||||
BRLTTY est le travail d'une équipe. Pour des informations actualisées,
|
||||
voyez la page Web de BRLTTY sur [<htmlurl url="http://mielke.cc/brltty/" name="http://mielke.cc/brltty/">]. Ont
|
||||
participé à ce document et au logiciel:
|
||||
|
||||
<itemize>
|
||||
<item>
|
||||
Dave Mielke (responsable, actif)
|
||||
<descrip>
|
||||
<tag/Web/<htmlurl url="http://mielke.cc/" name="http://mielke.cc/">
|
||||
<tag/E-Mail/<htmlurl url="mailto:dave@mielke.cc" name="<dave@mielke.cc>">
|
||||
</descrip>
|
||||
<item>
|
||||
Samuel Thibault (actif)
|
||||
<descrip>
|
||||
<tag/Web/<htmlurl url="http://dept-info.labri.fr/~thibault/" name="http://dept-info.labri.fr/~thibault/">
|
||||
<tag/E-Mail/<htmlurl url="mailto:samuel.thibault@ens-lyon.org" name="<samuel.thibault@ens-lyon.org>">
|
||||
</descrip>
|
||||
<item>
|
||||
Mario Lang (actif)
|
||||
<descrip>
|
||||
<tag/Web/<htmlurl url="http://delysid.org/" name="http://delysid.org/">
|
||||
<tag/E-Mail/<htmlurl url="mailto:mlang@delysid.org" name="<mlang@delysid.org>">
|
||||
</descrip>
|
||||
<item>
|
||||
Nicolas Pitre
|
||||
<descrip>
|
||||
<tag/Web/<htmlurl url="http://www.cam.org/~nico/" name="http://www.cam.org/~nico/">
|
||||
<tag/E-Mail/<htmlurl url="mailto:nico@fluxnic.net" name="<nico@fluxnic.net>">
|
||||
</descrip>
|
||||
<item>
|
||||
Stéphane Doyon
|
||||
<descrip>
|
||||
<tag/Web/<htmlurl url="http://pages.infinit.net/sdoyon/" name="http://pages.infinit.net/sdoyon/">
|
||||
<tag/E-Mail/<htmlurl url="mailto:s.doyon@videotron.ca" name="<s.doyon@videotron.ca>">
|
||||
</descrip>
|
||||
<item>
|
||||
Nikhil Nair (auteur)
|
||||
<descrip>
|
||||
<tag/E-Mail/<htmlurl url="mailto:nn201@cus.cam.ac.uk" name="<nn201@cus.cam.ac.uk>">
|
||||
</descrip>
|
||||
|
||||
</itemize>
|
||||
|
||||
Toute question, tout commentaire, toute suggestions, critiques et contributions
|
||||
sont les bienvenus. Même si nos adresses de messagerie sont listées ci-dessus,
|
||||
le meilleur moyen de nous contacter est la liste de diffusion BRLTTY. Vous
|
||||
pouvez poster sur la liste en envoyant votre message à
|
||||
<htmlurl url="mailto:BRLTTY@mielke.cc" name="<BRLTTY@mielke.cc>">. Si
|
||||
vous n'êtes pas abonné à la liste, vos messages seront soumis à l'approbation
|
||||
du modérateur. Pour vous abonner, vous désabonner, modifier les paramètres de
|
||||
voir les archives, etc, rendez-vous sur la page d'information de la liste, sur
|
||||
<htmlurl url="http://mielke.cc/mailman/listinfo/brltty" name="http://mielke.cc/mailman/listinfo/brltty">.
|
||||
|
||||
&introduction
|
||||
&compilation
|
||||
&utilisation
|
||||
&features
|
||||
&translation
|
||||
&advanced
|
||||
|
||||
&displays
|
||||
&synthesizers
|
||||
&drivers
|
||||
&screen
|
||||
&syntaxe
|
||||
&dots
|
||||
&nabcc
|
||||
&fr2007
|
||||
&midi
|
||||
|
||||
</article>
|
||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,106 @@
|
||||
<sect>Afficheurs braille supportés<label id="displays"><p>
|
||||
BRLTTY supporte les afficheurs braille suivants:
|
||||
<table loc="h">
|
||||
<tabular ca="ll">
|
||||
Nom|Modèles@<hline>
|
||||
Albatross
|
||||
|46/80@
|
||||
Alva
|
||||
|ABT (3nn)@
|
||||
|Delphi (4nn)@
|
||||
|Satellite (5nn)@
|
||||
|Braille System 40@
|
||||
|Braille Controller 640/680@
|
||||
Baum
|
||||
|Inka@
|
||||
|Vario/RBT@
|
||||
|SuperVario/Brailliant@
|
||||
|PocketVario@
|
||||
|VarioPro@
|
||||
|EcoVario@
|
||||
|VarioConnect/BrailleConnect@
|
||||
|Refreshabraille@
|
||||
BrailComm
|
||||
|III@
|
||||
BrailleLite
|
||||
|18/40/M20/M40@
|
||||
BrailleNote
|
||||
|18/32@
|
||||
BrlAPI@
|
||||
CombiBraille
|
||||
|25/45/85@
|
||||
EcoBraille
|
||||
|20/40/80@
|
||||
EuroBraille
|
||||
|AzerBraille@
|
||||
|Clio@
|
||||
|Iris@
|
||||
|NoteBraille@
|
||||
|Scriba@
|
||||
|Esys 12/40@
|
||||
FreedomScientific
|
||||
|Focus 1 44/70/84@
|
||||
|Focus 2 40/80@
|
||||
|Focus Blue 40@
|
||||
|PAC Mate 20/40@
|
||||
HandyTech
|
||||
|Modular 20/40/80@
|
||||
|Modular Evolution 64/88@
|
||||
|Active Braille@
|
||||
|Braille Wave@
|
||||
|Easy Braille@
|
||||
|Braille Star 40/80@
|
||||
|Bookworm@
|
||||
|Braillino@
|
||||
HIMS
|
||||
|Braille Sense@
|
||||
|SyncBraille@
|
||||
Libbraille@
|
||||
LogText
|
||||
|32@
|
||||
MDV
|
||||
|MB208/MB408L/MB408S (protocol 5)@
|
||||
Metec
|
||||
|BD-40@
|
||||
MiniBraille
|
||||
|20@
|
||||
MultiBraille
|
||||
|MB125CR/MB145CR/MB185CR@
|
||||
Papenmeier
|
||||
|Compact 486@
|
||||
|Compact/Tiny@
|
||||
|IB 80 CR Soft@
|
||||
|2D Lite (plus)@
|
||||
|2D Screen Soft@
|
||||
|EL 80@
|
||||
|EL 2D 40/66/80@
|
||||
|EL 40/66/70/80 S@
|
||||
|EL 2D 80 S@
|
||||
|EL 40 P@
|
||||
|EL 80 II@
|
||||
|Elba 20/32@
|
||||
|Trio 40/Elba20/Elba32@
|
||||
Pegasus
|
||||
|20/27/40/80@
|
||||
Seika
|
||||
|40@
|
||||
TSI
|
||||
|Navigator 20/40/80@
|
||||
|PowerBraille 40/65/80@
|
||||
TTY
|
||||
|terminfo@
|
||||
VideoBraille
|
||||
|40@
|
||||
Virtual
|
||||
|TCP/Unix, client/server@
|
||||
VisioBraille
|
||||
|20/40@
|
||||
Voyager
|
||||
|44/70@
|
||||
|Part232 (adaptateur série)@
|
||||
|BraillePen/EasyLink@
|
||||
XWindow
|
||||
|X11@
|
||||
|Windows@
|
||||
</tabular>
|
||||
</table>
|
||||
@@ -0,0 +1,27 @@
|
||||
<sect>Convention standard du nombre de points brailles<label id="dots"><p>
|
||||
Une cellule braille standard consiste en six points répartis en trois lignes
|
||||
et deux colonnes.
|
||||
Chaque point peut être identifié par son numéro, comme suit:
|
||||
<descrip>
|
||||
<tag>1</tag>En haut à gauche (ligne 1, colonne 1).
|
||||
<tag>2</tag>Milieu gauche (ligne 2, colonne 1).
|
||||
<tag>3</tag>Bas gauche (ligne 3, colonne 1).
|
||||
<tag>4</tag>En haut droite (ligne 1, colonne 2).
|
||||
<tag>5</tag>Milieu droite (ligne 2, colonne 2).
|
||||
<tag>6</tag>Bas droite (ligne 3, colonne 2).
|
||||
</descrip>
|
||||
|
||||
Le braille informatique a introduit une quatrième rangée en bas.
|
||||
<descrip>
|
||||
<tag>7</tag>Dessous gauche (ligne 4, colonne 1).
|
||||
<tag>8</tag>Dessous droite (ligne 4, colonne 2).
|
||||
</descrip>
|
||||
|
||||
Peut-être qu'une image rendra cette convention numérique plus facile à
|
||||
comprendre.
|
||||
<tscreen><verb>
|
||||
1 o o 4
|
||||
2 o o 5
|
||||
3 o o 6
|
||||
7 o o 8
|
||||
</verb></tscreen>
|
||||
@@ -0,0 +1,48 @@
|
||||
<sect>Codes d'identification de pilote<label id="drivers"><p>
|
||||
<table loc="h">
|
||||
<tabular ca="ll">
|
||||
Code|Name@<hline>
|
||||
al|Alva@
|
||||
at|Albatross@
|
||||
ba|BrlAPI@
|
||||
bc|BrailComm@
|
||||
bc|BrailComm@
|
||||
bl|BrailleLite@
|
||||
bm|Baum (Native, HT, PB1, PB2)@
|
||||
bn|BrailleNote@
|
||||
cb|CombiBraille@
|
||||
ec|EcoBraille@
|
||||
es|eSpeak@
|
||||
eu|EuroBraille@
|
||||
fl|FestivalLite@
|
||||
fs|FreedomScientific@
|
||||
fv|Festival@
|
||||
gs|GenericSay@
|
||||
hm|HIMS@
|
||||
ht|HandyTech@
|
||||
il|IrisLinux@
|
||||
lb|Libbraille@
|
||||
lt|LogText@
|
||||
mb|MultiBraille@
|
||||
md|MDV@
|
||||
mn|MiniBraille@
|
||||
mp|Mikropuhe@
|
||||
mt|Metec@
|
||||
no|no driver@
|
||||
pg|Pegasus@
|
||||
pm|Papenmeier@
|
||||
sd|SpeechDispatcher@
|
||||
sk|Seika@
|
||||
sw|Swift@
|
||||
th|Theta@
|
||||
ts|Telesensory Systems Inc.@
|
||||
tt|TTY@
|
||||
vd|VideoBraille@
|
||||
vo|Voyager@
|
||||
vr|Virtual@
|
||||
vs|VisioBraille@
|
||||
vv|ViaVoice@
|
||||
xs|ExternalSpeech@
|
||||
xw|XWindow@
|
||||
</tabular>
|
||||
</table>
|
||||
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,166 @@
|
||||
<sect>Introduction<p>
|
||||
BRLTTY donne à un utilisateur brailliste un accès aux consoles texte
|
||||
d'un système Linux/Unix. Il exécute un processus en arrière-plan
|
||||
(démon) qui fait fonctionner l'afficheur braille, et
|
||||
peut être démarré très tôt dans la séquence de démarrage du
|
||||
système. Ainsi, il permet à un utilisateur brailliste, de prendre en main
|
||||
facilement et de façon indépendante des aspects de l'administration du
|
||||
système, comme l'entrée en mode mono-utilisateur, la restauration de systèmes de fichiers, et
|
||||
l'analyse de problèmes de démarrage. Il facilite aussi beaucoup des
|
||||
opérations de bases telles que l'identification.
|
||||
|
||||
BRLTTY reproduit une portion rectangulaire de l'écran (appelée
|
||||
dans ce document `la fenêtre') sous forme de texte braille sur l'afficheur.
|
||||
Vous pouvez utiliser des contrôles de l'affichage pour déplacer la fenêtre sur
|
||||
l'écran, pour activer et désactiver des options de revue
|
||||
variées, et pour exécuter des fonctions spéciales.
|
||||
|
||||
<sect1>Résumé des possibilités<p>
|
||||
BRLTTY donne les possibilités suivantes:
|
||||
<itemize>
|
||||
<item>
|
||||
Totale mise en oeuvre des facilités de revue d'écran habituelles.
|
||||
<item>
|
||||
Choix d'un curseur en forme de <tt>bloc</tt>, <tt>souligné</tt>, ou
|
||||
<tt>aucun</tt>.
|
||||
<item>
|
||||
<tt>Soulignement</tt> possible pour indiquer un texte particulièrement
|
||||
en surbrillance.
|
||||
<item>
|
||||
Utilisation possible du <tt>clignotement</tt> (fréquences réglables
|
||||
individuellement) pour le curseur, le soulignement des caractères en
|
||||
surbrillance, et/ou les lettres en majuscule.
|
||||
<item>
|
||||
Gel de l'écran pour en faire une relecture plus lente.
|
||||
<item>
|
||||
Routine-curseur intelligente, permettant un rapide
|
||||
rapatriment du curseur dans les éditeurs de texte, les navigateurs
|
||||
web, etc., sans bouger les mains de l'afficheur braille.
|
||||
<item>
|
||||
Une fonction copier-coller (linéaire ou rectangulaire) qui est
|
||||
particulièrement utile pour la copie de longs noms de fichier, de
|
||||
texte entre des terminaux virtuels, la saisie de commandes
|
||||
compliquées, etc.
|
||||
<item>
|
||||
Gestion des tables de braille abrégé (fournie en anglais et en français).
|
||||
<item>
|
||||
Support pour de multiples codes braille.
|
||||
<item>
|
||||
Possibilité d'identifier un caractère inconnu.
|
||||
<item>
|
||||
Possibilité d'inspecter un caractère en surbrillance.
|
||||
<item>
|
||||
Une facilité dans l'aide en ligne pour les commandes de
|
||||
l'afficheur braille.
|
||||
<item>
|
||||
Un menu préférences.
|
||||
<item>
|
||||
Support de synthèses basiques.
|
||||
<item>
|
||||
Une conception en modules permettant d'ajouter relativement
|
||||
facilement d'autres afficheurs braille et d'autres synthèses
|
||||
vocales.
|
||||
<item>
|
||||
Une Interface de programmation de l'Application.
|
||||
</itemize>
|
||||
|
||||
<sect1>Système requis<p>
|
||||
Actuellement, BRLTTY fonctionne sur Linux, Solaris, OpenBSD, FreeBSD,
|
||||
NetBSD et Windows. Les portages sur d'autres systèmes d'exploitation
|
||||
dérivés de Unix ne sont pas encore prévues, nous apprécierions vraiment
|
||||
tout intérêt pour de tels projets.
|
||||
|
||||
<descrip>
|
||||
<tag>Linux</tag>
|
||||
Ce logiciel a été testé sur un grand nombre de systèmes Linux:
|
||||
<itemize>
|
||||
<item>
|
||||
Ordinateurs de bureau, portables, et quelques PDAs.
|
||||
<item>
|
||||
Des processeurs 386SX20 à Pentium.
|
||||
<item>
|
||||
Une large échelle de capacité de mémoire.
|
||||
<item>
|
||||
Plusieurs distributions dont Debian, Red Hat, Slackware et SuSE.
|
||||
<item>
|
||||
La plupart des noyaux, dont les 1.2.13, 2.0, 2.2, et 2.4.
|
||||
</itemize>
|
||||
<tag>Solaris</tag>
|
||||
Ce logiciel a été testé sur les systèmes Solaris suivants:
|
||||
<itemize>
|
||||
<item>
|
||||
L'architecture Sparc (versions 7, 8, et 9).
|
||||
<item>
|
||||
L'architecture Intel (version 9).
|
||||
</itemize>
|
||||
<tag>OpenBSD</tag>
|
||||
Ce logiciel a été testé sur les systèmes OpenBSD suivants:
|
||||
<itemize>
|
||||
<item>
|
||||
L'architecture Intel (version 3.4).
|
||||
</itemize>
|
||||
<tag>FreeBSD</tag>
|
||||
Ce logiciel a été testé sur les systèmes FreeBSD suivants:
|
||||
<itemize>
|
||||
<item>
|
||||
L'architecture Intel (version 5.1).
|
||||
</itemize>
|
||||
<tag>NetBSD</tag>
|
||||
Ce logiciel a été testé sur les systèmes NetBSD suivants:
|
||||
<itemize>
|
||||
<item>
|
||||
L'architecture Intel (version 1.6).
|
||||
</itemize>
|
||||
<tag>Windows</tag>
|
||||
Ce logiciel a été testé sur Windows 95, 98 et XP.
|
||||
|
||||
</descrip>
|
||||
|
||||
Sur Linux, BRLTTY peut inspecter le contenu de l'écran de façon
|
||||
totalement indépendante de l'utilisateur. Cela est possible
|
||||
grâce à l'utilisation d'un périphérique spécial offrant un accès
|
||||
facile aux contenus de la console virtuelle courante. Ce périphérique
|
||||
a été ajouté à la version 1.1.92 du noyau Linux, et s'appelle
|
||||
normalement <tt>/dev/vcsa</tt> ou <tt>/dev/vcsa0</tt> (sur les systèmes
|
||||
avec <tt>devfs</tt>, il s'appelle <tt>/dev/vcc/a</tt>). C'est pourquoi le noyau
|
||||
Linux 1.1.92 ou supérieur est nécessaire si BRLTTY est utilisé de
|
||||
cette façon. Cette possibilité:
|
||||
<itemize>
|
||||
<item>
|
||||
Permet à BRLTTY d'être démarré très tôt dans la séquence de
|
||||
démarrage du système.
|
||||
<item>
|
||||
Active l'afficheur braille pour qu'il soit totalement opérationnel
|
||||
à l'invite de logging.
|
||||
<item>
|
||||
Facilite fortement pour un utilisateur brailliste
|
||||
des tâches d'administration lors du démarrage.
|
||||
</itemize>
|
||||
|
||||
Un correctif pour le programme <tt>d'écran</tt> est fourni (voir le sous-répertoire
|
||||
<tt>Patches</tt>). Il permet à BRLTTY d'accéder à l'image d'un écran
|
||||
via une mémoire partagée, et, ainsi, permet à BRLTTY d'être utilisé
|
||||
beaucoup plus efficacement sur des plateformes qui n'ont pas leurs
|
||||
propres facilité d'inspection du contenu de leur écran. La faiblesse
|
||||
principale de cette approche de l'écran est que BRLTTY ne peut être
|
||||
démarré tant que l'utilisateur n'est pas connecté.
|
||||
|
||||
BRLTTY ne fonctionne qu'avec des consoles et des applications basées
|
||||
sur du texte. Il peut être utilisé avec les applications basées sur
|
||||
<tt>curses</tt>, mais pas avec une application utilisant des caractéristiques
|
||||
spéciales VGA ou qui requièrent une console graphique (comme le système X
|
||||
Window).
|
||||
|
||||
Bien entendu, vous devez aussi posséder un afficheur braille supporté
|
||||
(voir la section <ref id="displays" name="Afficheurs braille
|
||||
supportés"> pour la liste complète). Nous espérons que des afficheurs
|
||||
supplémentaires seront supportés dans le futur, donc si vous disposez de quelques
|
||||
vagues informations de programmation techniques pour un pilote que
|
||||
vous aimeriez voir supporté, faites-le nous savoir (voir la section
|
||||
<ref id="contact" name="Contacts">).
|
||||
|
||||
Enfin, vous avez besoin d'outils pour compiler l'exécutable depuis le
|
||||
source, <tt>make</tt>, les compilateurs <tt>C</tt> et <tt>C++</tt>, <tt>yacc</tt>,
|
||||
<tt>awk</tt>, etc. Les outils de développement fournis avec les
|
||||
distributions Unix standards devraient suffire. Si vous rencontrez des
|
||||
problèmes, contactez-nous et nous vous compilerons un exécutable.
|
||||
@@ -0,0 +1,149 @@
|
||||
<sect>Table d'instruments MIDI<label id="midi"><p>
|
||||
<table loc="h">
|
||||
<tabular ca="lrl">
|
||||
<hline>Piano
|
||||
|0|Piano à queue accoustique@
|
||||
|1|Piano accoustique brillant@
|
||||
|2|Piano à queue électrique@
|
||||
|3|Piano bastringue@
|
||||
|4|Piano 1@
|
||||
|5|Piano électrique 2@
|
||||
|6|clavecin@
|
||||
|7|Claviers@
|
||||
<hline>Percussions chromatiques
|
||||
|8|Célesta@
|
||||
|9|Glockenspiel@
|
||||
|10|Boîte à rythme@
|
||||
|11|Vibraphone@
|
||||
|12|Marimba@
|
||||
|13|Xylophone@
|
||||
|14|Tubular Bells@
|
||||
|15|Dulcimer@
|
||||
<hline>Orgue
|
||||
|16|Orgue de barbarie@
|
||||
|17|Orgue percussive@
|
||||
|18|Orgue rock@
|
||||
|19|Orgue d'église@
|
||||
|20|Orgue de hanche@
|
||||
|21|Accordéon@
|
||||
|22|Harmonica@
|
||||
|23|Accordéon de tango@
|
||||
<hline>Guitare
|
||||
|24|Guitare accoustique Nylon Acoustic Guitar@
|
||||
|25|Guitare accoustique métal@
|
||||
|26|Guitare électrique Jazz@
|
||||
|27|Guitare électrique propre@
|
||||
|28|Guitare électrique bouchée@
|
||||
|29|Guitare overdriven@
|
||||
|30|Distortion Guitar@
|
||||
|31|Harmoniques de guitare@
|
||||
<hline>Basse
|
||||
|32|Basse accoustique@
|
||||
|33|Basse électrique au doigt@
|
||||
|34|Pick Electric Bass@
|
||||
|35|Fretless Bass@
|
||||
|36|Slap Bass 1@
|
||||
|37|Slap Bass 2@
|
||||
|38|Synth Bass 1@
|
||||
|39|Synth Bass 2@
|
||||
<hline>Pistons
|
||||
|40|Violon@
|
||||
|41|Alto@
|
||||
|42|Violoncelle@
|
||||
|43|Contrebasse@
|
||||
|44|Pistons Tremolo@
|
||||
|45|Pisstons pizzicato@
|
||||
|46|Harpe Orchestrale@
|
||||
|47|timbales@
|
||||
<hline>Ensemble
|
||||
|48|String Ensemble 1@
|
||||
|49|String Ensemble 2@
|
||||
|50|Synth Strings 1@
|
||||
|51|Synth Strings 2@
|
||||
|52|Aahs choeur@
|
||||
|53|Oohs voix@
|
||||
|54|Voice synthétique@
|
||||
|55|Orchestra Hit@
|
||||
<hline>Cuivre
|
||||
|56|Trompette@
|
||||
|57|Trombonne@
|
||||
|58|Tuba@
|
||||
|59|Trompette bouchée@
|
||||
|60|Cor français@
|
||||
|61|Section cuivre@
|
||||
|62|Cuivre synthétique 1@
|
||||
|63|Cuivre synthétique 2@
|
||||
<hline>Anche
|
||||
|64|Saxophone soprano@
|
||||
|65|Saxophone Alto@
|
||||
|66|Saxophone Tenor@
|
||||
|67|Saxophone Bariton@
|
||||
|68|Hautbois@
|
||||
|69|Cor anglais@
|
||||
|70|Basson@
|
||||
|71|Clarinette@
|
||||
<hline>Tuyau
|
||||
|72|Piccolo@
|
||||
|73|Flûte@
|
||||
|74|Flûte à bec@
|
||||
|75|Flûte de pan@
|
||||
|76|Blown Bottle@
|
||||
|77|Shakuhachi@
|
||||
|78|Sifflet@
|
||||
|79|Ocarina@
|
||||
<hline>Synth Lead
|
||||
|80|Lead 1 (square)@
|
||||
|81|Lead 2 (dent de scie)@
|
||||
|82|Lead 3 (calliope)@
|
||||
|83|Lead 4 (chiff)@
|
||||
|84|Lead 5 (charang)@
|
||||
|85|Lead 6 (voix)@
|
||||
|86|Lead 7 (cinquièmes)@
|
||||
|87|Lead 8 (basse + lead)@
|
||||
<hline>Synth Pad
|
||||
|88|Pad 1 (nOuvel âge)@
|
||||
|89|Pad 2 (chaud)@
|
||||
|90|Pad 3 (polysynth)@
|
||||
|91|Pad 4 (choeur)@
|
||||
|92|Pad 5 (bowed)@
|
||||
|93|Pad 6 (métalique)@
|
||||
|94|Pad 7 (halo)@
|
||||
|95|Pad 8 (sweep)@
|
||||
<hline>Synth FM
|
||||
|96|FX 1 (pluie)@
|
||||
|97|FX 2 (soundtrack)@
|
||||
|98|FX 3 (cristal)@
|
||||
|99|FX 4 (atmosphère)@
|
||||
|100|FX 5 (brightness)@
|
||||
|101|FX 6 (goblins)@
|
||||
|102|FX 7 (échos)@
|
||||
|103|FX 8 (science-fiction)@
|
||||
<hline>Ethnic
|
||||
|104|Sitar@
|
||||
|105|Banjo@
|
||||
|106|Shamisen@
|
||||
|107|Koto@
|
||||
|108|Kalimba@
|
||||
|109|Bag Pipe@
|
||||
|110|Fiddle@
|
||||
|111|Shanai@
|
||||
<hline>Percussive
|
||||
|112|Tinkle Bell@
|
||||
|113|Agogo@
|
||||
|114|Steel Drum@
|
||||
|115|Wooden Block@
|
||||
|116|Taiko Drum@
|
||||
|117|Melodic Tom@
|
||||
|118|Synth Drum@
|
||||
|119|Reverse Cymbal@
|
||||
<hline>Effets sonores
|
||||
|120|Bruit de touche de guitare@
|
||||
|121|Bruit de souffle@
|
||||
|122|Bord de mer@
|
||||
|123|Bruit d'oiseau@
|
||||
|124|Sonnerie de télphone@
|
||||
|125|Helicoptère@
|
||||
|126|Applaudissements@
|
||||
|127|Gunshot@
|
||||
</tabular>
|
||||
</table>
|
||||
@@ -0,0 +1,23 @@
|
||||
<sect>Pilotes d'écran supportés <label id="screen"><p>
|
||||
BRLTTY supporte les pilotes d'écran suivants:
|
||||
<descrip>
|
||||
<tag/as/
|
||||
AT-SPI
|
||||
<tag/hd/
|
||||
Ce pilote fournit un accès direct à l'écran d'une console Hurd.
|
||||
Il n'est sélectionnable et par défaut oque sur les systèmes Hurd.
|
||||
<tag/lx/
|
||||
Ce pilote fournit un accès direct à l'écran d'une console Linux
|
||||
Il n'est sélectionnable et par défaut oque sur les systèmes Linux.
|
||||
<tag/sc/
|
||||
Ce pilote fournit un accès direct au programme <tt/screen/.
|
||||
Vous pouvez le sélectionner sur tous les systèmes, et il l'est par défaut
|
||||
si aucun pilote d'écran d'origine n'est disponible. Vous devez appliquer le
|
||||
correctif de <tt/screen/ que nous fournissons (voir le sous-répertoire
|
||||
<tt/Patches/ ). Du fait que screen doit être exécuté simultanément,
|
||||
l'utilisation de ce pilote rend BRLTTY opérationnel uniquement après que
|
||||
l'utilisateur s'est identifié.
|
||||
<tag/wn/
|
||||
Ce pilote fournit un accès direct à l'écran d'une console Windows.
|
||||
Il n'est sélectionnable et par défaut que sur les systèmes Windows/Cygwin.
|
||||
</descrip>
|
||||
@@ -0,0 +1,110 @@
|
||||
<sect>Syntaxe des opérateurs<p>
|
||||
|
||||
<sect1>Spécification de pilote<label id="operand-driver"><p>
|
||||
Vous devez spécifier un pilote pour un afficheur braille ou une synthèse vocale
|
||||
via les deux lettres de son
|
||||
<ref id="drivers" name="Code d'identification de pilote">.
|
||||
|
||||
Vous pouvez spécifier une liste de pilotes délimités par des virgules. Dans
|
||||
ce cas, une détection automatique s'effectue en utilisant chaque pilote listé dans la
|
||||
séquence.
|
||||
Il se peut que vous soyez obligé de faire des essais afin de déterminer l'ordre le plus
|
||||
fiable, étant donné que certains pilotes se détectent mieux automatiquement que d'autres.
|
||||
|
||||
Si vous ne spécifiez que le mot <tt>auto</tt>, la détection automatique s'effectue
|
||||
en n'utilisant que les pilotes connus pour leur fiabilité dans le but
|
||||
recherché.
|
||||
|
||||
<sect1>Spécification du périphérique braille<label id="operand-braille-device"><p>
|
||||
La forme générale de la spécification d'un périphérique braille (voir l'option
|
||||
<ref id="options-braille-device" name="-d"> en ligne de commande, la ligne
|
||||
<ref id="configure-braille-device" name="braille-device"> du fichier de
|
||||
configuration, et l'option de compilation
|
||||
<ref id="build-braille-device" name="--with-braille-device">) est
|
||||
<tt>qualificateur:</tt><em>donnée</em>.
|
||||
Par compatibilité entre d'anciennes versions et les plus récentes, si vous ommettez
|
||||
le qualificateur c'est <tt>serial:</tt> qui est utilisé.
|
||||
|
||||
Les types de périphérique suivants sont supportés:
|
||||
<descrip>
|
||||
<tag>Bluetooth</tag>
|
||||
Pour un périphérique bluetooth, spécifiez <tt>bluetooth:</tt><em>addresse</em>
|
||||
?vous pouvez aussi utiliser bt: et bluez: ).
|
||||
L'adresse doit se composer de six nombres hexadécimaux à deux chiffres
|
||||
séparés par des "deux-points", par exemple <tt>01:23:45:67:89:AB</tt>.
|
||||
<tag>Série</tag>
|
||||
Pour un périphérique en port série, spécifiez
|
||||
<tt>serial:</tt><em>/chemin/vers/peripherique</em>. Le qualificateur <tt>serial:</tt>
|
||||
est facultatif (pour compatibilité). Si vous donnez un chemin
|
||||
relatif, il est déterminé par rapport à <tt>/dev</tt> (l'emplacement habituel
|
||||
où les périphériques sont définis sur un système de type Unix).
|
||||
Les spécifications de périphérique suivantes se réfèrent toutes au port
|
||||
série 1 sur Linux:
|
||||
<itemize>
|
||||
<item><tt>serial:/dev/ttyS0</tt>
|
||||
<item><tt>serial:ttyS0</tt>
|
||||
<item><tt>/dev/ttyS0</tt>
|
||||
<item><tt>ttyS0</tt>
|
||||
</itemize>
|
||||
<tag>USB</tag>
|
||||
Pour un périphérique USB, spécifiez <tt>usb:</tt>. BRLTTY cherchera le premier
|
||||
périphérique USB qui entraîne l'utilisation du pilote d'afficheur braille.
|
||||
Par exemple, si vous avez plus d'un afficheur braille USB nécessitant le
|
||||
même pilote, vous pouvez affiner la spécification de pilote en y affectant
|
||||
le numéro de série de l'afficheur, comme par exemple <tt>usb:12345</tt>.
|
||||
N.B.: La possibilité "identification par le numéro de série" ne
|
||||
fonctionne pas avec certains modèles car certains fabricants, soit
|
||||
n'indiquent pas la description du numéro de série, soit l'indiquent
|
||||
mais pas en une valeur unique.
|
||||
</descrip>
|
||||
|
||||
Vous pouvez spécifier une liste de pilotes délimités par des virgules. Dans
|
||||
ce cas, une détection automatique s'effectue en utilisant chaque pilote listé dans la
|
||||
séquence. Cette possibilité est particulièrement utile si vous avez un
|
||||
afficheur braille à plusieurs interfaces, par exemple un port série et un USB.
|
||||
Dans ce cas, il est en général préférable de lister d'abord le port USB, comme
|
||||
par exemple <tt>usb:,serial:/dev/ttyS0</tt>, étant donné que l'ancien a
|
||||
tendance à être mieux détecté que le plus récent.
|
||||
|
||||
<sect1>Spécification d'un périphérique PCM<label id="operand-pcm-device"><p>
|
||||
Dans la plupart des cas, le périphériqve PCM est le chemin complet vers un
|
||||
périphérique du système approprié. Les exceptions sont:
|
||||
<descrip>
|
||||
<tag>ALSA</tag>
|
||||
Le nom et ses arguments pour le périphérique logique ou physique, comme
|
||||
<em>nom</em>[<tt>:</tt><em>argument</em><tt>,</tt>...].
|
||||
</descrip>
|
||||
|
||||
Le périphérique PCM par défaut est:
|
||||
<table loc="h">
|
||||
<tabular ca="ll">
|
||||
Plateforme|Périphérique@<hline>
|
||||
FreeBSD|/dev/dsp@
|
||||
Linux/ALSA|hw:0,0@
|
||||
Linux/OSS|/dev/dsp@
|
||||
NetBSD|/dev/audio@
|
||||
OpenBSD|/dev/audio@
|
||||
Qnx|le périphérique de sortie PCM préféré@
|
||||
Solaris|/dev/audio@
|
||||
</tabular>
|
||||
</table>
|
||||
|
||||
<sect1>Spécification de périphérique MIDI<label id="operand-midi-device"><p>
|
||||
Dans la plupart des cas, le périphérique MIDI est le chemin complet vers un
|
||||
périphérique du système approprié. Les exceptions sont:
|
||||
<descrip>
|
||||
<tag>ALSA</tag>
|
||||
Le client et le port séparés par "deux-points" tel que
|
||||
<em>client</em><tt>:</tt><em>port</em>.
|
||||
Vous pouvez spécifier chacun soit comme un nombre soit comme une
|
||||
sous-chaîne sensible à la casse de son nom.
|
||||
</descrip>
|
||||
|
||||
Le périphérique MIDI par défaut est:
|
||||
<table loc="h">
|
||||
<tabular ca="ll">
|
||||
Plateforme|Périphérique@<hline>
|
||||
Linux/ALSA|le premier port de sortie MIDI disponible@
|
||||
Linux/OSS|/dev/sequencer@
|
||||
</tabular>
|
||||
</table>
|
||||
@@ -0,0 +1,31 @@
|
||||
<sect>Synthèses vocales supportées<label id="synthesizers"><p>
|
||||
BRLTTY supporte les synthèses vocales suivantes:
|
||||
<table loc="h">
|
||||
<tabular ca="ll">
|
||||
Nom|Modèle@<hline>
|
||||
Alva
|
||||
|Delphi (4nn)@
|
||||
BrailleLite
|
||||
|@
|
||||
CombiBraille
|
||||
|@
|
||||
eSpeak
|
||||
|text to speech engine@
|
||||
ExternalSpeech
|
||||
|exécute /usr/local/bin/externalspeech@
|
||||
Festival
|
||||
|text to speech engine@
|
||||
FestivalLite
|
||||
|text to speech engine@
|
||||
GenericSay
|
||||
|redirige vers /usr/local/bin/say@
|
||||
Mikropuhe
|
||||
|text to speech engine@
|
||||
Swift
|
||||
|text to speech engine@
|
||||
Theta
|
||||
|text to speech engine@
|
||||
ViaVoice
|
||||
|text to speech engine@
|
||||
</tabular>
|
||||
</table>
|
||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,257 @@
|
||||
<sect>Table française unifiée<label id="nabcc"><p>
|
||||
<tscreen><verb>
|
||||
Num Hex Points Description
|
||||
+-------------------------------------------------------------------------+
|
||||
| 0 00 [ 32145 8] code nul |
|
||||
| 1 01 [73214 68] début de lecture |
|
||||
| 2 02 [ 21 5 8] début de texte |
|
||||
| 3 03 [ 3214 68] fin de texte |
|
||||
| 4 04 [7 145 8] fin de transmission |
|
||||
| 5 05 [ 1 5 8] ENQUIRY |
|
||||
| 6 06 [7 214 8] Connaissance |
|
||||
| 7 07 [ 2145 8] son (bell) |
|
||||
| 8 08 [7 21 5 8] effacement |
|
||||
| 9 09 [7 214 68] tabulation |
|
||||
| 10 0A [ 2 4568] LINE FEED (LF) |
|
||||
| 11 0B [ 3 1 8] tabulation |
|
||||
| 12 0C [7321 8] pied FORM FEED (FF) |
|
||||
| 13 0D [73 14 8] retour chariot |
|
||||
| 14 0E [ 3 145 8] SHIFT OUT |
|
||||
| 15 0F [ 32 68] SHIFT IN |
|
||||
| 16 10 [73214 8] échapper lien noir |
|
||||
| 17 11 [732145 8] contrôle de périphérique 1 |
|
||||
| 18 12 [7321 5 8] contrôle de périphérique 2 |
|
||||
| 19 13 [732 4 8] contrôle de périphérique 3 |
|
||||
| 20 14 [732 45 8] contrôle de périphérique 4 |
|
||||
| 21 15 [73 1 6 8] Connaissance négative |
|
||||
| 22 16 [7321 68] [SYNCHRONOUS IDLE] |
|
||||
| 23 17 [7 2 4568] fin du bloc de transmission |
|
||||
| 24 18 [73 14 68] annule | |
|
||||
| 25 19 [ 321 68] fin du milieu |
|
||||
| 26 1A [7 1 568] remplacer |
|
||||
| 27 1B [7 21 568] échappement |
|
||||
| 28 1C [7 14 68] séparateur 4 |
|
||||
| 29 1D [7 21 68] séparateur 3 |
|
||||
| 30 1E [732 5 ] séparateur 2 |
|
||||
| 31 1F [732 6 ] flèche droite |
|
||||
| 32 20 [ ] espace |
|
||||
| 33 21 [ 32 5 ] point d'exclamation |
|
||||
| 34 22 [ 32 56 ] guillemet |
|
||||
| 35 23 [ 3 4568] dièse |
|
||||
| 36 24 [73 5 ] dollar |
|
||||
| 37 25 [ 3 4 68] pour cent |
|
||||
| 38 26 [ 3214568] e commercial |
|
||||
| 39 27 [ 3 ] apostrophe |
|
||||
| 40 28 [ 32 6 ] parenthèse ouvrant |
|
||||
| 41 29 [ 3 56 ] parenthèse fermant |
|
||||
| 42 2A [ 3 5 ] astérisque (étoile) |
|
||||
| 43 2B [732 5 8] plus |
|
||||
| 44 2C [ 2 ] virgule | |
|
||||
| 45 2D [ 3 6 ] tiret |
|
||||
| 46 2E [ 2 56 ] point |
|
||||
| 47 2F [ 3 4 ] barre oblique |
|
||||
| 48 30 [ 3 456 ] zéro |
|
||||
| 49 31 [ 1 6 ] un |
|
||||
| 50 32 [ 21 6 ] deux |
|
||||
| 51 33 [ 14 6 ] trois |
|
||||
| 52 34 [ 1456 ] quatre |
|
||||
| 53 35 [ 1 56 ] cinq |
|
||||
| 54 36 [ 214 6 ] six |
|
||||
| 55 37 [ 21456 ] sept |
|
||||
| 56 38 [ 21 56 ] huit |
|
||||
| 57 39 [ 2 4 6 ] neuf |
|
||||
| 58 3A [ 2 5 ] deux-points |
|
||||
| 59 3B [ 32 ] inférieur |
|
||||
| 60 3C [ 32 8] inférieur |
|
||||
| 61 3D [732 568] égal |
|
||||
| 62 3E [7 56 ] supérieur |
|
||||
| 63 3F [ 2 6 ] point d'interrogation |
|
||||
| 64 40 [ 3 45 ] arrobas |
|
||||
| 65 41 [7 1 ] a majuscule |
|
||||
| 66 42 [7 21 ] b majuscule |
|
||||
| 67 43 [7 14 ] c majuscule |
|
||||
| 68 44 [7 145 ] d majuscule |
|
||||
| 69 45 [7 1 5 ] e majuscule |
|
||||
| 70 46 [7 214 ] f majuscule |
|
||||
| 71 47 [7 2145 ] g majuscule |
|
||||
| 72 48 [7 21 5 ] h majuscule |
|
||||
| 73 49 [7 2 4 ] i majuscule |
|
||||
| 74 4A [7 2 45 ] j majuscule |
|
||||
| 75 4B [73 1 ] k majuscule |
|
||||
| 76 4C [7321 ] l majuscule |
|
||||
| 77 4D [73 14 ] m majuscule |
|
||||
| 78 4E [73 145 ] n majuscule |
|
||||
| 79 4F [73 1 5 ] o majuscule |
|
||||
| 80 50 [73214 ] p majuscule |
|
||||
| 81 51 [732145 ] q majuscule |
|
||||
| 82 52 [7321 5 ] r majuscule |
|
||||
| 83 53 [732 4 ] s majuscule |
|
||||
| 84 54 [732 45 ] t majuscule |
|
||||
| 85 55 [73 1 6 ] u majuscule |
|
||||
| 86 56 [7321 6 ] v majuscule |
|
||||
| 87 57 [7 2 456 ] w majuscule |
|
||||
| 88 58 [73 14 6 ] x majuscule |
|
||||
| 89 59 [73 1456 ] y majuscule |
|
||||
| 90 5A [73 1 56 ] z majuscule |
|
||||
| 91 5B [732 68] crochet ouvrant |
|
||||
| 92 5C [ 3 4 8] barre oblique inversée |
|
||||
| 93 5D [73 568] crochet fermant |
|
||||
| 94 5E [ 4 ] accent circonflexe |
|
||||
| 95 5F [7 5 8] souligné |
|
||||
| 96 60 [ 6 ] accent grave |
|
||||
| 97 61 [ 1 ] a minuscule |
|
||||
| 98 62 [ 21 ] b minuscule |
|
||||
| 99 63 [ 14 ] c minuscule |
|
||||
| 100 64 [ 145 ] d minuscule |
|
||||
| 101 65 [ 1 5 ] e minuscule |
|
||||
| 102 66 [ 214 ] f minuscule |
|
||||
| 103 67 [ 2145 ] g minuscule |
|
||||
| 104 68 [ 21 5 ] h minuscule |
|
||||
| 105 69 [ 2 4 ] i minuscule |
|
||||
| 106 6A [ 2 45 ] j minuscule |
|
||||
| 107 6B [ 3 1 ] k minuscule |
|
||||
| 108 6C [ 321 ] l minuscule |
|
||||
| 109 6D [ 3 14 ] m minuscule |
|
||||
| 110 6E [ 3 145 ] n minuscule |
|
||||
| 111 6F [ 3 1 5 ] o minuscule |
|
||||
| 112 70 [ 3214 ] p minuscule |
|
||||
| 113 71 [ 32145 ] q minuscule |
|
||||
| 114 72 [ 321 5 ] r minuscule |
|
||||
| 115 73 [ 32 4 ] s minuscule |
|
||||
| 116 74 [ 32 45 ] t minuscule |
|
||||
| 117 75 [ 3 1 6 ] u minuscule |
|
||||
| 118 76 [ 321 6 ] v minuscule |
|
||||
| 119 77 [ 2 456 ] w minuscule |
|
||||
| 120 78 [ 3 14 6 ] x minuscule |
|
||||
| 121 79 [ 3 1456 ] y minuscule |
|
||||
| 122 7A [ 3 1 56 ] z minuscule |
|
||||
| 123 7B [732 8] ouvre accolade |
|
||||
| 124 7C [ 4568] barre verticale |
|
||||
| 125 7D [7 568] ferme accolade |
|
||||
| 126 7E [ 3 8] tilde minuscule |
|
||||
| 127 7F [ 321 8] effacement |
|
||||
| 128 20AC [7 1 5 8] euro |
|
||||
| 129 201A [7 6 ] guillemet bas simple |
|
||||
| 130 0192 [ 214 8] florin |
|
||||
| 131 201E [ 56 ] guillemet bas double |
|
||||
| 132 2026 [ 3 68] points de suspension |
|
||||
| 133 2020 [ 3 568] obel |
|
||||
| 134 2021 [73 56 ] double obel |
|
||||
| 135 2C6 [ 4 8] circonflexe minuscule |
|
||||
| 136 2030 [73 4 68] pour mille |
|
||||
| 137 0160 [732 4 68] s carron majuscule |
|
||||
| 138 2039 [7 5 ] guillemet fermant |
|
||||
| 139 0152 [7 2 4 6 ] e dans o majuscule |
|
||||
| 140 017D [73 1 568] z carron majuscule |
|
||||
| 141 2018 [ 68] guillemet simple ouvrant |
|
||||
| 142 2019 [73 ] guillemet simple fermant |
|
||||
| 143 201C [73 8] guillemet double ouvrant |
|
||||
| 144 201D [7 68] guillemett double fermant |
|
||||
| 145 2022 [7 2145 8] puce |
|
||||
| 146 2013 [7 4 8] tiret cadre atteint |
|
||||
| 147 2014 [7 45 8] tiret EM |
|
||||
| 148 02DC [7 4 6 ] tilde minuscule |
|
||||
| 149 2122 [ 32 45 8] marque déposée |
|
||||
| 150 0161 [ 32 4 68] s avec carron minuscule |
|
||||
| 151 203A [ 5 8] guillemet ouvrant |
|
||||
| 152 0153 [ 2 4 68] e dans o minuscule |
|
||||
| 153 017E [73 1 568] z carron minuscule |
|
||||
| 154 0178 [7 14568] y tréma majuscule |
|
||||
| 160 A0 [7 ] espace insécable (forcé) |
|
||||
| 161 A1 [ 32 5 8] point d'exclamation inversé |
|
||||
| 162 A2 [7 14 8] cent |
|
||||
| 163 A3 [732 ] livre |
|
||||
| 164 A4 [ 45 ] devise |
|
||||
| 165 A5 [7 2 568] yen |
|
||||
| 166 A6 [ 45 8] trait coupé vertical |
|
||||
| 167 A7 [ 3214 8] paragraphe |
|
||||
| 168 A8 [ 4 6 ] tréma |
|
||||
| 169 A9 [ 14 8] copyright |
|
||||
| 170 AA [7 1 68] ordinal féminin |
|
||||
| 171 AB [ 32 568] guillemet français ouvrant |
|
||||
| 172 AC [7 2 56 ] négation logique |
|
||||
| 173 AD [7 8] trait d'union conditionne |
|
||||
| 174 AE [ 321 5 8] marque déposée |
|
||||
| 175 AF [ 3 14 8] macron |
|
||||
| 176 B0 [7 2 6 ] degré |
|
||||
| 177 B1 [73 68] plus ou moins |
|
||||
| 178 B2 [7 45 ] carré (puissance 2) |
|
||||
| 179 B3 [7 456 ] cube (puissance 3) |
|
||||
| 180 B4 [ 5 ] accent aigu |
|
||||
| 181 B5 [7 2 5 ] micro |
|
||||
| 182 B6 [7 4568] pied de mouche |
|
||||
| 183 B7 [ 8] point médiant |
|
||||
| 184 B8 [ 456 ] cédille |
|
||||
| 185 B9 [7 4 ] exposant |
|
||||
| 186 BA [7 2 68] ordinal masculin |
|
||||
| 187 BB [732 56 ] guillemetts français fermant |
|
||||
| 188 BC [ 3 1 68] un quart |
|
||||
| 189 BD [ 4 68] un demi |
|
||||
| 190 BE [ 3 14 68] trois quart |
|
||||
| 191 BF [ 2 68] point d'interrogation inversé |
|
||||
| 192 C0 [7321 56 ] a grave majuscule |
|
||||
| 193 C1 [7321 568] a aigu majuscule |
|
||||
| 194 C2 [7 1 6 ] a circonflexe majuscule |
|
||||
| 195 C3 [7 1 8] a tilde majuscule |
|
||||
| 196 C4 [73 456 ] a tréma majuscule |
|
||||
| 197 C5 [7 2 ] a avec rond au-dessus majuscule |
|
||||
| 198 C6 [73 45 ] a e majuscule |
|
||||
| 199 C7 [73214 6 ] c cédille majuscule |
|
||||
| 200 C8 [732 4 6 ] e grave majuscule |
|
||||
| 201 C9 [7321456 ] e aigu majuscule |
|
||||
| 202 CA [7 21 6 ] e circonflexe majuscule |
|
||||
| 203 CB [7 214 6 ] e tréma majuscule |
|
||||
| 204 CC [7 2 4 8] i grave majuscule |
|
||||
| 205 CD [73 4 ] i aigu majuscule |
|
||||
| 206 CE [7 14 6 ] i circonflexe majuscule |
|
||||
| 207 CF [7 21456 ] i tréma majuscule |
|
||||
| 208 D0 [7 21 8] Eth majuscule |
|
||||
| 209 D1 [73 145 8] n tilde majuscule |
|
||||
| 210 D2 [73 1 5 8] o grave majuscule |
|
||||
| 211 D3 [73 4 6 ] o aigu majuscule |
|
||||
| 212 D4 [73 1456 ] o circonflexe majuscule |
|
||||
| 213 D5 [73 1 8] o tilde majuscule |
|
||||
| 214 D6 [7 2 4 68] o tréma majuscule |
|
||||
| 215 D7 [73 5 8] multipilé par |
|
||||
| 216 D8 [73 4568] o barré majuscule |
|
||||
| 217 D9 [732 456 ] u grave majuscule |
|
||||
| 218 DA [732 4568] u aigu majuscule |
|
||||
| 219 DB [7 1 56 ] u circonflexe majuscule |
|
||||
| 220 DC [7 21 56 ] u tréma majuscule |
|
||||
| 221 DD [73 14568] y aigu majuscule |
|
||||
| 222 DE [ 2 45 8] Thorn majuscule |
|
||||
| 223 DF [ 32 4 8] szeth |
|
||||
| 224 E0 [ 321 56 ] a grave minuscule |
|
||||
| 225 E1 [ 321 568] a aigu minuscule |
|
||||
| 226 E2 [ 1 68] a circonflexe minuscule |
|
||||
| 227 E3 [ 1 8] a qilde minuscule |
|
||||
| 228 E4 [73 45 8] a tréma minuscule |
|
||||
| 229 E5 [ 2 8] a avec rond en tête minuscule |
|
||||
| 230 E6 [ 3 45 8] a e minuscule |
|
||||
| 231 E7 [ 3214 6 ] c cédille minuscule |
|
||||
| 232 E8 [ 32 4 6 ] e grave minuscule |
|
||||
| 233 E9 [ 321456 ] e aigu minuscule |
|
||||
| 234 EA [ 21 68] e circonflexe minuscule |
|
||||
| 235 EB [ 214 68] e tréma minuscule |
|
||||
| 236 EC [ 2 4 8] i grave minuscule |
|
||||
| 237 ED [73 4 8] i aigu minuscule |
|
||||
| 238 EE [ 14 68] i circonflexe minuscule |
|
||||
| 239 EF [ 214568] i tréma minuscule |
|
||||
| 240 F0 [ 21 8] Eth minuscule |
|
||||
| 241 F1 [7 214568] n tilde minuscule |
|
||||
| 242 F2 [ 3 1 5 8] o grave minuscule |
|
||||
| 243 F3 [ 3 4 6 ] o aigu minuscule |
|
||||
| 244 F4 [ 14568] o circonflexe minuscule |
|
||||
| 245 F5 [7 4 68] o tilde minuscule |
|
||||
| 246 F6 [ 3 5 8] o tréma minuscule |
|
||||
| 247 F7 [7 2 5 8] divisé par |
|
||||
| 248 F8 [ 568] o barré minuscule |
|
||||
| 249 F9 [ 32 456 ] u grave minuscule |
|
||||
| 250 FA [ 32 4568] u aigu minuscule |
|
||||
| 251 FB [ 1 568] u circonflexe minuscule |
|
||||
| 252 FC [ 21 568] u tréma minuscule |
|
||||
| 253 FD [ 3 14568] y aigu minuscule |
|
||||
| 254 FE [ 2 45 8] thorn minuscule |
|
||||
| 255 FF [ 2 568] y tréma minuscule |
|
||||
+-------------------------------------------------------------------------+
|
||||
</verb></tscreen>
|
||||
@@ -0,0 +1,262 @@
|
||||
<sect>Code informatique braille Nord Américain<label id="nabcc"><p>
|
||||
<tscreen><verb>
|
||||
Num Hex Points Description
|
||||
+-----------------------------------------------------------------+
|
||||
| 0 00 [7 4 8] NUL (null) |
|
||||
| 1 01 [7 1 8] SOH (start of header) |
|
||||
| 2 02 [7 21 8] STX (start of text) |
|
||||
| 3 03 [7 14 8] ETX (end of text) |
|
||||
| 4 04 [7 145 8] EOT (end of transmission) |
|
||||
| 5 05 [7 1 5 8] ENQ (enquiry) |
|
||||
| 6 06 [7 214 8] ACK (acknowledge) |
|
||||
| 7 07 [7 2145 8] BEL (bell) |
|
||||
| 8 08 [7 21 5 8] BS (back space) |
|
||||
| 9 09 [7 2 4 8] HT (horizontal tab) |
|
||||
| 10 0A [7 2 45 8] LF (line feed) |
|
||||
| 11 0B [73 1 8] VT (vertical tab) |
|
||||
| 12 0C [7321 8] FF (form feed) |
|
||||
| 13 0D [73 14 8] CR (carriage return) |
|
||||
| 14 0E [73 145 8] SO (shift out) |
|
||||
| 15 0F [73 1 5 8] SI (shift in) |
|
||||
| 16 10 [73214 8] DLE (data link escape) |
|
||||
| 17 11 [732145 8] DC1 (direct control 1) |
|
||||
| 18 12 [7321 5 8] DC2 (direct control 2) |
|
||||
| 19 13 [732 4 8] DC3 (direct control 3) |
|
||||
| 20 14 [732 45 8] DC4 (direct control 4) |
|
||||
| 21 15 [73 1 68] NAK (negative acknowledge) |
|
||||
| 22 16 [7321 68] SYN (synchronize) |
|
||||
| 23 17 [7 2 4568] ETB (end of text block) |
|
||||
| 24 18 [73 14 68] CAN (cancel) |
|
||||
| 25 19 [73 14568] EM (end of medium) |
|
||||
| 26 1A [73 1 568] SUB (substitute) |
|
||||
| 27 1B [7 2 4 68] ESC (escape) |
|
||||
| 28 1C [7 21 568] FS (file separator) |
|
||||
| 29 1D [7 214568] GS (group separator) |
|
||||
| 30 1E [7 45 8] RS (record separator) |
|
||||
| 31 1F [7 4568] US (unit separator) |
|
||||
| 32 20 [ ] space |
|
||||
| 33 21 [ 32 4 6 ] exclamation point |
|
||||
| 34 22 [ 5 ] quotation mark |
|
||||
| 35 23 [ 3 456 ] number sign |
|
||||
| 36 24 [ 214 6 ] signe dollar |
|
||||
| 37 25 [ 14 6 ] signe pour cent |
|
||||
| 38 26 [ 3214 6 ] ampersand |
|
||||
| 39 27 [ 3 ] accent aigu |
|
||||
| 40 28 [ 321 56 ] left parenthesis |
|
||||
| 4 291 [ 32 456 ) right parenthesis |
|
||||
| 42 2A [ 1 6 ] asterisk |
|
||||
| 43 2B [ 3 4 6 ] plus sign |
|
||||
| 44 2C [ 6 ] comma |
|
||||
| 45 2D [ 3 6 ] minus sign |
|
||||
| 46 2E [ 4 6 ] period |
|
||||
| 47 2F [ 3 4 ] forward slash |
|
||||
| 48 30 [ 3 56 ] zero |
|
||||
| 49 31 [ 2 ] one |
|
||||
| 50 32 [ 32 ] two |
|
||||
| 51 33 [ 2 5 ] three |
|
||||
| 52 34 [ 2 56 ] four |
|
||||
| 53 35 [ 2 6 ] five |
|
||||
| 54 36 [ 32 5 ] six |
|
||||
| 55 37 [ 32 56 ] seven |
|
||||
| 56 38 [ 32 6 ] eight |
|
||||
| 57 39 [ 3 5 ] nine |
|
||||
| 58 3A [ 1 56 ] colon |
|
||||
| 59 3B [ 56 ] semicolon |
|
||||
| 60 3C [ 21 6 ] less-than sign |
|
||||
| 61 3D [ 321456 ] equals sign |
|
||||
| 62 3E [ 3 45 ] greater-than sign |
|
||||
| 63 3F [ 1456 ] question mark |
|
||||
| 64 40 [7 4 ] commercial at |
|
||||
| 65 41 [7 1 ] capital a |
|
||||
| 66 42 [7 21 ] capital b |
|
||||
| 67 43 [7 14 ] capital c |
|
||||
| 68 44 [7 145 ] capital d |
|
||||
| 69 45 [7 1 5 ] capital e |
|
||||
| 70 46 [7 214 ] capital f |
|
||||
| 71 47 [7 2145 ] capital g |
|
||||
| 72 48 [7 21 5 ] capital h |
|
||||
| 73 49 [7 2 4 ] capital i |
|
||||
| 74 4A [7 2 45 ] capital j |
|
||||
| 75 4B [73 1 ] capital k |
|
||||
| 76 4C [7321 ] capital l |
|
||||
| 77 4D [73 14 ] capital m |
|
||||
| 78 4E [73 145 ] capital n |
|
||||
| 79 4F [73 1 5 ] capital o |
|
||||
| 80 50 [73214 ] capital p |
|
||||
| 81 51 [732145 ] capital q |
|
||||
| 82 52 [7321 5 ] capital r |
|
||||
| 83 53 [732 4 ] capital s |
|
||||
| 84 54 [732 45 ] capital t |
|
||||
| 85 55 [73 1 6 ] capital u |
|
||||
| 86 56 [7321 6 ] capital v |
|
||||
| 87 57 [7 2 456 ] capital w |
|
||||
| 88 58 [73 14 6 ] capital x |
|
||||
| 89 59 [73 1456 ] capital y |
|
||||
| 90 5A [73 1 56 ] capital z |
|
||||
| 91 5B [7 2 4 6 ] left bracket |
|
||||
| 92 5C [7 21 56 ] backward slash |
|
||||
| 93 5D [7 21456 ] right bracket |
|
||||
| 94 5E [7 45 ] circumflex accent |
|
||||
| 95 5F [ 456 ] underscore |
|
||||
| 96 60 [ 4 ] grave accent |
|
||||
| 97 61 [ 1 ] small a |
|
||||
| 98 62 [ 21 ] small b |
|
||||
| 99 63 [ 14 ] small c |
|
||||
| 100 64 [ 145 ] small d |
|
||||
| 101 65 [ 1 5 ] small e |
|
||||
| 102 66 [ 214 ] small f |
|
||||
| 103 67 [ 2145 ] small g |
|
||||
| 104 68 [ 21 5 ] small h |
|
||||
| 105 69 [ 2 4 ] small i |
|
||||
| 106 6A [ 2 45 ] small j |
|
||||
| 107 6B [ 3 1 ] small k |
|
||||
| 108 6C [ 321 ] small l |
|
||||
| 109 6D [ 3 14 ] small m |
|
||||
| 110 6E [ 3 145 ] small n |
|
||||
| 111 6F [ 3 1 5 ] small o |
|
||||
| 112 70 [ 3214 ] small p |
|
||||
| 113 71 [ 32145 ] small q |
|
||||
| 114 72 [ 321 5 ] small r |
|
||||
| 115 73 [ 32 4 ] small s |
|
||||
| 116 74 [ 32 45 ] small t |
|
||||
| 117 75 [ 3 1 6 ] small u |
|
||||
| 118 76 [ 321 6 ] small v |
|
||||
| 119 77 [ 2 456 ] small w |
|
||||
| 120 78 [ 3 14 6 ] small x |
|
||||
| 121 79 [ 3 1456 ] small y |
|
||||
| 122 7A [ 3 1 56 ] small z |
|
||||
| 123 7B [ 2 4 6 ] left brace |
|
||||
| 124 7C [ 21 56 ] vertical bar |
|
||||
| 125 7D [ 21456 ] right brace |
|
||||
| 126 7E [ 45 ] tilde accent |
|
||||
| 127 7F [7 456 ] DEL (delete) |
|
||||
| 128 80 [ 4 8] <control> |
|
||||
| 129 81 [ 1 8] <control> |
|
||||
| 130 82 [ 21 8] BPH (break permitted here) |
|
||||
| 131 83 [ 14 8] NBH (no break here) |
|
||||
| 132 84 [ 145 8] <control> |
|
||||
| 133 85 [ 1 5 8] NL (next line) |
|
||||
| 134 86 [ 214 8] SSA (start of selected area) |
|
||||
| 135 87 [ 2145 8] ESA (end of selected area) |
|
||||
| 136 88 [ 21 5 8] CTS (character tabulation set) |
|
||||
| 137 89 [ 2 4 8] CTJ (character tabulation justification) |
|
||||
| 138 8A [ 2 45 8] LTS (line tabulation set) |
|
||||
| 139 8B [ 3 1 8] PLD (partial line down) |
|
||||
| 140 8C [ 321 8] PLU (partial line up) |
|
||||
| 141 8D [ 3 14 8] RLF (reverse line feed) |
|
||||
| 142 8E [ 3 145 8] SS2 (single shift two) |
|
||||
| 143 8F [ 3 1 5 8] SS3 (single shift three) |
|
||||
| 144 90 [ 3214 8] DCS (device control string) |
|
||||
| 145 91 [ 32145 8] PU1 (private use one) |
|
||||
| 146 92 [ 321 5 8] PU2 (private use two) |
|
||||
| 147 93 [ 32 4 8] STS (set transmit state) |
|
||||
| 148 94 [ 32 45 8] CC (cancel character) |
|
||||
| 149 95 [ 3 1 68] MW (message waiting) |
|
||||
| 150 96 [ 321 68] SGA (start of guarded area) |
|
||||
| 151 97 [ 2 4568] EGA (end of guarded area) |
|
||||
| 152 98 [ 3 14 68] SS (start of string) |
|
||||
| 153 99 [ 3 14568] <control> |
|
||||
| 154 9A [ 3 1 568] SCI (single character introducer) |
|
||||
| 155 9B [ 2 4 68] CSI (control sequence introducer) |
|
||||
| 156 9C [ 21 568] ST (string terminator) |
|
||||
| 157 9D [ 214568] OSC (operating system command) |
|
||||
| 158 9E [ 45 8] PM (privacy message) |
|
||||
| 159 9F [ 4568] APC (application program command) |
|
||||
| 160 A0 [7 8] no-break space |
|
||||
| 161 A1 [732 4 6 ] inverted exclamation mark |
|
||||
| 162 A2 [7 214 6 ] cent sign |
|
||||
| 163 A3 [73 456 ] pound sign |
|
||||
| 164 A4 [7 14 6 ] currency sign |
|
||||
| 165 A5 [73214 6 ] yen sign |
|
||||
| 166 A6 [7 1 56 ] broken bar |
|
||||
| 167 A7 [73 5 ] section sign |
|
||||
| 168 A8 [7 5 ] diaeresis |
|
||||
| 169 A9 [732 56 ] copyright sign |
|
||||
| 170 AA [ 8] feminine ordinal indicator |
|
||||
| 171 AB [7 21 6 ] left-pointing double angle quotation mark |
|
||||
| 172 AC [7 2 56 ] not sign |
|
||||
| 173 AD [73 6 ] soft hyphen |
|
||||
| 174 AE [732 6 ] registered sign |
|
||||
| 175 AF [7 2 6 ] macron |
|
||||
| 176 B0 [73 56 ] degree sign |
|
||||
| 177 B1 [73 4 6 ] plus-minus sign |
|
||||
| 178 B2 [732 ] superscript two |
|
||||
| 179 B3 [7 2 5 ] superscript three |
|
||||
| 180 B4 [73 ] acute accent |
|
||||
| 181 B5 [7 56 ] micro sign |
|
||||
| 182 B6 [732 5 ] pilcrow sign |
|
||||
| 183 B7 [7 4 6 ] middle dot |
|
||||
| 184 B8 [7 6 ] cedilla |
|
||||
| 185 B9 [7 2 ] superscript one |
|
||||
| 186 BA [7 ] masculine ordinal indicator |
|
||||
| 187 BB [73 45 ] right-pointing double angle quotation mark |
|
||||
| 188 BC [7321 56 ] vulgar fraction one quarter |
|
||||
| 189 BD [7321456 ] vulgar fraction one half |
|
||||
| 190 BE [732 456 ] vulgar fraction three quarters |
|
||||
| 191 BF [7 1456 ] inverted question mark |
|
||||
| 192 C0 [732 5 8] capital a grave |
|
||||
| 193 C1 [7 1 68] capital a acute |
|
||||
| 194 C2 [7 2 8] capital a circumflex |
|
||||
| 195 C3 [7 5 8] capital a tilde |
|
||||
| 196 C4 [73214 68] capital a diaeresis |
|
||||
| 197 C5 [73 45 8] capital a ring above |
|
||||
| 198 C6 [73 8] capital ae |
|
||||
| 199 C7 [73 4 68] capital c cedilla |
|
||||
| 200 C8 [732 568] capital e grave |
|
||||
| 201 C9 [7 21 68] capital e acute |
|
||||
| 202 CA [732 8] capital e circumflex |
|
||||
| 203 CB [73214568] capital e diaeresis |
|
||||
| 204 CC [732 68] capital i grave |
|
||||
| 205 CD [7 14 68] capital i acute |
|
||||
| 206 CE [7 2 5 8] capital i circumflex |
|
||||
| 207 CF [7321 568] capital i diaeresis |
|
||||
| 208 D0 [7 68] capital eth |
|
||||
| 209 D1 [7 4 68] capital n tilde |
|
||||
| 210 D2 [73 5 8] capital o grave |
|
||||
| 211 D3 [7 14568] capital o acute |
|
||||
| 212 D4 [7 2 568] capital o circumflex |
|
||||
| 213 D5 [7 568] capital o tilde |
|
||||
| 214 D6 [732 4 68] capital o diaeresis |
|
||||
| 215 D7 [7 1 6 ] multiplication sign |
|
||||
| 216 D8 [73 4 8] capital o stroke |
|
||||
| 217 D9 [73 568] capital u grave |
|
||||
| 218 DA [7 1 568] capital u acute |
|
||||
| 219 DB [7 2 68] capital u circumflex |
|
||||
| 220 DC [732 4568] capital u diaeresis |
|
||||
| 221 DD [7 214 68] capital y acute |
|
||||
| 222 DE [73 68] capital thorn |
|
||||
| 223 DF [73 4568] small sharp s |
|
||||
| 224 E0 [ 32 5 8] small a grave |
|
||||
| 225 E1 [ 1 68] small a acute |
|
||||
| 226 E2 [ 2 8] small a circumflex |
|
||||
| 227 E3 [ 5 8] small a tilde |
|
||||
| 228 E4 [ 3214 68] small a diaeresis |
|
||||
| 229 E5 [ 3 45 8] small a ring above |
|
||||
| 230 E6 [ 3 8] small ae |
|
||||
| 231 E7 [ 3 4 68] small c cedilla |
|
||||
| 232 E8 [ 32 568] small e grave |
|
||||
| 233 E9 [ 21 68] small e acute |
|
||||
| 234 EA [ 32 8] small e circumflex |
|
||||
| 235 EB [ 3214568] small e diaeresis |
|
||||
| 236 EC [ 32 68] small i grave |
|
||||
| 237 ED [ 14 68] small i acute |
|
||||
| 238 EE [ 2 5 8] small i circumflex |
|
||||
| 239 EF [ 321 568] small i diaeresis |
|
||||
| 240 F0 [ 68] small eth |
|
||||
| 241 F1 [ 4 68] small n tilde |
|
||||
| 242 F2 [ 3 5 8] small o grave |
|
||||
| 243 F3 [ 14568] small o acute |
|
||||
| 244 F4 [ 2 568] small o circumflex |
|
||||
| 245 F5 [ 568] small o tilde |
|
||||
| 246 F6 [ 32 4 68] small o diaeresis |
|
||||
| 247 F7 [73 4 ] division sign |
|
||||
| 248 F8 [ 3 4 8] small o stroke |
|
||||
| 249 F9 [ 3 568] small u grave |
|
||||
| 250 FA [ 1 568] small u acute |
|
||||
| 251 FB [ 2 68] small u circumflex |
|
||||
| 252 FC [ 32 4568] small u diaeresis |
|
||||
| 253 FD [ 214 68] small y acute |
|
||||
| 254 FE [ 3 68] small thorn |
|
||||
| 255 FF [ 3 4568] small y diaeresis |
|
||||
+-----------------------------------------------------------------+
|
||||
</verb></tscreen>
|
||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,69 @@
|
||||
Pairing a Bluetooth Device on Linux
|
||||
===================================
|
||||
|
||||
You need to "pair" your device with the host on which you wish to use it. You
|
||||
can pair a device with more than one host, but you can usually only use it with
|
||||
one host at a time.
|
||||
|
||||
Pairing a Bluetooth device on Linux is relatively easy if you're comfortable
|
||||
working within the graphical (X) environment. All you need to do is to run
|
||||
"bluetooth-applet" and follow the steps it presents to you. It's a little
|
||||
trickier to pair a Bluetooth device via the command line, but it can be done.
|
||||
One way to do it is as follows:
|
||||
|
||||
You need to find out your host's Bluetooth Device Address (referred to later in
|
||||
this document as <host-address>). To do this, run the command "hciconfig hci0".
|
||||
Look for the (indented) line which begins with "BD Address:". The very next
|
||||
"word" on that line is your host's Bluetooth Device Address. It'll be six
|
||||
two-digit hexadecimal numbers separated by colons (:). Examples in this
|
||||
document use the value "01:23:45:67:89:AB".
|
||||
|
||||
You need to find out your device's Bluetooth Device Address (referred to later
|
||||
in this document as <device-address>). To do this, run the command "hcitool
|
||||
scan". This command can take a while to complete as it gives devices a fair bit
|
||||
of time to respond. Each device which responds creates one two-column output
|
||||
line. The first column is its Bluetooth Device Address (examples in this
|
||||
document use the value "12:34:56:78:9A:BC"), and the second column is its
|
||||
current name. Manufacturers usually set a device's initial name to its product
|
||||
name and model number so that it's easy to spot within the scan output. If your
|
||||
device allows you to change its name, it's okay to do so even after you've
|
||||
paired it.
|
||||
|
||||
A device needs to be "visible" in order for the scan to find it. Most devices
|
||||
are "invisible" by default, but have a way to be made temporarily visible. You
|
||||
should check your device's manual to find out how to do this. In many cases
|
||||
there's either a button which needs to be pressed or a menu item which needs to
|
||||
be selected. Since both the device's temporary visibility and the host's scan
|
||||
time out, Make your device visible just before you initiate the scan.
|
||||
|
||||
You need to know what PIN (password) your device is expecting. Your device's
|
||||
documentation should contain this information. Many devices allow you to set
|
||||
the PIN, in which case they'll have a menu which allows you to do this.
|
||||
Examples in this document use the value "1234".
|
||||
|
||||
Go into the directory "/var/lib/bluetooth/<host-address>. In there (create if
|
||||
necessary) is the file "pincodes". Each line in this file associates a device
|
||||
with its PIN. It has two fields separated by space. The first field is the
|
||||
device's Bluetooth Device Address and the second field is its PIN. The
|
||||
Bluetooth Device Address must be in uppercase. For example:
|
||||
|
||||
cat /var/lib/bluetooth/01:23:45:67:89:AB/pincodes
|
||||
12:34:56:78:9A:BC 1234
|
||||
|
||||
|
||||
Using a Bluetooth Device with BRLTTY
|
||||
====================================
|
||||
|
||||
After your device has been paired with your host, it's ready to be used by
|
||||
BRLTTY. You can tell BRLTTY to use your Bluetooth device either via the -d (or
|
||||
--braille-device=) command line option or via the braille-device line in the
|
||||
file "/etc/brltty.conf". The device should be specified as the word
|
||||
"bluetooth", a colon (:), and the device's Bluetooth Device Address. For
|
||||
example:
|
||||
|
||||
brltty -d bluetooth:12:34:56:78:9A:BC
|
||||
or
|
||||
cat /etc/brltty.conf
|
||||
braille-device bluetooth:12:34:56:78:9A:BC
|
||||
|
||||
|
||||
@@ -0,0 +1,45 @@
|
||||
Serial Support
|
||||
--------------
|
||||
|
||||
The default DOS serial driver does not support speeds above 9600 baud. For
|
||||
higher speeds a more capable serial driver (like ADF) must be used.
|
||||
|
||||
|
||||
USB Support
|
||||
-----------
|
||||
|
||||
USB is not supported.
|
||||
|
||||
|
||||
Bluetooth Support
|
||||
-----------------
|
||||
|
||||
Bluetooth is not supported.
|
||||
|
||||
|
||||
Compilation
|
||||
-----------
|
||||
|
||||
The MSDOS version can be compiled thanks to a cross-compiler. Get the following
|
||||
archives:
|
||||
|
||||
ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/gcc410s2.zip
|
||||
ftp://ftp.delorie.com/pub/djgpp/current/v2/djcrx203.zip
|
||||
|
||||
The djcrx203.zip archive contains a file named cross/howto.32 which explains
|
||||
how to build a cross-compiler for gcc 3.2. You can build one for gcc 4.1 by
|
||||
applying the same instructions to the gcc410s2.zip archive (listed above)
|
||||
instead of to the gcc32s2.zip archive (mentioned in the howto). You can also
|
||||
use a more recent binutils package too (2.16.91 works fine).
|
||||
|
||||
You can use the cross-compiler with the following ./configure command:
|
||||
|
||||
CC_FOR_BUILD=gcc LD=i586-pc-msdosdjgpp-ld ./configure \
|
||||
--prefix=/brltty-msdos \
|
||||
--host=i586-pc-msdosdjgpp --target=i586-pc-msdosdjgpp \
|
||||
--build=x86_64-unknown-linux-gnu \
|
||||
--disable-api --disable-icu --without-speechd \
|
||||
--disable-x --without-usb-package --without-bluetooth-package \
|
||||
--with-braille-driver=-vr,all --without-libbraille \
|
||||
--with-speech-driver=all --without-espeak --without-flite \
|
||||
--with-screen-driver=pb,-all
|
||||
@@ -0,0 +1,87 @@
|
||||
Setting up BRLTTY on OpenBSD
|
||||
----------------------------
|
||||
|
||||
This document describes how to get BRLTTY working on a
|
||||
recent OpenBSD system. It assumes that you are working with a recent OpenBSD
|
||||
installation (3.4).
|
||||
|
||||
1. Patching "screen"
|
||||
--------------------
|
||||
|
||||
Since OpenBSD (and in fact all the other BSDs) do not
|
||||
have a way for user-space applications to access the current text/attribute
|
||||
content of the virtual consoles, we have to use "screen" to make
|
||||
this information available to BRLTTY. This also means that
|
||||
you can not use BRLTTY with the *BSD virtual consoles directly, you
|
||||
have to start "screen" first on some virtual terminal to be able
|
||||
to use BRLTTY.
|
||||
|
||||
You need to patch "screen" to enable the IPC_SHARED_IMAGE functionality
|
||||
which BRLTTY relies on. Assuming your ports tree is in /usr/ports,
|
||||
you will need to copy the appropriate patch from
|
||||
brltty/Patches into /usr/ports/misc/screen/patches.
|
||||
|
||||
OpenBSD 3.4 comes with screen-4.0.1. You can
|
||||
check the screen version by reading /usr/ports/misc/screen/Makefile.
|
||||
|
||||
The patch file should be named with the prefix "patch-" so that the
|
||||
screen build process will find it.
|
||||
|
||||
Now change into /usr/ports/misc/screen and run
|
||||
|
||||
$ make
|
||||
|
||||
followed by
|
||||
|
||||
$ sudo make install
|
||||
|
||||
If you successfully managed to compile and install the
|
||||
screen package, you can proceed to building BRLTTY.
|
||||
|
||||
There is a simple test you can use to verify if your screen
|
||||
installation does support the IPC_SHARED_IMAGE feature. Start "screen" and
|
||||
execute the command
|
||||
|
||||
# ipcs -m
|
||||
Shared Memory:
|
||||
T ID KEY MODE OWNER GROUP
|
||||
m 65536 -1160968401 --rwa------ root root
|
||||
|
||||
If you see output which looks roughly like the above,
|
||||
screen seems to be compiled with the IPC_SHARED_IMAGE feature.
|
||||
|
||||
Note that proper integration of the IPC_SHARED_IMAGE functionality
|
||||
via an additional FLAVOR for the screen port has recently been submitted
|
||||
to the OpenBSD ports mailing list. If you are working with the CVS ports
|
||||
tree, it might be worthwhile checking if the shm flavor already has
|
||||
been checked in by invoking the following command in /usr/ports/misc/screen:
|
||||
|
||||
$ make show=FLAVORS
|
||||
|
||||
If you see "shm" listed as a possible flavor to choose, simply
|
||||
build screen with the FLAVOR environment variable set to shm, and do not
|
||||
bother copying the patch from BRLTTY sources.
|
||||
|
||||
2. Compiling BRLTTY
|
||||
-------------------
|
||||
|
||||
To compile BRLTTY, you do the following:
|
||||
|
||||
$ ./configure
|
||||
$ gmake
|
||||
$ sudo gmake install
|
||||
|
||||
Note that 'gmake' needs to be used to avoid a problem
|
||||
related to BSD and GNU Make incompatibilities.
|
||||
|
||||
3. Running BRLTTY
|
||||
-----------------
|
||||
|
||||
You need to have "screen" started before you try to run
|
||||
BRLTTY. Inside screen, simply invoke BRLTTY as you would on
|
||||
other systems. Note that the first serial port is /dev/cua00.
|
||||
So a typical invocation could look like this:
|
||||
|
||||
# brltty -b ts -d /dev/cua00
|
||||
|
||||
-- Mario Lang <mlang@delysid.org>
|
||||
@@ -0,0 +1,303 @@
|
||||
System Requirements
|
||||
===================
|
||||
|
||||
The earliest release of Windows which is supported by BRLTTY is Windows 98.
|
||||
|
||||
Pre-built versions of brltty are available for download on
|
||||
http://mielke.cc/brltty or on http://youpibouh.thefreecat.org/brltty/
|
||||
|
||||
In order to build BRLTTY yourself from a supplied tarball, you
|
||||
need either Cygwin (see [http://www.cygwin.com/]) or MinGW (see
|
||||
[http://mingw.sourceforge.net/]). In both cases, you also need the following
|
||||
additional packages:
|
||||
* gcc
|
||||
* make
|
||||
* w32api (version 3.6 or later)
|
||||
|
||||
If you'd like to build BRLTTY from its source repository rather than from one
|
||||
of the supplied tarballs then you'll also need these additional packages:
|
||||
* autoconf
|
||||
* tcltk
|
||||
|
||||
If you'd like to prepare the documentation (do make within the Documents/
|
||||
subdirectory) you'll need these packages:
|
||||
* linuxdoc-tools (not pre-packaged in cygwin unfortunately)
|
||||
* doxygen
|
||||
|
||||
If you are using MSYS for running configure and make, you should always use
|
||||
Windows paths (like c:/brltty), not MSYS paths (like /c/brltty), because brltty
|
||||
does _not_ understand MSYS paths.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
Windows 98 and Me Limitation
|
||||
============================
|
||||
|
||||
On Windows versions 2000, XP, 2003, and later, BRLTTY automatically accesses
|
||||
the Windows terminal which you're currently using as you switch between them.
|
||||
This isn't possible on earlier versions. One way to still achieve this
|
||||
functionality, however, is to run one BRLTTY (which directly accesses your
|
||||
braille display) on the root window and another one (which indirectly accesses
|
||||
your braille display via BrlAPI) on each terminal. This scheme may sound
|
||||
complicated, but it can be easily set up to run automatically.
|
||||
|
||||
The first (or root) BRLTTY should be run as part of Windows startup. It must be
|
||||
given those options which are necessary to access your braille display, e.g.
|
||||
-b, -d, and all other options you'd normally specify. It must also be given the
|
||||
-Xroot=yes option, which attaches it to the root window.
|
||||
|
||||
An additional BRLTTY should then be run for each new terminal. It should be
|
||||
invoked like this:
|
||||
|
||||
brltty -bba -N
|
||||
|
||||
The -bba option tells it to access the root BRLTTY via BrlAPI, and the -N
|
||||
option tells it not to start a BrlAPI server of its own.
|
||||
|
||||
These BRLTTYs can be started automatically by, for example, adding this line to
|
||||
your .bashrc script. Each of these BRLTTYs takes care of the terminal it's
|
||||
running in, and connects, via BrlAPI, to the root BRLTTY in order to access
|
||||
your braille display.
|
||||
|
||||
If you're not concerned with security, and would rather not fiddle with the
|
||||
brlapi.key file, then add the -Aauth=none option to the command line which
|
||||
invokes the root BRLTTY. You don't need to worry about unauthorized access over
|
||||
the network since the default is that only locally running programs can connect
|
||||
to BrlAPI.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
USB Support
|
||||
===========
|
||||
|
||||
USB devices are supported thanks to the libusb-win32 or libusb-1.0
|
||||
packages.
|
||||
|
||||
Pre-built versions of brltty have USB support compiled in, and the required
|
||||
drivers are shipped, you just need to let the installer set them up.
|
||||
|
||||
In order to build BRLTTY yourself with USB support enabled, _before_ compiling
|
||||
BRLTTY, you need to install at least one of libusb-win32 or libusb-1.0.
|
||||
|
||||
At the time of this writing, libusb-win32 binaries can be found on
|
||||
[http://libusb-win32.sourceforge.net/]. The file will be called something
|
||||
like "libusb-win32-bin-<version>.exe", and should be available on
|
||||
[http://sourceforge.net/project/showfiles.php?group_id=78138].
|
||||
Unpack it in some place.
|
||||
|
||||
As of the time of this writing, the libusb-1.0 binary snapshots can be found on
|
||||
http://www.libusb.org/wiki/windows_backend . The file will be called something
|
||||
like "libusb_<date>.7z". Unpack it in some place.
|
||||
|
||||
The Cygwin or mingw toolchain then needs to get aware of the presence of
|
||||
libusb-win32 or libusb1.0-devel.
|
||||
|
||||
For Cygwin:
|
||||
|
||||
* Just install the libusb-win32 or libusb1.0-devel package.
|
||||
|
||||
For mingw:
|
||||
|
||||
For libusb-win32:
|
||||
|
||||
Symlink the header and library files into MinGW installation, run:
|
||||
|
||||
+ ln -s "/path/to/LibUSB-Win32/include/lusb0_usb.h" /mingw/include/
|
||||
+ ln -s "/path/to/LibUSB-Win32/lib/gcc/libusb.a" /mingw/lib/
|
||||
+ ln -s "/path/to/LibUSB-Win32/bin/x86/libusb0_x86.dll" /mingw/bin/libusb0.dll
|
||||
|
||||
Then you can configure, compile, install, and run BRLTTY as usual.
|
||||
|
||||
For libusb-1.0:
|
||||
|
||||
1) Symlink the header and library files into MinGW installation, run:
|
||||
|
||||
+ ln -s "/path/to/Libusb-1.0/include/libusb-1.0" /mingw/include/
|
||||
+ ln -s "/path/to/Libusb-1.0/MinGW32/dll/libusb-1.0.dll.a" /mingw/lib/
|
||||
+ ln -s "/path/to/Libusb-1.0/MinGW32/dll/libusb-1.0.dll" /mingw/bin/
|
||||
|
||||
2) Create a /mingw/lib/pkgconfig/libusb-1.0.pc file containing
|
||||
|
||||
prefix=/mingw
|
||||
exec_prefix=${prefix}
|
||||
libdir=${prefix}/lib
|
||||
includedir=${prefix}/include
|
||||
|
||||
Name: libusb-1.0
|
||||
Description: C API for USB device access from Windows userspace
|
||||
Version: 1.0
|
||||
Libs: -L${libdir} -lusb-1.0
|
||||
Cflags: -I${includedir}/libusb-1.0
|
||||
|
||||
Then you can configure, compile, install, and run BRLTTY as usual.
|
||||
|
||||
To actually be able to use the libusb-win32 driver, you need to copy the
|
||||
runtime files in the brltty source.
|
||||
|
||||
+ cp "/path/to/LibUSB-Win32/bin/x86/libusb0.sys" brltty/hotplug/libusb0.sys
|
||||
+ cp "/path/to/LibUSB-Win32/bin/x86/libusb0_x86.dll" brltty/hotplug/libusb0.dll
|
||||
+ cp "/path/to/LibUSB-Win32/bin/amd64/libusb0.sys" brltty/hotplug/libusb0_x64.sys
|
||||
+ cp "/path/to/LibUSB-Win32/bin/amd64/libusb0.dll" brltty/hotplug/libusb0_x64.dll
|
||||
|
||||
and then right-click on brltty/hotplug/brltty.inf and select install, or on
|
||||
braille device plug, point at the brltty/hotplug/brltty.inf file.
|
||||
|
||||
To actually be able to use the libusb-1.0 driver, right-click on
|
||||
brltty/hotplug/brltty-libusb-1.0.inf and select install, or on braille
|
||||
device plug, point at the brltty/hotplug/brltty-libusb-1.0.inf file.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
Configuring BRLTTY
|
||||
==================
|
||||
|
||||
Some of BRLTTY's configure options are of particular interest to users of the
|
||||
Windows platform:
|
||||
|
||||
--enable-relocatable-install: The default is for BRLTTY to refer to its
|
||||
components via absolute paths. On the Windows platform, however, the convention
|
||||
is for a package to use relative paths so that it can be installed into an
|
||||
arbitrary directory and so that it can be moved around thereafter as well. This
|
||||
option builds BRLTTY such that relative paths are used.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
Sticking to a console
|
||||
=====================
|
||||
|
||||
It may be useful to have BRLTTY only review the console it is started in, i.e.
|
||||
for it not to follow the keyboard focus. To achieve this, set the FollowFocus
|
||||
parameter of the Windows screen driver to no. This can be done either on the
|
||||
command line (-XFollowFocus=no) or in brltty.conf (screen-parameter
|
||||
FollowFocus=no).
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
Sharing the Braille Display with Other Screen Readers
|
||||
=====================================================
|
||||
|
||||
When you're not on a window which BRLTTY can handle its default action is to
|
||||
retain control of the braille display and to present a brief message explaining
|
||||
the problem. If you have another braille-capable screen reader and would like
|
||||
it to take over instead then both BRLTTY and that other screen reader must be
|
||||
instructed to share the braille display.
|
||||
|
||||
BRLTTY can be instructed to share the braille display via its --release-device
|
||||
option; the short form of this option is -r. When this option is in effect
|
||||
BRLTTY releases the braille display when you move onto a window which it cannot
|
||||
handle and tries to regain control of the braille display when you move onto a
|
||||
window which it can handle. Note that these actions take a noticeable amount of
|
||||
time so you should only use this option if it's actually needed.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
Sharing BRLTTY with JAWS
|
||||
========================
|
||||
|
||||
A common case wherein a JAWS user might want BRLTTY to be in control of the
|
||||
braille display is when using Cygwin.
|
||||
|
||||
There are two phases to configuring JAWS to run in the background while BRLTTY
|
||||
controls the braille display. First, the window title must be established and
|
||||
stable. Second, JAWS braille must be put to sleep.
|
||||
|
||||
What is a window title?
|
||||
-----------------------
|
||||
|
||||
Every window in Windows has a title bar that contains the name of the
|
||||
application which is running in it as well as some controls to do things like
|
||||
move and resize it. BRLTTY does not show this title bar.
|
||||
|
||||
For a program window, JAWS uses the name of the program's executable as the
|
||||
name of the configuration files to load when that program gains focus. For a
|
||||
console application such as Cygwin, however, it uses the title of the window
|
||||
instead. We must, therefore, tell JAWS within the window title that this is a
|
||||
Cygwin window.
|
||||
|
||||
Setting the Window Title
|
||||
------------------------
|
||||
|
||||
JAWS uses one of the words in the window title as the name of the configuration
|
||||
files to load. This file set is what tells JAWS the specifics of how to handle
|
||||
the application. It is, therefore, where JAWS must be instructed to put its
|
||||
braille component to sleep.
|
||||
|
||||
At this writing, it appears that JAWS uses the following algorithm for choosing
|
||||
which word in the title to use as the name of the file set:
|
||||
1) If there are no slashes (/) or backslashes (\) in the title then JAWS uses
|
||||
the first word. Thus, if the title is "Cygwin Bash Shell" then JAWS will
|
||||
load the Cygwin configuration files.
|
||||
2) If there is at least one slash (/) or backslash (\) in the title then JAWS
|
||||
uses the last word. Thus, if the title is "$PWD - Cygwin" then JAWS will
|
||||
similarly load the Cygwin configuration files.
|
||||
Setting Cygwin's Window Title
|
||||
-----------------------------
|
||||
|
||||
First, it is imperative that you replace, or at least modify, the default PS1
|
||||
(primary shell prompt) setting. The default for this setting, as distributed by
|
||||
Cygwin, places $PWD (the path to the current working directory) in the window
|
||||
title, thus requiring you to have a separate JAWS configuration for every
|
||||
directory on the system! One possible way to resolve this problem is to
|
||||
uncomment the `settitle' function which can be found near the end of `.bashrc'.
|
||||
This function allows you to place a string of your own choice in the title. You
|
||||
can use this function, therefore, as follows:
|
||||
|
||||
export PROMPT_COMMAND='settitle "$PWD - Cygwin"'
|
||||
export PS1='$ '
|
||||
|
||||
The first of these lines causes the window title to be set just before each
|
||||
shell prompt. Since $PWD always contains at least one slash (/), the operative
|
||||
word is `Cygwin' (the last word), and JAWS will load any Cygwin configuration
|
||||
files that it finds. The second of these lines sets the primary shell prompt to
|
||||
the customary dollar sign ($). More importantly, though, it replaces Cygwin's
|
||||
default PS1 setting which contains escape sequences that overwrite the window
|
||||
title with just $PWD thus not presenting any permanent text for JAWS to
|
||||
recognize.
|
||||
|
||||
Putting JAWS Braille to Sleep
|
||||
-----------------------------
|
||||
|
||||
Now that a stable window title has been established, JAWS braille can finally
|
||||
be put to sleep. While in Cygwin and with BRLTTY not running, do the following:
|
||||
1) Press Insert+F2 to bring up the Run JAWS Manager dialog.
|
||||
2) Down-Arrow to Configuration Manager and press Enter. Verify that the title
|
||||
on the top line contains "Cygwin.jcf".
|
||||
3) Press Alt+S for Set Options.
|
||||
4) Press B for Braille.
|
||||
5) Press S for Braille Sleep Mode.
|
||||
6) Verify that the box is checked (it should look like <x> instead of < >).
|
||||
Press Space to toggle the setting if the x isn't there.
|
||||
7) Press Enter to leave the menu.
|
||||
8) Press Control+S to save the file.
|
||||
9) Press Alt+F4 to exit the configuration manager.
|
||||
|
||||
Putting JAWS Speech to Sleep
|
||||
----------------------------
|
||||
|
||||
If you want to use JAWS speech in Windows but not in Cygwin, you can do the
|
||||
following:
|
||||
|
||||
1) Press Insert+F2 to bring up the Run JAWS Manager dialog.
|
||||
2) Down-Arrow to Configuration Manager and press Enter. Verify that the title
|
||||
on the top line contains "Cygwin.jcf".
|
||||
3) Press Alt+S for Set Options.
|
||||
4) Press A for Advanced.
|
||||
5) You should be on an item labelled "Sleep Mode Enable" with an empty check
|
||||
box (< >). Press Space to check it (<x>).
|
||||
6) Press Enter to leave the menu.
|
||||
7) Press Control+S to save the file.
|
||||
8) Press Alt+F4 to exit the configuration manager.
|
||||
|
||||
Performance
|
||||
-----------
|
||||
|
||||
You'll always be able to switch to Cygwin, and BRLTTY, if running, will take
|
||||
control of the braille display automatically. Switching back to Windows and
|
||||
JAWS may be a bit more problematic, though ... the degree of success seems to
|
||||
depend on the type of braille display being used. Sometimes it works properly.
|
||||
Sometimes, with a USB display, the cable must be unplugged/replugged to allow
|
||||
JAWS to regain control. In extreme cases you may need to exit BRLTTY before
|
||||
going to Windows.
|
||||
|
||||
------------------------------------------------------------------------------
|
||||
|
||||
@@ -0,0 +1,63 @@
|
||||
Brltty provides some support for the X11 graphical environment.
|
||||
|
||||
Braille Input from braille device support
|
||||
-----------------------------------------
|
||||
|
||||
Some braille devices have an integrated braille keyboard. The brltty daemon
|
||||
alone can not properly simulate keypresses for the X11 server, because it
|
||||
does not know which keyboard layout the latter uses. To get proper keyboard
|
||||
simulation, xbrlapi should be started in the background during X session
|
||||
startup. By default, xbrlapi also prints the current window's title on the
|
||||
braille device. To avoid this (since it could interfere with the output from
|
||||
screen readers like Orca), give the -q option to xbrlapi.
|
||||
|
||||
Braille Input from PC keyboard support
|
||||
--------------------------------------
|
||||
|
||||
The PC keyboard itself can be used in X11 as a braille keyboard. This can be
|
||||
enabled by using the "brai" layout, for instance, the following
|
||||
|
||||
setxkbmap -layout "us,brai" -option "grp:shift_caps_toggle,grp_led:scroll"
|
||||
|
||||
enables both US and braille keyboard layouts to be enabled in X11 (in two
|
||||
different XKB groups), and Shift+CapsLock can be used to switch between both
|
||||
(i.e. switch between the two XKB groups). The scroll LED will be lit while being
|
||||
in braille mode, for sighted people to notice why they get strange output if
|
||||
they switch groups by accident. Other shortcuts and LEDs can be used, see the
|
||||
XKB documentation. The default keyboard mapping for braille dots is "asdfjkl,",
|
||||
but other layouts are available, see the variants in XKB.
|
||||
|
||||
The setxkbmap command above enables it just for the current session. For
|
||||
permanent configuration, the two groups have to be configured properly in the
|
||||
system. On Debian for instance, this can be achieved by setting the following
|
||||
in /etc/default/keyboard:
|
||||
|
||||
XKBLAYOUT="us,brai"
|
||||
XKBOPTIONS="grp:shift_caps_toggle,grp_led:scroll"
|
||||
|
||||
By default, the result will be unicode braille patterns, because X11 does not
|
||||
know which braille table it should use. To tell X11 the conversion that should
|
||||
be performed, use the ttbtest tool to convert your brltty table into an XCompose
|
||||
table, for instance:
|
||||
|
||||
ttbtest -i ttb -o XCompose en_US.ttb /tmp/my.XCompose
|
||||
|
||||
The XCompose table can then be enabled by:
|
||||
|
||||
cat /tmp/my.XCompose >> ~/.XCompose
|
||||
|
||||
Screen reading
|
||||
--------------
|
||||
|
||||
Brltty is not meant to be able to read a whole graphical environment, as it
|
||||
does not have the notion of menus, buttons, etc. The orca screen reader should
|
||||
be used instead. Brltty however has a driver to at least review the textual
|
||||
elements: edit boxes and terminals. This is particularly interesting for
|
||||
reading terminals, since that is what brltty is good at. This can be achieved by
|
||||
running a second brltty daemon during X11 session startup:
|
||||
|
||||
brltty -b ba -x as
|
||||
|
||||
This second daemon will connect to the first one throught BrlAPI (thanks to the
|
||||
"ba" braille driver), and read the screen via AtSpi (thanks to the "as" screen
|
||||
driver). An "a2" driver is also provided for AtSpi2 support.
|
||||
@@ -0,0 +1,99 @@
|
||||
Managing BRLTTY with Stow utility
|
||||
-+===============================+-
|
||||
|
||||
Written by B. Daix (Wed Sep 10, 2003)
|
||||
|
||||
|
||||
Purpose
|
||||
=======
|
||||
|
||||
BRLTTY is a critical software for those who rely on it to access their
|
||||
box : upgrading such a tool can't be done without paying some special
|
||||
attention.
|
||||
|
||||
What will be explained here is how to keep /usr/local/bin/brltty up to
|
||||
date without removing old versions. We decide to put BRLTTY in
|
||||
/usr/local as we don't want to break filesystem root distribution
|
||||
(i.e. /bin/brltty should only come from a packaged version of BRLTTY
|
||||
for your distribution : if you install software in respect with this
|
||||
rule, you'd install it in /usr/local). Also, we want not to have to
|
||||
keep source files to be able to remove things cleanly : after
|
||||
installing a software, you shouldn't have to rely on a by-software
|
||||
uninstallation suite.
|
||||
|
||||
You should install Stow to be able to run it and to find more details
|
||||
about it. It's a common utility : "apt-get install stow" for Debian, and
|
||||
probably equivalents for other distributions.
|
||||
|
||||
|
||||
Why Stow can help
|
||||
=================
|
||||
|
||||
Stow allows to manage files like if they were packaged, by creating
|
||||
symlinks from by-directory grouped sets of files instead of copying
|
||||
them directly.
|
||||
|
||||
We recommend to attentively read Stow Info files, to realize what it
|
||||
can do, how, and specially why it is so useful when you have to manage
|
||||
personally compiled software you rely on.
|
||||
|
||||
|
||||
The procedure
|
||||
=============
|
||||
|
||||
So we want to run a BRLTTY version, taken from a set of personally
|
||||
compiled ones, and safely keep all of them around. Current working
|
||||
release will be run from /usr/local root, while all releases files
|
||||
will be kept in the "safe place", the "Stow directory"
|
||||
/usr/local/stow/. For example, releases (bins/configs/libs/mans, not
|
||||
source trees) will be stored there like this :
|
||||
/usr/local/stow/brltty-3.2/, /usr/local/stow/brltty-3.3-with-api/,
|
||||
/usr/local/stow/brltty-3.3/, and so on.
|
||||
|
||||
Compiling/installing BRLTTY for Stow file management
|
||||
|
||||
We have to use "configure" flags to indicate we want BRLTTY to be run
|
||||
From /usr/local root, and installed in /usr/local/stow/brltty-3.2/
|
||||
root : Stow will do symlinks for us then. The distinction between
|
||||
execution root and installation root is critical (c.f. Stow Info) :
|
||||
"./configure --with-execute-root=/usr/local
|
||||
--with-install-root=/usr/local/stow/brltty-3.2 [...]". You may add
|
||||
whatever flags then, except those which change directories as we
|
||||
already managed this.
|
||||
|
||||
Then, simply, "make" and "make install" : "ls
|
||||
/usr/local/stow/brltty-3.2/" should show you all what would have been
|
||||
put in /usr/local if we haven't managed files with Stow.
|
||||
|
||||
Reproduce this for each version you want to install, for example, we
|
||||
built a brltty-3.3-with-api directory by applying above principles and
|
||||
adding dedicated flag for enabling API to "configure" command line.
|
||||
We did the same for a standard brltty-3.3 too, and so on, all stored
|
||||
in /usr/local/stow/. As you see, we cleanly separate things : one
|
||||
directory per version on one hand, building vs. using on the other.
|
||||
Testing is now far lighter.
|
||||
|
||||
Managing safely kept versions with Stow
|
||||
|
||||
Before asking for Stow to create symlinks, we have to be sure we won't
|
||||
get any conflicts, i.e., we haven't already asked for Stow to create
|
||||
symlinks on the same software without removing them first, or we don't
|
||||
forget we have already installed BRLTTY directly. "ls
|
||||
/usr/local/{bin,sbin}" should be enough to see if we have to clean
|
||||
things up before going any further. Note we'll see how to use Stow to
|
||||
remove created symlinks just after explaining how to ask for it to
|
||||
create them (we hope you read from up to below...).
|
||||
|
||||
"cd /usr/local/stow ; stow brltty-3.2" will create the symlinks, in
|
||||
parent dir (i.e. "ln -s brltty-3.2/bin ../bin" if ../bin didn't exist,
|
||||
"ln -s brltty-3.2/bin/brltty ../bin/brltty" otherwise, and so on :
|
||||
c.f. Stow Info for more details).
|
||||
|
||||
Now, running /usr/local/bin/brltty will work perfectly, looking for
|
||||
its config files in /usr/local/etc/brltty/" and so on, even if it's
|
||||
all symlinks : as if BRLTTY-3.2 was installed there.
|
||||
|
||||
When you want to switch to another version, you simply have to ask for
|
||||
Stow to remove symlinks it created : "cd /usr/local/stow/ ; stow -D
|
||||
brltty-3.2" (if current release points to this version) and then "stow
|
||||
brltty-3.3-with-api". Doesn't it taste powerful ?!
|
||||
@@ -0,0 +1,32 @@
|
||||
BRLTTY TODO - March 30, 2000
|
||||
============================
|
||||
|
||||
(This concerns the main module of BRLTTY. Individual Braille terminal
|
||||
drivers may have their own TODO lists.)
|
||||
|
||||
Your help is welcome.
|
||||
|
||||
- Defining smaller regions of the screen to be concentrated on. Cursor
|
||||
movement outside the current region would be ignored. This would be
|
||||
useful if the screen was split into multiple `windows' (e.g. in ytalk).
|
||||
|
||||
- Attribute tracking (scroll bars, etc.)
|
||||
|
||||
- Revision of beeps. Too many events have the same beeps, so we might want
|
||||
to add new ones. See if we could optimize the use of the console resource.
|
||||
Implement .au and .wav sounds (through a soundcard).
|
||||
|
||||
- Scroll tracking: wouldn't it be great if you could continue reading the
|
||||
line you're on even when new text is printed and the screen scrolls up?
|
||||
Like in IRC for instance...
|
||||
|
||||
- Better speech support.
|
||||
|
||||
- Support for more Braille displays.
|
||||
|
||||
- Port to other Unix platforms. Since all Linux dependent functions are now
|
||||
modularized in separate source files, it would be easy to write other
|
||||
modules to make BRLTTY usable with the screen package or such and then
|
||||
become available for any other Unix platform. An experimental patch is
|
||||
available in the Patches/ directory.
|
||||
|
||||
@@ -0,0 +1,776 @@
|
||||
.TH "BRLTTY" "1" "Oct 2011" "brltty 4.3" "The BRLTTY Project"
|
||||
.SH NAME
|
||||
brltty \- refreshable braille display driver for Linux/Unix
|
||||
.SH SYNOPSIS
|
||||
\fBbrltty \fR[\fIoption\fR ...]
|
||||
.SH DESCRIPTION
|
||||
.B brltty
|
||||
is a background process (daemon)
|
||||
which provides access to the console screen (when in text mode)
|
||||
for a blind person using a refreshable braille display.
|
||||
It drives the braille display,
|
||||
and provides complete screen review functionality.
|
||||
Some speech capability has also been incorporated.
|
||||
.SH OPTIONS
|
||||
Options can be passed to
|
||||
.B brltty
|
||||
in a number of ways.
|
||||
From most to least influential, these are:
|
||||
.IP 1. 4
|
||||
Command Line Options
|
||||
.IP 2. 4
|
||||
Boot Parameters
|
||||
.IP 3. 4
|
||||
Environment Variables
|
||||
(if the
|
||||
.B -E
|
||||
.RB "(" "--environment-variables" ")"
|
||||
option is in effect)
|
||||
.IP 4. 4
|
||||
The Configuration File
|
||||
.IP 5. 4
|
||||
Built-in Defaults
|
||||
.SS "Command Line Options"
|
||||
The options are processed sequentially from left to right.
|
||||
If an option is specified more than once,
|
||||
or in case of a conflict,
|
||||
the rightmost specification takes precedence.
|
||||
.PP
|
||||
The following options are supported:
|
||||
.TP
|
||||
\fB-a \fItable\fR (\fB--attributes-table=\fR)
|
||||
The path to the attributes table.
|
||||
Relative paths are anchored at
|
||||
.BR "@TABLES_DIRECTORY@" "."
|
||||
The
|
||||
.B ".atb"
|
||||
extension is optional.
|
||||
The built-in default is
|
||||
.BR "attributes.atb" "."
|
||||
.TP
|
||||
\fB-b \fIdriver\fB,\fR...|\fBauto\fR (\fB--braille-driver=\fR)
|
||||
The driver for the braille display
|
||||
(see Driver Specification).
|
||||
The built-in default is \fBauto\fR.
|
||||
.TP
|
||||
\fB-c \fItable\fR (\fB--contraction-table=\fR)
|
||||
The path to the contraction table.
|
||||
Relative paths are anchored at
|
||||
.BR "@TABLES_DIRECTORY@" "."
|
||||
The
|
||||
.B ".ctb"
|
||||
extension is optional.
|
||||
.TP
|
||||
\fB-d \fIdevice\fB,\fR... (\fB--braille-device=\fR)
|
||||
The device to which the braille display is connected.
|
||||
The built-in default is \fB@braille_device@\fR.
|
||||
.RS
|
||||
.PP
|
||||
The general form of a braille device specification is
|
||||
\fIqualifier\fB:\fIdata\fR.
|
||||
For backward compatibility with earlier releases,
|
||||
if the qualifier is omitted then
|
||||
.B serial:
|
||||
is assumed.
|
||||
The following device types are supported:
|
||||
.TP
|
||||
.B Bluetooth
|
||||
For a bluetooth device, specify \fBbluez:\fIaddress\fR.
|
||||
The address must be six two-digit hexadecimal numbers separated by colons, e.g.
|
||||
.BR "01:23:45:67:89:AB" "."
|
||||
.TP
|
||||
.B Serial
|
||||
For a serial device, specify \fBserial:\fI/path/to/device\fR.
|
||||
The
|
||||
.B serial:
|
||||
qualifier is optional (for backward compatibility).
|
||||
If a relative path is given then it's anchored at
|
||||
.B /dev/
|
||||
(the usual location where devices are defined on a Unix-like system).
|
||||
The following device specifications all refer
|
||||
to the primary serial device:
|
||||
.BR "serial:/dev/@first_serial_device@" ","
|
||||
.BR "serial:@first_serial_device@" ","
|
||||
.BR "/dev/@first_serial_device@" ","
|
||||
.BR "@first_serial_device@" "."
|
||||
.TP
|
||||
.B USB
|
||||
For a USB device, specify \fBusb:\fR.
|
||||
.B brltty
|
||||
will search for the first USB device which
|
||||
matches the braille display driver being used.
|
||||
If this is inadequate,
|
||||
e.g. if you have more than one USB braille display which requires the same driver,
|
||||
then you can refine the device specification
|
||||
by appending the serial number of the display to it, e.g.
|
||||
.BR "usb:12345" "."
|
||||
N.B.:
|
||||
The "identification by serial number" feature doesn't work for some models
|
||||
because some manufacturers
|
||||
either don't set the USB serial number descriptor at all
|
||||
or do set it but not to a unique value.
|
||||
.PP
|
||||
A comma-delimited list of braille devices may be specified.
|
||||
If this is done then autodetection is performed on each listed device in sequence.
|
||||
This feature is particularly useful if you have
|
||||
a braille display with more than one interrface,
|
||||
e.g. both a serial and a USB port.
|
||||
.RE
|
||||
.TP
|
||||
\fB-e\fR (\fB--standard-error\fR)
|
||||
Write logs to standard error rather than to the system log (useful for debugging).
|
||||
.TP
|
||||
\fB-f \fIfile\fR (\fB--configuration-file=\fR)
|
||||
The path to the configuration file.
|
||||
Relative paths are anchored at the current working directory.
|
||||
The built-in default is
|
||||
.BR "@CONFIGURATION_DIRECTORY@/@CONFIGURATION_FILE@" "."
|
||||
.TP
|
||||
\fB-h\fR (\fB--help\fR)
|
||||
Print a command line usage summary and then exit.
|
||||
.TP
|
||||
\fB-i \fIname\fR (\fB--speech-input=\fR)
|
||||
The file system object
|
||||
(FIFO, named pipe, named socket, etc)
|
||||
which gives other applications access to
|
||||
.BR brltty 's
|
||||
speech driver for text-to-speech conversion.
|
||||
It's created at start-up and removed at termination.
|
||||
Relative paths are anchored at the current working directory.
|
||||
The built-in default is
|
||||
that the file system object is not created.
|
||||
.TP
|
||||
\fB-l \fIlevel\fR (\fB--log-level=\fR)
|
||||
The minimum severity level for messages written to the log.
|
||||
Any of the following numbers,
|
||||
or any abbreviation of their corresponding names,
|
||||
may be specified:
|
||||
.RS
|
||||
.TP 4
|
||||
.B 0
|
||||
.B emergency
|
||||
.TP 4
|
||||
.B 1
|
||||
.B alert
|
||||
.TP 4
|
||||
.B 2
|
||||
.B critical
|
||||
.TP 4
|
||||
.B 3
|
||||
.B error
|
||||
.TP 4
|
||||
.B 4
|
||||
.B warning
|
||||
.TP 4
|
||||
.B 5
|
||||
.B notice
|
||||
.TP 4
|
||||
.B 6
|
||||
.B information
|
||||
.TP 4
|
||||
.B 7
|
||||
.B debug
|
||||
.RE
|
||||
.PP
|
||||
The built-in default is
|
||||
.BR "notice" "."
|
||||
.TP
|
||||
\fB-m \fIdevice\fR (\fB--midi-device=\fR)
|
||||
The device to use for the Musical Instrument Digital Interface.
|
||||
For ALSA it's \fIclient\fB:\fIport\fR,
|
||||
where each may be either a number or a case-sensitive substring of its name.
|
||||
For other interfaces it's the full path to an appropriate system device.
|
||||
The built-in default is:
|
||||
.RS
|
||||
.IP Linux/ALSA 12
|
||||
the first available MIDI output port
|
||||
.IP Linux/OSS 12
|
||||
.B /dev/sequencer
|
||||
.RE
|
||||
.TP
|
||||
\fB-n\fR (\fB--no-daemon\fR)
|
||||
Remain in the foreground (useful for debugging).
|
||||
.TP
|
||||
\fB-p \fIdevice\fR (\fB--pcm-device=\fR)
|
||||
The device to use for digital audio.
|
||||
For ALSA it's \fIname\fR[\fB:\fIargument\fB,\fR...].
|
||||
For other interfaces it's the full path to an appropriate system device.
|
||||
The built-in default is:
|
||||
.RS
|
||||
.IP FreeBSD 12
|
||||
.B /dev/dsp
|
||||
.IP Linux/ALSA 12
|
||||
.B hw:0,0
|
||||
.IP Linux/OSS 12
|
||||
.B /dev/dsp
|
||||
.IP NetBSD 12
|
||||
.B /dev/audio
|
||||
.IP OpenBSD 12
|
||||
.B /dev/audio
|
||||
.IP Qnx 12
|
||||
the preferred PCM output device
|
||||
.IP Solaris 12
|
||||
.B /dev/audio
|
||||
.RE
|
||||
.TP
|
||||
\fB-q\fR (\fB--quiet\fR)
|
||||
Suppress the start-up messages.
|
||||
This is done by reducing the default log level
|
||||
(see the
|
||||
.B -l
|
||||
.RB "(" "--log-level=" ")"
|
||||
option)
|
||||
to
|
||||
.B warning
|
||||
.RB "(" "information"
|
||||
if either
|
||||
.B -v
|
||||
.RB "(" "--verify" ")"
|
||||
or
|
||||
.B -V
|
||||
.RB "(" "--version" ")"
|
||||
is also specified).
|
||||
.TP
|
||||
\fB-r\fR (\fB--release-device\fR)
|
||||
Release the device to which the braille display is connected
|
||||
when the current screen or window can't be read.
|
||||
.TP
|
||||
\fB-s \fIdriver\fB,\fR...|\fBauto\fR (\fB--speech-driver=\fR)
|
||||
The driver for the speech synthesizer
|
||||
(see Driver Specification).
|
||||
The built-in default is \fBauto\fR.
|
||||
.TP
|
||||
\fB-t \fItable\fR (\fB--text-table=\fR)
|
||||
The path to the text table.
|
||||
Relative paths are anchored at
|
||||
.BR "@TABLES_DIRECTORY@" "."
|
||||
The
|
||||
.B ".ttb"
|
||||
extension is optional.
|
||||
The built-in default is
|
||||
.B "nabcc.ttb"
|
||||
(the North American Braille Computer Code).
|
||||
.TP
|
||||
\fB-v\fR (\fB--verify\fR)
|
||||
Print the start-up messages and then exit.
|
||||
This always includes the versions of
|
||||
.B brltty
|
||||
itself,
|
||||
the server side of its application programming interface,
|
||||
and each of the selected braille and speech drivers.
|
||||
If the
|
||||
.B -q
|
||||
.RB "(" "--quiet" ")"
|
||||
option isn't also specified
|
||||
then it also includes the values of the options after all sources have been considered.
|
||||
If more than one braille driver and/or more than one braille device
|
||||
has been specified then braille display autodetection is performed.
|
||||
If more than one speech driver
|
||||
has been specified then speech synthesizer autodetection is performed.
|
||||
.TP
|
||||
\fB-x \fIdriver\fR (\fB--screen-driver=\fR)
|
||||
The screen driver.
|
||||
The built-in default is operating system appropriate.
|
||||
.TP
|
||||
\fB-A \fIname\fB=\fIvalue\fB,\fR... (\fB--api-parameters=\fR)
|
||||
Parameters for the application programming interface.
|
||||
If the same parameter is specified more than once
|
||||
then the rightmost specification is used.
|
||||
Parameter names may be abbreviated.
|
||||
.TP
|
||||
\fB-B \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR... (\fB--braille-parameters=\fR)
|
||||
Parameters for the braille display driver.
|
||||
If the same parameter is specified more than once
|
||||
then the rightmost specification is used.
|
||||
Parameter names may be abbreviated.
|
||||
If a parameter assignment is qualified with a driver identification code
|
||||
then it's only processed if that braille display driver is being used.
|
||||
.TP
|
||||
\fB-E\fR (\fB--environment-variables\fR)
|
||||
Recognize environment variables.
|
||||
.TP
|
||||
\fB-F \fIfile\fR (\fB--preferences-file=\fR)
|
||||
The path to the preferences file.
|
||||
Relative paths are anchored at
|
||||
.BR "@STATE_DIRECTORY@" "."
|
||||
The built-in default is
|
||||
.BR "@PREFERENCES_FILE@" "."
|
||||
.TP
|
||||
\fB-I\fR (\fB--install-service\fR)
|
||||
(Windows only)
|
||||
Install
|
||||
.B brltty
|
||||
as the
|
||||
.B BrlAPI
|
||||
service so that it will be automatically started when the system is booted
|
||||
and so that applications can know that a
|
||||
.B BrlAPI
|
||||
server is running.
|
||||
.TP
|
||||
\fB-L \fIfile\fR (\fB--log-file=\fR)
|
||||
The file to which log messages are written.
|
||||
Relative paths are anchored at the current working directory.
|
||||
The default is to send log messages to the system log.
|
||||
.TP
|
||||
\fB-M \fIcsecs\fR (\fB--message-delay=\fR)
|
||||
The message hold time in hundredths of a second.
|
||||
The built-in default is
|
||||
.B 400
|
||||
(4 seconds).
|
||||
.TP
|
||||
\fB-N\fR (\fB--no-api\fR)
|
||||
Don't start the application programming interface.
|
||||
.TP
|
||||
\fB-P \fIfile\fR (\fB--pid-file=\fR)
|
||||
The full path to the process identifier file.
|
||||
If this option is supplied,
|
||||
.B brltty
|
||||
writes its process identifier (pid) into the specified file at start-up.
|
||||
The file is removed when
|
||||
.B brltty
|
||||
terminates.
|
||||
.TP
|
||||
\fB-R\fR (\fB--remove-service\fR)
|
||||
(Windows only)
|
||||
Remove the
|
||||
.B BrlAPI
|
||||
service so that
|
||||
.B brltty
|
||||
will not be automatically started when the system is booted
|
||||
and so that applications can know that no
|
||||
.B BrlAPI
|
||||
server is running.
|
||||
.TP
|
||||
\fB-S \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR... (\fB--speech-parameters=\fR)
|
||||
Parameters for the speech synthesizer driver.
|
||||
If the same parameter is specified more than once
|
||||
then the rightmost specification is used.
|
||||
Parameter names may be abbreviated.
|
||||
If a parameter assignment is qualified with a driver identification code
|
||||
then it's only processed if that speech synthesizer driver is being used.
|
||||
.TP
|
||||
\fB-U \fIcsecs\fR (\fB--update-interval=\fR)
|
||||
The braille window update interval in hundredths of a second.
|
||||
The built-in default is
|
||||
.B 4
|
||||
(25 times per second).
|
||||
.TP
|
||||
\fB-V\fR (\fB--version\fR)
|
||||
Print the versions of
|
||||
.B brltty
|
||||
itself,
|
||||
the server side of its application programming interface,
|
||||
and those drivers which were configured in at build-time,
|
||||
and then exit.
|
||||
If the
|
||||
.B -q
|
||||
.RB "(" "--quiet" ")"
|
||||
option isn't also specified
|
||||
then also print copyright information.
|
||||
.TP
|
||||
\fB-X \fIname\fB=\fIvalue\fB,\fR... (\fB--screen-parameters=\fR)
|
||||
Parameters for the screen driver.
|
||||
If the same parameter is specified more than once
|
||||
then the rightmost specification is used.
|
||||
Parameter names may be abbreviated.
|
||||
.SS "Environment Variables"
|
||||
The following environment variables are recognized if the
|
||||
.B -E
|
||||
.RB "(" "--environment-variables" ")"
|
||||
option is specified:
|
||||
.TP
|
||||
\fBBRLTTY_API_PARAMETERS=\fIname\fB=\fIvalue\fB,\fR...
|
||||
Parameters for the application programming interface.
|
||||
See the
|
||||
.B -A
|
||||
.RB "(" "--api-parameters=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_ATTRIBUTES_TABLE=\fItable\fR
|
||||
The attributes table.
|
||||
See the
|
||||
.B -a
|
||||
.RB "(" "--attributes-table=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_BRAILLE_DEVICE=\fIdevice\fB,\fR...
|
||||
The device to which the braille display is connected.
|
||||
See the
|
||||
.B -d
|
||||
.RB "(" "--braille-device=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_BRAILLE_DRIVER=\fIdriver\fB,\fR...|\fBauto\fR
|
||||
The driver for the braille display.
|
||||
See the
|
||||
.B -b
|
||||
.RB "(" "--braille-driver=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_BRAILLE_PARAMETERS=\fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
|
||||
Parameters for the braille display driver.
|
||||
See the
|
||||
.B -B
|
||||
.RB "(" "--braille-parameters=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_CONFIGURATION_FILE=\fIfile\fR
|
||||
The configuration file.
|
||||
See the
|
||||
.B -f
|
||||
.RB "(" "--configuration-file=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_CONTRACTION_TABLE=\fItable\fR
|
||||
The contraction table.
|
||||
See the
|
||||
.B -c
|
||||
.RB "(" "--contraction-table=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_MIDI_DEVICE=\fIdevice\fR
|
||||
The device to use for the Musical Instrument Digital Interface.
|
||||
See the
|
||||
.B -m
|
||||
.RB "(" "--midi-device=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_PCM_DEVICE=\fIdevice\fR
|
||||
The device to use for digital audio.
|
||||
See the
|
||||
.B -p
|
||||
.RB "(" "--pcm-device=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_PREFERENCES_FILE=\fIfile\fR
|
||||
The preferences file.
|
||||
See the
|
||||
.B -F
|
||||
.RB "(" "--preferences-file=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_RELEASE_DEVICE=on\fR|\fBoff\fR
|
||||
Release the device to which the braille display is connected
|
||||
when the current screen or window can't be read.
|
||||
See the
|
||||
.B -r
|
||||
.RB "(" "--release-device" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_SCREEN_DRIVER=\fIdriver\fR
|
||||
The screen driver.
|
||||
See the
|
||||
.B -x
|
||||
.RB "(" "--screen-driver=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_SCREEN_PARAMETERS=\fIname\fB=\fIvalue\fB,\fR...
|
||||
Parameters for the screen driver.
|
||||
See the
|
||||
.B -X
|
||||
.RB "(" "--screen-parameters=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_SPEECH_DRIVER=\fIdriver\fB,\fR...|\fBauto\fR
|
||||
The driver for the speech synthesizer.
|
||||
See the
|
||||
.B -s
|
||||
.RB "(" "--speech-driver=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_SPEECH_INPUT=\fIname\fR
|
||||
The file system object which gives other applications access to
|
||||
.BR brltty 's
|
||||
speech driver for text-to-speech conversion.
|
||||
See the
|
||||
.B -i
|
||||
.RB "(" "--speech-input=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_SPEECH_PARAMETERS=\fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
|
||||
Parameters for the speech synthesizer driver.
|
||||
See the
|
||||
.B -S
|
||||
.RB "(" "--speech-parameters=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBBRLTTY_TEXT_TABLE=\fItable\fR
|
||||
The text table.
|
||||
See the
|
||||
.B -t
|
||||
.RB "(" "--text-table=" ")"
|
||||
option for details.
|
||||
.SS "The Configuration File"
|
||||
Blank lines are ignored.
|
||||
If the character
|
||||
.B "#"
|
||||
occurs on any line then
|
||||
all characters from it to the end of that line are treated as a comment.
|
||||
.PP
|
||||
The following configuration directives are supported:
|
||||
.TP
|
||||
\fBapi-parameters \fIname\fB=\fIvalue\fB,\fR...
|
||||
Parameters for the application programming interface.
|
||||
See the
|
||||
.B -A
|
||||
.RB "(" "--api-parameters=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBattributes-table \fItable\fR
|
||||
The attributes table.
|
||||
See the
|
||||
.B -a
|
||||
.RB "(" "--attributes-table=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBbraille-device \fIdevice\fB,\fR...
|
||||
The device to which the braille display is connected.
|
||||
See the
|
||||
.B -d
|
||||
.RB "(" "--braille-device=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBbraille-driver \fIdriver\fB,\fR...|\fBauto\fR
|
||||
The driver for the braille display.
|
||||
See the
|
||||
.B -b
|
||||
.RB "(" "--braille-driver=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBbraille-parameters \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
|
||||
Parameters for the braille display driver.
|
||||
See the
|
||||
.B -B
|
||||
.RB "(" "--braille-parameters=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBcontraction-table \fItable\fR
|
||||
The contraction table.
|
||||
See the
|
||||
.B -c
|
||||
.RB "(" "--contraction-table=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBmidi-device \fIdevice\fR
|
||||
The device to use for the Musical Instrument Digital Interface.
|
||||
See the
|
||||
.B -m
|
||||
.RB "(" "--midi-device=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBpcm-device \fIdevice\fR
|
||||
The device to use for digital audio.
|
||||
See the
|
||||
.B -p
|
||||
.RB "(" "--pcm-device=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
The preferences file.
|
||||
See the
|
||||
.B -F
|
||||
.RB "(" "--preferences-file=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBrelease-device on\fR|\fBoff\fR
|
||||
Release the device to which the braille display is connected
|
||||
when the current screen or window can't be read.
|
||||
See the
|
||||
.B -r
|
||||
.RB "(" "--release-device" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBscreen-driver \fIdriver\fR
|
||||
The screen driver.
|
||||
See the
|
||||
.B -x
|
||||
.RB "(" "--screen-driver=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBscreen-parameters \fIname\fB=\fIvalue\fB,\fR...
|
||||
Parameters for the screen driver.
|
||||
See the
|
||||
.B -X
|
||||
.RB "(" "--screen-parameters=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBspeech-driver \fIdriver\fB,\fR...|\fBauto\fR
|
||||
The driver for the speech synthesizer.
|
||||
See the
|
||||
.B -s
|
||||
.RB "(" "--speech-driver=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBspeech-input \name\fR
|
||||
The file system object which gives other applications access to
|
||||
.BR brltty 's
|
||||
speech driver for text-to-speech conversion.
|
||||
See the
|
||||
.B -i
|
||||
.RB "(" "--speech-input=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBspeech-parameters \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
|
||||
Parameters for the speech synthesizer driver.
|
||||
See the
|
||||
.B -S
|
||||
.RB "(" "--speech-parameters=" ")"
|
||||
option for details.
|
||||
.TP
|
||||
\fBtext-table \fItable\fR
|
||||
The text table.
|
||||
See the
|
||||
.B -t
|
||||
.RB "(" "--text-table=" ")"
|
||||
option for details.
|
||||
.SS "Driver Specification"
|
||||
A braille display or speech synthesizer driver
|
||||
must be specified via its identification code:
|
||||
.RS
|
||||
.TP 4
|
||||
.B al
|
||||
Alva
|
||||
.TP 4
|
||||
.B at
|
||||
Albatross
|
||||
.TP 4
|
||||
.B ba
|
||||
BrlAPI
|
||||
.TP 4
|
||||
.B bc
|
||||
BrailComm
|
||||
.TP 4
|
||||
.B bd
|
||||
Braudi
|
||||
.TP 4
|
||||
.B bl
|
||||
BrailleLite
|
||||
.TP 4
|
||||
.B bm
|
||||
Baum
|
||||
.TP 4
|
||||
.B bn
|
||||
BrailleNote
|
||||
.TP 4
|
||||
.B cb
|
||||
CombiBraille
|
||||
.TP 4
|
||||
.B ec
|
||||
EcoBraille
|
||||
.TP 4
|
||||
.B es
|
||||
eSpeak
|
||||
.TP 4
|
||||
.B eu
|
||||
EuroBraille
|
||||
.TP 4
|
||||
.B fl
|
||||
FestivalLite
|
||||
.TP 4
|
||||
.B fs
|
||||
FreedomScientific
|
||||
.TP 4
|
||||
.B fv
|
||||
Festival
|
||||
.TP 4
|
||||
.B gs
|
||||
GenericSay
|
||||
.TP 4
|
||||
.B hm
|
||||
HIMS
|
||||
.TP 4
|
||||
.B ht
|
||||
HandyTech
|
||||
.TP 4
|
||||
.B hw
|
||||
HumanWare
|
||||
.TP 4
|
||||
.B il
|
||||
IrisLinux
|
||||
.TP 4
|
||||
.B lb
|
||||
Libbraille
|
||||
.TP 4
|
||||
.B lt
|
||||
LogText
|
||||
.TP 4
|
||||
.B mb
|
||||
MultiBraille
|
||||
.TP 4
|
||||
.B md
|
||||
MDV
|
||||
.TP 4
|
||||
.B mn
|
||||
MiniBraille
|
||||
.TP 4
|
||||
.B mp
|
||||
Mikropuhe
|
||||
.TP 4
|
||||
.B mt
|
||||
Metec
|
||||
.TP 4
|
||||
.B no
|
||||
no driver
|
||||
.TP 4
|
||||
.B pg
|
||||
Pegasus
|
||||
.TP 4
|
||||
.B pm
|
||||
Papenmeier
|
||||
.TP 4
|
||||
.B sd
|
||||
SpeechDispatcher
|
||||
.TP 4
|
||||
.B sk
|
||||
Seika
|
||||
.TP 4
|
||||
.B sw
|
||||
Swift
|
||||
.TP 4
|
||||
.B th
|
||||
Theta
|
||||
.TP 4
|
||||
.B tn
|
||||
TechniBraille Systems Inc.
|
||||
.TP 4
|
||||
.B ts
|
||||
Telesensory Systems Inc.
|
||||
.TP 4
|
||||
.B tt
|
||||
TTY
|
||||
.TP 4
|
||||
.B vd
|
||||
VideoBraille
|
||||
.TP 4
|
||||
.B vo
|
||||
Voyager, Part232 (serial adapter), BraillePen/EasyLink
|
||||
.TP 4
|
||||
.B vr
|
||||
Virtual
|
||||
.TP 4
|
||||
.B vs
|
||||
VisioBraille
|
||||
.TP 4
|
||||
.B vv
|
||||
ViaVoice
|
||||
.TP 4
|
||||
.B xs
|
||||
ExternalSpeech
|
||||
.TP 4
|
||||
.B xw
|
||||
XWindow
|
||||
.PP
|
||||
A comma-delimited list of drivers may be specified.
|
||||
If this is done then autodetection is performed using each listed driver in sequence.
|
||||
You may need to experiment in order to determine the most reliable order
|
||||
since some drivers autodetect better than others.
|
||||
.PP
|
||||
If the single word
|
||||
.B auto
|
||||
is specified then autodetection is performed
|
||||
using only those drivers which are known to be reliable for this purpose.
|
||||
.RE
|
||||
.SH "SEE ALSO"
|
||||
For full documentation, see
|
||||
.BR brltty 's
|
||||
on-line manual at
|
||||
.RB "[" "http://mielke.cc/brltty/doc/Manual-HTML/Manual.html" "]."
|
||||
@@ -0,0 +1,521 @@
|
||||
# This is a configuration file template for the BRLTTY application.
|
||||
# Uncomment those entries which apply to your personal needs and system
|
||||
# requirements.
|
||||
|
||||
# BRLTTY expects to find its configuration file in "/etc/@CONFIGURATION_FILE@"
|
||||
# (can be overridden with the -f [--configuration-file=] option).
|
||||
# If it doesn't exist, then BRLTTY silently continues but may require
|
||||
# that certain command line options be explicitly supplied.
|
||||
|
||||
# Blank lines are ignored. The character '#', anywhere on a line,
|
||||
# initiates a comment; all characters from it to the end of that line
|
||||
# are ignored.
|
||||
|
||||
# Each configuration entry consists of a keyword followed by its operand.
|
||||
# An arbitrary amount of white space, (blanks and/or tabs), may occur
|
||||
# before the keyword, as well as before and after the operand. Keyword
|
||||
# processing is not case sensitive. Examples of valid entries are:
|
||||
#
|
||||
# Braille-Driver pm # Papenmeier braille displays.
|
||||
# braille-device serial:ttyS0 # The first serial device.
|
||||
# SPEECH-DRIVER fv # The Festival Text to Speech System.
|
||||
|
||||
# The default settings given within the following descriptions assume no
|
||||
# special build options (see "./configure --help" in the top-level
|
||||
# directory of the source tree.
|
||||
|
||||
|
||||
############################
|
||||
# Generic Braille Settings #
|
||||
############################
|
||||
|
||||
# The braille-driver directive specifies the two-letter driver
|
||||
# identification code of the driver for the braille display.
|
||||
# If not specified, autodetection will be performed.
|
||||
# (can be overridden with the -b [--braille-driver=] option)
|
||||
#braille-driver auto # autodetect
|
||||
#braille-driver al # Alva
|
||||
#braille-driver at # Albatross
|
||||
#braille-driver ba # BrlAPI
|
||||
#braille-driver bc # BrailComm
|
||||
#braille-driver bd # Braudi
|
||||
#braille-driver bl # BrailleLite
|
||||
#braille-driver bm # Baum
|
||||
#braille-driver bn # BrailleNote
|
||||
#braille-driver cb # CombiBraille
|
||||
#braille-driver ec # EcoBraille
|
||||
#braille-driver eu # EuroBraille
|
||||
#braille-driver fs # FreedomScientific
|
||||
#braille-driver hm # HIMS
|
||||
#braille-driver ht # HandyTech
|
||||
#braille-driver hw # HumanWare
|
||||
#braille-driver il # IrisLinux
|
||||
#braille-driver lb # Libbraille
|
||||
#braille-driver lt # LogText
|
||||
#braille-driver mb # MultiBraille
|
||||
#braille-driver md # MDV (protocol 5)
|
||||
#braille-driver mn # MiniBraille
|
||||
#braille-driver mt # Metec
|
||||
#braille-driver pg # Pegasus
|
||||
#braille-driver pm # Papenmeier
|
||||
#braille-driver sk # Seika
|
||||
#braille-driver tn # TechniBraille
|
||||
#braille-driver ts # TSI
|
||||
#braille-driver tt # TTY
|
||||
#braille-driver vd # VideoBraille
|
||||
#braille-driver vo # Voyager, Part232 (serial adapter), BraillePen/EasyLink
|
||||
#braille-driver vr # Virtual
|
||||
#braille-driver vs # VisioBraille
|
||||
#braille-driver xw # XWindow
|
||||
|
||||
# The braille-device directive specifies the device to which the braille
|
||||
# display is connected. The generic syntax is type:device. The device
|
||||
# type is optional, and, for backward compatibility, defaults to serial.
|
||||
# The following devices are supported (brackets indicate optionality):
|
||||
# serial:path (relative paths are anchored at "/dev")
|
||||
# usb:[serial-number]
|
||||
# bluetooth:address
|
||||
# If not specified, "usb:" will be used.
|
||||
# (can be overridden with the -d [--braille-device=] option)
|
||||
#braille-device serial:ttyS0 # First serial device.
|
||||
#braille-device usb: # First USB device matching braille driver.
|
||||
#braille-device usb:nnnnn # Specific USB device by serial number.
|
||||
#braille-device bluetooth:xx:xx:xx:xx:xx:xx # Specific bluetooth device by address.
|
||||
#
|
||||
# NOTE: If the device is connected via a serial-to-USB adapter then setting
|
||||
# braille-device to usb: will not work. In this case it needs to identify the
|
||||
# virtual serial device which the kernel has created for the adapter, i.e. to
|
||||
# something like serial:ttyUSB0 (see the kernel messages on device plug to get
|
||||
# the actual device name).
|
||||
|
||||
# The release-device directive specifies whether or not the device to which the
|
||||
# braille display is connected is to be released when the current screen or
|
||||
# window can't be read by BRLTTY. If not specified, "on" will be used on Windows
|
||||
# platforms and "off" will be used on all other platforms.
|
||||
# (can be overridden with the -r [--release-device] option)
|
||||
#release-device on # Release the device.
|
||||
#release-device off # Don't release the device.
|
||||
|
||||
# The text-table directive specifies which text table to use. Relative paths
|
||||
# are anchored at "/etc/brltty". If not specified, locale-based
|
||||
# autoselection with fallback to "en-nabcc" will be performed.
|
||||
# (can be overridden with the -t [--text-table=] option)
|
||||
#text-table auto # locale-based autoselection (fallback to "en-nabcc")
|
||||
#text-table ar # Arabic (generic)
|
||||
#text-table as # Assamese
|
||||
#text-table awa # Awadhi
|
||||
#text-table bg # Bulgarian
|
||||
#text-table bh # Bihari
|
||||
#text-table bn # Bengali
|
||||
#text-table bo # Tibetan
|
||||
#text-table bra # Braj
|
||||
#text-table cs # Czech
|
||||
#text-table cy # Welsh
|
||||
#text-table da # Danish
|
||||
#text-table de # German
|
||||
#text-table dra # Dravidian
|
||||
#text-table el # Greek
|
||||
#text-table en # English
|
||||
#text-table en_CA # English (Canada)
|
||||
#text-table en_GB # English (United Kingdom)
|
||||
#text-table en_US # English (United States)
|
||||
#text-table en-nabcc # English (North American Braille Computer Code)
|
||||
#text-table eo # Esperanto
|
||||
#text-table es # Spanish
|
||||
#text-table et # Estonian
|
||||
#text-table fi # Finnish
|
||||
#text-table fr # French
|
||||
#text-table fr_CA # French (Canada)
|
||||
#text-table fr_FR # French (France)
|
||||
#text-table fr-2007 # French (unified)
|
||||
#text-table fr-cbifs # French (Code Braille Informatique Français Standard)
|
||||
#text-table ga # Irish
|
||||
#text-table gd # Gaelic
|
||||
#text-table gon # Gondi
|
||||
#text-table gu # Gujarati
|
||||
#text-table he # Hebrew
|
||||
#text-table hi # Hindi
|
||||
#text-table hr # Croatian
|
||||
#text-table hu # Hungarian
|
||||
#text-table hy # Armenian
|
||||
#text-table is # Icelandic
|
||||
#text-table it # Italian
|
||||
#text-table kha # Khasi
|
||||
#text-table kn # Kannada
|
||||
#text-table kok # Konkani
|
||||
#text-table kru # Kurukh
|
||||
#text-table lt # Lituanian
|
||||
#text-table lv # Latvian
|
||||
#text-table mg # Malagasy
|
||||
#text-table mi # Maori
|
||||
#text-table ml # Malayalam
|
||||
#text-table mni # Manipuri
|
||||
#text-table mr # Marathi
|
||||
#text-table mt # Maltese
|
||||
#text-table mun # Mundari
|
||||
#text-table mwr # Marwari
|
||||
#text-table ne # Nepali
|
||||
#text-table new # Newari
|
||||
#text-table nl # Dutch
|
||||
#text-table nl_BE # Dutch (Belgium)
|
||||
#text-table nl_NL # Dutch (Netherlands)
|
||||
#text-table no # Norwegian
|
||||
#text-table no-generic # Norwegian (with support for other languages)
|
||||
#text-table no-oub # Norwegian (Offentlig Utvalg for Blindeskrift)
|
||||
#text-table nwc # Old Newari
|
||||
#text-table or # Oriya
|
||||
#text-table pa # Panjabi
|
||||
#text-table pi # Pali
|
||||
#text-table pl # Polish
|
||||
#text-table pt # Portuguese
|
||||
#text-table ro # Romanian
|
||||
#text-table ru # Russian
|
||||
#text-table sa # Sanskrit
|
||||
#text-table sat # Santali
|
||||
#text-table sd # Sindhi
|
||||
#text-table sk # Slovak
|
||||
#text-table sv # Swedish
|
||||
#text-table sw # Swahili
|
||||
#text-table ta # Tamil
|
||||
#text-table te # Telugu
|
||||
#text-table tr # Turkish
|
||||
#text-table vi # Vietnamese
|
||||
|
||||
# The attributes-table directive specifies which attributes table to use.
|
||||
# Relative paths are anchored at "/etc/brltty". If not specified,
|
||||
# "attributes" will be used.
|
||||
# (can be overridden with the -a [--attributes-table=] option)
|
||||
#attributes-table attributes #
|
||||
#attributes-table attrib #
|
||||
|
||||
# The contraction-table directive specifies which contraction table to use.
|
||||
# Relative paths are anchored at "/etc/brltty". If not specified, no
|
||||
# contraction table will be available.
|
||||
# (can be overridden with the -c [--contraction-table=] option)
|
||||
#contraction-table af # Afrikaans (contracted)
|
||||
#contraction-table am # Amharic (uncontracted)
|
||||
#contraction-table de-basis # German (uncontracted)
|
||||
#contraction-table de-kurzschrift # German (contracted - 1998 standard)
|
||||
#contraction-table de-vollschrift # German (basic contractions)
|
||||
#contraction-table en-ueb-g2 # Unified English Braille (grade 2)
|
||||
#contraction-table en-us-g2 # American English (grade 2)
|
||||
#contraction-table es # Spanish (grade 2)
|
||||
#contraction-table fr-abrege # French (contracted)
|
||||
#contraction-table fr-integral # French (uncontracted)
|
||||
#contraction-table ha # Hausa (contracted)
|
||||
#contraction-table id # Indonesian (contracted)
|
||||
#contraction-table ja # Japanese (uncontracted)
|
||||
#contraction-table ko-g1 # Korean (grade 1)
|
||||
#contraction-table ko-g2 # Korean (grade 2)
|
||||
#contraction-table ko # Korean (uncontracted)
|
||||
#contraction-table mg # Malagasy (contracted)
|
||||
#contraction-table mun # Munda (contracted)
|
||||
#contraction-table nl # Dutch (contracted)
|
||||
#contraction-table ny # Chichewa (contracted)
|
||||
#contraction-table ipa # International Phonetic Alphabet
|
||||
#contraction-table pt # Portuguese (grade 2)
|
||||
#contraction-table si # Sinhalese (uncontracted)
|
||||
#contraction-table sw # Swahili (contracted)
|
||||
#contraction-table th # Thai (contracted)
|
||||
#contraction-table zh-tw # Taiwanese Chinese (uncontracted)
|
||||
#contraction-table zh-tw-ucb # Taiwanese Chinese (Unique Chinese Braille)
|
||||
#contraction-table zu # Zulu (contracted)
|
||||
|
||||
|
||||
#############################
|
||||
# Braille Driver Parameters #
|
||||
#############################
|
||||
|
||||
# The braille-parameters directive passes non-generic parameters through
|
||||
# to the braille driver.
|
||||
# (can be overridden with the -B [--braille-parameters=] option)
|
||||
#braille-parameters driver:parameter=setting,...
|
||||
|
||||
# BrlAPI Braille Driver Parameters
|
||||
#braille-parameters ba:Auth=/etc/brlapi.key
|
||||
#braille-parameters ba:Host=:0
|
||||
|
||||
# BrailleLite Braille Driver Parameters
|
||||
#braille-parameters bl:BaudRate=9600 # [300,600,1200,2400,4800,9600,19200,38400]
|
||||
#braille-parameters bl:KbEmu=yes # [yes,no]
|
||||
|
||||
# Baum Braille Driver Parameters
|
||||
#braille-parameters bm:Protocols=default # [default,all,native]
|
||||
#braille-parameters bm:VarioKeys=no # [no,yes]
|
||||
|
||||
# EuroBraille Braille Driver Parameters
|
||||
#braille-parameters eu:Protocol= # [auto,azerbraille,clio,eurobraille,notebraille,pupibraille,scriba,esys,esytime,iris]
|
||||
|
||||
# HandyTech Braille Driver Parameters
|
||||
#braille-parameters ht:SetTime=no # [no,yes]
|
||||
|
||||
# Iris Braille Driver Parameters
|
||||
#braille-parameters ir:Embedded= # [no,yes]
|
||||
#braille-parameters ir:LatchDelay= # [0-10000]
|
||||
#braille-parameters ir:Protocol= # [eurobraille,native]
|
||||
|
||||
# Libbraille Braille Driver Parameters
|
||||
#braille-parameters lb:Device=/dev/ttyS0 #
|
||||
#braille-parameters lb:Driver=auto #
|
||||
#braille-parameters lb:Table=us.tbl #
|
||||
|
||||
# TTY Braille Driver Parameters
|
||||
#braille-parameters tt:Baud=9600 #
|
||||
#braille-parameters tt:CharSet=ISO8859-1 #
|
||||
#braille-parameters tt:Columns=40 # [1-80]
|
||||
#braille-parameters tt:Lines=1 # [1-3]
|
||||
#braille-parameters tt:Locale= #
|
||||
#braille-parameters tt:Term=vt100 # [terminfo]
|
||||
|
||||
# VisioBraille Braille Driver Parameters
|
||||
#braille-parameters vs:Baud=57600 #
|
||||
#braille-parameters vs:DisplaySize=40 # [20-40]
|
||||
#braille-parameters vs:PromVersion=4 # [3-6]
|
||||
|
||||
# XWindow Braille Driver Parameters
|
||||
#braille-parameters xw:Columns=40 # [1-80]
|
||||
#braille-parameters xw:Font=name # []
|
||||
#braille-parameters xw:Input=off # [off,on]
|
||||
#braille-parameters xw:Lines=1 # [1-3]
|
||||
#braille-parameters xw:Model=bare # [bare]
|
||||
#braille-parameters xw:TkParms= #
|
||||
|
||||
|
||||
###########################
|
||||
# Generic Speech Settings #
|
||||
###########################
|
||||
|
||||
# The speech-driver directive specifies the two-letter driver
|
||||
# identification code of the driver for the speech synthesizer.
|
||||
# If not specified, autodetection will be performed.
|
||||
# (can be overridden with the -s [--speech-driver=] option)
|
||||
#speech-driver auto # autodetect
|
||||
#speech-driver al # Alva
|
||||
#speech-driver bl # BrailleLite
|
||||
#speech-driver cb # CombiBraille
|
||||
#speech-driver es # eSpeak (text to speech engine)
|
||||
#speech-driver fl # FestivalLite (text to speech engine)
|
||||
#speech-driver fv # Festival (text to speech engine)
|
||||
#speech-driver gs # GenericSay (pipes to /usr/local/bin/say)
|
||||
#speech-driver mp # Mikropuhe (text to speech engine)
|
||||
#speech-driver sd # SpeechDispatcher (text to speech server)
|
||||
#speech-driver sw # Swift (text to speech engine)
|
||||
#speech-driver th # Theta (text to speech engine)
|
||||
#speech-driver vv # ViaVoice (text to speech engine)
|
||||
#speech-driver xs # ExternalSpeech (executes /usr/local/bin/externalspeech)
|
||||
|
||||
# The speech-input directive specifies the name of the file system object
|
||||
# (FIFO, named pipe, named socket, etc) which can be used by external
|
||||
# applications for text-to-speech conversion via BRLTTY's speech driver.
|
||||
# Relative paths are anchored at the current working directory. If not
|
||||
# specified, the file system object isn't created.
|
||||
# (can be overridden with the -i [--speech-input=] option)
|
||||
#speech-input /path/to/file-system-object
|
||||
|
||||
|
||||
############################
|
||||
# Speech Driver Parameters #
|
||||
############################
|
||||
|
||||
# The speech-parameters directive passes non-generic parameters through
|
||||
# to the speech driver.
|
||||
# (can be overridden with the -S [--speech-parameters=] option)
|
||||
#speech-parameters driver:parameter=setting,...
|
||||
|
||||
# eSpeak Speech Driver Parameters
|
||||
#speech-parameters es:Path=
|
||||
#speech-parameters es:PunctList=
|
||||
#speech-parameters es:Voice=
|
||||
|
||||
# ExternalSpeech Speech Driver Parameters
|
||||
#speech-parameters xs:Program=/usr/local/bin/externalspeech
|
||||
#speech-parameters xs:Uid=65534
|
||||
#speech-parameters xs:Gid=65534
|
||||
|
||||
# Festival Speech Driver Parameters
|
||||
#speech-parameters fv:Command=festival # [/path/to/command]
|
||||
#speech-parameters fv:Name= # [kevin,kal]
|
||||
|
||||
# FestivalLite Speech Driver Parameters
|
||||
#speech-parameters fl:Pitch=100 # [50-200]
|
||||
|
||||
# GenericSay Speech Driver Parameters
|
||||
#speech-parameters gs:Command=/usr/local/bin/say
|
||||
|
||||
# Mikropuhe Speech Driver Parameters
|
||||
#speech-parameters mp:Name= # [/path/to/mikropuhe/name.pu5]
|
||||
#speech-parameters mp:Pitch=0 # [-10-10]
|
||||
|
||||
# SpeechDispatcher Speech Driver Parameters
|
||||
#speech-parameters sd:Language= # [two-letter language code]
|
||||
#speech-parameters sd:Module= # [flite,festival,epos-generic,dtk-generic,...]
|
||||
#speech-parameters sd:Port=6560 # [1-65535] # [1-65535]
|
||||
#speech-parameters sd:Voice= # [male1,female1,male2,female2,male3,female3,child_male,child_female]
|
||||
|
||||
# Swift Speech Driver Parameters
|
||||
#speech-parameters sw:Name= # [voice,/path/to/voice]
|
||||
|
||||
# Theta Speech Driver Parameters
|
||||
#speech-parameters th:Age= # [1-99,-1--99]
|
||||
#speech-parameters th:Gender= # [male,female,neuter]
|
||||
#speech-parameters th:Language= # [two-letter language code]
|
||||
#speech-parameters th:Name= # [voice,/path/to/voice]
|
||||
#speech-parameters th:Pitch=0.0 # [-2.0-2.0]
|
||||
|
||||
# ViaVoice Speech Driver Parameters
|
||||
#speech-parameters vv:IniFile=/usr/lib/ViaVoiceTTS/eci.ini
|
||||
#speech-parameters vv:SampleRate= # [8000,11025,22050]
|
||||
#speech-parameters vv:AbbreviationMode= # [on,off]
|
||||
#speech-parameters vv:NumberMode= # [word,year]
|
||||
#speech-parameters vv:SynthMode= # [sentence,none]
|
||||
#speech-parameters vv:TextMode= # [talk,spell,literal,phonetic]
|
||||
#speech-parameters vv:Language= # [AmericanEnglish,BritishEnglish,CastilianSpanish,MexicanSpanish,StandardFrench,CanadianFrench,StandardGerman,StandardItalian,SimplifiedChinese,BrazilianPortuguese]
|
||||
#speech-parameters vv:Voice= # [AdultMale,AdultFemale,Child,ElderlyFemale,ElderlyMale]
|
||||
#speech-parameters vv:VocalTract= # [male,female]
|
||||
#speech-parameters vv:Breathiness= # [0-100]
|
||||
#speech-parameters vv:HeadSize= # [0-100]
|
||||
#speech-parameters vv:PitchBaseline= # [0-100]
|
||||
#speech-parameters vv:PitchFluctuation= # [0-100]
|
||||
#speech-parameters vv:Roughness= # [0-100]
|
||||
|
||||
|
||||
#####################
|
||||
# Keyboard Settings #
|
||||
#####################
|
||||
|
||||
# The key-table directive specifies which key table to use. Relative paths are
|
||||
# anchored at "/etc/brltty". If not specified, no key table is used.
|
||||
# (can be overridden with the -k [--key-table=] option)
|
||||
#key-table desktop # bindings for full keyboards
|
||||
#key-table keypad # bindings for keypad-based navigation
|
||||
#key-table laptop # bindings for keyboards without a keypad
|
||||
|
||||
# The keyboard-properties directive specifies which keyboards to monitor.
|
||||
# If not specified, all keyboards are monitored.
|
||||
# (can be overridden with the -K [--keyboard-properties=] option)
|
||||
#keyboard-properties Type=any # [any,ps2,usb,bluetooth]
|
||||
#keyboard-properties Vendor=0X0000 # [0X0000-0XFFFF]
|
||||
#keyboard-properties Product=0X0000 # [0X0000-0XFFFF]
|
||||
|
||||
|
||||
##################
|
||||
# Sound Settings #
|
||||
##################
|
||||
|
||||
# The pcm-device directive specifies the device to use for soundcard
|
||||
# digital audio. If not specified, a method- and system-dependent
|
||||
# default will be used.
|
||||
# (can be overridden with the -p [--pcm-device=] option)
|
||||
#pcm-device /path/to/device # most methods
|
||||
#pcm-device pcm-handle-id # ALSA (see second parameter of snd_pcm_open)
|
||||
|
||||
# The midi-device directive specifies the device to use for the Musical
|
||||
# Instrument Digital Interface. If not specified, a method- and
|
||||
# system-dependent default will be used.
|
||||
# (can be overridden with the -m [--midi-device=] option)
|
||||
#midi-device /path/to/device # most methods
|
||||
#midi-device client:port # ALSA (may use number or case-sensitive substring of name)
|
||||
|
||||
|
||||
##########################
|
||||
# Miscellaneous Settings #
|
||||
##########################
|
||||
|
||||
# The preferences-file directive specifies the file in which to save the user's
|
||||
# preferences. Relative paths are anchored at "@STATE_DIRECTORY@". If not
|
||||
# specified, "@PREFERENCES_FILE@" will be used.
|
||||
# (can be overridden with the -F [--preferences-file=] option)
|
||||
#preferences-file @PREFERENCES_FILE@
|
||||
|
||||
# The log-level directive specifies the severity threshold for diagnostics
|
||||
# written to the system log. Less severe diagnostics will not be logged. If not
|
||||
# specified, "notice" will be used.
|
||||
# (can be overridden with the -l [--log-level=] option)
|
||||
#log-level emergency
|
||||
#log-level alert
|
||||
#log-level critical
|
||||
#log-level error
|
||||
#log-level warning
|
||||
#log-level notice
|
||||
#log-level information
|
||||
#log-level debug
|
||||
|
||||
# The log-file directive specifies the file to which diagnostics are written.
|
||||
# Relative paths are anchored at the current working directory. If not
|
||||
# specified, diagnostics are written to the system log.
|
||||
# (can be overridden with the -L [--log-file=] option)
|
||||
#log-file /tmp/brltty.log
|
||||
|
||||
# The drivers-directory directive specifies the absolute path to the
|
||||
# directory which contains the dynamically loadable drivers. If not
|
||||
# specified, /lib/brltty will be used.
|
||||
# (can be overridden with the -D [--drivers-directory=] option)
|
||||
#drivers-directory /lib/brltty
|
||||
|
||||
# The writable-directory directive specifies the absolute path to a directory
|
||||
# which can be written to (creation of missing but needed resources, etc). If
|
||||
# not specified, "/lib/brltty/rw" will be used.
|
||||
# (can be overridden with the -W [--writable-directory=] option)
|
||||
#writable-directory /lib/brltty/rw
|
||||
|
||||
# The tables-directory directive specifies the absolute path to the directory
|
||||
# which contains the text, attributes, contraction, and key tables. If not
|
||||
# specified, "/etc/brltty" will be used.
|
||||
# (can be overridden with the -T [--tables-directory=] option)
|
||||
#tables-directory /etc/brltty
|
||||
|
||||
|
||||
################################################
|
||||
# Application Programming Interface Parameters #
|
||||
################################################
|
||||
|
||||
# The api-parameters directive passes parameters to the Application
|
||||
# Programming Interface.
|
||||
# (can be overridden with the -A [--api-parameters=] option)
|
||||
#api-parameters parameter=setting,...
|
||||
|
||||
#api-parameters Auth=keyfile:/etc/brlapi.key # Require authentication key
|
||||
#api-parameters Auth=user:joe # Allow some local user
|
||||
#api-parameters Auth=group:brl # Allow some local group
|
||||
#api-parameters Host=:0 # Accept only local Unix connections
|
||||
#api-parameters Host=0.0.0.0:0 # Accept any internet connection.
|
||||
#api-parameters StackSize=65536
|
||||
|
||||
|
||||
###########################
|
||||
# Generic Screen Settings #
|
||||
###########################
|
||||
|
||||
# The screen-driver directive specifies the two-letter driver
|
||||
# identification code of the driver for the console screen.
|
||||
# (can be overridden with the -x [--screen-driver=] option)
|
||||
#screen-driver as # AtSpi
|
||||
#screen-driver pb # PCBIOS
|
||||
#screen-driver hd # Hurd
|
||||
#screen-driver lx # Linux
|
||||
#screen-driver sc # Screen
|
||||
#screen-driver wn # Windows
|
||||
|
||||
|
||||
############################
|
||||
# Screen Driver Parameters #
|
||||
############################
|
||||
|
||||
# The screen-parameters directive passes non-generic parameters through
|
||||
# to the screen driver.
|
||||
# (can be overridden with the -X [--screen-parameters=] option)
|
||||
#screen-parameters driver:parameter=setting,...
|
||||
|
||||
# AtSpi Screen Driver Parameters
|
||||
#screen-parameters as:Type=text+terminal # [text,terminal,all]
|
||||
|
||||
# Linux Screen Driver Parameters
|
||||
#screen-parameters lx:Charset=name+... # []
|
||||
#screen-parameters lx:DebugSfm=no # [no,yes]
|
||||
#screen-parameters lx:Hfb=auto # [auto,vga,fb,0-7]
|
||||
|
||||
# Windows Screen Driver Parameters
|
||||
#screen-parameters wn:Root=no # [no,yes]
|
||||
#screen-parameters wn:FollowFocus=yes # [yes,no]
|
||||
|
||||
|
||||
@@ -0,0 +1,521 @@
|
||||
# This is a configuration file template for the BRLTTY application.
|
||||
# Uncomment those entries which apply to your personal needs and system
|
||||
# requirements.
|
||||
|
||||
# BRLTTY expects to find its configuration file in "@CONFIGURATION_DIRECTORY@/@CONFIGURATION_FILE@"
|
||||
# (can be overridden with the -f [--configuration-file=] option).
|
||||
# If it doesn't exist, then BRLTTY silently continues but may require
|
||||
# that certain command line options be explicitly supplied.
|
||||
|
||||
# Blank lines are ignored. The character '#', anywhere on a line,
|
||||
# initiates a comment; all characters from it to the end of that line
|
||||
# are ignored.
|
||||
|
||||
# Each configuration entry consists of a keyword followed by its operand.
|
||||
# An arbitrary amount of white space, (blanks and/or tabs), may occur
|
||||
# before the keyword, as well as before and after the operand. Keyword
|
||||
# processing is not case sensitive. Examples of valid entries are:
|
||||
#
|
||||
# Braille-Driver pm # Papenmeier braille displays.
|
||||
# braille-device serial:@first_serial_device@ # The first serial device.
|
||||
# SPEECH-DRIVER fv # The Festival Text to Speech System.
|
||||
|
||||
# The default settings given within the following descriptions assume no
|
||||
# special build options (see "./configure --help" in the top-level
|
||||
# directory of the source tree.
|
||||
|
||||
|
||||
############################
|
||||
# Generic Braille Settings #
|
||||
############################
|
||||
|
||||
# The braille-driver directive specifies the two-letter driver
|
||||
# identification code of the driver for the braille display.
|
||||
# If not specified, autodetection will be performed.
|
||||
# (can be overridden with the -b [--braille-driver=] option)
|
||||
#braille-driver auto # autodetect
|
||||
#braille-driver al # Alva
|
||||
#braille-driver at # Albatross
|
||||
#braille-driver ba # BrlAPI
|
||||
#braille-driver bc # BrailComm
|
||||
#braille-driver bd # Braudi
|
||||
#braille-driver bl # BrailleLite
|
||||
#braille-driver bm # Baum
|
||||
#braille-driver bn # BrailleNote
|
||||
#braille-driver cb # CombiBraille
|
||||
#braille-driver ec # EcoBraille
|
||||
#braille-driver eu # EuroBraille
|
||||
#braille-driver fs # FreedomScientific
|
||||
#braille-driver hm # HIMS
|
||||
#braille-driver ht # HandyTech
|
||||
#braille-driver hw # HumanWare
|
||||
#braille-driver il # IrisLinux
|
||||
#braille-driver lb # Libbraille
|
||||
#braille-driver lt # LogText
|
||||
#braille-driver mb # MultiBraille
|
||||
#braille-driver md # MDV (protocol 5)
|
||||
#braille-driver mn # MiniBraille
|
||||
#braille-driver mt # Metec
|
||||
#braille-driver pg # Pegasus
|
||||
#braille-driver pm # Papenmeier
|
||||
#braille-driver sk # Seika
|
||||
#braille-driver tn # TechniBraille
|
||||
#braille-driver ts # TSI
|
||||
#braille-driver tt # TTY
|
||||
#braille-driver vd # VideoBraille
|
||||
#braille-driver vo # Voyager, Part232 (serial adapter), BraillePen/EasyLink
|
||||
#braille-driver vr # Virtual
|
||||
#braille-driver vs # VisioBraille
|
||||
#braille-driver xw # XWindow
|
||||
|
||||
# The braille-device directive specifies the device to which the braille
|
||||
# display is connected. The generic syntax is type:device. The device
|
||||
# type is optional, and, for backward compatibility, defaults to serial.
|
||||
# The following devices are supported (brackets indicate optionality):
|
||||
# serial:path (relative paths are anchored at "/dev")
|
||||
# usb:[serial-number]
|
||||
# bluetooth:address
|
||||
# If not specified, "@braille_device@" will be used.
|
||||
# (can be overridden with the -d [--braille-device=] option)
|
||||
#braille-device serial:@first_serial_device@ # First serial device.
|
||||
#braille-device usb: # First USB device matching braille driver.
|
||||
#braille-device usb:nnnnn # Specific USB device by serial number.
|
||||
#braille-device bluetooth:xx:xx:xx:xx:xx:xx # Specific bluetooth device by address.
|
||||
#
|
||||
# NOTE: If the device is connected via a serial-to-USB adapter then setting
|
||||
# braille-device to usb: will not work. In this case it needs to identify the
|
||||
# virtual serial device which the kernel has created for the adapter, i.e. to
|
||||
# something like serial:ttyUSB0 (see the kernel messages on device plug to get
|
||||
# the actual device name).
|
||||
|
||||
# The release-device directive specifies whether or not the device to which the
|
||||
# braille display is connected is to be released when the current screen or
|
||||
# window can't be read by BRLTTY. If not specified, "on" will be used on Windows
|
||||
# platforms and "off" will be used on all other platforms.
|
||||
# (can be overridden with the -r [--release-device] option)
|
||||
#release-device on # Release the device.
|
||||
#release-device off # Don't release the device.
|
||||
|
||||
# The text-table directive specifies which text table to use. Relative paths
|
||||
# are anchored at "@TABLES_DIRECTORY@". If not specified, locale-based
|
||||
# autoselection with fallback to "@text_table@" will be performed.
|
||||
# (can be overridden with the -t [--text-table=] option)
|
||||
#text-table auto # locale-based autoselection (fallback to "@text_table@")
|
||||
#text-table ar # Arabic (generic)
|
||||
#text-table as # Assamese
|
||||
#text-table awa # Awadhi
|
||||
#text-table bg # Bulgarian
|
||||
#text-table bh # Bihari
|
||||
#text-table bn # Bengali
|
||||
#text-table bo # Tibetan
|
||||
#text-table bra # Braj
|
||||
#text-table cs # Czech
|
||||
#text-table cy # Welsh
|
||||
#text-table da # Danish
|
||||
#text-table de # German
|
||||
#text-table dra # Dravidian
|
||||
#text-table el # Greek
|
||||
#text-table en # English
|
||||
#text-table en_CA # English (Canada)
|
||||
#text-table en_GB # English (United Kingdom)
|
||||
#text-table en_US # English (United States)
|
||||
#text-table en-nabcc # English (North American Braille Computer Code)
|
||||
#text-table eo # Esperanto
|
||||
#text-table es # Spanish
|
||||
#text-table et # Estonian
|
||||
#text-table fi # Finnish
|
||||
#text-table fr # French
|
||||
#text-table fr_CA # French (Canada)
|
||||
#text-table fr_FR # French (France)
|
||||
#text-table fr-2007 # French (unified)
|
||||
#text-table fr-cbifs # French (Code Braille Informatique Français Standard)
|
||||
#text-table ga # Irish
|
||||
#text-table gd # Gaelic
|
||||
#text-table gon # Gondi
|
||||
#text-table gu # Gujarati
|
||||
#text-table he # Hebrew
|
||||
#text-table hi # Hindi
|
||||
#text-table hr # Croatian
|
||||
#text-table hu # Hungarian
|
||||
#text-table hy # Armenian
|
||||
#text-table is # Icelandic
|
||||
#text-table it # Italian
|
||||
#text-table kha # Khasi
|
||||
#text-table kn # Kannada
|
||||
#text-table kok # Konkani
|
||||
#text-table kru # Kurukh
|
||||
#text-table lt # Lituanian
|
||||
#text-table lv # Latvian
|
||||
#text-table mg # Malagasy
|
||||
#text-table mi # Maori
|
||||
#text-table ml # Malayalam
|
||||
#text-table mni # Manipuri
|
||||
#text-table mr # Marathi
|
||||
#text-table mt # Maltese
|
||||
#text-table mun # Mundari
|
||||
#text-table mwr # Marwari
|
||||
#text-table ne # Nepali
|
||||
#text-table new # Newari
|
||||
#text-table nl # Dutch
|
||||
#text-table nl_BE # Dutch (Belgium)
|
||||
#text-table nl_NL # Dutch (Netherlands)
|
||||
#text-table no # Norwegian
|
||||
#text-table no-generic # Norwegian (with support for other languages)
|
||||
#text-table no-oub # Norwegian (Offentlig Utvalg for Blindeskrift)
|
||||
#text-table nwc # Old Newari
|
||||
#text-table or # Oriya
|
||||
#text-table pa # Panjabi
|
||||
#text-table pi # Pali
|
||||
#text-table pl # Polish
|
||||
#text-table pt # Portuguese
|
||||
#text-table ro # Romanian
|
||||
#text-table ru # Russian
|
||||
#text-table sa # Sanskrit
|
||||
#text-table sat # Santali
|
||||
#text-table sd # Sindhi
|
||||
#text-table sk # Slovak
|
||||
#text-table sv # Swedish
|
||||
#text-table sw # Swahili
|
||||
#text-table ta # Tamil
|
||||
#text-table te # Telugu
|
||||
#text-table tr # Turkish
|
||||
#text-table vi # Vietnamese
|
||||
|
||||
# The attributes-table directive specifies which attributes table to use.
|
||||
# Relative paths are anchored at "@TABLES_DIRECTORY@". If not specified,
|
||||
# "@attributes_table@" will be used.
|
||||
# (can be overridden with the -a [--attributes-table=] option)
|
||||
#attributes-table attributes #
|
||||
#attributes-table attrib #
|
||||
|
||||
# The contraction-table directive specifies which contraction table to use.
|
||||
# Relative paths are anchored at "@TABLES_DIRECTORY@". If not specified, no
|
||||
# contraction table will be available.
|
||||
# (can be overridden with the -c [--contraction-table=] option)
|
||||
#contraction-table af # Afrikaans (contracted)
|
||||
#contraction-table am # Amharic (uncontracted)
|
||||
#contraction-table de-basis # German (uncontracted)
|
||||
#contraction-table de-kurzschrift # German (contracted - 1998 standard)
|
||||
#contraction-table de-vollschrift # German (basic contractions)
|
||||
#contraction-table en-ueb-g2 # Unified English Braille (grade 2)
|
||||
#contraction-table en-us-g2 # American English (grade 2)
|
||||
#contraction-table es # Spanish (grade 2)
|
||||
#contraction-table fr-abrege # French (contracted)
|
||||
#contraction-table fr-integral # French (uncontracted)
|
||||
#contraction-table ha # Hausa (contracted)
|
||||
#contraction-table id # Indonesian (contracted)
|
||||
#contraction-table ja # Japanese (uncontracted)
|
||||
#contraction-table ko-g1 # Korean (grade 1)
|
||||
#contraction-table ko-g2 # Korean (grade 2)
|
||||
#contraction-table ko # Korean (uncontracted)
|
||||
#contraction-table mg # Malagasy (contracted)
|
||||
#contraction-table mun # Munda (contracted)
|
||||
#contraction-table nl # Dutch (contracted)
|
||||
#contraction-table ny # Chichewa (contracted)
|
||||
#contraction-table ipa # International Phonetic Alphabet
|
||||
#contraction-table pt # Portuguese (grade 2)
|
||||
#contraction-table si # Sinhalese (uncontracted)
|
||||
#contraction-table sw # Swahili (contracted)
|
||||
#contraction-table th # Thai (contracted)
|
||||
#contraction-table zh-tw # Taiwanese Chinese (uncontracted)
|
||||
#contraction-table zh-tw-ucb # Taiwanese Chinese (Unique Chinese Braille)
|
||||
#contraction-table zu # Zulu (contracted)
|
||||
|
||||
|
||||
#############################
|
||||
# Braille Driver Parameters #
|
||||
#############################
|
||||
|
||||
# The braille-parameters directive passes non-generic parameters through
|
||||
# to the braille driver.
|
||||
# (can be overridden with the -B [--braille-parameters=] option)
|
||||
#braille-parameters driver:parameter=setting,...
|
||||
|
||||
# BrlAPI Braille Driver Parameters
|
||||
#braille-parameters ba:Auth=@CONFIGURATION_DIRECTORY@/@api_authkeyfile@
|
||||
#braille-parameters ba:Host=:0
|
||||
|
||||
# BrailleLite Braille Driver Parameters
|
||||
#braille-parameters bl:BaudRate=9600 # [300,600,1200,2400,4800,9600,19200,38400]
|
||||
#braille-parameters bl:KbEmu=yes # [yes,no]
|
||||
|
||||
# Baum Braille Driver Parameters
|
||||
#braille-parameters bm:Protocols=default # [default,all,native]
|
||||
#braille-parameters bm:VarioKeys=no # [no,yes]
|
||||
|
||||
# EuroBraille Braille Driver Parameters
|
||||
#braille-parameters eu:Protocol= # [auto,azerbraille,clio,eurobraille,notebraille,pupibraille,scriba,esys,esytime,iris]
|
||||
|
||||
# HandyTech Braille Driver Parameters
|
||||
#braille-parameters ht:SetTime=no # [no,yes]
|
||||
|
||||
# Iris Braille Driver Parameters
|
||||
#braille-parameters ir:Embedded= # [no,yes]
|
||||
#braille-parameters ir:LatchDelay= # [0-10000]
|
||||
#braille-parameters ir:Protocol= # [eurobraille,native]
|
||||
|
||||
# Libbraille Braille Driver Parameters
|
||||
#braille-parameters lb:Device=/dev/ttyS0 #
|
||||
#braille-parameters lb:Driver=auto #
|
||||
#braille-parameters lb:Table=us.tbl #
|
||||
|
||||
# TTY Braille Driver Parameters
|
||||
#braille-parameters tt:Baud=9600 #
|
||||
#braille-parameters tt:CharSet=ISO8859-1 #
|
||||
#braille-parameters tt:Columns=40 # [1-80]
|
||||
#braille-parameters tt:Lines=1 # [1-3]
|
||||
#braille-parameters tt:Locale= #
|
||||
#braille-parameters tt:Term=vt100 # [terminfo]
|
||||
|
||||
# VisioBraille Braille Driver Parameters
|
||||
#braille-parameters vs:Baud=57600 #
|
||||
#braille-parameters vs:DisplaySize=40 # [20-40]
|
||||
#braille-parameters vs:PromVersion=4 # [3-6]
|
||||
|
||||
# XWindow Braille Driver Parameters
|
||||
#braille-parameters xw:Columns=40 # [1-80]
|
||||
#braille-parameters xw:Font=name # []
|
||||
#braille-parameters xw:Input=off # [off,on]
|
||||
#braille-parameters xw:Lines=1 # [1-3]
|
||||
#braille-parameters xw:Model=bare # [bare]
|
||||
#braille-parameters xw:TkParms= #
|
||||
|
||||
|
||||
###########################
|
||||
# Generic Speech Settings #
|
||||
###########################
|
||||
|
||||
# The speech-driver directive specifies the two-letter driver
|
||||
# identification code of the driver for the speech synthesizer.
|
||||
# If not specified, autodetection will be performed.
|
||||
# (can be overridden with the -s [--speech-driver=] option)
|
||||
#speech-driver auto # autodetect
|
||||
#speech-driver al # Alva
|
||||
#speech-driver bl # BrailleLite
|
||||
#speech-driver cb # CombiBraille
|
||||
#speech-driver es # eSpeak (text to speech engine)
|
||||
#speech-driver fl # FestivalLite (text to speech engine)
|
||||
#speech-driver fv # Festival (text to speech engine)
|
||||
#speech-driver gs # GenericSay (pipes to /usr/local/bin/say)
|
||||
#speech-driver mp # Mikropuhe (text to speech engine)
|
||||
#speech-driver sd # SpeechDispatcher (text to speech server)
|
||||
#speech-driver sw # Swift (text to speech engine)
|
||||
#speech-driver th # Theta (text to speech engine)
|
||||
#speech-driver vv # ViaVoice (text to speech engine)
|
||||
#speech-driver xs # ExternalSpeech (executes /usr/local/bin/externalspeech)
|
||||
|
||||
# The speech-input directive specifies the name of the file system object
|
||||
# (FIFO, named pipe, named socket, etc) which can be used by external
|
||||
# applications for text-to-speech conversion via BRLTTY's speech driver.
|
||||
# Relative paths are anchored at the current working directory. If not
|
||||
# specified, the file system object isn't created.
|
||||
# (can be overridden with the -i [--speech-input=] option)
|
||||
#speech-input /path/to/file-system-object
|
||||
|
||||
|
||||
############################
|
||||
# Speech Driver Parameters #
|
||||
############################
|
||||
|
||||
# The speech-parameters directive passes non-generic parameters through
|
||||
# to the speech driver.
|
||||
# (can be overridden with the -S [--speech-parameters=] option)
|
||||
#speech-parameters driver:parameter=setting,...
|
||||
|
||||
# eSpeak Speech Driver Parameters
|
||||
#speech-parameters es:Path=
|
||||
#speech-parameters es:PunctList=
|
||||
#speech-parameters es:Voice=
|
||||
|
||||
# ExternalSpeech Speech Driver Parameters
|
||||
#speech-parameters xs:Program=/usr/local/bin/externalspeech
|
||||
#speech-parameters xs:Uid=65534
|
||||
#speech-parameters xs:Gid=65534
|
||||
|
||||
# Festival Speech Driver Parameters
|
||||
#speech-parameters fv:Command=festival # [/path/to/command]
|
||||
#speech-parameters fv:Name= # [kevin,kal]
|
||||
|
||||
# FestivalLite Speech Driver Parameters
|
||||
#speech-parameters fl:Pitch=100 # [50-200]
|
||||
|
||||
# GenericSay Speech Driver Parameters
|
||||
#speech-parameters gs:Command=/usr/local/bin/say
|
||||
|
||||
# Mikropuhe Speech Driver Parameters
|
||||
#speech-parameters mp:Name= # [/path/to/mikropuhe/name.pu5]
|
||||
#speech-parameters mp:Pitch=0 # [-10-10]
|
||||
|
||||
# SpeechDispatcher Speech Driver Parameters
|
||||
#speech-parameters sd:Language= # [two-letter language code]
|
||||
#speech-parameters sd:Module= # [flite,festival,epos-generic,dtk-generic,...]
|
||||
#speech-parameters sd:Port=6560 # [1-65535] # [1-65535]
|
||||
#speech-parameters sd:Voice= # [male1,female1,male2,female2,male3,female3,child_male,child_female]
|
||||
|
||||
# Swift Speech Driver Parameters
|
||||
#speech-parameters sw:Name= # [voice,/path/to/voice]
|
||||
|
||||
# Theta Speech Driver Parameters
|
||||
#speech-parameters th:Age= # [1-99,-1--99]
|
||||
#speech-parameters th:Gender= # [male,female,neuter]
|
||||
#speech-parameters th:Language= # [two-letter language code]
|
||||
#speech-parameters th:Name= # [voice,/path/to/voice]
|
||||
#speech-parameters th:Pitch=0.0 # [-2.0-2.0]
|
||||
|
||||
# ViaVoice Speech Driver Parameters
|
||||
#speech-parameters vv:IniFile=/usr/lib/ViaVoiceTTS/eci.ini
|
||||
#speech-parameters vv:SampleRate= # [8000,11025,22050]
|
||||
#speech-parameters vv:AbbreviationMode= # [on,off]
|
||||
#speech-parameters vv:NumberMode= # [word,year]
|
||||
#speech-parameters vv:SynthMode= # [sentence,none]
|
||||
#speech-parameters vv:TextMode= # [talk,spell,literal,phonetic]
|
||||
#speech-parameters vv:Language= # [AmericanEnglish,BritishEnglish,CastilianSpanish,MexicanSpanish,StandardFrench,CanadianFrench,StandardGerman,StandardItalian,SimplifiedChinese,BrazilianPortuguese]
|
||||
#speech-parameters vv:Voice= # [AdultMale,AdultFemale,Child,ElderlyFemale,ElderlyMale]
|
||||
#speech-parameters vv:VocalTract= # [male,female]
|
||||
#speech-parameters vv:Breathiness= # [0-100]
|
||||
#speech-parameters vv:HeadSize= # [0-100]
|
||||
#speech-parameters vv:PitchBaseline= # [0-100]
|
||||
#speech-parameters vv:PitchFluctuation= # [0-100]
|
||||
#speech-parameters vv:Roughness= # [0-100]
|
||||
|
||||
|
||||
#####################
|
||||
# Keyboard Settings #
|
||||
#####################
|
||||
|
||||
# The key-table directive specifies which key table to use. Relative paths are
|
||||
# anchored at "@TABLES_DIRECTORY@". If not specified, no key table is used.
|
||||
# (can be overridden with the -k [--key-table=] option)
|
||||
#key-table desktop # bindings for full keyboards
|
||||
#key-table keypad # bindings for keypad-based navigation
|
||||
#key-table laptop # bindings for keyboards without a keypad
|
||||
|
||||
# The keyboard-properties directive specifies which keyboards to monitor.
|
||||
# If not specified, all keyboards are monitored.
|
||||
# (can be overridden with the -K [--keyboard-properties=] option)
|
||||
#keyboard-properties Type=any # [any,ps2,usb,bluetooth]
|
||||
#keyboard-properties Vendor=0X0000 # [0X0000-0XFFFF]
|
||||
#keyboard-properties Product=0X0000 # [0X0000-0XFFFF]
|
||||
|
||||
|
||||
##################
|
||||
# Sound Settings #
|
||||
##################
|
||||
|
||||
# The pcm-device directive specifies the device to use for soundcard
|
||||
# digital audio. If not specified, a method- and system-dependent
|
||||
# default will be used.
|
||||
# (can be overridden with the -p [--pcm-device=] option)
|
||||
#pcm-device /path/to/device # most methods
|
||||
#pcm-device pcm-handle-id # ALSA (see second parameter of snd_pcm_open)
|
||||
|
||||
# The midi-device directive specifies the device to use for the Musical
|
||||
# Instrument Digital Interface. If not specified, a method- and
|
||||
# system-dependent default will be used.
|
||||
# (can be overridden with the -m [--midi-device=] option)
|
||||
#midi-device /path/to/device # most methods
|
||||
#midi-device client:port # ALSA (may use number or case-sensitive substring of name)
|
||||
|
||||
|
||||
##########################
|
||||
# Miscellaneous Settings #
|
||||
##########################
|
||||
|
||||
# The preferences-file directive specifies the file in which to save the user's
|
||||
# preferences. Relative paths are anchored at "@STATE_DIRECTORY@". If not
|
||||
# specified, "@PREFERENCES_FILE@" will be used.
|
||||
# (can be overridden with the -F [--preferences-file=] option)
|
||||
#preferences-file @PREFERENCES_FILE@
|
||||
|
||||
# The log-level directive specifies the severity threshold for diagnostics
|
||||
# written to the system log. Less severe diagnostics will not be logged. If not
|
||||
# specified, "notice" will be used.
|
||||
# (can be overridden with the -l [--log-level=] option)
|
||||
#log-level emergency
|
||||
#log-level alert
|
||||
#log-level critical
|
||||
#log-level error
|
||||
#log-level warning
|
||||
#log-level notice
|
||||
#log-level information
|
||||
#log-level debug
|
||||
|
||||
# The log-file directive specifies the file to which diagnostics are written.
|
||||
# Relative paths are anchored at the current working directory. If not
|
||||
# specified, diagnostics are written to the system log.
|
||||
# (can be overridden with the -L [--log-file=] option)
|
||||
#log-file /tmp/brltty.log
|
||||
|
||||
# The drivers-directory directive specifies the absolute path to the
|
||||
# directory which contains the dynamically loadable drivers. If not
|
||||
# specified, @DRIVERS_DIRECTORY@ will be used.
|
||||
# (can be overridden with the -D [--drivers-directory=] option)
|
||||
#drivers-directory @DRIVERS_DIRECTORY@
|
||||
|
||||
# The writable-directory directive specifies the absolute path to a directory
|
||||
# which can be written to (creation of missing but needed resources, etc). If
|
||||
# not specified, "@WRITABLE_DIRECTORY@" will be used.
|
||||
# (can be overridden with the -W [--writable-directory=] option)
|
||||
#writable-directory @WRITABLE_DIRECTORY@
|
||||
|
||||
# The tables-directory directive specifies the absolute path to the directory
|
||||
# which contains the text, attributes, contraction, and key tables. If not
|
||||
# specified, "@TABLES_DIRECTORY@" will be used.
|
||||
# (can be overridden with the -T [--tables-directory=] option)
|
||||
#tables-directory @TABLES_DIRECTORY@
|
||||
|
||||
|
||||
################################################
|
||||
# Application Programming Interface Parameters #
|
||||
################################################
|
||||
|
||||
# The api-parameters directive passes parameters to the Application
|
||||
# Programming Interface.
|
||||
# (can be overridden with the -A [--api-parameters=] option)
|
||||
#api-parameters parameter=setting,...
|
||||
|
||||
#api-parameters Auth=keyfile:@CONFIGURATION_DIRECTORY@/@api_authkeyfile@ # Require authentication key
|
||||
#api-parameters Auth=user:joe # Allow some local user
|
||||
#api-parameters Auth=group:brl # Allow some local group
|
||||
#api-parameters Host=:0 # Accept only local Unix connections
|
||||
#api-parameters Host=0.0.0.0:0 # Accept any internet connection.
|
||||
#api-parameters StackSize=65536
|
||||
|
||||
|
||||
###########################
|
||||
# Generic Screen Settings #
|
||||
###########################
|
||||
|
||||
# The screen-driver directive specifies the two-letter driver
|
||||
# identification code of the driver for the console screen.
|
||||
# (can be overridden with the -x [--screen-driver=] option)
|
||||
#screen-driver as # AtSpi
|
||||
#screen-driver pb # PCBIOS
|
||||
#screen-driver hd # Hurd
|
||||
#screen-driver lx # Linux
|
||||
#screen-driver sc # Screen
|
||||
#screen-driver wn # Windows
|
||||
|
||||
|
||||
############################
|
||||
# Screen Driver Parameters #
|
||||
############################
|
||||
|
||||
# The screen-parameters directive passes non-generic parameters through
|
||||
# to the screen driver.
|
||||
# (can be overridden with the -X [--screen-parameters=] option)
|
||||
#screen-parameters driver:parameter=setting,...
|
||||
|
||||
# AtSpi Screen Driver Parameters
|
||||
#screen-parameters as:Type=text+terminal # [text,terminal,all]
|
||||
|
||||
# Linux Screen Driver Parameters
|
||||
#screen-parameters lx:Charset=name+... # []
|
||||
#screen-parameters lx:DebugSfm=no # [no,yes]
|
||||
#screen-parameters lx:Hfb=auto # [auto,vga,fb,0-7]
|
||||
|
||||
# Windows Screen Driver Parameters
|
||||
#screen-parameters wn:Root=no # [no,yes]
|
||||
#screen-parameters wn:FollowFocus=yes # [yes,no]
|
||||
|
||||
|
||||
@@ -0,0 +1,88 @@
|
||||
Begin4
|
||||
Title: brltty
|
||||
Version: 4.3
|
||||
Entered-date: 2011/10/10
|
||||
Description: Braille Display Driver for Linux/Unix
|
||||
BRLTTY is a background process (daemon) which provides access
|
||||
to the console screen (when in text mode) for a blind person
|
||||
using a refreshable braille display. It drives the braille
|
||||
display, and provides complete screen review functionality. Some
|
||||
speech capability has also been incorporated.
|
||||
Keywords: refreshable braille display console access visually impaired blind linux unix
|
||||
Author: dave@mielke.cc (Dave Mielke)
|
||||
nico@fluxnic.net (Nicolas Pitre)
|
||||
s.doyon@videotron.ca (Stéphane Doyon)
|
||||
nn201@cus.cam.ac.uk (Nikhil Nair)
|
||||
Maintained-by: dave@mielke.cc (Dave Mielke)
|
||||
Primary-site: ftp.ibiblio.org /pub/Linux/system/access
|
||||
2400KB brltty-4.3.tar.gz
|
||||
1300KB brltty-4.3-1.i686.rpm
|
||||
2300KB brltty-4.3-1.src.rpm
|
||||
14KB brltty-4.3.README
|
||||
4KB brltty-4.3.lsm
|
||||
Alternate-site: ftp://leb.net /pub/blinux/brltty
|
||||
Original-site:
|
||||
Platforms: Linux (kernel 1.1.92 or later)
|
||||
Solaris (release 7 or later)
|
||||
OpenBSD (release 3.4 or later)
|
||||
FreeBSD (release 5.1 or later)
|
||||
NetBSD (release 1.6 or later)
|
||||
Supported Braille Displays:
|
||||
- Albatross [46/80]
|
||||
- Alva [ABT(3nn), Delphi(4nn), Satellite(5nn), Braille System 40,
|
||||
Braille Controller 640/680]
|
||||
- Baum [Inka, Vario/RBT, SuperVario/Brailliant, PocketVario,
|
||||
VarioPro, EcoVario, VarioConnect/BrailleConnect,
|
||||
Refreshabraille]
|
||||
- BrailComm [III]
|
||||
- BrailleLite [18/40/M20/M40]
|
||||
- BrailleNote [18/32]
|
||||
- BrlAPI
|
||||
- CombiBraille [25/45/85]
|
||||
- EcoBraille [20/40/80]
|
||||
- EuroBraille [AzerBraille, Clio, Esys, Iris, NoteBraille,
|
||||
Scriba]
|
||||
- FreedomScientific [Focus 1 44/70/84, Focus 2 40/80, Focus Blue 40,
|
||||
PAC Mate 20/40]
|
||||
- HandyTech [Modular 20/40/80, Modular Evolution 64/88,
|
||||
Active Braille, Braille Wave, Easy Braille,
|
||||
Braille Star 40/80, Bookworm, Braillino]
|
||||
- HIMS [Braille Sense, SyncBraille]
|
||||
- HumanWare [Brailliant 32/40/80 bi]
|
||||
- IrisLinux
|
||||
- Libbraille
|
||||
- LogText [32]
|
||||
- MDV [MB208/MB408L/MB408S (protocol 5)]
|
||||
- Metec [BD-40]
|
||||
- MiniBraille [20]
|
||||
- MultiBraille [MB125CR/MB145CR/MB185CR]
|
||||
- Papenmeier [Compact 486, Compact/Tiny, IB 80 CR Soft,
|
||||
2D Lite (plus), 2D Screen Soft, EL 80,
|
||||
EL 2D 40/66/80, EL 40/66/70/80 S, EL 2D 80 S,
|
||||
EL 40 P, EL 80 II, Elba 20/32,
|
||||
Trio 40/Elba20/Elba32]
|
||||
- Pegasus [20/27/40/80]
|
||||
- Seika [40]
|
||||
- TSI [Navigator 20/40/80, PowerBraille 40/65/80]
|
||||
- TTY [terminfo]
|
||||
- VideoBraille [40]
|
||||
- Virtual [TCP/Unix, client/server]
|
||||
- VisioBraille [20/40]
|
||||
- Voyager [44/70], Part232 (serial adapter), BraillePen/EasyLink
|
||||
- XWindow [X11, Windows]
|
||||
Supported Speech Synthesizers:
|
||||
- Alva [Delphi(4nn)]
|
||||
- BrailleLite
|
||||
- CombiBraille
|
||||
- eSpeak [text to speech engine]
|
||||
- ExternalSpeech [runs /usr/local/bin/externalspeech]
|
||||
- Festival [text to speech engine]
|
||||
- FestivalLite [text to speech engine]
|
||||
- GenericSay [pipes to /usr/local/bin/say]
|
||||
- Mikropuhe [text to speech engine]
|
||||
- SpeechDispatcher [text to speech server]
|
||||
- Swift [text to speech engine]
|
||||
- Theta [text to speech engine]
|
||||
- ViaVoice [text to speech engine]
|
||||
Copying-policy: GPL
|
||||
End
|
||||
Reference in new issue
Block a user