Skip to contentSkip to conversation

doc/qualification: Add PICS and howto for the SM qualification

PATCH Applied Frédéric Danis 3 participants 3 messages Jan 23 – Jan 26 Bluetooth drivers

lore
Share & tools
lore
#0 lore raw

PATCH v2 1/1 doc/qualification: Add PICS and howto for the SM qualification

---
v1->v2: Fix trailing whitespace

 doc/qualification/sm-pics.rst | 205 +++++++++
 doc/qualification/sm-pts.rst  | 806 ++++++++++++++++++++++++++++++++++
 2 files changed, 1011 insertions(+)
 create mode 100644 doc/qualification/sm-pics.rst
 create mode 100644 doc/qualification/sm-pts.rst
doc/qualification/sm-pics.rst new file +205 -0
new file mode 100644
index 000000000..cbf375a03
@@ -0,0 +1,205 @@
+.. SPDX-License-Identifier: GPL-2.0-or-later
+.. Copyright © 2025-2026 Collabora Ltd.
+
+================
+Security Manager
+================
+(TCRL 2023-1, SM.ICS.p11)
+
+Roles and versions
+==================
+**Table 1: Role Requirements**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_1_1      | x        | Central Role (Initiator) (C.1)               |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_1_2      | x        | Peripheral Role (Responder) (C.1)            |
++------------------+----------+----------------------------------------------+
+
+- C.1: Mandatory to support at least one of SM 1/1 "Central Role (Initiator)"
+  OR SM 1/2 "Peripheral Role (Responder)".
+
+Security properties
+===================
+**Table 2: Security Properties**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_2_1      | x        | Authenticated MITM protection (O)            |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_2_2      | x        | Unauthenticated no MITM protection (C.1)     |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_2_3      | x        | No security requirements (M)                 |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_2_4      |          | OOB supported (O)                            |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_2_5      | x        | LE Secure Connections (O)                    |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+- O: Optional
+- C.1: Mandatory IF SM 2/1 "Authenticated MITM protection",
+  otherwise Optional.
+
+Pairing algorithms
+==================
+**Table 3: Encryption Key Size**
+
+Prerequisite: SM 2/1 "Authenticated MITM protection" OR
+SM 2/2 "Unauthenticated no MITM protection" OR SM 2/4 "OOB supported"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_3_1      | x        | Encryption Key Size (M)                      |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+
+Pairing algorithms
+==================
+**Table 4: Pairing Method**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_4_1      | x        | Just Works (O)                               |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_4_2      | x        | Passkey Entry (C.1)                          |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_4_3      |          | Out of Band (C.1)                            |
++------------------+----------+----------------------------------------------+
+
+- O: Optional
+- C.1: Mandatory to support at least one of SM 4/2 "Passkey Entry" OR
+  SM 4/3 "Out of Band" IF SM 2/1 "Authenticated MITM protection",
+  otherwise Excluded.
+
+Key distribution and usage
+==========================
+**Table 5: Security Initiation**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_5_1      | x        | Encryption Setup using STK (C.3)             |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_5_2      | x        | Encryption Setup using LTK (O)               |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_5_3      | x        | Peripheral Initiated Security (C.1)          |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_5_4      | x        | Peripheral Initiated Security - Central      |
+|                  |          | response (C.2)                               |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_5_5      |          | CT2 bit (C.4)                                |
++------------------+----------+----------------------------------------------+
+
+- O: Optional
+- C.1: Optional IF SM 1/2 "Peripheral Role (Responder)", otherwise Excluded.
+- C.2: Mandatory IF SM 1/1 "Central Role (Initiator)", otherwise Excluded.
+- C.3: Mandatory IF SM 2/1 "Authenticated MITM protection" OR
+  SM 2/2 "Unauthenticated no MITM protection" OR SM 2/4 "OOB supported",
+  otherwise Excluded.
+- C.4: Excluded IF NOT SM 8a/1 "Cross Transport Key Derivation Supported"
+  AND NOT SM 8b/1 "Cross Transport Key Derivation Supported", otherwise
+  Mandatory IF NOT SUM ICS 31/17 "Core v4.2" AND NOT SUM ICS 31/18
+  "Core v4.2+HS", otherwise Optional.
+
+Key distribution and usage
+==========================
+**Table 6: Signing Algorithm**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_6_1      |          | Signing Algorithm - Generation (O)           |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_6_2      |          | Signing Algorithm - Resolving (O)            |
++------------------+----------+----------------------------------------------+
+
+- O: Optional
+
+Key distribution and usage
+==========================
+**Table 7a: Key Distribution by Central**
+
+Prerequisite: SM 1/1 "Central Role (Initiator)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_7a_1     | x        | Encryption Key (O)                           |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_7a_2     | x        | Identity Key (O)                             |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_7a_3     |          | Signing Key (O)                              |
++------------------+----------+----------------------------------------------+
+
+- O: Optional
+
+Key distribution and usage
+==========================
+**Table 7b: Key Distribution by Peripheral**
+
+Prerequisite: SM 1/2 "Peripheral Role (Responder)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_7b_1     | x        | Encryption Key (O)                           |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_7b_2     | x        | Identity Key (O)                             |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_7b_3     | x        | Signing Key (O)                              |
++------------------+----------+----------------------------------------------+
+
+- O: Optional
+
+Key distribution and usage
+==========================
+**Table 8a: Cross-Transport Key Derivation by Central**
+
+Prerequisite: SM 1/1 "Central Role (Initiator)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_8a_1     |          | Cross Transport Key Derivation Supported     |
+|                  |          | (C.1)                                        |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_8a_2     |          | Derivation of LE LTK from BR/EDR Link Key    |
+|                  |          | (C.2)                                        |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_8a_3     |          | Derivation of BR/EDR Link Key from LE LTK    |
+|                  |          | (C.2)                                        |
++------------------+----------+----------------------------------------------+
+
+- C.1: Optional IF SM 2/5 "LE Secure Connections", otherwise Excluded.
+- C.2: Optional IF SM 8a/1 "Cross Transport Key Derivation Supported",
+  otherwise Excluded.
+
+Key distribution and usage
+==========================
+**Table 8b: Cross-Transport Key Derivation by Peripheral**
+
+Prerequisite: SM 1/2 "Peripheral Role (Responder)"
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_SM_8b_1     |          | Cross Transport Key Derivation Supported     |
+|                  |          | (C.1)                                        |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_8b_2     |          | Derivation of LE LTK from BR/EDR Link Key    |
+|                  |          | (C.2)                                        |
++------------------+----------+----------------------------------------------+
+| TSPC_SM_8b_3     |          | Derivation of BR/EDR Link Key from LE LTK    |
+|                  |          | (C.2)                                        |
++------------------+----------+----------------------------------------------+
+
+- C.1: Optional IF SM 2/5 "LE Secure Connections", otherwise Excluded.
+- C.2: Optional IF SM 8b/1 "Cross Transport Key Derivation Supported",
+  otherwise Excluded.
doc/qualification/sm-pts.rst new file +806 -0

