B2G/Bluetooth

This wiki page is now for Firefox OS 1.0 and will be updated irregularly.

Overview

Bluetooth of Firefox OS 1.0 has basic functionalities. It allows users to:

• Discover visible Bluetooth devices nearby
• Pair with found devices
• Send files to/Receive files from remote Bluetooth devices
• Connect with Bluetooth headsets, then headset can be used for basic call controls, such as Answer/Hang up/Redial

For Firefox OS 1.0, the Bluetooth Web API is considered a Certified API, which means that only certified applications (applications that ship with the OS itself) may use bluetooth. Applications retreived from Firefox Marketplace or elsewhere on the web are not able to use the Bluetooth API at this time.

Supported Bluetooth Profiles

• HFP (Handsfree Profile)
• HSP (Headset Profile)
• OPP (Object Push Profile)

Unsupported Bluetooth Profiles

• A2DP (Advanced Audio Distribution Profile)
• AVRCP (Audio/Video Remote Control Profile)
• FTP (File Transfer Profile)
• PBAP (Phone Book Access Profile)
• PAN (Personal Area Network Profile)

FAQ

Why can't I hear music from connected Bluetooth headset even when a song is playing?

That's because A2DP hasn't been implemented yet. For now, only voice stream of phone calls can be heard from Bluetooth headset.

We have a meta bug on bugzilla tracking A2DP implementation.

I would like to share a song via Bluetooth, but I can't find the share button.

Please press and hold on a song, then you should be able to see the Bluetooth paired device list.

Please see Bug 830040 comment 1 for more information.

I just successfully received a photo from another Bluetooth device (e.g. Android phone, laptop ...), but I couldn't find that photo in Gallery app. What happened?

For Firefox OS 1.0, Gallery app would ignore images that have a file size of > 3 megabytes or a resolution of more than 5 megapixels.

Please see Bug 815079 comment 4 for more information.

Why can't I send a file to my iPhone/iPad?

It's because iOS doesn't support file-transfer profiles.

Please see http://support.apple.com/kb/HT3647 for more information about iOS supported profiles.

Why can't I send a file to or receive a file from my Mac?

If you would like to share files to Mac, the file-transfer function should be enabled beforehand.

1. Click Bluetooth icon at the top-right corner of the screen

2. Go to "Open Bluetooth Preference" -> "Sharing Setup"

3. Select the Bluetooth Sharing checkbox

Please see http://support.apple.com/kb/PH10786 for more information.

Once you have done the above steps, please go to Bluetooth page and unpair/pair your Mac, then it should work normally.

Why can't I receive a file from my Ubuntu laptop/desktop?

On Ubuntu 12.04/12.10, the function of receiving a file from remote Bluetooth devices is disabled by default. Therefore you have to turn it on then try again.

1. Go to "Personal File Saring"

2. Check the item "Receive files in Downloads folder over Bluetooth"

Once you have done the above steps, please go to Bluetooth page and unpair/pair your Ubuntu device, then it should work normally.

Why can't my bluetooth car kit work well with my phone?

There are so many cars installed difference Bluetooth modules, we cannot test them one by one.

We have a meta bug on bugzilla tracking interoperability issues for bluetooth car kit .

File a Bug

If you have read the FAQ and still have problems. Please file a bug to Bugzilla. To help developers finding bugs more easily, please make the title start with [Bluetooth].

Helpful Debugging Information

When filing a bug related to Bluetooth, please provide information about your test environment as much as possible, such as:

• Device (Otoro, Unagi ...)
• Software information
  • Build Identifier (Go to "Settings" > "Device information" > "More Information")
  • Git commit info
  • Gecko version
  • Gaia version
• STR (Step to Reproduce)
• Actual result/Expected result
• Occurence
• GDB backtrace
• adb logcat
• hcidump log
  • hcidump is a tool for Bluetooth protocol analysis. However it would not be included in release build.
  • Take the following steps to get hcidump log:
    • 1. Turn on Bluetooth
    • 2 - 1. For headset/car kit issues, please enter adb shell hcidump --ascii -t > hcidump.txt
    • 2 - 2. For file transferring and other issues, please enter adb shell hcidump --hex -t > hcidump.txt
    • 3. Do the test
    • 4. Attach hcidump.txt to the bug

Links

• Bluetooth WebAPI