Commit f2b6490d authored by Théo Battrel's avatar Théo Battrel Committed by Anas Nashif
Browse files

Docs: Bluetooth: Update qualification page 



With the new Bluetooth Qualification process the QDID and link to
launchstudio are outdated, remove them.

Also remove the ICS listing as it hasn't been updated for a while.
Instead add a download link to the Zephyr Bluetooth Host ICS file.

Update the documentation configuration script to include the ICS file
(`*.pts`) in the external contents.

Signed-off-by: default avatarThéo Battrel <theo.battrel@nordicsemi.no>
parent f9de58ef

doc/conf.py

+1 −0
Original line number Diff line number Diff line
@@ -325,6 +325,7 @@ external_content_contents = [ 
    (ZEPHYR_BASE, "samples/**/doc"),

    (ZEPHYR_BASE, "snippets/**/*.rst"),

    (ZEPHYR_BASE, "snippets/**/doc"),

    (ZEPHYR_BASE, "tests/**/*.pts"),

]

external_content_keep = [

    "reference/kconfig/*",

doc/connectivity/bluetooth/bluetooth-qual.rst

+11 −83
Original line number Diff line number Diff line
@@ -6,9 +6,12 @@ Qualification 
Qualification setup

*******************



.. _auto_pts_repository:

   https://github.com/auto-pts/auto-pts



The Zephyr Bluetooth host can be qualified using Bluetooth's PTS (Profile Tuning

Suite) software. It is originally a manual process, but is automated by using

the `AutoPTS automation software <https://github.com/auto-pts/auto-pts>`_.

the `AutoPTS automation software <auto_pts_repository>`_.



The setup is described in more details in the pages linked below.
@@ -18,89 +21,14 @@ The setup is described in more details in the pages linked below. 
   autopts/autopts-win10.rst

   autopts/autopts-linux.rst





Qualification Listings

**********************



The Zephyr BLE stack has obtained qualification listings for both the Host

and the Controller.

See the tables below for a list of qualification listings



Host qualifications

===================



.. list-table::

   :header-rows: 1



   * - Zephyr version

     - Link

     - Qualifying Company



   * - 2.2.x

     - `QDID 151074 <https://launchstudio.bluetooth.com/ListingDetails/109287>`_

     - Demant A/S



   * - 1.14.x

     - `QDID 139258 <https://launchstudio.bluetooth.com/ListingDetails/95152>`__

     - The Linux Foundation



   * - 1.13

     - `QDID 119517 <https://launchstudio.bluetooth.com/ListingDetails/70189>`__

     - Nordic Semiconductor



Mesh qualifications

===================



.. list-table::

   :header-rows: 1



   * - Zephyr version

     - Link

     - Qualifying Company



   * - 1.14.x

     - `QDID 139259 <https://launchstudio.bluetooth.com/ListingDetails/95153>`__

     - The Linux Foundation



Controller qualifications

=========================



.. list-table::

   :header-rows: 1



   * - Zephyr version

     - Link

     - Qualifying Company

     - Compatible Hardware



   * - 2.2.x

     - `QDID 150092 <https://launchstudio.bluetooth.com/ListingDetails/108089>`__

     - Nordic Semiconductor

     - nRF52x



   * - 1.14.x

     - `QDID 135679 <https://launchstudio.bluetooth.com/ListingDetails/90777>`__

     - Nordic Semiconductor

     - nRF52x



   * - 1.9 to 1.13

     - `QDID 101395 <https://launchstudio.bluetooth.com/ListingDetails/25166>`__

     - Nordic Semiconductor

     - nRF52x



ICS Features

*************

************



The ICS features for each supported protocol & profile can be found in

the following documents:

.. _bluetooth_qualification_website:

   https://qualification.bluetooth.com/



.. toctree::

   :maxdepth: 1

The Zephyr ICS file for the Host features can be downloaded here:

