diff --git a/docs/conf_common.py b/docs/conf_common.py index ea57bf680d..52d76cb3c8 100644 --- a/docs/conf_common.py +++ b/docs/conf_common.py @@ -20,6 +20,7 @@ BT_DOCS = ['api-guides/ble/blufi.rst', 'api-guides/ble/overview.rst', 'api-guides/ble/ble-feature-support-status.rst', 'api-guides/ble/host-feature-support-status.rst', + 'api-guides/ble/ble-qualification.rst', 'api-guides/ble/get-started/ble-connection.rst', 'api-guides/ble/get-started/ble-data-exchange.rst', 'api-guides/ble/get-started/ble-device-discovery.rst', diff --git a/docs/en/api-guides/ble/ble-qualification.rst b/docs/en/api-guides/ble/ble-qualification.rst new file mode 100644 index 0000000000..43493296e1 --- /dev/null +++ b/docs/en/api-guides/ble/ble-qualification.rst @@ -0,0 +1,70 @@ +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 `__. + +.. 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-S3 |.. centered:: |239440| |.. centered:: 5.4 | + +-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+ + + +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 `__ + - .. centered:: 5.3 + * - ESP-NimBLE + - .. centered:: `141499 `__ + - .. centered:: 5.1 + +.. |141661| replace:: `141661 `__ +.. |147845| replace:: `147845 `__ +.. |239440| replace:: `239440 `__ +.. |194009| replace:: `194009 `__ +.. |199258| replace:: `199258 `__ +.. |198312| replace:: `198312 `__ +.. |141499| replace:: `141499 `__ +.. |Q331318| replace:: `Q331318 `__ + + +.. [1] + Since 1 July 2024, the identifying number for a new qualified design has changed from Qualified Design ID (QDID) to `Design Number (DN) `_. + Please log in to the `Bluetooth SIG website `__ 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 ` for the supported Bluetooth LE features on each chip. diff --git a/docs/en/api-guides/ble/index.rst b/docs/en/api-guides/ble/index.rst index 499ded12fa..2f3dc18c8a 100644 --- a/docs/en/api-guides/ble/index.rst +++ b/docs/en/api-guides/ble/index.rst @@ -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 diff --git a/docs/zh_CN/api-guides/ble/ble-qualification.rst b/docs/zh_CN/api-guides/ble/ble-qualification.rst new file mode 100644 index 0000000000..7d35a0c07d --- /dev/null +++ b/docs/zh_CN/api-guides/ble/ble-qualification.rst @@ -0,0 +1,70 @@ +蓝牙\ :sup:`®` SIG 认证 +================================ + +:link_to_translation:`en:[English]` + +控制器 (Controller) +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +参考下表可知乐鑫各芯片上最新的低功耗蓝牙控制器认证信息。 有关乐鑫模组的认证信息，请参阅 `SIG Qualification Workspace `__ 。 + +.. 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-S3 |.. centered:: |239440| |.. centered:: 5.4 | + +-----------------------------------------------------------------------+-------------------------------------------+------------------------------------------+ + + +主机 (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 `__ + - .. centered:: 5.3 + * - ESP-NimBLE + - .. centered:: `141499 `__ + - .. centered:: 5.1 + +.. |141661| replace:: `141661 `__ +.. |147845| replace:: `147845 `__ +.. |239440| replace:: `239440 `__ +.. |194009| replace:: `194009 `__ +.. |199258| replace:: `199258 `__ +.. |198312| replace:: `198312 `__ +.. |141499| replace:: `141499 `__ +.. |Q331318| replace:: `Q331318 `__ + + + + +.. [1] + 自 2024 年 7 月 1 日起，蓝牙 SIG 新认证的设计识别编号已从 Qualified Deign ID (QDID) 更改为 `Design Number (DN) `__。 + 请登录 `Bluetooth SIG 官方网站 `__ 以获取合格产品的详细信息，例如设计详情、TCRL 版本和 ICS 详情（通过的测试用例）等。 + +.. [2] + 蓝牙协议中的某些功能是可选的，因此通过某个协议版本的认证并不意味着支持该版本协议中规定的所有功能 + 请参阅 :doc:`主要功能支持状态 ` 以获取各个芯片当前支持的低功耗蓝牙功能。 diff --git a/docs/zh_CN/api-guides/ble/index.rst b/docs/zh_CN/api-guides/ble/index.rst index 4dfa0ff4fe..f96c691822 100644 --- a/docs/zh_CN/api-guides/ble/index.rst +++ b/docs/zh_CN/api-guides/ble/index.rst @@ -1,6 +1,6 @@ -################ -低功耗蓝牙® -################ +###################### +低功耗蓝牙\ :sup:`®` +###################### :link_to_translation:`en:[English]` @@ -12,6 +12,7 @@ overview ble-feature-support-status + ble-qualification ********** 快速入门