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

docs(coex): update rf coexistence documents

Browse Source 
- remove BLE connecting state in coexistence scenario
- remove WIFI section in H2 docs
This commit is contained in:
linruihao 2025-02-14 15:51:17 +08:00
parent a28b62e2b9
commit 50e6628089
2 changed files with 132 additions and 120 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
docs/en/api-guides/coexist.rst
View File

@ -15,32 +15,32 @@ Supported Coexistence Scenario for {IDF_TARGET_NAME}
.. table:: Supported Features of Wi-Fi and BLE Coexistence
+-------+--------+-----------+-----+------------+-----------+----------+
+-------+--------+-----------+-----+------------+----------+
| |BLE |
+ +-----+------------+-----------+----------+
| |Scan |Advertising |Connecting |Connected |
+-------+--------+-----------+-----+------------+-----------+----------+
| Wi-Fi |STA |Scan |Y |Y |Y |Y |
+ + +-----------+-----+------------+-----------+----------+
| | |Connecting |Y |Y |Y |Y |
+ + +-----------+-----+------------+-----------+----------+
| | |Connected |Y |Y |Y |Y |
+ +--------+-----------+-----+------------+-----------+----------+
| |SOFTAP |TX Beacon |Y |Y |Y |Y |
+ + +-----------+-----+------------+-----------+----------+
| | |Connecting |C1 |C1 |C1 |C1 |
+ + +-----------+-----+------------+-----------+----------+
| | |Connected |C1 |C1 |C1 |C1 |
+ +--------+-----------+-----+------------+-----------+----------+
| |Sniffer |RX |C1 |C1 |C1 |C1 |
+ +--------+-----------+-----+------------+-----------+----------+
| |ESP-NOW |RX |S |S |S |S |
+ + +-----------+-----+------------+-----------+----------+
| | |TX |Y |Y |Y |Y |
+-------+--------+-----------+-----+------------+-----------+----------+
+ +-----+------------+----------+
| |Scan |Advertising |Connected |
+-------+--------+-----------+-----+------------+----------+
| Wi-Fi |STA |Scan |Y |Y |Y |
+ + +-----------+-----+------------+----------+
| | |Connecting |Y |Y |Y |
+ + +-----------+-----+------------+----------+
| | |Connected |Y |Y |Y |
+ +--------+-----------+-----+------------+----------+
| |SOFTAP |TX Beacon |Y |Y |Y |
+ + +-----------+-----+------------+----------+
| | |Connecting |C1 |C1 |C1 |
+ + +-----------+-----+------------+----------+
| | |Connected |C1 |C1 |C1 |
+ +--------+-----------+-----+------------+----------+
| |Sniffer |RX |C1 |C1 |C1 |
+ +--------+-----------+-----+------------+----------+
| |ESP-NOW |RX |S |S |S |
+ + +-----------+-----+------------+----------+
| | |TX |Y |Y |Y |
+-------+--------+-----------+-----+------------+----------+
.. only:: esp32
.. only:: SOC_WIFI_SUPPORTED and SOC_BT_CLASSIC_SUPPORTED
.. table:: Supported Features of Wi-Fi and Classic Bluetooth (BT) Coexistence
@ -96,24 +96,26 @@ Supported Coexistence Scenario for {IDF_TARGET_NAME}
.. table:: Supported Features of IEEE 802.15.4 (Thread / Zigbee) and BLE Coexistence
+-----------------+-------------+-----+------------+-----------+----------+
+-----------------+-------------+-----+------------+----------+
| |BLE |
+ +-----+------------+-----------+----------+
| |Scan |Advertising |Connecting |Connected |
+-----------------+-------------+-----+------------+-----------+----------+
| Thread / Zigbee |Scan |X |Y |Y |Y |
+ +-------------+-----+------------+-----------+----------+
| |Router |X |Y |Y |Y |
+ +-------------+-----+------------+-----------+----------+
| |End Device |C1 |Y |Y |Y |
+-----------------+-------------+-----+------------+-----------+----------+
+ +-----+------------+----------+
| |Scan |Advertising |Connected |
+-----------------+-------------+-----+------------+----------+
| Thread / Zigbee |Scan |X |Y |Y |
+ +-------------+-----+------------+----------+
| |Router |X |Y |Y |
+ +-------------+-----+------------+----------+
| |End Device |C1 |Y |Y |
+-----------------+-------------+-----+------------+----------+
.. note::
.. list::
- Y: supported and the performance is stable
- C1: supported but the performance is unstable
- X: not supported
- S: supported and the performance is stable in STA mode, otherwise not supported
:SOC_WIFI_SUPPORTED: - S: supported and the performance is stable in STA mode, otherwise not supported
.. only:: SOC_IEEE802154_SUPPORTED
@ -166,22 +168,24 @@ The RF resource allocation mechanism is based on priority. As shown below, Wi-Fi
Coexistence Policy
^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. only:: SOC_WIFI_SUPPORTED and SOC_BT_SUPPORTED
Coexistence Period and Time Slice
""""""""""""""""""""""""""""""""""""""""
.. only:: esp32
.. only:: SOC_BLE_SUPPORTED and SOC_BT_CLASSIC_SUPPORTED
Wi-Fi, BT, and BLE have their fixed time slice to use the RF. A coexistence period is divided into 3 time slices in the order of Wi-Fi, BT, and BLE. In the Wi-Fi slice, Wi-Fi's request to the coexistence arbitration module will have higher priority. Similarly, BT/BLE can enjoy higher priority at their own time slices. The duration of the coexistence period and the proportion of each time slice are divided into four categories according to the Wi-Fi status:
.. only:: SOC_WIFI_SUPPORTED and SOC_BLE_SUPPORTED and not esp32
.. only:: not SOC_BT_CLASSIC_SUPPORTED
Wi-Fi and BLE have their fixed time slice to use the RF. In the Wi-Fi time slice, Wi-Fi will send a higher priority request to the coexistence arbitration module. Similarly, BLE can enjoy higher priority at their own time slice. The duration of the coexistence period and the proportion of each time slice are divided into four categories according to the Wi-Fi status:
.. list::
:esp32: 1) IDLE status: the coexistence of BT and BLE is controlled by Bluetooth module.
:SOC_WIFI_SUPPORTED and SOC_BLE_SUPPORTED and not esp32: 1) IDLE status: RF module is controlled by Bluetooth module.
:SOC_BLE_SUPPORTED and SOC_BT_CLASSIC_SUPPORTED: 1) IDLE status: the coexistence of BT and BLE is controlled by Bluetooth module.
:not SOC_BT_CLASSIC_SUPPORTED: 1) IDLE status: RF module is controlled by Bluetooth module.
#) CONNECTED status: the coexistence period starts at the Target Beacon Transmission Time (TBTT) and is more than 100 ms.
#) SCAN status: Wi-Fi slice and coexistence period are longer than in the CONNECTED status. To ensure Bluetooth performance, the Bluetooth time slice will also be adjusted accordingly.
#) CONNECTING status: Wi-Fi slice is longer than in the CONNECTED status. To ensure Bluetooth performance, the Bluetooth time slice will also be adjusted accordingly.
@ -200,6 +204,8 @@ According to the coexistence logic, different coexistence periods and time slice
The IEEE 802.15.4 module requests RF resources based on pre-assigned priorities. Normal receive operations are assigned the lowest priority, meaning Wi-Fi and BLE will take over the RF whenever needed, while 802.15.4 can only receive during the remaining time. Other 802.15.4 operations, such as transmitting or receiving ACKs and transmitting or receiving at given time, are assigned higher priorities. However, their access to RF ultimately depends on the priorities of Wi-Fi and BLE operations at that moment.
.. only:: SOC_WIFI_SUPPORTED and SOC_BT_SUPPORTED
Dynamic Priority
""""""""""""""""""""""""""""

