Simplifying Bluetooth qualification for Linux/BlueZ: New upstream documentation
-->
-->
-->
About
Who we are
Our expertise
Our work
Open Source
Our ecosystem
Services
Guide
Train
Build
Integrate
Optimize
Maintain
Industries
Automotive
Digital TV
Silicon
OEM
VR/AR
News & Blog
Careers
Contact
About
Services
Industries
News & Blog
Careers
Contact
-->
+44 (0)1223 362967
+1 514 667 2499
contact@collabora.com
-->
Home "
News & Blog "
Blog "
Simplifying Bluetooth qualification for Linux/BlueZ: New upstream documentation
-->
Home<br>News & Blog<br>Blog
Simplifying Bluetooth qualification for Linux/BlueZ: New upstream documentation
-->
Simplifying Bluetooth qualification for Linux/BlueZ: New upstream documentation
Posted on 26/05/2026 by<br>-->
Posted on 26/05/2026 by Frederic Danis
-->
Posted on 26/05/2026 by Frederic Danis<br>--><br>Frederic Danis<br>May 26, 2026
Share this post:
-->
Reading time:
Acquiring Bluetooth qualification can be arduous and confusing. To alleviate this burden, we've been working with multiple customers to get them through this process. By going through these steps, we've gained some insight and are excited to contribute upstream documentation detailing how to pass Bluetooth profile qualification tests for various profiles.
Why this matters
Bluetooth qualification is a mandatory process required by the Bluetooth Special Interest Group (SIG) for any product that uses the Bluetooth trademark or implements Bluetooth technology. It ensures interoperability across the vast ecosystem of Bluetooth devices and requires demonstrating that your implementation correctly supports the required profiles and passes a defined set of test cases.
Historically, qualifying a Linux/BlueZ stack has been a challenging experience — something we encountered firsthand while supporting several customers through the qualification process during the past years. Key information about which kernel and BlueZ versions support specific test cases was scattered, undocumented, or simply unknown, leaving developers to rediscover the same solutions independently.
By pushing this documentation upstream into BlueZ itself, we ensure that the knowledge is preserved and accessible to anyone working on qualification. Teams can quickly identify the minimum software versions they need, and the manual steps required for each test case are clearly described, reducing the trial-and-error that qualification efforts so often involve. Because the documentation lives alongside the code it describes, it can also be updated and improved by the community over time.
This effort aims to simplify the Bluetooth qualification process for developers, integrators, and device manufacturers, ensuring compliance with Bluetooth SIG standards.
How the documentation is structured
The new documentation is available in the doc/qualification/ directory of the BlueZ repository.
More than 15 Bluetooth profiles are currently covered and we are planning more in the future.
For every supported profile, you will now find two dedicated files:
1. __Protocol Implementation Conformance Statement ({profile}-pics.txt)__
This file describes the profile properties supported by the BlueZ implementation, giving a clear picture of its capabilities as relevant to qualification. It serves as your reference when filling out the PICS on the Bluetooth SIG website.
2. __Test Case Instructions ({profile}-pts.txt)__
This file covers each test case in the qualification test suite, documenting the oldest kernel and BlueZ versions without backports for which we have confirmed the test passes, as well as any manual steps required to pass it.
Contributing & feedback
If you are qualifying a product using BlueZ, we'd love to hear your feedback on this documentation. Has it been helpful to you? How could it be better?
This is an open source effort and we welcome contributions! If you come across missing profiles or test cases, notice version discrepancies, or have additional manual steps to share, we encourage you to contribute improvements directly via the BlueZ mailing list. The more teams that bring their qualification experience upstream, the more useful this resource becomes for everyone.
If you are working on Bluetooth qualification for a Linux-based product and would like expert support, don't hesitate to reach out to Collabora. We are always happy to help.
Acknowledgments
This work was made possible thanks to:
The BlueZ maintainers for their guidance and reviews.
Collabora’s engineering team for testing and documentation efforts.
The Bluetooth SIG for their qualification tools and standards.
We hope this resource saves developers time and improves Bluetooth interoperability across Linux-based devices.
Let’s make Bluetooth qualification easier for everyone!
Related Posts
BlueZ-powered Auracast broadcasting on Genio 700
Implementing Bluetooth LE Audio & Auracast on Linux systems
Implementing Bluetooth on...