doc/qualification: Add PICS and howto for the L2CAP qualification
PATCH 1/1 doc/qualification: Add PICS and howto for the L2CAP qualification
--- doc/qualification/l2cap-pics.rst | 345 ++++++++++++++++++++++++ doc/qualification/l2cap-pts.rst | 443 +++++++++++++++++++++++++++++++ 2 files changed, 788 insertions(+) create mode 100644 doc/qualification/l2cap-pics.rst create mode 100644 doc/qualification/l2cap-pts.rst
doc/qualification/l2cap-pics.rst new file +345 -0
@@ -0,0 +1,345 @@ +.. SPDX-License-Identifier: GPL-2.0-or-later +.. Copyright © 2025-2026 Collabora Ltd. + +============================================ +Logical Link Control and Adaptation Protocol +============================================ +(TCRL 2023-1, L2CAP.ICS.p25ed3) + +L2CAP Transport Configuration +============================= +**Table 0: L2CAP Transport Configuration** + ++------------------+----------+----------------------------------------------+ +| Parameter Name | Selected | Description | ++==================+==========+==============================================+ +| TSPC_L2CAP_0_1 | | BR/EDR (includes possible support of GAP LE | +| | | Broadcaster or LE Observer roles) (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_0_2 | | LE (C.2) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_0_3 | x | BR/EDR/LE (C.3) | ++------------------+----------+----------------------------------------------+ + +- C.1: Mandatory IF SUM ICS 32/1 "Logical Link Control and Adaptation + Protocol (L2CAP)", otherwise Excluded. +- C.2: Mandatory IF SUM ICS 34/1 "Logical Link Control and Adaptation + Protocol (L2CAP)", otherwise Excluded. +- C.3: Mandatory IF SUM ICS 32/1 "Logical Link Control and Adaptation + Protocol (L2CAP)" AND SUM ICS 34/1 "Logical Link Control and Adaptation + Protocol (L2CAP)", otherwise Excluded. + +Capability Statement +==================== +**Table 1: Role Requirements** + ++------------------+----------+----------------------------------------------+ +| Parameter Name | Selected | Description | ++==================+==========+==============================================+ +| TSPC_L2CAP_1_1 | x | Data Channel Initiator (C.3) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_1_2 | x | Data Channel Acceptor (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_1_3 | x | LE Central (C.2) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_1_4 | x | LE Peripheral (C.2) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_1_5 | | LE Data Channel Initiator (C.4) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_1_6 | | LE Data Channel Acceptor (C.5) | ++------------------+----------+----------------------------------------------+ + +- C.1: Mandatory IF L2CAP 0/1 "BR/EDR (includes possible support of GAP LE + Broadcaster or LE Observer roles)" OR L2CAP 0/3 "BR/EDR/LE", + otherwise Excluded. +- C.2: Mandatory to support at least one IF L2CAP 0/2 "LE" OR L2CAP 0/3 + "BR/EDR/LE", otherwise Excluded. +- C.3: Optional IF L2CAP 0/1 "BR/EDR (includes possible support of GAP LE + Broadcaster or LE Observer roles)" OR L2CAP 0/3 "BR/EDR/LE", + otherwise Excluded. +- C.4: Optional IF (L2CAP 0/2 "LE" OR L2CAP 0/3 "BR/EDR/LE") AND L2CAP 2/46 + "LE Credit Based Flow Control Mode", otherwise Excluded. +- C.5: Mandatory IF (L2CAP 0/2 "LE" OR L2CAP 0/3 "BR/EDR/LE") AND L2CAP + 2/46 "LE Credit Based Flow Control Mode", otherwise Excluded. + +Capability Statement +==================== +**Table 2: General Operation** + ++------------------+----------+----------------------------------------------+ +| Parameter Name | Selected | Description | ++==================+==========+==============================================+ +| TSPC_L2CAP_2_1 | x | L2CAP Signaling channel over BR/EDR (C.16) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_2 | x | Configuration process (C.16) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_3 | x | Connection-oriented data channel over BR/EDR | +| | | (C.16) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_4 | x | Send echo request (C.17) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_5 | x | Send echo response (C.16) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_6 | x | Send information request (C.17) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_7 | x | Send information response (C.16) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_10 | | Retransmission mode (C.17) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_11 | | Flow Control mode (C.17) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_12 | x | Enhanced Retransmission Mode (C.11) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_13 | x | Streaming Mode (O) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_14 | x | FCS Option (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_15 | | Generate Local Busy Condition (C.2) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_16 | | Send Reject (C.2) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_17 | x | Send Selective Reject (C.2) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_18 | | Mandatory use of ERTM (C.3) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_19 | | Mandatory use of Streaming Mode (C.4) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_20 | x | Optional use of ERTM (C.3) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_21 | x | Optional use of Streaming Mode (C.4) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_22 | x | Send data using SAR in ERTM (C.5) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_23 | x | Send data using SAR in Streaming Mode (C.6) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_24 | x | Actively request Basic Mode for a PSM that | +| | | supports the use of ERTM or Streaming Mode | +| | | (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_25 | x | Performing L2CAP channel mode configuration | +| | | fallback from Streaming Mode to ERTM (C.8) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_26 | | Sending more than one unacknowledged I-Frame | +| | | when operating in ERTM (C.5) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_27 | | Sending more than three unacknowledged | +| | | I-Frame when operating in ERTM (C.5) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_28 | x | Peer TxWindow configuration greater than 1 | +| | | (C.5) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_29 | | AMP (C.24) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_30 | x | Fixed channel(s) (C.11) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_31 | | AMP Manager (C.18) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_32 | | ERTM over AMP (C.25) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_33 | | Streaming Mode Source over AMP (C.12) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_34 | | Streaming Mode Sink over AMP (C.12) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_35 | | Unicast Connectionless Data, Reception (O) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_36 | | Ability to transmit an unencrypted packet | +| | | over a Unicast connectionless L2CAP channel | +| | | (O) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_37 | | Ability to transmit an encrypted packet over | +| | | a Unicast connectionless L2CAP channel (O) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_38 | | Extended Flow Specification for BR/EDR (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_39 | | Extended Window Size (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_40 | x | L2CAP LE Signaling channel (C.13) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_41 | x | Command reject (C.13) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_42 | x | Send Connection Parameter Update Request | +| | | (C.14) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_43 | x | Send Connection Parameter Update Response | +| | | (C.15) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_44 | | Extended Flow Specification for AMP (C.18) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_45 | x | Send Disconnect Request Command (C.21) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_45a | | Send Disconnect Request Command - LE (C.22) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_46 | | LE Credit Based Flow Control Mode (C.19) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_47 | | LE Data Channel (C.20) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_48 | | Enhanced Credit Based Flow Control Mode | +| | | (C.23) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_48a | | Enhanced Credit Based Flow Control Mode - | +| | | BR/EDR (C.26) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_2_48b | | Enhanced Credit Based Flow Control Mode - LE | +| | | (C.27) | ++------------------+----------+----------------------------------------------+ + +- O: Optional +- C.1: Optional IF L2CAP 2/12 "Enhanced Retransmission Mode" OR + L2CAP 2/13 "Streaming Mode", otherwise Excluded. +- C.2: Optional IF L2CAP 2/12 "Enhanced Retransmission Mode" AND + L2CAP 2/28 "Peer TxWindow configuration greater than 1", otherwise Excluded. +- C.3: Mandatory to support at least one IF L2CAP 2/12 "Enhanced + Retransmission Mode", otherwise Excluded. +- C.4: Mandatory to support at least one IF L2CAP 2/13 "Streaming Mode", + otherwise Excluded. +- C.5: Optional IF L2CAP 2/12 "Enhanced Retransmission Mode", + otherwise Excluded. +- C.6: Optional IF L2CAP 2/13 "Streaming Mode", otherwise Excluded. +- C.8: Mandatory IF L2CAP 2/12 "Enhanced Retransmission Mode" AND L2CAP 2/13 + "Streaming Mode" AND L2CAP 2/21 "Optional use of Streaming Mode", + otherwise Excluded. +- C.11: Mandatory IF SUM ICS 31/18 "Core v4.2+HS", otherwise Optional. +- C.12: Optional IF L2CAP 2/29 "AMP", otherwise Excluded. +- C.13: Mandatory IF L2CAP 0/2 "LE" OR L2CAP 0/3 "BR/EDR/LE", + otherwise Excluded. +- C.14: Optional IF L2CAP 1/4 "LE Peripheral", otherwise Excluded. +- C.15: Mandatory IF L2CAP 1/3 "LE Central", otherwise Excluded. +- C.16: Mandatory IF L2CAP 0/1 "BR/EDR (includes possible support of GAP LE + Broadcaster or LE Observer roles)" OR L2CAP 0/3 "BR/EDR/LE", + otherwise Excluded. +- C.17: Optional IF L2CAP 0/1 "BR/EDR (includes possible support of GAP LE + Broadcaster or LE Observer roles)" OR L2CAP 0/3 "BR/EDR/LE", + otherwise Excluded. +- C.18: Mandatory IF L2CAP 2/29 "AMP", otherwise Excluded. +- C.19: Optional IF L2CAP 0/2 "LE" OR L2CAP 0/3 "BR/EDR/LE", + otherwise Excluded. +- C.20: Mandatory IF L2CAP 2/46 "LE Credit Based Flow Control Mode", + otherwise Excluded. +- C.21: Optional IF L2CAP 2/1 "L2CAP Signaling channel over BR/EDR", + otherwise Excluded. +- C.22: Optional IF L2CAP 2/40 "L2CAP LE Signaling channel" AND L2CAP 2/46 + "LE Credit Based Flow Control Mode", otherwise Excluded. +- C.23: Excluded IF SUM ICS 31/17 "Core v4.2" OR SUM ICS 31/18 "Core v4.2+HS" + OR SUM ICS 31/19 "Core v5.0" OR SUM ICS 31/20 "Core v5.1", + otherwise Optional. +- C.24: Mandatory IF SUM ICS 31/18 "Core v4.2+HS", otherwise Optional IF SUM + ICS 31/17 "Core v4.2" OR SUM ICS 31/19 "Core v5.0" OR SUM ICS 31/20 + "Core v5.1" OR SUM ICS 31/21 "Core v5.2", otherwise Excluded. +- C.25: Optional IF L2CAP 2/12 "Enhanced Retransmission Mode" AND L2CAP 2/29 + "AMP", otherwise Excluded. +- C.26: Optional IF L2CAP 2/48 "Enhanced Credit Based Flow Control Mode" AND + (L2CAP 0/1 "BR/EDR (includes possible support of GAP LE Broadcaster or LE + Observer roles)" OR L2CAP 0/3 "BR/EDR/LE"), otherwise Excluded. +- C.27: Optional IF L2CAP 2/48 "Enhanced Credit Based Flow Control Mode" AND + (L2CAP 0/2 "LE" OR L2CAP 0/3 "BR/EDR/LE"), otherwise Excluded. + +Capability Statement +==================== +**Table 3: Configurable Parameters** + ++------------------+----------+----------------------------------------------+ +| Parameter Name | Selected | Description | ++==================+==========+==============================================+ +| TSPC_L2CAP_3_1 | x | RTX timer (M) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_2 | x | ERTX timer (C.4) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_3 | x | Minimum MTU size of 48 octets (C.4) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_4 | x | MTU size larger than 48 octets (C.5) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_5 | x | Flush timeout value for reliable channel | +| | | (C.4) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_6 | x | Flush timeout value for unreliable channel | +| | | (C.5) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_7 | x | Bi-directional quality of service (QoS) | +| | | option field (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_8 | | Negotiate QoS service type (C.5) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_9 | | Negotiate and support service type | +| | | 'No traffic' (C.2) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_10 | | Negotiate and support service type | +| | | 'Best effort' (C.3) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_11 | | Negotiate and support service type | +| | | 'Guaranteed' (C.2) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_12 | x | Minimum MTU size of 23 octets (C.6) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_13 | | Negotiate and support service type | +| | | 'No traffic' for Extended Flow Specification | +| | | (C.7) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_14 | | Negotiate and support service type | +| | | 'Best Effort' for Extended Flow Specification| +| | | (C.8) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_15 | | Negotiate and support service type | +| | | 'Guaranteed' for Extended Flow Specification.| +| | | (C.7) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_3_16 | | Support Multiple Simultaneous LE Data | +| | | Channels (C.10) | ++------------------+----------+----------------------------------------------+ + +- M: Mandatory +- C.1: Mandatory IF L2CAP 3/8 "Negotiate QoS service type", otherwise + Optional. +- C.2: Optional IF L2CAP 3/8 "Negotiate QoS service type", otherwise Excluded. +- C.3: Mandatory IF L2CAP 3/8 "Negotiate QoS service type", otherwise + Excluded. +- C.4: Mandatory IF L2CAP 0/1 "BR/EDR (includes possible support of GAP LE + Broadcaster or LE Observer roles)" OR L2CAP 0/3 "BR/EDR/LE", otherwise + Excluded. +- C.5: Optional IF L2CAP 0/1 "BR/EDR (includes possible support of GAP LE + Broadcaster or LE Observer roles)" OR L2CAP 0/3 "BR/EDR/LE", otherwise + Excluded. +- C.6: Mandatory IF L2CAP 0/2 "LE" OR L2CAP 0/3 "BR/EDR/LE", otherwise + Excluded. +- C.7: Optional IF L2CAP 2/44 "Extended Flow Specification for AMP" OR + L2CAP 2/38 "Extended Flow Specification for BR/EDR", otherwise Excluded. +- C.8: Mandatory IF L2CAP 2/44 "Extended Flow Specification for AMP" OR + L2CAP 2/38 "Extended Flow Specification for BR/EDR", otherwise Excluded. +- C.10: Optional IF L2CAP 2/47 "LE Data Channel", otherwise Excluded. + +Capability Statement +==================== +**Table 4: GAP Requirements - Security Aspects (LE)** + ++------------------+----------+----------------------------------------------+ +| Parameter Name | Selected | Description | ++==================+==========+==============================================+ +| TSPC_L2CAP_4_1 | | Authentication procedure (LE) (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_4_2 | | Authorization procedure (LE) (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_4_3 | x | Encryption procedure (C.2) | ++------------------+----------+----------------------------------------------+ + +- C.1: Optional IF L2CAP 0/2 "LE" OR L2CAP 0/3 "BR/EDR/LE", otherwise not + defined. +- C.2: Mandatory IF GAP 25/6 "Authenticate signed data procedure" OR + GAP 25/7 "Authenticated Pairing (LE security mode 1 level 3)" OR + GAP 25/9 "LE security mode 1 level 4" OR + GAP 35/6 "Authenticate signed data procedure" OR + GAP 35/7 "Authenticated Pairing (LE security mode 1 level 3)" OR + GAP 35/9 "LE security mode 1 level 4", otherwise Optional. + +Capability Statement +==================== +**Table 5: GAP Requirements - Security Aspects (BR/EDR)** + ++------------------+----------+----------------------------------------------+ +| Parameter Name | Selected | Description | ++==================+==========+==============================================+ +| TSPC_L2CAP_5_1 | | Authentication procedure (BR/EDR) (C.1) | ++------------------+----------+----------------------------------------------+ +| TSPC_L2CAP_5_2 | | Authorization procedure (BR/EDR) (O) | ++------------------+----------+----------------------------------------------+ + +- O: Optional +- C.1: Mandatory IF GAP 2/1 "Authentication procedure", otherwise Optional.
doc/qualification/l2cap-pts.rst new file +443 -0
443 lines not on this page · raw message
Signature · 1 line
2.43.0
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=1044232
---Test result---
Test Summary:
CheckPatch PENDING 0.41 seconds GitLint PENDING 0.37 seconds BuildEll PASS 20.35 seconds BluezMake PASS 651.84 seconds MakeCheck PASS 19.07 seconds MakeDistcheck PASS 246.59 seconds CheckValgrind PASS 296.95 seconds CheckSmatch PASS 360.51 seconds bluezmakeextell PASS 188.78 seconds IncrementalBuild PENDING 0.29 seconds ScanBuild PASS 1012.51 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
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 6 lines · On Mon, 19 Jan 2026 16:55:48 +0100 you wrote:
--- doc/qualification/l2cap-pics.rst | 345 ++++++++++++++++++++++++ doc/qualification/l2cap-pts.rst | 443 +++++++++++++++++++++++++++++++ 2 files changed, 788 insertions(+) create mode 100644 doc/qualification/l2cap-pics.rst create mode 100644 doc/qualification/l2cap-pts.rst
Here is the summary with links:
- [BlueZ] doc/qualification: Add PICS and howto for the L2CAP qualification
https://git.kernel.org/pub/scm/bluetooth/bluez.git/?id=ad1ab05699b1
You are awesome, thank you!
Signature · 2 lines
Deet-doot-dot, I am a bot. https://korg.docs.kernel.org/patchwork/pwbot.html