diff --git a/docs/en/api-guides/ble/ble-multiconnection-guide.rst b/docs/en/api-guides/ble/ble-multiconnection-guide.rst index 38f0c1cb43..b0a229c071 100644 --- a/docs/en/api-guides/ble/ble-multiconnection-guide.rst +++ b/docs/en/api-guides/ble/ble-multiconnection-guide.rst @@ -10,6 +10,9 @@ The following table provides an overview of the maximum number of concurrent con In this document, the maximum number of connections refers to the maximum number of simultaneous active connections that the device can maintain, whether operating as a central or peripheral. +Host SDKconfig +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + .. table:: Maximum Concurrent Connections by ESP Bluetooth LE Host +---------------+-----------------------------+------------------------------+---------------------+ @@ -23,6 +26,37 @@ In this document, the maximum number of connections refers to the maximum number +---------------+-----------------------------+------------------------------+---------------------+ +Controller SDKconfig +^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. only:: esp32 + + - :ref:`BTDM_CTRL_BLE_MAX_CONN ` + + The configuration option **BTDM_CTRL_BLE_MAX_CONN** specifies the maximum number of Bluetooth LE connections that the controller can support concurrently. This value must match the maximum number of connections configured on the Host side, as defined in the table above. + +.. only:: esp32c3 or esp32s3 + + - :ref:`BT_CTRL_BLE_MAX_ACT ` + + The configuration option **BT_CTRL_BLE_MAX_ACT** defines the maximum number of Bluetooth LE activities that the controller can handle simultaneously. Each Bluetooth LE activity consumes one resource, including: + + - Connections + - Advertising + - Scanning + - Periodic sync + + Therefore, this parameter should be configured as follows: + + **Maximum connections + required advertising, scanning and periodic sync instances** + + **Example:** If the Host supports up to 8 connections, and the application requires 1 advertising instance and 1 scanning instance concurrently, set **BT_CTRL_BLE_MAX_ACT** to 10 (8 + 1 + 1). + +.. only:: not esp32 and not esp32c3 and not esp32s3 + + - No controller-related SDK configuration is required. + + Note ---- diff --git a/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst b/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst index b43d6308ea..938fa4336a 100644 --- a/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst +++ b/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst @@ -10,10 +10,13 @@ 在本文档中,最大连接数指设备作为中心设备或外围设备时,能够同时维持的最大连接数量。 +主机 (Host) SDKconfig +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + .. table:: ESP 低功耗蓝牙主机支持的最大连接数 +---------------+-----------------------------+------------------------------+---------------------+ - | 主机(Host) | 最大连接个数 | SDKconfig | 示例 | + | 主机 (Host) | 最大连接个数 | SDKconfig | 示例 | +===============+=============================+==============================+=====================+ | | | |bluedroid_enable_config| | | | ESP-Bluedroid | |max_bluedroid_connections| | | |bluedroid_example| | @@ -23,6 +26,37 @@ +---------------+-----------------------------+------------------------------+---------------------+ +控制器 (Controller) SDKconfig +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. only:: esp32 + + - :ref:`BTDM_CTRL_BLE_MAX_CONN ` + + 配置项 **BTDM_CTRL_BLE_MAX_CONN** 用于指定控制器 (Controller) 可同时支持的最大低功耗蓝牙连接数。该值必须与上表中主机端配置的最大连接数保持一致。 + +.. only:: esp32c3 or esp32s3 + + - :ref:`BT_CTRL_BLE_MAX_ACT ` + + 配置项 **BT_CTRL_BLE_MAX_ACT** 用于定义控制器 (Controller) 可同时处理的最大 Bluetooth LE 活动数。每个 Bluetooth LE 活动都会占用一个资源,包括: + + - 连接 + - 广播 + - 扫描 + - 周期性同步 + + 因此,该参数应按以下方式配置: + + **最大连接数 + 所需的广播、扫描及周期性同步实例数量** + + **示例:** 如果主机 (Host) 配置为支持最多 8 个连接,且应用需要同时运行 1 个广播实例和 1 个扫描实例,建议将 **BT_CTRL_BLE_MAX_ACT** 设置为 10。 + +.. only:: not esp32 and not esp32c3 and not esp32s3 + + - 无需进行控制器 (Controller) 相关的 SDK 配置。 + + 注意 ----