docs: fix clock sources for esp32c6

pull/13854/head
Linda 2024-02-26 16:35:38 +08:00 zatwierdzone przez Fu Hanxi
rodzic 01c13a72a6
commit 52cfd1bf24
11 zmienionych plików z 75 dodań i 37 usunięć

Wyświetl plik

@ -5,11 +5,11 @@ choice RTC_CLK_SRC
Choose which clock is used as RTC clock source.
config RTC_CLK_SRC_INT_RC
bool "Internal 136kHz RC oscillator"
bool "Internal 136 kHz RC oscillator"
config RTC_CLK_SRC_EXT_OSC
bool "External 32kHz oscillator at pin0"
bool "External 32 kHz oscillator at pin0"
config RTC_CLK_SRC_INT_8MD256
bool "Internal 17.5MHz oscillator, divided by 256"
bool "Internal 17.5 MHz oscillator, divided by 256"
endchoice
config RTC_CLK_CAL_CYCLES

Wyświetl plik

@ -5,15 +5,15 @@ choice RTC_CLK_SRC
Choose which clock is used as RTC clock source.
config RTC_CLK_SRC_INT_RC
bool "Internal 136kHz RC oscillator"
bool "Internal 136 kHz RC oscillator"
config RTC_CLK_SRC_EXT_CRYS
bool "External 32kHz crystal"
bool "External 32 kHz crystal"
select ESP_SYSTEM_RTC_EXT_XTAL
config RTC_CLK_SRC_EXT_OSC
bool "External 32kHz oscillator at 32K_XP pin"
bool "External 32 kHz oscillator at 32K_XP pin"
select ESP_SYSTEM_RTC_EXT_OSC
config RTC_CLK_SRC_INT_8MD256
bool "Internal 17.5MHz oscillator, divided by 256"
bool "Internal 17.5 MHz oscillator, divided by 256"
endchoice
config RTC_CLK_CAL_CYCLES

Wyświetl plik

@ -10,13 +10,13 @@ choice RTC_CLK_SRC
depends on IDF_TARGET_ESP32C5_MP_VERSION
bool "Internal 136kHz RC oscillator"
config RTC_CLK_SRC_EXT_CRYS
bool "External 32kHz crystal"
bool "External 32 kHz crystal"
select ESP_SYSTEM_RTC_EXT_XTAL
config RTC_CLK_SRC_EXT_OSC
bool "External 32kHz oscillator at 32K_XP pin"
bool "External 32 kHz oscillator at 32K_XP pin"
select ESP_SYSTEM_RTC_EXT_OSC
config RTC_CLK_SRC_INT_RC32K
bool "Internal 32kHz RC oscillator"
bool "Internal 32 kHz RC oscillator"
endchoice
config RTC_CLK_CAL_CYCLES

Wyświetl plik

@ -5,15 +5,15 @@ choice RTC_CLK_SRC
Choose which clock is used as RTC clock source.
config RTC_CLK_SRC_INT_RC
bool "Internal 150 kHz RC oscillator"
bool "Internal 136 kHz RC oscillator"
config RTC_CLK_SRC_EXT_CRYS
bool "External 32kHz crystal"
bool "External 32 kHz crystal"
select ESP_SYSTEM_RTC_EXT_XTAL
config RTC_CLK_SRC_EXT_OSC
bool "External 32kHz oscillator at 32K_XP pin"
bool "External 32 kHz oscillator at 32K_XP pin"
select ESP_SYSTEM_RTC_EXT_OSC
config RTC_CLK_SRC_INT_RC32K
bool "Internal 32kHz RC oscillator"
bool "Internal 32 kHz RC oscillator"
endchoice
config RTC_CLK_CAL_CYCLES

Wyświetl plik

