/usr/share/doc/brltty/README.Bluetooth is in brltty 5.0-2ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 | 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
|