public inbox for linux-bluetooth@vger.kernel.org
 help / color / mirror / Atom feed
From: "Frédéric Danis" <frederic.danis@collabora.com>
To: linux-bluetooth@vger.kernel.org
Subject: [PATCH BlueZ] doc/qualification: Add PICS and howto for the RFComm qualification
Date: Tue, 27 Jan 2026 18:13:06 +0100	[thread overview]
Message-ID: <20260127171306.151311-1-frederic.danis@collabora.com> (raw)

---
 doc/qualification/rfcomm-pics.rst | 106 ++++++++++++++++++++++++++++++
 doc/qualification/rfcomm-pts.rst  |  58 ++++++++++++++++
 2 files changed, 164 insertions(+)
 create mode 100644 doc/qualification/rfcomm-pics.rst
 create mode 100644 doc/qualification/rfcomm-pts.rst

diff --git a/doc/qualification/rfcomm-pics.rst b/doc/qualification/rfcomm-pics.rst
new file mode 100644
index 000000000..5ab1b07be
--- /dev/null
+++ b/doc/qualification/rfcomm-pics.rst
@@ -0,0 +1,106 @@
+.. SPDX-License-Identifier: GPL-2.0-or-later
+.. Copyright © 2025-2026 Collabora Ltd.
+
+===============
+RFComm Protocol
+===============
+(TCRL pkg101, RFCOMM.ICS.p8)
+
+
+Versions
+========
+**Table 0: X.Y Versions**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_RFCOMM_0_1  |          | RFCOMM v1.1 with TS 07.10 (C.1)              |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_0_2  | x        | RFCOMM v1.2 with TS 07.10 (C.1)              |
++------------------+----------+----------------------------------------------+
+
+- C.1: Mandatory to support one and only one.
+
+Core Configuration
+==================
+**Table 0a: Core Configuration Requirements**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_RFCOMM_0a_1 | x        | Protocol supported over BR/EDR (C.1, C.3)    |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_0a_2 |          | 2 Protocol supported over LE (C.2)           |
++------------------+----------+----------------------------------------------+
+
+- C.1: Excluded for this Protocol IF CORE 41/2 “LE Core Configuration”.
+- C.2: Excluded for this Protocol.
+- C.3: Mandatory for this Protocol.
+
+2.3 Supported procedures
+========================
+**Table 1: Supported Procedures**
+
++------------------+----------+----------------------------------------------+
+| Parameter Name   | Selected | Description                                  |
++==================+==========+==============================================+
+| TSPC_RFCOMM_1_1  | x        | Initialize RFCOMM Session (C.5)              |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_2  | x        | Respond to Initialization of an RFCOMM       |
+|                  |          | Session (C.5)                                |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_3  | x        | Shutdown RFCOMM Session (M)                  |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_4  | x        | Respond to a Shutdown of an RFCOMM Session   |
+|                  |          | (M)                                          |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_5  | x        | Establish DLC (C.2)                          |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_6  | x        | Respond to Establishment of a DLC (C.1)      |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_7  | x        | Disconnect DLC (M)                           |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_8  | x        | Respond to Disconnection of a DLC (M)        |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_9  | x        | Respond to and send MSC Command (M)          |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_10 | x        | Initiate Transfer Information (M)            |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_11 | x        | Respond to Test Command (M)                  |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_12 | x        | Send Test Command (O)                        |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_13 | x        | React to Aggregate Flow Control (M)          |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_14 | x        | Respond to RLS Command (M)                   |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_15 |          | Send RLS Command (O)                         |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_16 | x        | Respond to PN Command (M)                    |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_17 | x        | Send PN Command (C.3)                        |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_18 | x        | Send Non-Supported Command (NSC) response    |
+|                  |          | (C.4)                                        |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_19 | x        | Respond to RPN Command (M)                   |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_20 | x        | Send RPN Command (O)                         |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_21 | x        | Closing Multiplexer by First Sending a DISC  |
+|                  |          | Command (O)                                  |
++------------------+----------+----------------------------------------------+
+| TSPC_RFCOMM_1_22 | x        | Support of Credit Based Flow Control (M)     |
++------------------+----------+----------------------------------------------+
+
+- M: Mandatory
+- O: Optional
+- C.1: Mandatory IF RFCOMM 1/2 “Respond to Initialization of an RFCOMM
+  Session”, otherwise Excluded.
+- C.2: Mandatory IF RFCOMM 1/1 “Initialize RFCOMM Session”, otherwise
+  Excluded.
+- C.3: Mandatory IF RFCOMM 1/1 “Initialize RFCOMM Session”, otherwise
+  Optional.
+- C.4: Mandatory IF RFCOMM 0/2 “RFCOMM v1.2 with TS 07.10”, otherwise
+  Optional.
+- C.5: Mandatory to support at least one.
\ No newline at end of file
diff --git a/doc/qualification/rfcomm-pts.rst b/doc/qualification/rfcomm-pts.rst
new file mode 100644
index 000000000..860ef6508
--- /dev/null
+++ b/doc/qualification/rfcomm-pts.rst
@@ -0,0 +1,58 @@
+.. SPDX-License-Identifier: GPL-2.0-or-later
+.. Copyright © 2025-2026 Collabora Ltd.
+
+===================
+RFComm test results
+===================
+
+:PTS version: 8.5.2 Build 5
+
+Setup
+=====
+
+- Remove PTS device from Bluetooth devices
+- Update "TSPX_server_channel_iut" in IXIT to "10"
+
+Tests
+=====
+
+The kernel and BlueZ versions represent the oldest version without backport
+for which we know the test passed.
+
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| Test name                    | Result   | Kernel  | BlueZ |                                                                         |
++==============================+==========+=========+=======+=========================================================================+
+| RFCOMM/DEVA/RFC/BV-01-C      | PASS     |     6.1 | 5.69  | Run 'rctest -n -U spp <BD_ADDR>' upon request                           |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA/RFC/BV-05-C      | PASS     |     6.1 | 5.69  | Run 'rctest -n -U spp <BD_ADDR>' upon request                           |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVB/RFC/BV-02-C      | PASS     |     6.1 | 5.69  |                                                                         |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVB/RFC/BV-06-C      | PASS     |     6.1 | 5.69  | Run 'rctest -r -U spp -P 16' before starting the test                   |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-03-C | PASS     |     6.1 | 5.69  |                                                                         |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-04-C | PASS     |     6.1 | 5.69  | Run 'rctest -r -U spp -P 16' before starting the test                   |
+|                              |          |         |       |                                                                         |
+|                              |          |         |       | Kill rctest upon request                                                |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-07-C | PASS     |     6.1 | 5.69  | Run 'rctest -r -U spp -P 16' before starting the test                   |
+|                              |          |         |       |                                                                         |
+|                              |          |         |       | Kill rctest upon request                                                |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-08-C | PASS     |     6.1 | 5.69  | Run 'rctest -r -U spp -P 16' before starting the test                   |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-11-C | PASS     |     6.1 | 5.69  |                                                                         |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-13-C | PASS     |     6.1 | 5.69  | Run 'rctest -r -U spp -P 16' before starting the test                   |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-15-C | PASS     |     6.1 | 5.69  | Run 'rctest -r -U spp -P 16' before starting the test                   |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-17-C | PASS     |     6.1 | 5.69  |                                                                         |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-19-C | PASS     |     6.1 | 5.69  |                                                                         |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-21-C | PASS     |     6.1 | 5.69  | Run 'rctest -w -U spp -P 16' before starting the test                   |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
+| RFCOMM/DEVA-DEVB/RFC/BV-22-C | PASS     |     6.1 | 5.69  | Run 'rctest -w -U spp -P 16' before starting the test                   |
++------------------------------+----------+---------+-------+-------------------------------------------------------------------------+
-- 
2.43.0


             reply	other threads:[~2026-01-27 17:13 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-01-27 17:13 Frédéric Danis [this message]
2026-01-27 18:13 ` [BlueZ] doc/qualification: Add PICS and howto for the RFComm qualification bluez.test.bot
2026-01-27 18:30 ` [PATCH BlueZ] " patchwork-bot+bluetooth

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260127171306.151311-1-frederic.danis@collabora.com \
    --to=frederic.danis@collabora.com \
    --cc=linux-bluetooth@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox