The general form of a device specification
(see the
-d command line option,
the
braille-device configuration file directive,
and the
--with-braille-device build option)
is qualifier:
data.
For backward compatibility with earlier releases,
if the qualifier is omitted then serial:
is assumed.
The following device types are supported:
For a bluetooth device, specify bluez:
address.
The address must be six two-digit hexadecimal numbers separated by colons,
e.g. 01:23:45:67:89:AB
.
For a serial device, specify serial:
/path/to/device.
The serial:
qualifier is optional (for backward compatibility).
If a relative path is given then it's anchored at /dev
(the usual location where devices are defined on a Unix-like system).
The following device specifications all refer
to the first serial device on Linux:
serial:/dev/ttyS0
serial:ttyS0
/dev/ttyS0
ttyS0
For a USB device, specify usb:
.
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. 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.