docs(ble): Uploaded the classic-bluetooth-architecture.png; Applied the suggestion from Mengyang

This commit is contained in:
Yuhan Wei 2024-07-25 14:31:01 +08:00 committed by Wei Yu Han
parent b71b3366d9
commit 124a23d9b1
5 changed files with 9 additions and 35 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

View File

@ -129,7 +129,7 @@ There are two hosts, ESP-Bluedroid and ESP-NimBLE. The major difference between
ESP-Bluedroid
^^^^^^^^^^^^^
ESP-Bluedroid is a modified version of the native Android Bluetooth stack, Bluedroid. It consists of two layers: the Bluetooth Upper Layer (BTU) and the Bluetooth Transport Controller layer (BTC). The BTU layer is responsible for processing bottom layer Bluetooth protocols such as L2CAP, GATT/ATT, SMP, GAP, and other profiles. The BTU layer provides an interface prefixed with "bta". The BTC layer is mainly responsible for providing a supported interface, prefixed with "esp", to the application layer, processing GATT-based profiles and handling miscellaneous tasks. All the APIs are located in the ESP_API layer. Developers should use the Bluetooth APIs prefixed with "esp".
ESP-Bluedroid is a modified version of the native Android Bluetooth stack, Bluedroid. It consists of two layers: the Bluetooth Upper Layer (BTU) and the Bluetooth Transport Controller layer (BTC). The BTU layer is responsible for processing bottom layer Bluetooth protocols such as L2CAP, GATT/ATT, SMP, GAP, and other profiles. The BTU layer provides an interface prefixed with "bta". The BTC layer is mainly responsible for providing a supported interface, prefixed with "esp", to the application layer, processing GATT-based profiles and handling miscellaneous tasks. All the APIs are located in the ESP_API layer. Developers should use the Bluetooth Low Energy APIs prefixed with "esp".
.. only:: esp32

View File

@ -13,14 +13,14 @@ The Classic Bluetooth stack in ESP-IDF is a layered architecture that enables Bl
.. only:: esp32
.. figure:: ../../../_static/bluetooth-architecture-no-ble-mesh.png
.. figure:: ../../../_static/classic-bluetooth.png
:align: center
:scale: 90%
:alt: {IDF_TARGET_NAME} Classic Bluetooth Stack Architecture
{IDF_TARGET_NAME} Classic Bluetooth Stack Architecture
The table below shows whether the Classic Bluetooth modules are supported in a specific chip series.
The table below shows whether the Classic Bluetooth Controller are supported in a specific chip series.
.. list-table::
:width: 100%
@ -29,28 +29,20 @@ The table below shows whether the Classic Bluetooth modules are supported in a s
* - Chip Series
- Controller
- ESP-Bluedroid
* - ESP32
- Y
- Y
* - ESP32-S2
- \
- \
* - ESP32-S3
- \
- \
* - ESP32-C2
- \
- \
* - ESP32-C3
- \-
- \-
* - ESP32-C6
- \-
- \-
* - ESP32-H2
- \-
- \-
The following sections briefly describe each layer and provide quick links to the related documents and application examples.
@ -67,13 +59,13 @@ At the bottom layer is ESP Bluetooth Controller, which encompasses various modul
Hosts
-----
There are one host, ESP-Bluedroid, supporting Classic Bluetooth in IDF.
There is one host, ESP-Bluedroid, supporting Classic Bluetooth in IDF.
ESP-Bluedroid
^^^^^^^^^^^^^
ESP-Bluedroid is a modified version of the native Android Bluetooth stack, Bluedroid. It consists of two layers: the Bluetooth Upper Layer (BTU) and the Bluetooth Transport Controller layer (BTC). The BTU layer is responsible for processing bottom layer Bluetooth protocols such as L2CAP, GATT/ATT, SMP, GAP, and other profiles. The BTU layer provides an interface prefixed with "bta". The BTC layer is mainly responsible for providing a supported interface, prefixed with "esp", to the application layer, processing GATT-based profiles and handling miscellaneous tasks. All the APIs are located in the ESP_API layer. Developers should use the Bluetooth APIs prefixed with "esp".
ESP-Bluedroid is a modified version of the native Android Bluetooth stack, Bluedroid. It consists of two layers: the Bluetooth Upper Layer (BTU) and the Bluetooth Transport Controller layer (BTC). The BTU layer is responsible for processing bottom layer Bluetooth protocols such as L2CAP and other profiles. The BTU layer provides an interface prefixed with "bta". The BTC layer is mainly responsible for providing a supported interface, prefixed with "esp", to the application layer and handling miscellaneous tasks. All the APIs are located in the ESP_API layer. Developers should use the Classic Bluetooth APIs prefixed with "esp".
- API references
@ -81,11 +73,6 @@ ESP-Bluedroid is a modified version of the native Android Bluetooth stack, Blued
- :doc:`../../api-reference/bluetooth/classic_bt`
- :example:`Application examples <bluetooth/bluedroid/classic_bt>`
Profiles
--------
Above the host stacks are the profile implementations by Espressif and some common profiles. Depending on your configuration, these profiles can run on ESP-Bluedroid.
Applications
------------

