public inbox for linux-bluetooth@vger.kernel.org
 help / color / mirror / Atom feed
* [PATCH BlueZ] doc/qualification: Add PICS and howto for the HSP qualification
@ 2026-01-27 17:16 Frédéric Danis
  2026-01-27 18:15 ` [BlueZ] " bluez.test.bot
  2026-01-27 18:30 ` [PATCH BlueZ] " patchwork-bot+bluetooth
  0 siblings, 2 replies; 3+ messages in thread
From: Frédéric Danis @ 2026-01-27 17:16 UTC (permalink / raw)
  To: linux-bluetooth

---
 doc/qualification/hsp-pics.rst | 234 +++++++++++++++++++++++++++++++++
 doc/qualification/hsp-pts.rst  |  87 ++++++++++++
 2 files changed, 321 insertions(+)
 create mode 100644 doc/qualification/hsp-pics.rst
 create mode 100644 doc/qualification/hsp-pts.rst

diff --git a/doc/qualification/hsp-pics.rst b/doc/qualification/hsp-pics.rst
new file mode 100644
index 000000000..cc607514f
--- /dev/null
+++ b/doc/qualification/hsp-pics.rst
@@ -0,0 +1,234 @@
+.. SPDX-License-Identifier: GPL-2.0-or-later
+.. Copyright © 2025-2026 Collabora Ltd.
+
+===============
+Headset Profile
+===============
+(TCRL 2023-1, HSP.ICS.p6)
+
+Versions
+========
+**Table 0: Major Versions (X.Y)**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_0_1     |          | HSP v1.1 DeprecatedTo be withdrawn (C.1)     |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_0_2     | x        | HSP v1.2 (C.1)                               |
++------------------+----------+----------------------------------------------+
+
+- C.1: Mandatory to support one and only one of HSP 0/1 "HSP v1.1" OR HSP 0/2 "HSP v1.2".
+
+Roles
+=====
+**Table 1: Role Requirements**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_1_1     | x        | Audio Gateway (AG) (C.1)                     |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_1_2     |          | Headset (HS) (C.1)                           |
++------------------+----------+----------------------------------------------+
+
+- C.1: Mandatory to support at least one of HSP 1/1 "Audio Gateway (AG)" OR HSP 1/2 "Headset (HS)".
+
+Audio Gateway Role
+==================
+**Table 2: Application Features (AG)**
+
+Prerequisite: HSP 1/1 "Audio Gateway (AG)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_2_1     | x        | Incoming audio connection establishment (M)  |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_2     |          | Ring (AT command) (C.3)                      |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_3     |          | Inband ring tone (O)                         |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_4     |          | Outgoing audio connection establishment (O)  |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_5     | x        | Audio connection release from HS (M)         |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_6     |          | Audio connection release from AG (C.5)       |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_7     | x        | Audio connection transfer: AG to HS (M)      |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_8     | x        | Audio connection transfer: HS to AG (M)      |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_9     |          | Remote audio volume control (C.1)            |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_10    |          | HS informs AG about local changes of audio   |
+|                  |          | volume (O)                                   |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_11    |          | Audio volume setting storage by HS (O)       |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_12    |          | Remote microphone gain control (C.2)         |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_13    |          | HS informs AG about local changes of         |
+|                  |          | microphone gain (O)                          |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_14    |          | Microphone gain setting storage by HS (O)    |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2_15    | x        | Connection Handling with Detach/Page (M)     |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+- O: Optional
+- C.1: Mandatory IF HSP 2/10 "HS informs AG about local changes of audio volume", otherwise Optional.
+- C.2: Mandatory IF HSP 2/13 "HS informs AG about local changes of microphone gain", otherwise Optional.
+- C.3: Excluded IF HSP 2/3 "Inband ring tone" AND HSP 4/1 "E2112/TSE 1134 (212): Show that in-band ringing and RING are mutually exclusive", otherwise Optional.
+- C.5: Mandatory IF HSP 0/1 "HSP v1.1", otherwise Optional.
+
+Audio Gateway Role
+==================
+**Table 2a: GAP Requirements**
+
+Prerequisite: HSP 1/1 "Audio Gateway (AG)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_2a_1    | x        | Initiation of general inquiry (M)            |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+
+Audio Gateway Role
+==================
+**Table 2b: SDP Requirements**
+
+Prerequisite: HSP 1/1 "Audio Gateway (AG)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_2b_1    | x        | ProtocolDescriptorList (M)                   |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_2b_2    | x        | BluetoothProfileDescriptorList (M)           |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+
+Audio Gateway Role
+==================
+**Table 2c: RFCOMM Requirements**
+
+Prerequisite: HSP 1/1 "Audio Gateway (AG)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_2c_1    | x        | RFCOMM with TS 07.10 (M)                     |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+
+Headset Role
+============
+**Table 3: Application Features (HS)**
+
+Prerequisite: HSP 1/2 "Headset (HS)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_3_1     |          | Incoming audio connection establishment (M)  |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_2     |          | Ring (AT command) (M)                        |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_3     |          | Inband ring tone (M)                         |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_4     |          | Outgoing audio connection establishment (M)  |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_5     |          | Audio connection release from HS (M)         |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_6     |          | Audio connection release from AG (M)         |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_7     |          | Audio connection transfer: AG to HS (M)      |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_8     |          | Audio connection transfer: HS to AG (M)      |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_9     |          | Remote audio volume control (C.1)            |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_10    |          | HS informs AG about local changes of audio   |
+|                  |          | volume (O)                                   |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_11    |          | Audio volume setting storage by HS (O)       |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_12    |          | Remote microphone gain control (C.2)         |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_13    |          | HS informs AG about local changes of         |
+|                  |          | microphone gain (O)                          |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_14    |          | Microphone gain setting storage by HS (O)    |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3_15    |          | Connection Handling with Detach/Page (M)     |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+- O: Optional
+- C.1: Mandatory IF HSP 3/10 "HS informs AG about local changes of audio volume", otherwise Optional.
+- C.2: Mandatory IF HSP 3/13 "HS informs AG about local changes of microphone gain", otherwise Optional.
+
+Headset Role
+============
+**Table 3a: GAP Requirements**
+
+Prerequisite: HSP 1/2 "Headset (HS)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_3a_1    |          | Non-discoverable mode (M)                    |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3a_2    |          | General discoverable mode (M)                |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+
+Headset Role
+============
+**Table 3b: SDP Requirements**
+
+Prerequisite: HSP 1/2 "Headset (HS)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_3b_1    |          | ProtocolDescriptorList (M)                   |
++------------------+----------+----------------------------------------------+
+| TSPC_HSP_3b_2    |          | BluetoothProfileDescriptorList (M)           |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+
+Headset Role
+============
+**Table 3c: RFCOMM Requirements**
+
+Prerequisite: HSP 1/2 "Headset (HS)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_3c_1    |          | RFCOMM with TS 07.10 (M)                     |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+
+Errata Service Releases
+=======================
+**Table 4: Errata Service Releases (ESR)**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_HSP_4_1     |          | E2112/TSE 1134 (212): Show that in-band      |
+|                  |          | ringing and RING are mutually exclusive (C.1)|
++------------------+----------+----------------------------------------------+
+
+- C.1: Excluded IF HSP 0/2 "HSP v1.2", otherwise Optional.
diff --git a/doc/qualification/hsp-pts.rst b/doc/qualification/hsp-pts.rst
new file mode 100644
index 000000000..1233bc2a4
--- /dev/null
+++ b/doc/qualification/hsp-pts.rst
@@ -0,0 +1,87 @@
+.. SPDX-License-Identifier: GPL-2.0-or-later
+.. Copyright © 2025-2026 Collabora Ltd.
+
+================
+HSP test results
+================
+
+:PTS version: 8.5.3 Build 4
+
+Setup
+=====
+
+- Remove PTS device from Bluetooth devices
+
+- PipeWire version >= 1.1.81
+
+Tests
+=====
+
+The kernel and BlueZ versions represent the oldest version without backport
+for which we know the test passed.
+
++----------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| Test name                  | Result   | Kernel  | BlueZ |                                                                         |
++============================+==========+=========+=======+=========================================================================+
+| HSP/AG/IAC/BV-01-I         | PASS     |     6.1 | 5.69  | Pre-condition:                                                          |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | - Start PulseAudio Volume Control                                       |
+|                            |          |         |       +-------------------------------------------------------------------------+
+|                            |          |         |       | Pair to PTS                                                             |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | Verify in Configuration tab that PTS-HFP profile is set to Headset Head |
+|                            |          |         |       | Unit, or select it                                                      |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | Start playing file using Lollypop                                       |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | Verify in PulseAudio Volume Control's Output Devices tab that audio is  |
+|                            |          |         |       | playing on PTS-HFP device                                               |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | On request disconnect                                                   |
++----------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| HSP/AG/ACR/BV-01-I         | PASS     |     6.1 | 5.69  | Pre-condition:                                                          |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | - Start PulseAudio Volume Control                                       |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | - Start playing file using Lollypop                                     |
+|                            |          |         |       +-------------------------------------------------------------------------+
+|                            |          |         |       | Verify in Configuration tab that PTS-HFP profile is set to Headset Head |
+|                            |          |         |       | Unit, or select it                                                      |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | Verify in PulseAudio Volume Control's Output Devices tab that audio is  |
+|                            |          |         |       | playing on PTS-HFP device                                               |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | On request disconnect                                                   |
++----------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| HSP/AG/ACT/BV-01-I         | PASS     |     6.1 | 5.69  | Pre-condition:                                                          |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | - Start PulseAudio Volume Control                                       |
+|                            |          |         |       +-------------------------------------------------------------------------+
+|                            |          |         |       | Verify in Configuration tab that PTS-HFP profile is set to Headset Head |
+|                            |          |         |       | Unit, or select it                                                      |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | Start playing file using Lollypop                                       |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | Verify in PulseAudio Volume Control's Output Devices tab that audio is  |
+|                            |          |         |       | playing on PTS-HFP device                                               |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | On request disconnect                                                   |
++----------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| HSP/AG/ACT/BV-02-I         | PASS     |     6.1 | 5.69  | Pre-condition:                                                          |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | - Start PulseAudio Volume Control                                       |
+|                            |          |         |       +-------------------------------------------------------------------------+
+|                            |          |         |       | Connect to PTS                                                          |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | Verify in Configuration tab that PTS-HFP profile is set to Headset Head |
+|                            |          |         |       | Unit, or select it                                                      |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | Start playing file using Lollypop                                       |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | Verify in PulseAudio Volume Control's Output Devices tab that audio is  |
+|                            |          |         |       | playing on PTS-HFP device                                               |
+|                            |          |         |       |                                                                         |
+|                            |          |         |       | On request disconnect                                                   |
++----------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| IOPT/CL/HSP-AG/SFC/BV-16-I | PASS     |     6.1 | 5.69  |                                                                         |
++----------------------------+----------+---------+-------+-------------------------------------------------------------------------+
-- 
2.43.0