:download:`ICS_Zephyr_Bluetooth_Host.pts

</tests/bluetooth/qualification/ICS_Zephyr_Bluetooth_Host.pts>`.



   ics/gap.rst

   ics/gatt.rst

   ics/l2cap.rst

   ics/sm.rst

   ics/rfcomm.rst

   ics/mesh.rst

   ics/dis.rst
 
Use the `Bluetooth Qualification website <bluetooth_qualification_website>`_ to view and edit the ICS.

doc/connectivity/bluetooth/ics/dis.rst

deleted100644 → 0
+0 −50
Original line number Diff line number Diff line 
.. _dis-pics:



DIS ICS

*******



PTS version: 8.0.3



M - mandatory



O - optional





Service Version

===============



============== ======== ===================================

Parameter Name Selected Description

============== ======== ===================================

TSPC_DIS_0_1   True     Device Information Service v1.1 (M)

============== ======== ===================================



Transport Requirements

======================



============== ======== ===================================

Parameter Name Selected Description

============== ======== ===================================

TSPC_DIS_1_1   False    Service supported over BR/EDR (C.1)

TSPC_DIS_1_2   True     Service supported over LE (C.1)

TSPC_DIS_1_3   False    Service supported over HS (C.1)

============== ======== ===================================



Service Requirements

====================



============== ======== ======================================================================

Parameter Name Selected Description

============== ======== ======================================================================

TSPC_DIS_2_1   True     Device Information Service (M)

TSPC_DIS_2_2   True     Manufacturer Name String Characteristic (O)

TSPC_DIS_2_3   True     Model Number String Characteristic (O)

TSPC_DIS_2_4   True     Serial Number String Characteristic (O)

TSPC_DIS_2_5   True     Hardware Revision String Characteristic (O)

TSPC_DIS_2_6   True     Firmware Revision String Characteristic (O)

TSPC_DIS_2_7   True     Software Revision String Characteristic (O)

TSPC_DIS_2_8   False    System ID Characteristic (O)

TSPC_DIS_2_9   False    IEEE 11073-20601 Regulatory Certification Data List Characteristic (O)

TSPC_DIS_2_10  False    SDP Interoperability (C.1)

TSPC_DIS_2_11  True     PnP ID (O)

============== ======== ======================================================================

doc/connectivity/bluetooth/ics/gap.rst

deleted100644 → 0
+0 −680

File deleted.

Preview size limit exceeded, changes collapsed.

doc/connectivity/bluetooth/ics/gatt.rst

deleted100644 → 0
+0 −164
Original line number Diff line number Diff line 
.. _gatt-pics:



GATT ICS

********



PTS version: 8.0.3



M - mandatory



O - optional





Generic Attribute Profile Support

=================================



============== ======== =============================================

Parameter Name Selected Description

============== ======== =============================================

TSPC_GATT_1_1  True     Generic Attribute Profile (GATT) Client (C.1)

TSPC_GATT_1_2  True     Generic Attribute Profile (GATT) Server (C.2)

============== ======== =============================================



GATT role configuration

=======================



============== ======== =============================

Parameter Name Selected Description

============== ======== =============================

TSPC_GATT_1a_1 True     GATT Client over LE (C.1)

TSPC_GATT_1a_2 False    GATT Client over BR/EDR (C.2)

TSPC_GATT_1a_3 True     GATT Server over LE (C.3)

TSPC_GATT_1a_4 False    GATT Server over BR/EDR (C.4)

============== ======== =============================



Attribute Protocol Transport

============================



============== ======== =======================================================================================

Parameter Name Selected Description

============== ======== =======================================================================================

TSPC_GATT_2_1  False    Attribute Protocol Supported over BR/EDR (L2CAP fixed channel support) (C.1)

TSPC_GATT_2_2  True     Attribute Protocol Supported over LE (C.2)

TSPC_GATT_2_3  True     Enhanced ATT bearer Attribute Protocol Supported (L2CAP fixed EATT PSM supported) (C.3)

