feat(docs): initial migration guide for idf 6.x

Author: suda-morris

docs/en/migration-guides/index.rst

@@ -15,3 +15,11 @@ ESP-IDF 5.x Migration Guide
     release-5.x/5.3/index
     release-5.x/5.4/index
     release-5.x/5.5/index
+
+ESP-IDF 6.x Migration Guide
+===========================
+
+.. toctree::
+    :maxdepth: 1
+
+    release-6.x/6.0/index

docs/en/migration-guides/release-6.x/6.0/index.rst

@@ -0,0 +1,9 @@
+Migration from 5.5 to 6.0
+-------------------------
+
+:link_to_translation:`zh_CN:[中文]`
+
+.. toctree::
+    :maxdepth: 1
+
+    peripherals

docs/en/migration-guides/release-6.x/6.0/peripherals.rst

@@ -0,0 +1,31 @@
+Peripherals
+===========
+
+:link_to_translation:`zh_CN:[中文]`
+
+Common Changes
+--------------
+
+All drivers' ``io_loop_back`` configuration have been removed
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Different driver objects can share the same GPIO number, enabling more complex functionalities. For example, you can bind the TX and RX channels of the RMT peripheral to the same GPIO to simulate 1-Wire bus read and write timing. In previous versions, you needed to configure the ``io_loop_back`` setting in the driver to achieve this "loopback" functionality. Now, this configuration has been removed. Simply configuring the same GPIO number in different drivers will achieve the same functionality.
+
+RMT
+---
+
+The ``io_od_mode`` member in the :cpp:type:`rmt_tx_channel_config_t` configuration structure has been removed. If you want to use open-drain mode, you need to manually call the :func:`gpio_od_enable` function.
+
+MCPWM
+-----
+
+The ``io_od_mode`` member in the :cpp:type:`mcpwm_generator_config_t` configuration structure has been removed. If you want to use open-drain mode, you need to manually call the :func:`gpio_od_enable` function.
+
+The ``pull_up`` and ``pull_down`` members have been removed from the following configuration structures. You need to manually call the :func:`gpio_set_pull_mode` function to configure the pull-up and pull-down resistors for the IO:
+
+.. list::
+
+    - :cpp:type:`mcpwm_generator_config_t`
+    - :cpp:type:`mcpwm_gpio_fault_config_t`
+    - :cpp:type:`mcpwm_gpio_sync_src_config_t`
+    - :cpp:type:`mcpwm_capture_channel_config_t`

docs/zh_CN/migration-guides/index.rst

@@ -15,3 +15,11 @@
     release-5.x/5.3/index
     release-5.x/5.4/index
     release-5.x/5.5/index
+
+迁移到 ESP-IDF 6.x
+-------------------
+
+.. toctree::
+    :maxdepth: 1
+
+    release-6.x/6.0/index

docs/zh_CN/migration-guides/release-6.x/6.0/index.rst

@@ -0,0 +1,9 @@
+从 5.5 迁移到 6.0
+-----------------
+
+:link_to_translation:`en:[English]`
+
+.. toctree::
+    :maxdepth: 1
+
+    peripherals

docs/zh_CN/migration-guides/release-6.x/6.0/peripherals.rst

@@ -0,0 +1,31 @@
+外设驱动
+========
+
+:link_to_translation:`en:[English]`
+
+公共变化
+--------
+
+所有驱动的 ``io_loop_back`` 配置已被移除
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+不同的驱动对象可以共享同一个 GPIO 编号，联合起来可以实现更加复杂的功能。比如将 RMT 外设的 TX 通道和 RX 通道绑定在同一个 GPIO 上，进而模拟单总线的读写时序。在以前的版本中，你需要在驱动的配置中额外设置 ``io_loop_back`` 来实现这种“回环”功能，现在，这个配置已经被移除。不同的驱动只需要在配置中设置相同的 GPIO 编号就能实现这个功能。
+
+RMT
+---
+
+:cpp:type:`rmt_tx_channel_config_t` 配置结构体中的 ``io_od_mode`` 已经被移除。如果想要使用开漏模式，你需要手动调用 GPIO 驱动中的 :func:`gpio_od_enable` 函数。
+
+MCPWM
+-----
+
+:cpp:type:`mcpwm_generator_config_t` 配置结构体中的 ``io_od_mode`` 已经被移除。如果想要使用开漏模式，你需要手动调用 GPIO 驱动中的 :func:`gpio_od_enable` 函数。
+
+以下配置结构体中的 ``pull_up`` 和 ``pull_down`` 成员已经被移除，你需要手动调用 GPIO 驱动中的 :func:`gpio_set_pull_mode` 函数来配置 IO 上拉和下拉电阻：
+
+.. list::
+
+    - :cpp:type:`mcpwm_generator_config_t`
+    - :cpp:type:`mcpwm_gpio_fault_config_t`
+    - :cpp:type:`mcpwm_gpio_sync_src_config_t`
+    - :cpp:type:`mcpwm_capture_channel_config_t`