i2s: update documents for driver-NG

components/soc/esp32s3/include/soc/clk_tree_defs.h

@@ -248,6 +248,21 @@ typedef enum {
     MCPWM_CAPTURE_CLK_SRC_DEFAULT = SOC_MOD_CLK_APB, /*!< SElect APB as the default clock choice */
 } soc_periph_mcpwm_capture_clk_src_t;
 
+///////////////////////////////////////////////////// I2S //////////////////////////////////////////////////////////////
+
+/**
+ * @brief Array initializer for all supported clock sources of
+ */
+#define SOC_I2S_CLKS {SOC_MOD_CLK_PLL_F160M}
+
+/**
+ * @brief I2S clock source enum
+ */
+typedef enum {
+    I2S_CLK_SRC_DEFAULT = SOC_MOD_CLK_PLL_F160M,                    /*!< Select PLL_F160M as the default source clock  */
+    I2S_CLK_SRC_PLL_160M = SOC_MOD_CLK_PLL_F160M,                   /*!< Select PLL_F160M as the source clock */
+} soc_periph_i2s_clk_src_t;
+
 #ifdef __cplusplus
 }
 #endif

components/soc/esp32s3/include/soc/i2s_struct.h

@@ -197,7 +197,7 @@ typedef volatile struct i2s_dev_s {
             uint32_t reserved26                    :    6;  /*Reserved*/
         };
         uint32_t val;
-    } tx_pcm2pdm_conf;
+    } tx_pcm2pdm_conf; // Only available on I2S0
     union {
         struct {
             uint32_t tx_pdm_fp                     :    10;  /*I2S TX PDM Fp*/
@@ -207,7 +207,7 @@ typedef volatile struct i2s_dev_s {
             uint32_t reserved26                    :    6;  /*Reserved*/
         };
         uint32_t val;
-    } tx_pcm2pdm_conf1;
+    } tx_pcm2pdm_conf1; // Only available on I2S0
     uint32_t reserved_48;
     uint32_t reserved_4c;
     union {