Skip to content

Commit 9f56f16

Browse files
committed
docs(ble): Fixed the common operation path for all chips
1 parent f60b142 commit 9f56f16

File tree

2 files changed

+21
-13
lines changed

2 files changed

+21
-13
lines changed

docs/en/api-guides/low-power-mode/low-power-mode-ble.rst

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ To use a 32kHz external crystal as the Bluetooth LE internal clock source, confi
4646

4747
.. only:: esp32 or esp32c3 or esp32s3
4848

49-
**Configuration Path:**
49+
**Configuration Path 1:**
5050

5151
``Component config → Bluetooth → Controller Options → MODEM SLEEP Options → Bluetooth modem sleep → Bluetooth Modem sleep Mode 1 → Bluetooth low power clock``
5252

@@ -64,13 +64,13 @@ To use a 32kHz external crystal as the Bluetooth LE internal clock source, confi
6464

6565
- \ (X) Use system RTC slow clock source
6666

67-
**Configuration Path 2:**
67+
**Configuration Path 2:**
6868

69-
``Component config → Hardware Settings → RTC Clock Config → RTC clock source``
69+
``Component config → Hardware Settings → RTC Clock Config → RTC clock source``
7070

71-
**Configuration Option:**
71+
**Configuration Option:**
7272

73-
- \ (X) External 32 kHz crystal
73+
- \ (X) External 32 kHz crystal
7474

7575
**Note:** Even if 32kHz is selected in menuconfig, the system will fall back to the main XTAL if the external crystal is not detected during Bluetooth LE initialization. This may lead to unexpected current consumption in light-sleep mode.
7676

@@ -82,7 +82,7 @@ Selecting 136 kHz RC Oscillator
8282

8383
To use a 136 kHz internal RC oscillator as the Bluetooth LE internal clock source, configure the following option:
8484

85-
**Configuration Path:** `
85+
**Configuration Path 1:**
8686

8787
`Component config → Bluetooth → Controller Options → MODEM SLEEP Options → Bluetooth modem sleep → Bluetooth Modem sleep Mode 1 → Bluetooth low power clock``
8888

@@ -108,6 +108,8 @@ Selecting 136 kHz RC Oscillator
108108

109109
- \ (X) Use system RTC slow clock source
110110

111+
.. only:: not esp32
112+
111113
**Configuration Path 2:**
112114

113115
``Component config → Hardware Settings → RTC Clock Config → RTC clock source``
@@ -116,6 +118,8 @@ Selecting 136 kHz RC Oscillator
116118

117119
- \ (X) Internal 136 kHz RC oscillator
118120

121+
.. only:: esp32c2 or esp32c6 or esp32h2 or esp32c5 or esp32c61
122+
119123
If low current consumption is required but have no access to the External 32kHz Crystal, then this clock source is recommended. However, selecting this clock source will have the sleep clock accuracy larger than 500 PPM, which is supported if the peer device is also an ESP chip. If the peer device is not an ESP chip, here's some Bluetooth LE event not supported:
120124

121125
1. Central role of Connection

docs/zh_CN/api-guides/low-power-mode/low-power-mode-ble.rst

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
低功耗模式下的时钟源选择
99
--------------------------------------------
1010

11-
在低功耗蓝牙应用场景中,由于协议要求休眠时钟精度需在 500 PPM 以内,light-sleep 和 modem-sleep 模式下所用的时钟源必须满足该要求。如果时钟精度不足,可能会出现 ACL 连接失败或超时断开等问题。**因此在使用前请确保所选时钟源及其精度满 要求**
11+
在低功耗蓝牙应用场景中,由于协议要求休眠时钟精度需在 500 PPM 以内,light-sleep 和 modem-sleep 模式下所用的时钟源必须满足该要求。如果时钟精度不足,可能会出现 ACL 连接失败或超时断开等问题。**因此在使用前请确保所选时钟源及其精度满足要求**
1212

1313

1414
选择主晶振
@@ -46,7 +46,7 @@
4646

4747
.. only:: esp32 or esp32c3 or esp32s3
4848

49-
**配置路径:**
49+
**配置路径 1**
5050

5151
``Component config → Bluetooth → Controller Options → MODEM SLEEP Options → Bluetooth modem sleep → Bluetooth Modem sleep Mode 1 → Bluetooth low power clock``
5252

@@ -64,13 +64,13 @@
6464

6565
- \ (X) Use system RTC slow clock source
6666

67-
**配置路径 2:**
67+
**配置路径 2:**
6868

69-
``Component config → Hardware Settings → RTC Clock Config → RTC clock source``
69+
``Component config → Hardware Settings → RTC Clock Config → RTC clock source``
7070

71-
**配置选项:**
71+
**配置选项:**
7272

73-
- \ (X) External 32 kHz crystal
73+
- \ (X) External 32 kHz crystal
7474

7575
**注意:** 即使在 menuconfig 中选择了 32kHz 外部晶振,如果低功耗蓝牙初始化时未检测到外部晶振,系统会自动切换为主晶振,可能导致 light-sleep 电流高于预期。
7676

@@ -82,7 +82,7 @@
8282

8383
要使用 136 kHz 内部 RC 振荡器作为低功耗蓝牙内部时钟源,请配置以下选项:
8484

85-
**配置路径:**
85+
**配置路径 1**
8686

8787
``Component config → Bluetooth → Controller Options → MODEM SLEEP Options → Bluetooth modem sleep → Bluetooth Modem sleep Mode 1 → Bluetooth low power clock``
8888

@@ -108,6 +108,8 @@
108108

109109
- \ (X) Use system RTC slow clock source
110110

111+
.. only:: not esp32
112+
111113
**配置路径 2:**
112114

113115
``Component config → Hardware Settings → RTC Clock Config → RTC clock source``
@@ -116,6 +118,8 @@
116118

117119
- \ (X) Internal 136 kHz RC oscillator
118120

121+
.. only:: esp32c2 or esp32c6 or esp32h2 or esp32c5 or esp32c61
122+
119123
对于需要低功耗且没有 32kHz 外部晶振的场景下,可以选择 136 kHz R C振荡器。然而这个时钟无法满足低功耗蓝牙的 500PPM 的休眠时钟精度需求。不过如果对端设备使用的是 ESP 芯片,仍能支持低功耗蓝牙行为。但是如果对端设备并非使用 ESP 芯片,则使用下面低功耗蓝牙行为将无法支持:
120124

121125
1. 作为连接的 Central 方

0 commit comments

Comments
 (0)