82
docs/zh_CN/api-guides/coexist.rst
View File

@ -15,32 +15,32 @@ ESP系列芯片最多支持三种射频收发模块: Bluetooth（BT 和 BLE）,
.. table:: Wi-Fi 和 BLE 共存支持功能
+-------+--------+-----------+-----+------------+-----------+----------+
+-------+--------+-----------+-----+------------+----------+
| |BLE |
+ +-----+------------+-----------+----------+
| |Scan |Advertising |Connecting |Connected |
+-------+--------+-----------+-----+------------+-----------+----------+
| Wi-Fi |STA |Scan |Y |Y |Y |Y |
+ + +-----------+-----+------------+-----------+----------+
| | |Connecting |Y |Y |Y |Y |
+ + +-----------+-----+------------+-----------+----------+
| | |Connected |Y |Y |Y |Y |
+ +--------+-----------+-----+------------+-----------+----------+
| |SOFTAP |TX Beacon |Y |Y |Y |Y |
+ + +-----------+-----+------------+-----------+----------+
| | |Connecting |C1 |C1 |C1 |C1 |
+ + +-----------+-----+------------+-----------+----------+
| | |Connected |C1 |C1 |C1 |C1 |
+ +--------+-----------+-----+------------+-----------+----------+
| |Sniffer |RX |C1 |C1 |C1 |C1 |
+ +--------+-----------+-----+------------+-----------+----------+
| |ESP-NOW |RX |S |S |S |S |
+ + +-----------+-----+------------+-----------+----------+
| | |TX |Y |Y |Y |Y |
+-------+--------+-----------+-----+------------+-----------+----------+
+ +-----+------------+----------+
| |Scan |Advertising |Connected |
+-------+--------+-----------+-----+------------+----------+
| Wi-Fi |STA |Scan |Y |Y |Y |
+ + +-----------+-----+------------+----------+
| | |Connecting |Y |Y |Y |
+ + +-----------+-----+------------+----------+
| | |Connected |Y |Y |Y |
+ +--------+-----------+-----+------------+----------+
| |SOFTAP |TX Beacon |Y |Y |Y |
+ + +-----------+-----+------------+----------+
| | |Connecting |C1 |C1 |C1 |
+ + +-----------+-----+------------+----------+
| | |Connected |C1 |C1 |C1 |
+ +--------+-----------+-----+------------+----------+
| |Sniffer |RX |C1 |C1 |C1 |
+ +--------+-----------+-----+------------+----------+
| |ESP-NOW |RX |S |S |S |
+ + +-----------+-----+------------+----------+
| | |TX |Y |Y |Y |
+-------+--------+-----------+-----+------------+----------+
.. only:: esp32
.. only:: SOC_WIFI_SUPPORTED and SOC_BT_CLASSIC_SUPPORTED
.. table:: Wi-Fi 和经典蓝牙 (BT) 共存支持功能
@ -96,24 +96,26 @@ ESP系列芯片最多支持三种射频收发模块: Bluetooth（BT 和 BLE）,
.. table:: IEEE 802.15.4 (Thread / Zigbee) 和 BLE 共存支持功能
+-----------------+-------------+-----+------------+-----------+----------+
+-----------------+-------------+-----+------------+----------+
| |BLE |
+ +-----+------------+-----------+----------+
| |Scan |Advertising |Connecting |Connected |
+-----------------+-------------+-----+------------+-----------+----------+
| Thread / Zigbee |Scan |X |Y |Y |Y |
+ +-------------+-----+------------+-----------+----------+
| |Router |X |Y |Y |Y |
+ +-------------+-----+------------+-----------+----------+
| |End Device |C1 |Y |Y |Y |
+-----------------+-------------+-----+------------+-----------+----------+
+ +-----+------------+----------+
| |Scan |Advertising |Connected |
+-----------------+-------------+-----+------------+----------+
| Thread / Zigbee |Scan |X |Y |Y |
+ +-------------+-----+------------+----------+
| |Router |X |Y |Y |
+ +-------------+-----+------------+----------+
| |End Device |C1 |Y |Y |
+-----------------+-------------+-----+------------+----------+
.. note::
.. list::
- Y：支持且性能稳定。
- C1：不能保证性能处于稳定状态。
- X：不支持。
- S：在 STA 模式下支持且性能稳定，否则不支持。
:SOC_WIFI_SUPPORTED: - S：在 STA 模式下支持且性能稳定，否则不支持。
.. only:: SOC_IEEE802154_SUPPORTED
@ -166,22 +168,24 @@ ESP系列芯片最多支持三种射频收发模块: Bluetooth（BT 和 BLE）,
共存策略
^^^^^^^^^^^^^^
.. only:: SOC_WIFI_SUPPORTED and SOC_BT_SUPPORTED
共存周期和时间片
"""""""""""""""""""
.. only:: esp32
.. only:: SOC_BLE_SUPPORTED and SOC_BT_CLASSIC_SUPPORTED
Wi-Fi、BT、BLE 三者对于 RF 的使用，主要是按照时间片来划分的。在一个共存周期内，按照 Wi-Fi、BT、BLE 的顺序划分时间片。在 Wi-Fi 的时间片内，Wi-Fi 会向共存仲裁模块发出较高优先级的请求，同理，BT/BLE 在自己的时间片内会具有较高优先级。共存周期大小和各个时间片占比根据 Wi-Fi 的状态分成四类：
.. only:: SOC_WIFI_SUPPORTED and SOC_BLE_SUPPORTED and not esp32
.. only:: not SOC_BT_CLASSIC_SUPPORTED
Wi-Fi、BLE 二者对于 RF 的使用，主要是按照时间片来划分的。在 Wi-Fi 的时间片内，Wi-Fi 会向共存仲裁模块发出较高优先级的请求，在 Bluetooth 的时间片内，BLE 会具有较高优先级。共存周期大小和各个时间片占比根据 Wi-Fi 的状态分成四类：
.. list::
:esp32: 1) IDLE 状态：BT 和 BLE 共存由 Bluetooth 模块控制。
:SOC_WIFI_SUPPORTED and SOC_BLE_SUPPORTED and not esp32: 1) IDLE 状态：RF 模块由 Bluetooth 模块控制。
:SOC_BLE_SUPPORTED and SOC_BT_CLASSIC_SUPPORTED: 1) IDLE 状态：BT 和 BLE 共存由 Bluetooth 模块控制。
:not SOC_BT_CLASSIC_SUPPORTED: 1) IDLE 状态：RF 模块由 Bluetooth 模块控制。
#) CONNECTED 状态：共存周期以目标信标传输时间 (Target Beacon Transmission Time, TBTT) 点为起始点，周期大于 100 ms。
#) SCAN 状态：Wi-Fi 时间片以及共存周期都比在 CONNECTED 状态下的长。为了确保蓝牙的性能，蓝牙的时间片也会做相应的调整。
#) CONNECTING 状态：Wi-Fi 时间片比在 CONNECTED 状态下的长。为了确保蓝牙的性能，蓝牙的时间片也会做相应的调整。
@ -200,6 +204,8 @@ ESP系列芯片最多支持三种射频收发模块: Bluetooth（BT 和 BLE）,
IEEE 802.15.4 模块根据预先分配的优先级请求 RF 资源。普通的接收操作被分配为最低优先级，这意味着 Wi-Fi 和 BLE 在需要时会优先占用 RF，而 802.15.4 只能在剩余时间内进行接收。其他 802.15.4 操作，例如发送和接收 ACK 以及在指定时间内的发送和接收，被分配了更高的优先级。然而，它们能否实际获得 RF 资源最终取决于当时 Wi-Fi 和 BLE 操作的优先级。
.. only:: SOC_WIFI_SUPPORTED and SOC_BT_SUPPORTED
动态优先级
"""""""""""""""""""