Merge branch 'docs/update_32khz_oscillator_amplitude_instructions' into 'master'

docs: Update the amplitude constraints for external 32 kHz oscillator

Closes DOC-12245

See merge request espressif/esp-idf!41693

components/esp_hw_support/port/esp32/Kconfig.rtc

@@ -12,9 +12,7 @@ choice RTC_CLK_SRC
             expense of slightly higher (1uA) deep sleep current consumption.
         - "External 32kHz oscillator" allows using 32kHz clock generated by an
             external circuit. In this case, external clock signal must be connected
-            to 32K_XN pin. Amplitude should be <1.2V in case of sine wave signal,
+            to 32K_XN pin.
-            and <1V in case of square wave signal. Common mode voltage should be
-            0.1 < Vcm < 0.5Vamp, where Vamp is the signal amplitude.
             Additionally, 1nF capacitor must be connected between 32K_XP pin and
             ground. 32K_XP pin can not be used as a GPIO in this case.
         - "Internal 8.5MHz oscillator divided by 256" option results in higher

components/esp_hw_support/port/esp32s2/Kconfig.rtc

@@ -12,9 +12,7 @@ choice RTC_CLK_SRC
             expense of slightly higher (1uA) deep sleep current consumption.
         - "External 32kHz oscillator" allows using 32kHz clock generated by an
             external circuit. In this case, external clock signal must be connected
-            to 32K_XP pin. Amplitude should be <1.2V in case of sine wave signal,
+            to 32K_XP pin.
-            and <1V in case of square wave signal. Common mode voltage should be
-            0.1 < Vcm < 0.5Vamp, where Vamp is the signal amplitude.
         - "Internal 8MHz oscillator divided by 256" option results in higher
             deep sleep current (by 5uA) but has better frequency stability than
             the internal 90kHz oscillator. It does not require external components.

docs/en/api-reference/system/system_time.rst

@@ -35,7 +35,7 @@ The RTC timer has the following clock sources:
 
     :not esp32c2: - ``External 32 kHz crystal``: Requires a 32 kHz crystal to be connected to the external crystal pins. This source provides a better frequency stability at the expense of a slightly higher (by 1 μA) Deep-sleep current consumption. Refer to the `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__ for information on which pins to connect to.
 
-    - ``External 32 kHz oscillator``: Allows using 32 kHz clock generated by an external circuit. The external clock signal must be connected to the external oscillator pin. The amplitude should be less than 1.2 V for sine wave signal and less than 1 V for square wave signal. Common mode voltage should be in the range of 0.1 < Vcm < 0.5xVamp, where Vamp stands for signal amplitude. Refer to the `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__ for information on which pin to connect to.
+    - ``External 32 kHz oscillator``: Allows using a 32 kHz clock generated by an external circuit. The external clock signal must be connected to the external oscillator pin. The input amplitude must ensure that the digital circuit can correctly distinguish between logic high and low levels. Test results show that 1.7 V is the threshold between high and low levels. Therefore, make sure the input waveform has a peak value greater than 1.7 V and a minimum value lower than 1.7 V. For details on pin connections, please refer to the `datasheet <{IDF_TARGET_DATASHEET_EN_URL}>`__.
 
     :esp32 or esp32s2 or esp32s3 or esp32c2 or esp32c3: - ``Internal 8.5–17.5 MHz oscillator (depending on chip), divided by 256``: Provides better frequency stability than the ``Internal 90–150 kHz RC oscillator`` at the expense of a higher (by 5 μA) Deep-sleep current consumption. It also does not require external components.
 

docs/zh_CN/api-reference/system/system_time.rst

@@ -35,7 +35,7 @@ RTC 定时器有以下时钟源：
 
     :not esp32c2: - ``外置 32 kHz 晶振``：需要将一个 32 kHz 晶振连接到外置晶振管脚。频率稳定性更高，但在 Deep-sleep 模式下电流消耗略高（比默认模式高 1 μA）。管脚连接的相关信息请参考 `技术规格书 <{IDF_TARGET_DATASHEET_CN_URL}>`__。
 
-    - ``外置 32 kHz 振荡器``：允许使用由外部电路产生的 32 kHz 时钟。外部时钟信号必须连接到外置振荡器管脚。正弦波信号的振幅应小于 1.2 V，方波信号的振幅应小于 1 V。正常模式下，电压范围应为 0.1 < Vcm < 0.5 xVamp，其中 Vamp 代表信号振幅。管脚连接的相关信息请参考 `技术规格书 <{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）。