^ permalink raw reply related	[flat|nested] 3+ messages in thread

* RE: [BlueZ] doc/qualification: Add PICS and howto for the HSP qualification
  2026-01-27 17:16 [PATCH BlueZ] doc/qualification: Add PICS and howto for the HSP qualification Frédéric Danis
@ 2026-01-27 18:15 ` bluez.test.bot
  2026-01-27 18:30 ` [PATCH BlueZ] " patchwork-bot+bluetooth
  1 sibling, 0 replies; 3+ messages in thread
From: bluez.test.bot @ 2026-01-27 18:15 UTC (permalink / raw)
  To: linux-bluetooth, frederic.danis

[-- Attachment #1: Type: text/plain, Size: 1262 bytes --]

This is automated email and please do not reply to this email!

Dear submitter,

Thank you for submitting the patches to the linux bluetooth mailing list.
This is a CI test results with your patch series:
PW Link:https://patchwork.kernel.org/project/bluetooth/list/?series=1047701

---Test result---

Test Summary:
CheckPatch                    PENDING   0.50 seconds
GitLint                       PENDING   0.37 seconds
BuildEll                      PASS      20.26 seconds
BluezMake                     PASS      653.76 seconds
MakeCheck                     PASS      18.63 seconds
MakeDistcheck                 PASS      244.61 seconds
CheckValgrind                 PASS      296.17 seconds
CheckSmatch                   PASS      352.95 seconds
bluezmakeextell               PASS      182.84 seconds
IncrementalBuild              PENDING   0.39 seconds
ScanBuild                     PASS      1053.18 seconds

Details
##############################
Test: CheckPatch - PENDING
Desc: Run checkpatch.pl script
Output:

##############################
Test: GitLint - PENDING
Desc: Run gitlint
Output:

##############################
Test: IncrementalBuild - PENDING
Desc: Incremental build with the patches in the series
Output:



---
Regards,
Linux Bluetooth


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH BlueZ] doc/qualification: Add PICS and howto for the HSP qualification
  2026-01-27 17:16 [PATCH BlueZ] doc/qualification: Add PICS and howto for the HSP qualification Frédéric Danis
  2026-01-27 18:15 ` [BlueZ] " bluez.test.bot
@ 2026-01-27 18:30 ` patchwork-bot+bluetooth
  1 sibling, 0 replies; 3+ messages in thread
