diff --git a/docs/_static/ble/feature_status/developing202603.svg b/docs/_static/ble/feature_status/developing202603.svg new file mode 100644 index 00000000000..ed5b6595330 --- /dev/null +++ b/docs/_static/ble/feature_status/developing202603.svg @@ -0,0 +1 @@ +In Progress: 2026/03In Progress2026/03 diff --git a/docs/_static/ble/feature_status/developing202606.svg b/docs/_static/ble/feature_status/developing202606.svg new file mode 100644 index 00000000000..c8c073d4843 --- /dev/null +++ b/docs/_static/ble/feature_status/developing202606.svg @@ -0,0 +1 @@ +In Progress: 2026/06In Progress2026/06 diff --git a/docs/conf_common.py b/docs/conf_common.py index 231dcdc259f..bf6c03c0f4b 100644 --- a/docs/conf_common.py +++ b/docs/conf_common.py @@ -30,6 +30,7 @@ BLE_DOCS = ['api-guides/ble/index.rst', 'api-guides/ble/host-feature-support-status.rst', 'api-guides/ble/ble-qualification.rst', 'api-guides/ble/ble-low-power-mode.rst', + 'api-guides/ble/ble-multiconnection-guide.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', diff --git a/docs/en/api-guides/ble/ble-feature-support-status.rst b/docs/en/api-guides/ble/ble-feature-support-status.rst index 67490bdd419..48299c96a2f 100644 --- a/docs/en/api-guides/ble/ble-feature-support-status.rst +++ b/docs/en/api-guides/ble/ble-feature-support-status.rst @@ -156,19 +156,19 @@ If none of our chip series meet your needs, please contact `customer support tea - .. only:: esp32h2 |experimental| - .. only:: not esp32h2 + .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 |unsupported| - .. only:: esp32h2 |experimental| - .. only:: not esp32h2 + .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 |unsupported| - .. only:: esp32h2 |experimental| - .. only:: not esp32h2 + .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 |unsupported| * - @@ -178,7 +178,7 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - Randomized Advertising Channel Indexing - - |unsupported| + - |developing202603| - |NA| - |NA| * - @@ -188,19 +188,19 @@ If none of our chip series meet your needs, please contact `customer support tea |unsupported| .. only:: esp32c6 or esp32h2 or esp32c2 - |experimental| + |supported| - .. only:: esp32 or esp32c3 or esp32s3 |unsupported| .. only:: esp32c6 or esp32h2 or esp32c2 - |experimental| + |supported| - .. only:: esp32 or esp32c3 or esp32s3 |unsupported| .. only:: esp32c6 or esp32h2 or esp32c2 - |experimental| + |supported| * - .. centered:: |5.2| - LE Isochronous Channels (BIS/CIS) - |unsupported| @@ -253,22 +253,22 @@ If none of our chip series meet your needs, please contact `customer support tea |supported| * - - LE Enhanced Connection Update (Connection Subrating) - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h |experimental| * - @@ -293,22 +293,22 @@ If none of our chip series meet your needs, please contact `customer support tea |experimental| * - .. centered:: |5.4| - Advertising Coding Selection - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 - |developing202512| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + |experimental| + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| * - @@ -323,6 +323,81 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - Periodic Advertising with Responses + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + * - .. centered:: |6.0| + - Channel Sounding + - |unsupported| + - |unsupported| + - |unsupported| + * - + - LL Extended Feature Set + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + * - + - Decision-Based Advertising Filtering + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Enhancements for ISOAL + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Monitoring Advertisers + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + * - + - Frame Space Update - |unsupported| - |unsupported| - |unsupported| @@ -346,6 +421,12 @@ You are encouraged to consult with our `customer support team `__ .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ +.. |6.0| replace:: `6.0 `__ diff --git a/docs/en/api-guides/ble/ble-multiconnection-guide.rst b/docs/en/api-guides/ble/ble-multiconnection-guide.rst new file mode 100644 index 00000000000..d7ad1deb81e --- /dev/null +++ b/docs/en/api-guides/ble/ble-multiconnection-guide.rst @@ -0,0 +1,63 @@ +Multi-Connection Guide +========================================== + +:link_to_translation:`zh_CN:[中文]` + +Introduction +-------------- + +The following table provides an overview of the maximum number of concurrent connections supported for each ESP Bluetooth LE Host. In multi-connection scenarios, connection parameters must be configured appropriately. In general, as the number of connections increases, the connection interval should be increased accordingly. For detailed parameter configuration recommendations and SDK configuration details, please refer to the corresponding example code in the following table. + +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. + +.. table:: Maximum Concurrent Connections by ESP Bluetooth LE Host + + +---------------+-----------------------------+------------------------------+---------------------+ + | Host | Max Connections | SDKconfig | Example | + +===============+=============================+==============================+=====================+ + | | | |bluedroid_enable_config| | | + | ESP-Bluedroid | |max_bluedroid_connections| | | |bluedroid_example| | + | | | |bluedroid_connection_num| | | + +---------------+-----------------------------+------------------------------+---------------------+ + | ESP-NimBLE | |max_nimble_connections| | |nimble_connection_num| | |nimble_example| | + +---------------+-----------------------------+------------------------------+---------------------+ + + +Note +---- + +1. The ability to support multiple connections highly depends on the application’s overall memory usage. It is recommended to disable unnecessary features to optimize multi-connection performance. + +2. When the device operates in the peripheral role, connection stability and overall performance will be influenced by the central device and the negotiated connection parameters. + +.. only:: not esp32 and not esp32c3 and not esp32s3 and not esp32c2 + + 3. Due to the relatively higher memory usage of ESP-Bluedroid, it supports fewer concurrent connections compared to ESP-Nimble. + + 4. If your application requires more simultaneous connections than the values listed above, please contact our `customer support team `__ for further assistance. + +.. |bluedroid_enable_config| replace:: :ref:`BT_MULTI_CONNECTION_ENBALE ` +.. |bluedroid_connection_num| replace:: :ref:`BT_ACL_CONNECTIONS ` +.. |bluedroid_example| replace:: :example:`multi_conn ` +.. |nimble_connection_num| replace:: :ref:`BT_NIMBLE_MAX_CONNECTIONS ` +.. |nimble_example| replace:: :example:`multi_conn` + +.. only:: esp32 or esp32c3 or esp32s3 + + .. |max_bluedroid_connections| replace:: 9 + .. |max_nimble_connections| replace:: 9 + +.. only:: esp32c2 + + .. |max_bluedroid_connections| replace:: 2 + .. |max_nimble_connections| replace:: 2 + +.. only:: esp32h2 + + .. |max_bluedroid_connections| replace:: 15 + .. |max_nimble_connections| replace:: 70 + +.. only:: esp32c6 + + .. |max_bluedroid_connections| replace:: 50 + .. |max_nimble_connections| replace:: 70 diff --git a/docs/en/api-guides/ble/host-feature-support-status.rst b/docs/en/api-guides/ble/host-feature-support-status.rst index 6dcc45d59ad..d17a95bbf9b 100644 --- a/docs/en/api-guides/ble/host-feature-support-status.rst +++ b/docs/en/api-guides/ble/host-feature-support-status.rst @@ -112,7 +112,7 @@ If none of our chip series meet your needs, please contact `customer support tea - |supported| * - .. centered:: |5.4| - Advertising Coding Selection - - |developing202512| + - |experimental| - |supported| * - - Encrypted Advertising Data @@ -120,12 +120,36 @@ If none of our chip series meet your needs, please contact `customer support tea - |experimental| * - - LE GATT Security Levels Characteristic - - |unsupported| + - |experimental| - |experimental| * - - Periodic Advertising with Responses - - |developing202512| - |experimental| + - |experimental| + * - .. centered:: |6.0| + - Channel Sounding + - |experimental| + - |unsupported| + * - + - LL Extended Feature Set + - |developing202606| + - |developing202606| + * - + - Decision-Based Advertising Filtering + - |unsupported| + - |unsupported| + * - + - Enhancements for ISOAL + - |unsupported| + - |unsupported| + * - + - Monitoring Advertisers + - |developing202606| + - |developing202606| + * - + - Frame Space Update + - |unsupported| + - |unsupported| .. [1] If you would like to know the Bluetooth SIG certification information for supported features, @@ -140,6 +164,13 @@ You are encouraged to consult with our `customer support team `__ .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ +.. |6.0| replace:: `6.0 `__ diff --git a/docs/en/api-guides/ble/index.rst b/docs/en/api-guides/ble/index.rst index 5598db3cbd2..584571c555b 100644 --- a/docs/en/api-guides/ble/index.rst +++ b/docs/en/api-guides/ble/index.rst @@ -14,6 +14,7 @@ Overview ble-feature-support-status ble-qualification Low Power Mode Introduction + ble-multiconnection-guide *************** Get Started diff --git a/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst b/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst index 6943eada19b..028fb8a6970 100644 --- a/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst +++ b/docs/zh_CN/api-guides/ble/ble-feature-support-status.rst @@ -156,19 +156,19 @@ - .. only:: esp32h2 |experimental| - .. only:: not esp32h2 + .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 |unsupported| - .. only:: esp32h2 |experimental| - .. only:: not esp32h2 + .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 |unsupported| - .. only:: esp32h2 |experimental| - .. only:: not esp32h2 + .. only:: esp32 or esp32c3 or esp32s3 or esp32c6 or esp32c2 |unsupported| * - @@ -178,7 +178,7 @@ - |experimental| * - - Randomized Advertising Channel Indexing - - |unsupported| + - |developing202603| - |NA| - |NA| * - @@ -188,19 +188,19 @@ |unsupported| .. only:: esp32c6 or esp32h2 or esp32c2 - |experimental| + |supported| - .. only:: esp32 or esp32c3 or esp32s3 |unsupported| .. only:: esp32c6 or esp32h2 or esp32c2 - |experimental| + |supported| - .. only:: esp32 or esp32c3 or esp32s3 |unsupported| .. only:: esp32c6 or esp32h2 or esp32c2 - |experimental| + |supported| * - .. centered:: |5.2| - LE Isochronous Channels (BIS/CIS) - |unsupported| @@ -253,22 +253,22 @@ |supported| * - - LE Enhanced Connection Update (Connection Subrating) - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| * - @@ -293,22 +293,22 @@ |experimental| * - .. centered:: |5.4| - Advertising Coding Selection - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 - |developing202512| - - .. only:: esp32 or esp32c6 or esp32c2 or esp32h2 + |experimental| + - .. only:: esp32 |unsupported| - .. only:: esp32c3 or esp32s3 + .. only:: esp32c3 or esp32s3 or esp32c6 or esp32c2 or esp32h2 |experimental| * - @@ -323,6 +323,81 @@ - |experimental| * - - Periodic Advertising with Responses + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |experimental| + * - .. centered:: |6.0| + - Channel Sounding + - |unsupported| + - |unsupported| + - |unsupported| + * - + - LL Extended Feature Set + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + * - + - Decision-Based Advertising Filtering + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Enhancements for ISOAL + - |unsupported| + - |unsupported| + - |unsupported| + * - + - Monitoring Advertisers + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + - .. only:: esp32 or esp32c3 or esp32s3 + + |unsupported| + .. only:: esp32c6 or esp32c2 or esp32h2 + + |developing202606| + * - + - Frame Space Update - |unsupported| - |unsupported| - |unsupported| @@ -346,6 +421,12 @@ .. |developing202512| image:: ../../../_static/ble/feature_status/developing202512.svg :class: align-center :width: 120px +.. |developing202603| image:: ../../../_static/ble/feature_status/developing202603.svg + :class: align-center + :width: 125px +.. |developing202606| image:: ../../../_static/ble/feature_status/developing202606.svg + :class: align-center + :width: 125px .. |unsupported| image:: ../../../_static/ble/feature_status/unsupported.svg :class: align-center :width: 75px @@ -366,3 +447,4 @@ .. |5.2| replace:: `5.2 `__ .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ +.. |6.0| replace:: `6.0 `__ diff --git a/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst b/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst new file mode 100644 index 00000000000..c7686624573 --- /dev/null +++ b/docs/zh_CN/api-guides/ble/ble-multiconnection-guide.rst @@ -0,0 +1,63 @@ +多连接指南 +============================= + +:link_to_translation:`en:[English]` + +介绍 +---- + +下表展示了每个 ESP 低功耗蓝牙主机所支持的最大多连接个数。在多连接场景下，需要对连接参数进行合理配置。通常情况下，随着连接数量的增加，连接间隔（Connection Interval）也应相应增大。具体的参数配置建议和 sdkconfig 详细信息，请参阅下表中的相应示例代码。 + +在本文档中，最大连接数指设备作为中心设备或外围设备时，能够同时维持的最大连接数量。 + +.. table:: ESP 低功耗蓝牙主机支持的最大连接数 + + +---------------+-----------------------------+------------------------------+---------------------+ + | 主机（Host） | 最大连接个数 | SDKconfig | 示例 | + +===============+=============================+==============================+=====================+ + | | | |bluedroid_enable_config| | | + | ESP-Bluedroid | |max_bluedroid_connections| | | |bluedroid_example| | + | | | |bluedroid_connection_num| | | + +---------------+-----------------------------+------------------------------+---------------------+ + | ESP-NimBLE | |max_nimble_connections| | |nimble_connection_num| | |nimble_example| | + +---------------+-----------------------------+------------------------------+---------------------+ + + +注意 +---- + +1. 应用能够支持的最大连接数在很大程度上取决于整体内存使用情况。建议禁用不必要的功能，以优化多连接性能。 + +2. 当设备处于外围角色时，连接稳定性和整体性能将受到中心设备和协商连接参数的影响。 + +.. only:: not esp32 and not esp32c3 and not esp32s3 and not esp32c2 + + 3. 由于 ESP-Bluedroid 的内存占用相对更高，其支持的最大连接数会少于 ESP-Nimble。 + + 4. 如果您的应用需要的同时连接数量超过上述数值，请联系 `乐鑫客户支持团队 `__ 以获取进一步的协助。 + +.. |bluedroid_enable_config| replace:: :ref:`BT_MULTI_CONNECTION_ENBALE ` +.. |bluedroid_connection_num| replace:: :ref:`BT_ACL_CONNECTIONS ` +.. |bluedroid_example| replace:: :example:`multi_conn ` +.. |nimble_connection_num| replace:: :ref:`BT_NIMBLE_MAX_CONNECTIONS ` +.. |nimble_example| replace:: :example:`multi_conn` + +.. only:: esp32 or esp32c3 or esp32s3 + + .. |max_bluedroid_connections| replace:: 9 + .. |max_nimble_connections| replace:: 9 + +.. only:: esp32c2 + + .. |max_bluedroid_connections| replace:: 2 + .. |max_nimble_connections| replace:: 2 + +.. only:: esp32h2 + + .. |max_bluedroid_connections| replace:: 15 + .. |max_nimble_connections| replace:: 70 + +.. only:: esp32c6 + + .. |max_bluedroid_connections| replace:: 50 + .. |max_nimble_connections| replace:: 70 diff --git a/docs/zh_CN/api-guides/ble/host-feature-support-status.rst b/docs/zh_CN/api-guides/ble/host-feature-support-status.rst index a5f301073f0..94cc3c55e37 100644 --- a/docs/zh_CN/api-guides/ble/host-feature-support-status.rst +++ b/docs/zh_CN/api-guides/ble/host-feature-support-status.rst @@ -112,7 +112,7 @@ ESP 主机主要功能支持状态 - |supported| * - .. centered:: |5.4| - Advertising Coding Selection - - |developing202512| + - |experimental| - |supported| * - - Encrypted Advertising Data @@ -120,12 +120,36 @@ ESP 主机主要功能支持状态 - |experimental| * - - LE GATT Security Levels Characteristic - - |unsupported| + - |experimental| - |experimental| * - - Periodic Advertising with Responses - - |developing202512| - |experimental| + - |experimental| + * - .. centered:: |6.0| + - Channel Sounding + - |experimental| + - |unsupported| + * - + - LL Extended Feature Set + - |developing202606| + - |developing202606| + * - + - Decision-Based Advertising Filtering + - |unsupported| + - |unsupported| + * - + - Enhancements for ISOAL + - |unsupported| + - |unsupported| + * - + - Monitoring Advertisers + - |developing202606| + - |developing202606| + * - + - Frame Space Update + - |unsupported| + - |unsupported| .. [1] 如果想了解支持功能的 Bluetooth SIG 认证状态， @@ -140,6 +164,13 @@ ESP 主机主要功能支持状态 :class: align-center .. |developing202512| image:: ../../../_static/ble/feature_status/developing202512.svg :class: align-center + :width: 120px +.. |developing202603| image:: ../../../_static/ble/feature_status/developing202603.svg + :class: align-center + :width: 125px +.. |developing202606| image:: ../../../_static/ble/feature_status/developing202606.svg + :class: align-center + :width: 125px .. |unsupported| image:: ../../../_static/ble/feature_status/unsupported.svg :class: align-center .. |experimental| image:: ../../../_static/ble/feature_status/experimental.svg @@ -157,3 +188,4 @@ ESP 主机主要功能支持状态 .. |5.2| replace:: `5.2 `__ .. |5.3| replace:: `5.3 `__ .. |5.4| replace:: `5.4 `__ +.. |6.0| replace:: `6.0 `__ diff --git a/docs/zh_CN/api-guides/ble/index.rst b/docs/zh_CN/api-guides/ble/index.rst index a3d14113ff1..16895d38cce 100644 --- a/docs/zh_CN/api-guides/ble/index.rst +++ b/docs/zh_CN/api-guides/ble/index.rst @@ -14,6 +14,7 @@ ble-feature-support-status ble-qualification 低功耗模式介绍 + ble-multiconnection-guide ********** 快速入门