← Back to branch summary

~bluetooth/bluez/vivid-phone-overlay

« back to all changes in this revision

Viewing changes to debian/README.Debian

  • Committer: Simon Fels
  • Date: 2015-09-11 09:01:46 UTC
  • Revision ID: morphis@gravedo.de-20150911090146-4c0ln9s7ec3xf0nx
Import package bluez_4.101-0ubuntu25.1~overlay4 from stable phone overlay PPA

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/README.Debian
 
1
bluez for Debian
 
2
================
 
3
 
 
4
The /dev/rfcomm* serial devices entries are automatically created for using
 
5
RFCOMM with legacy applications -- see rfcomm(8).  Users must be in group
 
6
'dialout' to have privileges to use these devices.
 
7
 
 
8
You can edit /etc/bluetooth/rfcomm.conf to have some rfcomm devices bound
 
9
automatically at boot time.
 
10
 
 
11
If you wish to install PCMCIA card services support for your Bluetooth
 
12
devices you should install the bluez-pcmcia-support package.
 
13
 
 
14
Some USB dongles require firmware to make them work: bluez-firmware from the
 
15
"non-free" section provides the required firmware.
 
16
 
 
17
 
 
18
Mailing lists and documentation
 
19
-------------------------------
 
20
The old sourceforge lists have been discontinued, the new lists can be found at:
 
21
 
 
22
http://www.bluez.org/development/lists/
 
23
 
 
24
plus a wiki at: http://wiki.bluez.org/
 
25
 
 
26
PIN (or passkey) management
 
27
---------------------------
 
28
Interaction with the local user can be required while BT connection is
 
29
being established (pairing process) and the PIN is not yet known or
 
30
needs to be changed.
 
31
 
 
32
To retrieve the passkey (or PIN) from the user a service program (agent)
 
33
running in user's interactive session needs to be prepared and listen
 
34
for requests of the bluez daemon when pairing begins.
 
35
 
 
36
Examples of such programs are kblueplugd (kdebluetooth package) and
 
37
bluetooth-applet (bluez-gnome or gnome-bluetooth packages). A minimal
 
38
command-line agent is also provided by bluez-simple-agent.
 
39
 
 
40
For example, you can execute bluez-simple-agent as follows.
 
41
 
 
42
$ bluez-simple-agent hci0 XX:XX:XX:XX:XX:XX (Address of target device)
 
43
RequestPinCode (/org/bluez/27392/hci0/dev_XX_XX_XX_XX_XX_XX)
 
44
Enter PIN Code: 0000
 
45
Release
 
46
 
 
47
Headset support
 
48
---------------
 
49
There's support for bluetooth headset both via ALSA and GStreamer, respectively
 
50
via bluez-alsa and bluez-gstreamer packages.
 
51
 
 
52
ALSA
 
53
~~~~
 
54
You might setup your headset by discovering it with gnome-bluetooth, once setup
 
55
add the following configuration to ~/.asoundrc:
 
56
 
 
57
        pcm.bluetooth {
 
58
                   type bluetooth
 
59
                   device <BT address>
 
60
        }
 
61
 
 
62
then audio can be played with supported player, e.g. mplayer:
 
63
 
 
64
        mplayer -ao alsa:device=bluetooth
 
65
 
 
66
See also: http://wiki.bluez.org/wiki/HOWTO/AudioDevices
 
67
 
 
68
Legacy daemons
 
69
--------------
 
70
The bluez-compat package includes old legacy daemons such as dund, pand and hidd
 
71
for enabling dial-up, ethernet networking and input devices over bluetooth.
 
72
 
 
73
Bluetooth Networking Quickstart with legacy daemons
 
74
+++++++++++++++++++++++++++++++++++++++++++++++++++
 
75
1. Start dund and pand at boot time
 
76
 
 
77
2. PPP over RFCOMM
 
78
 
 
79
This is what most devices call "LAN Access" or "Serial Access".  It
 