View File

@ -129,7 +129,7 @@ ESP 蓝牙主机
ESP-Bluedroid
^^^^^^^^^^^^^
ESP-Bluedroid 是原生 Android 蓝牙协议栈 Bluedroid 的修改版,由两层组成:蓝牙上层 (BTU) 和蓝牙传输控制器层 (BTC)。BTU 层负责处理 L2CAP、GATT/ATT、SMP、GAP 等底层蓝牙协议以及其他配置文件,提供以 "bta" 为前缀的接口。BTC 层主要负责向应用层提供以 "esp" 为前缀的支持接口,并处理基于 GATT 的配置文件以及其他任务。所有的 API 都位于 ESP_API 层,开发者应使用以 "esp" 为前缀的蓝牙 API。
ESP-Bluedroid 是原生 Android 蓝牙协议栈 Bluedroid 的修改版,由两层组成:蓝牙上层 (BTU) 和蓝牙传输控制器层 (BTC)。BTU 层负责处理 L2CAP、GATT/ATT、SMP、GAP 等底层蓝牙协议以及其他配置文件,提供以 "bta" 为前缀的接口。BTC 层主要负责向应用层提供以 "esp" 为前缀的支持接口,并处理基于 GATT 的配置文件以及其他任务。所有的 API 都位于 ESP_API 层,开发者应使用以 "esp" 为前缀的低功耗蓝牙 API。
.. only:: esp32

View File

@ -13,14 +13,14 @@ ESP-IDF 中的经典蓝牙协议栈是一个分层架构,可在 {IDF_TARGET_NA
.. only:: esp32
.. figure:: ../../../_static/bluetooth-architecture-no-ble-mesh.png
.. figure:: ../../../_static/classic-bluetooth.png
:align: center
:scale: 90%
:alt: {IDF_TARGET_NAME} 经典蓝牙协议栈架构
{IDF_TARGET_NAME} 经典蓝牙协议栈架构
参考下表可知特定芯片是否支持经典蓝牙模块
参考下表可知特定芯片是否支持经典蓝牙控制器
.. list-table::
:width: 100%
@ -29,28 +29,20 @@ ESP-IDF 中的经典蓝牙协议栈是一个分层架构,可在 {IDF_TARGET_NA
* - 芯片系列
- 控制器
- ESP-Bluedroid
* - ESP32
- Y
- Y
* - ESP32-S2
- \
- \
* - ESP32-S3
- \
- \
* - ESP32-C2
- \-
- \-
* - ESP32-C3
- \-
- \-
* - ESP32-C6
- \-
- \-
* - ESP32-H2
- \-
- \-
以下各节简要介绍了每个层,并提供了相关文档和应用示例的快速链接。
@ -73,7 +65,7 @@ IDF 中的ESP-Bluedroid 主机支持经典蓝牙。
ESP-Bluedroid
^^^^^^^^^^^^^
ESP-Bluedroid 是原生 Android 蓝牙协议栈 Bluedroid 的修改版,由两层组成:蓝牙上层 (BTU) 和蓝牙传输控制器层 (BTC)。BTU 层负责处理 L2CAP、GATT/ATT、SMP、GAP 等底层蓝牙协议以及其他配置文件,提供以 "bta" 为前缀的接口。BTC 层主要负责向应用层提供以 "esp" 为前缀的支持接口,并处理基于 GATT 的配置文件以及其他任务。所有的 API 都位于 ESP_API 层,开发者应使用以 "esp" 为前缀的蓝牙 API。
ESP-Bluedroid 是原生 Android 蓝牙协议栈 Bluedroid 的修改版,由两层组成:蓝牙上层 (BTU) 和蓝牙传输控制器层 (BTC)。BTU 层负责处理 L2CAP 等底层蓝牙协议以及其他配置文件,提供以 "bta" 为前缀的接口。BTC 层主要负责向应用层提供以 "esp" 为前缀的支持接口,并处理其他任务。所有的 API 都位于 ESP_API 层,开发者应使用以 "esp" 为前缀的经典蓝牙 API。
- API 参考
@ -81,11 +73,6 @@ ESP-Bluedroid 是原生 Android 蓝牙协议栈 Bluedroid 的修改版,由两
- :doc:`经典蓝牙 <../../api-reference/bluetooth/classic_bt>`
- :example:`应用程序示例 <bluetooth/bluedroid/classic_bt>`
蓝牙规范
--------
主机协议层之上是 Espressif 的蓝牙规范和一些常见的蓝牙规范。根据具体配置,这些规范可以在 ESP-Bluedroid 上运行。
应用
----