mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
docs(tools): Changed USB Drivers (Windows Only) section of DFU
New driver was created for ESP32-S2, so there is no need to manually install it using tools
This commit is contained in:
parent
7e97b72dff
commit
0ff1009598
@ -116,11 +116,22 @@ Restart your computer so the previous setting could take into affect or run ``su
|
||||
USB Drivers (Windows Only)
|
||||
--------------------------
|
||||
|
||||
``dfu-util`` uses `libusb` to access the device. You have to register on Windows the device with the `WinUSB` driver.
|
||||
``dfu-util`` uses `libusb` to access the device. On Windows, the `WinUSB` driver is the recommended driver which has to be installed for the device to work properly. For more details please see the `libusb wiki <https://github.com/libusb/libusb/wiki/Windows#How_to_use_libusb_on_Windows>`_.
|
||||
|
||||
Please see the `libusb wiki <https://github.com/libusb/libusb/wiki/Windows#How_to_use_libusb_on_Windows>`_ for more details.
|
||||
.. only:: esp32s2
|
||||
|
||||
The drivers can be installed by the `Zadig tool <https://zadig.akeo.ie/>`_. Please make sure that the device is in download mode before you run the tool and that it detects the {IDF_TARGET_NAME} device before you install the drivers. The Zadig tool might detect several USB interfaces of {IDF_TARGET_NAME}. Please install the WinUSB driver only for the interface where there is no driver installed (probably it is Interface 2) and do not re-install the driver for the other interface.
|
||||
The development board driver can be downloaded from https://github.com/espressif/esp-win-usb-drivers/releases. The files need to be extracted and `installed <https://learn.microsoft.com/en-us/windows-hardware/drivers/ifs/using-an-inf-file-to-install-a-file-system-filter-driver#right-click-install>`_. This should change or install the WinUSB driver for the right interface of the device.
|
||||
|
||||
.. note::
|
||||
|
||||
If the feature is not working please proceed with the manual driver assignment. Otherwise, the following section can be skipped.
|
||||
|
||||
USB Drivers (Windows Only) - manual driver assignment
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Manual driver assignment can be performed with the `Zadig tool <https://zadig.akeo.ie/>`_. Please make sure that the device is in download mode before running the tool and that the {IDF_TARGET_NAME} device is detected before the driver installation.
|
||||
|
||||
The Zadig tool might detect several USB interfaces of {IDF_TARGET_NAME}. Please install the `WinUSB` driver **only** for the interface where there is no driver installed (probably it is Interface 2) and do not re-install the driver for the other interface.
|
||||
|
||||
.. warning::
|
||||
|
||||
|
@ -114,13 +114,24 @@ Udev 是 Linux 内核的设备管理器,允许用户在没有 ``sudo`` 的情
|
||||
.. _api_guide_dfu_flash_win:
|
||||
|
||||
USB 驱动(仅限 Windows)
|
||||
-------------------------------
|
||||
------------------------
|
||||
|
||||
``dfu-util`` 使用 `libusb` 来访问设备。你需要在 Windows 上使用 `WinUSB` 驱动程序注册设备。
|
||||
``dfu-util`` 使用 `libusb` 访问设备。在 Windows 上,必须先安装 `WinUSB` 驱动程序才能使设备正常工作。详情请参阅 `libusb wiki <https://github.com/libusb/libusb/wiki/Windows#How_to_use_libusb_on_Windows>`_。
|
||||
|
||||
更多详细信息,请参考 `libusb wiki <https://github.com/libusb/libusb/wiki/Windows#How_to_use_libusb_on_Windows>`_。
|
||||
.. only:: esp32s2
|
||||
|
||||
可以通过 `Zadig 工具 <https://zadig.akeo.ie/>`_ 安装驱动程序。请确保在运行该工具之前设备处于下载模式,并确保在安装驱动程序之前检测到 {IDF_TARGET_NAME} 设备。Zadig 工具可能会检测到 {IDF_TARGET_NAME} 的多个 USB 接口。请只为没有安装驱动的接口(可能是接口 2)安装 WinUSB 驱动,不要重新安装其他接口驱动。
|
||||
开发板驱动程序可以从 https://github.com/espressif/esp-win-usb-drivers/releases 下载。文件需要解压并 `安装 <https://learn.microsoft.com/zh-cn/windows-hardware/drivers/ifs/using-an-inf-file-to-install-a-file-system-filter-driver#right-click-install>`_。进行以上操作,可以为正确的设备接口更改或安装 WinUSB 驱动程序。
|
||||
|
||||
.. note::
|
||||
|
||||
如果该功能无法正常运作,请手动分配驱动程序;若设备正常工作,请跳过以下章节。
|
||||
|
||||
USB 驱动(仅限 Windows)- 手动分配驱动程序
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
可以使用 `Zadig 工具 <https://zadig.akeo.ie/>`_ 手动分配驱动程序。在运行工具前,请确保设备处于下载模式,且在安装驱动程序之前已检测到 {IDF_TARGET_NAME} 设备。
|
||||
|
||||
Zadig 工具可能会检测到 {IDF_TARGET_NAME} 的多个 USB 接口。请 **仅为** 没有安装驱动程序的接口(可能是接口 2)安装 `WinUSB` 驱动程序,不要重新安装其他接口的驱动程序。
|
||||
|
||||
.. warning::
|
||||
|
||||
|
Loading…
x
Reference in New Issue
Block a user