blackbeard420/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf synced 2025-03-09 17:19:09 -04:00
Code Issues Projects Releases Wiki Activity

docs(ble): Added BLE Qualification Information to API Guides (v5.4)

Browse Source
This commit is contained in:
Wei Yu Han 2025-01-06 17:33:09 +08:00 committed by Island
parent 9dcd2990a7
commit 6f4b1d8767
7 changed files with 164 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
docs/conf_common.py
View File

@ -27,11 +27,12 @@ BLE_DOCS = ['api-guides/ble/index.rst',
'api-guides/ble/overview.rst',
'api-guides/ble/ble-feature-support-status.rst',
'api-guides/ble/host-feature-support-status.rst',
'api-reference/bluetooth/bt_le.rst',
'api-guides/ble/ble-qualification.rst',
'api-guides/ble/get-started/ble-introduction.rst',
'api-guides/ble/get-started/ble-device-discovery.rst',
'api-guides/ble/get-started/ble-connection.rst',
'api-guides/ble/get-started/ble-data-exchange.rst',
'api-reference/bluetooth/bt_le.rst',
'api-reference/bluetooth/esp_gap_ble.rst',
'api-reference/bluetooth/esp_gatt_defs.rst',
'api-reference/bluetooth/esp_gatts.rst',

74
docs/en/api-guides/ble/ble-qualification.rst Normal file
View File

@ -0,0 +1,74 @@
Bluetooth\ :sup:`®` SIG Qualification
======================================
:link_to_translation:`zh_CN:[中文]`
Controller
^^^^^^^^^^^
The table below shows the latest qualification for Espressif Bluetooth LE Controller on each chip. For the qualification of Espressif modules, please check the `SIG Qualification Workspace <https://qualification.bluetooth.com/MyProjects/ListingsSearch>`__.
.. table::
:widths: 70 20 10
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
| .. centered:: Chip Name |.. centered:: Design Number / |.. centered:: Specification |
| |.. centered:: Qualified Design ID [1]_ |.. centered:: Version [2]_ |
+=======================================================================+===========================================+==========================================+
|ESP32 | | |
| |.. centered:: |141661| |.. centered:: 5.0 |
|(Bluetooth LE Mode) | | |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32 | | |
| |.. centered:: |147845| |.. centered:: 4.2 |
|(Dual Mode: Bluetooth Classic & Bluetooth LE) | | |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-C2 (ESP8684) |.. centered:: |194009| |.. centered:: 5.3 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-C3 |.. centered:: |239440| |.. centered:: 5.4 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-C6 |.. centered:: |199258| |.. centered:: 5.3 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-S3 |.. centered:: |239440| |.. centered:: 5.4 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-H2 |.. centered:: |Q331318| |.. centered:: 6.0 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
Host
^^^^^^
The table below shows the latest qualification for Espressif Bluetooth LE Host.
.. list-table::
:width: 100%
:widths: auto
:header-rows: 1
* - .. centered:: Host
- .. centered:: Design Number / Qualified Design ID [1]_
- .. centered:: Specification Version [2]_
* - ESP-Bluedroid
- .. centered:: `198312 <https://qualification.bluetooth.com/ListingDetails/165785>`__
- .. centered:: 5.3
* - ESP-NimBLE
- .. centered:: `141499 <https://qualification.bluetooth.com/ListingDetails/97856>`__
- .. centered:: 5.1
.. |141661| replace:: `141661 <https://qualification.bluetooth.com/ListingDetails/98048>`__
.. |147845| replace:: `147845 <https://qualification.bluetooth.com/ListingDetails/105426>`__
.. |239440| replace:: `239440 <https://qualification.bluetooth.com/ListingDetails/212759>`__
.. |194009| replace:: `194009 <https://qualification.bluetooth.com/ListingDetails/160725>`__
.. |199258| replace:: `199258 <https://qualification.bluetooth.com/ListingDetails/166887>`__
.. |198312| replace:: `198312 <https://qualification.bluetooth.com/ListingDetails/165785>`__
.. |141499| replace:: `141499 <https://qualification.bluetooth.com/ListingDetails/97856>`__
.. |Q331318| replace:: `Q331318 <https://qualification.bluetooth.com/ListingDetails/257081>`__
.. [1]
Since 1 July 2024, the identifying number for a new qualified design has changed from Qualified Design ID (QDID) to `Design Number (DN) <https://qualification.support.bluetooth.com/hc/en-us/articles/26704417298573-What-do-I-need-to-know-about-the-new-Qualification-Program-Reference-Document-QPRD-v3#:~:text=The%20identifying%20number%20for%20a%20Design%20has%20changed%20from%20Qualified%20Design%20ID%20(QDID)%20to%20Design%20Number%20(DN)>`_.
Please log in to the `Bluetooth SIG website <https://www.bluetooth.com/>`__ to view Qualified Product Details, such as Design Details, TCRL Version, and ICS Details (passed cases) and etc.
.. [2]
Some features of the Bluetooth Core Specification are optional. Therefore, passing the certification for a specific specification version does not necessarily mean supporting all the features specified in that version.
Please refer to :doc:`Major Feature Support Status <ble-feature-support-status>` for the supported Bluetooth LE features on each chip.

7
docs/en/api-guides/ble/index.rst
View File

@ -1,6 +1,6 @@
#######################
Bluetooth® Low Energy
#######################
################################
Bluetooth\ :sup:`®` Low Energy
################################
:link_to_translation:`zh_CN:[中文]`
@ -12,6 +12,7 @@ Overview
overview
ble-feature-support-status
ble-qualification
***************
Get Started

6
docs/en/api-guides/classic-bt/index.rst
View File

@ -1,6 +1,6 @@
#######################
Bluetooth® Classic
#######################
##############################
Bluetooth\ :sup:`®` Classic
##############################
:link_to_translation:`zh_CN:[中文]`

74
docs/zh_CN/api-guides/ble/ble-qualification.rst Normal file
View File

@ -0,0 +1,74 @@
蓝牙\ :sup:`®` SIG 认证
================================
:link_to_translation:`en:[English]`
控制器 (Controller)
^^^^^^^^^^^^^^^^^^^^^^^^^^^
参考下表可知乐鑫各芯片上最新的低功耗蓝牙控制器认证信息。 有关乐鑫模组的认证信息，请参阅 `SIG Qualification Workspace <https://qualification.bluetooth.com/MyProjects/ListingsSearch>`__ 。
.. table::
:widths: 50 25 25
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|.. centered:: 芯片名称 |.. centered:: Design Number / |.. centered:: 协议版本 [2]_ |
| |.. centered:: Qualified Design ID [1]_ | |
+=======================================================================+===========================================+==========================================+
|ESP32 |.. centered:: |141661| |.. centered:: 5.0 |
|（低功耗蓝牙模式） | | |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32 |.. centered:: |147845| |.. centered:: 4.2 |
|（双模模式: 经典蓝牙 & 低功耗蓝牙） | | |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-C2 (ESP8684) |.. centered:: |194009| |.. centered:: 5.3 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-C3 |.. centered:: |239440| |.. centered:: 5.4 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-C6 |.. centered:: |199258| |.. centered:: 5.3 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-S3 |.. centered:: |239440| |.. centered:: 5.4 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
|ESP32-H2 |.. centered:: |Q331318| |.. centered:: 6.0 |
+-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+
主机 (Host)
^^^^^^^^^^^^^^^
参考下表可知最新的低功耗蓝牙主机的认证信息。
.. list-table::
:width: 100%
:widths: auto
:header-rows: 1
* - .. centered:: 主机 (Host)
- .. centered:: Design Number / Qualified Design ID [1]_
- .. centered:: 协议版本 [2]_
* - ESP-Bluedroid
- .. centered:: `198312 <https://qualification.bluetooth.com/ListingDetails/165785>`__
- .. centered:: 5.3
* - ESP-NimBLE
- .. centered:: `141499 <https://qualification.bluetooth.com/ListingDetails/97856>`__
- .. centered:: 5.1
.. |141661| replace:: `141661 <https://qualification.bluetooth.com/ListingDetails/98048>`__
.. |147845| replace:: `147845 <https://qualification.bluetooth.com/ListingDetails/105426>`__
.. |239440| replace:: `239440 <https://qualification.bluetooth.com/ListingDetails/212759>`__
.. |194009| replace:: `194009 <https://qualification.bluetooth.com/ListingDetails/160725>`__
.. |199258| replace:: `199258 <https://qualification.bluetooth.com/ListingDetails/166887>`__
.. |198312| replace:: `198312 <https://qualification.bluetooth.com/ListingDetails/165785>`__
.. |141499| replace:: `141499 <https://qualification.bluetooth.com/ListingDetails/97856>`__
.. |Q331318| replace:: `Q331318 <https://qualification.bluetooth.com/ListingDetails/257081>`__
.. [1]
自 2024 年 7 月 1 日起，蓝牙 SIG 新认证的设计识别编号已从 Qualified Deign ID (QDID) 更改为 `Design Number (DN) <https://qualification.support.bluetooth.com/hc/en-us/articles/26704417298573-What-do-I-need-to-know-about-the-new-Qualification-Program-Reference-Document-QPRD-v3#:~:text=The%20identifying%20number%20for%20a%20Design%20has%20changed%20from%20Qualified%20Design%20ID%20(QDID)%20to%20Design%20Number%20(DN)>`__。
请登录 `Bluetooth SIG 官方网站 <https://www.bluetooth.com/>`__ 以获取合格产品的详细信息，例如设计详情、TCRL 版本和 ICS 详情（通过的测试用例）等。
.. [2]
蓝牙协议中的某些功能是可选的，因此通过某个协议版本的认证并不意味着支持该版本协议中规定的所有功能
请参阅 :doc:`主要功能支持状态 <ble-feature-support-status>` 以获取各个芯片当前支持的低功耗蓝牙功能。

7
docs/zh_CN/api-guides/ble/index.rst
View File

@ -1,6 +1,6 @@
################
低功耗蓝牙®
################
#####################
低功耗蓝牙\ :sup:`®`
#####################
:link_to_translation:`en:[English]`
@ -12,6 +12,7 @@
overview
ble-feature-support-status
ble-qualification
**********
快速入门

6
docs/zh_CN/api-guides/classic-bt/index.rst
View File

@ -1,6 +1,6 @@
###########
经典蓝牙®
###########
###################
经典蓝牙\ :sup:`®`
###################
:link_to_translation:`en:[English]`