TSPC_GATT_2_3a True     Enhanced ATT bearer supported over LE (C.4)

TSPC_GATT_2_3b False    Enhanced ATT bearer supported over BR/EDR (C.5)

============== ======== =======================================================================================



Generic Attribute Profile Feature Support, by Client

====================================================



============== ======== =========================================================

Parameter Name Selected Description

============== ======== =========================================================

TSPC_GATT_3_1  True     Exchange MTU (C.11)

TSPC_GATT_3_2  True     Discover All Primary Services (O)

TSPC_GATT_3_3  True     Discover Primary Services by Service UUID (O)

TSPC_GATT_3_4  True     Find Included Services (O)

TSPC_GATT_3_5  True     Discover All characteristics of a Service (O)

TSPC_GATT_3_6  True     Discover Characteristics by UUID (O)

TSPC_GATT_3_7  True     Discover All Characteristic Descriptors (O)

TSPC_GATT_3_8  True     Read Characteristic Value (O)

TSPC_GATT_3_9  True     Read Using Characteristic UUID (O)

TSPC_GATT_3_10 True     Read Long Characteristic Values (O)

TSPC_GATT_3_11 True     Read Multiple Characteristic Values (O)

TSPC_GATT_3_12 True     Write without Response (O)

TSPC_GATT_3_13 True     Signed Write Without Response (C.11)

TSPC_GATT_3_14 True     Write Characteristic Value (O)

TSPC_GATT_3_15 True     Write Long Characteristic Values (O)

TSPC_GATT_3_16 True     Characteristic Value Reliable Writes (O)

TSPC_GATT_3_17 True     Notifications (C.7)

TSPC_GATT_3_18 True     Indications (M)

TSPC_GATT_3_19 True     Read Characteristic Descriptors (O)

TSPC_GATT_3_20 True     Read Long Characteristic Descriptors (O)

TSPC_GATT_3_21 True     Write Characteristic Descriptors (O)

TSPC_GATT_3_22 True     Write Long Characteristic Descriptors (O)

TSPC_GATT_3_23 True     Service Changed Characteristic (M)

TSPC_GATT_3_24 False    Configured Broadcast (C.2)

TSPC_GATT_3_25 True     Client Supported Features Characteristic (C.4)

TSPC_GATT_3_26 True     Database Hash Characteristic (C.4)

TSPC_GATT_3_27 False    Read and Interpret Characteristic Presentation Format (O)

TSPC_GATT_3_28 False    Read and Interpret Characteristic Aggregate Format (C.6)

TSPC_GATT_3_29 False    Read Multiple Variable Length Characteristic Values (C.9)

TSPC_GATT_3_30 False    Multiple Variable Length Notifications (C.10)

============== ======== =========================================================



Generic Attribute Profile Feature Support, by Server

====================================================



============== ======== =============================================================================

Parameter Name Selected Description

============== ======== =============================================================================

TSPC_GATT_4_1  True     Exchange MTU (C.6)

TSPC_GATT_4_2  True     Discover All Primary Services (M)

TSPC_GATT_4_3  True     Discover Primary Services by Service UUID (M)

TSPC_GATT_4_4  True     Find Included Services (M)

TSPC_GATT_4_5  True     Discover All characteristics of a Service (M)

TSPC_GATT_4_6  True     Discover Characteristics by UUID (M)

TSPC_GATT_4_7  True     Discover All Characteristic Descriptors (M)

TSPC_GATT_4_8  True     Read Characteristic Value (M)

TSPC_GATT_4_9  True     Read Using Characteristic UUID (M)

TSPC_GATT_4_10 True     Read Long Characteristic Values (C.12)

TSPC_GATT_4_11 True     Read Multiple Characteristic Values (O)

TSPC_GATT_4_12 True     Write without Response (C.2)

TSPC_GATT_4_13 True     Signed Write Without Response (C.6)

TSPC_GATT_4_14 True     Write Characteristic Value (C.3)

