Collect Bluetooth Logs
This article explains how to collect logs about the air traffic between a Sailfish and another Bluetooth device. The test scripts needed are attached to this article.
Enable the Developer mode.
Scripts to enable effective debugging
Please find two script files attached to this message. Save them to your computer:
The first script is to restart Bluetooth, Obex and some other processes and start collecting Bluetooth air traffic. The second script stops the logging.
Copy the two script files to your Sailfish device (folder /home/defaultuser).
Make sure that the scripts have the execution rights by issuing the commands below:
cd /home/defaultuser chmod a+x upf*.sh
Get the super-user permissions by giving the command “devel-su” at the Terminal. Next, install two code packages to enable the Bluetooth HCI dumps and tracing:
devel-su pkcon refresh pkcon install bluez5-hcidump pkcon install bluez5-tracing systemctl restart bluetooth.service
You have completed the preparations.
Start collecting the logs with the command below. In this example, we use the word CAR as the name of this logging session (as if we were monitoring the Bluetooth traffic between a phone and a car).
Choose the name that is appropriate for your case.
The command below must be run with super-user permissions, as ‘root’. If needed, use “devel-su” to get the permissions.
The logs will be collected in the folder
devel-su # if not 'root' already ./upf-start-test.sh CAR
The display will turn black momentarily but the normal UI should return in 10-20 seconds. You will have to open the Terminal app again. Bluetooth logs are now being collected in the background.
Force the device to the problem situation
You should run your Bluetooth test scenarios next. That is, use the Sailfish device with the peripheral Bluetooth device. Do the steps that cause the error situation. If possible, make a note of the time when the problem occurs (the time of the phone) - this will help find the correct point in the log file.
devel-su # if not 'root' already ./upf-stop-test.sh CAR
This script collects the logs from your device and compresses them to file CAR.tar on your Sailfish device.
Send the results
File a ticket at Jolla customer care. Attach the log file to it, please: CAR.tar.
1) Remove the packages you installed:
devel-su # if not 'root' already pkcon remove bluez5-hcidump pkcon remove bluez5-tracing
2) Switch off “Developer mode” in “Settings > System > Developer tools”. 3) Restart your device to ensure that it really exits the debugging mode.