80
uses normal PPP over a serial connection.  Most PDAs will be able to
 
81
connect using this method.
 
82
 
 
83
Use the 'dund' tool to accept incoming connections.  Configure pppd
 
84
as per the instructions in the ppp package.  Then run:
 
85
 
 
86
dund --listen --sdp --nodetach
 
87
 
 
88
Try and connect your device and you'll see something like:
 
89
 
 
90
dund[9801]: DUN daemon ver 1.1pre4
 
91
dund[9811]: New connection from 00:02:31:24:17:6A
 
92
 
 
93
The --sdp option causes the DUN access to be advertised to other
 
94
devices via the SDP protocol.  Most devices need this in order to be
 
95
able to connect.
 
96
 
 
97
Run dund --help to see the various other options available to you.
 
98
 
 
99
If you want to make an outgoing connection using PPP, for instance to
 
100
a mobile phone, use the 'rfcomm' program from bluez-utils to bind a
 
101
/dev/rfcommX serial port to the phone, and then then use pppd as you
 
102
would with a normal modem.
 
103
 
 
104
3. PAN
 
105
 
 
106
The 'pand' tool allows you to use ethernet style networking over
 
107
Bluetooth.  It creates a network interface on your machine that can be
 
108
configured in the same way normal network devices are.
 
109
 
 
110
For full details see the PAN HOWTO at
 
111
<http://bluez.sourceforge.net/contrib/HOWTO-PAN>
 
112
 
 
113
Keyboard and mouse support
 
114
++++++++++++++++++++++++++++++++++++
 
115
hidd daemon is included in a bluez-compat package. 
 
116
We use bluez-simple-agent and bluez-test-input in bluez now.
 
117
 
 
118
1. Discover you mouse or keyboard bluetooth address (bdaddr) by running
 
119
   "hcitool scan".
 
120
 
 
121
2. Start bluez-simple-agent
 
122
 
 
123
    $ sudo bluez-simple-agent hci0 <bdaddr>
 
124
    RequestPinCode (/org/bluez/22302/hci0/dev_00_XX_XX_XX_XX_XX)
 
125
    Enter PIN Code: 0000 <-- Please input PIN code
 
126
    Release
 
127
    New device (/org/bluez/22302/hci0/dev_00_XX_XX_XX_XX_XX)
 
128
 
 
129
    Bluetooth mouse set simple PIN code as "0000".
 
130
    PIN code are different depending on mouse. 
 
131
    Please check the PIN code of your mouse.
 
132
 
 
133
3. With bluez-test-device, set *trusted* to the device.
 
134
 
 
135
    $ sudo bluez-test-device trusted <bdaddr> yet
 
136
 
 
137
        When you did not execute this, you use bluez-test-input after suspend
 
138
        and resume (and reboot) have to connect a device again.
 
139
 
 
140
4. With bluez-test-input, connected to the device.
 
141
 
 
142
    $ sudo bluez-test-input connect <bdaddr>
 
143
 
 
144
NOTE: If you want to use hidd daemon, please install bluez-compat package.
 
145
 
 
146
   You must then connect to your keyboard or mouse using 
 
147
   "sudo hidd --connect <bdaddr>".  
 
148
   On first connection, pairing is likely and you should
 
149
   press "connect" button on mice/keyboard, if any.  Mice normally have a
 
150
   preset PIN which should be in the manufacturer's documentation, try 0000.
 
151
   For keyboards, type the PIN on the Bluetooth keyboard and hit enter, and
 
152
   then supply it to the passkey agent 
 
153
   (using a cable-attached keyboard. e.g. bluez-simple-agent).
 
154
   In future your keyboard or mouse should reconnect to your computer
 
155
 
 
156
Sound (alsa) support
 
157
-------------------------------
 
158
Note:
 
159
From Bluez 4.96, you also need to add to /etc/bluetooth/audio.conf:
 
160
 
 
161
[General]
 
162
    Disable=Media
 
163
    Enable=Socket