diff --git a/docs/en/api-reference/system/system_time.rst b/docs/en/api-reference/system/system_time.rst index b811fb37bb..c368649dec 100644 --- a/docs/en/api-reference/system/system_time.rst +++ b/docs/en/api-reference/system/system_time.rst @@ -66,12 +66,13 @@ Some chips may provide the **internal oscillator** option, which is a trade-off In most designs, the additional sleep current is a reasonable trade-off for significantly improved RTC Timer frequency stability and reduced time drift during sleep. -**Bluetooth LE** requires sleep clock accuracy within 500 PPM. The RTC clock source may not meet this requirement, leading to connection establishment failures, unexpected timeouts, or incompatibility with non-ESP peer devices. +**Bluetooth LE** requires sleep clock accuracy within 500 PPM. The RTC clock source may not meet this requirement, leading to connection establishment failures, unexpected timeouts, or incompatibility with non-Espressif peer devices. .. only:: SOC_BLE_SUPPORTED For a detailed comparison of Bluetooth LE clock configurations and power consumption, refer to :doc:`Low Power Mode in Bluetooth LE `. + Get Current Time ---------------- diff --git a/docs/zh_CN/api-reference/system/system_time.rst b/docs/zh_CN/api-reference/system/system_time.rst index 21b52671c5..44ad84e9db 100644 --- a/docs/zh_CN/api-reference/system/system_time.rst +++ b/docs/zh_CN/api-reference/system/system_time.rst @@ -31,17 +31,47 @@ RTC 定时器有以下时钟源： .. list:: - - ``内置 90～150 kHz（频率取决于芯片型号） 振荡器`` （默认）：Deep-sleep 模式下电流消耗最低，不依赖任何外部元件。但由于温度波动会影响该时钟源的频率稳定性，在 Deep-sleep 和 Light-sleep 模式下都有可能发生时间偏移。 + - ``内置 90～150 kHz（频率取决于芯片型号）振荡器`` （默认）：Deep-sleep 模式下电流消耗最低，不依赖任何外部元件。但由于温度波动会影响该时钟源的频率稳定性，在 Deep-sleep 和 Light-sleep 模式下都有可能发生时间偏移。 - :not esp32c2: - ``外置 32 kHz 晶振``：需要将一个 32 kHz 晶振连接到外置晶振管脚。频率稳定性更高，但在 Deep-sleep 模式下电流消耗略高（比默认模式高 1 μA）。管脚连接的相关信息请参考 `技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`__。 + :not esp32c2: - ``外部 32 kHz 晶振``：需要将一个 32 kHz 晶振连接到外部晶振管脚。频率稳定性更高，但在 Deep-sleep 模式下电流消耗略高（比默认模式高 1 μA）。管脚连接的相关信息请参考 `技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`__。 - - ``外置 32 kHz 振荡器``：允许使用由外部电路产生的 32 kHz 时钟。外部时钟信号必须连接到外置振荡器管脚。输入振幅必须保证数字电路能够正确识别电平高低。测试结果表明，1.7 V 为高低电平的分界点，因此需确保输入波形的峰值大于 1.7 V，谷值小于 1.7 V。管脚连接的相关信息请参考 `技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`__。 + - ``外部 32 kHz 振荡器``：允许使用由外部电路产生的 32 kHz 时钟。外部时钟信号必须连接到外部振荡器管脚。输入振幅必须保证数字电路能够正确识别电平高低。测试结果表明，1.7 V 为高低电平的分界点，因此需确保输入波形的峰值大于 1.7 V，谷值小于 1.7 V。管脚连接的相关信息请参考 `技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`__。 :esp32 or esp32s2 or esp32s3 or esp32c2 or esp32c3: - ``内置 8.5～17.5 MHz 振荡器（频率取决于芯片型号）的 256 分频时钟``：频率稳定性优于 ``内置 90～150 kHz RC 振荡器``，同样无需外部元件，但 Deep-sleep 模式下电流消耗更高（比默认模式高 5 μA）。 时钟源的选择取决于系统时间精度要求和睡眠模式下的功耗要求。要修改 RTC 时钟源，请在项目配置中设置 :ref:`CONFIG_RTC_CLK_SRC`。 -想要了解外置晶振或外置振荡器的更多布线要求，请参考 `硬件设计指南 `_。 +想要了解外部晶振或外部振荡器的更多布线要求，请参考 `硬件设计指南 `_。 + +选择 RTC 定时器时钟源 +^^^^^^^^^^^^^^^^^^^^^ + +在以下情况下使用默认的 **内部 RC 振荡器**： + +- 对于电池供电设备或能量受限的设备，最小化睡眠电流消耗。 +- 睡眠模式下不需要高时间精度，并且可以接受每天几秒的时间漂移。 +- 优先考虑最小化外部元件和硬件复杂度。 +- 工作温度相对稳定（减少频率变化）。 +- 未使用低功耗蓝牙的节能模式，或仅用于传统广播/扫描而不建立连接。 + +在以下情况下使用 **外部 32 kHz 晶振** 或 **外部 32 kHz 振荡器**： + +- 需要在 Deep-sleep 和 Light-sleep 模式下保持准确的时间。 +- 睡眠电流略有增加（通常为几微安）仍在功耗预算范围内。 +- 设计可以接受添加外部元件。 +- 工作温度可能变化较大。 +- 启用低功耗蓝牙的节能模式，且需要建立连接。 + +某些芯片可能提供 **内部振荡器** 选项，这是内部 RC 振荡器和外部 32 kHz 晶振/振荡器选项之间的折中方案。它不需要外部元件，同时提供比内部 RC 振荡器更好的频率稳定性，但代价是睡眠电流消耗更高。如果使用低功耗蓝牙，请确认内部振荡器是否满足低功耗蓝牙睡眠时钟精度要求（见下文）。 + +在大多数设计中，睡眠电流的略微增加是换取 RTC 定时器频率稳定性显著提升和睡眠期间时间漂移减少的合理权衡。 + +**低功耗蓝牙** 要求睡眠时钟精度在 500 PPM 以内。RTC 时钟源可能无法满足此要求，导致连接建立失败、意外超时或与非乐鑫设备不兼容。 + +.. only:: SOC_BLE_SUPPORTED + + 有关低功耗蓝牙时钟配置和功耗的详细比较，请参考 :doc:`低功耗蓝牙的低功耗模式 `。 + 获取当前时间 --------------