DebuggingBluetooth

Differences between revisions 1 and 8 (spanning 7 versions)
⇤ ← Revision 1 as of 2015-07-30 09:50:03 →
Size: 1767
Editor: pD9ED6F30
Comment:
← Revision 8 as of 2015-10-15 09:43:28 → ⇥
Size: 2673
Editor: pD9ED7662
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:

= WARNING =

'''If you're going to attach the log files mentioned below be warned that those might include private information like phone numbers. If you're asked to share such log files you're free to not do this or share them with the asking person on a more private way than through launchpad/irc/.. '''
Line 11: Line 15:
* Which devices are involved? Exact model numbers if available are helpful.
* Which Bluetooth version do all involved devices support?
* Necessary log files (if possible with debugging information; see below)
** /var/log/syslog
** For Touch based devices: /home/phablet/.cache/upstart/application-legacy-ubuntu-system-settings-.log		  * Which devices are involved? Exact model numbers if available are helpful.
 * Which Bluetooth version do all involved devices support?
 * Necessary log files (if possible with debugging information; see below)
  * /var/log/syslog
  * For Touch based devices:
    * /home/phablet/.cache/upstart/application-legacy-ubuntu-system-settings-.log
    * /home/phablet/.cache/upstart/dbus.log

== List common information about current Bluetooth setup ==

 * Adapter info
{{{
phablet@ubuntu-phablet:~$ hciconfig -a
}}}

 * List of paired devices
{{{
phablet@ubuntu-phablet:~$ /usr/bin/bluez-list-devices
}}}
Line 21: Line 39:
# If you're on a Touch based system you have to temporarily mount your system partition read/write.  * If you're on a Touch based system you have to temporarily mount your system partition read/write.
Line 25: Line 43:
# As next step we enable verbose logging for the Bluetooth daemon  * As next step we enable verbose logging for the Bluetooth daemon
{{{
phablet@ubuntu-phablet:~$ sudo sed -i 's/exec \/usr\/sbin\/bluetoothd \-c \/etc\/bluetooth\/touch.conf/exec \/usr\/sbin\/bluetoothd \-c \/etc\/bluetooth\/touch.conf -d/g' /etc/init/bluetooth.override
}}}
'''NOTE:''' If ''/etc/init/bluetooth.override'' doesn't exist use the following command instead
Line 29: Line 51:
# For additional logging information we also enable verbose logging of the PulseAudio daemon  * For additional logging information we also enable verbose logging of the PulseAudio daemon

Debugging Central

This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages.

WARNING

If you're going to attach the log files mentioned below be warned that those might include private information like phone numbers. If you're asked to share such log files you're free to not do this or share them with the asking person on a more private way than through launchpad/irc/..

Debugging procedure

Reporting a bug

When reporting a Bluetooth bug we need to include different things to make it easier for the developers to find a solution for the problem.

Please note/include the following things in your bug report:

  • Which devices are involved? Exact model numbers if available are helpful.
  • Which Bluetooth version do all involved devices support?
  • Necessary log files (if possible with debugging information; see below)
    • /var/log/syslog
    • For Touch based devices:
      • /home/phablet/.cache/upstart/application-legacy-ubuntu-system-settings-.log
      • /home/phablet/.cache/upstart/dbus.log

List common information about current Bluetooth setup

  • Adapter info 

phablet@ubuntu-phablet:~$ hciconfig -a
  • List of paired devices 

phablet@ubuntu-phablet:~$ /usr/bin/bluez-list-devices

Generating log files with debugging information

As log files are normally just include warnings and errors it is quite helpful to have log files with additional debugging information. In the std. configuration of a Ubuntu system debugging informations are disabled to not pollute the system with a big log files. For Bluetooth we need to perform the following steps to enable verbose debug logging:

  • If you're on a Touch based system you have to temporarily mount your system partition read/write. 

phablet@ubuntu-phablet:~$ sudo mount -o remount,rw /
  • As next step we enable verbose logging for the Bluetooth daemon 

phablet@ubuntu-phablet:~$ sudo sed -i 's/exec \/usr\/sbin\/bluetoothd \-c \/etc\/bluetooth\/touch.conf/exec \/usr\/sbin\/bluetoothd \-c \/etc\/bluetooth\/touch.conf -d/g' /etc/init/bluetooth.override

NOTE: If /etc/init/bluetooth.override doesn't exist use the following command instead 

phablet@ubuntu-phablet:~$ sudo sed -i 's/exec \/usr\/sbin\/bluetoothd/exec \/usr\/sbin\/bluetoothd -d/g' /etc/init/bluetooth.conf

  • For additional logging information we also enable verbose logging of the PulseAudio daemon 

phablet@ubuntu-phablet:~$ sudo sed -i 's/--start/--start --log-level=debug/g' /usr/share/upstart/sessions/pulseaudio.conf

*NOTE:* This is currently pretty specific to Touch and needs additional information for systemd based variants of Ubuntu.

DebuggingBluetooth (last edited 2017-05-08 06:53:59 by kzapalowicz)