TSPC_GATT_4_15 True     Write Long Characteristic Values (C.12)

TSPC_GATT_4_16 True     Characteristic Value ReliableWrites (O)

TSPC_GATT_4_17 True     Notifications (O)

TSPC_GATT_4_18 True     Indications (C.1)

TSPC_GATT_4_19 True     Read Characteristic Descriptors (C.12)

TSPC_GATT_4_20 True     Read Long Characteristic Descriptors (C.12)

TSPC_GATT_4_21 True     Write Characteristic Descriptors (C.12)

TSPC_GATT_4_22 True     Write Long Characteristic Descriptors (O)

TSPC_GATT_4_23 True     Service Changed Characteristic (C.1)

TSPC_GATT_4_24 False    Configured Broadcast (C.5)

TSPC_GATT_4_25 False    Execute Write Request with empty queue (C.7)

TSPC_GATT_4_26 True     Client Supported Features Characteristic (C.9)

TSPC_GATT_4_27 True     Database Hash Characteristic (C.8)

TSPC_GATT_4_28 False    Report Characteristic Value: Characteristic Presentation Format (O)

TSPC_GATT_4_29 False    Report aggregate Characteristic Value: Characteristic Aggregate Format (C.10)

TSPC_GATT_4_30 False    Read Multiple Variable Length Characteristic Values (C.13)

TSPC_GATT_4_31 False    Multiple Variable Length Notifications (C.13)

============== ======== =============================================================================



SDP Interoperability

====================



============== ======== =============================================================

Parameter Name Selected Description

============== ======== =============================================================

TSPC_GATT_6_2  False    Discover GATT Services using Service Discovery Profile (C.1)

TSPC_GATT_6_3  False    Publish SDP record for GATT services support via BR/EDR (C.2)

============== ======== =============================================================



Attribute Protocol Transport Security

=====================================



============== ======== ===========================================

Parameter Name Selected Description

============== ======== ===========================================

TSPC_GATT_7_1  False    Security Mode 4 (C.1)

TSPC_GATT_7_2  True     LE Security Mode 1 (C.5)

TSPC_GATT_7_3  True     LE Security Mode 2 (C.6)

TSPC_GATT_7_4  True     LE Authentication Procedure (C.4)

TSPC_GATT_7_5  True     LE connection data signing procedure (C.2)

TSPC_GATT_7_6  True     LE Authenticate signed data procedure (C.2)

TSPC_GATT_7_7  True     LE Authorization Procedure (C.3)

============== ======== ===========================================



Multiple Simultaneous ATT Bearers

=================================



============== ======== ==================================================================================================================

Parameter Name Selected Description

============== ======== ==================================================================================================================

TSPC_GATT_8_1  False    Support for multiple simultaneous active ATT bearers from same device – ATT over LE and ATT over BR/EDR (C.1)

TSPC_GATT_8_2  True     Support for multiple simultaneous active ATT bearers from same device – ATT over LE and EATT over LE (C.2)

TSPC_GATT_8_3  False    Support for multiple simultaneous active ATT bearers from same device – ATT over BR/EDR and EATT over BR/EDR (C.3)

TSPC_GATT_8_4  False    Support for multiple simultaneous active ATT bearers from same device – ATT over LE and EATT over BR/EDR (C.4)

TSPC_GATT_8_5  False    Support for multiple simultaneous active ATT bearers from same device – ATT over BR/EDR and EATT over LE (C.5)

TSPC_GATT_8_6  False    Support for multiple simultaneous active EATT bearers from same device – EATT over BR/EDR and EATT over LE (C.6)

TSPC_GATT_8_7  False    Support for multiple simultaneous active EATT bearers from same device – EATT over BR/EDR (C.7)

TSPC_GATT_8_8  True     Support for multiple simultaneous active EATT bearers from same device – EATT over LE (C.7)

============== ======== ==================================================================================================================

CRA Git | Maintained and supported by SUSTech CRA and CCSE