From: patchwork-bot+bluetooth @ 2026-01-27 18:30 UTC (permalink / raw)
  To: =?utf-8?b?RnLDqWTDqXJpYyBEYW5pcyA8ZnJlZGVyaWMuZGFuaXNAY29sbGFib3JhLmNvbT4=?=
  Cc: linux-bluetooth

Hello:

This patch was applied to bluetooth/bluez.git (master)
by Luiz Augusto von Dentz <luiz.von.dentz@intel.com>:

On Tue, 27 Jan 2026 18:16:13 +0100 you wrote:
> ---
>  doc/qualification/hsp-pics.rst | 234 +++++++++++++++++++++++++++++++++
>  doc/qualification/hsp-pts.rst  |  87 ++++++++++++
>  2 files changed, 321 insertions(+)
>  create mode 100644 doc/qualification/hsp-pics.rst
>  create mode 100644 doc/qualification/hsp-pts.rst

Here is the summary with links:
  - [BlueZ] doc/qualification: Add PICS and howto for the HSP qualification
    https://git.kernel.org/pub/scm/bluetooth/bluez.git/?id=e4b4db9702e6

You are awesome, thank you!
-- 
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html



^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2026-01-27 18:30 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-01-27 17:16 [PATCH BlueZ] doc/qualification: Add PICS and howto for the HSP qualification Frédéric Danis
2026-01-27 18:15 ` [BlueZ] " bluez.test.bot
2026-01-27 18:30 ` [PATCH BlueZ] " patchwork-bot+bluetooth

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox