diff --git a/docs/en/api-guides/dfu.rst b/docs/en/api-guides/dfu.rst index cf4bee3080..e599352c90 100644 --- a/docs/en/api-guides/dfu.rst +++ b/docs/en/api-guides/dfu.rst @@ -17,6 +17,8 @@ Device Firmware Upgrade via USB However, you can permanently switch the internal USB PHY to work with USB OTG peripheral instead of USB_SERIAL_JTAG by burning the ``USB_PHY_SEL`` eFuse. See *{IDF_TARGET_NAME} Technical Reference Manual* [`PDF <{IDF_TARGET_TRM_EN_URL}>`__] for more details about USB_SERIAL_JTAG and USB OTG. + For a practical example of USB OTG implementation, refer to the `ESP32-S3-USB-OTG `_ development board, which is specifically designed for USB OTG applications. + Device Firmware Upgrade (DFU) is a mechanism for upgrading the firmware of {IDF_TARGET_NAME} directly via the Universal Serial Bus (USB). However, enabling Secure Boot or flash encryption disables the USB-OTG USB stack in the ROM, disallowing updates via the serial emulation or DFU on that port. - :ref:`get-started-get-prerequisites` of the Getting Started Guide introduces the software requirements of DFU. diff --git a/docs/en/api-reference/peripherals/sdspi_share.rst b/docs/en/api-reference/peripherals/sdspi_share.rst index ea178813b7..3e8cbc85f3 100644 --- a/docs/en/api-reference/peripherals/sdspi_share.rst +++ b/docs/en/api-reference/peripherals/sdspi_share.rst @@ -63,7 +63,7 @@ When using an SD card with other SPI devices on the same SPI bus, due to the res 1. Attach devices to the SPI bus by calling :cpp:func:`spi_bus_add_device`. This function will by default initialize the GPIO that is used as CS to the idle level: high. - 2. Initialize GPIO on the CS pin that needs to be tied up before actually adding a new device. + 2. Before adding a new device, initialize the GPIO for the CS pin that must remain high. 3. Rely on the internal/external pull-up (**not recommended**) to pull up all the CS pins when the GPIOs of ESP are not initialized yet. You need to check carefully the pull-up is strong enough and there are no other pull-downs that will influence the pull-up. For example, internal pull-down should be enabled. diff --git a/docs/zh_CN/api-guides/dfu.rst b/docs/zh_CN/api-guides/dfu.rst index 2a27358865..a45d5c093a 100644 --- a/docs/zh_CN/api-guides/dfu.rst +++ b/docs/zh_CN/api-guides/dfu.rst @@ -17,6 +17,8 @@ 然而，你可以通过烧录 ``USB_PHY_SEL`` eFuse，将内部 USB PHY 永久切换为支持 USB OTG 外设的模式，不再用于 USB_SERIAL_JTAG。有关 USB_SERIAL_JTAG 和 USB OTG 的更多信息，请参阅 *{IDF_TARGET_NAME} 技术参考手册* [`PDF <{IDF_TARGET_TRM_CN_URL}>`__]。 + 如需了解 USB OTG 的实际应用示例，请参考专为 USB OTG 应用设计的 `ESP32-S3-USB-OTG `_ 开发板。 + 设备固件升级 (DFU) 是一种通过通用串行总线 (USB) 升级设备固件的机制。但是，启用安全启动 (Secure Boot) 或 flash 加密会禁用 ROM 中的 USB-OTG USB 堆栈，则无法通过该端口上的模拟串口或 DFU 进行更新。 - 入门指南中的 :ref:`get-started-get-prerequisites` 介绍了 DFU 的软件要求。 diff --git a/docs/zh_CN/api-reference/peripherals/sdspi_share.rst b/docs/zh_CN/api-reference/peripherals/sdspi_share.rst index 6dd2fc433a..99c2d2a3e3 100644 --- a/docs/zh_CN/api-reference/peripherals/sdspi_share.rst +++ b/docs/zh_CN/api-reference/peripherals/sdspi_share.rst @@ -63,7 +63,7 @@ SD 卡所需的上拉电阻通常在 10 kΩ 至 50 kΩ 之间，注意对某些 1. 调用 :cpp:func:`spi_bus_add_device` 将设备连接到 SPI 总线，该函数将初始化用作 CS 的 GPIO 管脚到空闲电平：默认为高电平。 - 2. 在添加新设备前，初始化需要拉高的 CS 管脚 GPIO。 + 2. 在添加新设备前，先初始化需要保持为拉高状态的 CS 管脚 GPIO。 3. 在 ESP 的 GPIO 未初始化前，依靠内部/外部上拉电阻拉高所有 CS 管脚（**不推荐**）。请确保上拉电阻拥有足够强度，且没有其他下拉电阻影响拉高。例如，应启用内部下拉电阻。