@ -5,15 +5,15 @@ choice RTC_CLK_SRC
Choose which clock is used as RTC clock source.
config RTC_CLK_SRC_INT_RC
bool "Internal 150 kHz RC oscillator"
bool "Internal 136 kHz RC oscillator"
config RTC_CLK_SRC_EXT_CRYS
bool "External 32kHz crystal"
bool "External 32 kHz crystal"
select ESP_SYSTEM_RTC_EXT_XTAL
config RTC_CLK_SRC_EXT_OSC
bool "External 32kHz oscillator at 32K_XP pin"
bool "External 32 kHz oscillator at 32K_XP pin"
select ESP_SYSTEM_RTC_EXT_OSC
config RTC_CLK_SRC_INT_RC32K
bool "Internal 32kHz RC oscillator"
bool "Internal 32 kHz RC oscillator"
endchoice
config RTC_CLK_CAL_CYCLES

Wyświetl plik

@ -5,12 +5,12 @@ choice RTC_CLK_SRC
Choose which clock is used as RTC clock source.
config RTC_CLK_SRC_INT_RC
bool "Internal 150 kHz RC oscillator"
bool "Internal 136 kHz RC oscillator"
config RTC_CLK_SRC_EXT_CRYS
bool "External 32kHz crystal"
bool "External 32 kHz crystal"
select ESP_SYSTEM_RTC_EXT_XTAL
config RTC_CLK_SRC_INT_RC32K
bool "Internal 32kHz RC oscillator"
bool "Internal 32 kHz RC oscillator"
endchoice
config RTC_CLK_CAL_CYCLES

Wyświetl plik

@ -5,15 +5,15 @@ choice RTC_CLK_SRC
Choose which clock is used as RTC clock source.
config RTC_CLK_SRC_INT_RC
bool "Internal 136kHz RC oscillator"
bool "Internal 136 kHz RC oscillator"
config RTC_CLK_SRC_EXT_CRYS
bool "External 32kHz crystal"
bool "External 32 kHz crystal"
select ESP_SYSTEM_RTC_EXT_XTAL
config RTC_CLK_SRC_EXT_OSC
bool "External 32kHz oscillator at 32K_XP pin"
bool "External 32 kHz oscillator at 32K_XP pin"
select ESP_SYSTEM_RTC_EXT_OSC
config RTC_CLK_SRC_INT_8MD256
bool "Internal 17.5MHz oscillator, divided by 256"
bool "Internal 17.5 MHz oscillator, divided by 256"
endchoice
config RTC_CLK_CAL_CYCLES

Wyświetl plik

@ -150,7 +150,26 @@ The source clock can also limit the PWM frequency. The higher the source clock f
- 40 MHz
- Dynamic Frequency Scaling compatible
.. only:: esp32c6 or esp32p4
.. only:: esp32c6
.. list-table:: Characteristics of {IDF_TARGET_NAME} LEDC source clocks
:widths: 15 15 30
:header-rows: 1
* - Clock name
- Clock freq
- Clock capabilities
* - PLL_80M_CLK
- 80 MHz
- /
* - RC_FAST_CLK
- ~ 17.5 MHz
- Dynamic Frequency Scaling compatible, Light sleep compatible
* - XTAL_CLK
- 40 MHz
- Dynamic Frequency Scaling compatible
.. only:: esp32p4
.. list-table:: Characteristics of {IDF_TARGET_NAME} LEDC source clocks
:widths: 15 15 30
@ -270,7 +289,7 @@ The LEDC hardware provides the means to gradually transition from one duty cycle
On {IDF_TARGET_NAME}, the hardware additionally allows to perform up to {IDF_TARGET_LEDC_MAX_FADE_RANGE_NUM} consecutive linear fades without CPU intervention. This feature can be useful if you want to do a fade with gamma correction.
The luminance perceived by human eyes does not have a linear relationship with the PWM duty cycle. In order to make human feel the LED is dimming or lightening linearly, the change in duty cycle should be non-linear, which is the so-called gamma correction. The LED controller can simulate a gamma curve fading by piecewise linear approximation. :cpp:func:`ledc_fill_multi_fade_param_list` is a function that can help to construct the parameters for the piecewise linear fades. First, you need to allocate a memory block for saving the fade parameters, then by providing start/end PWM duty cycle values, gamma correction function, and the total number of desired linear segments to the helper function, it will fill the calculation results into the allocated space. You can also construct the array of :cpp:type:`ledc_fade_param_config_t` manually. Once the fade parameter structs are prepared, a consecutive fading can be configured by passing the pointer to the prepared :cpp:type:`ledc_fade_param_config_t` list and the total number of fade ranges to :cpp:func:`ledc_set_multi_fade`.
The luminance perceived by human eyes does not have a linear relationship with the PWM duty cycle. In order to make human feel the LED is dimming or lighting linearly, the change in duty cycle should be non-linear, which is the so-called gamma correction. The LED controller can simulate a gamma curve fading by piecewise linear approximation. :cpp:func:`ledc_fill_multi_fade_param_list` is a function that can help to construct the parameters for the piecewise linear fades. First, you need to allocate a memory block for saving the fade parameters, then by providing start/end PWM duty cycle values, gamma correction function, and the total number of desired linear segments to the helper function, it will fill the calculation results into the allocated space. You can also construct the array of :cpp:type:`ledc_fade_param_config_t` manually. Once the fade parameter structs are prepared, a consecutive fading can be configured by passing the pointer to the prepared :cpp:type:`ledc_fade_param_config_t` list and the total number of fade ranges to :cpp:func:`ledc_set_multi_fade`.
.. only:: esp32

Wyświetl plik

@ -3,7 +3,7 @@ System Time
:link_to_translation:`zh_CN:[中文]`
{IDF_TARGET_RTC_CLK_FRE:default="Not updated", esp32="150 kHz", esp32s2="90 kHz", esp32s3="136 kHz", esp32c3="136 kHz", esp32c2="136 kHz", esp32c6="150 kHz", esp32h2="150 kHz", esp32p4="150 kHz"}
{IDF_TARGET_RTC_CLK_FRE:default="136 kHz", esp32="150 kHz", esp32s2="90 kHz", esp32s3="136 kHz", esp32c3="136 kHz", esp32c2="136 kHz", esp32c6="136 kHz", esp32h2="136 kHz", esp32p4="136 kHz"}
{IDF_TARGET_INT_OSC_FRE:default="Not updated", esp32="8.5 MHz", esp32s2="8.5 MHz", esp32s3="17.5 MHz", esp32c3="17.5 MHz", esp32c2="17.5 MHz"}
{IDF_TARGET_INT_OSC_FRE_DIVIDED:default="Not updated", esp32="about 33 kHz", esp32s2="about 33 kHz", esp32s3="about 68 kHz", esp32c3="about 68 kHz", esp32c2="about 68 kHz"}
{IDF_TARGET_EXT_CRYSTAL_PIN:default="Not updated", esp32="32K_XP and 32K_XN", esp32s2="XTAL_32K_P and XTAL_32K_N", esp32s3="XTAL_32K_P and XTAL_32K_N", esp32c3="XTAL_32K_P and XTAL_32K_N", esp32c6="XTAL_32K_P and XTAL_32K_N", esp32h2="XTAL_32K_P and XTAL_32K_N", esp32p4="XTAL_32K_P and XTAL_32K_N"}

Wyświetl plik

@ -88,7 +88,7 @@ LED PWM 控制器可在无需 CPU 干预的情况下自动改变占空比,实
* - RC_FAST_CLK
- ~ 8 MHz
- 低速
- 支持动态调频DFS功能,支持 Light-sleep 模式
- 支持动态调频 (DFS) 功能,支持 Light-sleep 模式
.. only:: esp32s2
@ -107,7 +107,7 @@ LED PWM 控制器可在无需 CPU 干预的情况下自动改变占空比,实
- 支持动态调频 (DFS) 功能
* - RC_FAST_CLK
- ~ 8 MHz
- 支持动态调频DFS功能,支持 Light-sleep 模式
- 支持动态调频 (DFS) 功能,支持 Light-sleep 模式
* - XTAL_CLK
- 40 MHz
- 支持动态调频 (DFS) 功能
@ -126,10 +126,10 @@ LED PWM 控制器可在无需 CPU 干预的情况下自动改变占空比,实
- /
* - RC_FAST_CLK
- ~ 20 MHz
- 支持动态调频DFS功能,支持 Light-sleep 模式
- 支持动态调频 (DFS) 功能,支持 Light-sleep 模式
* - XTAL_CLK
- 40 MHz
- 支持动态调频DFS功能
- 支持动态调频 (DFS) 功能
.. only:: esp32c2
@ -145,12 +145,31 @@ LED PWM 控制器可在无需 CPU 干预的情况下自动改变占空比,实
- /
* - RC_FAST_CLK
- ~ 20 MHz
- 支持动态调频DFS功能,支持 Light-sleep 模式
- 支持动态调频 (DFS) 功能,支持 Light-sleep 模式
* - XTAL_CLK
- 40 MHz
- 支持动态调频 (DFS) 功能
.. only:: esp32c6 or esp32p4
.. only:: esp32c6
.. list-table:: {IDF_TARGET_NAME} LEDC 时钟源特性
:widths: 10 10 30
:header-rows: 1
* - 时钟名称
- 时钟频率
- 时钟功能
* - PLL_80M_CLK
- 80 MHz
- /
* - RC_FAST_CLK
- ~ 17.5 MHz
- 支持动态调频 (DFS) 功能,支持 Light-sleep 模式
* - XTAL_CLK
- 40 MHz
- 支持动态调频 (DFS) 功能
.. only:: esp32p4
.. list-table:: {IDF_TARGET_NAME} LEDC 时钟源特性
:widths: 10 10 30
@ -164,7 +183,7 @@ LED PWM 控制器可在无需 CPU 干预的情况下自动改变占空比,实
- /
* - RC_FAST_CLK
- ~ 20 MHz
- 支持动态调频DFS功能,支持 Light-sleep 模式
- 支持动态调频 (DFS) 功能,支持 Light-sleep 模式
* - XTAL_CLK
- 40 MHz
- 支持动态调频 (DFS) 功能
@ -183,7 +202,7 @@ LED PWM 控制器可在无需 CPU 干预的情况下自动改变占空比,实
- /
* - RC_FAST_CLK
- ~ 8 MHz
- 支持动态调频DFS功能,支持 Light-sleep 模式
- 支持动态调频 (DFS) 功能,支持 Light-sleep 模式
* - XTAL_CLK
- 32 MHz
- 支持动态调频 (DFS) 功能

Wyświetl plik

@ -3,7 +3,7 @@
:link_to_translation:`en:[English]`
{IDF_TARGET_RTC_CLK_FRE:default="未更新", esp32="150 kHz", esp32s2="90 kHz", esp32s3="136 kHz", esp32c3="136 kHz", esp32c2="136 kHz", esp32c6="150 kHz", esp32h2="150 kHz", esp32p4="150 kHz"}
{IDF_TARGET_RTC_CLK_FRE:default="未更新", esp32="150 kHz", esp32s2="90 kHz", esp32s3="136 kHz", esp32c3="136 kHz", esp32c2="136 kHz", esp32c6="136 kHz", esp32h2="136 kHz", esp32p4="136 kHz"}
{IDF_TARGET_INT_OSC_FRE:default="未更新", esp32="8.5 MHz", esp32s2="8.5 MHz", esp32s3="17.5 MHz", esp32c3="17.5 MHz", esp32c2="17.5 MHz"}
{IDF_TARGET_INT_OSC_FRE_DIVIDED:default="未更新", esp32="约 33 kHz", esp32s2="约 33 kHz", esp32s3="约 68 kHz", esp32c3="约 68 kHz", esp32c2="约 68 kHz"}
{IDF_TARGET_EXT_CRYSTAL_PIN:default="未更新", esp32="32K_XP 和 32K_XN", esp32s2="XTAL_32K_P 和 XTAL_32K_N", esp32s3="XTAL_32K_P 和 XTAL_32K_N", esp32c3="XTAL_32K_P 和 XTAL_32K_N", esp32c6="XTAL_32K_P 和 XTAL_32K_N", esp32h2="XTAL_32K_P 和 XTAL_32K_N", esp32p4="XTAL_32K_P 和 XTAL_32K_N"}