docs(i2s): add note for the restriction of MCLK on esp32

Closes https://github.com/espressif/esp-idf/issues/18564
This commit is contained in:
Chen Chen
2026-05-15 16:38:10 +08:00
parent 79baa56745
commit 7b7bb4f6f2
3 changed files with 13 additions and 1 deletions
@@ -99,6 +99,12 @@ I2S 时钟
通常,MCLK 应该同时是 ``采样率`` 和 BCLK 的倍数。字段 :cpp:member:`i2s_std_clk_config_t::mclk_multiple` 表示 MCLK 相对于 ``采样率`` 的倍数。在大多数情况下,将其设置为 ``I2S_MCLK_MULTIPLE_256`` 即可。但如果 ``slot_bit_width`` 被设置为 ``I2S_SLOT_BIT_WIDTH_24BIT``,为了保证 MCLK 是 BCLK 的整数倍,应该将 :cpp:member:`i2s_std_clk_config_t::mclk_multiple` 设置为能被 3 整除的倍数,如 ``I2S_MCLK_MULTIPLE_384``,否则 WS 会不精准。
.. only:: esp32
.. note::
在ESP32上,MCLK 管脚必须使用 GPIO0、GPIO1 或 GPIO3 管脚。其他的时钟管脚可以使用任意的 GPIO。注意,由于 GPIO0 为 Strapping 管脚,一般不推荐用作其他功能。
.. _i2s-communication-mode:
I2S 通信模式