806 lines not on this page · raw message

Signature · 1 line
2.43.0
#1 lore raw

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=1046381

---Test result---

Test Summary:

CheckPatch                    PENDING   0.41 seconds
GitLint                       PENDING   0.39 seconds
BuildEll                      PASS      20.40 seconds
BluezMake                     PASS      649.14 seconds
MakeCheck                     PASS      18.17 seconds
MakeDistcheck                 PASS      246.43 seconds
CheckValgrind                 PASS      299.39 seconds
CheckSmatch                   PASS      354.66 seconds
bluezmakeextell               PASS      184.91 seconds
IncrementalBuild              PENDING   0.40 seconds
ScanBuild                     PASS      1032.66 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

#2 lore raw
In reply to Frédéric Danis
This patch was applied to bluetooth/bluez.git (master) by Luiz Augusto von Dentz <[email protected]>:

Hello:

This patch was applied to bluetooth/bluez.git (master) by Luiz Augusto von Dentz <[email protected]>:

Quoted 8 lines · On Fri, 23 Jan 2026 17:47:33 +0100 you wrote:

---
v1->v2: Fix trailing whitespace

 doc/qualification/sm-pics.rst | 205 +++++++++
 doc/qualification/sm-pts.rst  | 806 ++++++++++++++++++++++++++++++++++
 2 files changed, 1011 insertions(+)
 create mode 100644 doc/qualification/sm-pics.rst
 create mode 100644 doc/qualification/sm-pts.rst

Here is the summary with links:
- [BlueZ,v2] doc/qualification: Add PICS and howto for the SM qualification

    https://git.kernel.org/pub/scm/bluetooth/bluez.git/?id=687c62a08ee8

You are awesome, thank you!

Signature · 2 lines
Deet-doot-dot, I am a bot.
https://korg.docs.kernel.org/patchwork/pwbot.html